@camstack/server 1.2.489 → 1.2.491

package/dist/agent/agent-http.js

@@ -385,10 +385,11 @@ async function createAgentHttpServer(getBroker, config) {
     // eslint-disable-next-line oxc/no-async-endpoint-handlers
     app.post('/api/agent/config', async (req, reply) => {
         // `joinToken` is redeemed, never stored; `meshTls` only ever comes from an
-        // enrollment, never from a request body.
+        // enrollment (or is cleared via `clearMeshTls`), never pasted as PEM.
         const body = req.body ?? {};
         const joinToken = body['joinToken'];
-        const patch = Object.fromEntries(Object.entries(body).filter(([k]) => k !== 'joinToken' && k !== 'meshTls'));
+        const clearMeshTls = body['clearMeshTls'] === true;
+        const patch = Object.fromEntries(Object.entries(body).filter(([k]) => k !== 'joinToken' && k !== 'meshTls' && k !== 'clearMeshTls'));
         const existing = readConfigFile(config.configPath);
         // Join-token enrollment (mesh mTLS Release A): the hub address comes from
         // the token and wins over a `hubAddress` posted in the same form. Nothing is
@@ -411,6 +412,9 @@ async function createAgentHttpServer(getBroker, config) {
             merged['hubAddress'] = enrolled.hubAddress;
             merged['meshTls'] = enrolled.meshTls;
         }
+        else if (clearMeshTls) {
+            delete merged['meshTls'];
+        }
         writeConfigFile(config.configPath, merged);
         if (enrolled !== null) {
             console.log(`[Agent] Enrolled in the mesh CA via join token — hub ${enrolled.hubAddress}, ` +
@@ -432,11 +436,13 @@ async function createAgentHttpServer(getBroker, config) {
         // false-positive "Restart required" prompts on no-op saves.
         const reconnectRelevant = ['hubAddress', 'secret'];
         const needsReconnect = enrolled !== null ||
+            clearMeshTls ||
             reconnectRelevant.some((k) => Object.prototype.hasOwnProperty.call(patch, k) && patch[k] !== existing[k]);
         return {
             success: true,
             restartRequired: needsReconnect,
             ...(enrolled !== null ? { enrolled: true } : {}),
+            ...(clearMeshTls ? { clearedMeshTls: true } : {}),
         };
     });
     // -- Agent reconnect (applies new hub/secret config) ----------------

package/dist/core/agent/agent-liveness-event.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentOfflineData = agentOfflineData;
+exports.nodeDisplayName = nodeDisplayName;
+/**
+ * The payload of `agent.offline`, built from what Moleculer told us.
+ *
+ * `unexpected` is Moleculer's own verdict on `$node.disconnected`: `true` when
+ * the heartbeat or the socket was lost, `false` when the node sent its
+ * DISCONNECT on a clean stop. The notification centre turns it into the body
+ * of the "node offline" notification (D820).
+ */
+function agentOfflineData(agentId, unexpected, nodeName) {
+    return {
+        agentId,
+        ...(nodeName !== undefined ? { nodeName } : {}),
+        ...(unexpected !== undefined
+            ? { reason: unexpected ? 'connection-lost' : 'shutdown' }
+            : {}),
+    };
+}
+/** The history's display name for a node — only a real one, never the id echoed back. */
+function nodeDisplayName(nodeId, history) {
+    const name = history?.find((row) => row.id === nodeId)?.name;
+    return name !== undefined && name.length > 0 && name !== nodeId ? name : undefined;
+}

package/dist/core/agent/agent-registry.service.js

@@ -42,6 +42,7 @@ const system_1 = require("@camstack/system");
 const types_1 = require("@camstack/types");
 const agent_addon_backfill_1 = require("./agent-addon-backfill");
 const agent_delivery_ledger_1 = require("./agent-delivery-ledger");
+const agent_liveness_event_1 = require("./agent-liveness-event");
 const cluster_node_history_mirror_1 = require("./cluster-node-history-mirror");
 const node_directory_1 = require("./node-directory");
 /** Turn a forget outcome into the sentence the operator reads. */
@@ -477,12 +478,13 @@ class AgentRegistryService {
                 return;
             if (kind === 'agent') {
                 console.log(`[agent-registry] Agent connected: ${node.id}`);
+                const nodeName = this.knownNodeName(node.id);
                 this.eventBus.emit({
                     id: (0, node_crypto_1.randomUUID)(),
                     timestamp: new Date(),
                     source: { type: 'core', id: 'agent-registry' },
                     category: types_1.EventCategory.AgentOnline,
-                    data: { agentId: node.id },
+                    data: { agentId: node.id, ...(nodeName !== undefined ? { nodeName } : {}) },
                 });
             }
             else {
@@ -495,12 +497,12 @@ class AgentRegistryService {
                 });
             }
         });
-        this.broker.localBus.on('$node.disconnected', ({ node }) => {
+        this.broker.localBus.on('$node.disconnected', ({ node, unexpected }) => {
             const kind = classifyNode(node.id);
             if (!kind)
                 return;
             if (kind === 'agent') {
-                console.log(`[agent-registry] Agent disconnected: ${node.id}`);
+                console.log(`[agent-registry] Agent disconnected: ${node.id}${unexpected === true ? ' (unexpected)' : ''}`);
                 // A1: stamp the disconnect time as the node's `lastActive` so its
                 // offline row reports an honest "last seen". Best-effort, no-op if the
                 // node was never snapshotted while online.
@@ -510,7 +512,7 @@ class AgentRegistryService {
                     timestamp: new Date(),
                     source: { type: 'core', id: 'agent-registry' },
                     category: types_1.EventCategory.AgentOffline,
-                    data: { agentId: node.id },
+                    data: (0, agent_liveness_event_1.agentOfflineData)(node.id, unexpected, this.knownNodeName(node.id)),
                 });
             }
             else {
@@ -557,6 +559,10 @@ class AgentRegistryService {
             // Registry shape varies across Moleculer versions — never fatal.
         }
     }
+    /** The durable history's display name for a node, when it knows a real one. */
+    knownNodeName(nodeId) {
+        return (0, agent_liveness_event_1.nodeDisplayName)(nodeId, this.historyMirror?.peek() ?? null);
+    }
     // ---- Placement reconciliation ----
     /**
      * Boot-time reconciliation pass. Agents already connected when the hub

package/dist/core/agent/cluster-node-history-mirror.js

@@ -42,6 +42,14 @@ class ClusterNodeHistoryMirror {
         const rows = await this.refresh();
         return rows ?? this.entry?.rows ?? null;
     }
+    /**
+     * The last successful read, however old, without reading. For a synchronous
+     * caller that only wants a label (the node liveness events' display name) —
+     * a stale name is still the right name, and no answer is `null`.
+     */
+    peek() {
+        return this.entry?.rows ?? null;
+    }
     /** Drop the mirror (a node was forgotten): the next `current()` must re-read. */
     invalidate() {
         this.generation += 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/server",
-  "version": "1.2.489",
+  "version": "1.2.491",
   "license": "MIT",
   "private": false,
   "files": [
@@ -37,18 +37,18 @@
     ]
   },
   "dependencies": {
-    "@camstack/addon-admin-ui": "1.2.362",
-    "@camstack/addon-agent-ui": "1.2.197",
+    "@camstack/addon-admin-ui": "1.2.364",
+    "@camstack/addon-agent-ui": "1.2.198",
     "@camstack/addon-auth": "1.2.135",
     "@camstack/addon-decoder-nodeav": "1.2.122",
     "@camstack/addon-notifiers": "1.2.129",
     "@camstack/addon-pipeline": "1.2.347",
     "@camstack/addon-pipeline-orchestrator": "1.2.301",
-    "@camstack/addon-post-analysis": "1.2.348",
+    "@camstack/addon-post-analysis": "1.2.349",
     "@camstack/sdk": "1.2.128",
-    "@camstack/system": "1.2.384",
-    "@camstack/types": "1.2.334",
-    "@camstack/ui-library": "1.2.255",
+    "@camstack/system": "1.2.385",
+    "@camstack/types": "1.2.335",
+    "@camstack/ui-library": "1.2.256",
     "@fastify/compress": "^9.0.0",
     "@fastify/cookie": "^11.0.2",
     "@fastify/cors": "^11.2.0",