@camstack/server 1.2.490 → 1.2.491

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.490",
+  "version": "1.2.491",
   "license": "MIT",
   "private": false,
   "files": [
@@ -37,17 +37,17 @@
     ]
   },
   "dependencies": {
-    "@camstack/addon-admin-ui": "1.2.363",
+    "@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/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",