@camstack/system 1.1.15 → 1.1.17

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-Cro19O4u.js");
+const require_manifest_python_deps = require("./manifest-python-deps-lZd5B4FS.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 { $ as setWorkerNativeCapsChangeListener, A as createUdsLoggerWithControl, X as getWorkerNativeCapProvider, Z as getWorkerNativeCapSnapshot, i as createUdsAddonContext, j as LocalChildClient, mt as resolveAddonClass, pt as installManifestNativeDeps, t as installManifestPythonDeps, tt as validateProviderRegistrations } from "./manifest-python-deps-BfJEdXhi.mjs";
+import { $ as getWorkerNativeCapProvider, N as createUdsLoggerWithControl, P as LocalChildClient, _t as resolveAddonClass, et as getWorkerNativeCapSnapshot, gt as installManifestNativeDeps, i as createUdsAddonContext, it as validateProviderRegistrations, nt as setWorkerNativeCapsChangeListener, t as installManifestPythonDeps } from "./manifest-python-deps-DOAh19rY.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/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-Cro19O4u.js");
+const require_manifest_python_deps = require("./manifest-python-deps-lZd5B4FS.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");
@@ -93298,6 +93298,8 @@ exports.FsStorageBackend = FsStorageBackend;
 exports.HEALTH_MONITOR_GRACE_PERIOD_MS = HEALTH_MONITOR_GRACE_PERIOD_MS;
 exports.HEALTH_MONITOR_RETRY_INTERVALS_MS = HEALTH_MONITOR_RETRY_INTERVALS_MS;
 exports.HEALTH_MONITOR_TICK_MS = HEALTH_MONITOR_TICK_MS;
+exports.HUB_CAP_FWD_ACTION = require_manifest_python_deps.HUB_CAP_FWD_ACTION;
+exports.HUB_CAP_FWD_SERVICE = require_manifest_python_deps.HUB_CAP_FWD_SERVICE;
 exports.HubForwarderAddon = require_builtins_hub_forwarder_index.HubForwarderAddon$1;
 exports.HubForwarderDestination = require_builtins_hub_forwarder_index.HubForwarderDestination$1;
 exports.HubLogForwarder = HubLogForwarder;
@@ -93405,6 +93407,7 @@ exports.createBroker = createBroker;
 exports.createBrokerDeviceManagerApi = require_manifest_python_deps.createBrokerDeviceManagerApi;
 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;

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 { A as createUdsLoggerWithControl, B as createLocalTransport, C as ipcParentLink, D as createUdsEventBus, E as createUdsEventBridge, F as AGENT_CAP_FWD_SERVICE, G as FrameDecoder, H as UdsLocalTransportServer, I as CapRouteResolver, J as buildUdsNativeCapProxy, K as encodeFrame, L as CapRouteError, M as LocalChildRegistry, N as UDS_NO_ROUTE_PREFIX, O as udsChildLogToWorkerEntry, P as AGENT_CAP_FWD_ACTION, Q as mountNativeCapService, R as classifyCapRoute, S as ipcChildLink, T as createParentUnownedCallHandler, U as SocketChannel, V as UdsLocalTransportClient, W as localEndpointPath, Y as createBrokerDeviceManagerApi, _ as __resetCapUsageRegistryForTests, a as getWorkerDeviceRegistry, at as capBareAction, b as brokerTransportLink, c as setHubConnected, ct as deserializeTypedArrays, d as registerEventBusService, dt as CapabilityHandle, et as createAddonService, f as AddonDepsManager, ft as CapabilityUnavailableError, g as CapUsageRegistry, h as createHwAccelService, i as createUdsAddonContext, it as capActionSuffix, j as LocalChildClient, k as createUdsLogger, l as EVENT_TOPIC_PREFIX, lt as serializeTypedArrays, m as resolveHwAccel, mt as resolveAddonClass, n as adaptBrokerToCluster, nt as NATIVE_PROVIDER_SERVICE_INFIX, o as getOrInitReadinessRegistry, ot as capServiceName, p as createKernelHwAccel, pt as installManifestNativeDeps, q as buildNativeCapProxy, r as createAddonContext, rt as capActionName, s as getOrInitReadinessRegistryForClient, st as parseCapAction, t as installManifestPythonDeps, tt as validateProviderRegistrations, u as getBrokerEventBus, ut as DeviceRegistry, v as getCapUsageRegistry, w as localProviderLink, x as buildLinkChain, y as brokerCallForCap, z as callWithServiceDiscovery } from "./manifest-python-deps-BfJEdXhi.mjs";
+import { A as createUdsEventBus, B as CapRouteError, C as ipcParentLink, D as createHubCapForwardService, E as HUB_CAP_FWD_SERVICE, F as LocalChildRegistry, G as UdsLocalTransportServer, H as callWithServiceDiscovery, I as UDS_NO_ROUTE_PREFIX, J as FrameDecoder, K as SocketChannel, L as AGENT_CAP_FWD_ACTION, M as createUdsLogger, N as createUdsLoggerWithControl, O as createParentUnownedCallHandler, P as LocalChildClient, Q as createBrokerDeviceManagerApi, R as AGENT_CAP_FWD_SERVICE, S as ipcChildLink, T as HUB_CAP_FWD_ACTION, U as createLocalTransport, V as classifyCapRoute, W as UdsLocalTransportClient, X as buildNativeCapProxy, Y as encodeFrame, Z as buildUdsNativeCapProxy, _ as __resetCapUsageRegistryForTests, _t as resolveAddonClass, a as getWorkerDeviceRegistry, at as NATIVE_PROVIDER_SERVICE_INFIX, b as brokerTransportLink, c as setHubConnected, ct as capBareAction, d as registerEventBusService, dt as deserializeTypedArrays, f as AddonDepsManager, ft as serializeTypedArrays, g as CapUsageRegistry, gt as installManifestNativeDeps, h as createHwAccelService, ht as CapabilityUnavailableError, i as createUdsAddonContext, it as validateProviderRegistrations, j as udsChildLogToWorkerEntry, k as createUdsEventBridge, l as EVENT_TOPIC_PREFIX, lt as capServiceName, m as resolveHwAccel, mt as CapabilityHandle, n as adaptBrokerToCluster, o as getOrInitReadinessRegistry, ot as capActionName, p as createKernelHwAccel, pt as DeviceRegistry, q as localEndpointPath, r as createAddonContext, rt as createAddonService, s as getOrInitReadinessRegistryForClient, st as capActionSuffix, t as installManifestPythonDeps, tt as mountNativeCapService, u as getBrokerEventBus, ut as parseCapAction, v as getCapUsageRegistry, w as localProviderLink, x as buildLinkChain, y as brokerCallForCap, z as CapRouteResolver } from "./manifest-python-deps-DOAh19rY.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";
@@ -93246,4 +93246,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, 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, 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, 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, stageFrameworkLockstep, stripCamstackDeps, 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, 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, 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, stageFrameworkLockstep, stripCamstackDeps, udsChildLogToWorkerEntry, validateProviderRegistrations, writePendingRestart };

package/dist/kernel/transport/hub-cap-forward.d.ts

@@ -0,0 +1,34 @@
+import { ServiceSchema } from 'moleculer';
+import { CapCallInput } from './child-cap-protocol.js';
+/** The Moleculer service name the hub registers for agent→hub cap forwarding. */
+export declare const HUB_CAP_FWD_SERVICE: "$hub-cap-fwd";
+/** The Moleculer action (service.action) for hub cap forwarding. */
+export declare const HUB_CAP_FWD_ACTION: "$hub-cap-fwd.forward";
+/**
+ * Params envelope an agent sends to `$hub-cap-fwd.forward`. Mirrors
+ * {@link CapCallInput} (the hub's onUnownedCall input): `capName` + `method` are
+ * required; `args` passes through; `deviceId` / `nodeId` are optional routing
+ * hints the hub's resolver honours.
+ */
+export interface HubCapForwardParams {
+    readonly capName: string;
+    readonly method: string;
+    readonly args: unknown;
+    readonly deviceId?: number;
+    readonly nodeId?: string;
+}
+/**
+ * Handler that routes an agent-originated cap call through the hub's own
+ * unowned-call routing. Structurally the hub's `onUnownedCall`.
+ */
+export type HubUnownedCallHandler = (input: CapCallInput) => Promise<unknown>;
+/**
+ * Build the `$hub-cap-fwd` Moleculer `ServiceSchema`. The hub registers this on
+ * its broker (only the hub registers it → an agent's `broker.call` for
+ * `$hub-cap-fwd.forward` discovers it on the hub with no explicit nodeID pin).
+ *
+ * @param onUnownedCall  The hub's cap routing handler (from
+ *                       `createParentUnownedCallHandler`). Reused verbatim so
+ *                       forwarded calls route exactly like a hub-local child's.
+ */
+export declare function createHubCapForwardService(onUnownedCall: HubUnownedCallHandler): ServiceSchema;

package/dist/kernel/transport/index.d.ts

@@ -25,3 +25,5 @@ export { createUdsEventBridge } from './uds-event-bridge.js';
 export type { UdsEventBridgeDeps, ChildEventBroadcaster } from './uds-event-bridge.js';
 export { createParentUnownedCallHandler } from './parent-unowned-call.js';
 export type { ParentUnownedCallDeps, ParentUnownedCallLogger } from './parent-unowned-call.js';
+export { createHubCapForwardService, HUB_CAP_FWD_SERVICE, HUB_CAP_FWD_ACTION, } from './hub-cap-forward.js';
+export type { HubCapForwardParams, HubUnownedCallHandler } from './hub-cap-forward.js';

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

@@ -58,6 +58,38 @@ export interface ParentUnownedCallDeps {
      * deviceId-carrying SYSTEM-cap calls (e.g. `system.info({deviceId})`) fast.
      */
     readonly isDeviceNativeCap?: (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`
+     * service instead of attempted via raw Moleculer service discovery
+     * (`brokerCallForCap`). This is what makes an agent's forked addon reach a
+     * HUB-hosted cap (`stream-broker`, `settings-store`, …): hub-local addon
+     * runners register NO Moleculer service, so raw discovery for `${cap}.*`
+     * 30s-deadlines. The hub side answers `$hub-cap-fwd.forward` by running the
+     * call through ITS OWN `onUnownedCall` (resolver + broker-fallback), so the
+     * agent inherits the hub's full routing. The hub itself passes this undefined
+     * (it IS the hub) and keeps the `brokerCallForCap` path for its `$`-core
+     * services. See `hub-cap-forward.ts`.
+     */
+    readonly forwardToHub?: (input: CapCallInput) => Promise<unknown>;
+    /**
+     * Optional empty-collection fast-path. Returns `[]` (an empty aggregate) when
+     * `capName` is a `mode:'collection'` cap whose `method` is array-output AND
+     * ZERO providers are registered cluster-wide; `null`/`undefined` otherwise.
+     *
+     * Why: a collection cap with no providers IS the empty collection — but with
+     * nothing registered, the resolver returns `no-provider` and the call falls
+     * to the broker fallback, which polls Moleculer service discovery for a
+     * `${cap}.${method}` service that will NEVER appear until the discovery
+     * deadline (~30s) elapses. That 30s stall hit EVERY WebRTC cold start via the
+     * provider-less `turn-provider` (`getTurnServers`). Returning `[]` up front
+     * treats a provider-less collection as the empty collection it is — instant,
+     * no discovery. A collection WITH ≥1 provider returns `null` here and routes
+     * normally (the aggregate fans out across its providers as before). The
+     * kernel layer has no cap registry, so the wiring side (which has both the
+     * `CapabilityDefinition`s and the registry) injects this.
+     */
+    readonly resolveEmptyCollection?: (capName: string, method: string) => readonly unknown[] | null;
     /** Optional logger for the broker-fallback diagnostic line. */
     readonly logger?: ParentUnownedCallLogger;
 }

package/dist/{manifest-python-deps-BfJEdXhi.mjs → manifest-python-deps-DOAh19rY.mjs}

@@ -4619,6 +4619,10 @@ function createParentUnownedCallHandler(deps) {
 	return async (input) => {
 		const deviceId = input.deviceId ?? extractDeviceId(input.args);
 		const nodeId = input.nodeId ?? extractNodeId(input.args);
+		if (nodeId === void 0) {
+			const empty = deps.resolveEmptyCollection?.(input.capName, input.method);
+			if (empty != null) return empty;
+		}
 		const resolver = deps.getResolver();
 		if (resolver !== null) try {
 			const route = resolver.resolveCapRoute(input.capName, {
@@ -4652,8 +4656,24 @@ function createParentUnownedCallHandler(deps) {
 					});
 				}
 				const owner = deps.nodeRegistry.listNativeCapEntriesForDevice(deviceId).find((entry) => entry.capName === input.capName);
-				if (owner !== void 0) return await brokerCallForCap(deps.broker, input.capName, input.method, input.args, { nodeId: owner.nodeId });
+				if (owner !== void 0) {
+					if (deps.forwardToHub !== void 0) return await deps.forwardToHub({
+						capName: input.capName,
+						method: input.method,
+						args: input.args,
+						deviceId,
+						nodeId: owner.nodeId
+					});
+					return await brokerCallForCap(deps.broker, input.capName, input.method, input.args, { nodeId: owner.nodeId });
+				}
 			}
+			if (deps.forwardToHub !== void 0) return await deps.forwardToHub({
+				capName: input.capName,
+				method: input.method,
+				args: input.args,
+				...deviceId !== void 0 ? { deviceId } : {},
+				...nodeId !== void 0 ? { nodeId } : {}
+			});
 			deps.logger?.warn?.("routing child unowned cap call via broker fallback", {
 				capName: input.capName,
 				method: input.method
@@ -4666,6 +4686,55 @@ function createParentUnownedCallHandler(deps) {
 	};
 }
 //#endregion
+//#region src/kernel/transport/hub-cap-forward.ts
+/** The Moleculer service name the hub registers for agent→hub cap forwarding. */
+var HUB_CAP_FWD_SERVICE = "$hub-cap-fwd";
+/** The Moleculer action (service.action) for hub cap forwarding. */
+var HUB_CAP_FWD_ACTION = `${HUB_CAP_FWD_SERVICE}.forward`;
+/**
+* Narrow Moleculer's loosely-typed `ctx.params` to {@link HubCapForwardParams}
+* without unsafe casts — mirrors `agent-cap-dispatch-service.ts:narrowParams`.
+*/
+function narrowParams(raw) {
+	if (raw === null || typeof raw !== "object") throw new Error("$hub-cap-fwd.forward: invalid params — capName and method are required strings");
+	const capName = Reflect.get(raw, "capName");
+	const method = Reflect.get(raw, "method");
+	if (typeof capName !== "string" || typeof method !== "string") throw new Error("$hub-cap-fwd.forward: invalid params — capName and method are required strings");
+	const deviceId = Reflect.get(raw, "deviceId");
+	const nodeId = Reflect.get(raw, "nodeId");
+	return {
+		capName,
+		method,
+		args: Reflect.get(raw, "args"),
+		deviceId: typeof deviceId === "number" ? deviceId : void 0,
+		nodeId: typeof nodeId === "string" && nodeId.length > 0 ? nodeId : void 0
+	};
+}
+/**
+* Build the `$hub-cap-fwd` Moleculer `ServiceSchema`. The hub registers this on
+* its broker (only the hub registers it → an agent's `broker.call` for
+* `$hub-cap-fwd.forward` discovers it on the hub with no explicit nodeID pin).
+*
+* @param onUnownedCall  The hub's cap routing handler (from
+*                       `createParentUnownedCallHandler`). Reused verbatim so
+*                       forwarded calls route exactly like a hub-local child's.
+*/
+function createHubCapForwardService(onUnownedCall) {
+	return {
+		name: HUB_CAP_FWD_SERVICE,
+		actions: { forward: { handler: async (ctx) => {
+			const { capName, method, args, deviceId, nodeId } = narrowParams(ctx.params);
+			return onUnownedCall({
+				capName,
+				method,
+				args,
+				...deviceId !== void 0 ? { deviceId } : {},
+				...nodeId !== void 0 ? { nodeId } : {}
+			});
+		} } }
+	};
+}
+//#endregion
 //#region src/kernel/moleculer/trpc-links.ts
 /** Convert camelCase → kebab-case. */
 function toKebab(name) {
@@ -6585,4 +6654,4 @@ async function installManifestPythonDeps(declaration, addonDir, deps, logger) {
 	await deps.installPythonRequirements(reqAbs);
 }
 //#endregion
-export { setWorkerNativeCapsChangeListener as $, createUdsLoggerWithControl as A, createLocalTransport as B, ipcParentLink as C, createUdsEventBus as D, createUdsEventBridge as E, AGENT_CAP_FWD_SERVICE as F, FrameDecoder as G, UdsLocalTransportServer as H, CapRouteResolver as I, buildUdsNativeCapProxy as J, encodeFrame as K, CapRouteError as L, LocalChildRegistry as M, UDS_NO_ROUTE_PREFIX as N, udsChildLogToWorkerEntry as O, AGENT_CAP_FWD_ACTION as P, mountNativeCapService as Q, classifyCapRoute as R, ipcChildLink as S, createParentUnownedCallHandler as T, SocketChannel as U, UdsLocalTransportClient as V, localEndpointPath as W, getWorkerNativeCapProvider as X, createBrokerDeviceManagerApi as Y, getWorkerNativeCapSnapshot as Z, __resetCapUsageRegistryForTests as _, getWorkerDeviceRegistry as a, capBareAction as at, brokerTransportLink as b, setHubConnected as c, deserializeTypedArrays as ct, registerEventBusService as d, CapabilityHandle as dt, createAddonService as et, AddonDepsManager as f, CapabilityUnavailableError as ft, CapUsageRegistry as g, createHwAccelService as h, createUdsAddonContext as i, capActionSuffix as it, LocalChildClient as j, createUdsLogger as k, EVENT_TOPIC_PREFIX as l, serializeTypedArrays as lt, resolveHwAccel as m, resolveAddonClass as mt, adaptBrokerToCluster as n, NATIVE_PROVIDER_SERVICE_INFIX as nt, getOrInitReadinessRegistry as o, capServiceName as ot, createKernelHwAccel as p, installManifestNativeDeps as pt, buildNativeCapProxy as q, createAddonContext as r, capActionName as rt, getOrInitReadinessRegistryForClient as s, parseCapAction as st, installManifestPythonDeps as t, validateProviderRegistrations as tt, getBrokerEventBus as u, DeviceRegistry as ut, getCapUsageRegistry as v, localProviderLink as w, buildLinkChain as x, brokerCallForCap as y, callWithServiceDiscovery as z };
+export { getWorkerNativeCapProvider as $, createUdsEventBus as A, CapRouteError as B, ipcParentLink as C, createHubCapForwardService as D, HUB_CAP_FWD_SERVICE as E, LocalChildRegistry as F, UdsLocalTransportServer as G, callWithServiceDiscovery as H, UDS_NO_ROUTE_PREFIX as I, FrameDecoder as J, SocketChannel as K, AGENT_CAP_FWD_ACTION as L, createUdsLogger as M, createUdsLoggerWithControl as N, createParentUnownedCallHandler as O, LocalChildClient as P, createBrokerDeviceManagerApi as Q, AGENT_CAP_FWD_SERVICE as R, ipcChildLink as S, HUB_CAP_FWD_ACTION as T, createLocalTransport as U, classifyCapRoute as V, UdsLocalTransportClient as W, buildNativeCapProxy as X, encodeFrame as Y, buildUdsNativeCapProxy as Z, __resetCapUsageRegistryForTests as _, resolveAddonClass as _t, getWorkerDeviceRegistry as a, NATIVE_PROVIDER_SERVICE_INFIX as at, brokerTransportLink as b, setHubConnected as c, capBareAction as ct, registerEventBusService as d, deserializeTypedArrays as dt, getWorkerNativeCapSnapshot as et, AddonDepsManager as f, serializeTypedArrays as ft, CapUsageRegistry as g, installManifestNativeDeps as gt, createHwAccelService as h, CapabilityUnavailableError as ht, createUdsAddonContext as i, validateProviderRegistrations as it, udsChildLogToWorkerEntry as j, createUdsEventBridge as k, EVENT_TOPIC_PREFIX as l, capServiceName as lt, resolveHwAccel as m, CapabilityHandle as mt, adaptBrokerToCluster as n, setWorkerNativeCapsChangeListener as nt, getOrInitReadinessRegistry as o, capActionName as ot, createKernelHwAccel as p, DeviceRegistry as pt, localEndpointPath as q, createAddonContext as r, createAddonService as rt, getOrInitReadinessRegistryForClient as s, capActionSuffix as st, installManifestPythonDeps as t, mountNativeCapService as tt, getBrokerEventBus as u, parseCapAction as ut, getCapUsageRegistry as v, localProviderLink as w, buildLinkChain as x, brokerCallForCap as y, CapRouteResolver as z };

package/dist/{manifest-python-deps-Cro19O4u.js → manifest-python-deps-lZd5B4FS.js}

@@ -4621,6 +4621,10 @@ function createParentUnownedCallHandler(deps) {
 	return async (input) => {
 		const deviceId = input.deviceId ?? extractDeviceId(input.args);
 		const nodeId = input.nodeId ?? extractNodeId(input.args);
+		if (nodeId === void 0) {
+			const empty = deps.resolveEmptyCollection?.(input.capName, input.method);
+			if (empty != null) return empty;
+		}
 		const resolver = deps.getResolver();
 		if (resolver !== null) try {
 			const route = resolver.resolveCapRoute(input.capName, {
@@ -4654,8 +4658,24 @@ function createParentUnownedCallHandler(deps) {
 					});
 				}
 				const owner = deps.nodeRegistry.listNativeCapEntriesForDevice(deviceId).find((entry) => entry.capName === input.capName);
-				if (owner !== void 0) return await brokerCallForCap(deps.broker, input.capName, input.method, input.args, { nodeId: owner.nodeId });
+				if (owner !== void 0) {
+					if (deps.forwardToHub !== void 0) return await deps.forwardToHub({
+						capName: input.capName,
+						method: input.method,
+						args: input.args,
+						deviceId,
+						nodeId: owner.nodeId
+					});
+					return await brokerCallForCap(deps.broker, input.capName, input.method, input.args, { nodeId: owner.nodeId });
+				}
 			}
+			if (deps.forwardToHub !== void 0) return await deps.forwardToHub({
+				capName: input.capName,
+				method: input.method,
+				args: input.args,
+				...deviceId !== void 0 ? { deviceId } : {},
+				...nodeId !== void 0 ? { nodeId } : {}
+			});
 			deps.logger?.warn?.("routing child unowned cap call via broker fallback", {
 				capName: input.capName,
 				method: input.method
@@ -4668,6 +4688,55 @@ function createParentUnownedCallHandler(deps) {
 	};
 }
 //#endregion
+//#region src/kernel/transport/hub-cap-forward.ts
+/** The Moleculer service name the hub registers for agent→hub cap forwarding. */
+var HUB_CAP_FWD_SERVICE = "$hub-cap-fwd";
+/** The Moleculer action (service.action) for hub cap forwarding. */
+var HUB_CAP_FWD_ACTION = `${HUB_CAP_FWD_SERVICE}.forward`;
+/**
+* Narrow Moleculer's loosely-typed `ctx.params` to {@link HubCapForwardParams}
+* without unsafe casts — mirrors `agent-cap-dispatch-service.ts:narrowParams`.
+*/
+function narrowParams(raw) {
+	if (raw === null || typeof raw !== "object") throw new Error("$hub-cap-fwd.forward: invalid params — capName and method are required strings");
+	const capName = Reflect.get(raw, "capName");
+	const method = Reflect.get(raw, "method");
+	if (typeof capName !== "string" || typeof method !== "string") throw new Error("$hub-cap-fwd.forward: invalid params — capName and method are required strings");
+	const deviceId = Reflect.get(raw, "deviceId");
+	const nodeId = Reflect.get(raw, "nodeId");
+	return {
+		capName,
+		method,
+		args: Reflect.get(raw, "args"),
+		deviceId: typeof deviceId === "number" ? deviceId : void 0,
+		nodeId: typeof nodeId === "string" && nodeId.length > 0 ? nodeId : void 0
+	};
+}
+/**
+* Build the `$hub-cap-fwd` Moleculer `ServiceSchema`. The hub registers this on
+* its broker (only the hub registers it → an agent's `broker.call` for
+* `$hub-cap-fwd.forward` discovers it on the hub with no explicit nodeID pin).
+*
+* @param onUnownedCall  The hub's cap routing handler (from
+*                       `createParentUnownedCallHandler`). Reused verbatim so
+*                       forwarded calls route exactly like a hub-local child's.
+*/
+function createHubCapForwardService(onUnownedCall) {
+	return {
+		name: HUB_CAP_FWD_SERVICE,
+		actions: { forward: { handler: async (ctx) => {
+			const { capName, method, args, deviceId, nodeId } = narrowParams(ctx.params);
+			return onUnownedCall({
+				capName,
+				method,
+				args,
+				...deviceId !== void 0 ? { deviceId } : {},
+				...nodeId !== void 0 ? { nodeId } : {}
+			});
+		} } }
+	};
+}
+//#endregion
 //#region src/kernel/moleculer/trpc-links.ts
 /** Convert camelCase → kebab-case. */
 function toKebab(name) {
@@ -6653,6 +6722,18 @@ Object.defineProperty(exports, "FrameDecoder", {
 		return FrameDecoder;
 	}
 });
+Object.defineProperty(exports, "HUB_CAP_FWD_ACTION", {
+	enumerable: true,
+	get: function() {
+		return HUB_CAP_FWD_ACTION;
+	}
+});
+Object.defineProperty(exports, "HUB_CAP_FWD_SERVICE", {
+	enumerable: true,
+	get: function() {
+		return HUB_CAP_FWD_SERVICE;
+	}
+});
 Object.defineProperty(exports, "LocalChildClient", {
 	enumerable: true,
 	get: function() {
@@ -6791,6 +6872,12 @@ Object.defineProperty(exports, "createBrokerDeviceManagerApi", {
 		return createBrokerDeviceManagerApi;
 	}
 });
+Object.defineProperty(exports, "createHubCapForwardService", {
+	enumerable: true,
+	get: function() {
+		return createHubCapForwardService;
+	}
+});
 Object.defineProperty(exports, "createHwAccelService", {
 	enumerable: true,
 	get: function() {

package/package.json

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