@camstack/system 1.1.24 → 1.1.25

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-XWJwKYDx.js");
+const require_manifest_python_deps = require("./manifest-python-deps-BqXCckob.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,4 +1,4 @@
-import { I as createUdsLoggerWithControl, L as LocalChildClient, at as setWorkerNativeCapsChangeListener, bt as resolveAddonClass, i as createUdsAddonContext, nt as getWorkerNativeCapProvider, rt as getWorkerNativeCapSnapshot, st as validateProviderRegistrations, t as installManifestPythonDeps, yt as installManifestNativeDeps } from "./manifest-python-deps-CPJXzrZt.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-Dxl4twM3.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/platform-probe/index.d.ts

@@ -8,7 +8,29 @@ export declare class PlatformProbeNativeAddon extends BaseAddon {
     private encoderProber;
     private decodeAccelProber;
     private cachedCaps;
+    /**
+     * Per-boot generation stamp for the manual readiness emissions below.
+     * Constant for the lifetime of this addon instance (== one process boot);
+     * consumer-side registries derive a monotonic epoch from generation
+     * transitions. Mirrors `BaseAddon._readinessGeneration` (private there).
+     */
+    private readonly readinessGeneration;
     constructor();
+    /**
+     * Manual readiness protocol. The provider registers synchronously from
+     * `onInitialize`, but the REAL hardware + EP scoring is the async
+     * `probePromise` (embedded-Python install included). The BaseAddon
+     * auto-emit would flip `ready` at registration time — BEFORE any
+     * accelerator is visible — so probe-gated consumers (detection-pipeline
+     * engine auto-pick) would read accelerator-blind results and stick on
+     * onnx-CPU. Instead: `starting` at init, the single authoritative
+     * `ready` once the probe resolves, `down` on shutdown.
+     */
+    protected get autoEmitReadiness(): boolean;
+    /** Bare cluster node id — readiness is scoped `{type:'node', nodeId}`. */
+    private bareLocalNodeId;
+    /** Emit a `system.ready-state` transition for the platform-probe cap. */
+    private emitProbeReadiness;
     /**
      * Resolve the ffmpeg binary the encoder probe should test, from the cluster
      * `ffmpeg` config section (`binaryPath`). The probe MUST exercise the same

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

@@ -594,15 +594,86 @@ var HardwareDecodeAccelProber = class {
 };
 //#endregion
 //#region src/builtins/platform-probe/index.ts
+/**
+* The decode-hwaccel backends `ctx.kernel.hwaccel.resolve` accepts. The cap
+* input enum is WIDER (it also carries EP-only names — coreml/openvino/… —
+* shared with other probe surfaces), so the provider param must stay
+* `string`-typed to satisfy the `InferProvider` contract. We narrow it here
+* with a type guard instead of a cast: any value that is not a known decode
+* backend (or the `'none'` sentinel) resolves to `null` → auto-probe.
+*/
+var HWACCEL_DECODE_BACKENDS = [
+	"videotoolbox",
+	"cuda",
+	"nvdec",
+	"vaapi",
+	"qsv",
+	"d3d11va",
+	"dxva2",
+	"amf",
+	"vdpau",
+	"drm"
+];
+function isHwAccelBackend(value) {
+	return HWACCEL_DECODE_BACKENDS.includes(value);
+}
+function narrowHwAccelPrefer(value) {
+	if (value === "none") return "none";
+	if (typeof value === "string" && isHwAccelBackend(value)) return value;
+	return null;
+}
 var PlatformProbeNativeAddon = class extends _camstack_types.BaseAddon {
 	scorer = null;
 	encoderProber = null;
 	decodeAccelProber = null;
 	cachedCaps = null;
+	/**
+	* Per-boot generation stamp for the manual readiness emissions below.
+	* Constant for the lifetime of this addon instance (== one process boot);
+	* consumer-side registries derive a monotonic epoch from generation
+	* transitions. Mirrors `BaseAddon._readinessGeneration` (private there).
+	*/
+	readinessGeneration = typeof crypto !== "undefined" && crypto.randomUUID ? crypto.randomUUID() : Math.random().toString(36).slice(2, 14);
 	constructor() {
 		super({});
 	}
 	/**
+	* Manual readiness protocol. The provider registers synchronously from
+	* `onInitialize`, but the REAL hardware + EP scoring is the async
+	* `probePromise` (embedded-Python install included). The BaseAddon
+	* auto-emit would flip `ready` at registration time — BEFORE any
+	* accelerator is visible — so probe-gated consumers (detection-pipeline
+	* engine auto-pick) would read accelerator-blind results and stick on
+	* onnx-CPU. Instead: `starting` at init, the single authoritative
+	* `ready` once the probe resolves, `down` on shutdown.
+	*/
+	get autoEmitReadiness() {
+		return false;
+	}
+	/** Bare cluster node id — readiness is scoped `{type:'node', nodeId}`. */
+	bareLocalNodeId() {
+		const raw = this.ctx.kernel?.localNodeId ?? "hub";
+		return raw.includes("/") ? raw.split("/")[0] : raw;
+	}
+	/** Emit a `system.ready-state` transition for the platform-probe cap. */
+	emitProbeReadiness(state) {
+		const ctx = this.ctxIfReady;
+		if (!ctx) return;
+		const nodeId = this.bareLocalNodeId();
+		try {
+			(0, _camstack_types.emitReadiness)(ctx.eventBus, {
+				capName: _camstack_types.platformProbeCapability.name,
+				scope: {
+					type: "node",
+					nodeId
+				},
+				state,
+				generation: this.readinessGeneration,
+				sourceNodeId: nodeId
+			});
+		} catch {}
+	}
+	/**
 	* Resolve the ffmpeg binary the encoder probe should test, from the cluster
 	* `ffmpeg` config section (`binaryPath`). The probe MUST exercise the same
 	* binary the broker/recorder spawn, or it may report encoders for a different
@@ -617,6 +688,7 @@ var PlatformProbeNativeAddon = class extends _camstack_types.BaseAddon {
 		}
 	}
 	async onInitialize() {
+		this.emitProbeReadiness("starting");
 		const embeddedPython = await this.ctx.deps.ensurePython().catch((err) => {
 			this.ctx.logger.debug("ensurePython unavailable for platform probe", { meta: { error: (0, _camstack_types.errMsg)(err) } });
 			return null;
@@ -651,6 +723,7 @@ var PlatformProbeNativeAddon = class extends _camstack_types.BaseAddon {
 				bestReason: caps.bestScore.reason,
 				bestScore: caps.bestScore.score
 			} });
+			this.emitProbeReadiness("ready");
 			return caps;
 		}).catch((err) => {
 			const msg = (0, _camstack_types.errMsg)(err);
@@ -676,8 +749,15 @@ var PlatformProbeNativeAddon = class extends _camstack_types.BaseAddon {
 				},
 				resolveHwAccel: async (input) => {
 					const hwaccel = this.ctx.kernel.hwaccel;
-					if (!hwaccel) return { preferred: [] };
-					return { preferred: (await hwaccel.resolve(input.prefer ?? null)).preferred };
+					if (!hwaccel) return {
+						preferred: [],
+						rationale: "kernel hwaccel unavailable"
+					};
+					const res = await hwaccel.resolve(narrowHwAccelPrefer(input.prefer));
+					return {
+						preferred: res.preferred,
+						rationale: res.rationale
+					};
 				},
 				getHardwareEncoders: async () => {
 					const prober = this.encoderProber;
@@ -707,6 +787,7 @@ var PlatformProbeNativeAddon = class extends _camstack_types.BaseAddon {
 		}];
 	}
 	async onShutdown() {
+		this.emitProbeReadiness("down");
 		this.scorer = null;
 		this.encoderProber = null;
 		this.decodeAccelProber = null;

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

@@ -1,5 +1,5 @@
 import * as fs from "node:fs";
-import { BaseAddon, EventCategory, errMsg, platformProbeCapability, scoreRuntimes } from "@camstack/types";
+import { BaseAddon, EventCategory, emitReadiness, errMsg, platformProbeCapability, scoreRuntimes } from "@camstack/types";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import * as os from "node:os";
@@ -587,15 +587,86 @@ var HardwareDecodeAccelProber = class {
 };
 //#endregion
 //#region src/builtins/platform-probe/index.ts
+/**
+* The decode-hwaccel backends `ctx.kernel.hwaccel.resolve` accepts. The cap
+* input enum is WIDER (it also carries EP-only names — coreml/openvino/… —
+* shared with other probe surfaces), so the provider param must stay
+* `string`-typed to satisfy the `InferProvider` contract. We narrow it here
+* with a type guard instead of a cast: any value that is not a known decode
+* backend (or the `'none'` sentinel) resolves to `null` → auto-probe.
+*/
+var HWACCEL_DECODE_BACKENDS = [
+	"videotoolbox",
+	"cuda",
+	"nvdec",
+	"vaapi",
+	"qsv",
+	"d3d11va",
+	"dxva2",
+	"amf",
+	"vdpau",
+	"drm"
+];
+function isHwAccelBackend(value) {
+	return HWACCEL_DECODE_BACKENDS.includes(value);
+}
+function narrowHwAccelPrefer(value) {
+	if (value === "none") return "none";
+	if (typeof value === "string" && isHwAccelBackend(value)) return value;
+	return null;
+}
 var PlatformProbeNativeAddon = class extends BaseAddon {
 	scorer = null;
 	encoderProber = null;
 	decodeAccelProber = null;
 	cachedCaps = null;
+	/**
+	* Per-boot generation stamp for the manual readiness emissions below.
+	* Constant for the lifetime of this addon instance (== one process boot);
+	* consumer-side registries derive a monotonic epoch from generation
+	* transitions. Mirrors `BaseAddon._readinessGeneration` (private there).
+	*/
+	readinessGeneration = typeof crypto !== "undefined" && crypto.randomUUID ? crypto.randomUUID() : Math.random().toString(36).slice(2, 14);
 	constructor() {
 		super({});
 	}
 	/**
+	* Manual readiness protocol. The provider registers synchronously from
+	* `onInitialize`, but the REAL hardware + EP scoring is the async
+	* `probePromise` (embedded-Python install included). The BaseAddon
+	* auto-emit would flip `ready` at registration time — BEFORE any
+	* accelerator is visible — so probe-gated consumers (detection-pipeline
+	* engine auto-pick) would read accelerator-blind results and stick on
+	* onnx-CPU. Instead: `starting` at init, the single authoritative
+	* `ready` once the probe resolves, `down` on shutdown.
+	*/
+	get autoEmitReadiness() {
+		return false;
+	}
+	/** Bare cluster node id — readiness is scoped `{type:'node', nodeId}`. */
+	bareLocalNodeId() {
+		const raw = this.ctx.kernel?.localNodeId ?? "hub";
+		return raw.includes("/") ? raw.split("/")[0] : raw;
+	}
+	/** Emit a `system.ready-state` transition for the platform-probe cap. */
+	emitProbeReadiness(state) {
+		const ctx = this.ctxIfReady;
+		if (!ctx) return;
+		const nodeId = this.bareLocalNodeId();
+		try {
+			emitReadiness(ctx.eventBus, {
+				capName: platformProbeCapability.name,
+				scope: {
+					type: "node",
+					nodeId
+				},
+				state,
+				generation: this.readinessGeneration,
+				sourceNodeId: nodeId
+			});
+		} catch {}
+	}
+	/**
 	* Resolve the ffmpeg binary the encoder probe should test, from the cluster
 	* `ffmpeg` config section (`binaryPath`). The probe MUST exercise the same
 	* binary the broker/recorder spawn, or it may report encoders for a different
@@ -610,6 +681,7 @@ var PlatformProbeNativeAddon = class extends BaseAddon {
 		}
 	}
 	async onInitialize() {
+		this.emitProbeReadiness("starting");
 		const embeddedPython = await this.ctx.deps.ensurePython().catch((err) => {
 			this.ctx.logger.debug("ensurePython unavailable for platform probe", { meta: { error: errMsg(err) } });
 			return null;
@@ -644,6 +716,7 @@ var PlatformProbeNativeAddon = class extends BaseAddon {
 				bestReason: caps.bestScore.reason,
 				bestScore: caps.bestScore.score
 			} });
+			this.emitProbeReadiness("ready");
 			return caps;
 		}).catch((err) => {
 			const msg = errMsg(err);
@@ -669,8 +742,15 @@ var PlatformProbeNativeAddon = class extends BaseAddon {
 				},
 				resolveHwAccel: async (input) => {
 					const hwaccel = this.ctx.kernel.hwaccel;
-					if (!hwaccel) return { preferred: [] };
-					return { preferred: (await hwaccel.resolve(input.prefer ?? null)).preferred };
+					if (!hwaccel) return {
+						preferred: [],
+						rationale: "kernel hwaccel unavailable"
+					};
+					const res = await hwaccel.resolve(narrowHwAccelPrefer(input.prefer));
+					return {
+						preferred: res.preferred,
+						rationale: res.rationale
+					};
 				},
 				getHardwareEncoders: async () => {
 					const prober = this.encoderProber;
@@ -700,6 +780,7 @@ var PlatformProbeNativeAddon = class extends BaseAddon {
 		}];
 	}
 	async onShutdown() {
+		this.emitProbeReadiness("down");
 		this.scorer = null;
 		this.encoderProber = null;
 		this.decodeAccelProber = null;

package/dist/index.js

@@ -20,7 +20,7 @@ const require_builtins_local_auth_local_auth_addon = require("./builtins/local-a
 require("./builtins/local-auth/index.js");
 const require_builtins_device_manager_device_manager_addon = require("./builtins/device-manager/device-manager.addon.js");
 require("./builtins/device-manager/index.js");
-const require_manifest_python_deps = require("./manifest-python-deps-XWJwKYDx.js");
+const require_manifest_python_deps = require("./manifest-python-deps-BqXCckob.js");
 const require_custom_action_registry = require("./custom-action-registry-vLYEFTtv.js");
 let _camstack_types_node = require("@camstack/types/node");
 let node_http = require("node:http");
@@ -93415,7 +93415,6 @@ exports.createCoreCapService = createCoreCapService;
 exports.createFileDataPlaneHandler = require_model_download_service.createFileDataPlaneHandler;
 exports.createHubCapForwardService = require_manifest_python_deps.createHubCapForwardService;
 exports.createHubService = createHubService;
-exports.createHwAccelService = require_manifest_python_deps.createHwAccelService;
 exports.createKernelHwAccel = require_manifest_python_deps.createKernelHwAccel;
 exports.createLocalTransport = require_manifest_python_deps.createLocalTransport;
 exports.createParentUnownedCallHandler = require_manifest_python_deps.createParentUnownedCallHandler;

package/dist/index.mjs

@@ -18,7 +18,7 @@ import { LocalAuthAddon, a as require_ms, c as __esmMin, d as __toCommonJS, f as
 import "./builtins/local-auth/index.mjs";
 import { DeviceManagerAddon } from "./builtins/device-manager/device-manager.addon.mjs";
 import "./builtins/device-manager/index.mjs";
-import { $ as buildNativeCapProxy, A as createHubCapForwardService, B as AGENT_CAP_FWD_ACTION, C as brokerTransportLink, D as localProviderLink, E as ipcParentLink, F as createUdsLogger, G as callWithServiceDiscovery, H as CapRouteResolver, I as createUdsLoggerWithControl, J as UdsLocalTransportServer, K as createLocalTransport, L as LocalChildClient, M as createUdsEventBridge, N as createUdsEventBus, O as HUB_CAP_FWD_ACTION, P as udsChildLogToWorkerEntry, Q as encodeFrame, R as LocalChildRegistry, S as brokerCallForCap, T as ipcChildLink, U as CapRouteError, V as AGENT_CAP_FWD_SERVICE, W as classifyCapRoute, X as localEndpointPath, Y as SocketChannel, Z as FrameDecoder, _ as resolveHwAccel, _t as CapabilityHandle, a as getWorkerDeviceRegistry, b as __resetCapUsageRegistryForTests, bt as resolveAddonClass, c as setHubConnected, ct as NATIVE_PROVIDER_SERVICE_INFIX, d as getMoleculerEventStats, dt as capBareAction, et as buildUdsNativeCapProxy, f as registerEventBusService, ft as capServiceName, g as createKernelHwAccel, gt as DeviceRegistry, h as AddonDepsManager, ht as serializeTypedArrays, i as createUdsAddonContext, it as mountNativeCapService, j as createParentUnownedCallHandler, k as HUB_CAP_FWD_SERVICE, l as EVENT_TOPIC_PREFIX, lt as capActionName, m as subscribePassthrough, mt as deserializeTypedArrays, n as adaptBrokerToCluster, o as getOrInitReadinessRegistry, ot as createAddonService, p as setNodeEventInterest, pt as parseCapAction, q as UdsLocalTransportClient, r as createAddonContext, s as getOrInitReadinessRegistryForClient, st as validateProviderRegistrations, t as installManifestPythonDeps, tt as createBrokerDeviceManagerApi, u as getBrokerEventBus, ut as capActionSuffix, v as createHwAccelService, vt as CapabilityUnavailableError, w as buildLinkChain, x as getCapUsageRegistry, y as CapUsageRegistry, yt as installManifestNativeDeps, z as UDS_NO_ROUTE_PREFIX } from "./manifest-python-deps-CPJXzrZt.mjs";
+import { $ as buildUdsNativeCapProxy, A as createParentUnownedCallHandler, B as AGENT_CAP_FWD_SERVICE, C as buildLinkChain, D as HUB_CAP_FWD_ACTION, E as localProviderLink, F as createUdsLoggerWithControl, G as createLocalTransport, H as CapRouteError, I as LocalChildClient, J as SocketChannel, K as UdsLocalTransportClient, L as LocalChildRegistry, M as createUdsEventBus, N as udsChildLogToWorkerEntry, O as HUB_CAP_FWD_SERVICE, P as createUdsLogger, Q as buildNativeCapProxy, R as UDS_NO_ROUTE_PREFIX, S as brokerTransportLink, T as ipcParentLink, U as classifyCapRoute, V as CapRouteResolver, W as callWithServiceDiscovery, X as FrameDecoder, Y as localEndpointPath, Z as encodeFrame, _ as resolveHwAccel, _t as CapabilityUnavailableError, a as getWorkerDeviceRegistry, at as createAddonService, b as getCapUsageRegistry, c as setHubConnected, ct as capActionName, d as getMoleculerEventStats, dt as capServiceName, et as createBrokerDeviceManagerApi, f as registerEventBusService, ft as parseCapAction, g as createKernelHwAccel, gt as CapabilityHandle, h as AddonDepsManager, ht as DeviceRegistry, i as createUdsAddonContext, j as createUdsEventBridge, k as createHubCapForwardService, l as EVENT_TOPIC_PREFIX, lt as capActionSuffix, m as subscribePassthrough, mt as serializeTypedArrays, n as adaptBrokerToCluster, o as getOrInitReadinessRegistry, ot as validateProviderRegistrations, p as setNodeEventInterest, pt as deserializeTypedArrays, q as UdsLocalTransportServer, r as createAddonContext, rt as mountNativeCapService, s as getOrInitReadinessRegistryForClient, st as NATIVE_PROVIDER_SERVICE_INFIX, t as installManifestPythonDeps, u as getBrokerEventBus, ut as capBareAction, v as CapUsageRegistry, vt as installManifestNativeDeps, w as ipcChildLink, x as brokerCallForCap, y as __resetCapUsageRegistryForTests, yt as resolveAddonClass, z as AGENT_CAP_FWD_ACTION } from "./manifest-python-deps-Dxl4twM3.mjs";
 import { t as CustomActionRegistry } from "./custom-action-registry-BEXwC-oo.mjs";
 import { PYTHON_VERSION, buildBinaryPath, downloadBinary, ensureBinary, ensureFfmpeg, ensurePython, findInPath, getFfmpegDownloadUrl, getPlatformInfo, getPythonDownloadUrl, installPythonPackages, installPythonRequirements } from "@camstack/types/node";
 import { request } from "node:http";
@@ -93252,4 +93252,4 @@ async function stageFrameworkLockstep(input) {
 	return results;
 }
 //#endregion
-export { AGENT_CAP_FWD_ACTION, AGENT_CAP_FWD_SERVICE, AddonApiFactory, AddonDepsManager, AddonEngineManager, AddonHealthMonitor, AddonInstaller, AddonLoader, AddonManifest, AddonRouteRegistry, AlertCenterAddon, ApiKeyManager, AuthManager, CLUSTER_SECRET_MISMATCH_TYPE, CLUSTER_SECRET_REJECTED_EXIT_CODE, CORE_CAP_SERVICE_NAME, CapRouteError, CapRouteResolver, CapUsageRegistry, CapabilityHandle, CapabilityRegistry, CapabilityUnavailableError, ConfigManager, ConfigStore, ConsoleDestination, ConsoleLoggingAddon, CustomActionRegistry, DEFAULT_DATA_PATH, DataPlaneRegistry, DeviceManagerAddon, DeviceRegistry, DeviceStore, EVENT_TOPIC_PREFIX, EngineManagerResolver, EventBus, FRAMEWORK_LOCKSTEP, FeatureManager, FilesystemStorageAddon, FilesystemStorageProvider, FrameDecoder, FsStorageBackend, HEALTH_MONITOR_GRACE_PERIOD_MS, HEALTH_MONITOR_RETRY_INTERVALS_MS, HEALTH_MONITOR_TICK_MS, HUB_CAP_FWD_ACTION, HUB_CAP_FWD_SERVICE, HubForwarderAddon, HubForwarderDestination, HubLogForwarder, HubNodeRegistry, INFRA_CAPABILITIES, IntegrationRegistry, JobJournal, LifecycleJobEngine, LifecycleStateMachine, LocalAuthAddon, LocalChildClient, LocalChildRegistry, LogManager, LogRingBuffer, ModelDownloadService, NATIVE_PROVIDER_SERVICE_INFIX, NativeMetricsAddon, NativeMetricsProvider, NetworkQualityTracker, NotificationService, PYTHON_VERSION, PipelineRunner, PipelineValidator, PythonEnvManager, RESTART_MARKER_FILE, RUNTIME_DEFAULTS, ReadinessRegistry, ReadinessTimeoutError, ReplEngine, RingBuffer, ScopedLogger, ScopedTokenManager, SocketChannel, SqliteSettingsAddon, SqliteSettingsBackend, StagingArea, StorageLocationManager, StorageManager, StorageOrchestratorAddon, StorageOrchestratorService, SystemConfigAddon, SystemEventBus, ToastService, UDS_NO_ROUTE_PREFIX, UdsLocalTransportClient, UdsLocalTransportServer, UserManager, WinstonDestination, WinstonLoggingAddon, __resetCapUsageRegistryForTests, adaptBrokerToCluster, bootstrapSchema, brokerCallForCap, brokerTransportLink, buildBinaryPath, buildCapRouters, buildLinkChain, buildNativeCapProxy, buildNodeManifest, buildStorageLocationRegistry, buildUdsNativeCapProxy, builderMountedCapNames, callRegisterNodeWithRetry, callWithServiceDiscovery, capActionName, capActionSuffix, capBareAction, capServiceName, classifyCapRoute, clearPendingRestart, clusterSecretMatches, collectModelFiles, contentTypeFor, copyDirRecursive, copyExtraFileDirs, createAddonContext, createAddonService, createAuthenticatedFileServer, createBroker, createBrokerDeviceManagerApi, createCoreCapService, createFileDataPlaneHandler, createHubCapForwardService, createHubService, createHwAccelService, createKernelHwAccel, createLocalTransport, createParentUnownedCallHandler, createProcessService, createReadinessService, createReadinessServiceForRegistry, createScopedProcessManager, createStreamProbeBrokerService, createUdsAddonContext, createUdsEventBridge, createUdsEventBus, createUdsLogger, createUdsLoggerWithControl, deleteModelFromDisk, deriveAgentListenPort, describeProviderKindDrift, detectWorkspacePackagesDir, downloadBinary, downloadFile, downloadModel, emitDownForOwnedCaps, encodeFrame, ensureBinary, ensureDir, ensureFfmpeg, ensureLibraryBuilt, ensureModel, ensurePython, ensureTlsCert, fetchJson, findInPath, formatLogLine, getBrokerEventBus, getCapUsageRegistry, getFfmpegDownloadUrl, getModelFilePath, getMoleculerEventStats, getOrInitReadinessRegistry, getOrInitReadinessRegistryForClient, getPidStats, getPlatformInfo, getPythonDownloadUrl, getRestartMarkerPath, getSinglePidStats, getWorkerDeviceRegistry, hashClusterSecret, installManifestNativeDeps, installManifestPythonDeps, installPackageFromNpm, installPythonPackages, installPythonRequirements, ipcChildLink, ipcParentLink, isAddonDeploySource, isClusterSecretMismatchError, isInfraCapability, isModelDownloaded, isSourceNewer, loadTlsCert, localEndpointPath, localProviderLink, mountNativeCapService, parseCapAction, parseRangeHeader, parseTokenizedUrl, proxyToUpstream, readPendingRestart, readinessKey, registerEventBusService, resolveFilePath, resolveHwAccel, scheduleSelfRestart, scopeKey, scopesAllowDeviceCap, serializeTypedArrays, setHubConnected, setNodeEventInterest, stageFrameworkLockstep, stripCamstackDeps, subscribePassthrough, udsChildLogToWorkerEntry, validateProviderRegistrations, writePendingRestart };
+export { AGENT_CAP_FWD_ACTION, AGENT_CAP_FWD_SERVICE, AddonApiFactory, AddonDepsManager, AddonEngineManager, AddonHealthMonitor, AddonInstaller, AddonLoader, AddonManifest, AddonRouteRegistry, AlertCenterAddon, ApiKeyManager, AuthManager, CLUSTER_SECRET_MISMATCH_TYPE, CLUSTER_SECRET_REJECTED_EXIT_CODE, CORE_CAP_SERVICE_NAME, CapRouteError, CapRouteResolver, CapUsageRegistry, CapabilityHandle, CapabilityRegistry, CapabilityUnavailableError, ConfigManager, ConfigStore, ConsoleDestination, ConsoleLoggingAddon, CustomActionRegistry, DEFAULT_DATA_PATH, DataPlaneRegistry, DeviceManagerAddon, DeviceRegistry, DeviceStore, EVENT_TOPIC_PREFIX, EngineManagerResolver, EventBus, FRAMEWORK_LOCKSTEP, FeatureManager, FilesystemStorageAddon, FilesystemStorageProvider, FrameDecoder, FsStorageBackend, HEALTH_MONITOR_GRACE_PERIOD_MS, HEALTH_MONITOR_RETRY_INTERVALS_MS, HEALTH_MONITOR_TICK_MS, HUB_CAP_FWD_ACTION, HUB_CAP_FWD_SERVICE, HubForwarderAddon, HubForwarderDestination, HubLogForwarder, HubNodeRegistry, INFRA_CAPABILITIES, IntegrationRegistry, JobJournal, LifecycleJobEngine, LifecycleStateMachine, LocalAuthAddon, LocalChildClient, LocalChildRegistry, LogManager, LogRingBuffer, ModelDownloadService, NATIVE_PROVIDER_SERVICE_INFIX, NativeMetricsAddon, NativeMetricsProvider, NetworkQualityTracker, NotificationService, PYTHON_VERSION, PipelineRunner, PipelineValidator, PythonEnvManager, RESTART_MARKER_FILE, RUNTIME_DEFAULTS, ReadinessRegistry, ReadinessTimeoutError, ReplEngine, RingBuffer, ScopedLogger, ScopedTokenManager, SocketChannel, SqliteSettingsAddon, SqliteSettingsBackend, StagingArea, StorageLocationManager, StorageManager, StorageOrchestratorAddon, StorageOrchestratorService, SystemConfigAddon, SystemEventBus, ToastService, UDS_NO_ROUTE_PREFIX, UdsLocalTransportClient, UdsLocalTransportServer, UserManager, WinstonDestination, WinstonLoggingAddon, __resetCapUsageRegistryForTests, adaptBrokerToCluster, bootstrapSchema, brokerCallForCap, brokerTransportLink, buildBinaryPath, buildCapRouters, buildLinkChain, buildNativeCapProxy, buildNodeManifest, buildStorageLocationRegistry, buildUdsNativeCapProxy, builderMountedCapNames, callRegisterNodeWithRetry, callWithServiceDiscovery, capActionName, capActionSuffix, capBareAction, capServiceName, classifyCapRoute, clearPendingRestart, clusterSecretMatches, collectModelFiles, contentTypeFor, copyDirRecursive, copyExtraFileDirs, createAddonContext, createAddonService, createAuthenticatedFileServer, createBroker, createBrokerDeviceManagerApi, createCoreCapService, createFileDataPlaneHandler, createHubCapForwardService, createHubService, createKernelHwAccel, createLocalTransport, createParentUnownedCallHandler, createProcessService, createReadinessService, createReadinessServiceForRegistry, createScopedProcessManager, createStreamProbeBrokerService, createUdsAddonContext, createUdsEventBridge, createUdsEventBus, createUdsLogger, createUdsLoggerWithControl, deleteModelFromDisk, deriveAgentListenPort, describeProviderKindDrift, detectWorkspacePackagesDir, downloadBinary, downloadFile, downloadModel, emitDownForOwnedCaps, encodeFrame, ensureBinary, ensureDir, ensureFfmpeg, ensureLibraryBuilt, ensureModel, ensurePython, ensureTlsCert, fetchJson, findInPath, formatLogLine, getBrokerEventBus, getCapUsageRegistry, getFfmpegDownloadUrl, getModelFilePath, getMoleculerEventStats, getOrInitReadinessRegistry, getOrInitReadinessRegistryForClient, getPidStats, getPlatformInfo, getPythonDownloadUrl, getRestartMarkerPath, getSinglePidStats, getWorkerDeviceRegistry, hashClusterSecret, installManifestNativeDeps, installManifestPythonDeps, installPackageFromNpm, installPythonPackages, installPythonRequirements, ipcChildLink, ipcParentLink, isAddonDeploySource, isClusterSecretMismatchError, isInfraCapability, isModelDownloaded, isSourceNewer, loadTlsCert, localEndpointPath, localProviderLink, mountNativeCapService, parseCapAction, parseRangeHeader, parseTokenizedUrl, proxyToUpstream, readPendingRestart, readinessKey, registerEventBusService, resolveFilePath, resolveHwAccel, scheduleSelfRestart, scopeKey, scopesAllowDeviceCap, serializeTypedArrays, setHubConnected, setNodeEventInterest, stageFrameworkLockstep, stripCamstackDeps, subscribePassthrough, udsChildLogToWorkerEntry, validateProviderRegistrations, writePendingRestart };

package/dist/kernel/index.d.ts

@@ -51,13 +51,11 @@ export type { UdsReadinessClient } from './moleculer/readiness-context.js';
 export { createStreamProbeBrokerService } from './moleculer/stream-probe-service.js';
 export type { StreamProbeBrokerDeps } from './moleculer/stream-probe-service.js';
 export { resolveHwAccel, createKernelHwAccel } from './hwaccel/hwaccel-resolver.js';
-export { createHwAccelService } from './hwaccel/hwaccel-service.js';
 export { AddonDepsManager } from './deps/addon-deps-manager.js';
 export { installManifestPythonDeps } from './deps/manifest-python-deps.js';
 export { installManifestNativeDeps } from './deps/manifest-native-deps.js';
 export { AddonHealthMonitor, HEALTH_MONITOR_TICK_MS, HEALTH_MONITOR_GRACE_PERIOD_MS, HEALTH_MONITOR_RETRY_INTERVALS_MS, } from './addon-health-monitor.js';
 export type { AddonHealthPhase, AddonHealthState, AddonHealthSnapshot, AddonHealthMonitorOptions, } from './addon-health-monitor.js';
-export type { HwAccelServiceDeps } from './hwaccel/hwaccel-service.js';
 export type { HubServiceDeps } from './moleculer/hub-service.js';
 export { createBrokerDeviceManagerApi, buildNativeCapProxy, buildUdsNativeCapProxy, mountNativeCapService, NATIVE_PROVIDER_SERVICE_INFIX, } from './moleculer/device-cap-proxy.js';
 export type { WorkerDeviceManagerOptions } from './moleculer/device-cap-proxy.js';

package/dist/kernel/transport/parent-unowned-call.d.ts

@@ -58,6 +58,26 @@ export interface ParentUnownedCallDeps {
      * deviceId-carrying SYSTEM-cap calls (e.g. `system.info({deviceId})`) fast.
      */
     readonly isDeviceNativeCap?: (capName: string) => boolean;
+    /**
+     * Optional predicate — returns `true` when `capName` declares
+     * `nodeIdMode: 'data'` in its `CapabilityDefinition` (`addon-settings`,
+     * `addons`, `nodes`, `pipeline-orchestrator`): an inline `nodeId` in the
+     * call args is DATA for the (hub-singleton) provider, which dispatches
+     * internally — NOT a routing hint. For such caps the handler must NOT lift
+     * `args.nodeId` into a routing pin: pinning routes the call to a node with
+     * no provider for the cap (e.g. a forked addon on an agent calling
+     * `addon-settings.getGlobalSettings({addonId, nodeId})` gets pinned to
+     * `nodeId` → dead broker fallback → ServiceNotFoundError). Suppressing the
+     * pin forwards the call unpinned → singleton resolution on the hub — exactly
+     * how `settings-store` (no `nodeId` arg) already behaves. `args` pass
+     * through UNTOUCHED: the provider still reads `nodeId` as data.
+     *
+     * The kernel layer has no cap registry, so the wiring side (which does)
+     * injects this. Omitted (or returning `false`) ⇒ legacy behaviour exactly:
+     * an inline `args.nodeId` keeps pinning (benchmark, platform-probe,
+     * pipeline-runner node-pinned execution is unaffected).
+     */
+    readonly isDataNodeIdCap?: (capName: string) => boolean;
     /**
      * Optional forward-to-hub dispatcher (the AGENT path). When present, a cap
      * that no agent-LOCAL child owns is forwarded to the hub's `$hub-cap-fwd`

package/dist/{manifest-python-deps-XWJwKYDx.js → manifest-python-deps-BqXCckob.js}

@@ -4880,7 +4880,7 @@ var delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 function createParentUnownedCallHandler(deps) {
 	return async (input) => {
 		const deviceId = input.deviceId ?? extractDeviceId(input.args);
-		const nodeId = input.nodeId ?? extractNodeId(input.args);
+		const nodeId = deps.isDataNodeIdCap?.(input.capName) === true ? void 0 : input.nodeId ?? extractNodeId(input.args);
 		if (nodeId === void 0) {
 			const empty = deps.resolveEmptyCollection?.(input.capName, input.method);
 			if (empty != null) return empty;
@@ -5526,16 +5526,6 @@ function __resetCapUsageRegistryForTests() {
 	singleton = null;
 }
 //#endregion
-//#region src/kernel/hwaccel/hwaccel-service.ts
-function createHwAccelService(deps) {
-	return {
-		name: "$hwaccel",
-		actions: { resolve: { async handler(ctx) {
-			return deps.resolve(ctx.params.prefer ?? null);
-		} } }
-	};
-}
-//#endregion
 //#region src/kernel/hwaccel/hwaccel-resolver.ts
 /**
 * Platform-probe for hardware video decode acceleration.
@@ -6629,24 +6619,6 @@ function createRemoteProviderProxy(broker, serviceName, capName, nodeId, methods
 function runtimeNodeId(runtime) {
 	return runtime.mode === "broker" ? runtime.broker.nodeID : runtime.nodeId;
 }
-var hwaccelRegistered = /* @__PURE__ */ new WeakSet();
-/**
-* Idempotently register the per-node `$hwaccel` Moleculer service on
-* `broker`. Safe to call multiple times. The service exposes the
-* local platform probe as `$hwaccel.resolve` so cross-node queries
-* (`broker.call('$hwaccel.resolve', p, { nodeID })`) work.
-*/
-function ensureHwAccelService(broker) {
-	if (hwaccelRegistered.has(broker)) return;
-	const bkr = broker;
-	try {
-		bkr.createService(createHwAccelService(createKernelHwAccel()));
-		hwaccelRegistered.add(broker);
-	} catch (err) {
-		if (!(err instanceof Error ? err.message : String(err)).includes("already registered")) throw err;
-		hwaccelRegistered.add(broker);
-	}
-}
 /**
 * Adapt a Moleculer ServiceBroker to the camstack-types `IClusterBroker`
 * structural interface so addons can consume cluster-level RPC without
@@ -6953,7 +6925,6 @@ async function buildAddonContext(runtime, declaration, dataDir, options) {
 					value
 				})
 			};
-			if (runtime.mode === "broker") ensureHwAccelService(runtime.broker);
 			const hwaccel = createKernelHwAccel();
 			return {
 				localNodeId: nodeId,
@@ -7313,12 +7284,6 @@ Object.defineProperty(exports, "createHubCapForwardService", {
 		return createHubCapForwardService;
 	}
 });
-Object.defineProperty(exports, "createHwAccelService", {
-	enumerable: true,
-	get: function() {
-		return createHwAccelService;
-	}
-});
 Object.defineProperty(exports, "createKernelHwAccel", {
 	enumerable: true,
 	get: function() {

package/dist/{manifest-python-deps-CPJXzrZt.mjs → manifest-python-deps-Dxl4twM3.mjs}

@@ -11,7 +11,7 @@ import { promisify } from "node:util";
 import * as os from "node:os";
 import { tmpdir } from "node:os";
 import { unlink } from "node:fs/promises";
-import { DATAPLANE_SECRET_HEADER as DATAPLANE_SECRET_HEADER$1, DeviceType as DeviceType$1, DisposerChain, EventCategory as EventCategory$1, ReadinessRegistry, asJsonObject as asJsonObject$1, asString as asString$1, createDeviceProxy, deviceOpsCapability, emitReadiness, errMsg as errMsg$1, expandCapMethods as expandCapMethods$1, scopeKey, sleep as sleep$1 } from "@camstack/types/addon";
+import { DATAPLANE_SECRET_HEADER as DATAPLANE_SECRET_HEADER$1, DeviceType as DeviceType$1, DisposerChain, EventCategory as EventCategory$1, ReadinessRegistry, asJsonObject as asJsonObject$1, asString as asString$1, createDeviceProxy, deviceOpsCapability, emitReadiness as emitReadiness$1, errMsg as errMsg$1, expandCapMethods as expandCapMethods$1, scopeKey, sleep as sleep$1 } from "@camstack/types/addon";
 import { TRPCClientError, createTRPCClient } from "@trpc/client";
 import { connect, createServer as createServer$1 } from "node:net";
 //#region src/kernel/addon-class-resolver.ts
@@ -1237,7 +1237,7 @@ function createBrokerDeviceManagerApi(opts) {
 						nodeId
 					}
 				});
-				emitReadiness(eventBus, {
+				emitReadiness$1(eventBus, {
 					capName: cap.name,
 					scope: {
 						type: "device",
@@ -1780,7 +1780,7 @@ function createBrokerDeviceManagerApi(opts) {
 						nodeId
 					}
 				});
-				emitReadiness(eventBus, {
+				emitReadiness$1(eventBus, {
 					capName,
 					scope: {
 						type: "device",
@@ -4878,7 +4878,7 @@ var delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 function createParentUnownedCallHandler(deps) {
 	return async (input) => {
 		const deviceId = input.deviceId ?? extractDeviceId(input.args);
-		const nodeId = input.nodeId ?? extractNodeId(input.args);
+		const nodeId = deps.isDataNodeIdCap?.(input.capName) === true ? void 0 : input.nodeId ?? extractNodeId(input.args);
 		if (nodeId === void 0) {
 			const empty = deps.resolveEmptyCollection?.(input.capName, input.method);
 			if (empty != null) return empty;
@@ -5524,16 +5524,6 @@ function __resetCapUsageRegistryForTests() {
 	singleton = null;
 }
 //#endregion
-//#region src/kernel/hwaccel/hwaccel-service.ts
-function createHwAccelService(deps) {
-	return {
-		name: "$hwaccel",
-		actions: { resolve: { async handler(ctx) {
-			return deps.resolve(ctx.params.prefer ?? null);
-		} } }
-	};
-}
-//#endregion
 //#region src/kernel/hwaccel/hwaccel-resolver.ts
 /**
 * Platform-probe for hardware video decode acceleration.
@@ -6627,24 +6617,6 @@ function createRemoteProviderProxy(broker, serviceName, capName, nodeId, methods
 function runtimeNodeId(runtime) {
 	return runtime.mode === "broker" ? runtime.broker.nodeID : runtime.nodeId;
 }
-var hwaccelRegistered = /* @__PURE__ */ new WeakSet();
-/**
-* Idempotently register the per-node `$hwaccel` Moleculer service on
-* `broker`. Safe to call multiple times. The service exposes the
-* local platform probe as `$hwaccel.resolve` so cross-node queries
-* (`broker.call('$hwaccel.resolve', p, { nodeID })`) work.
-*/
-function ensureHwAccelService(broker) {
-	if (hwaccelRegistered.has(broker)) return;
-	const bkr = broker;
-	try {
-		bkr.createService(createHwAccelService(createKernelHwAccel()));
-		hwaccelRegistered.add(broker);
-	} catch (err) {
-		if (!(err instanceof Error ? err.message : String(err)).includes("already registered")) throw err;
-		hwaccelRegistered.add(broker);
-	}
-}
 /**
 * Adapt a Moleculer ServiceBroker to the camstack-types `IClusterBroker`
 * structural interface so addons can consume cluster-level RPC without
@@ -6951,7 +6923,6 @@ async function buildAddonContext(runtime, declaration, dataDir, options) {
 					value
 				})
 			};
-			if (runtime.mode === "broker") ensureHwAccelService(runtime.broker);
 			const hwaccel = createKernelHwAccel();
 			return {
 				localNodeId: nodeId,
@@ -7089,4 +7060,4 @@ async function installManifestPythonDeps(declaration, addonDir, deps, logger) {
 	await deps.installPythonRequirements(reqAbs);
 }
 //#endregion
-export { buildNativeCapProxy as $, createHubCapForwardService as A, AGENT_CAP_FWD_ACTION as B, brokerTransportLink as C, localProviderLink as D, ipcParentLink as E, createUdsLogger as F, callWithServiceDiscovery as G, CapRouteResolver as H, createUdsLoggerWithControl as I, UdsLocalTransportServer as J, createLocalTransport as K, LocalChildClient as L, createUdsEventBridge as M, createUdsEventBus as N, HUB_CAP_FWD_ACTION as O, udsChildLogToWorkerEntry as P, encodeFrame as Q, LocalChildRegistry as R, brokerCallForCap as S, ipcChildLink as T, CapRouteError as U, AGENT_CAP_FWD_SERVICE as V, classifyCapRoute as W, localEndpointPath as X, SocketChannel as Y, FrameDecoder as Z, resolveHwAccel as _, CapabilityHandle as _t, getWorkerDeviceRegistry as a, setWorkerNativeCapsChangeListener as at, __resetCapUsageRegistryForTests as b, resolveAddonClass as bt, setHubConnected as c, NATIVE_PROVIDER_SERVICE_INFIX as ct, getMoleculerEventStats as d, capBareAction as dt, buildUdsNativeCapProxy as et, registerEventBusService as f, capServiceName as ft, createKernelHwAccel as g, DeviceRegistry as gt, AddonDepsManager as h, serializeTypedArrays as ht, createUdsAddonContext as i, mountNativeCapService as it, createParentUnownedCallHandler as j, HUB_CAP_FWD_SERVICE as k, EVENT_TOPIC_PREFIX as l, capActionName as lt, subscribePassthrough as m, deserializeTypedArrays as mt, adaptBrokerToCluster as n, getWorkerNativeCapProvider as nt, getOrInitReadinessRegistry as o, createAddonService as ot, setNodeEventInterest as p, parseCapAction as pt, UdsLocalTransportClient as q, createAddonContext as r, getWorkerNativeCapSnapshot as rt, getOrInitReadinessRegistryForClient as s, validateProviderRegistrations as st, installManifestPythonDeps as t, createBrokerDeviceManagerApi as tt, getBrokerEventBus as u, capActionSuffix as ut, createHwAccelService as v, CapabilityUnavailableError as vt, buildLinkChain as w, getCapUsageRegistry as x, CapUsageRegistry as y, installManifestNativeDeps as yt, UDS_NO_ROUTE_PREFIX as z };
+export { buildUdsNativeCapProxy as $, createParentUnownedCallHandler as A, AGENT_CAP_FWD_SERVICE as B, buildLinkChain as C, HUB_CAP_FWD_ACTION as D, localProviderLink as E, createUdsLoggerWithControl as F, createLocalTransport as G, CapRouteError as H, LocalChildClient as I, SocketChannel as J, UdsLocalTransportClient as K, LocalChildRegistry as L, createUdsEventBus as M, udsChildLogToWorkerEntry as N, HUB_CAP_FWD_SERVICE as O, createUdsLogger as P, buildNativeCapProxy as Q, UDS_NO_ROUTE_PREFIX as R, brokerTransportLink as S, ipcParentLink as T, classifyCapRoute as U, CapRouteResolver as V, callWithServiceDiscovery as W, FrameDecoder as X, localEndpointPath as Y, encodeFrame as Z, resolveHwAccel as _, CapabilityUnavailableError as _t, getWorkerDeviceRegistry as a, createAddonService as at, getCapUsageRegistry as b, setHubConnected as c, capActionName as ct, getMoleculerEventStats as d, capServiceName as dt, createBrokerDeviceManagerApi as et, registerEventBusService as f, parseCapAction as ft, createKernelHwAccel as g, CapabilityHandle as gt, AddonDepsManager as h, DeviceRegistry as ht, createUdsAddonContext as i, setWorkerNativeCapsChangeListener as it, createUdsEventBridge as j, createHubCapForwardService as k, EVENT_TOPIC_PREFIX as l, capActionSuffix as lt, subscribePassthrough as m, serializeTypedArrays as mt, adaptBrokerToCluster as n, getWorkerNativeCapSnapshot as nt, getOrInitReadinessRegistry as o, validateProviderRegistrations as ot, setNodeEventInterest as p, deserializeTypedArrays as pt, UdsLocalTransportServer as q, createAddonContext as r, mountNativeCapService as rt, getOrInitReadinessRegistryForClient as s, NATIVE_PROVIDER_SERVICE_INFIX as st, installManifestPythonDeps as t, getWorkerNativeCapProvider as tt, getBrokerEventBus as u, capBareAction as ut, CapUsageRegistry as v, installManifestNativeDeps as vt, ipcChildLink as w, brokerCallForCap as x, __resetCapUsageRegistryForTests as y, resolveAddonClass as yt, AGENT_CAP_FWD_ACTION as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/system",
-  "version": "1.1.24",
+  "version": "1.1.25",
   "description": "Core addon for CamStack — builtins, pipeline, process management, auth, logging, events",
   "keywords": [
     "camstack",

package/dist/kernel/hwaccel/hwaccel-service.d.ts

@@ -1,4 +0,0 @@
-import { ServiceSchema } from 'moleculer';
-import { IKernelHwAccel } from '@camstack/types';
-export type HwAccelServiceDeps = IKernelHwAccel;
-export declare function createHwAccelService(deps: HwAccelServiceDeps): ServiceSchema;