@camstack/server 1.2.382 → 1.2.384

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

@@ -465,6 +465,7 @@ function buildNodesProvider(agentRegistry, moleculer, addonRegistry, getNodeRoot
     const broker = moleculer.broker;
     return {
         topology: async () => computeTopology(agentRegistry, addonRegistry, getNodeRootPackage),
+        directory: async () => agentRegistry.listNodeDirectory(),
         deployAddon: async () => {
             // Placeholder — actual deployment orchestration TBD
             return { success: true };

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

@@ -4573,6 +4573,33 @@ function createCapRouter_llmRuntime(getProvider, createRemoteProxy) {
             // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
             return p.getDiskUsage(methodInput);
         }),
+        cancel: trpc_middleware_js_1.adminProcedure
+            .input(types_58.llmRuntimeCapability.methods.cancel.input.loose())
+            .output(types_58.llmRuntimeCapability.methods.cancel.output)
+            .mutation(async ({ input, ctx }) => {
+            const { nodeId, ...methodInput } = input;
+            const p = resolveProvider('llm-runtime', nodeId, () => getProvider(ctx), createRemoteProxy);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
+            return p.cancel(methodInput);
+        }),
+        appleAvailability: trpc_middleware_js_1.adminProcedure
+            .input(types_58.llmRuntimeCapability.methods.appleAvailability.input.loose())
+            .output(types_58.llmRuntimeCapability.methods.appleAvailability.output)
+            .query(async ({ input, ctx }) => {
+            const { nodeId, ...methodInput } = input;
+            const p = resolveProvider('llm-runtime', nodeId, () => getProvider(ctx), createRemoteProxy);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
+            return p.appleAvailability(methodInput);
+        }),
+        completeApple: trpc_middleware_js_1.adminProcedure
+            .input(types_58.llmRuntimeCapability.methods.completeApple.input.loose())
+            .output(types_58.llmRuntimeCapability.methods.completeApple.output)
+            .mutation(async ({ input, ctx }) => {
+            const { nodeId, ...methodInput } = input;
+            const p = resolveProvider('llm-runtime', nodeId, () => getProvider(ctx), createRemoteProxy);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
+            return p.completeApple(methodInput);
+        }),
     });
 }
 function createCapRouter_loadContribution(getProvider, createRemoteProxy) {
@@ -5532,6 +5559,14 @@ function createCapRouter_nodes(getProvider, _createRemoteProxy) {
             const p = requireCapProvider('nodes', () => getProvider(ctx));
             return p.topology();
         }),
+        directory: trpc_middleware_js_1.adminProcedure
+            .input(zod_1.z.object({ nodeId: zod_1.z.string().optional() }).optional())
+            .output(types_79.nodesCapability.methods.directory.output)
+            .query(async ({ input, ctx }) => {
+            void input;
+            const p = requireCapProvider('nodes', () => getProvider(ctx));
+            return p.directory();
+        }),
         deployAddon: trpc_middleware_js_1.adminProcedure
             .input(types_79.nodesCapability.methods.deployAddon.input.loose())
             .output(types_79.nodesCapability.methods.deployAddon.output)

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

@@ -42,6 +42,8 @@ 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 cluster_node_history_mirror_1 = require("./cluster-node-history-mirror");
+const node_directory_1 = require("./node-directory");
 /** Turn a forget outcome into the sentence the operator reads. */
 function describeForgetOutcome(nodeId, history, registryRemoved, stillListed) {
     const parts = [];
@@ -194,6 +196,11 @@ class AgentRegistryService {
      * fakes) stay untouched; a null store means "history disabled" (best-effort).
      */
     historyStore = null;
+    /**
+     * The history as last read successfully — fed by every topology pass
+     * (`getClusterNodeHistory`), served to `nodes.directory` (D637).
+     */
+    historyMirror = null;
     /**
      * Scoped logger, wired post-construction from `manual-boot` for the same
      * reason as the seams above (the logging service is built earlier but the
@@ -240,6 +247,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());
     }
     /** Wire the scoped logger (boot order — see the field). */
     setLogger(logger) {
@@ -291,7 +299,9 @@ class AgentRegistryService {
      * Returns `[]` when no history store is wired (unit fakes).
      */
     async getClusterNodeHistory() {
-        return this.historyStore ? this.historyStore.getAll() : [];
+        // A fresh read each pass (topology semantics unchanged), and it feeds the
+        // mirror `listNodeDirectory` serves.
+        return this.historyMirror ? ((await this.historyMirror.refresh()) ?? []) : [];
     }
     /**
      * Permanently forget a node (inline "Forget node") — and report what that
@@ -335,6 +345,8 @@ class AgentRegistryService {
         const historyOutcome = this.historyStore
             ? await this.historyStore.forget(nodeId)
             : 'store-unavailable';
+        // The mirror still lists the forgotten node: the next directory re-reads.
+        this.historyMirror?.invalidate();
         const registryRemoved = this.removeFromNodeCatalog(nodeId);
         // Its intended set is gone with the row, so the back-fill breaker's memory
         // of failed deliveries to it is meaningless — drop it too.
@@ -890,6 +902,17 @@ class AgentRegistryService {
     listNodeLiveness() {
         return toNodeLiveness(this.moleculer.broker.registry.getNodeList({ onlyAvailable: false }));
     }
+    /**
+     * The cheap node list for pickers (D637): the in-memory liveness above plus
+     * the durable history — no per-node RPC, unlike `computeTopology` (32–51 s).
+     * The history comes from the mirror the topology pass keeps fresh, so a
+     * picker open normally costs no settings round trip either. No history
+     * store wired, or no read that ever answered, is `complete: false`.
+     */
+    async listNodeDirectory() {
+        const history = this.historyMirror ? await this.historyMirror.current() : null;
+        return (0, node_directory_1.toNodeDirectory)(this.listNodeLiveness(), history);
+    }
     async listNodes() {
         const registry = this.moleculer.broker.registry;
         // `onlyAvailable: false` intentionally includes nodes Moleculer still

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

@@ -0,0 +1,52 @@
+"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 {
+    read;
+    now;
+    maxAgeMs;
+    entry = null;
+    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) {
+        this.read = read;
+        this.now = now;
+        this.maxAgeMs = maxAgeMs;
+    }
+    /** Read the store now (sharing any read in flight). Returns THIS read's answer. */
+    refresh() {
+        if (this.inFlight !== null)
+            return this.inFlight;
+        const generation = this.generation;
+        const flight = this.read().then((rows) => {
+            if (rows !== null && generation === this.generation) {
+                this.entry = { rows, readAt: this.now() };
+            }
+            return rows;
+        });
+        const settled = flight.finally(() => {
+            if (this.inFlight === settled)
+                this.inFlight = null;
+        });
+        this.inFlight = settled;
+        return settled;
+    }
+    /** The mirror if fresh; otherwise a read, falling back to the last successful one. */
+    async current() {
+        const entry = this.entry;
+        if (entry !== null && this.now() - entry.readAt <= this.maxAgeMs)
+            return entry.rows;
+        const rows = await this.refresh();
+        return rows ?? this.entry?.rows ?? null;
+    }
+    /** Drop the mirror (a node was forgotten): the next `current()` must re-read. */
+    invalidate() {
+        this.generation += 1;
+        this.entry = null;
+        this.inFlight = null;
+    }
+}
+exports.ClusterNodeHistoryMirror = ClusterNodeHistoryMirror;

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

@@ -321,9 +321,19 @@ class ClusterNodeHistoryStore {
     }
     /** Read the full persisted history, validated. Malformed rows are dropped. */
     async getAll() {
+        return (await this.tryGetAll()) ?? [];
+    }
+    /**
+     * Read the full persisted history, validated, or `null` when the store did
+     * not ANSWER (unavailable, or the query threw). A caller that must not claim
+     * a node absent from an unanswered read (D315) uses this; `getAll` folds the
+     * `null` into `[]` for the callers that only render what exists. Malformed
+     * rows are dropped (and logged) — the rest of the answer still stands.
+     */
+    async tryGetAll() {
         const store = await this.ensureDeclared();
         if (!store)
-            return [];
+            return null;
         try {
             const rows = await store.query({ collection: COLLECTION });
             const result = [];
@@ -340,8 +350,8 @@ class ClusterNodeHistoryStore {
             return result;
         }
         catch (err) {
-            this.logger.warn('getAll failed (best-effort)', { meta: { error: (0, types_1.errMsg)(err) } });
-            return [];
+            this.logger.warn('history read failed (best-effort)', { meta: { error: (0, types_1.errMsg)(err) } });
+            return null;
         }
     }
     /**

package/dist/core/agent/node-directory.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toNodeDirectory = toNodeDirectory;
+/**
+ * The cheap node list (D637): live liveness plus the durable history, merged.
+ *
+ * - A node Moleculer still lists keeps Moleculer's liveness verdict, named
+ *   from the history when the history knows it.
+ * - A node known ONLY from the history (Moleculer already purged it) is
+ *   listed OFFLINE — never dropped.
+ * - `history === null` = unreadable, so the answer is INCOMPLETE and a picker
+ *   must not call a missing id removed (D315).
+ */
+function toNodeDirectory(live, history) {
+    const rows = history ?? [];
+    const names = new Map(rows.map((row) => [row.id, row.name]));
+    const hubs = new Set(rows.filter((row) => row.isHub).map((row) => row.id));
+    const entries = new Map();
+    for (const node of live) {
+        entries.set(node.id, {
+            id: node.id,
+            name: displayName(node.id, names.get(node.id)),
+            isHub: node.isHub || hubs.has(node.id),
+            isOnline: node.isOnline,
+        });
+    }
+    for (const row of rows) {
+        if (entries.has(row.id))
+            continue;
+        entries.set(row.id, {
+            id: row.id,
+            name: displayName(row.id, row.name),
+            isHub: row.isHub,
+            isOnline: false,
+        });
+    }
+    const nodes = [...entries.values()].sort(compareDirectoryEntries);
+    return { nodes, complete: history !== null };
+}
+function displayName(id, name) {
+    return name !== undefined && name.length > 0 ? name : id;
+}
+/** Hub first, then online before offline, then by name. */
+function compareDirectoryEntries(a, b) {
+    return (Number(b.isHub) - Number(a.isHub) ||
+        Number(b.isOnline) - Number(a.isOnline) ||
+        a.name.localeCompare(b.name));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/server",
-  "version": "1.2.382",
+  "version": "1.2.384",
   "private": false,
   "files": [
     "dist",
@@ -35,18 +35,18 @@
     ]
   },
   "dependencies": {
-    "@camstack/addon-admin-ui": "1.2.264",
-    "@camstack/addon-agent-ui": "1.2.145",
+    "@camstack/addon-admin-ui": "1.2.266",
+    "@camstack/addon-agent-ui": "1.2.146",
     "@camstack/addon-auth": "1.2.123",
     "@camstack/addon-decoder-nodeav": "1.2.115",
     "@camstack/addon-notifiers": "1.2.120",
     "@camstack/addon-pipeline": "1.2.292",
-    "@camstack/addon-pipeline-orchestrator": "1.2.249",
-    "@camstack/addon-post-analysis": "1.2.279",
+    "@camstack/addon-pipeline-orchestrator": "1.2.251",
+    "@camstack/addon-post-analysis": "1.2.281",
     "@camstack/sdk": "1.2.118",
-    "@camstack/system": "1.2.297",
-    "@camstack/types": "1.2.253",
-    "@camstack/ui-library": "1.2.203",
+    "@camstack/system": "1.2.299",
+    "@camstack/types": "1.2.255",
+    "@camstack/ui-library": "1.2.204",
     "@fastify/compress": "^9.0.0",
     "@fastify/cookie": "^11.0.2",
     "@fastify/cors": "^11.2.0",