@camstack/server 1.2.675 → 1.2.676

package/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.676] - 2026-10-28
+
+### Fixed
+
+- An agent advertises itself on the network again, so the hub lists a new agent for pairing without typing its address
+- An unpaired agent no longer crash-loops: it stays up to be paired and starts its addons once pairing completes
+
 ## [1.2.675] - 2026-10-28
 
 ### Changed

package/dist/agent/agent-boot-mode.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decideAgentBootMode = decideAgentBootMode;
+function decideAgentBootMode(input) {
+    return input.paired ? 'full' : 'pairing-only';
+}

package/dist/agent/main.js

@@ -56,6 +56,7 @@ const agent_http_js_1 = require("./agent-http.js");
 const agent_node_certificates_js_1 = require("./agent-node-certificates.js");
 const agent_reconnect_js_1 = require("./agent-reconnect.js");
 const serial_queue_js_1 = require("./serial-queue.js");
+const agent_boot_mode_js_1 = require("./agent-boot-mode.js");
 const agent_infra_capabilities_js_1 = require("./agent-infra-capabilities.js");
 const agent_service_js_1 = require("./agent-service.js");
 const agent_hub_addon_update_js_1 = require("./agent-hub-addon-update.js");
@@ -900,6 +901,7 @@ async function startAgent(configPath) {
             leafFingerprint: (0, agent_pairing_store_js_1.pairedLeafFingerprint)(config.configPath),
         });
     };
+    const addonsBooted = (0, agent_boot_mode_js_1.decideAgentBootMode)({ paired: (0, agent_pairing_store_js_1.isAgentPaired)(config.configPath) }) === 'full';
     const localPairing = (0, agent_pairing_local_js_1.createLocalPairingAnnouncer)(config.dataDir, consoleLogger);
     const pairing = new system_1.AgentPairing({
         nodeId: config.nodeId,
@@ -912,7 +914,16 @@ async function startAgent(configPath) {
                 meta: { hubUrl: installed.hubUrl, hubAddress: installed.hubAddress },
             });
             // The completion is answered first; the wire is replaced right after.
-            const timer = setTimeout(() => void reconnect().then(advertise, advertise), 400);
+            const timer = setTimeout(() => {
+                if (addonsBooted) {
+                    void reconnect().then(advertise, advertise);
+                }
+                else {
+                    // Booted unpaired: no addon was started (agent-boot-mode.ts). Relaunch (D5) so
+                    // the core addons boot with the hub reachable.
+                    (0, agent_update_service_js_1.scheduleAgentRestart)(consoleLogger, 'paired with the hub', config.dataDir);
+                }
+            }, 400);
             timer.unref?.();
         },
         log: (message, meta) => consoleLogger.info(`pairing: ${message}`, meta ? { meta } : undefined),
@@ -951,6 +962,40 @@ 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);
+    // 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) {
+        console.log(`[Agent] Node "${config.nodeId}" is unpaired - serving pairing only; addons boot after pairing`);
+        return;
+    }
     // ── Phase 1: Load core infrastructure addons (in-process) ──
     // storage + settings + metrics + hub-forwarder (log destination)
     await bootCoreAddons(broker, config, capabilityRegistry, loadedAddons, loggerFactory);
@@ -1003,34 +1048,6 @@ async function startAgent(configPath) {
         }
     });
     console.log(`[Agent] Node "${config.nodeId}" (name="${config.name}") ready — ${loadedAddons.size} addon(s) loaded`);
-    // 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);
 }
 // ---------------------------------------------------------------------------
 // Phase 1: Boot core addons (storage, settings, metrics — NO winston)
@@ -1217,7 +1234,10 @@ async function loadClusterCapableAddons(broker, config, capabilityRegistry, load
             try {
                 await broker.call('$process.spawnRunner', {
                     runnerId: groupId,
-                    addons: addons.map((a) => ({ addonId: a.addonId, addonDir: a.addonDir })),
+                    addons: addons.map((a) => ({
+                        addonId: a.addonId,
+                        addonDir: a.addonDir,
+                    })),
                 });
                 // Shared with the reload path (`ensureGroupRunner`) so the boot and
                 // reload registrations can never drift — the drift was the in-process

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/server",
-  "version": "1.2.675",
+  "version": "1.2.676",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -60,7 +60,7 @@
     "@camstack/addon-post-analysis": "1.2.649",
     "@camstack/develop": "0.1.38",
     "@camstack/sdk": "1.2.154",
-    "@camstack/system": "1.2.506",
+    "@camstack/system": "1.2.507",
     "@camstack/types": "1.2.436",
     "@camstack/ui-library": "1.2.345",
     "@fastify/compress": "^9.0.0",