@camstack/system 1.2.255 → 1.2.257

package/dist/addon-runner.js

@@ -1,5 +1,5 @@
 const require_chunk = require("./chunk-Cek0wNdY.js");
-const require_manifest_system_deps = require("./manifest-system-deps-CzyjTMcO.js");
+const require_manifest_system_deps = require("./manifest-system-deps-CfVyUKLU.js");
 const require_custom_action_registry = require("./custom-action-registry-acBY3mHA.js");
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);

package/dist/addon-runner.mjs

@@ -1,4 +1,4 @@
-import { A as createUdsLoggerWithControl, It as RUNNER_RSS_BUDGET_ENV, L as LocalChildClient, Yt as startRunnerHeapWatch, a as createUdsAddonContext, bt as resolveAddonClass, it as setWorkerNativeCapsChangeListener, n as installManifestPythonDeps, nt as getWorkerNativeCapSnapshot, ot as validateProviderRegistrations, sn as emitHeapDiagnosticReport, t as installManifestSystemDeps, tt as getWorkerNativeCapProvider, yt as installManifestNativeDeps } from "./manifest-system-deps-CfR7Z90J.mjs";
+import { Lt as RUNNER_RSS_BUDGET_ENV, R as LocalChildClient, Xt as startRunnerHeapWatch, a as createUdsAddonContext, at as setWorkerNativeCapsChangeListener, bt as installManifestNativeDeps, cn as emitHeapDiagnosticReport, j as createUdsLoggerWithControl, n as installManifestPythonDeps, nt as getWorkerNativeCapProvider, rt as getWorkerNativeCapSnapshot, st as validateProviderRegistrations, t as installManifestSystemDeps, xt as resolveAddonClass } from "./manifest-system-deps-BXf-Ouqx.mjs";
 import { t as CustomActionRegistry } from "./custom-action-registry-B4Cf4O_X.mjs";
 import { register } from "node:module";
 import * as path$1 from "node:path";

package/dist/builtins/autotrack/autotrack-cameras.d.ts

@@ -1,9 +1,33 @@
 import { FirstLevelMacroClass, PtzAutotrackSettings, PtzAutotrackStatus } from '@camstack/types';
 import { AutotrackLoopConfig } from './autotrack-config.js';
+/**
+ * How much of the frame the subject SHOULD occupy, and nothing else about zoom.
+ *
+ * Hidden on purpose (operator, 2026-09-18: *"rendiamo lo zoom configurabile,
+ * nascosto per ora, ci lavoriamo poi quando ne vedo il bisogno"*). It is not in
+ * `PtzAutotrackSettings` — that schema is the cross-vendor surface the device
+ * page renders, and putting it there would SHOW a control nothing implements.
+ * It lives in this addon's own record instead: settable, persisted, invisible.
+ *
+ * `null` means the loop does not touch zoom at all, which is what every camera
+ * gets until somebody decides otherwise.
+ */
+export interface AutotrackZoomSetting {
+    /**
+     * Target share of the frame for the tracked subject's box, `0..1`.
+     *
+     * The operator's original ask was "keep the target at about 50% of frame",
+     * so 0.5 is the number this exists to hold. It is a FRACTION OF AREA on the
+     * frame the loop measures in, not a zoom level: the loop is declaredly
+     * visual and never learns where the optics are (D520).
+     */
+    readonly targetSubjectFraction: number | null;
+}
 /** One camera's record. */
 export interface AutotrackCameraRecord {
     readonly enabled: boolean;
     readonly settings: PtzAutotrackSettings;
+    readonly zoom: AutotrackZoomSetting;
 }
 /** deviceId → record. */
 export type AutotrackCameraRecords = Readonly<Record<number, AutotrackCameraRecord>>;
@@ -25,18 +49,20 @@ export declare const DEFAULT_CAMERA_RECORD: AutotrackCameraRecord;
  */
 export declare const EMULATED_TARGET_OPTIONS: PtzAutotrackStatus['supportedTargetTypes'];
 /**
- * Read the persisted blob.
+ * Why this camera's zoom request is not being honoured, or `null` when it asked
+ * for nothing.
  *
- * A malformed ENTRY falls back to the defaults and keeps its `enabled` flag —
- * it is never dropped. Dropping it would disarm a function the operator armed,
- * which is the one direction this must not fail in; a camera that is not in
- * the blob at all is simply a camera nobody has switched on.
+ * A setting that is read and ignored in silence is indistinguishable from a
+ * broken one, and this one WILL be read by a loop that cannot act on it yet.
+ * So asking for it produces a sentence naming the number and what is missing.
  */
+export declare function zoomRefusalFor(record: AutotrackCameraRecord): string | null;
 export declare function parseCameraRecords(raw: unknown): AutotrackCameraRecords;
 /** Immutable per-camera patch — a NEW map, the previous one untouched. */
 export declare function withCameraPatch(records: AutotrackCameraRecords, deviceId: number, patch: {
     enabled?: boolean;
     settings?: Partial<PtzAutotrackSettings>;
+    zoom?: Partial<AutotrackZoomSetting>;
 }): AutotrackCameraRecords;
 /**
  * The detection macro class this camera follows.

package/dist/builtins/autotrack/index.js

@@ -52,7 +52,8 @@ var DEFAULT_CAMERA_RECORD = {
 		targetType: "",
 		stopDelaySeconds: 30,
 		disappearDelaySeconds: DEFAULT_AUTOTRACK_LOOP_CONFIG.disappearDelayMs / 1e3
-	}
+	},
+	zoom: { targetSubjectFraction: null }
 };
 /**
 * What this implementation can follow, as the cap's target options.
@@ -88,6 +89,32 @@ function parseSettings(raw) {
 * which is the one direction this must not fail in; a camera that is not in
 * the blob at all is simply a camera nobody has switched on.
 */
+/**
+* Read the hidden zoom setting.
+*
+* Out-of-range is CLAMPED into the unit interval rather than carried: a control
+* loop that eventually reads this must never be handed a 4, and a silently
+* dropped value would look like "the operator never set it".
+*/
+function parseZoom(raw) {
+	if (!isRecordObject(raw)) return { targetSubjectFraction: null };
+	const value = raw["targetSubjectFraction"];
+	if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) return { targetSubjectFraction: null };
+	return { targetSubjectFraction: Math.min(1, value) };
+}
+/**
+* Why this camera's zoom request is not being honoured, or `null` when it asked
+* for nothing.
+*
+* A setting that is read and ignored in silence is indistinguishable from a
+* broken one, and this one WILL be read by a loop that cannot act on it yet.
+* So asking for it produces a sentence naming the number and what is missing.
+*/
+function zoomRefusalFor(record) {
+	const target = record.zoom.targetSubjectFraction;
+	if (target === null) return null;
+	return `autotrack zoom is configured (target subject fraction ${String(target)}) but NOT IMPLEMENTED: the loop drives pan and tilt only. Subject-size control needs a third axis with its own dead band, a rule that it may act only while pan/tilt are settled, and the two D520 measurements first — a stale error costs more the further the optics are zoomed in.`;
+}
 function parseCameraRecords(raw) {
 	if (!isRecordObject(raw)) return {};
 	const out = {};
@@ -97,7 +124,8 @@ function parseCameraRecords(raw) {
 		if (!isRecordObject(value)) continue;
 		out[deviceId] = {
 			enabled: value["enabled"] === true,
-			settings: parseSettings(value["settings"])
+			settings: parseSettings(value["settings"]),
+			zoom: parseZoom(value["zoom"])
 		};
 	}
 	return out;
@@ -112,6 +140,10 @@ function withCameraPatch(records, deviceId, patch) {
 			settings: {
 				...current.settings,
 				...patch.settings
+			},
+			zoom: {
+				...current.zoom,
+				...patch.zoom
 			}
 		}
 	};
@@ -816,7 +848,7 @@ var AutotrackAddon = class extends require_dist.BaseAddon {
 		this.records = withCameraPatch(this.records, deviceId, patch);
 		if (before !== this.recordOf(deviceId).enabled) this.lastChangedAt.set(deviceId, Date.now());
 		await this.updateGlobalSettings({ cameras: this.serialiseRecords() });
-		await this.reconcileSessions();
+		await this.refreshEverything();
 	}
 	serialiseRecords() {
 		const out = {};
@@ -921,6 +953,11 @@ var AutotrackAddon = class extends require_dist.BaseAddon {
 			}
 		});
 		this.ctx.logger.warn("autotrack ON: this camera must not be driven by anyone else", { tags: { deviceId } });
+		const zoomRefusal = zoomRefusalFor(record);
+		if (zoomRefusal !== null) this.ctx.logger.warn(zoomRefusal, {
+			tags: { deviceId },
+			meta: { targetSubjectFraction: record.zoom.targetSubjectFraction }
+		});
 	}
 	stopSession(deviceId, reason) {
 		const session = this.sessions.get(deviceId);

package/dist/builtins/autotrack/index.mjs

@@ -47,7 +47,8 @@ var DEFAULT_CAMERA_RECORD = {
 		targetType: "",
 		stopDelaySeconds: 30,
 		disappearDelaySeconds: DEFAULT_AUTOTRACK_LOOP_CONFIG.disappearDelayMs / 1e3
-	}
+	},
+	zoom: { targetSubjectFraction: null }
 };
 /**
 * What this implementation can follow, as the cap's target options.
@@ -83,6 +84,32 @@ function parseSettings(raw) {
 * which is the one direction this must not fail in; a camera that is not in
 * the blob at all is simply a camera nobody has switched on.
 */
+/**
+* Read the hidden zoom setting.
+*
+* Out-of-range is CLAMPED into the unit interval rather than carried: a control
+* loop that eventually reads this must never be handed a 4, and a silently
+* dropped value would look like "the operator never set it".
+*/
+function parseZoom(raw) {
+	if (!isRecordObject(raw)) return { targetSubjectFraction: null };
+	const value = raw["targetSubjectFraction"];
+	if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) return { targetSubjectFraction: null };
+	return { targetSubjectFraction: Math.min(1, value) };
+}
+/**
+* Why this camera's zoom request is not being honoured, or `null` when it asked
+* for nothing.
+*
+* A setting that is read and ignored in silence is indistinguishable from a
+* broken one, and this one WILL be read by a loop that cannot act on it yet.
+* So asking for it produces a sentence naming the number and what is missing.
+*/
+function zoomRefusalFor(record) {
+	const target = record.zoom.targetSubjectFraction;
+	if (target === null) return null;
+	return `autotrack zoom is configured (target subject fraction ${String(target)}) but NOT IMPLEMENTED: the loop drives pan and tilt only. Subject-size control needs a third axis with its own dead band, a rule that it may act only while pan/tilt are settled, and the two D520 measurements first — a stale error costs more the further the optics are zoomed in.`;
+}
 function parseCameraRecords(raw) {
 	if (!isRecordObject(raw)) return {};
 	const out = {};
@@ -92,7 +119,8 @@ function parseCameraRecords(raw) {
 		if (!isRecordObject(value)) continue;
 		out[deviceId] = {
 			enabled: value["enabled"] === true,
-			settings: parseSettings(value["settings"])
+			settings: parseSettings(value["settings"]),
+			zoom: parseZoom(value["zoom"])
 		};
 	}
 	return out;
@@ -107,6 +135,10 @@ function withCameraPatch(records, deviceId, patch) {
 			settings: {
 				...current.settings,
 				...patch.settings
+			},
+			zoom: {
+				...current.zoom,
+				...patch.zoom
 			}
 		}
 	};
@@ -811,7 +843,7 @@ var AutotrackAddon = class extends BaseAddon {
 		this.records = withCameraPatch(this.records, deviceId, patch);
 		if (before !== this.recordOf(deviceId).enabled) this.lastChangedAt.set(deviceId, Date.now());
 		await this.updateGlobalSettings({ cameras: this.serialiseRecords() });
-		await this.reconcileSessions();
+		await this.refreshEverything();
 	}
 	serialiseRecords() {
 		const out = {};
@@ -916,6 +948,11 @@ var AutotrackAddon = class extends BaseAddon {
 			}
 		});
 		this.ctx.logger.warn("autotrack ON: this camera must not be driven by anyone else", { tags: { deviceId } });
+		const zoomRefusal = zoomRefusalFor(record);
+		if (zoomRefusal !== null) this.ctx.logger.warn(zoomRefusal, {
+			tags: { deviceId },
+			meta: { targetSubjectFraction: record.zoom.targetSubjectFraction }
+		});
 	}
 	stopSession(deviceId, reason) {
 		const session = this.sessions.get(deviceId);

package/dist/index.js

@@ -27,7 +27,7 @@ require("./builtins/system-config/index.js");
 const require_builtins_winston_logging_index = require("./builtins/winston-logging/index.js");
 const require_event_loop_stall_monitor = require("./event-loop-stall-monitor-CAsHdMwP.js");
 const require_tls$1 = require("./tls-BFs4PzoW.js");
-const require_manifest_system_deps = require("./manifest-system-deps-CzyjTMcO.js");
+const require_manifest_system_deps = require("./manifest-system-deps-CfVyUKLU.js");
 const require_resource_monitor = require("./resource-monitor-LVE1BoLs.js");
 const require_custom_action_registry = require("./custom-action-registry-acBY3mHA.js");
 let zod = require("zod");
@@ -96058,6 +96058,7 @@ exports.deriveAgentListenPort = deriveAgentListenPort;
 exports.describeProviderKindDrift = describeProviderKindDrift;
 exports.describeRss = require_manifest_system_deps.describeRss;
 exports.detectWorkspacePackagesDir = detectWorkspacePackagesDir;
+exports.deviceCapResolverLink = require_manifest_system_deps.deviceCapResolverLink;
 exports.diffCapActionCensus = require_manifest_system_deps.diffCapActionCensus;
 exports.diffEventPlane = require_manifest_system_deps.diffEventPlane;
 exports.diffSocketPlane = require_manifest_system_deps.diffSocketPlane;

package/dist/index.mjs

@@ -26,7 +26,7 @@ import "./builtins/system-config/index.mjs";
 import { WinstonDestination, WinstonLoggingAddon } from "./builtins/winston-logging/index.mjs";
 import { _ as fetchJson, a as createFileDataPlaneHandler, c as parseRangeHeader, d as ModelDownloadService, f as collectModelFiles, g as ensureModel, h as downloadModel, i as startEventLoopStallMonitor, l as parseTokenizedUrl, m as downloadFile, n as STALL_TICK_MS, o as contentTypeFor, p as deleteModelFromDisk, r as attributeStall, s as createAuthenticatedFileServer, t as STALL_REPORT_MS, u as resolveFilePath, v as getModelFilePath, y as isModelDownloaded } from "./event-loop-stall-monitor-GPrVvx14.mjs";
 import { C as registerLanHttpHandler, S as readLanHttpState, _ as DEFAULT_LAN_HTTP_PORT, a as writeTlsMode, b as bindPendingLanHttp, c as loadTlsCert, d as collectCertIdentity, f as CA_VALIDITY_DAYS, g as evaluateExistingCert, h as SERVER_AUTH_OID, i as writeExtraSans, l as reissueTlsLeaf, m as MAX_LEAF_VALIDITY_DAYS, n as readTlsAccessStatus, o as validateUploadedTls, p as LEAF_RENEWAL_WINDOW_DAYS, r as readTlsMode, s as ensureTlsCert, t as readExtraSans, u as CA_COMMON_NAME, v as allFamiliesListenHost, x as closeLanHttp, y as applyLanHttp } from "./tls-2xbgg78V.mjs";
-import { $ as buildUdsNativeCapProxy, $t as ARRAY_BUFFER_CENSUS_THRESHOLD_MB, A as createUdsLoggerWithControl, An as recordSocketFrame, At as HUB_MAIN_HEAP_WATCH_LABEL, B as readMoleculerFanoutMode, Bn as diffCapActionCensus, Bt as createLoopDelayMeter, C as ipcParentLink, Cn as createSocketPlaneMeter, Ct as runNpm, D as createUdsEventBus, Dn as readSocketQueues, Dt as HEAP_RECLAIM_TRIGGER_MB, E as createUdsEventBridge, En as formatSocketPlane, Et as HEAP_RECLAIM_STEADY_STATE_INTERVAL_MS, F as CapRouteError, Fn as CAP_ACTION_UNLABELLED, Ft as RUNNER_HEAP_WATCH_INTERVAL_MS, G as createLocalTransport, Gn as formatEventPlane, Gt as parseRssBudgetMb, H as PARENT_ROUTED_PROVIDER_ADDON_ID, Hn as createEventPlaneMeter, Ht as describeRss, I as classifyCapRoute, In as EMPTY_CAP_ACTION_READING, It as RUNNER_RSS_BUDGET_ENV, J as SocketChannel, Jt as startHeapWatch, K as UdsLocalTransportClient, Kt as reclaimIntervalMs, L as LocalChildClient, Ln as MAX_CAP_ACTIONS_PER_PEER, Lt as ZERO_LOOP_DELAY, M as AGENT_CAP_FWD_SERVICE, Mn as socketDirectionBytes, Mt as HUB_RSS_BUDGET_ENV, N as CapRouteResolver, Nn as socketDirectionMessages, Nt as RSS_BUDGET_REANNOUNCE_MIN_MS, O as udsChildLogToWorkerEntry, On as EMPTY_SOCKET_DIRECTION, Ot as HEAP_WATCH_INTERVAL_MS, P as callWithServiceDiscovery, Pn as CAP_ACTION_OVERFLOW_LABEL, Pt as RSS_BUDGET_RELEASE_RATIO, Q as buildNativeCapProxy, Qt as ARRAY_BUFFER_CENSUS_SUSTAIN_MS, R as LocalChildRegistry, Rn as capActionLabel, Rt as buildHeapSample, S as buildLinkChain, Sn as SOCKET_QUEUE_TOP_N, St as resolveNpmInvocation, T as createParentUnownedCallHandler, Tn as diffSocketPlane, Tt as HEAP_RECLAIM_MIN_INTERVAL_MS, U as __resetCapUsageRegistryForTests, Un as createEventPlaneReader, Ut as hubMainRssBudget, V as CapUsageRegistry, Vn as EVENT_PLANE_TOP_N, Vt as createV8Reclaimer, W as getCapUsageRegistry, Wn as diffEventPlane, Wt as nextRssBudgetState, X as FrameDecoder, Xt as strandedMb, Y as localEndpointPath, Yt as startRunnerHeapWatch, Z as encodeFrame, Zt as ARRAY_BUFFER_CENSUS_COOLDOWN_MS, _ as AddonDepsManager, _n as MESH_QUEUE_TOP_N, _t as CapabilityUnavailableError, a as createUdsAddonContext, an as DECISIVE_HEAP_SPACES, at as createAddonService, b as brokerCallForCap, bn as EMPTY_SOCKET_PLANE_BASELINE, bt as resolveAddonClass, c as getOrInitReadinessRegistryForClient, cn as formatHeapSpaces, ct as capActionName, d as clusterEventTopic, dn as selectReportedSpaces, dt as capServiceName, en as ARRAY_BUFFER_RELEASE_MIN_DROP_RATIO, et as createBrokerDeviceManagerApi, f as getBrokerEventBus, fn as OUTBOUND_QUEUE_COOLDOWN_MS, ft as parseCapAction, g as subscribePassthrough, gn as formatOutboundQueueVerdict, gt as CapabilityHandle, h as setNodeEventInterest, hn as createOutboundQueueGate, ht as DeviceRegistry, i as createAddonContext, in as isArrayBufferCensusReport, j as AGENT_CAP_FWD_ACTION, jn as sampleSocketDirection, jt as HUB_MAIN_RSS_BUDGET_MB, k as createUdsLogger, kn as createSocketDirectionCounters, kt as HEAP_WATCH_WARN_RATIO, l as setHubConnected, ln as heapSpaceField, lt as capActionSuffix, m as registerEventBusService, mn as OUTBOUND_QUEUE_THRESHOLD_BYTES, mt as serializeTypedArrays, n as installManifestPythonDeps, nn as createInspectorArrayBufferCensus, o as getWorkerDeviceRegistry, on as HEAP_SPACE_REPORT_MIN_MB, ot as validateProviderRegistrations, p as getMoleculerEventStats, pn as OUTBOUND_QUEUE_SUSTAIN_MS, pt as deserializeTypedArrays, q as UdsLocalTransportServer, qt as shouldReclaim, r as adaptBrokerToCluster, rn as formatArrayBufferCensus, rt as mountNativeCapService, s as getOrInitReadinessRegistry, sn as emitHeapDiagnosticReport, st as NATIVE_PROVIDER_SERVICE_INFIX, t as installManifestSystemDeps, tn as createArrayBufferCensusGate, u as EVENT_TOPIC_PREFIX, un as readHeapSpaces, ut as capBareAction, v as createKernelHwAccel, vn as createMeshQueueReader, vt as copyBundledNativeModules, w as localProviderLink, wn as createSocketPlaneReader, wt as createAddonDataPlaneFacility, x as brokerTransportLink, xn as SOCKET_PLANE_TOP_N, xt as buildNpmChildEnv, y as resolveHwAccel, yn as formatMeshQueue, yt as installManifestNativeDeps, z as UDS_NO_ROUTE_PREFIX, zn as createCapActionCensus, zt as createDeferredHeapWatchSink } from "./manifest-system-deps-CfR7Z90J.mjs";
+import { $ as buildNativeCapProxy, $t as ARRAY_BUFFER_CENSUS_SUSTAIN_MS, A as createUdsLogger, An as createSocketDirectionCounters, At as HEAP_WATCH_WARN_RATIO, B as UDS_NO_ROUTE_PREFIX, Bn as createCapActionCensus, Bt as createDeferredHeapWatchSink, C as deviceCapResolverLink, Cn as SOCKET_QUEUE_TOP_N, Ct as resolveNpmInvocation, D as createUdsEventBridge, Dn as formatSocketPlane, Dt as HEAP_RECLAIM_STEADY_STATE_INTERVAL_MS, E as createParentUnownedCallHandler, En as diffSocketPlane, Et as HEAP_RECLAIM_MIN_INTERVAL_MS, F as callWithServiceDiscovery, Fn as CAP_ACTION_OVERFLOW_LABEL, Ft as RSS_BUDGET_RELEASE_RATIO, G as getCapUsageRegistry, Gn as diffEventPlane, Gt as nextRssBudgetState, H as CapUsageRegistry, Hn as EVENT_PLANE_TOP_N, Ht as createV8Reclaimer, I as CapRouteError, In as CAP_ACTION_UNLABELLED, It as RUNNER_HEAP_WATCH_INTERVAL_MS, J as UdsLocalTransportServer, Jt as shouldReclaim, K as createLocalTransport, Kn as formatEventPlane, Kt as parseRssBudgetMb, L as classifyCapRoute, Ln as EMPTY_CAP_ACTION_READING, Lt as RUNNER_RSS_BUDGET_ENV, M as AGENT_CAP_FWD_ACTION, Mn as sampleSocketDirection, Mt as HUB_MAIN_RSS_BUDGET_MB, N as AGENT_CAP_FWD_SERVICE, Nn as socketDirectionBytes, Nt as HUB_RSS_BUDGET_ENV, O as createUdsEventBus, On as readSocketQueues, Ot as HEAP_RECLAIM_TRIGGER_MB, P as CapRouteResolver, Pn as socketDirectionMessages, Pt as RSS_BUDGET_REANNOUNCE_MIN_MS, Q as encodeFrame, Qt as ARRAY_BUFFER_CENSUS_COOLDOWN_MS, R as LocalChildClient, Rn as MAX_CAP_ACTIONS_PER_PEER, Rt as ZERO_LOOP_DELAY, S as buildLinkChain, Sn as SOCKET_PLANE_TOP_N, St as buildNpmChildEnv, T as localProviderLink, Tn as createSocketPlaneReader, Tt as createAddonDataPlaneFacility, U as PARENT_ROUTED_PROVIDER_ADDON_ID, Un as createEventPlaneMeter, Ut as describeRss, V as readMoleculerFanoutMode, Vn as diffCapActionCensus, Vt as createLoopDelayMeter, W as __resetCapUsageRegistryForTests, Wn as createEventPlaneReader, Wt as hubMainRssBudget, X as localEndpointPath, Xt as startRunnerHeapWatch, Y as SocketChannel, Yt as startHeapWatch, Z as FrameDecoder, Zt as strandedMb, _ as AddonDepsManager, _n as formatOutboundQueueVerdict, _t as CapabilityHandle, a as createUdsAddonContext, an as isArrayBufferCensusReport, b as brokerCallForCap, bn as formatMeshQueue, bt as installManifestNativeDeps, c as getOrInitReadinessRegistryForClient, cn as emitHeapDiagnosticReport, ct as NATIVE_PROVIDER_SERVICE_INFIX, d as clusterEventTopic, dn as readHeapSpaces, dt as capBareAction, en as ARRAY_BUFFER_CENSUS_THRESHOLD_MB, et as buildUdsNativeCapProxy, f as getBrokerEventBus, fn as selectReportedSpaces, ft as capServiceName, g as subscribePassthrough, gn as createOutboundQueueGate, gt as DeviceRegistry, h as setNodeEventInterest, hn as OUTBOUND_QUEUE_THRESHOLD_BYTES, ht as serializeTypedArrays, i as createAddonContext, in as formatArrayBufferCensus, it as mountNativeCapService, j as createUdsLoggerWithControl, jn as recordSocketFrame, jt as HUB_MAIN_HEAP_WATCH_LABEL, k as udsChildLogToWorkerEntry, kn as EMPTY_SOCKET_DIRECTION, kt as HEAP_WATCH_INTERVAL_MS, l as setHubConnected, ln as formatHeapSpaces, lt as capActionName, m as registerEventBusService, mn as OUTBOUND_QUEUE_SUSTAIN_MS, mt as deserializeTypedArrays, n as installManifestPythonDeps, nn as createArrayBufferCensusGate, o as getWorkerDeviceRegistry, on as DECISIVE_HEAP_SPACES, ot as createAddonService, p as getMoleculerEventStats, pn as OUTBOUND_QUEUE_COOLDOWN_MS, pt as parseCapAction, q as UdsLocalTransportClient, qt as reclaimIntervalMs, r as adaptBrokerToCluster, rn as createInspectorArrayBufferCensus, s as getOrInitReadinessRegistry, sn as HEAP_SPACE_REPORT_MIN_MB, st as validateProviderRegistrations, t as installManifestSystemDeps, tn as ARRAY_BUFFER_RELEASE_MIN_DROP_RATIO, tt as createBrokerDeviceManagerApi, u as EVENT_TOPIC_PREFIX, un as heapSpaceField, ut as capActionSuffix, v as createKernelHwAccel, vn as MESH_QUEUE_TOP_N, vt as CapabilityUnavailableError, w as ipcParentLink, wn as createSocketPlaneMeter, wt as runNpm, x as brokerTransportLink, xn as EMPTY_SOCKET_PLANE_BASELINE, xt as resolveAddonClass, y as resolveHwAccel, yn as createMeshQueueReader, yt as copyBundledNativeModules, z as LocalChildRegistry, zn as capActionLabel, zt as buildHeapSample } from "./manifest-system-deps-BXf-Ouqx.mjs";
 import { n as getSinglePidStats, t as getPidStats } from "./resource-monitor-Vp0bPV3U.mjs";
 import { t as CustomActionRegistry } from "./custom-action-registry-B4Cf4O_X.mjs";
 import { z } from "zod";
@@ -95810,4 +95810,4 @@ var LifecycleJobEngine = class {
 	}
 };
 //#endregion
-export { AGENT_CAP_FWD_ACTION, AGENT_CAP_FWD_SERVICE, AGENT_READINESS_SERVICE_NAME, ALL_CAPABILITY_DEFINITIONS, ARRAY_BUFFER_CENSUS_COOLDOWN_MS, ARRAY_BUFFER_CENSUS_SUSTAIN_MS, ARRAY_BUFFER_CENSUS_THRESHOLD_MB, ARRAY_BUFFER_RELEASE_MIN_DROP_RATIO, AddonApiFactory, AddonDepsManager, AddonEngineManager, AddonHealthMonitor, AddonInstaller, AddonLoader, AddonManifest, AddonRouteRegistry, AlertCenterAddon, ApiKeyManager, AuthManager, CAP_ACTION_OVERFLOW_LABEL, CAP_ACTION_UNLABELLED, CA_COMMON_NAME, CA_VALIDITY_DAYS, CLUSTER_SECRET_MISMATCH_TYPE, CLUSTER_SECRET_REJECTED_EXIT_CODE, CORE_CAP_SERVICE_NAME, CapRouteError, CapRouteResolver, CapUsageRegistry, CapabilityHandle, CapabilityRegistry, CapabilityUnavailableError, ConfigManager, ConfigStore, ConsoleDestination, ConsoleLoggingAddon, CoreBlocksAddon, CustomActionRegistry, DECISIVE_HEAP_SPACES, DEFAULT_DATA_PATH, DEFAULT_LAN_HTTP_PORT, DEFAULT_LOG_LEVEL, DEVICE_SETTINGS_CONTRIBUTION_METHODS, DEVICE_STATUS_METHOD, DataPlaneRegistry, DeviceManagerAddon, DeviceRegistry, DeviceStore, EMPTY_CAP_ACTION_READING, EMPTY_SOCKET_DIRECTION, EMPTY_SOCKET_PLANE_BASELINE, EVENT_PLANE_TOP_N, EVENT_TOPIC_PREFIX, EngineManagerResolver, EventBus, FeatureManager, FilesystemStorageAddon, FilesystemStorageProvider, FrameDecoder, FsStorageBackend, HEALTH_MONITOR_GRACE_PERIOD_MS, HEALTH_MONITOR_RETRY_INTERVALS_MS, HEALTH_MONITOR_TICK_MS, HEAP_RECLAIM_MIN_INTERVAL_MS, HEAP_RECLAIM_STEADY_STATE_INTERVAL_MS, HEAP_RECLAIM_TRIGGER_MB, HEAP_SPACE_REPORT_MIN_MB, HEAP_WATCH_INTERVAL_MS, HEAP_WATCH_WARN_RATIO, HUB_CAP_FWD_ACTION, HUB_CAP_FWD_SERVICE, HUB_MAIN_HEAP_WATCH_LABEL, HUB_MAIN_RSS_BUDGET_MB, HUB_RSS_BUDGET_ENV, HubForwarderAddon, HubForwarderDestination, HubLogForwarder, HubNodeRegistry, INFRA_CAPABILITIES, IntegrationRegistry, JobJournal, LEAF_RENEWAL_WINDOW_DAYS, LifecycleJobEngine, LifecycleStateMachine, LivenessMonitorAddon, LocalAuthAddon, LocalChildClient, LocalChildRegistry, LogManager, LogRingBuffer, LoggingGate, LokiDestination, LokiLoggingAddon, MAX_CAP_ACTIONS_PER_PEER, MAX_LEAF_VALIDITY_DAYS, MESH_QUEUE_TOP_N, METHOD_ACCESS_MAP, ModelDownloadService, NATIVE_PROVIDER_SERVICE_INFIX, NATIVE_SCAN_DEPTH, NativeMetricsAddon, NativeMetricsProvider, NetworkQualityTracker, NotificationService, OUTBOUND_QUEUE_COOLDOWN_MS, OUTBOUND_QUEUE_SUSTAIN_MS, OUTBOUND_QUEUE_THRESHOLD_BYTES, PARENT_ROUTED_PROVIDER_ADDON_ID, PYTHON_VERSION, PipelineRunner, PipelineValidator, PythonEnvManager, QUARANTINE_DIRNAME, RESTART_MARKER_FILE, RSS_BUDGET_REANNOUNCE_MIN_MS, RSS_BUDGET_RELEASE_RATIO, RUNNER_HEAP_WATCH_INTERVAL_MS, RUNNER_RSS_BUDGET_ENV, RUNTIME_DEFAULTS, ReadinessRegistry, ReadinessTimeoutError, ReplEngine, RingBuffer, SERVER_AUTH_OID, SOCKET_PLANE_TOP_N, SOCKET_QUEUE_TOP_N, STALL_REPORT_MS, STALL_TICK_MS, ScopedLogger, ScopedTokenManager, SocketChannel, SqliteSettingsAddon, SqliteSettingsBackend, StagingArea, StorageLocationManager, StorageManager, StorageOrchestratorAddon, StorageOrchestratorService, SystemConfigAddon, SystemEventBus, TRADITIONAL_NATIVE_PACKAGES, ToastService, UDS_NO_ROUTE_PREFIX, UdsLocalTransportClient, UdsLocalTransportServer, UserManager, WinstonDestination, WinstonLoggingAddon, ZERO_LOOP_DELAY, __resetCapUsageRegistryForTests, __resetLoggingGateForTests, adaptBrokerToCluster, addonSettingsCapability, allFamiliesListenHost, applyLanHttp, attributeStall, bindPendingLanHttp, bootstrapSchema, brokerCallForCap, brokerTransportLink, buildBinaryPath, buildCapRouters, buildHeapSample, buildLinkChain, buildNativeCapProxy, buildNodeManifest, buildNpmChildEnv, buildStorageLocationRegistry, buildUdsNativeCapProxy, builderMountedCapNames, callRegisterNodeWithRetry, callWithServiceDiscovery, canServeDataPlane, capActionLabel, capActionName, capActionSuffix, capBareAction, capServiceName, classifyAddonDir, classifyCapRoute, clearPendingRestart, closeLanHttp, clusterEventTopic, clusterSecretMatches, collectCertIdentity, collectModelFiles, contentTypeFor, copyDirRecursive, copyExtraFileDirs, createAddonContext, createAddonDataPlaneFacility, createAddonService, createArrayBufferCensusGate, createAuthenticatedFileServer, createBroker, createBrokerDeviceManagerApi, createCapActionCensus, createCoreCapService, createDeferredHeapWatchSink, createDoorSettingsView, createEventPlaneMeter, createEventPlaneReader, createFileDataPlaneHandler, createHubCapForwardService, createHubService, createInspectorArrayBufferCensus, createKernelHwAccel, createLocalTransport, createLoopDelayMeter, createMeshQueueReader, createOutboundQueueGate, createParentUnownedCallHandler, createProcessService, createReadinessService, createReadinessServiceForRegistry, createScopedProcessManager, createSocketDirectionCounters, createSocketPlaneMeter, createSocketPlaneReader, createStreamProbeBrokerService, createUdsAddonContext, createUdsEventBridge, createUdsEventBus, createUdsLogger, createUdsLoggerWithControl, createV8Reclaimer, deleteModelFromDisk, deriveAgentListenPort, describeProviderKindDrift, describeRss, detectWorkspacePackagesDir, diffCapActionCensus, diffEventPlane, diffSocketPlane, downloadBinary, downloadFile, downloadModel, emitDownForOwnedCaps, emitHeapDiagnosticReport, encodeFrame, ensureAddonNativePrebuilds, ensureBinary, ensureDir, ensureFfmpeg, ensureLibraryBuilt, ensureModel, ensureNativePrebuilds, ensurePython, ensureTlsCert, evaluateExistingCert, expandCapMethods, fetchJson, findInPath, formatArrayBufferCensus, formatEventPlane, formatHeapSpaces, formatLogLine, formatMeshQueue, formatOutboundQueueVerdict, formatSocketPlane, getBrokerEventBus, getCapUsageRegistry, getFfmpegDownloadUrl, getLoggingGate, getModelFilePath, getMoleculerEventStats, getOrInitReadinessRegistry, getOrInitReadinessRegistryForClient, getPidStats, getPlatformInfo, getPythonDownloadUrl, getRestartMarkerPath, getSinglePidStats, getWorkerDeviceRegistry, hasDotNode, hashClusterSecret, heapSpaceField, hubMainRssBudget, installManifestNativeDeps, installManifestPythonDeps, installManifestSystemDeps, installPackageFromNpm, installPythonPackages, installPythonRequirements, ipcParentLink, isAddonDeploySource, isArrayBufferCensusReport, isArrayOutputSchema, isClusterSecretMismatchError, isCollectionArrayMethod, isInfraCapability, isModelDownloaded, isSourceNewer, isolatedBuiltinPhase, loadTlsCert, localEndpointPath, localProviderLink, mountNativeCapService, nextRssBudgetState, parseCapAction, parseRangeHeader, parseRssBudgetMb, parseTokenizedUrl, partitionIsolatedBuiltinIds, proxyToUpstream, quarantineAddonResidue, readExtraSans, readHeapSpaces, readLanHttpState, readMoleculerFanoutMode, readPendingRestart, readSocketQueues, readTlsAccessStatus, readTlsMode, readinessKey, reclaimIntervalMs, recordSocketFrame, registerEventBusService, registerLanHttpHandler, reissueTlsLeaf, resolveFilePath, resolveHwAccel, resolveNpmInvocation, runHubAddonBoot, runNpm, sampleSocketDirection, scheduleSelfRestart, scopeKey, scopesAllowAddon, scopesAllowDeviceCap, selectAddonResidue, selectReportedSpaces, serializeTypedArrays, setHubConnected, setNodeEventInterest, shouldReclaim, socketDirectionBytes, socketDirectionMessages, startEventLoopStallMonitor, startHeapWatch, startRunnerHeapWatch, strandedMb, stripCamstackDeps, subscribePassthrough, udsChildLogToWorkerEntry, validateProviderRegistrations, validateUploadedTls, waitUntilReady, writeExtraSans, writePendingRestart, writeTlsMode };
+export { AGENT_CAP_FWD_ACTION, AGENT_CAP_FWD_SERVICE, AGENT_READINESS_SERVICE_NAME, ALL_CAPABILITY_DEFINITIONS, ARRAY_BUFFER_CENSUS_COOLDOWN_MS, ARRAY_BUFFER_CENSUS_SUSTAIN_MS, ARRAY_BUFFER_CENSUS_THRESHOLD_MB, ARRAY_BUFFER_RELEASE_MIN_DROP_RATIO, AddonApiFactory, AddonDepsManager, AddonEngineManager, AddonHealthMonitor, AddonInstaller, AddonLoader, AddonManifest, AddonRouteRegistry, AlertCenterAddon, ApiKeyManager, AuthManager, CAP_ACTION_OVERFLOW_LABEL, CAP_ACTION_UNLABELLED, CA_COMMON_NAME, CA_VALIDITY_DAYS, CLUSTER_SECRET_MISMATCH_TYPE, CLUSTER_SECRET_REJECTED_EXIT_CODE, CORE_CAP_SERVICE_NAME, CapRouteError, CapRouteResolver, CapUsageRegistry, CapabilityHandle, CapabilityRegistry, CapabilityUnavailableError, ConfigManager, ConfigStore, ConsoleDestination, ConsoleLoggingAddon, CoreBlocksAddon, CustomActionRegistry, DECISIVE_HEAP_SPACES, DEFAULT_DATA_PATH, DEFAULT_LAN_HTTP_PORT, DEFAULT_LOG_LEVEL, DEVICE_SETTINGS_CONTRIBUTION_METHODS, DEVICE_STATUS_METHOD, DataPlaneRegistry, DeviceManagerAddon, DeviceRegistry, DeviceStore, EMPTY_CAP_ACTION_READING, EMPTY_SOCKET_DIRECTION, EMPTY_SOCKET_PLANE_BASELINE, EVENT_PLANE_TOP_N, EVENT_TOPIC_PREFIX, EngineManagerResolver, EventBus, FeatureManager, FilesystemStorageAddon, FilesystemStorageProvider, FrameDecoder, FsStorageBackend, HEALTH_MONITOR_GRACE_PERIOD_MS, HEALTH_MONITOR_RETRY_INTERVALS_MS, HEALTH_MONITOR_TICK_MS, HEAP_RECLAIM_MIN_INTERVAL_MS, HEAP_RECLAIM_STEADY_STATE_INTERVAL_MS, HEAP_RECLAIM_TRIGGER_MB, HEAP_SPACE_REPORT_MIN_MB, HEAP_WATCH_INTERVAL_MS, HEAP_WATCH_WARN_RATIO, HUB_CAP_FWD_ACTION, HUB_CAP_FWD_SERVICE, HUB_MAIN_HEAP_WATCH_LABEL, HUB_MAIN_RSS_BUDGET_MB, HUB_RSS_BUDGET_ENV, HubForwarderAddon, HubForwarderDestination, HubLogForwarder, HubNodeRegistry, INFRA_CAPABILITIES, IntegrationRegistry, JobJournal, LEAF_RENEWAL_WINDOW_DAYS, LifecycleJobEngine, LifecycleStateMachine, LivenessMonitorAddon, LocalAuthAddon, LocalChildClient, LocalChildRegistry, LogManager, LogRingBuffer, LoggingGate, LokiDestination, LokiLoggingAddon, MAX_CAP_ACTIONS_PER_PEER, MAX_LEAF_VALIDITY_DAYS, MESH_QUEUE_TOP_N, METHOD_ACCESS_MAP, ModelDownloadService, NATIVE_PROVIDER_SERVICE_INFIX, NATIVE_SCAN_DEPTH, NativeMetricsAddon, NativeMetricsProvider, NetworkQualityTracker, NotificationService, OUTBOUND_QUEUE_COOLDOWN_MS, OUTBOUND_QUEUE_SUSTAIN_MS, OUTBOUND_QUEUE_THRESHOLD_BYTES, PARENT_ROUTED_PROVIDER_ADDON_ID, PYTHON_VERSION, PipelineRunner, PipelineValidator, PythonEnvManager, QUARANTINE_DIRNAME, RESTART_MARKER_FILE, RSS_BUDGET_REANNOUNCE_MIN_MS, RSS_BUDGET_RELEASE_RATIO, RUNNER_HEAP_WATCH_INTERVAL_MS, RUNNER_RSS_BUDGET_ENV, RUNTIME_DEFAULTS, ReadinessRegistry, ReadinessTimeoutError, ReplEngine, RingBuffer, SERVER_AUTH_OID, SOCKET_PLANE_TOP_N, SOCKET_QUEUE_TOP_N, STALL_REPORT_MS, STALL_TICK_MS, ScopedLogger, ScopedTokenManager, SocketChannel, SqliteSettingsAddon, SqliteSettingsBackend, StagingArea, StorageLocationManager, StorageManager, StorageOrchestratorAddon, StorageOrchestratorService, SystemConfigAddon, SystemEventBus, TRADITIONAL_NATIVE_PACKAGES, ToastService, UDS_NO_ROUTE_PREFIX, UdsLocalTransportClient, UdsLocalTransportServer, UserManager, WinstonDestination, WinstonLoggingAddon, ZERO_LOOP_DELAY, __resetCapUsageRegistryForTests, __resetLoggingGateForTests, adaptBrokerToCluster, addonSettingsCapability, allFamiliesListenHost, applyLanHttp, attributeStall, bindPendingLanHttp, bootstrapSchema, brokerCallForCap, brokerTransportLink, buildBinaryPath, buildCapRouters, buildHeapSample, buildLinkChain, buildNativeCapProxy, buildNodeManifest, buildNpmChildEnv, buildStorageLocationRegistry, buildUdsNativeCapProxy, builderMountedCapNames, callRegisterNodeWithRetry, callWithServiceDiscovery, canServeDataPlane, capActionLabel, capActionName, capActionSuffix, capBareAction, capServiceName, classifyAddonDir, classifyCapRoute, clearPendingRestart, closeLanHttp, clusterEventTopic, clusterSecretMatches, collectCertIdentity, collectModelFiles, contentTypeFor, copyDirRecursive, copyExtraFileDirs, createAddonContext, createAddonDataPlaneFacility, createAddonService, createArrayBufferCensusGate, createAuthenticatedFileServer, createBroker, createBrokerDeviceManagerApi, createCapActionCensus, createCoreCapService, createDeferredHeapWatchSink, createDoorSettingsView, createEventPlaneMeter, createEventPlaneReader, createFileDataPlaneHandler, createHubCapForwardService, createHubService, createInspectorArrayBufferCensus, createKernelHwAccel, createLocalTransport, createLoopDelayMeter, createMeshQueueReader, createOutboundQueueGate, createParentUnownedCallHandler, createProcessService, createReadinessService, createReadinessServiceForRegistry, createScopedProcessManager, createSocketDirectionCounters, createSocketPlaneMeter, createSocketPlaneReader, createStreamProbeBrokerService, createUdsAddonContext, createUdsEventBridge, createUdsEventBus, createUdsLogger, createUdsLoggerWithControl, createV8Reclaimer, deleteModelFromDisk, deriveAgentListenPort, describeProviderKindDrift, describeRss, detectWorkspacePackagesDir, deviceCapResolverLink, diffCapActionCensus, diffEventPlane, diffSocketPlane, downloadBinary, downloadFile, downloadModel, emitDownForOwnedCaps, emitHeapDiagnosticReport, encodeFrame, ensureAddonNativePrebuilds, ensureBinary, ensureDir, ensureFfmpeg, ensureLibraryBuilt, ensureModel, ensureNativePrebuilds, ensurePython, ensureTlsCert, evaluateExistingCert, expandCapMethods, fetchJson, findInPath, formatArrayBufferCensus, formatEventPlane, formatHeapSpaces, formatLogLine, formatMeshQueue, formatOutboundQueueVerdict, formatSocketPlane, getBrokerEventBus, getCapUsageRegistry, getFfmpegDownloadUrl, getLoggingGate, getModelFilePath, getMoleculerEventStats, getOrInitReadinessRegistry, getOrInitReadinessRegistryForClient, getPidStats, getPlatformInfo, getPythonDownloadUrl, getRestartMarkerPath, getSinglePidStats, getWorkerDeviceRegistry, hasDotNode, hashClusterSecret, heapSpaceField, hubMainRssBudget, installManifestNativeDeps, installManifestPythonDeps, installManifestSystemDeps, installPackageFromNpm, installPythonPackages, installPythonRequirements, ipcParentLink, isAddonDeploySource, isArrayBufferCensusReport, isArrayOutputSchema, isClusterSecretMismatchError, isCollectionArrayMethod, isInfraCapability, isModelDownloaded, isSourceNewer, isolatedBuiltinPhase, loadTlsCert, localEndpointPath, localProviderLink, mountNativeCapService, nextRssBudgetState, parseCapAction, parseRangeHeader, parseRssBudgetMb, parseTokenizedUrl, partitionIsolatedBuiltinIds, proxyToUpstream, quarantineAddonResidue, readExtraSans, readHeapSpaces, readLanHttpState, readMoleculerFanoutMode, readPendingRestart, readSocketQueues, readTlsAccessStatus, readTlsMode, readinessKey, reclaimIntervalMs, recordSocketFrame, registerEventBusService, registerLanHttpHandler, reissueTlsLeaf, resolveFilePath, resolveHwAccel, resolveNpmInvocation, runHubAddonBoot, runNpm, sampleSocketDirection, scheduleSelfRestart, scopeKey, scopesAllowAddon, scopesAllowDeviceCap, selectAddonResidue, selectReportedSpaces, serializeTypedArrays, setHubConnected, setNodeEventInterest, shouldReclaim, socketDirectionBytes, socketDirectionMessages, startEventLoopStallMonitor, startHeapWatch, startRunnerHeapWatch, strandedMb, stripCamstackDeps, subscribePassthrough, udsChildLogToWorkerEntry, validateProviderRegistrations, validateUploadedTls, waitUntilReady, writeExtraSans, writePendingRestart, writeTlsMode };

package/dist/kernel/index.d.ts

@@ -69,7 +69,7 @@ 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';
 export { getWorkerDeviceRegistry } from './moleculer/addon-context-factory.js';
-export { localProviderLink, brokerTransportLink, ipcParentLink, buildLinkChain, brokerCallForCap, } from './moleculer/trpc-links.js';
+export { localProviderLink, brokerTransportLink, deviceCapResolverLink, ipcParentLink, buildLinkChain, brokerCallForCap, } from './moleculer/trpc-links.js';
 export type { LocalProviderResolver, BrokerCapCallOpts } from './moleculer/trpc-links.js';
 export { createProcessService } from './moleculer/process-service.js';
 export type { ProcessInfo } from './moleculer/process-service.js';

package/dist/kernel/moleculer/trpc-links.d.ts

@@ -170,6 +170,33 @@ export declare function brokerCallForCap(broker: ServiceBroker, capName: string,
 export interface BrokerTransportLinkOptions {
     readonly discoveryTimeoutMs?: number;
 }
+/**
+ * Dispatch a call to a device-scoped capability. Supplied by the hub, where it
+ * is `callCapabilityOnNode` — the entry the codegen cap routers already use,
+ * which extracts the `deviceId` from the input and asks the `CapRouteResolver`.
+ */
+export type DeviceCapDispatcher = (capName: string, method: string, input: unknown) => Promise<unknown>;
+/**
+ * The link that lets an IN-PROCESS addon call a device-scoped cap.
+ *
+ * Without it the hub's own `ctx.api` chain is `localProviderLink →
+ * brokerTransportLink`: a provider in this process, then the Moleculer
+ * registry. Forked addon children are BROKER-LESS (UDS), so a device provider
+ * such as hikvision's `ptz` advertises nothing on the bus, no service candidate
+ * matches, and the call falls back to the `<cap>.<cap>.<method>` shape
+ * documented above as the broken one. A forked addon never hits this because
+ * its chain ends at `ipcParentLink` → the parent's `CapRouteResolver`; an
+ * in-process one had no way to reach that authority at all.
+ *
+ * Deliberately narrow: it intercepts ONLY a cap whose definition says
+ * `scope: 'device'`, and only when the call actually carries a numeric
+ * `deviceId` to route on. A system cap that happens to take a `deviceId`
+ * argument (`deviceManager.getBindings`, `deviceState.getCapSlice`) is left
+ * exactly where it was. There is no fallback to the broker after a resolver
+ * failure, on purpose: the resolver's error names the node and the reason,
+ * and replacing it with "service not found" is how this class of bug hides.
+ */
+export declare function deviceCapResolverLink<TRouter extends AnyRouter>(dispatch: DeviceCapDispatcher, isDeviceScoped: (capName: string) => boolean): TRPCLink<TRouter>;
 export declare function brokerTransportLink<TRouter extends AnyRouter>(broker: ServiceBroker, serviceMap?: Readonly<Record<string, string>>, observerOpts?: CapUsageObserverOptions, linkOptions?: BrokerTransportLinkOptions): TRPCLink<TRouter>;
 /**
  * Middle link that routes a child addon's outbound `ctx.api` cap call to the

package/dist/{manifest-system-deps-CfR7Z90J.mjs → manifest-system-deps-BXf-Ouqx.mjs}

@@ -9556,6 +9556,49 @@ async function brokerCallForCap(broker, capName, method, args, opts) {
 	if (abort.aborted) throw new Error(`brokerCallForCap: aborted while awaiting "${capName}.${method}" discovery`);
 	return broker.call(action, callInput, callOpts);
 }
+/**
+* The link that lets an IN-PROCESS addon call a device-scoped cap.
+*
+* Without it the hub's own `ctx.api` chain is `localProviderLink →
+* brokerTransportLink`: a provider in this process, then the Moleculer
+* registry. Forked addon children are BROKER-LESS (UDS), so a device provider
+* such as hikvision's `ptz` advertises nothing on the bus, no service candidate
+* matches, and the call falls back to the `<cap>.<cap>.<method>` shape
+* documented above as the broken one. A forked addon never hits this because
+* its chain ends at `ipcParentLink` → the parent's `CapRouteResolver`; an
+* in-process one had no way to reach that authority at all.
+*
+* Deliberately narrow: it intercepts ONLY a cap whose definition says
+* `scope: 'device'`, and only when the call actually carries a numeric
+* `deviceId` to route on. A system cap that happens to take a `deviceId`
+* argument (`deviceManager.getBindings`, `deviceState.getCapSlice`) is left
+* exactly where it was. There is no fallback to the broker after a resolver
+* failure, on purpose: the resolver's error names the node and the reason,
+* and replacing it with "service not found" is how this class of bug hides.
+*/
+function deviceCapResolverLink(dispatch, isDeviceScoped) {
+	return () => {
+		return ({ op, next }) => {
+			const parsed = parsePath(op.path);
+			if (!parsed || !isDeviceScoped(parsed.capName)) return next(op);
+			const input = op.input;
+			const deviceId = input !== null && typeof input === "object" ? Reflect.get(input, "deviceId") : void 0;
+			if (typeof deviceId !== "number" || !Number.isFinite(deviceId)) return next(op);
+			return observable((observer) => {
+				dispatch(parsed.capName, parsed.method, input).then((data) => {
+					observer.next({ result: {
+						type: "data",
+						data
+					} });
+					observer.complete();
+				}).catch((cause) => {
+					observer.error(TRPCClientError.from(cause instanceof Error ? cause : new Error(String(cause))));
+				});
+				return () => {};
+			});
+		};
+	};
+}
 function brokerTransportLink(broker, serviceMap, observerOpts, linkOptions) {
 	const map = serviceMap ?? {};
 	const discoveryTimeoutMs = linkOptions?.discoveryTimeoutMs;
@@ -11583,4 +11626,4 @@ async function defaultRun(command, args) {
 	await execFileAsync(command, [...args], { timeout: INSTALL_TIMEOUT_MS });
 }
 //#endregion
-export { buildUdsNativeCapProxy as $, ARRAY_BUFFER_CENSUS_THRESHOLD_MB as $t, createUdsLoggerWithControl as A, recordSocketFrame as An, HUB_MAIN_HEAP_WATCH_LABEL as At, readMoleculerFanoutMode as B, diffCapActionCensus as Bn, createLoopDelayMeter as Bt, ipcParentLink as C, createSocketPlaneMeter as Cn, runNpm as Ct, createUdsEventBus as D, readSocketQueues as Dn, HEAP_RECLAIM_TRIGGER_MB as Dt, createUdsEventBridge as E, formatSocketPlane as En, HEAP_RECLAIM_STEADY_STATE_INTERVAL_MS as Et, CapRouteError as F, CAP_ACTION_UNLABELLED as Fn, RUNNER_HEAP_WATCH_INTERVAL_MS as Ft, createLocalTransport as G, formatEventPlane as Gn, parseRssBudgetMb as Gt, PARENT_ROUTED_PROVIDER_ADDON_ID as H, createEventPlaneMeter as Hn, describeRss as Ht, classifyCapRoute as I, EMPTY_CAP_ACTION_READING as In, RUNNER_RSS_BUDGET_ENV as It, SocketChannel as J, startHeapWatch as Jt, UdsLocalTransportClient as K, reclaimIntervalMs as Kt, LocalChildClient as L, MAX_CAP_ACTIONS_PER_PEER as Ln, ZERO_LOOP_DELAY as Lt, AGENT_CAP_FWD_SERVICE as M, socketDirectionBytes as Mn, HUB_RSS_BUDGET_ENV as Mt, CapRouteResolver as N, socketDirectionMessages as Nn, RSS_BUDGET_REANNOUNCE_MIN_MS as Nt, udsChildLogToWorkerEntry as O, EMPTY_SOCKET_DIRECTION as On, HEAP_WATCH_INTERVAL_MS as Ot, callWithServiceDiscovery as P, CAP_ACTION_OVERFLOW_LABEL as Pn, RSS_BUDGET_RELEASE_RATIO as Pt, buildNativeCapProxy as Q, ARRAY_BUFFER_CENSUS_SUSTAIN_MS as Qt, LocalChildRegistry as R, capActionLabel as Rn, buildHeapSample as Rt, buildLinkChain as S, SOCKET_QUEUE_TOP_N as Sn, resolveNpmInvocation as St, createParentUnownedCallHandler as T, diffSocketPlane as Tn, HEAP_RECLAIM_MIN_INTERVAL_MS as Tt, __resetCapUsageRegistryForTests as U, createEventPlaneReader as Un, hubMainRssBudget as Ut, CapUsageRegistry as V, EVENT_PLANE_TOP_N as Vn, createV8Reclaimer as Vt, getCapUsageRegistry as W, diffEventPlane as Wn, nextRssBudgetState as Wt, FrameDecoder as X, strandedMb as Xt, localEndpointPath as Y, startRunnerHeapWatch as Yt, encodeFrame as Z, ARRAY_BUFFER_CENSUS_COOLDOWN_MS as Zt, AddonDepsManager as _, MESH_QUEUE_TOP_N as _n, CapabilityUnavailableError as _t, createUdsAddonContext as a, DECISIVE_HEAP_SPACES as an, createAddonService as at, brokerCallForCap as b, EMPTY_SOCKET_PLANE_BASELINE as bn, resolveAddonClass as bt, getOrInitReadinessRegistryForClient as c, formatHeapSpaces as cn, capActionName as ct, clusterEventTopic as d, selectReportedSpaces as dn, capServiceName as dt, ARRAY_BUFFER_RELEASE_MIN_DROP_RATIO as en, createBrokerDeviceManagerApi as et, getBrokerEventBus as f, OUTBOUND_QUEUE_COOLDOWN_MS as fn, parseCapAction as ft, subscribePassthrough as g, formatOutboundQueueVerdict as gn, CapabilityHandle as gt, setNodeEventInterest as h, createOutboundQueueGate as hn, DeviceRegistry as ht, createAddonContext as i, isArrayBufferCensusReport as in, setWorkerNativeCapsChangeListener as it, AGENT_CAP_FWD_ACTION as j, sampleSocketDirection as jn, HUB_MAIN_RSS_BUDGET_MB as jt, createUdsLogger as k, createSocketDirectionCounters as kn, HEAP_WATCH_WARN_RATIO as kt, setHubConnected as l, heapSpaceField as ln, capActionSuffix as lt, registerEventBusService as m, OUTBOUND_QUEUE_THRESHOLD_BYTES as mn, serializeTypedArrays as mt, installManifestPythonDeps as n, createInspectorArrayBufferCensus as nn, getWorkerNativeCapSnapshot as nt, getWorkerDeviceRegistry as o, HEAP_SPACE_REPORT_MIN_MB as on, validateProviderRegistrations as ot, getMoleculerEventStats as p, OUTBOUND_QUEUE_SUSTAIN_MS as pn, deserializeTypedArrays as pt, UdsLocalTransportServer as q, shouldReclaim as qt, adaptBrokerToCluster as r, formatArrayBufferCensus as rn, mountNativeCapService as rt, getOrInitReadinessRegistry as s, emitHeapDiagnosticReport as sn, NATIVE_PROVIDER_SERVICE_INFIX as st, installManifestSystemDeps as t, createArrayBufferCensusGate as tn, getWorkerNativeCapProvider as tt, EVENT_TOPIC_PREFIX as u, readHeapSpaces as un, capBareAction as ut, createKernelHwAccel as v, createMeshQueueReader as vn, copyBundledNativeModules as vt, localProviderLink as w, createSocketPlaneReader as wn, createAddonDataPlaneFacility as wt, brokerTransportLink as x, SOCKET_PLANE_TOP_N as xn, buildNpmChildEnv as xt, resolveHwAccel as y, formatMeshQueue as yn, installManifestNativeDeps as yt, UDS_NO_ROUTE_PREFIX as z, createCapActionCensus as zn, createDeferredHeapWatchSink as zt };
+export { buildNativeCapProxy as $, ARRAY_BUFFER_CENSUS_SUSTAIN_MS as $t, createUdsLogger as A, createSocketDirectionCounters as An, HEAP_WATCH_WARN_RATIO as At, UDS_NO_ROUTE_PREFIX as B, createCapActionCensus as Bn, createDeferredHeapWatchSink as Bt, deviceCapResolverLink as C, SOCKET_QUEUE_TOP_N as Cn, resolveNpmInvocation as Ct, createUdsEventBridge as D, formatSocketPlane as Dn, HEAP_RECLAIM_STEADY_STATE_INTERVAL_MS as Dt, createParentUnownedCallHandler as E, diffSocketPlane as En, HEAP_RECLAIM_MIN_INTERVAL_MS as Et, callWithServiceDiscovery as F, CAP_ACTION_OVERFLOW_LABEL as Fn, RSS_BUDGET_RELEASE_RATIO as Ft, getCapUsageRegistry as G, diffEventPlane as Gn, nextRssBudgetState as Gt, CapUsageRegistry as H, EVENT_PLANE_TOP_N as Hn, createV8Reclaimer as Ht, CapRouteError as I, CAP_ACTION_UNLABELLED as In, RUNNER_HEAP_WATCH_INTERVAL_MS as It, UdsLocalTransportServer as J, shouldReclaim as Jt, createLocalTransport as K, formatEventPlane as Kn, parseRssBudgetMb as Kt, classifyCapRoute as L, EMPTY_CAP_ACTION_READING as Ln, RUNNER_RSS_BUDGET_ENV as Lt, AGENT_CAP_FWD_ACTION as M, sampleSocketDirection as Mn, HUB_MAIN_RSS_BUDGET_MB as Mt, AGENT_CAP_FWD_SERVICE as N, socketDirectionBytes as Nn, HUB_RSS_BUDGET_ENV as Nt, createUdsEventBus as O, readSocketQueues as On, HEAP_RECLAIM_TRIGGER_MB as Ot, CapRouteResolver as P, socketDirectionMessages as Pn, RSS_BUDGET_REANNOUNCE_MIN_MS as Pt, encodeFrame as Q, ARRAY_BUFFER_CENSUS_COOLDOWN_MS as Qt, LocalChildClient as R, MAX_CAP_ACTIONS_PER_PEER as Rn, ZERO_LOOP_DELAY as Rt, buildLinkChain as S, SOCKET_PLANE_TOP_N as Sn, buildNpmChildEnv as St, localProviderLink as T, createSocketPlaneReader as Tn, createAddonDataPlaneFacility as Tt, PARENT_ROUTED_PROVIDER_ADDON_ID as U, createEventPlaneMeter as Un, describeRss as Ut, readMoleculerFanoutMode as V, diffCapActionCensus as Vn, createLoopDelayMeter as Vt, __resetCapUsageRegistryForTests as W, createEventPlaneReader as Wn, hubMainRssBudget as Wt, localEndpointPath as X, startRunnerHeapWatch as Xt, SocketChannel as Y, startHeapWatch as Yt, FrameDecoder as Z, strandedMb as Zt, AddonDepsManager as _, formatOutboundQueueVerdict as _n, CapabilityHandle as _t, createUdsAddonContext as a, isArrayBufferCensusReport as an, setWorkerNativeCapsChangeListener as at, brokerCallForCap as b, formatMeshQueue as bn, installManifestNativeDeps as bt, getOrInitReadinessRegistryForClient as c, emitHeapDiagnosticReport as cn, NATIVE_PROVIDER_SERVICE_INFIX as ct, clusterEventTopic as d, readHeapSpaces as dn, capBareAction as dt, ARRAY_BUFFER_CENSUS_THRESHOLD_MB as en, buildUdsNativeCapProxy as et, getBrokerEventBus as f, selectReportedSpaces as fn, capServiceName as ft, subscribePassthrough as g, createOutboundQueueGate as gn, DeviceRegistry as gt, setNodeEventInterest as h, OUTBOUND_QUEUE_THRESHOLD_BYTES as hn, serializeTypedArrays as ht, createAddonContext as i, formatArrayBufferCensus as in, mountNativeCapService as it, createUdsLoggerWithControl as j, recordSocketFrame as jn, HUB_MAIN_HEAP_WATCH_LABEL as jt, udsChildLogToWorkerEntry as k, EMPTY_SOCKET_DIRECTION as kn, HEAP_WATCH_INTERVAL_MS as kt, setHubConnected as l, formatHeapSpaces as ln, capActionName as lt, registerEventBusService as m, OUTBOUND_QUEUE_SUSTAIN_MS as mn, deserializeTypedArrays as mt, installManifestPythonDeps as n, createArrayBufferCensusGate as nn, getWorkerNativeCapProvider as nt, getWorkerDeviceRegistry as o, DECISIVE_HEAP_SPACES as on, createAddonService as ot, getMoleculerEventStats as p, OUTBOUND_QUEUE_COOLDOWN_MS as pn, parseCapAction as pt, UdsLocalTransportClient as q, reclaimIntervalMs as qt, adaptBrokerToCluster as r, createInspectorArrayBufferCensus as rn, getWorkerNativeCapSnapshot as rt, getOrInitReadinessRegistry as s, HEAP_SPACE_REPORT_MIN_MB as sn, validateProviderRegistrations as st, installManifestSystemDeps as t, ARRAY_BUFFER_RELEASE_MIN_DROP_RATIO as tn, createBrokerDeviceManagerApi as tt, EVENT_TOPIC_PREFIX as u, heapSpaceField as un, capActionSuffix as ut, createKernelHwAccel as v, MESH_QUEUE_TOP_N as vn, CapabilityUnavailableError as vt, ipcParentLink as w, createSocketPlaneMeter as wn, runNpm as wt, brokerTransportLink as x, EMPTY_SOCKET_PLANE_BASELINE as xn, resolveAddonClass as xt, resolveHwAccel as y, createMeshQueueReader as yn, copyBundledNativeModules as yt, LocalChildRegistry as z, capActionLabel as zn, buildHeapSample as zt };

package/dist/{manifest-system-deps-CzyjTMcO.js → manifest-system-deps-CfVyUKLU.js}

@@ -9559,6 +9559,49 @@ async function brokerCallForCap(broker, capName, method, args, opts) {
 	if (abort.aborted) throw new Error(`brokerCallForCap: aborted while awaiting "${capName}.${method}" discovery`);
 	return broker.call(action, callInput, callOpts);
 }
+/**
+* The link that lets an IN-PROCESS addon call a device-scoped cap.
+*
+* Without it the hub's own `ctx.api` chain is `localProviderLink →
+* brokerTransportLink`: a provider in this process, then the Moleculer
+* registry. Forked addon children are BROKER-LESS (UDS), so a device provider
+* such as hikvision's `ptz` advertises nothing on the bus, no service candidate
+* matches, and the call falls back to the `<cap>.<cap>.<method>` shape
+* documented above as the broken one. A forked addon never hits this because
+* its chain ends at `ipcParentLink` → the parent's `CapRouteResolver`; an
+* in-process one had no way to reach that authority at all.
+*
+* Deliberately narrow: it intercepts ONLY a cap whose definition says
+* `scope: 'device'`, and only when the call actually carries a numeric
+* `deviceId` to route on. A system cap that happens to take a `deviceId`
+* argument (`deviceManager.getBindings`, `deviceState.getCapSlice`) is left
+* exactly where it was. There is no fallback to the broker after a resolver
+* failure, on purpose: the resolver's error names the node and the reason,
+* and replacing it with "service not found" is how this class of bug hides.
+*/
+function deviceCapResolverLink(dispatch, isDeviceScoped) {
+	return () => {
+		return ({ op, next }) => {
+			const parsed = parsePath(op.path);
+			if (!parsed || !isDeviceScoped(parsed.capName)) return next(op);
+			const input = op.input;
+			const deviceId = input !== null && typeof input === "object" ? Reflect.get(input, "deviceId") : void 0;
+			if (typeof deviceId !== "number" || !Number.isFinite(deviceId)) return next(op);
+			return observable((observer) => {
+				dispatch(parsed.capName, parsed.method, input).then((data) => {
+					observer.next({ result: {
+						type: "data",
+						data
+					} });
+					observer.complete();
+				}).catch((cause) => {
+					observer.error(_trpc_client.TRPCClientError.from(cause instanceof Error ? cause : new Error(String(cause))));
+				});
+				return () => {};
+			});
+		};
+	};
+}
 function brokerTransportLink(broker, serviceMap, observerOpts, linkOptions) {
 	const map = serviceMap ?? {};
 	const discoveryTimeoutMs = linkOptions?.discoveryTimeoutMs;
@@ -12162,6 +12205,12 @@ Object.defineProperty(exports, "deserializeTypedArrays", {
 		return deserializeTypedArrays;
 	}
 });
+Object.defineProperty(exports, "deviceCapResolverLink", {
+	enumerable: true,
+	get: function() {
+		return deviceCapResolverLink;
+	}
+});
 Object.defineProperty(exports, "diffCapActionCensus", {
 	enumerable: true,
 	get: function() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/system",
-  "version": "1.2.255",
+  "version": "1.2.257",
   "description": "Core addon for CamStack — builtins, pipeline, process management, auth, logging, events",
   "keywords": [
     "camstack",
@@ -203,7 +203,7 @@
         "id": "autotrack",
         "category": "system",
         "name": "PTZ Autotrack (emulated)",
-        "description": "Wrapper over the `ptz-autotrack` cap — follows a subject with self-terminating `ptz.move` pulses on cameras whose firmware has no autotrack, driven by the detection pipeline's tracked boxes. The operator binds it per camera, then uses the SAME autotrack switch a native camera has: the binding chooses the implementation, never a second toggle. It refuses to move without a readable `moveImpulseMs`, and while a firmware autotrack on the same camera reports armed.",
+        "description": "Wrapper over the `ptz-autotrack` cap — follows a subject with self-terminating `ptz.move` pulses on cameras whose firmware has no autotrack, driven by the detection pipeline's tracked boxes. The operator binds it per camera, then uses the SAME autotrack switch a native camera has: the binding chooses the implementation, never a second toggle. It refuses to move without a readable `moveImpulseMs`, and while a firmware autotrack on the same camera reports armed. Runs IN-PROCESS: it spawns nothing, carries no frames and issues a command every few seconds at most.",
         "entry": "./dist/builtins/autotrack/index.js",
         "capabilities": [
           {