@camstack/server 1.2.688 → 1.2.690

package/CHANGELOG.md

@@ -7,6 +7,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.690] - 2026-10-29
+
+### Changed
+
+- The agent reports its memory, reclaims stranded pages and gets a heap ceiling sized to the host; a node's launch parameters (heap ceiling, allocator) come from the server and can be overridden per node from the hub
+
+## [1.2.689] - 2026-10-29
+
+### Added
+
+- A node's free memory comes from the metrics provider instead of os.freemem(), which undercounts on macOS
+- device-export gains optional methods to list, expose and unexpose actions and notification targets beside devices.
+- Forget node now works on an online node too: its certificates are revoked, its connection is cut and calls pinned to it fail at once.
+- Generated routers for the pet-fountain capability
+- Agents report their own process memory in the topology (the core process showed 0), and an unreadable memory shows as unknown
+
+### Changed
+
+- The agent now reports its own [mem] agent-main heartbeat and reclaims stranded memory, as the hub does
+- The hub tells its addon runners which telemetry categories anyone consumes, so unused ones stop crossing the process boundary
+- Node launch parameters (heap ceiling, allocator env) are decided by a closure module, with a per-node override and a source line in the boot log
+- A node's heap-ceiling override can be read and set through server-management (applies at the next restart)
+
 ## [1.2.688] - 2026-10-29
 
 ### Changed

package/dist/agent/agent-heap-watch.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startAgentHeapWatch = startAgentHeapWatch;
+/**
+ * The agent root's own memory, on the record and returned to the OS.
+ *
+ * hub-main has had the `[mem]` heartbeat and the stranded-page reclaimer since
+ * 2026-08; the agent root process (container AND desktop — both reach
+ * `startAgent` through the same launcher) had neither, so a measured 0.8–1.4 GB
+ * agent root emitted no line at all and never gave a page back. This is the same
+ * mechanism, not a second one: `startHeapWatch` with the V8 reclaimer, labelled
+ * `agent-main`.
+ */
+const system_1 = require("@camstack/system");
+const DEFAULT_DEPS = {
+    start: system_1.startHeapWatch,
+    createReclaimer: system_1.createV8Reclaimer,
+};
+/**
+ * Start the heartbeat + reclaim for the agent root. Returns the stop function.
+ * `createV8Reclaimer()` returns undefined when V8 declines; the heartbeat then
+ * runs report-only, exactly as hub-main does.
+ */
+function startAgentHeapWatch(logger, deps = DEFAULT_DEPS) {
+    const reclaimer = deps.createReclaimer();
+    const sink = {
+        info: (line) => {
+            logger.info(line);
+        },
+        warn: (line) => {
+            logger.warn(line);
+        },
+    };
+    return deps.start(system_1.AGENT_MAIN_HEAP_WATCH_LABEL, sink, undefined, reclaimer === undefined ? undefined : { reclaim: reclaimer }, undefined, undefined, 
+    // Say who chose the ceiling: the default ceiling below is applied by the
+    // launcher's argv, and an absent flag means the image/desktop predates it.
+    true);
+}

package/dist/agent/agent-service.js

@@ -240,7 +240,8 @@ function createAgentService(deps) {
                     const { broker } = ctx;
                     const cpus = os.cpus();
                     let cpuPercent = 0;
-                    let memoryPercent = 0;
+                    let memoryPercent = null;
+                    let freeMemoryBytes = null;
                     const metrics = deps.getMetricsProvider?.();
                     if (metrics) {
                         // Bounded so $agent.status never hangs (and drops the node from
@@ -249,6 +250,7 @@ function createAgentService(deps) {
                         if (snapshot) {
                             cpuPercent = snapshot.cpu.total;
                             memoryPercent = snapshot.memory.percent;
+                            freeMemoryBytes = snapshot.memory.availableBytes;
                         }
                     }
                     const mem = process.memoryUsage();
@@ -262,9 +264,12 @@ function createAgentService(deps) {
                         cpuCores: cpus.length,
                         cpuModel: cpus[0]?.model,
                         totalMemoryMB: Math.round(os.totalmem() / 1024 / 1024),
-                        freeMemoryMB: Math.round(os.freemem() / 1024 / 1024),
+                        freeMemoryMB: freeMemoryBytes === null ? null : Math.round(freeMemoryBytes / 1024 / 1024),
                         cpuPercent,
                         memoryPercent,
+                        // The agent's own (core) process, so a topology row can attribute
+                        // the largest process on the node instead of showing 0.
+                        processRssBytes: process.memoryUsage().rss,
                         uptime: os.uptime(),
                         // The agent *process* itself (distinct from the host `uptime` /
                         // memory above) — surfaced so the UI can show how long THIS agent
@@ -298,7 +303,7 @@ function createAgentService(deps) {
                 handler: async (ctx) => {
                     const { broker } = ctx;
                     let cpuPercent = 0;
-                    let memoryPercent = 0;
+                    let memoryPercent = null;
                     const metrics = deps.getMetricsProvider?.();
                     if (metrics) {
                         try {

package/dist/agent/main.js

@@ -76,6 +76,7 @@ const register_agent_cap_dispatch_js_1 = require("./register-agent-cap-dispatch.
 // entries flow through it (console output + hub forwarding).
 // ---------------------------------------------------------------------------
 const system_2 = require("@camstack/system");
+const agent_heap_watch_js_1 = require("./agent-heap-watch.js");
 /** A reconnect (stop + rebuild + start) that takes longer than this is abandoned. */
 const RECONNECT_DEADLINE_MS = 90_000;
 /** How often the agent re-evaluates whether to ask its hub "am I still a member?" (D857). */
@@ -97,6 +98,11 @@ const DATA_NODEID_CAPS = new Set(types_2.ALL_CAPABILITY_DEFINITIONS.filter((c) =
 // Main
 // ---------------------------------------------------------------------------
 async function startAgent(configPath) {
+    // The agent root's own memory: `[mem] agent-main` heartbeat + the stranded-page
+    // reclaim hub-main has had since 2026-08. Started first so a slow boot is on the
+    // record; lines reach the hub through the same LogManager the addons use.
+    const heapWatchLogger = agentLogManager.createLogger().withTags({ addonId: 'heap-watch' });
+    (0, agent_heap_watch_js_1.startAgentHeapWatch)(heapWatchLogger);
     const config = (0, agent_config_js_1.loadAgentConfig)(configPath);
     // Derive CAMSTACK_HUB_URL from the configured hub address so remote agents
     // no longer need a second, redundant env var set by hand (the cross-node
@@ -480,7 +486,7 @@ async function startAgent(configPath) {
         dataDir: config.dataDir,
         runnerBootCheck: () => agentRunnerBootCheck?.current(),
     });
-    capabilityRegistry.registerProvider('server-management', agent_update_service_js_1.AGENT_RUNTIME_ADDON_ID, (0, server_management_provider_js_1.buildServerManagementProvider)(agentUpdateService));
+    capabilityRegistry.registerProvider('server-management', agent_update_service_js_1.AGENT_RUNTIME_ADDON_ID, (0, server_management_provider_js_1.buildServerManagementProvider)(agentUpdateService, config.dataDir));
     // The agent's certificates (D856): mesh leaf swap with automatic rollback, and the
     // hub-issued HTTPS leaf hot-swapped into the sniffing listener. The listener is
     // created later in boot, so it is read through a getter.

package/dist/api/core/cap-providers.js

@@ -349,7 +349,9 @@ async function computeTopologyInternal(agentRegistry, addonRegistry, getNodeRoot
                 name: `${node.info.id} (core)`,
                 state: 'running',
                 cpuPercent: node.status?.cpuPercent ?? 0,
-                memoryRss: 0,
+                // The agent's own process RSS from $agent.status; 0 only for an agent
+                // that predates the field.
+                memoryRss: node.status?.processRssBytes ?? 0,
                 uptimeSeconds: Math.floor((Date.now() - node.connectedSince) / 1000),
                 services: mainProcessServices,
             };
@@ -414,7 +416,7 @@ async function computeTopologyInternal(agentRegistry, addonRegistry, getNodeRoot
             isHub: node.isHub,
             isOnline: node.isOnline !== false,
             cpuPercent: node.status?.cpuPercent ?? 0,
-            memoryPercent: node.status?.memoryPercent ?? 0,
+            memoryPercent: node.status?.memoryPercent ?? null,
             uptime: Date.now() - node.connectedSince,
             // Fix (was hardcoded `new Date().toISOString()` — always "now", a bug
             // even for online nodes): report the persisted `lastActive` when we have
@@ -456,7 +458,7 @@ async function computeTopologyInternal(agentRegistry, addonRegistry, getNodeRoot
         isHub: persisted.isHub,
         isOnline: false,
         cpuPercent: 0,
-        memoryPercent: 0,
+        memoryPercent: null,
         uptime: 0,
         lastSeen: new Date(persisted.lastActive).toISOString(),
         localIps: [...persisted.localIps],

package/dist/api/core/cluster-nodes.router.js

@@ -69,9 +69,9 @@ function createClusterNodesRouter(agentRegistry) {
             await agentRegistry.repairNodeAddons(input.nodeId);
             return { success: true };
         }),
-        // Purge one node's persisted offline history. Pairs with
-        // `pipelineOrchestrator.removeAgentSettings` on the frontend to fully
-        // forget an offline node (history row + per-node pipeline assignments).
+        // Forget a node, online or offline: revoke its certificates, cut it from routing, purge its
+        // persisted history. Pairs with `pipelineOrchestrator.removeAgentSettings` on the frontend
+        // (per-node pipeline assignments).
         forgetNode: trpc_middleware_js_1.adminProcedure
             .input(ForgetNodeInputSchema)
             .output(ForgetNodeResultSchema)

package/dist/api/core/server-management.provider.js

@@ -1,7 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildLaunchOverrideMethods = buildLaunchOverrideMethods;
 exports.buildServerManagementProvider = buildServerManagementProvider;
-function buildServerManagementProvider(service) {
+const launch_args_js_1 = require("../../launch-args.js");
+/** The per-node launch override methods (ADR 0970), backed by the node's data dir. */
+function buildLaunchOverrideMethods(dataDir) {
+    return {
+        getLaunchOverrides: () => Promise.resolve({ heapMb: (0, launch_args_js_1.readHeapOverrideMb)(dataDir) }),
+        setLaunchOverrides: (input) => {
+            (0, launch_args_js_1.writeHeapOverrideMb)(dataDir, input.heapMb);
+            return Promise.resolve({ heapMb: input.heapMb, restartRequired: true });
+        },
+    };
+}
+function buildServerManagementProvider(service, dataDir) {
     if (service === null)
         return null;
     return {
@@ -10,5 +22,6 @@ function buildServerManagementProvider(service) {
         applyServerUpdate: (input) => service.applyServerUpdate(input),
         rollbackServerUpdate: () => service.rollbackServerUpdate(),
         restartServer: () => Promise.resolve(service.restartNode()),
+        ...buildLaunchOverrideMethods(dataDir),
     };
 }

package/dist/api/trpc/generated-cap-mounts.js

@@ -2,7 +2,7 @@
 // AUTO-GENERATED by scripts/generate-cap-mounts.ts — DO NOT EDIT
 // Re-run: npx tsx scripts/generate-cap-mounts.ts
 //
-// Mounted: 188    Skipped (legacy): 3
+// Mounted: 189    Skipped (legacy): 3
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LEGACY_SHAPE_SKIP = void 0;
 exports.mountAllCaps = mountAllCaps;
@@ -231,6 +231,8 @@ function mountAllCaps(services) {
                 ...first,
                 listSupportedDeviceKinds: (0, cap_mount_helpers_js_1.concatCollection)(providers, 'listSupportedDeviceKinds'),
                 listExposedDevices: (0, cap_mount_helpers_js_1.concatCollection)(providers, 'listExposedDevices'),
+                listSupportedEntityKinds: (0, cap_mount_helpers_js_1.concatCollection)(providers, 'listSupportedEntityKinds'),
+                listExposedEntities: (0, cap_mount_helpers_js_1.concatCollection)(providers, 'listExposedEntities'),
             };
         }, remoteCapProxy),
         deviceExtension: (0, generated_cap_routers_js_1.createCapRouter_deviceExtension)((_ctx) => (0, device_collection_dispatch_js_1.requireDeviceCollection)(reg, 'device-extension'), remoteCapProxy),
@@ -501,6 +503,7 @@ function mountAllCaps(services) {
         osd: (0, generated_cap_routers_js_1.createCapRouter_osd)((_ctx) => (0, cap_mount_helpers_js_1.requireDeviceScoped)(reg, 'osd'), remoteCapProxy),
         osdManager: (0, generated_cap_routers_js_1.createCapRouter_osdManager)((_ctx) => reg?.getSingleton('osd-manager') ?? null, remoteCapProxy),
         petFeeder: (0, generated_cap_routers_js_1.createCapRouter_petFeeder)((_ctx) => (0, cap_mount_helpers_js_1.requireDeviceScoped)(reg, 'pet-feeder'), remoteCapProxy),
+        petFountain: (0, generated_cap_routers_js_1.createCapRouter_petFountain)((_ctx) => (0, cap_mount_helpers_js_1.requireDeviceScoped)(reg, 'pet-fountain'), remoteCapProxy),
         pipelineAnalytics: (0, generated_cap_routers_js_1.createCapRouter_pipelineAnalytics)((_ctx) => (0, cap_mount_helpers_js_1.requireDeviceScoped)(reg, 'pipeline-analytics'), remoteCapProxy),
         pipelineExecutor: (0, generated_cap_routers_js_1.createCapRouter_pipelineExecutor)((_ctx) => reg?.getSingleton('pipeline-executor') ??
             null, remoteCapProxy),