@camstack/server 1.2.703 → 1.2.705

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.705] - 2026-10-31
+
+### Fixed
+
+- A node agent stopped by a signal now shuts down within 15 seconds and logs what started it, instead of hanging while looking alive but deregistered
+
+## [1.2.704] - 2026-10-30
+
+### Changed
+
+- Rebuilt against updated dependencies.
+
 ## [1.2.703] - 2026-10-30
 
 ### Added

package/dist/agent/agent-shutdown.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SHUTDOWN_DEADLINE_MS = exports.SHUTDOWN_STEP_TIMEOUT_MS = void 0;
+exports.createAgentShutdown = createAgentShutdown;
+exports.SHUTDOWN_STEP_TIMEOUT_MS = 5_000;
+exports.SHUTDOWN_DEADLINE_MS = 15_000;
+function errMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+async function runBounded(step, timeoutMs) {
+    let timer;
+    const timeout = new Promise((resolve) => {
+        timer = setTimeout(() => resolve('timed-out'), timeoutMs);
+    });
+    try {
+        return await Promise.race([step.run().then(() => 'done'), timeout]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** Returns `shutdown(reason)`; `reason` names the signal or caller that started it. */
+function createAgentShutdown(deps) {
+    const stepTimeoutMs = deps.stepTimeoutMs ?? exports.SHUTDOWN_STEP_TIMEOUT_MS;
+    const deadlineMs = deps.deadlineMs ?? exports.SHUTDOWN_DEADLINE_MS;
+    const { logger } = deps;
+    let startedAt = null;
+    return async (reason) => {
+        if (startedAt !== null) {
+            logger.error(`shutdown already in progress for ${Date.now() - startedAt}ms; ${reason} forces exit`);
+            deps.exit(1);
+            return;
+        }
+        const began = Date.now();
+        startedAt = began;
+        logger.info(`shutdown started by ${reason}`);
+        const deadline = setTimeout(() => {
+            logger.error(`shutdown deadline of ${deadlineMs}ms exceeded (started by ${reason}); exiting 1`);
+            deps.exit(1);
+        }, deadlineMs);
+        for (const step of deps.steps) {
+            const stepStart = Date.now();
+            try {
+                const outcome = await runBounded(step, stepTimeoutMs);
+                const took = `${Date.now() - stepStart}ms`;
+                if (outcome === 'timed-out') {
+                    logger.warn(`shutdown step ${step.name} timed out after ${took}; continuing`);
+                }
+                else {
+                    logger.info(`shutdown step ${step.name} done in ${took}`);
+                }
+            }
+            catch (err) {
+                logger.warn(`shutdown step ${step.name} failed after ${Date.now() - stepStart}ms: ${errMessage(err)}`);
+            }
+        }
+        clearTimeout(deadline);
+        logger.info(`shutdown finished in ${Date.now() - began}ms (started by ${reason})`);
+        deps.exit(0);
+    };
+}

package/dist/agent/main.js

@@ -48,6 +48,7 @@ const addon_scan_js_1 = require("./addon-scan.js");
 const agent_addon_updates_js_1 = require("./agent-addon-updates.js");
 const agent_hub_registration_js_1 = require("./agent-hub-registration.js");
 const agent_mesh_gate_js_1 = require("./agent-mesh-gate.js");
+const agent_shutdown_js_1 = require("./agent-shutdown.js");
 const agent_pairing_local_js_1 = require("./agent-pairing-local.js");
 const agent_membership_watch_js_1 = require("./agent-membership-watch.js");
 const agent_pairing_store_js_1 = require("./agent-pairing-store.js");
@@ -1071,34 +1072,49 @@ async function startAgent(configPath) {
     }).then((listener) => {
         agentHttpListener = listener;
     });
-    // Graceful shutdown
-    const shutdown = async () => {
-        console.log('[Agent] Shutting down...');
-        // Abort any in-flight upward hub registration retry loop.
-        registerAbortController.abort();
-        // Dispose the UDS event bridge to remove the parent-bus subscriber and
-        // clear the child-event handler, preventing subscriber leaks on shutdown.
-        udsEventBridgeDispose?.();
-        udsEventBridgeDispose = null;
-        for (const [, entry] of loadedAddons) {
-            if (entry.addon?.shutdown) {
-                try {
-                    await entry.addon.shutdown();
-                }
-                catch {
-                    /* */
-                }
-            }
-        }
-        // Withdraw the mDNS advertisement, then stop accepting new HTTP/HTTPS connections before
-        // the broker goes away.
-        await agentMdns.stop().catch(() => undefined);
-        await agentHttpListener?.close().catch(() => undefined);
-        await broker.stop();
-        process.exit(0);
-    };
-    process.on('SIGTERM', shutdown);
-    process.on('SIGINT', shutdown);
+    // Graceful shutdown: bounded, re-entry guarded, and it logs what started it (agent-shutdown.ts).
+    const shutdown = (0, agent_shutdown_js_1.createAgentShutdown)({
+        logger: consoleLogger,
+        exit: (code) => process.exit(code),
+        steps: [
+            {
+                name: 'abort-registration',
+                run: async () => {
+                    // Abort any in-flight upward hub registration retry loop.
+                    registerAbortController.abort();
+                    // Dispose the UDS event bridge to remove the parent-bus subscriber and
+                    // clear the child-event handler, preventing subscriber leaks on shutdown.
+                    udsEventBridgeDispose?.();
+                    udsEventBridgeDispose = null;
+                },
+            },
+            {
+                name: 'addons',
+                // Concurrent: one slow addon must not eat the budget of the others.
+                run: async () => {
+                    const stops = [];
+                    for (const [addonId, entry] of loadedAddons) {
+                        if (!entry.addon?.shutdown)
+                            continue;
+                        const began = Date.now();
+                        stops.push(Promise.resolve()
+                            .then(() => entry.addon?.shutdown?.())
+                            .then(() => undefined)
+                            .catch((err) => consoleLogger.warn(`addon ${addonId} shutdown failed: ${(0, types_2.errMsg)(err)}`))
+                            .finally(() => consoleLogger.info(`addon ${addonId} shutdown took ${Date.now() - began}ms`)));
+                    }
+                    await Promise.all(stops);
+                },
+            },
+            // Withdraw the mDNS advertisement, then stop accepting new HTTP/HTTPS connections before
+            // the broker goes away.
+            { name: 'mdns', run: () => agentMdns.stop() },
+            { name: 'http-listener', run: async () => void (await agentHttpListener?.close()) },
+            { name: 'broker', run: () => broker.stop() },
+        ],
+    });
+    process.on('SIGTERM', () => void shutdown('SIGTERM'));
+    process.on('SIGINT', () => void shutdown('SIGINT'));
     // An unpaired agent has no hub to read settings from (D857): serve pairing only and
     // relaunch after the certificate is installed (D5). See agent-boot-mode.ts.
     if (!addonsBooted) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/server",
-  "version": "1.2.703",
+  "version": "1.2.705",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -50,20 +50,20 @@
     ]
   },
   "dependencies": {
-    "@camstack/addon-admin-ui": "1.2.527",
-    "@camstack/addon-agent-ui": "1.2.299",
+    "@camstack/addon-admin-ui": "1.2.529",
+    "@camstack/addon-agent-ui": "1.2.300",
     "@camstack/addon-auth": "1.2.172",
-    "@camstack/addon-benchmark": "1.2.298",
+    "@camstack/addon-benchmark": "1.2.299",
     "@camstack/addon-decoder-nodeav": "1.2.144",
-    "@camstack/addon-notifiers": "1.2.623",
+    "@camstack/addon-notifiers": "1.2.624",
     "@camstack/addon-pipeline": "1.2.635",
-    "@camstack/addon-pipeline-orchestrator": "1.2.640",
-    "@camstack/addon-post-analysis": "1.2.653",
+    "@camstack/addon-pipeline-orchestrator": "1.2.642",
+    "@camstack/addon-post-analysis": "1.2.654",
     "@camstack/develop": "0.1.41",
     "@camstack/sdk": "1.2.154",
-    "@camstack/system": "1.2.525",
-    "@camstack/types": "1.2.452",
-    "@camstack/ui-library": "1.2.357",
+    "@camstack/system": "1.2.526",
+    "@camstack/types": "1.2.453",
+    "@camstack/ui-library": "1.2.358",
     "@fastify/compress": "^9.0.0",
     "@fastify/cookie": "^11.0.2",
     "@fastify/cors": "^11.2.0",