@camstack/server 1.2.593 → 1.2.594

package/dist/core/agent/agent-registry.service.js

@@ -1,50 +1,12 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgentRegistryService = exports.AGENT_BACKFILL_RPC_TIMEOUT_MS = void 0;
-exports.toNodeLiveness = toNodeLiveness;
-exports.toDescriptor = toDescriptor;
-const node_crypto_1 = require("node:crypto");
-const os = __importStar(require("node:os"));
-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");
+import { randomUUID } from 'node:crypto';
+import * as os from 'node:os';
+import { callWithServiceDiscovery, getProcessAgentHttpsNames, localSupportedPythonRuntimes, } from '@camstack/system';
+import { EventCategory, resolveAddonPlacement } from '@camstack/types';
+import { BackfillAttemptTracker, computeBackfillPlan, confirmBackfillPlan, executeBackfill, MAX_BACKFILL_ATTEMPTS, triggerMayDeliver, } from './agent-addon-backfill';
+import { AgentDeliveryLedger } from './agent-delivery-ledger';
+import { agentOfflineData, nodeDisplayName } from './agent-liveness-event';
+import { ClusterNodeHistoryMirror } from './cluster-node-history-mirror';
+import { toNodeDirectory } from './node-directory';
 /** Turn a forget outcome into the sentence the operator reads. */
 function describeForgetOutcome(nodeId, history, registryRemoved, stillListed) {
     const parts = [];
@@ -72,7 +34,7 @@ const AGENT_RECONCILE_RPC_TIMEOUT_MS = 8_000;
  * and a timeout here aborts the call even though the deploy already landed.
  * Matches the `addons.updatePackage` agent path.
  */
-exports.AGENT_BACKFILL_RPC_TIMEOUT_MS = 300_000;
+export const AGENT_BACKFILL_RPC_TIMEOUT_MS = 300_000;
 /**
  * Package name of the system/infrastructure builtins. Addons shipped in
  * `@camstack/system` (filesystem-storage, storage-orchestrator,
@@ -127,7 +89,7 @@ function rosterFromAddons(addons) {
  * Child runner ids (`hub/foo`, `agent/bar`) are processes, not cluster
  * nodes — excluded, same rule as `listNodes()` / `classifyNode`.
  */
-function toNodeLiveness(nodes) {
+export function toNodeLiveness(nodes) {
     return (nodes
         // A Moleculer registry can transiently hold a malformed entry with no id
         // (seen live 2026-07-16 after agent churn): guard it or every consumer of
@@ -141,7 +103,7 @@ function toNodeLiveness(nodes) {
  * cpuModel `undefined`→`null`, addonIds from the reported `agentAddons`) so an
  * offline row rendered from history is indistinguishable from the live shape.
  */
-function toDescriptor(entry) {
+export function toDescriptor(entry) {
     return {
         id: entry.info.id,
         name: entry.info.name,
@@ -175,7 +137,7 @@ function toSubProcess(p) {
         groupId: p.groupId ?? null,
     };
 }
-class AgentRegistryService {
+export class AgentRegistryService {
     eventBus;
     moleculer;
     capabilityService;
@@ -221,14 +183,14 @@ class AgentRegistryService {
      * Bounded per-`(node, package)` delivery breaker — see
      * `agent-addon-backfill.ts`. Process-scoped, holds no intent.
      */
-    backfillTracker = new agent_addon_backfill_1.BackfillAttemptTracker();
+    backfillTracker = new BackfillAttemptTracker();
     /**
      * "Is the hub writing addons to this node right now?" — the gate that stops
      * the back-fill reacting to a roster gap the hub itself opened. Public so the
      * delivery path (`deliverAddonToAgent`) can mark its own window; see
      * `agent-delivery-ledger.ts` for why a delivery makes the roster lie.
      */
-    deliveryLedger = new agent_delivery_ledger_1.AgentDeliveryLedger();
+    deliveryLedger = new AgentDeliveryLedger();
     /**
      * Nodes with a reconcile in flight. The pass is triggered from two places
      * (the `registerNode` ack and the hub-boot sweep) and a reconnect can fire
@@ -248,7 +210,7 @@ class AgentRegistryService {
     /** Wire the durable offline-node history store (A1). */
     setClusterNodeHistoryStore(store) {
         this.historyStore = store;
-        this.historyMirror = new cluster_node_history_mirror_1.ClusterNodeHistoryMirror(() => store.tryGetAll());
+        this.historyMirror = new ClusterNodeHistoryMirror(() => store.tryGetAll());
     }
     /** Wire the scoped logger (boot order — see the field). */
     setLogger(logger) {
@@ -296,10 +258,10 @@ class AgentRegistryService {
         await this.historyStore?.prunePackages(nodeId, [packageName]);
         for (const addonId of addonIds) {
             this.eventBus.emit({
-                id: (0, node_crypto_1.randomUUID)(),
+                id: randomUUID(),
                 timestamp: new Date(),
                 source: { type: 'core', id: 'agent-registry' },
-                category: types_1.EventCategory.AddonUninstalled,
+                category: EventCategory.AddonUninstalled,
                 data: { addonId, agentId: nodeId, packageName, reason: 'operator uninstall' },
             });
         }
@@ -380,7 +342,7 @@ class AgentRegistryService {
         this.backfillTracker.forget(nodeId);
         this.deliveryLedger.forget(nodeId);
         // The names the hub certified to this node are free again (a forgotten node cannot hold them).
-        await (0, system_1.getProcessAgentHttpsNames)()
+        await getProcessAgentHttpsNames()
             ?.release(nodeId)
             .catch((err) => this.logger?.warn("forget cluster node: could not release the node's certified names", {
             tags: { nodeId },
@@ -399,10 +361,10 @@ class AgentRegistryService {
         // `AgentUnregistered` and re-emits immediately.
         if (historyRemoved || registryRemoved) {
             this.eventBus.emit({
-                id: (0, node_crypto_1.randomUUID)(),
+                id: randomUUID(),
                 timestamp: new Date(),
                 source: { type: 'core', id: 'agent-registry' },
-                category: types_1.EventCategory.AgentUnregistered,
+                category: EventCategory.AgentUnregistered,
                 data: { agentId: nodeId },
             });
         }
@@ -477,19 +439,19 @@ class AgentRegistryService {
                 console.log(`[agent-registry] Agent connected: ${node.id}`);
                 const nodeName = this.knownNodeName(node.id);
                 this.eventBus.emit({
-                    id: (0, node_crypto_1.randomUUID)(),
+                    id: randomUUID(),
                     timestamp: new Date(),
                     source: { type: 'core', id: 'agent-registry' },
-                    category: types_1.EventCategory.AgentOnline,
+                    category: EventCategory.AgentOnline,
                     data: { agentId: node.id, ...(nodeName !== undefined ? { nodeName } : {}) },
                 });
             }
             else {
                 this.eventBus.emit({
-                    id: (0, node_crypto_1.randomUUID)(),
+                    id: randomUUID(),
                     timestamp: new Date(),
                     source: { type: 'core', id: 'agent-registry' },
-                    category: types_1.EventCategory.WorkerOnline,
+                    category: EventCategory.WorkerOnline,
                     data: { workerId: node.id },
                 });
             }
@@ -505,19 +467,19 @@ class AgentRegistryService {
                 // node was never snapshotted while online.
                 void this.historyStore?.touch(node.id);
                 this.eventBus.emit({
-                    id: (0, node_crypto_1.randomUUID)(),
+                    id: randomUUID(),
                     timestamp: new Date(),
                     source: { type: 'core', id: 'agent-registry' },
-                    category: types_1.EventCategory.AgentOffline,
-                    data: (0, agent_liveness_event_1.agentOfflineData)(node.id, unexpected, this.knownNodeName(node.id)),
+                    category: EventCategory.AgentOffline,
+                    data: agentOfflineData(node.id, unexpected, this.knownNodeName(node.id)),
                 });
             }
             else {
                 this.eventBus.emit({
-                    id: (0, node_crypto_1.randomUUID)(),
+                    id: randomUUID(),
                     timestamp: new Date(),
                     source: { type: 'core', id: 'agent-registry' },
-                    category: types_1.EventCategory.WorkerOffline,
+                    category: EventCategory.WorkerOffline,
                     data: { workerId: node.id },
                 });
             }
@@ -526,7 +488,7 @@ class AgentRegistryService {
         // connected when the listener registers. Classifies each as
         // agent or worker — same logic as the live handlers above.
         try {
-            const registry = this.moleculer.broker.registry;
+            const registry = this.nodeCatalogRegistry();
             const existing = registry?.getNodeList?.({ onlyAvailable: true }) ?? [];
             for (const { id } of existing) {
                 const kind = classifyNode(id);
@@ -534,19 +496,19 @@ class AgentRegistryService {
                     continue;
                 if (kind === 'agent') {
                     this.eventBus.emit({
-                        id: (0, node_crypto_1.randomUUID)(),
+                        id: randomUUID(),
                         timestamp: new Date(),
                         source: { type: 'core', id: 'agent-registry' },
-                        category: types_1.EventCategory.AgentOnline,
+                        category: EventCategory.AgentOnline,
                         data: { agentId: id },
                     });
                 }
                 else {
                     this.eventBus.emit({
-                        id: (0, node_crypto_1.randomUUID)(),
+                        id: randomUUID(),
                         timestamp: new Date(),
                         source: { type: 'core', id: 'agent-registry' },
-                        category: types_1.EventCategory.WorkerOnline,
+                        category: EventCategory.WorkerOnline,
                         data: { workerId: id },
                     });
                 }
@@ -558,7 +520,7 @@ class AgentRegistryService {
     }
     /** 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);
+        return nodeDisplayName(nodeId, this.historyMirror?.peek() ?? null);
     }
     // ---- Placement reconciliation ----
     /**
@@ -571,7 +533,7 @@ class AgentRegistryService {
      * must not abort the pass or hub boot.
      */
     async reconcileConnectedAgents() {
-        const registry = this.moleculer.broker.registry;
+        const registry = this.nodeCatalogRegistry();
         const nodes = registry?.getNodeList?.({ onlyAvailable: true }) ?? [];
         const agentIds = nodes
             .map((n) => n.id)
@@ -655,7 +617,7 @@ class AgentRegistryService {
             // waitForServices primitive) and retries once, instead of giving up and
             // leaving the agent unreconciled until the next connect. (No timers/backoff
             // — that's banned for node readiness; this is the sanctioned primitive.)
-            const statusRaw = await (0, system_1.callWithServiceDiscovery)(broker, '$agent', '$agent.status', {}, {
+            const statusRaw = await callWithServiceDiscovery(broker, '$agent', '$agent.status', {}, {
                 nodeID: agentId,
                 timeout: AGENT_RECONCILE_RPC_TIMEOUT_MS,
             });
@@ -680,7 +642,7 @@ class AgentRegistryService {
                 if (typeof declId !== 'string')
                     continue;
                 const decl = row.declaration ?? row.manifest;
-                hubPlacements.set(declId, (0, types_1.resolveAddonPlacement)(decl));
+                hubPlacements.set(declId, resolveAddonPlacement(decl));
                 const packageName = row.manifest.packageName;
                 if (typeof packageName === 'string' && packageName.length > 0) {
                     hubPackages.add(packageName);
@@ -743,10 +705,10 @@ class AgentRegistryService {
                             undeployedPackages.add(packageName);
                     }
                     this.eventBus.emit({
-                        id: (0, node_crypto_1.randomUUID)(),
+                        id: randomUUID(),
                         timestamp: new Date(),
                         source: { type: 'core', id: 'agent-registry' },
-                        category: types_1.EventCategory.AddonUninstalled,
+                        category: EventCategory.AddonUninstalled,
                         data: { addonId: addon.id, agentId, reason },
                     });
                 }
@@ -788,7 +750,7 @@ class AgentRegistryService {
         if (!seam)
             return;
         const recorded = await store.getPackages(agentId);
-        const planned = (0, agent_addon_backfill_1.computeBackfillPlan)({
+        const planned = computeBackfillPlan({
             recorded,
             live,
             bootstrap: AGENT_BOOTSTRAP_PACKAGES,
@@ -808,7 +770,7 @@ class AgentRegistryService {
         }
         // GATE 1 — the trigger allowlist. A pass that must not install says so and
         // stops; silence here would read as "nothing was missing".
-        if (!(0, agent_addon_backfill_1.triggerMayDeliver)(trigger)) {
+        if (!triggerMayDeliver(trigger)) {
             console.log(`[agent-registry] Back-fill ${agentId}: SKIPPED — trigger "${trigger}" may not deliver ` +
                 `(${planned.targets.length} package(s) would have been installed)`);
             return;
@@ -838,7 +800,7 @@ class AgentRegistryService {
         const closeWindow = this.deliveryLedger.begin(agentId, plan.targets.map((t) => t.name).join(', ') || 'back-fill');
         let outcome;
         try {
-            outcome = await (0, agent_addon_backfill_1.executeBackfill)(seam, agentId, plan, this.backfillTracker);
+            outcome = await executeBackfill(seam, agentId, plan, this.backfillTracker);
         }
         finally {
             closeWindow();
@@ -849,10 +811,10 @@ class AgentRegistryService {
                 .join(', ')} — trigger=${trigger}, node reported ${plan.liveCount} package(s) and its ` +
                 `declared roster has ${recorded.length}`);
             this.eventBus.emit({
-                id: (0, node_crypto_1.randomUUID)(),
+                id: randomUUID(),
                 timestamp: new Date(),
                 source: { type: 'core', id: 'agent-registry' },
-                category: types_1.EventCategory.AddonInstalled,
+                category: EventCategory.AddonInstalled,
                 data: {
                     agentId,
                     packages: outcome.delivered.map((d) => `${d.name}@${d.version}`),
@@ -864,7 +826,7 @@ class AgentRegistryService {
         for (const failure of outcome.failed) {
             console.error(`[agent-registry] Back-fill ${agentId}: FAILED to deliver ${failure.name}@${failure.version} — ${failure.error}` +
                 (failure.retired
-                    ? ` (retired after ${agent_addon_backfill_1.MAX_BACKFILL_ATTEMPTS} attempts; this node is running WITHOUT that package)`
+                    ? ` (retired after ${MAX_BACKFILL_ATTEMPTS} attempts; this node is running WITHOUT that package)`
                     : ''));
         }
         for (const name of outcome.skipped) {
@@ -899,7 +861,7 @@ class AgentRegistryService {
             console.warn(`[agent-registry] Back-fill ${agentId}: SKIPPED — the confirmation read carried no addon list`);
             return null;
         }
-        const { plan: confirmed, contradicted } = (0, agent_addon_backfill_1.confirmBackfillPlan)(plan, rosterFromAddons(secondAddons));
+        const { plan: confirmed, contradicted } = confirmBackfillPlan(plan, rosterFromAddons(secondAddons));
         if (contradicted.length > 0) {
             console.warn(`[agent-registry] Back-fill ${agentId}: two roster reads DISAGREE — ` +
                 `${contradicted.map((t) => t.name).join(', ')} reported absent then present. ` +
@@ -965,10 +927,10 @@ class AgentRegistryService {
      */
     async listNodeDirectory() {
         const history = this.historyMirror ? await this.historyMirror.current() : null;
-        return (0, node_directory_1.toNodeDirectory)(this.listNodeLiveness(), history);
+        return toNodeDirectory(this.listNodeLiveness(), history);
     }
     async listNodes() {
-        const registry = this.moleculer.broker.registry;
+        const registry = this.nodeCatalogRegistry();
         // `onlyAvailable: false` intentionally includes nodes Moleculer still
         // remembers as disconnected (`available: false`) — the same registry
         // read `listNodeLiveness()` uses for `/health`. This surfaces recently
@@ -1164,7 +1126,7 @@ class AgentRegistryService {
                 cpuCores: cpus.length,
                 memoryMB: Math.round(os.totalmem() / 1024 / 1024),
                 cpuModel: cpus[0]?.model,
-                pythonRuntimes: (0, system_1.localSupportedPythonRuntimes)(),
+                pythonRuntimes: localSupportedPythonRuntimes(),
             },
             status: {
                 activeCameras: 0,
@@ -1205,12 +1167,11 @@ class AgentRegistryService {
         const promoted = { ...backup, priority: 'primary' };
         this.assignments.set(primaryKey, promoted);
         this.eventBus.emit({
-            id: (0, node_crypto_1.randomUUID)(),
+            id: randomUUID(),
             timestamp: new Date(),
             source: { type: 'core', id: 'agent-registry' },
-            category: types_1.EventCategory.AgentBackupActivated,
+            category: EventCategory.AgentBackupActivated,
             data: { cameraId, role, agentId: promoted.agentId },
         });
     }
 }
-exports.AgentRegistryService = AgentRegistryService;

package/dist/core/agent/cluster-node-history-mirror.js

@@ -1,9 +1,6 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ClusterNodeHistoryMirror = exports.HISTORY_MIRROR_MAX_AGE_MS = void 0;
 /** Two topology heartbeats: a mirror older than this was not being fed. */
-exports.HISTORY_MIRROR_MAX_AGE_MS = 60_000;
-class ClusterNodeHistoryMirror {
+export const HISTORY_MIRROR_MAX_AGE_MS = 60_000;
+export class ClusterNodeHistoryMirror {
     read;
     now;
     maxAgeMs;
@@ -11,7 +8,7 @@ class ClusterNodeHistoryMirror {
     inFlight = null;
     /** Bumped by `invalidate()`: a read started before it must not land. */
     generation = 0;
-    constructor(read, now = Date.now, maxAgeMs = exports.HISTORY_MIRROR_MAX_AGE_MS) {
+    constructor(read, now = Date.now, maxAgeMs = HISTORY_MIRROR_MAX_AGE_MS) {
         this.read = read;
         this.now = now;
         this.maxAgeMs = maxAgeMs;
@@ -57,4 +54,3 @@ class ClusterNodeHistoryMirror {
         this.inFlight = null;
     }
 }
-exports.ClusterNodeHistoryMirror = ClusterNodeHistoryMirror;