@camstack/server 1.1.65 → 1.1.67

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

@@ -2243,6 +2243,33 @@ function createCapRouter_deviceExport(getProvider, createRemoteProxy) {
 }
 function createCapRouter_deviceManager(getProvider, createRemoteProxy) {
     return (0, trpc_middleware_js_1.trpcRouter)({
+        getDeviceSettingsContribution: trpc_middleware_js_1.protectedProcedure
+            .input(types_1.DEVICE_SETTINGS_CONTRIBUTION_METHODS.getDeviceSettingsContribution.input.loose())
+            .output(types_1.DEVICE_SETTINGS_CONTRIBUTION_METHODS.getDeviceSettingsContribution.output)
+            .query(async ({ input, ctx }) => {
+            const { nodeId, ...methodInput } = input;
+            const p = resolveProvider('device-manager', nodeId, () => getProvider(ctx), createRemoteProxy);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
+            return p.getDeviceSettingsContribution(methodInput);
+        }),
+        getDeviceLiveContribution: trpc_middleware_js_1.protectedProcedure
+            .input(types_1.DEVICE_SETTINGS_CONTRIBUTION_METHODS.getDeviceLiveContribution.input.loose())
+            .output(types_1.DEVICE_SETTINGS_CONTRIBUTION_METHODS.getDeviceLiveContribution.output)
+            .query(async ({ input, ctx }) => {
+            const { nodeId, ...methodInput } = input;
+            const p = resolveProvider('device-manager', nodeId, () => getProvider(ctx), createRemoteProxy);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
+            return p.getDeviceLiveContribution(methodInput);
+        }),
+        applyDeviceSettingsPatch: trpc_middleware_js_1.adminProcedure
+            .input(types_1.DEVICE_SETTINGS_CONTRIBUTION_METHODS.applyDeviceSettingsPatch.input.loose())
+            .output(types_1.DEVICE_SETTINGS_CONTRIBUTION_METHODS.applyDeviceSettingsPatch.output)
+            .mutation(async ({ input, ctx }) => {
+            const { nodeId, ...methodInput } = input;
+            const p = resolveProvider('device-manager', nodeId, () => getProvider(ctx), createRemoteProxy);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
+            return p.applyDeviceSettingsPatch(methodInput);
+        }),
         allocateDeviceId: trpc_middleware_js_1.protectedProcedure
             .input(types_39.deviceManagerCapability.methods.allocateDeviceId.input.loose())
             .output(types_39.deviceManagerCapability.methods.allocateDeviceId.output)
@@ -2511,6 +2538,15 @@ function createCapRouter_deviceManager(getProvider, createRemoteProxy) {
             // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
             return p.getChildren(methodInput);
         }),
+        getLinkedDevices: trpc_middleware_js_1.protectedProcedure
+            .input(types_39.deviceManagerCapability.methods.getLinkedDevices.input.loose())
+            .output(types_39.deviceManagerCapability.methods.getLinkedDevices.output)
+            .query(async ({ input, ctx }) => {
+            const { nodeId, ...methodInput } = input;
+            const p = resolveProvider('device-manager', nodeId, () => getProvider(ctx), createRemoteProxy);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
+            return p.getLinkedDevices(methodInput);
+        }),
         getStreamSources: trpc_middleware_js_1.protectedProcedure
             .input(types_39.deviceManagerCapability.methods.getStreamSources.input.loose())
             .output(types_39.deviceManagerCapability.methods.getStreamSources.output)
@@ -3117,6 +3153,33 @@ function createCapRouter_doorbell(getProvider, createRemoteProxy) {
             // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
             return p.getStatus(methodInput);
         }),
+        getDeviceSettingsContribution: trpc_middleware_js_1.protectedProcedure
+            .input(types_1.DEVICE_SETTINGS_CONTRIBUTION_METHODS.getDeviceSettingsContribution.input.loose())
+            .output(types_1.DEVICE_SETTINGS_CONTRIBUTION_METHODS.getDeviceSettingsContribution.output)
+            .query(async ({ input, ctx }) => {
+            const { nodeId, ...methodInput } = input;
+            const p = resolveProvider('doorbell', nodeId, () => getProvider(ctx), createRemoteProxy);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
+            return p.getDeviceSettingsContribution(methodInput);
+        }),
+        getDeviceLiveContribution: trpc_middleware_js_1.protectedProcedure
+            .input(types_1.DEVICE_SETTINGS_CONTRIBUTION_METHODS.getDeviceLiveContribution.input.loose())
+            .output(types_1.DEVICE_SETTINGS_CONTRIBUTION_METHODS.getDeviceLiveContribution.output)
+            .query(async ({ input, ctx }) => {
+            const { nodeId, ...methodInput } = input;
+            const p = resolveProvider('doorbell', nodeId, () => getProvider(ctx), createRemoteProxy);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
+            return p.getDeviceLiveContribution(methodInput);
+        }),
+        applyDeviceSettingsPatch: trpc_middleware_js_1.adminProcedure
+            .input(types_1.DEVICE_SETTINGS_CONTRIBUTION_METHODS.applyDeviceSettingsPatch.input.loose())
+            .output(types_1.DEVICE_SETTINGS_CONTRIBUTION_METHODS.applyDeviceSettingsPatch.output)
+            .mutation(async ({ input, ctx }) => {
+            const { nodeId, ...methodInput } = input;
+            const p = resolveProvider('doorbell', nodeId, () => getProvider(ctx), createRemoteProxy);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
+            return p.applyDeviceSettingsPatch(methodInput);
+        }),
     });
 }
 function createCapRouter_embeddingEncoder(getProvider, createRemoteProxy) {
@@ -5121,6 +5184,15 @@ function createCapRouter_pipelineAnalytics(getProvider, createRemoteProxy) {
             // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
             return p.listTracks(methodInput);
         }),
+        listRecentTracks: trpc_middleware_js_1.protectedProcedure
+            .input(types_78.pipelineAnalyticsCapability.methods.listRecentTracks.input.loose())
+            .output(types_78.pipelineAnalyticsCapability.methods.listRecentTracks.output)
+            .query(async ({ input, ctx }) => {
+            const { nodeId, ...methodInput } = input;
+            const p = resolveProvider('pipeline-analytics', nodeId, () => getProvider(ctx), createRemoteProxy);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
+            return p.listRecentTracks(methodInput);
+        }),
         clearTracks: trpc_middleware_js_1.adminProcedure
             .input(types_78.pipelineAnalyticsCapability.methods.clearTracks.input.loose())
             .output(types_78.pipelineAnalyticsCapability.methods.clearTracks.output)
@@ -5157,6 +5229,24 @@ function createCapRouter_pipelineAnalytics(getProvider, createRemoteProxy) {
             // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
             return p.getAudioEvents(methodInput);
         }),
+        listEventKinds: trpc_middleware_js_1.protectedProcedure
+            .input(types_78.pipelineAnalyticsCapability.methods.listEventKinds.input.loose())
+            .output(types_78.pipelineAnalyticsCapability.methods.listEventKinds.output)
+            .query(async ({ input, ctx }) => {
+            const { nodeId, ...methodInput } = input;
+            const p = resolveProvider('pipeline-analytics', nodeId, () => getProvider(ctx), createRemoteProxy);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
+            return p.listEventKinds(methodInput);
+        }),
+        getSensorEvents: trpc_middleware_js_1.protectedProcedure
+            .input(types_78.pipelineAnalyticsCapability.methods.getSensorEvents.input.loose())
+            .output(types_78.pipelineAnalyticsCapability.methods.getSensorEvents.output)
+            .query(async ({ input, ctx }) => {
+            const { nodeId, ...methodInput } = input;
+            const p = resolveProvider('pipeline-analytics', nodeId, () => getProvider(ctx), createRemoteProxy);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
+            return p.getSensorEvents(methodInput);
+        }),
         getKeyEvents: trpc_middleware_js_1.protectedProcedure
             .input(types_78.pipelineAnalyticsCapability.methods.getKeyEvents.input.loose())
             .output(types_78.pipelineAnalyticsCapability.methods.getKeyEvents.output)

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

@@ -39,6 +39,8 @@ exports.shouldEmitProviderRegisteredReady = shouldEmitProviderRegisteredReady;
 const os = __importStar(require("node:os"));
 const addon_row_manifest_1 = require("./addon-row-manifest");
 const runner_convergence_1 = require("./runner-convergence");
+const system_addons_sync_1 = require("./system-addons-sync");
+const package_dir_utils_1 = require("./package-dir-utils");
 const types_1 = require("@camstack/types");
 const system_1 = require("@camstack/system");
 const system_2 = require("@camstack/system");
@@ -433,6 +435,24 @@ class AddonRegistryService {
         // launcher). Defaults to `<dataDir>/addons` for dev.
         const dataDir = path.resolve(process.env.CAMSTACK_DATA ?? 'camstack-data');
         const addonsDir = process.env.CAMSTACK_ADDONS_DIR ?? path.resolve(dataDir, 'addons');
+        // Builtins load from the ADDONS-DIR copy of `@camstack/system`, which no
+        // update channel refreshes on an image hub (seed excludes it, apply-update
+        // swaps only server-root, deploy of system is rejected) — a stale copy
+        // silently pins builtin code forever (2026-07-17: snapshot builtin ran
+        // 1.1.49 while the closure carried 1.1.51). Reconcile it from the hub's
+        // own closure when the closure is NEWER; a newer addons copy (dev
+        // live-update flow) is left alone. Never throws.
+        const closureSystemDir = (0, package_dir_utils_1.resolveHubClosurePackageDir)('@camstack/system');
+        if (closureSystemDir) {
+            const outcome = (0, system_addons_sync_1.syncSystemAddonsCopy)({
+                addonsDir,
+                closureSystemDir,
+                log: (msg, meta) => this.logger.info(msg, { meta: meta ?? {} }),
+            });
+            if (outcome === 'failed') {
+                this.logger.warn('system addons-copy sync failed — builtins may run stale code');
+            }
+        }
         await this.addonLoader.loadFromDirectory(addonsDir);
         // Hand pre-init load failures (broken package.json, missing
         // dist, import-time errors) to the health monitor so its retry
@@ -1399,6 +1419,16 @@ class AddonRegistryService {
             // roster from the freshly-swapped on-disk bundle. Updating ONE member of a
             // group therefore respawns the ENTIRE group — they share a process.
             if (this.isForkedAddonEntry(entry)) {
+                // Snapshot which declared caps are ACTUALLY registered right now —
+                // the post-restart wait below must only gate on these. Device-scoped
+                // caps (vacuum-control, valve, humidifier, …) register only when a
+                // device using them exists: waiting for a cap that was NOT registered
+                // before the restart burns the full 120s timeout for nothing (live:
+                // integrations.create held its mutation — and the creation modal —
+                // for 2 minutes on the HA addon's 8 deviceless caps).
+                const preRegistered = new Set(entry.declaredCapabilities
+                    .map((cap) => cap.name)
+                    .filter((name) => this.capabilityRegistry.getProviderByAddon(name, addonId) != null));
                 await this.ensureForkedRunner(addonId, { restart: true });
                 // The respawn resolves as soon as the child is up, not when its
                 // capabilities are re-registered. Callers (integrations.create, UI forms) may
@@ -1430,9 +1460,21 @@ class AddonRegistryService {
                     // *misleading error* on timeout — a warning avoids that while still
                     // letting the update finalize).
                     const REGISTER_WAIT_MS = 120_000;
-                    const waits = declared.map((cap) => this.capabilityRegistry.waitForProvider(cap.name, addonId, REGISTER_WAIT_MS));
+                    // Gate ONLY on the caps that were registered BEFORE the restart —
+                    // those are the ones a caller could have been routing to. Caps that
+                    // were absent (device-scoped, no device yet) re-register
+                    // asynchronously whenever their devices appear; waiting for them
+                    // here held integrations.create (and its modal) for the full
+                    // timeout on every deviceless declared cap.
+                    const gated = declared.filter((cap) => preRegistered.has(cap.name));
+                    const skipped = declared.filter((cap) => !preRegistered.has(cap.name));
+                    if (skipped.length > 0) {
+                        this.logger.debug(`Addon "${addonId}" restart: not gating on ${skipped.length} cap(s) that were ` +
+                            `unregistered pre-restart (device-scoped, awaiting devices): ${skipped.map((c) => c.name).join(', ')}`, { tags: { addonId } });
+                    }
+                    const waits = gated.map((cap) => this.capabilityRegistry.waitForProvider(cap.name, addonId, REGISTER_WAIT_MS));
                     const settled = await Promise.all(waits);
-                    const missing = declared
+                    const missing = gated
                         .map((cap, i) => (settled[i] == null ? cap.name : null))
                         .filter((name) => name !== null);
                     if (missing.length > 0) {

package/dist/core/addon/system-addons-sync.js

@@ -0,0 +1,121 @@
+"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.isVersionNewer = isVersionNewer;
+exports.syncSystemAddonsCopy = syncSystemAddonsCopy;
+/**
+ * system-addons-sync — reconcile the ADDONS-DIR copy of `@camstack/system`
+ * with the hub's own (active server-root closure) copy at boot.
+ *
+ * Builtins are loaded from `CAMSTACK_ADDONS_DIR/@camstack/system` (the addon
+ * loader scans only that dir), but NO update channel refreshes that copy on an
+ * image hub: the seed-addons stage excludes framework packages, applyServerUpdate
+ * swaps only /data/server-root, and `camstack deploy packages/system` is
+ * rejected once a release image runs. Live incident 2026-07-17: the snapshot
+ * builtin ran system 1.1.49 (no media endpoint) while the active closure
+ * carried 1.1.51 — shipped builtin code silently never executed.
+ *
+ * The sync copies `dist/` + `package.json` from the closure copy over the
+ * addons copy when the closure version is NEWER (semver-wise). The addons
+ * copy's own `node_modules/` is preserved: third-party deps also resolve via
+ * NODE_PATH (the framework dir), and `@camstack/*` deps are host-provided.
+ * Staged copy + rename swap so a crash mid-sync never leaves a gutted dist.
+ * An addons copy that is newer or equal (dev live-update flow) is left alone.
+ */
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+/** Loose semver compare on dotted numeric parts; non-numeric parts compare 0. */
+function isVersionNewer(candidate, current) {
+    const a = candidate.split('.').map((p) => Number.parseInt(p, 10) || 0);
+    const b = current.split('.').map((p) => Number.parseInt(p, 10) || 0);
+    for (let i = 0; i < Math.max(a.length, b.length); i += 1) {
+        const d = (a[i] ?? 0) - (b[i] ?? 0);
+        if (d !== 0)
+            return d > 0;
+    }
+    return false;
+}
+function readVersion(pkgDir) {
+    try {
+        const raw = JSON.parse(fs.readFileSync(path.join(pkgDir, 'package.json'), 'utf-8'));
+        return typeof raw.version === 'string' ? raw.version : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Reconcile once. Returns what happened (for the caller's log/telemetry).
+ * Never throws — a failed sync leaves the previous copy running (same as
+ * before this fix existed) and reports `'failed'`.
+ */
+function syncSystemAddonsCopy(input) {
+    const { addonsDir, closureSystemDir, log } = input;
+    const addonsCopyDir = path.join(addonsDir, '@camstack', 'system');
+    if (!fs.existsSync(path.join(addonsCopyDir, 'package.json')))
+        return 'absent';
+    const closureVersion = readVersion(closureSystemDir);
+    const addonsVersion = readVersion(addonsCopyDir);
+    if (closureVersion === null || addonsVersion === null)
+        return 'failed';
+    if (!isVersionNewer(closureVersion, addonsVersion))
+        return 'up-to-date';
+    try {
+        const srcDist = path.join(closureSystemDir, 'dist');
+        const nextDist = path.join(addonsCopyDir, `.dist.next-${process.pid}`);
+        const oldDist = path.join(addonsCopyDir, `.dist.old-${process.pid}`);
+        fs.rmSync(nextDist, { recursive: true, force: true });
+        fs.cpSync(srcDist, nextDist, { recursive: true });
+        // Swap: rename-aside then rename-in (metadata ops on the same mount).
+        fs.rmSync(oldDist, { recursive: true, force: true });
+        if (fs.existsSync(path.join(addonsCopyDir, 'dist'))) {
+            fs.renameSync(path.join(addonsCopyDir, 'dist'), oldDist);
+        }
+        fs.renameSync(nextDist, path.join(addonsCopyDir, 'dist'));
+        fs.copyFileSync(path.join(closureSystemDir, 'package.json'), path.join(addonsCopyDir, 'package.json'));
+        fs.rmSync(oldDist, { recursive: true, force: true });
+        log('addons-dir @camstack/system synced from closure', {
+            from: addonsVersion,
+            to: closureVersion,
+        });
+        return 'synced';
+    }
+    catch (err) {
+        log('addons-dir @camstack/system sync FAILED — stale builtins keep running', {
+            error: err instanceof Error ? err.message : String(err),
+        });
+        return 'failed';
+    }
+}

package/dist/core/moleculer/agent-readiness-pull.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filterAgentAuthoritativeRecords = filterAgentAuthoritativeRecords;
+const VALID_STATES = new Set(['starting', 'ready', 'down']);
+const VALID_SCOPE_TYPES = new Set(['global', 'node', 'device']);
+/** Structural validation for a record received from a remote node. */
+function isWellFormedRecord(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const record = value;
+    if (typeof record.capName !== 'string' || record.capName.length === 0)
+        return false;
+    if (typeof record.state !== 'string' || !VALID_STATES.has(record.state))
+        return false;
+    if (typeof record.generation !== 'string')
+        return false;
+    if (typeof record.sourceNodeId !== 'string')
+        return false;
+    const scope = record.scope;
+    if (typeof scope !== 'object' || scope === null)
+        return false;
+    if (!VALID_SCOPE_TYPES.has(scope.type))
+        return false;
+    return true;
+}
+/**
+ * Keep only the records `agentNodeId` is authoritative for, dropping
+ * malformed entries. See module doc for why this filter must exist.
+ */
+function filterAgentAuthoritativeRecords(records, agentNodeId) {
+    if (!Array.isArray(records))
+        return [];
+    return records.filter((record) => {
+        if (!isWellFormedRecord(record))
+            return false;
+        if (record.scope.type === 'node')
+            return record.scope.nodeId === agentNodeId;
+        return record.sourceNodeId === agentNodeId;
+    });
+}

package/dist/core/moleculer/moleculer.service.js

@@ -5,6 +5,7 @@ exports.buildChildUdsManifest = buildChildUdsManifest;
 const node_crypto_1 = require("node:crypto");
 const system_1 = require("@camstack/system");
 const types_1 = require("@camstack/types");
+const agent_readiness_pull_js_1 = require("./agent-readiness-pull.js");
 const cap_router_runtime_js_1 = require("../../api/trpc/cap-router-runtime.js");
 const core_cap_bridge_js_1 = require("../../api/trpc/core-cap-bridge.js");
 const cap_call_fn_js_1 = require("./cap-call-fn.js");
@@ -26,6 +27,14 @@ class MoleculerService {
      * `$hub.registerNode`. Populated by `onRegisterNode` in `hubDeps`.
      */
     nodeRegistry = new system_1.HubNodeRegistry();
+    /**
+     * Fixed-period agent-readiness snapshot sweep (D8 reconcile) — repairs
+     * agent-origin readiness deltas lost while the agent stayed connected.
+     * Not a retry backoff: a steady-state reconcile against each agent's
+     * authoritative snapshot.
+     */
+    static AGENT_READINESS_PULL_INTERVAL_MS = 60_000;
+    agentReadinessPullTimer = null;
     nodeCallFns = new Map();
     /**
      * D3: callback invoked whenever a bare-ID agent node completes the
@@ -390,6 +399,30 @@ class MoleculerService {
         bridgeBus.localBus.on('$node.disconnected', ({ node }) => {
             this.removeNodeFromRegistry(node.id);
         });
+        // D8 reverse-leg snapshot-reconcile: on every agent (re)connect, pull
+        // the agent's own readiness snapshot (`$agent-readiness.getSnapshot`)
+        // and hydrate the hub-authoritative registry with the records the
+        // agent is authoritative for. Cross-node `system.ready-state` deltas
+        // are telemetry (lossy) — a lost post-restart `ready` used to leave
+        // this registry stuck on the synthesized `down` forever (2026-07-17:
+        // pipeline-executor@little-unraid, 3.5h dispatch outage). The
+        // periodic sweep below repairs deltas lost while CONNECTED.
+        bridgeBus.localBus.on('$node.connected', ({ node }) => {
+            const nodeId = node.id;
+            if (nodeId === this.brokerSafe.nodeID || nodeId.includes('/'))
+                return;
+            void this.pullAgentReadinessSnapshot(nodeId);
+        });
+        this.agentReadinessPullTimer = setInterval(() => {
+            for (const nodeId of this.nodeRegistry.listNodeIds()) {
+                if (nodeId === this.brokerSafe.nodeID || nodeId.includes('/'))
+                    continue;
+                void this.pullAgentReadinessSnapshot(nodeId);
+            }
+        }, MoleculerService.AGENT_READINESS_PULL_INTERVAL_MS);
+        if (typeof this.agentReadinessPullTimer.unref === 'function') {
+            this.agentReadinessPullTimer.unref();
+        }
         // Register the $event-bus service BEFORE broker.start(). Moleculer
         // announces service subscriptions to remote nodes only during discovery
         // handshake, not dynamically after post-start `createService()`.
@@ -955,7 +988,39 @@ class MoleculerService {
             return false;
         return registry.setChildLogLevel(childId, level);
     }
+    /**
+     * Pull one agent's own readiness snapshot and hydrate the
+     * hub-authoritative registry with the records that agent is
+     * authoritative for (see `agent-readiness-pull.ts` for the filter
+     * rationale). Best-effort: agents predating `$agent-readiness` (or a
+     * service list still propagating right after connect) fail with
+     * "not found" — silent; the periodic sweep retries.
+     */
+    async pullAgentReadinessSnapshot(nodeId) {
+        try {
+            const snapshot = await this.brokerSafe.call(`${system_1.AGENT_READINESS_SERVICE_NAME}.getSnapshot`, {}, { nodeID: nodeId });
+            if (!Array.isArray(snapshot) || snapshot.length === 0)
+                return;
+            const records = (0, agent_readiness_pull_js_1.filterAgentAuthoritativeRecords)(snapshot, nodeId);
+            if (records.length === 0)
+                return;
+            this.readinessRegistry.hydrate(records);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (!msg.includes('not found') && !msg.includes('NOT_FOUND')) {
+                this.logger.debug('agent readiness snapshot pull failed', {
+                    tags: { nodeId },
+                    meta: { err: msg },
+                });
+            }
+        }
+    }
     async onModuleDestroy() {
+        if (this.agentReadinessPullTimer !== null) {
+            clearInterval(this.agentReadinessPullTimer);
+            this.agentReadinessPullTimer = null;
+        }
         this.udsEventBridgeDispose?.();
         this.udsEventBridgeDispose = null;
         await this.brokerSafe.stop();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/server",
-  "version": "1.1.65",
+  "version": "1.1.67",
   "private": false,
   "files": [
     "dist",
@@ -23,19 +23,19 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@camstack/addon-admin-ui": "1.1.53",
-    "@camstack/addon-advanced-notifier": "1.1.25",
-    "@camstack/addon-auth": "1.1.10",
-    "@camstack/addon-decoder-nodeav": "1.1.13",
-    "@camstack/addon-notifiers": "1.1.25",
-    "@camstack/addon-pipeline": "1.1.58",
-    "@camstack/addon-pipeline-orchestrator": "1.1.48",
-    "@camstack/addon-post-analysis": "1.1.30",
-    "@camstack/sdk": "1.1.25",
-    "@camstack/shm-ring": "1.0.24",
-    "@camstack/system": "1.1.51",
-    "@camstack/types": "1.1.46",
-    "@camstack/ui-library": "1.1.37",
+    "@camstack/addon-admin-ui": "1.1.55",
+    "@camstack/addon-advanced-notifier": "1.1.27",
+    "@camstack/addon-auth": "1.1.12",
+    "@camstack/addon-decoder-nodeav": "1.1.15",
+    "@camstack/addon-notifiers": "1.1.27",
+    "@camstack/addon-pipeline": "1.1.60",
+    "@camstack/addon-pipeline-orchestrator": "1.1.50",
+    "@camstack/addon-post-analysis": "1.1.32",
+    "@camstack/sdk": "1.1.27",
+    "@camstack/shm-ring": "1.0.26",
+    "@camstack/system": "1.1.53",
+    "@camstack/types": "1.1.48",
+    "@camstack/ui-library": "1.1.39",
     "@fastify/compress": "^9.0.0",
     "@fastify/cookie": "^11.0.2",
     "@fastify/multipart": "^10.0.0",