@camstack/system 1.2.217 → 1.2.219

package/dist/addon-runner.js

@@ -1,6 +1,6 @@
 const require_chunk = require("./chunk-Cek0wNdY.js");
-const require_manifest_system_deps = require("./manifest-system-deps-DvY1bY_n.js");
-const require_custom_action_registry = require("./custom-action-registry-jY0NOZK8.js");
+const require_manifest_system_deps = require("./manifest-system-deps-g_nK0xsF.js");
+const require_custom_action_registry = require("./custom-action-registry-DKWhaWL1.js");
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);
 let node_fs = require("node:fs");
@@ -85,7 +85,10 @@ function createChildAddonCallDispatch(deps) {
 				if (typeof action !== "string" || action.length === 0) throw new Error(`child-addon-call: addon "${addonId}" custom call missing action name`);
 				const entry = deps.customActions.resolve(addonId, action);
 				if (entry === null) throw new Error(`child-addon-call: addon "${addonId}" has no custom action "${action}"`);
-				return entry.handler(call.args, call.caller);
+				const parsedInput = entry.spec.input.safeParse(call.args);
+				if (!parsedInput.success) throw new Error(`child-addon-call: addon "${addonId}" custom action "${action}" rejected its input — ` + parsedInput.error.issues.map((issue) => `${issue.path.join(".") || "(root)"}: ${issue.message}`).join("; "));
+				const result = await entry.handler(parsedInput.data, call.caller);
+				return entry.spec.output.parse(result);
 			}
 			case "settings": {
 				const method = call.method;
@@ -584,9 +587,9 @@ async function main() {
 	runnerLog.info("UDS child transport connected", { meta: { childId: runnerId } });
 	if (storageProvider) runnerLog.info(`"${nodeId}" storage provider rooted at ${dataDir}`);
 	else runnerLog.warn(`"${nodeId}" failed to load FilesystemStorageProvider`, { meta: { error: (0, _camstack_types_addon.errMsg)(storageProviderError) } });
-	const refreshChildCaps = (reason) => {
+	const refreshChildCaps = (reason, customActions) => {
 		const freshDescriptors = buildChildCapDescriptors(runnerManifest, require_manifest_system_deps.getWorkerNativeCapSnapshot());
-		udsChildClient.updateCaps(freshDescriptors).catch((err) => {
+		udsChildClient.updateCaps(freshDescriptors, customActions).catch((err) => {
 			runnerLog.warn(`UDS updateCaps failed (${reason})`, { meta: { error: err instanceof Error ? err.message : String(err) } });
 		});
 	};
@@ -673,7 +676,7 @@ async function main() {
 		process.exit(1);
 	}
 	if (deviceRestorePromises.length > 0 && !shuttingDown) await Promise.allSettled(deviceRestorePromises);
-	refreshChildCaps("post-init");
+	refreshChildCaps("post-init", customActionRegistry.describeAll(specs.map((spec) => spec.addonId)));
 	let hubReachableFired = false;
 	const fireHubReachableOnce = () => {
 		if (hubReachableFired) return;

package/dist/addon-runner.mjs

@@ -1,5 +1,5 @@
-import { A as createUdsLoggerWithControl, Ft as RUNNER_RSS_BUDGET_ENV, Jt as startRunnerHeapWatch, Qt as emitHeapDiagnosticReport, a as createUdsAddonContext, bt as resolveAddonClass, it as setWorkerNativeCapsChangeListener, j as LocalChildClient, n as installManifestPythonDeps, nt as getWorkerNativeCapSnapshot, ot as validateProviderRegistrations, t as installManifestSystemDeps, tt as getWorkerNativeCapProvider, yt as installManifestNativeDeps } from "./manifest-system-deps-726RBOX7.mjs";
-import { t as CustomActionRegistry } from "./custom-action-registry-F__gp_VX.mjs";
+import { A as createUdsLoggerWithControl, Ft as RUNNER_RSS_BUDGET_ENV, Jt as startRunnerHeapWatch, L as LocalChildClient, a as createUdsAddonContext, bt as resolveAddonClass, it as setWorkerNativeCapsChangeListener, n as installManifestPythonDeps, nt as getWorkerNativeCapSnapshot, on as emitHeapDiagnosticReport, ot as validateProviderRegistrations, t as installManifestSystemDeps, tt as getWorkerNativeCapProvider, yt as installManifestNativeDeps } from "./manifest-system-deps-C7dihwWT.mjs";
+import { t as CustomActionRegistry } from "./custom-action-registry-B6gOtUWA.mjs";
 import { register } from "node:module";
 import * as path$1 from "node:path";
 import * as fs from "node:fs";
@@ -82,7 +82,10 @@ function createChildAddonCallDispatch(deps) {
 				if (typeof action !== "string" || action.length === 0) throw new Error(`child-addon-call: addon "${addonId}" custom call missing action name`);
 				const entry = deps.customActions.resolve(addonId, action);
 				if (entry === null) throw new Error(`child-addon-call: addon "${addonId}" has no custom action "${action}"`);
-				return entry.handler(call.args, call.caller);
+				const parsedInput = entry.spec.input.safeParse(call.args);
+				if (!parsedInput.success) throw new Error(`child-addon-call: addon "${addonId}" custom action "${action}" rejected its input — ` + parsedInput.error.issues.map((issue) => `${issue.path.join(".") || "(root)"}: ${issue.message}`).join("; "));
+				const result = await entry.handler(parsedInput.data, call.caller);
+				return entry.spec.output.parse(result);
 			}
 			case "settings": {
 				const method = call.method;
@@ -581,9 +584,9 @@ async function main() {
 	runnerLog.info("UDS child transport connected", { meta: { childId: runnerId } });
 	if (storageProvider) runnerLog.info(`"${nodeId}" storage provider rooted at ${dataDir}`);
 	else runnerLog.warn(`"${nodeId}" failed to load FilesystemStorageProvider`, { meta: { error: errMsg(storageProviderError) } });
-	const refreshChildCaps = (reason) => {
+	const refreshChildCaps = (reason, customActions) => {
 		const freshDescriptors = buildChildCapDescriptors(runnerManifest, getWorkerNativeCapSnapshot());
-		udsChildClient.updateCaps(freshDescriptors).catch((err) => {
+		udsChildClient.updateCaps(freshDescriptors, customActions).catch((err) => {
 			runnerLog.warn(`UDS updateCaps failed (${reason})`, { meta: { error: err instanceof Error ? err.message : String(err) } });
 		});
 	};
@@ -670,7 +673,7 @@ async function main() {
 		process.exit(1);
 	}
 	if (deviceRestorePromises.length > 0 && !shuttingDown) await Promise.allSettled(deviceRestorePromises);
-	refreshChildCaps("post-init");
+	refreshChildCaps("post-init", customActionRegistry.describeAll(specs.map((spec) => spec.addonId)));
 	let hubReachableFired = false;
 	const fireHubReachableOnce = () => {
 		if (hubReachableFired) return;

package/dist/addon-utils.js

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("./chunk-Cek0wNdY.js");
-const require_event_loop_stall_monitor = require("./event-loop-stall-monitor-DM9OAzy8.js");
-const require_custom_action_registry = require("./custom-action-registry-jY0NOZK8.js");
+const require_event_loop_stall_monitor = require("./event-loop-stall-monitor-CAsHdMwP.js");
+const require_custom_action_registry = require("./custom-action-registry-DKWhaWL1.js");
 exports.CustomActionRegistry = require_custom_action_registry.CustomActionRegistry;
 exports.ModelDownloadService = require_event_loop_stall_monitor.ModelDownloadService;
 exports.STALL_REPORT_MS = require_event_loop_stall_monitor.STALL_REPORT_MS;

package/dist/addon-utils.mjs

@@ -1,3 +1,3 @@
-import { a as createFileDataPlaneHandler, c as parseRangeHeader, d as ModelDownloadService, f as collectModelFiles, g as ensureModel, i as startEventLoopStallMonitor, m as downloadFile, n as STALL_TICK_MS, o as contentTypeFor, p as deleteModelFromDisk, r as attributeStall, t as STALL_REPORT_MS, v as getModelFilePath, y as isModelDownloaded } from "./event-loop-stall-monitor-B3CFd9tM.mjs";
-import { t as CustomActionRegistry } from "./custom-action-registry-F__gp_VX.mjs";
+import { a as createFileDataPlaneHandler, c as parseRangeHeader, d as ModelDownloadService, f as collectModelFiles, g as ensureModel, i as startEventLoopStallMonitor, m as downloadFile, n as STALL_TICK_MS, o as contentTypeFor, p as deleteModelFromDisk, r as attributeStall, t as STALL_REPORT_MS, v as getModelFilePath, y as isModelDownloaded } from "./event-loop-stall-monitor-GPrVvx14.mjs";
+import { t as CustomActionRegistry } from "./custom-action-registry-B6gOtUWA.mjs";
 export { CustomActionRegistry, ModelDownloadService, STALL_REPORT_MS, STALL_TICK_MS, attributeStall, collectModelFiles, contentTypeFor, createFileDataPlaneHandler, deleteModelFromDisk, downloadFile, ensureModel, getModelFilePath, isModelDownloaded, parseRangeHeader, startEventLoopStallMonitor };

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-C85OOASj.js");
+const require_dist = require("../../dist-B17W9ngu.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 { Jt as BaseAddon, bn as EventCategory, k as addonPagesCapability, qt as errMsg } from "../../dist-DtDKMSeG.mjs";
+import { Jt as errMsg, Yt as BaseAddon, k as addonPagesCapability, xn as EventCategory } from "../../dist-Cyz5_i7z.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-C85OOASj.js");
+const require_dist = require("../../dist-B17W9ngu.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 { Jt as BaseAddon, bn as EventCategory, j as addonWidgetsCapability, qt as errMsg } from "../../dist-DtDKMSeG.mjs";
+import { Jt as errMsg, Yt as BaseAddon, j as addonWidgetsCapability, xn as EventCategory } from "../../dist-Cyz5_i7z.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-C85OOASj.js");
+const require_dist = require("../../dist-B17W9ngu.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 { Jt as BaseAddon, M as alertsCapability, bn as EventCategory, n as AlertSchema, qt as errMsg, sn as createEvent } from "../../dist-DtDKMSeG.mjs";
+import { Jt as errMsg, M as alertsCapability, Yt as BaseAddon, cn as createEvent, n as AlertSchema, xn as EventCategory } from "../../dist-Cyz5_i7z.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-C85OOASj.js");
+const require_dist = require("../../dist-B17W9ngu.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 { Bt as storageOccupancyCapability, Jt as BaseAddon, P as backupCapability, bn as EventCategory, yt as mayWriteToLocation } from "../../dist-DtDKMSeG.mjs";
+import { P as backupCapability, Vt as storageOccupancyCapability, Yt as BaseAddon, bt as mayWriteToLocation, xn as EventCategory } from "../../dist-Cyz5_i7z.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-C85OOASj.js");
+const require_dist = require("../../dist-B17W9ngu.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 { Jt as BaseAddon, ht as logDestinationCapability } from "../../dist-DtDKMSeG.mjs";
+import { Yt as BaseAddon, gt as logDestinationCapability } from "../../dist-Cyz5_i7z.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-C85OOASj.js");
+const require_dist = require("../../dist-B17W9ngu.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 { B as coreBlockIdFromAddonId, Jt as BaseAddon, V as coreBlocksCapability, c as CORE_BLOCK_ADDON_PREFIX, d as DeclaredDevices, l as CoreBlockSchema, qt as errMsg, s as CORE_BLOCKS_ADDON_ID, z as coreBlockAddonId } from "../../dist-DtDKMSeG.mjs";
+import { B as coreBlockIdFromAddonId, Jt as errMsg, V as coreBlocksCapability, Yt as BaseAddon, c as CORE_BLOCK_ADDON_PREFIX, d as DeclaredDevices, l as CoreBlockSchema, s as CORE_BLOCKS_ADDON_ID, z as coreBlockAddonId } from "../../dist-Cyz5_i7z.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-C85OOASj.js");
-const require_retired_settings_keys = require("../../retired-settings-keys-Dfj9LA-i.js");
+const require_dist = require("../../dist-B17W9ngu.js");
+const require_retired_settings_keys = require("../../retired-settings-keys-CjvB7Etx.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 { $t as DeviceRole, G as deviceManagerCapability, Jt as BaseAddon, K as deviceStateCapability, L as buildStreamParamsConfigSchema, Mt as runtimeStatePolicyFor, Qt as DeviceFeature, S as STREAM_PROFILE_META, St as normalizeUnit, X as enumerateItemArrayFields, Z as enumerateSchemaFields, a as CAMERA_SWITCH_ORDER, bn as EventCategory, en as DeviceType, f as DeviceStatusSchema, fn as isDeviceConfigCap, kt as resolveContainerPrimaryChild, o as CAP_NAMES_WITH_STATUS, q as deviceStatusCapability, qt as errMsg, rn as WELL_KNOWN_TAB_MAP, t as ALL_CAPABILITY_DEFINITIONS, wt as parseStreamParamsFormPatch, yn as sleep } from "../../dist-DtDKMSeG.mjs";
-import { n as purgeRetiredSettingsRows } from "../../retired-settings-keys-Cx-lYIbU.mjs";
+import { $t as DeviceFeature, At as resolveContainerPrimaryChild, Ct as normalizeUnit, J as deviceStatusCapability, Jt as errMsg, K as deviceManagerCapability, L as buildStreamParamsConfigSchema, Nt as runtimeStatePolicyFor, Q as enumerateSchemaFields, S as STREAM_PROFILE_META, Tt as parseStreamParamsFormPatch, Yt as BaseAddon, Z as enumerateItemArrayFields, a as CAMERA_SWITCH_ORDER, bn as sleep, en as DeviceRole, f as DeviceStatusSchema, in as WELL_KNOWN_TAB_MAP, o as CAP_NAMES_WITH_STATUS, pn as isDeviceConfigCap, q as deviceStateCapability, t as ALL_CAPABILITY_DEFINITIONS, tn as DeviceType, xn as EventCategory } from "../../dist-Cyz5_i7z.mjs";
+import { n as purgeRetiredSettingsRows } from "../../retired-settings-keys-BCYUrdsA.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-C85OOASj.js");
+const require_dist = require("../../dist-B17W9ngu.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 { F as bareAddonId, J as doorbellCapability, Jt as BaseAddon, Q as evaluateSensorEdge, b as SOURCE_DEVICE_TYPES, bn as EventCategory, ct as isSameAddonId, en as DeviceType, lt as isSourceCap, qt as errMsg, sn as createEvent, y as SOURCE_CAPS } from "../../dist-DtDKMSeG.mjs";
+import { $ as evaluateSensorEdge, F as bareAddonId, Jt as errMsg, Y as doorbellCapability, Yt as BaseAddon, b as SOURCE_DEVICE_TYPES, cn as createEvent, lt as isSameAddonId, tn as DeviceType, ut as isSourceCap, xn as EventCategory, y as SOURCE_CAPS } from "../../dist-Cyz5_i7z.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-C85OOASj.js");
+const require_dist = require("../../dist-B17W9ngu.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 { Jt as BaseAddon, ht as logDestinationCapability } from "../../dist-DtDKMSeG.mjs";
+import { Yt as BaseAddon, gt as logDestinationCapability } from "../../dist-Cyz5_i7z.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-C85OOASj.js");
+const require_dist = require("../../dist-B17W9ngu.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 { Jt as BaseAddon, bn as EventCategory, qt as errMsg, sn as createEvent, v as RecordingStatusSchema } from "../../dist-DtDKMSeG.mjs";
+import { Jt as errMsg, Yt as BaseAddon, cn as createEvent, v as RecordingStatusSchema, xn as EventCategory } from "../../dist-Cyz5_i7z.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-C85OOASj.js");
+const require_dist = require("../../dist-B17W9ngu.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 { C as ScopedTokenSchema, Jt as BaseAddon, N as authProviderCapability, O as UserRecordSchema, Ut as userManagementCapability, r as ApiKeyRecordSchema } from "../../dist-DtDKMSeG.mjs";
+import { C as ScopedTokenSchema, N as authProviderCapability, O as UserRecordSchema, Wt as userManagementCapability, Yt as BaseAddon, r as ApiKeyRecordSchema } from "../../dist-Cyz5_i7z.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,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-C85OOASj.js");
-const require_tls = require("../../tls-BxQlomxd.js");
+const require_dist = require("../../dist-B17W9ngu.js");
+const require_tls = require("../../tls-BFs4PzoW.js");
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");
 let node_fs = require("node:fs");

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

@@ -1,5 +1,5 @@
-import { Jt as BaseAddon, bn as EventCategory, mt as localNetworkCapability } from "../../dist-DtDKMSeG.mjs";
-import { S as readLanHttpState, _ as DEFAULT_LAN_HTTP_PORT, a as writeTlsMode, i as writeExtraSans, l as reissueTlsLeaf, n as readTlsAccessStatus, o as validateUploadedTls, r as readTlsMode, s as ensureTlsCert, t as readExtraSans, y as applyLanHttp } from "../../tls-DOTmtLCW.mjs";
+import { Yt as BaseAddon, ht as localNetworkCapability, xn as EventCategory } from "../../dist-Cyz5_i7z.mjs";
+import { S as readLanHttpState, _ as DEFAULT_LAN_HTTP_PORT, a as writeTlsMode, i as writeExtraSans, l as reissueTlsLeaf, n as readTlsAccessStatus, o as validateUploadedTls, r as readTlsMode, s as ensureTlsCert, t as readExtraSans, y as applyLanHttp } from "../../tls-2xbgg78V.mjs";
 import { mkdir, writeFile } from "node:fs/promises";
 import { join } from "node:path";
 import { readFileSync } from "node:fs";

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-C85OOASj.js");
+const require_dist = require("../../dist-B17W9ngu.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 { Jt as BaseAddon, ht as logDestinationCapability } from "../../dist-DtDKMSeG.mjs";
+import { Yt as BaseAddon, gt as logDestinationCapability } from "../../dist-Cyz5_i7z.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/gpu-probe.d.ts

@@ -0,0 +1,18 @@
+import { MetricsGpuInfo } from '@camstack/types';
+/** `access(path, X_OK)` — resolves when executable, rejects otherwise. */
+export type AccessCheck = (path: string) => Promise<void>;
+/**
+ * The first `PATH` entry under which `binary` is executable, or `null`.
+ * An empty or missing `PATH` asks nothing.
+ */
+export declare function findOnPath(binary: string, pathEnv: string | undefined, check?: AccessCheck): Promise<string | null>;
+/** The two impure steps, injectable. */
+export interface NvidiaProbeDeps {
+    readonly findOnPath: (binary: string) => Promise<string | null>;
+    readonly exec: (command: string, args: readonly string[]) => Promise<string>;
+}
+/**
+ * `nvidia-smi`'s one-line CSV as a `MetricsGpuInfo`, or `null` when the
+ * binary is absent, fails, or prints something else. Never throws.
+ */
+export declare function readNvidiaGpu(deps: NvidiaProbeDeps): Promise<MetricsGpuInfo | null>;

package/dist/builtins/native-metrics/native-metrics-provider.d.ts

@@ -1,4 +1,4 @@
-import { SystemResourceSnapshot, MemoryInfo, DiskSpaceInfo, MetricsGpuInfo, PidResourceStats } from '@camstack/types';
+import { DiskSpaceInfo, MemoryInfo, MetricsGpuInfo, PidResourceStats, SystemResourceSnapshot } from '@camstack/types';
 interface SamplingDiagnostics {
     warn(message: string, meta?: Record<string, unknown>): void;
 }

package/dist/builtins/native-metrics/native-metrics.addon.d.ts

@@ -132,7 +132,23 @@ export default class NativeMetricsAddon extends BaseAddon<NativeMetricsConfig> {
      * agreeing on a value nobody chose.
      */
     private applyLoadSeriesConfig;
-    /** (Re)arm the fixed-cadence process-tree timer at the configured interval. */
+    /**
+     * (Re)arm the process-tree timer at the configured interval.
+     *
+     * The process-tree snapshot is FIXED-CADENCE, and its cadence is the
+     * operator's `loadSeriesCadenceSec` (5-60 s, 10 by default).
+     *
+     * It used to emit only ON A CHANGE, with a 60 s fallback heartbeat, and the
+     * dedup is gone rather than tuned. A conditional emit makes a hole in the
+     * series mean two different things — "nothing changed" and "nobody reported"
+     * — and telling those apart is the entire reason an operator opens this chart
+     * after a spike. Now a gap means exactly one thing.
+     *
+     * It is not free: the emit rate is deterministic, so the durable table's row
+     * count is too (nodes x processes / cadence, no discount for a quiet fleet).
+     * The measured cost of that is in `docs/architecture/load-ledger.md`, and it
+     * is why the retention default is six hours rather than three days.
+     */
     private startProcessSnapshotTimer;
     protected onShutdown(): Promise<void>;
     /**
@@ -149,7 +165,8 @@ export default class NativeMetricsAddon extends BaseAddon<NativeMetricsConfig> {
     /**
      * Emit one `metrics.node-processes-snapshot` for this node.
      *
-     * Heavy — a full OS `ps -eo` scan plus a `$process.list` broker call — and
+     * Heavy — a full process-table read (`/proc` on Linux, `ps -eo` elsewhere;
+     * `proc-process-table.ts`) plus a `$process.list` broker call — and
      * UNCONDITIONAL. The change-detection that used to guard it is gone: with a
      * fixed cadence a missing interval means exactly one thing, and that is the
      * property an operator investigating a spike is actually looking for.
@@ -171,13 +188,12 @@ export default class NativeMetricsAddon extends BaseAddon<NativeMetricsConfig> {
      */
     private listNodeProcesses;
     /**
-     * Ask the addon's forked runner to write a V8 heap snapshot (SIGUSR2 → the
-     * runner's diagnostic handler in addon-runner.ts), for deep per-addon memory
-     * attribution. Resolves the addon's worker pid from the kernel `$process.list`
-     * and signals it; the runner writes `/tmp/heap-<sanitized nodeId>.heapsnapshot`
-     * and logs its memoryUsage + heap-space breakdown. '$hub' targets this process.
+     * Every pid + command + resource stats on this node.
+     *
+     * From `/proc` on Linux — no fork. This used to be a `ps -eo` child on every
+     * tick, i.e. a synchronous `fork()` of hub-main at p50 91 ms (D441, D452).
+     * `ps` remains the source only on a platform without `/proc`.
      */
-    /** Raw `ps` scan returning every pid + command + resource stats. */
     private runPs;
     /**
      * The knobs live HERE, on the document this addon already owns.