@camstack/system 1.1.21 → 1.1.23

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-Bp7nvTNF.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-hDWMDe_b.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";

package/dist/kernel/transport/cap-route-resolver.d.ts

@@ -1,6 +1,6 @@
-import { CapCallInput } from './child-cap-protocol.js';
 import { ServiceDiscoveryBroker } from '../moleculer/resilient-cap-call.js';
 import { CapRoute, CapRouteOpts, HubLocalUdsRoute, InProcessProviderRef } from './cap-route.js';
+import { CapCallInput } from './child-cap-protocol.js';
 /**
  * Minimal surface of LocalChildRegistry that the resolver needs.
  * Keeping a narrow interface here prevents the resolver from depending on the
@@ -80,6 +80,14 @@ export interface CapRouteResolverDeps {
      * Decouples the resolver from CapabilityRegistry.
      */
     readonly inProcessProviders: InProcessProviderLookup;
+    /**
+     * Optional NODE-ACCURATE lookup for providers physically resident on the
+     * hub node — consulted ONLY when a call is EXPLICITLY pinned to the hub.
+     * `inProcessProviders` may resolve the cluster-elected ACTIVE singleton
+     * (a remote-proxy provider registered in the hub registry), which must not
+     * satisfy a `nodePin('hub')`. See `CapRouteSnapshot.hubResidentProvides`.
+     */
+    readonly hubResidentProviders?: InProcessProviderLookup;
     /**
      * Per-cap-method RPC timeout (ms). Lets a long-running cap method (e.g.
      * `model-convert.convert`, minutes) override the default 60s remote/forward
@@ -133,6 +141,7 @@ export declare class CapRouteResolver {
     private readonly hubLocalRegistry;
     private readonly nodeAuthority;
     private readonly inProcessProviders;
+    private readonly hubResidentProviders?;
     private readonly capTimeoutMs?;
     private readonly snapshot;
     constructor(deps: CapRouteResolverDeps);

package/dist/kernel/transport/cap-route.d.ts

@@ -108,6 +108,26 @@ export interface CapRouteSnapshot {
      * null, classifyCapRoute throws no-provider rather than casting.
      */
     readonly getInProcessProviderRef?: (cap: string) => InProcessProviderRef | null;
+    /**
+     * Optional NODE-ACCURATE variant of `hubInProcessProvides`, consulted ONLY
+     * for an EXPLICIT hub pin (`opts.nodeId === hubNodeId`). Returns true only
+     * when a provider physically resident on the hub node exists.
+     *
+     * Rationale: `hubInProcessProvides` may be backed by the cluster-elected
+     * ACTIVE singleton — which can be a REMOTE-proxy provider registered in the
+     * hub registry. That is correct for UNPINNED dispatch (election adherence)
+     * but must NOT satisfy an explicit `nodePin('hub')`: dispatching the remote
+     * proxy as "hub-in-process" silently executes the call on another node
+     * (the shm frame-plane cross-node decoder-session storm). When absent,
+     * classifyExplicitNode falls back to `hubInProcessProvides` (legacy).
+     */
+    readonly hubResidentProvides?: (cap: string) => boolean;
+    /**
+     * Optional: resolves the InProcessProviderRef of a HUB-RESIDENT provider
+     * (paired with `hubResidentProvides` — same node-accuracy contract). Used
+     * instead of `getInProcessProviderRef` when `hubResidentProvides` is set.
+     */
+    readonly getHubResidentProviderRef?: (cap: string) => InProcessProviderRef | null;
     /**
      * Optional: enumerates all known remote nodeIds for singleton cap resolution
      * (the case where no explicit nodeId is given by the caller).

package/dist/{manifest-python-deps-Di_9ayDE.js → manifest-python-deps-D7iR07uA.js}

@@ -3584,8 +3584,11 @@ function classifyCapRoute(capName, opts, snapshot) {
 }
 function classifyExplicitNode(capName, nodeId, deviceId, snap, rejected) {
 	if (nodeId === snap.hubNodeId) {
-		if (snap.hubInProcessProvides(capName)) {
-			const ref = snap.getInProcessProviderRef?.(capName) ?? null;
+		const residentProvides = snap.hubResidentProvides;
+		const providesOnHub = residentProvides ?? snap.hubInProcessProvides;
+		const getRef = residentProvides !== void 0 ? snap.getHubResidentProviderRef : snap.getInProcessProviderRef;
+		if (providesOnHub(capName)) {
+			const ref = getRef?.(capName) ?? null;
 			if (ref !== null) return {
 				kind: "hub-in-process",
 				capName,
@@ -3750,6 +3753,7 @@ var CapRouteResolver = class {
 	hubLocalRegistry;
 	nodeAuthority;
 	inProcessProviders;
+	hubResidentProviders;
 	capTimeoutMs;
 	snapshot;
 	constructor(deps) {
@@ -3758,6 +3762,7 @@ var CapRouteResolver = class {
 		this.hubLocalRegistry = deps.hubLocalRegistry;
 		this.nodeAuthority = deps.nodeAuthority;
 		this.inProcessProviders = deps.inProcessProviders;
+		this.hubResidentProviders = deps.hubResidentProviders;
 		this.capTimeoutMs = deps.capTimeoutMs;
 		this.snapshot = this.buildSnapshot();
 	}
@@ -3879,9 +3884,14 @@ var CapRouteResolver = class {
 		const hubLocalRegistry = this.hubLocalRegistry;
 		const nodeAuthority = this.nodeAuthority;
 		const inProcessProviders = this.inProcessProviders;
+		const hubResidentProviders = this.hubResidentProviders;
 		return {
 			hubNodeId: this.hubNodeId,
 			hubInProcessProvides: (cap) => inProcessProviders(cap) !== null,
+			...hubResidentProviders !== void 0 ? {
+				hubResidentProvides: (cap) => hubResidentProviders(cap) !== null,
+				getHubResidentProviderRef: (cap) => hubResidentProviders(cap)
+			} : {},
 			hubLocalChildProvides: (cap, deviceId) => hubLocalRegistry !== null && hubLocalRegistry.resolveChildId(cap, deviceId) !== null,
 			nodeKnowsCap: (nodeId, cap) => nodeAuthority.nodeKnowsCap(nodeId, cap),
 			nodeIsAgent: (nodeId) => nodeAuthority.nodeIsAgent(nodeId),

package/dist/{manifest-python-deps-Bp7nvTNF.mjs → manifest-python-deps-hDWMDe_b.mjs}

@@ -3582,8 +3582,11 @@ function classifyCapRoute(capName, opts, snapshot) {
 }
 function classifyExplicitNode(capName, nodeId, deviceId, snap, rejected) {
 	if (nodeId === snap.hubNodeId) {
-		if (snap.hubInProcessProvides(capName)) {
-			const ref = snap.getInProcessProviderRef?.(capName) ?? null;
+		const residentProvides = snap.hubResidentProvides;
+		const providesOnHub = residentProvides ?? snap.hubInProcessProvides;
+		const getRef = residentProvides !== void 0 ? snap.getHubResidentProviderRef : snap.getInProcessProviderRef;
+		if (providesOnHub(capName)) {
+			const ref = getRef?.(capName) ?? null;
 			if (ref !== null) return {
 				kind: "hub-in-process",
 				capName,
@@ -3748,6 +3751,7 @@ var CapRouteResolver = class {
 	hubLocalRegistry;
 	nodeAuthority;
 	inProcessProviders;
+	hubResidentProviders;
 	capTimeoutMs;
 	snapshot;
 	constructor(deps) {
@@ -3756,6 +3760,7 @@ var CapRouteResolver = class {
 		this.hubLocalRegistry = deps.hubLocalRegistry;
 		this.nodeAuthority = deps.nodeAuthority;
 		this.inProcessProviders = deps.inProcessProviders;
+		this.hubResidentProviders = deps.hubResidentProviders;
 		this.capTimeoutMs = deps.capTimeoutMs;
 		this.snapshot = this.buildSnapshot();
 	}
@@ -3877,9 +3882,14 @@ var CapRouteResolver = class {
 		const hubLocalRegistry = this.hubLocalRegistry;
 		const nodeAuthority = this.nodeAuthority;
 		const inProcessProviders = this.inProcessProviders;
+		const hubResidentProviders = this.hubResidentProviders;
 		return {
 			hubNodeId: this.hubNodeId,
 			hubInProcessProvides: (cap) => inProcessProviders(cap) !== null,
+			...hubResidentProviders !== void 0 ? {
+				hubResidentProvides: (cap) => hubResidentProviders(cap) !== null,
+				getHubResidentProviderRef: (cap) => hubResidentProviders(cap)
+			} : {},
 			hubLocalChildProvides: (cap, deviceId) => hubLocalRegistry !== null && hubLocalRegistry.resolveChildId(cap, deviceId) !== null,
 			nodeKnowsCap: (nodeId, cap) => nodeAuthority.nodeKnowsCap(nodeId, cap),
 			nodeIsAgent: (nodeId) => nodeAuthority.nodeIsAgent(nodeId),

package/package.json

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