@camstack/system 1.1.36 → 1.1.38

package/dist/kernel/moleculer/node-registry.d.ts

@@ -32,6 +32,17 @@ interface RegisteredNativeCap {
     readonly addonId: string;
     readonly deviceIds: readonly number[];
 }
+/**
+ * A node's runtime-updatable ROOT package identity (`@camstack/server` on
+ * the hub, `@camstack/agent` on agents) — carried in the `registerNode`
+ * manifest so the hub knows every node's exact software version (design:
+ * runtime-updatable node packages, "visibility"). Version skew is SEEN in
+ * the UI instead of discovered via a black-hole.
+ */
+interface NodeRootPackageInfo {
+    readonly name: string;
+    readonly version: string;
+}
 /** Payload of the `$hub.registerNode` RPC — a node's COMPLETE manifest. */
 interface RegisterNodeParams {
     readonly nodeId: string;
@@ -50,6 +61,12 @@ interface RegisterNodeParams {
      * receiver; never carries the raw secret. (Cluster-secret registration gate.)
      */
     readonly clusterSecretHash?: string;
+    /**
+     * The node's root-package identity. Optional — absent from UDS child
+     * manifests and pre-phase-2 agents; present on agents running the
+     * runtime-updatable root model.
+     */
+    readonly rootPackage?: NodeRootPackageInfo;
 }
 /** Ack returned by `$hub.registerNode` — presence of `ok` is the signal. */
 interface RegisterNodeResult {
@@ -73,6 +90,8 @@ declare class HubNodeRegistry {
     private readonly nodes;
     /** nodeId → its device-scoped native caps (last `registerNode` wins). */
     private readonly nativeCaps;
+    /** nodeId → its root-package identity (last `registerNode` wins). */
+    private readonly rootPackages;
     /**
      * deviceId → flat native-cap entries for THAT device, across all nodes.
      * Maintained incrementally on every `registerNode`/`removeNode` so a
@@ -99,6 +118,8 @@ declare class HubNodeRegistry {
     registerNode(params: RegisterNodeParams): void;
     /** Drop a node entirely — caps AND native caps — on `$node.disconnected`. */
     removeNode(nodeId: string): void;
+    /** The node's root-package identity, or null when it never reported one. */
+    getNodeRootPackage(nodeId: string): NodeRootPackageInfo | null;
     /** The node's manifest, or undefined when the node never registered. */
     getNodeManifest(nodeId: string): readonly RegisteredAddonManifest[] | undefined;
     /**
@@ -123,4 +144,4 @@ declare class HubNodeRegistry {
     listNodeIds(): readonly string[];
 }
 export { HubNodeRegistry };
-export type { CallFn, RegisteredAddonManifest, RegisteredNativeCap, RegisterNodeParams, RegisterNodeResult, NodeCapEntry, NodeNativeCapEntry, };
+export type { CallFn, NodeRootPackageInfo, RegisteredAddonManifest, RegisteredNativeCap, RegisterNodeParams, RegisterNodeResult, NodeCapEntry, NodeNativeCapEntry, };

package/dist/kernel/moleculer/register-node-client.d.ts

@@ -1,4 +1,4 @@
-import { RegisteredAddonManifest, RegisteredNativeCap, RegisterNodeParams } from './node-registry.js';
+import { NodeRootPackageInfo, RegisteredAddonManifest, RegisteredNativeCap, RegisterNodeParams } from './node-registry.js';
 /** Minimal broker surface this client needs. */
 interface RegisterNodeBroker {
     call(action: string, params: unknown, opts?: {
@@ -19,11 +19,14 @@ interface CallRegisterNodeOptions {
 }
 /**
  * Build a `RegisterNodeParams` from a node id, its per-addon manifests,
- * optionally its device-scoped native caps, and optionally the SHA-256 hash
- * of the cluster secret. `nativeCaps` is omitted entirely on the first
- * handshake; `clusterSecretHash` is omitted when no secret is configured.
+ * optionally its device-scoped native caps, optionally the SHA-256 hash
+ * of the cluster secret, and optionally the node's root-package identity
+ * (runtime-updatable node packages: version visibility). `nativeCaps` is
+ * omitted entirely on the first handshake; `clusterSecretHash` is omitted
+ * when no secret is configured; `rootPackage` is omitted by nodes that do
+ * not run the root-package model (UDS children).
  */
-declare function buildNodeManifest(nodeId: string, addons: readonly RegisteredAddonManifest[], nativeCaps?: readonly RegisteredNativeCap[], clusterSecretHash?: string): RegisterNodeParams;
+declare function buildNodeManifest(nodeId: string, addons: readonly RegisteredAddonManifest[], nativeCaps?: readonly RegisteredNativeCap[], clusterSecretHash?: string, rootPackage?: NodeRootPackageInfo): RegisterNodeParams;
 /**
  * Call `<target>.registerNode` and retry until the parent acks. The loop
  * terminates ONLY on a successful ack or an abort — there is no fixed

package/dist/{manifest-python-deps-BYIV8-rc.mjs → manifest-python-deps-4QvOLiBn.mjs}

@@ -1,4 +1,4 @@
-import { H as readNodePin } from "./dist-C7oOY4iL.mjs";
+import { H as readNodePin } from "./dist-CU3lb_Ys.mjs";
 import { ensureBinary, ensureFfmpeg, ensurePython, installPythonPackages, installPythonRequirements } from "@camstack/types/node";
 import { createServer } from "node:http";
 import * as fs from "node:fs";

package/dist/{manifest-python-deps-CZFqI4wp.js → manifest-python-deps-B6ahe90k.js}

@@ -1,5 +1,5 @@
 const require_chunk = require("./chunk-Cek0wNdY.js");
-const require_dist = require("./dist-COIhbSao.js");
+const require_dist = require("./dist-fRVWwrkF.js");
 let _camstack_types_node = require("@camstack/types/node");
 let node_http = require("node:http");
 let node_fs = require("node:fs");

package/package.json

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