@camstack/system 1.1.22 → 1.1.24

package/dist/builtins/device-manager/device-meta-actions.d.ts

@@ -97,6 +97,27 @@ export declare function setDeviceLinks(pctx: ProviderContext, input: Parameters<
  * `setIntegrationId`). Idempotent. `null` clears a previous role.
  */
 export declare function setRole(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['setRole']>[0]): ReturnType<IDeviceManagerProvider['setRole']>;
+/**
+ * Set (or clear) the per-device display override on a device's meta row.
+ * Mirrors `setChildLayout` persistence; `null` REMOVES the `display` key
+ * entirely (immutable rest-destructure — matches the "absent ⇒ no override"
+ * projection contract, never persists `display: undefined`). Override units are
+ * normalized at write so the render path always looks up canonical spellings.
+ */
+export declare function setDisplay(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['setDisplay']>[0]): ReturnType<IDeviceManagerProvider['setDisplay']>;
+/**
+ * Read the operator-authored per-role display defaults. Empty record when none
+ * set. Not per-device — a plain top-level-key read.
+ */
+export declare function getRoleDisplayDefaults(pctx: ProviderContext, _input: Parameters<IDeviceManagerProvider['getRoleDisplayDefaults']>[0]): ReturnType<IDeviceManagerProvider['getRoleDisplayDefaults']>;
+/**
+ * Replace the per-role display defaults whole-record (full replace). Override
+ * units are normalized (`normalizeUnit`) at write so the render path always
+ * looks up canonical spellings. Single-writer top-level key — no lock, no RMW,
+ * no interaction with the `deviceMeta` write lock. Not per-device, so no event
+ * is emitted; the UI invalidates its own query on mutate.
+ */
+export declare function setRoleDisplayDefaults(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['setRoleDisplayDefaults']>[0]): ReturnType<IDeviceManagerProvider['setRoleDisplayDefaults']>;
 /**
  * Batched meta pre-seed. Applies every provided field to the
  * device's meta row in ONE read-modify-write under a single

package/dist/builtins/device-manager/device-meta-store.d.ts

@@ -62,6 +62,12 @@ export declare class DeviceMetaStore {
      *  whose stableId is `${parentStableId}-${sourceKey}`. Null when absent.
      *  Pure over a pre-read meta map so a multi-link resolve reads the store once. */
     resolveSourceDeviceId: (parentStableId: string, sourceKey: string, meta: Record<string, PersistedDeviceMeta>) => number | null;
+    /** Resolve a GLOBAL link source (P2e) to a live device id: the device whose
+     *  FULL stableId equals `sourceStableId`, regardless of parent container.
+     *  First match wins (stableIds are effectively unique cluster-wide — see the
+     *  `DeviceLinkGlobalSource` docblock). Null when absent. Pure over a
+     *  pre-read meta map so a multi-link resolve reads the store once. */
+    resolveGlobalSourceDeviceId: (sourceStableId: string, meta: Record<string, PersistedDeviceMeta>) => number | null;
     allocateNextDeviceId: () => Promise<number>;
     /** Rebuild the `linkTargets` / `linkDependents` reverse-index maps from the
      *  current persisted meta. Called at boot (once the `devicesWithLinks` seed

package/dist/builtins/device-manager/device-meta-types.d.ts

@@ -1,4 +1,4 @@
-import { ChildLayout, DeviceLinks } from '@camstack/types';
+import { ChildLayout, DeviceDisplayOverride, DeviceLinks, RoleDisplayDefault } from '@camstack/types';
 /**
  * Wire shape matching `z.infer<typeof SettingsSchemaWithValuesSchema>` —
  * duplicated as a plain interface because importing the Zod schema across
@@ -132,6 +132,11 @@ export interface PersistedDeviceMeta {
      *  Optional: only present for accessory children that carry a known role
      *  (e.g. 'numeric-sensor', 'binary-sensor'). `null` clears a previous role. */
     role?: string | null;
+    /** Operator-authored per-device display override (icon/label/unit/precision/
+     *  hidden), set via `setDisplay`. Same create/persist/project/restore
+     *  lifecycle as `deviceLinks`. Absent ⇒ no override. Applied at render time
+     *  only — storage stays in source units. */
+    display?: DeviceDisplayOverride;
 }
 export interface AddonStore {
     deviceIndex?: Record<string, string[]>;
@@ -166,4 +171,10 @@ export interface AddonStore {
      * the operator forgot to register a label before assigning it.
      */
     locations?: readonly string[];
+    /** Operator-authored per-role display defaults (unit/precision/icon), keyed
+     *  by `DeviceRole` string. Resolution merges these UNDER any per-device
+     *  `display` override. Written whole-record by `setRoleDisplayDefaults`
+     *  (full replace — no read-modify-write, single writer, so it never
+     *  interacts with the `deviceMeta` write lock). */
+    roleDisplayDefaults?: Record<string, RoleDisplayDefault>;
 }

package/dist/builtins/device-manager/device-projection.d.ts

@@ -47,6 +47,7 @@ export declare function isDeviceRole(value: string): value is DeviceRole;
  *  never leaks an off-enum string onto the wire shape. */
 export declare function toDeviceRole(value: string | null | undefined): DeviceRole | null;
 export declare function toDeviceInfo(addonId: string, device: IDevice, metadata?: Record<string, unknown> | null, metaRow?: PersistedDeviceMeta | null): {
+    display?: import('@camstack/types').DeviceDisplayOverride | undefined;
     deviceLinks?: import('@camstack/types').DeviceLinks | undefined;
     childLayout?: import('@camstack/types').ChildLayout | undefined;
     primaryChildEntityId?: string | null | undefined;

package/dist/builtins/device-manager/device-provider-context.d.ts

@@ -14,6 +14,10 @@ export interface ProviderHost {
     readonly devicesWithLinks: Set<number>;
     /** Expected link-source stableIds, gating the `registerDevice` rebuild. */
     readonly expectedSourceStableIds: Set<string>;
+    /** In-flight `${deviceId}:${cap}` pairs of `resolveLinkedStatus` — the
+     *  defensive re-entrancy guard that bounds link cycles at resolve time
+     *  (P2e). A nested resolve of a pair already in flight returns null. */
+    readonly linkResolveInFlight: Set<string>;
     /** Drop a removed device's overlay-emit guard entries (state-mirror keyed
      *  `${deviceId}:${cap}`). Called from `removeDevice`. */
     dropDeviceOverlays(deviceId: number): void;

package/dist/builtins/device-manager/device-state-mirror.d.ts

@@ -108,18 +108,26 @@ export declare class DeviceStateMirror {
      * Read-time overlay of a cap slice with its cross-device linked values.
      * Returns a cloned raw mirror slice when the (device, cap) pair has no
      * links. Sources are read from the same in-hub stateMirror — sync, no
-     * cross-process call. The disk writer must NOT use this method; it must
-     * persist raw provider truth via snapshotForDevice.
+     * cross-process call. When the raw slice is ABSENT but the cap is a link
+     * target, the slice is SYNTHESIZED: the merge base is seeded from the
+     * cap's declared `status.empty` default; a failed/empty synthesize
+     * returns null (no phantom slices). The disk writer must NOT use this
+     * method; it must persist raw provider truth via snapshotForDevice.
      */
     overlayedSlice(deviceId: number, cap: string): Record<string, unknown> | null;
     /**
      * Like snapshotForDevice but applies the device-link overlay per cap.
      * Used exclusively by the device-state READ methods (getSnapshot,
-     * getAllSnapshots) so callers see overlayed values. The debounced disk
-     * writer must continue to call snapshotForDevice (raw truth).
+     * getAllSnapshots) so callers see overlayed values. SYNTHESIZE-only
+     * link-target caps (no base mirror slice) are unioned into the iterated
+     * key set so they appear at warm-load — `overlayedSlice` builds them from
+     * the cap's `status.empty` (and drops them when nothing resolves). The
+     * debounced disk writer must continue to call snapshotForDevice (raw truth).
      */
     snapshotForDeviceOverlayed(deviceId: number): Record<string, Record<string, unknown>>;
-    /** Whole-system mirror dump (overlaid). Backs `deviceState.getAllSnapshots`. */
+    /** Whole-system mirror dump (overlaid). Backs `deviceState.getAllSnapshots`.
+     *  Devices that only exist as link TARGETS (no mirror slice yet) are
+     *  included via the link reverse-index so their synthesized caps appear. */
     allSnapshotsOverlayed(): Record<string, Record<string, Record<string, unknown>>>;
     private emitStateChanged;
     /** Emit DeviceStateChanged for (deviceId, cap) using the OVERLAID slice,

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-D7iR07uA.js");
+const require_manifest_python_deps = require("./manifest-python-deps-XWJwKYDx.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");

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

@@ -1423,6 +1423,18 @@ function createBrokerDeviceManagerApi(opts) {
 						meta: { error: err instanceof Error ? err.message : String(err) }
 					});
 				});
+				if (initialMeta.display !== void 0) await callDeviceManager(api, "setDisplay", {
+					deviceId: id,
+					display: initialMeta.display
+				}).catch((err) => {
+					opts.logger.warn("create: setDisplay pre-seed failed", {
+						tags: {
+							stableId,
+							deviceId: id
+						},
+						meta: { error: err instanceof Error ? err.message : String(err) }
+					});
+				});
 			}
 			if (Object.keys(config).length > 0) await callDeviceManager(api, "persistConfig", {
 				deviceId: id,

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

@@ -1425,6 +1425,18 @@ function createBrokerDeviceManagerApi(opts) {
 						meta: { error: err instanceof Error ? err.message : String(err) }
 					});
 				});
+				if (initialMeta.display !== void 0) await callDeviceManager(api, "setDisplay", {
+					deviceId: id,
+					display: initialMeta.display
+				}).catch((err) => {
+					opts.logger.warn("create: setDisplay pre-seed failed", {
+						tags: {
+							stableId,
+							deviceId: id
+						},
+						meta: { error: err instanceof Error ? err.message : String(err) }
+					});
+				});
 			}
 			if (Object.keys(config).length > 0) await callDeviceManager(api, "persistConfig", {
 				deviceId: id,

package/package.json

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