@camstack/server 1.2.124 → 1.2.126

package/dist/agent/agent-update-service.js

@@ -60,11 +60,15 @@ exports.agentRuntimeManifestEntry = agentRuntimeManifestEntry;
  *
  * Spec: docs/superpowers/specs/2026-07-18-single-framework-copy-collapse-design.md
  */
+const node_crypto_1 = require("node:crypto");
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const index_js_1 = require("../server-root/index.js");
 const system_exec_npm_js_1 = require("../core/server-update/system-exec-npm.js");
 const system_ensure_prebuilds_js_1 = require("../core/server-update/system-ensure-prebuilds.js");
+const system_1 = require("@camstack/system");
+const types_1 = require("@camstack/types");
+const update_availability_emitter_js_1 = require("../core/update-availability-emitter.js");
 /**
  * The synthetic addonId the agent's OWN runtime registers infra providers
  * under (no addon owns them — the bootstrap does). Appears in the agent's
@@ -143,7 +147,13 @@ function scheduleAgentRestart(logger, requestedBy, dataDir) {
     grace.unref();
 }
 class AgentUpdateService extends index_js_1.RootUpdateService {
+    updateAvailability;
+    eventBus;
+    nodeId;
+    agentDataDir;
     constructor(options) {
+        const restartAgent = options.restartAgent ??
+            ((requestedBy) => scheduleAgentRestart(options.logger, requestedBy, options.dataDir));
         super({
             spec: index_js_1.HUB_ROOT_SPEC,
             // The agent's on-disk root IS `@camstack/server` (booted via
@@ -155,8 +165,10 @@ class AgentUpdateService extends index_js_1.RootUpdateService {
                 seedDir: 'CAMSTACK_SEED_SERVER_DIR',
             },
             logger: options.logger,
-            restartServer: options.restartAgent ??
-                ((requestedBy) => scheduleAgentRestart(options.logger, requestedBy, options.dataDir)),
+            restartServer: (requestedBy) => {
+                writeAgentRestartMarker(options.dataDir, requestedBy);
+                restartAgent(requestedBy);
+            },
             dataDir: options.dataDir,
             runningPackageJsonPath: options.runningPackageJsonPath ?? resolveAgentPackageJsonPath(__dirname),
             workspaceProbeDir: __dirname,
@@ -175,9 +187,88 @@ class AgentUpdateService extends index_js_1.RootUpdateService {
             env: options.env,
             now: options.now,
         });
+        this.nodeId = options.nodeId ?? process.env['CAMSTACK_NODE_ID'] ?? 'agent';
+        this.agentDataDir = options.dataDir;
+        this.eventBus = options.eventBus ?? null;
+        this.updateAvailability =
+            options.eventBus !== undefined
+                ? new update_availability_emitter_js_1.UpdateAvailabilityEmitter(options.eventBus, {
+                    type: 'core',
+                    id: 'agent-update-service',
+                })
+                : null;
+    }
+    bindAvailability(eventBus, nodeId) {
+        this.eventBus = eventBus;
+        this.nodeId = nodeId;
+        this.updateAvailability = new update_availability_emitter_js_1.UpdateAvailabilityEmitter(eventBus, {
+            type: 'core',
+            id: 'agent-update-service',
+        });
+    }
+    async checkServerUpdate() {
+        const result = await super.checkServerUpdate();
+        if (result.error !== null)
+            return result;
+        this.updateAvailability?.publishSnapshot('server', result.updateAvailable && result.runningVersion !== null && result.latestVersion !== null
+            ? [
+                {
+                    target: 'server',
+                    packageName: result.packageName,
+                    currentVersion: result.runningVersion,
+                    latestVersion: result.latestVersion,
+                    nodeId: this.nodeId,
+                },
+            ]
+            : [], this.nodeId);
+        return result;
+    }
+    /** Consume `.restart-pending` and emit `system.restart-completed` if present. */
+    emitRestartCompletedIfPending() {
+        const bus = this.eventBus;
+        if (bus === null)
+            return;
+        const marker = (0, system_1.readPendingRestart)(this.agentDataDir);
+        if (marker === null)
+            return;
+        const payload = {
+            kind: marker.kind,
+            requestedAt: marker.requestedAt,
+            nodeId: this.nodeId,
+            ...(marker.packageName !== undefined ? { packageName: marker.packageName } : {}),
+            ...(marker.fromVersion !== undefined ? { fromVersion: marker.fromVersion } : {}),
+            ...(marker.toVersion !== undefined ? { toVersion: marker.toVersion } : {}),
+            ...(marker.requestedBy !== undefined ? { requestedBy: marker.requestedBy } : {}),
+        };
+        bus.emit({
+            id: (0, node_crypto_1.randomUUID)(),
+            timestamp: new Date(),
+            source: { type: 'core', id: 'agent-update-service' },
+            category: types_1.EventCategory.SystemRestartCompleted,
+            data: payload,
+        });
     }
 }
 exports.AgentUpdateService = AgentUpdateService;
+function writeAgentRestartMarker(dataDir, requestedBy) {
+    const toVersion = /@([^@\s]+)$/.exec(requestedBy)?.[1];
+    try {
+        (0, system_1.writePendingRestart)(dataDir, {
+            kind: requestedBy.startsWith('server-update:') ? 'framework-update' : 'manual',
+            requestedAt: Date.now(),
+            requestedBy,
+            ...(requestedBy.startsWith('server-update:')
+                ? {
+                    packageName: '@camstack/server',
+                    ...(toVersion !== undefined ? { toVersion } : {}),
+                }
+                : {}),
+        });
+    }
+    catch {
+        // Marker write must never block the restart.
+    }
+}
 /**
  * The manifest entry for the agent runtime's own providers. Appended to
  * `buildAgentOwnManifest`'s output so `server-management` reaches the hub's

package/dist/agent/main.js

@@ -378,6 +378,7 @@ async function startAgent(configPath) {
         agentBootConfirmed = true;
         try {
             agentUpdateService.confirmBootHealthy();
+            agentUpdateService.emitRestartCompletedIfPending();
         }
         catch (err) {
             consoleLogger.warn(`agent root boot confirmation failed: ${err instanceof Error ? err.message : String(err)}`);
@@ -655,9 +656,10 @@ async function startAgent(configPath) {
     // local events propagate to every UDS child. Inert when agentUdsRegistry
     // was not started (no UDS children). Wired after broker.start() so
     // getBrokerEventBus returns the fully operational shared bus.
+    const agentBrokerEventBus = (0, system_1.getBrokerEventBus)(broker);
+    agentUpdateService.bindAvailability(agentBrokerEventBus, broker.nodeID);
     let udsEventBridgeDispose = null;
     if (agentUdsRegistry !== undefined) {
-        const agentBrokerEventBus = (0, system_1.getBrokerEventBus)(broker);
         udsEventBridgeDispose = (0, system_1.createUdsEventBridge)({
             registry: agentUdsRegistry,
             parentBus: agentBrokerEventBus,

package/dist/boot/post-boot.service.js

@@ -75,6 +75,7 @@ class PostBootService {
         const payload = {
             kind: marker.kind,
             requestedAt: marker.requestedAt,
+            nodeId: process.env['CAMSTACK_NODE_ID'] ?? 'hub',
             ...(marker.packageName !== undefined ? { packageName: marker.packageName } : {}),
             ...(marker.fromVersion !== undefined ? { fromVersion: marker.fromVersion } : {}),
             ...(marker.toVersion !== undefined ? { toVersion: marker.toVersion } : {}),

package/dist/core/addon/addon-package.service.js

@@ -1103,10 +1103,17 @@ class AddonPackageService {
      */
     restartServer(requestedBy) {
         this.logger.info('Server restart requested -- initiating graceful shutdown');
+        const toVersion = toVersionFromRestartReason(requestedBy);
         const payload = {
-            kind: 'manual',
+            kind: isServerUpdateRequest(requestedBy) ? 'framework-update' : 'manual',
             requestedAt: Date.now(),
             ...(requestedBy !== undefined ? { requestedBy } : {}),
+            ...(isServerUpdateRequest(requestedBy)
+                ? {
+                    packageName: '@camstack/server',
+                    ...(toVersion !== undefined ? { toVersion } : {}),
+                }
+                : {}),
         };
         try {
             (0, system_1.writePendingRestart)(this.resolveDataDir(), payload);
@@ -1710,6 +1717,15 @@ class AddonPackageService {
     }
 }
 exports.AddonPackageService = AddonPackageService;
+function isServerUpdateRequest(requestedBy) {
+    return requestedBy !== undefined && requestedBy.startsWith('server-update:');
+}
+function toVersionFromRestartReason(requestedBy) {
+    if (requestedBy === undefined)
+        return undefined;
+    const match = /@([^@\s]+)$/.exec(requestedBy);
+    return match?.[1];
+}
 // ---------------------------------------------------------------------------
 // Tarball extraction helper (exported for regression tests)
 // ---------------------------------------------------------------------------

package/dist/core/server-update/server-update.service.js

@@ -58,6 +58,7 @@ const system_ensure_prebuilds_js_1 = require("./system-ensure-prebuilds.js");
 const update_availability_emitter_js_1 = require("../update-availability-emitter.js");
 class ServerUpdateService extends index_js_1.RootUpdateService {
     updateAvailability;
+    nodeId;
     constructor(options) {
         const dataDir = path.resolve(options.dataDir ??
             options.env?.['CAMSTACK_DATA'] ??
@@ -99,11 +100,13 @@ class ServerUpdateService extends index_js_1.RootUpdateService {
                     id: 'server-update-service',
                 })
                 : null;
+        this.nodeId = options.nodeId ?? 'hub';
     }
     async checkServerUpdate() {
         const result = await super.checkServerUpdate();
         if (result.error !== null)
             return result;
+        const nodeId = this.nodeId;
         this.updateAvailability?.publishSnapshot('server', result.updateAvailable && result.runningVersion !== null && result.latestVersion !== null
             ? [
                 {
@@ -111,9 +114,10 @@ class ServerUpdateService extends index_js_1.RootUpdateService {
                     packageName: result.packageName,
                     currentVersion: result.runningVersion,
                     latestVersion: result.latestVersion,
+                    ...(nodeId !== undefined ? { nodeId } : {}),
                 },
             ]
-            : []);
+            : [], nodeId);
         return result;
     }
 }

package/dist/core/update-availability-emitter.js

@@ -3,14 +3,23 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateAvailabilityEmitter = void 0;
 const types_1 = require("@camstack/types");
 /**
- * Emits update availability only when a successful check changes the observed
- * `(currentVersion, latestVersion)` pair. A successful empty snapshot clears
- * prior state; failed checks should not call this method.
+ * Emits update availability only when a successful check changes an observed
+ * `latestVersion` (or first-sees a package/node that has one). Repeated polls
+ * of the same latests are silent.
+ *
+ * Addon snapshots emit ONE event carrying the **entire** currently-available
+ * list. Server snapshots do the same across nodes, so the Notification Center
+ * can say "1.0.3 is available on hub and little-unraid" instead of one push
+ * per package or per node.
+ *
+ * A successful empty snapshot clears prior state for that scope; failed checks
+ * should not call this method.
  */
 class UpdateAvailabilityEmitter {
     eventBus;
     source;
-    signatures = new Map();
+    latestByKey = new Map();
+    held = new Map();
     constructor(eventBus, source) {
         this.eventBus = eventBus;
         this.source = source;
@@ -18,36 +27,78 @@ class UpdateAvailabilityEmitter {
     publishSnapshot(target, candidates, nodeId) {
         const scope = nodeId ?? 'hub';
         const present = new Set();
+        let latestChanged = false;
         for (const candidate of candidates) {
             if (candidate.target !== target)
                 continue;
-            const key = this.key(candidate);
+            const stamped = stampNode(candidate, nodeId);
+            const key = this.key(stamped);
             present.add(key);
-            this.publish(candidate);
+            if (this.note(stamped))
+                latestChanged = true;
         }
-        for (const key of this.signatures.keys()) {
-            if (key.startsWith(`${target}:${scope}:`) && !present.has(key)) {
-                this.signatures.delete(key);
-            }
+        for (const key of [...this.held.keys()]) {
+            if (!key.startsWith(`${target}:${scope}:`))
+                continue;
+            if (present.has(key))
+                continue;
+            this.held.delete(key);
+            this.latestByKey.delete(key);
         }
+        if (!latestChanged)
+            return;
+        this.emitList(target);
     }
     /** Publish a partial candidate set without treating omissions as up-to-date. */
     publishCandidates(candidates) {
-        for (const candidate of candidates)
-            this.publish(candidate);
+        let latestChanged = false;
+        const targets = new Set();
+        for (const candidate of candidates) {
+            targets.add(candidate.target);
+            if (this.note(candidate))
+                latestChanged = true;
+        }
+        if (!latestChanged)
+            return;
+        for (const target of targets)
+            this.emitList(target);
     }
-    publish(candidate) {
+    note(candidate) {
         const key = this.key(candidate);
-        const signature = `${candidate.currentVersion}->${candidate.latestVersion}`;
-        if (this.signatures.get(key) === signature)
+        const previous = this.latestByKey.get(key);
+        this.held.set(key, candidate);
+        this.latestByKey.set(key, candidate.latestVersion);
+        return previous !== candidate.latestVersion;
+    }
+    emitList(target) {
+        const list = [...this.held.values()].filter((candidate) => candidate.target === target);
+        if (list.length === 0)
             return;
-        this.signatures.set(key, signature);
+        const packages = list.map((candidate) => ({
+            packageName: candidate.packageName,
+            currentVersion: candidate.currentVersion,
+            latestVersion: candidate.latestVersion,
+            ...(candidate.nodeId !== undefined ? { nodeId: candidate.nodeId } : {}),
+        }));
+        const nodeIds = unique(packages.map((pkg) => pkg.nodeId).filter((id) => id !== undefined));
+        const head = list[0];
         this.eventBus.emit({
-            id: `update.available:${key}:${signature}`,
+            id: `update.available:${target}:${packages
+                .map((pkg) => `${pkg.nodeId ?? 'hub'}:${pkg.packageName}@${pkg.latestVersion}`)
+                .toSorted()
+                .join(',')}`,
             timestamp: new Date(),
             source: this.source,
             category: types_1.EventCategory.UpdateAvailable,
-            data: candidate,
+            data: {
+                target,
+                packageName: head.packageName,
+                currentVersion: head.currentVersion,
+                latestVersion: head.latestVersion,
+                packages,
+                ...(head.nodeId !== undefined ? { nodeId: head.nodeId } : {}),
+                ...(nodeIds.length > 0 ? { nodeIds } : {}),
+            },
         });
     }
     key(candidate) {
@@ -55,3 +106,11 @@ class UpdateAvailabilityEmitter {
     }
 }
 exports.UpdateAvailabilityEmitter = UpdateAvailabilityEmitter;
+function stampNode(candidate, nodeId) {
+    if (nodeId === undefined || candidate.nodeId !== undefined)
+        return candidate;
+    return { ...candidate, nodeId };
+}
+function unique(values) {
+    return [...new Set(values)];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/server",
-  "version": "1.2.124",
+  "version": "1.2.126",
   "private": false,
   "files": [
     "dist",
@@ -33,18 +33,18 @@
     ]
   },
   "dependencies": {
-    "@camstack/addon-admin-ui": "1.2.67",
+    "@camstack/addon-admin-ui": "1.2.68",
     "@camstack/addon-agent-ui": "1.2.20",
     "@camstack/addon-auth": "1.2.22",
     "@camstack/addon-decoder-nodeav": "1.2.19",
     "@camstack/addon-notifiers": "1.2.24",
-    "@camstack/addon-pipeline": "1.2.88",
-    "@camstack/addon-pipeline-orchestrator": "1.2.66",
-    "@camstack/addon-post-analysis": "1.2.84",
+    "@camstack/addon-pipeline": "1.2.89",
+    "@camstack/addon-pipeline-orchestrator": "1.2.69",
+    "@camstack/addon-post-analysis": "1.2.85",
     "@camstack/sdk": "1.2.22",
     "@camstack/shm-ring": "1.1.19",
-    "@camstack/system": "1.2.100",
-    "@camstack/types": "1.2.82",
+    "@camstack/system": "1.2.102",
+    "@camstack/types": "1.2.83",
     "@camstack/ui-library": "1.2.57",
     "@fastify/compress": "^9.0.0",
     "@fastify/cookie": "^11.0.2",