@marinoscar/platform-api 0.1.0-next.18 → 0.1.0-next.20

package/dist/nodes/index.d.ts

@@ -1,5 +1,5 @@
 export { NodesModule } from './nodes.module';
-export { NODES_OPTIONS, resolveNodesModuleOptions } from './nodes.options';
+export { DEFAULT_NODE_EVENTS_RETENTION_DAYS, NODES_OPTIONS, resolveNodesModuleOptions } from './nodes.options';
 export type { NodesModuleOptions, ResolvedNodesModuleOptions } from './nodes.options';
 export { NODES_SYSTEM_SETTINGS, mergeNodesSettings } from './nodes.system-settings';
 export { NodeCredentialModule } from './node-credential.module';
@@ -9,9 +9,14 @@ export { BUILTIN_NODE_SPAN_ATTRIBUTES, DEFAULT_NODE_SPAN_ATTRIBUTE_STRING_LENGTH
 export type { BuiltinNodeSpanAttribute, NodeSpanAttributeDefinition, RelayedAttribute } from './node-span-attribute.registry';
 export type { BuiltinNodeSpanName, NodeSpanName } from './dto/node-telemetry.dto';
 export { NODE_OFFLINE_EVENT, NodeOfflineEvent } from './events/node-offline.event';
+export { NODE_EVENT_REPORTED, NodeEventReportedEvent } from './events/node-event.event';
 export { CREDENTIAL_OWNER_SELECT, NODE_TOKEN_PREFIX, NodeCredentialService } from './node-credential.service';
 export { NodesService } from './nodes.service';
-export { NodeLifecycleService } from './node-lifecycle.service';
+export { NODE_EVENTS_PER_HOUR, NODE_EVENT_MAX_AGE_MS, NODE_EVENT_MAX_FUTURE_MS, NodeEventRateLimiter, NodeEventsService, } from './node-events.service';
+export type { NodeEventIngestOutcome } from './node-events.service';
+export { NODE_EVENTS_PURGE_TYPE, NodeEventsPurgeHandler } from './handlers/node-events-purge.handler';
+export { NodeLifecycleService, deriveNodeHealth } from './node-lifecycle.service';
+export type { NodeHealth, NodeHealthInput } from './node-lifecycle.service';
 export { NODE_OUTPUT_KEY_PREFIX, NodeDataPlaneService } from './node-data-plane.service';
 export { NodeSecretBrokerService, SECRET_CLOCK_SKEW_ALLOWANCE_MS } from './node-secret-broker.service';
 export { NodesAdminService, OWNER_SELECT } from './nodes-admin.service';
@@ -29,9 +34,11 @@ export type { HeartbeatNodeDto, NodeJobFailureDto, RegisterNodeDto, RenewLeaseDt
 export type { NodeDownloadUrlResponseDto, NodeJobTypeDto, NodeJobTypesResponseDto, NodeUploadUrlResponseDto, } from './dto/node-data-plane.dto';
 export type { NodeJobSecretRequestDto, NodeJobSecretResponseDto } from './dto/node-job-secret.dto';
 export type { AdminNodeCredentialDto, AdminNodeDto, NodeJobCountsDto, NodeOwnerDto, NodeVitalsCountersDto, NodeVitalsDto, } from './dto/node-admin.dto';
-export type { ClaimJobsResponseDto, JobSettlementResponseDto, NodeJobAssignmentDto, NodeJobDto, RegisterNodeResponseDto, RenewLeaseResponseDto, WorkerNodeDto, } from './dto/node-response.dto';
+export { NODE_SERVER_FEATURES } from './dto/node-response.dto';
+export type { AdminNodeEventDto, AdminNodeEventListDto, NodeHostVitalsDto, NodePowerDto } from './dto/node-event.dto';
+export type { ClaimJobsResponseDto, HeartbeatNodeResponseDto, JobSettlementResponseDto, NodeJobAssignmentDto, NodeJobDto, RegisterNodeResponseDto, RenewLeaseResponseDto, WorkerNodeDto, } from './dto/node-response.dto';
 export type { NodeCredentialCreatedResponseDto, NodeCredentialListItemDto } from './dto/node-credential-response.dto';
-export { NODES_APP_METRICS, NODE_HEALTH_VALUES, NODE_STATUS_VALUES } from './nodes.metrics';
+export { NODES_APP_METRICS, NODE_EVENT_METRIC_TYPES, NODE_EVENT_SEVERITY_VALUES, NODE_HEALTH_VALUES, NODE_STATUS_VALUES, } from './nodes.metrics';
 export type { NodesAppMetricDef } from './nodes.metrics';
 export { NODES_PERMISSIONS } from './nodes.permissions';
 export type { NodesPermissionDeclaration } from './nodes.permissions';

package/dist/nodes/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/nodes/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/nodes/index.ts"],"names":[],"mappings":"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"}

package/dist/nodes/index.js

@@ -5,11 +5,13 @@
 // fleet admin routes, sweeps and gauges. Needs `@marinoscar/platform-api/jobs`.
 // Documented in ./README.md. Explicit named exports only.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NODES_PERMISSIONS = exports.NODE_STATUS_VALUES = exports.NODE_HEALTH_VALUES = exports.NODES_APP_METRICS = exports.NodeUploadUrlDto = exports.NodeDownloadUrlDto = exports.NodeJobResultDto = exports.ClaimJobsDto = exports.NodeFleetSweepHandler = exports.NODE_FLEET_SWEEP_TYPE = exports.NodeFleetPruneHandler = exports.NODE_FLEET_PRUNE_TYPE = exports.OWNER_SELECT = exports.NodesAdminService = exports.SECRET_CLOCK_SKEW_ALLOWANCE_MS = exports.NodeSecretBrokerService = exports.NodeDataPlaneService = exports.NODE_OUTPUT_KEY_PREFIX = exports.NodeLifecycleService = exports.NodesService = exports.NodeCredentialService = exports.NODE_TOKEN_PREFIX = exports.CREDENTIAL_OWNER_SELECT = exports.NodeOfflineEvent = exports.NODE_OFFLINE_EVENT = exports.resolveRelayedAttribute = exports.registerNodeSpanAttribute = exports.nodeSpanAttributeRegistry = exports.NODE_SPAN_ATTRIBUTE_STRING_PATTERN = exports.NODE_SPAN_ATTRIBUTE_KEY_PATTERN = exports.MAX_NODE_SPAN_ATTRIBUTE_STRING_LENGTH = exports.MAX_NODE_SPAN_ATTRIBUTES = exports.DEFAULT_NODE_SPAN_ATTRIBUTE_STRING_LENGTH = exports.BUILTIN_NODE_SPAN_ATTRIBUTES = exports.NodeJobInputError = exports.NODE_OBJECT_STORE = exports.NODE_JOB_INPUTS = exports.NodeCredentialModule = exports.mergeNodesSettings = exports.NODES_SYSTEM_SETTINGS = exports.resolveNodesModuleOptions = exports.NODES_OPTIONS = exports.NodesModule = void 0;
+exports.NodeUploadUrlDto = exports.NodeDownloadUrlDto = exports.NodeJobResultDto = exports.ClaimJobsDto = exports.NodeFleetSweepHandler = exports.NODE_FLEET_SWEEP_TYPE = exports.NodeFleetPruneHandler = exports.NODE_FLEET_PRUNE_TYPE = exports.OWNER_SELECT = exports.NodesAdminService = exports.SECRET_CLOCK_SKEW_ALLOWANCE_MS = exports.NodeSecretBrokerService = exports.NodeDataPlaneService = exports.NODE_OUTPUT_KEY_PREFIX = exports.deriveNodeHealth = exports.NodeLifecycleService = exports.NodeEventsPurgeHandler = exports.NODE_EVENTS_PURGE_TYPE = exports.NodeEventsService = exports.NodeEventRateLimiter = exports.NODE_EVENT_MAX_FUTURE_MS = exports.NODE_EVENT_MAX_AGE_MS = exports.NODE_EVENTS_PER_HOUR = exports.NodesService = exports.NodeCredentialService = exports.NODE_TOKEN_PREFIX = exports.CREDENTIAL_OWNER_SELECT = exports.NodeEventReportedEvent = exports.NODE_EVENT_REPORTED = exports.NodeOfflineEvent = exports.NODE_OFFLINE_EVENT = exports.resolveRelayedAttribute = exports.registerNodeSpanAttribute = exports.nodeSpanAttributeRegistry = exports.NODE_SPAN_ATTRIBUTE_STRING_PATTERN = exports.NODE_SPAN_ATTRIBUTE_KEY_PATTERN = exports.MAX_NODE_SPAN_ATTRIBUTE_STRING_LENGTH = exports.MAX_NODE_SPAN_ATTRIBUTES = exports.DEFAULT_NODE_SPAN_ATTRIBUTE_STRING_LENGTH = exports.BUILTIN_NODE_SPAN_ATTRIBUTES = exports.NodeJobInputError = exports.NODE_OBJECT_STORE = exports.NODE_JOB_INPUTS = exports.NodeCredentialModule = exports.mergeNodesSettings = exports.NODES_SYSTEM_SETTINGS = exports.resolveNodesModuleOptions = exports.NODES_OPTIONS = exports.DEFAULT_NODE_EVENTS_RETENTION_DAYS = exports.NodesModule = void 0;
+exports.NODES_PERMISSIONS = exports.NODE_STATUS_VALUES = exports.NODE_HEALTH_VALUES = exports.NODE_EVENT_SEVERITY_VALUES = exports.NODE_EVENT_METRIC_TYPES = exports.NODES_APP_METRICS = exports.NODE_SERVER_FEATURES = void 0;
 // ---- the modules and options (rung 1) --------------------------------------------------
 var nodes_module_1 = require("./nodes.module");
 Object.defineProperty(exports, "NodesModule", { enumerable: true, get: function () { return nodes_module_1.NodesModule; } });
 var nodes_options_1 = require("./nodes.options");
+Object.defineProperty(exports, "DEFAULT_NODE_EVENTS_RETENTION_DAYS", { enumerable: true, get: function () { return nodes_options_1.DEFAULT_NODE_EVENTS_RETENTION_DAYS; } });
 Object.defineProperty(exports, "NODES_OPTIONS", { enumerable: true, get: function () { return nodes_options_1.NODES_OPTIONS; } });
 Object.defineProperty(exports, "resolveNodesModuleOptions", { enumerable: true, get: function () { return nodes_options_1.resolveNodesModuleOptions; } });
 var nodes_system_settings_1 = require("./nodes.system-settings");
@@ -37,6 +39,9 @@ Object.defineProperty(exports, "resolveRelayedAttribute", { enumerable: true, ge
 var node_offline_event_1 = require("./events/node-offline.event");
 Object.defineProperty(exports, "NODE_OFFLINE_EVENT", { enumerable: true, get: function () { return node_offline_event_1.NODE_OFFLINE_EVENT; } });
 Object.defineProperty(exports, "NodeOfflineEvent", { enumerable: true, get: function () { return node_offline_event_1.NodeOfflineEvent; } });
+var node_event_event_1 = require("./events/node-event.event");
+Object.defineProperty(exports, "NODE_EVENT_REPORTED", { enumerable: true, get: function () { return node_event_event_1.NODE_EVENT_REPORTED; } });
+Object.defineProperty(exports, "NodeEventReportedEvent", { enumerable: true, get: function () { return node_event_event_1.NodeEventReportedEvent; } });
 // ---- services ----------------------------------------------------------------------------------
 var node_credential_service_1 = require("./node-credential.service");
 Object.defineProperty(exports, "CREDENTIAL_OWNER_SELECT", { enumerable: true, get: function () { return node_credential_service_1.CREDENTIAL_OWNER_SELECT; } });
@@ -44,8 +49,18 @@ Object.defineProperty(exports, "NODE_TOKEN_PREFIX", { enumerable: true, get: fun
 Object.defineProperty(exports, "NodeCredentialService", { enumerable: true, get: function () { return node_credential_service_1.NodeCredentialService; } });
 var nodes_service_1 = require("./nodes.service");
 Object.defineProperty(exports, "NodesService", { enumerable: true, get: function () { return nodes_service_1.NodesService; } });
+var node_events_service_1 = require("./node-events.service");
+Object.defineProperty(exports, "NODE_EVENTS_PER_HOUR", { enumerable: true, get: function () { return node_events_service_1.NODE_EVENTS_PER_HOUR; } });
+Object.defineProperty(exports, "NODE_EVENT_MAX_AGE_MS", { enumerable: true, get: function () { return node_events_service_1.NODE_EVENT_MAX_AGE_MS; } });
+Object.defineProperty(exports, "NODE_EVENT_MAX_FUTURE_MS", { enumerable: true, get: function () { return node_events_service_1.NODE_EVENT_MAX_FUTURE_MS; } });
+Object.defineProperty(exports, "NodeEventRateLimiter", { enumerable: true, get: function () { return node_events_service_1.NodeEventRateLimiter; } });
+Object.defineProperty(exports, "NodeEventsService", { enumerable: true, get: function () { return node_events_service_1.NodeEventsService; } });
+var node_events_purge_handler_1 = require("./handlers/node-events-purge.handler");
+Object.defineProperty(exports, "NODE_EVENTS_PURGE_TYPE", { enumerable: true, get: function () { return node_events_purge_handler_1.NODE_EVENTS_PURGE_TYPE; } });
+Object.defineProperty(exports, "NodeEventsPurgeHandler", { enumerable: true, get: function () { return node_events_purge_handler_1.NodeEventsPurgeHandler; } });
 var node_lifecycle_service_1 = require("./node-lifecycle.service");
 Object.defineProperty(exports, "NodeLifecycleService", { enumerable: true, get: function () { return node_lifecycle_service_1.NodeLifecycleService; } });
+Object.defineProperty(exports, "deriveNodeHealth", { enumerable: true, get: function () { return node_lifecycle_service_1.deriveNodeHealth; } });
 var node_data_plane_service_1 = require("./node-data-plane.service");
 Object.defineProperty(exports, "NODE_OUTPUT_KEY_PREFIX", { enumerable: true, get: function () { return node_data_plane_service_1.NODE_OUTPUT_KEY_PREFIX; } });
 Object.defineProperty(exports, "NodeDataPlaneService", { enumerable: true, get: function () { return node_data_plane_service_1.NodeDataPlaneService; } });
@@ -68,9 +83,13 @@ Object.defineProperty(exports, "NodeJobResultDto", { enumerable: true, get: func
 var node_data_plane_dto_1 = require("./dto/node-data-plane.dto");
 Object.defineProperty(exports, "NodeDownloadUrlDto", { enumerable: true, get: function () { return node_data_plane_dto_1.NodeDownloadUrlDto; } });
 Object.defineProperty(exports, "NodeUploadUrlDto", { enumerable: true, get: function () { return node_data_plane_dto_1.NodeUploadUrlDto; } });
+var node_response_dto_1 = require("./dto/node-response.dto");
+Object.defineProperty(exports, "NODE_SERVER_FEATURES", { enumerable: true, get: function () { return node_response_dto_1.NODE_SERVER_FEATURES; } });
 // ---- metrics, permissions ----------------------------------------------------------------------
 var nodes_metrics_1 = require("./nodes.metrics");
 Object.defineProperty(exports, "NODES_APP_METRICS", { enumerable: true, get: function () { return nodes_metrics_1.NODES_APP_METRICS; } });
+Object.defineProperty(exports, "NODE_EVENT_METRIC_TYPES", { enumerable: true, get: function () { return nodes_metrics_1.NODE_EVENT_METRIC_TYPES; } });
+Object.defineProperty(exports, "NODE_EVENT_SEVERITY_VALUES", { enumerable: true, get: function () { return nodes_metrics_1.NODE_EVENT_SEVERITY_VALUES; } });
 Object.defineProperty(exports, "NODE_HEALTH_VALUES", { enumerable: true, get: function () { return nodes_metrics_1.NODE_HEALTH_VALUES; } });
 Object.defineProperty(exports, "NODE_STATUS_VALUES", { enumerable: true, get: function () { return nodes_metrics_1.NODE_STATUS_VALUES; } });
 var nodes_permissions_1 = require("./nodes.permissions");

package/dist/nodes/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/nodes/index.ts"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,qEAAqE;AACrE,6EAA6E;AAC7E,gFAAgF;AAChF,0DAA0D;;;AAE1D,2FAA2F;AAC3F,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AACpB,iDAA2E;AAAlE,8GAAA,aAAa,OAAA;AAAE,0HAAA,yBAAyB,OAAA;AAEjD,iEAAoF;AAA3E,8HAAA,qBAAqB,OAAA;AAAE,2HAAA,kBAAkB,OAAA;AAClD,mEAAgE;AAAvD,8HAAA,oBAAoB,OAAA;AAE7B,6FAA6F;AAC7F,iCAAgF;AAAvE,wGAAA,eAAe,OAAA;AAAE,0GAAA,iBAAiB,OAAA;AAAE,0GAAA,iBAAiB,OAAA;AAU9D,8FAA8F;AAC9F,+EAUwC;AATtC,4IAAA,4BAA4B,OAAA;AAC5B,yJAAA,yCAAyC,OAAA;AACzC,wIAAA,wBAAwB,OAAA;AACxB,qJAAA,qCAAqC,OAAA;AACrC,+IAAA,+BAA+B,OAAA;AAC/B,kJAAA,kCAAkC,OAAA;AAClC,yIAAA,yBAAyB,OAAA;AACzB,yIAAA,yBAAyB,OAAA;AACzB,uIAAA,uBAAuB,OAAA;AAKzB,iGAAiG;AACjG,kEAAmF;AAA1E,wHAAA,kBAAkB,OAAA;AAAE,sHAAA,gBAAgB,OAAA;AAE7C,mGAAmG;AACnG,qEAA8G;AAArG,kIAAA,uBAAuB,OAAA;AAAE,4HAAA,iBAAiB,OAAA;AAAE,gIAAA,qBAAqB,OAAA;AAC1E,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,mEAAgE;AAAvD,8HAAA,oBAAoB,OAAA;AAC7B,qEAAyF;AAAhF,iIAAA,sBAAsB,OAAA;AAAE,+HAAA,oBAAoB,OAAA;AACrD,2EAAuG;AAA9F,qIAAA,uBAAuB,OAAA;AAAE,4IAAA,8BAA8B,OAAA;AAChE,6DAAwE;AAA/D,wHAAA,iBAAiB,OAAA;AAAE,mHAAA,YAAY,OAAA;AACxC,gFAAmG;AAA1F,iIAAA,qBAAqB,OAAA;AAAE,iIAAA,qBAAqB,OAAA;AACrD,gFAAmG;AAA1F,iIAAA,qBAAqB,OAAA;AAAE,iIAAA,qBAAqB,OAAA;AAErD,oGAAoG;AACpG,uEAA8E;AAArE,sHAAA,YAAY,OAAA;AAAE,0HAAA,gBAAgB,OAAA;AACvC,iEAAiF;AAAxE,yHAAA,kBAAkB,OAAA;AAAE,uHAAA,gBAAgB,OAAA;AAoC7C,mGAAmG;AACnG,iDAA4F;AAAnF,kHAAA,iBAAiB,OAAA;AAAE,mHAAA,kBAAkB,OAAA;AAAE,mHAAA,kBAAkB,OAAA;AAElE,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/nodes/index.ts"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,qEAAqE;AACrE,6EAA6E;AAC7E,gFAAgF;AAChF,0DAA0D;;;;AAE1D,2FAA2F;AAC3F,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AACpB,iDAA+G;AAAtG,mIAAA,kCAAkC,OAAA;AAAE,8GAAA,aAAa,OAAA;AAAE,0HAAA,yBAAyB,OAAA;AAErF,iEAAoF;AAA3E,8HAAA,qBAAqB,OAAA;AAAE,2HAAA,kBAAkB,OAAA;AAClD,mEAAgE;AAAvD,8HAAA,oBAAoB,OAAA;AAE7B,6FAA6F;AAC7F,iCAAgF;AAAvE,wGAAA,eAAe,OAAA;AAAE,0GAAA,iBAAiB,OAAA;AAAE,0GAAA,iBAAiB,OAAA;AAU9D,8FAA8F;AAC9F,+EAUwC;AATtC,4IAAA,4BAA4B,OAAA;AAC5B,yJAAA,yCAAyC,OAAA;AACzC,wIAAA,wBAAwB,OAAA;AACxB,qJAAA,qCAAqC,OAAA;AACrC,+IAAA,+BAA+B,OAAA;AAC/B,kJAAA,kCAAkC,OAAA;AAClC,yIAAA,yBAAyB,OAAA;AACzB,yIAAA,yBAAyB,OAAA;AACzB,uIAAA,uBAAuB,OAAA;AAKzB,iGAAiG;AACjG,kEAAmF;AAA1E,wHAAA,kBAAkB,OAAA;AAAE,sHAAA,gBAAgB,OAAA;AAC7C,8DAAwF;AAA/E,uHAAA,mBAAmB,OAAA;AAAE,0HAAA,sBAAsB,OAAA;AAEpD,mGAAmG;AACnG,qEAA8G;AAArG,kIAAA,uBAAuB,OAAA;AAAE,4HAAA,iBAAiB,OAAA;AAAE,gIAAA,qBAAqB,OAAA;AAC1E,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,6DAM+B;AAL7B,2HAAA,oBAAoB,OAAA;AACpB,4HAAA,qBAAqB,OAAA;AACrB,+HAAA,wBAAwB,OAAA;AACxB,2HAAA,oBAAoB,OAAA;AACpB,wHAAA,iBAAiB,OAAA;AAGnB,kFAAsG;AAA7F,mIAAA,sBAAsB,OAAA;AAAE,mIAAA,sBAAsB,OAAA;AACvD,mEAAkF;AAAzE,8HAAA,oBAAoB,OAAA;AAAE,0HAAA,gBAAgB,OAAA;AAE/C,qEAAyF;AAAhF,iIAAA,sBAAsB,OAAA;AAAE,+HAAA,oBAAoB,OAAA;AACrD,2EAAuG;AAA9F,qIAAA,uBAAuB,OAAA;AAAE,4IAAA,8BAA8B,OAAA;AAChE,6DAAwE;AAA/D,wHAAA,iBAAiB,OAAA;AAAE,mHAAA,YAAY,OAAA;AACxC,gFAAmG;AAA1F,iIAAA,qBAAqB,OAAA;AAAE,iIAAA,qBAAqB,OAAA;AACrD,gFAAmG;AAA1F,iIAAA,qBAAqB,OAAA;AAAE,iIAAA,qBAAqB,OAAA;AAErD,oGAAoG;AACpG,uEAA8E;AAArE,sHAAA,YAAY,OAAA;AAAE,0HAAA,gBAAgB,OAAA;AACvC,iEAAiF;AAAxE,yHAAA,kBAAkB,OAAA;AAAE,uHAAA,gBAAgB,OAAA;AAyB7C,6DAA+D;AAAtD,yHAAA,oBAAoB,OAAA;AAc7B,mGAAmG;AACnG,iDAMyB;AALvB,kHAAA,iBAAiB,OAAA;AACjB,wHAAA,uBAAuB,OAAA;AACvB,2HAAA,0BAA0B,OAAA;AAC1B,mHAAA,kBAAkB,OAAA;AAClB,mHAAA,kBAAkB,OAAA;AAGpB,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA"}

package/dist/nodes/node-events.service.d.ts

@@ -0,0 +1,87 @@
+import { EventEmitter2 } from '@nestjs/event-emitter';
+import type { AdminNodeEventList, NodeEvent, NodeEventListQuery } from '@marinoscar/platform-contract/nodes';
+import { type JobsPrisma, type WorkerNode } from '../jobs/index';
+import { MetricsHostService } from '../otel-core/index';
+/**
+ * Accepted events per node per hour; the excess is dropped and counted.
+ *
+ * @stability experimental
+ */
+export declare const NODE_EVENTS_PER_HOUR = 120;
+/**
+ * An `occurredAt` older than this (relative to receipt) is replaced by the receipt time.
+ *
+ * @stability experimental
+ */
+export declare const NODE_EVENT_MAX_AGE_MS: number;
+/**
+ * An `occurredAt` further in the future than this is replaced by the receipt time.
+ *
+ * @stability experimental
+ */
+export declare const NODE_EVENT_MAX_FUTURE_MS: number;
+/** Default page size of the events list. */
+export declare const NODE_EVENTS_DEFAULT_PAGE_SIZE = 20;
+/** Largest page size of the events list. */
+export declare const NODE_EVENTS_MAX_PAGE_SIZE = 100;
+/**
+ * A per-node token bucket: `NODE_EVENTS_PER_HOUR` capacity, refilled evenly
+ * over the hour. In memory and per replica, on purpose (see the header).
+ *
+ * @stability experimental
+ */
+export declare class NodeEventRateLimiter {
+    private readonly buckets;
+    /**
+     * Takes up to `wanted` tokens for `nodeId` and returns how many it granted.
+     *
+     * @param nodeId - the node (proven owned by the caller before this is asked).
+     * @param wanted - how many events the heartbeat carried.
+     * @param nowMs - the clock, injectable for tests.
+     */
+    take(nodeId: string, wanted: number, nowMs?: number): number;
+    /** Forgets full (idle) buckets first; a fresh bucket starts full, so nothing is lost. */
+    private evict;
+}
+/**
+ * What one ingestion did.
+ *
+ * @stability experimental
+ */
+export interface NodeEventIngestOutcome {
+    /** Rows written. */
+    accepted: number;
+    /** Events dropped by the per-node rate cap. */
+    dropped: number;
+}
+/** `occurredAt` after the clamp (see the header). */
+export declare function clampOccurredAt(at: string, receivedAt: Date): Date;
+/**
+ * Records the events a heartbeat carries and serves the per-node event log:
+ * the rate cap, the clamp, the write, then the metric, span, log line and
+ * `nodes.node.event` domain event. `ingest` never throws.
+ *
+ * @stability experimental
+ */
+export declare class NodeEventsService {
+    private readonly prisma;
+    private readonly events?;
+    private readonly logger;
+    private readonly limiter;
+    private readonly metrics;
+    constructor(prisma: JobsPrisma, events?: EventEmitter2 | undefined, metrics?: MetricsHostService);
+    /**
+     * Persists the events a heartbeat carried and announces them. NEVER THROWS.
+     *
+     * @param node - the node row the heartbeat was proven to belong to.
+     * @param events - the validated `events` of the heartbeat body.
+     */
+    ingest(node: Pick<WorkerNode, 'id' | 'name' | 'createdById'>, events: readonly NodeEvent[] | undefined): Promise<NodeEventIngestOutcome>;
+    private announce;
+    /**
+     * One page of a node's events, newest first. The caller has already proven
+     * access to the node; `nodeId` not existing is a 404 here as a backstop.
+     */
+    list(nodeId: string, query: NodeEventListQuery): Promise<AdminNodeEventList>;
+}
+//# sourceMappingURL=node-events.service.d.ts.map

package/dist/nodes/node-events.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-events.service.d.ts","sourceRoot":"","sources":["../../src/nodes/node-events.service.ts"],"names":[],"mappings":"AAkCA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAkB,kBAAkB,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAG7H,OAAO,EAA2B,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAC1F,OAAO,EAAE,kBAAkB,EAAsB,MAAM,oBAAoB,CAAC;AAI5E;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAAsB,CAAC;AAEzD;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,QAAgB,CAAC;AAEtD,4CAA4C;AAC5C,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD,4CAA4C;AAC5C,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAU7C;;;;;GAKG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IAErD;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAmB,GAAG,MAAM;IAgBxE,yFAAyF;IACzF,OAAO,CAAC,KAAK;CAOd;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qDAAqD;AACrD,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,GAAG,IAAI,CAOlE;AAED;;;;;;GAMG;AACH,qBACa,iBAAiB;IAMD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAPtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAC7D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAGD,MAAM,EAAE,UAAU,EAE/B,MAAM,CAAC,EAAE,aAAa,YAAA,EACvC,OAAO,CAAC,EAAE,kBAAkB;IAK1C;;;;;OAKG;IACG,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,MAAM,GAAG,aAAa,CAAC,EAAE,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAkC9I,OAAO,CAAC,QAAQ;IAiDhB;;;OAGG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAkCnF"}

package/dist/nodes/node-events.service.js

@@ -0,0 +1,271 @@
+"use strict";
+// =============================================================================
+// Node events: ingestion and reads (issue #1045)
+// =============================================================================
+//
+// A heartbeat may carry `events[]` the node observed about itself (power source
+// changed, battery low, woke from sleep, disk low). This service is the one
+// place they are turned into rows, metrics, a span and a domain event.
+//
+// ORDER, AND WHY
+//
+//   1. RATE CAP (per node, in memory): at most `NODE_EVENTS_PER_HOUR` accepted
+//      events per node per hour. A node in a flapping loop (or a stolen
+//      credential used as a firehose) cannot grow the table without bound;
+//      the excess is DROPPED AND COUNTED, never an error, because a heartbeat
+//      carries liveness and must not fail over its events. In memory and per
+//      replica for the reason `NodeTelemetryRateLimiter` gives.
+//   2. CLAMP: `occurredAt` is the node's clock. A value outside
+//      `[now - 24h, now + 5m]` (a wrong clock, a replayed queue) is replaced
+//      by the server's `receivedAt`, so a timeline never shows next year.
+//   3. WRITE: one `createMany`.
+//   4. AFTER THE WRITE, outside any transaction: the `app.nodes.events`
+//      counter, a short `node.event` span, and one `NODE_EVENT_REPORTED` domain
+//      event per row. All three are observers and never throw.
+//
+// ⚠ NOTHING HERE MAY FAIL THE HEARTBEAT. `ingest` swallows its own errors
+// (logged): a node whose heartbeats fail goes stale and is swept offline, a
+// far worse outcome than a missing power event.
+//
+// SPAN ATTRIBUTES ARE BOUNDED: `node.id`, `node.name`, `node.event.type` (a
+// known type, else `other`) and `node.event.severity`. The free-form `attrs`
+// never reach a span or a metric label; they are stored and displayed only.
+// =============================================================================
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var NodeEventsService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeEventsService = exports.NodeEventRateLimiter = exports.NODE_EVENTS_MAX_PAGE_SIZE = exports.NODE_EVENTS_DEFAULT_PAGE_SIZE = exports.NODE_EVENT_MAX_FUTURE_MS = exports.NODE_EVENT_MAX_AGE_MS = exports.NODE_EVENTS_PER_HOUR = void 0;
+exports.clampOccurredAt = clampOccurredAt;
+const common_1 = require("@nestjs/common");
+const event_emitter_1 = require("@nestjs/event-emitter");
+const api_1 = require("@opentelemetry/api");
+const index_1 = require("../core/index");
+const index_2 = require("../otel-core/index");
+const node_event_event_1 = require("./events/node-event.event");
+const nodes_metrics_1 = require("./nodes.metrics");
+/**
+ * Accepted events per node per hour; the excess is dropped and counted.
+ *
+ * @stability experimental
+ */
+exports.NODE_EVENTS_PER_HOUR = 120;
+/**
+ * An `occurredAt` older than this (relative to receipt) is replaced by the receipt time.
+ *
+ * @stability experimental
+ */
+exports.NODE_EVENT_MAX_AGE_MS = 24 * 60 * 60 * 1000;
+/**
+ * An `occurredAt` further in the future than this is replaced by the receipt time.
+ *
+ * @stability experimental
+ */
+exports.NODE_EVENT_MAX_FUTURE_MS = 5 * 60 * 1000;
+/** Default page size of the events list. */
+exports.NODE_EVENTS_DEFAULT_PAGE_SIZE = 20;
+/** Largest page size of the events list. */
+exports.NODE_EVENTS_MAX_PAGE_SIZE = 100;
+/** Cap on tracked nodes in the in-memory limiter. */
+const MAX_BUCKETS = 10_000;
+/**
+ * A per-node token bucket: `NODE_EVENTS_PER_HOUR` capacity, refilled evenly
+ * over the hour. In memory and per replica, on purpose (see the header).
+ *
+ * @stability experimental
+ */
+class NodeEventRateLimiter {
+    buckets = new Map();
+    /**
+     * Takes up to `wanted` tokens for `nodeId` and returns how many it granted.
+     *
+     * @param nodeId - the node (proven owned by the caller before this is asked).
+     * @param wanted - how many events the heartbeat carried.
+     * @param nowMs - the clock, injectable for tests.
+     */
+    take(nodeId, wanted, nowMs = Date.now()) {
+        let bucket = this.buckets.get(nodeId);
+        if (bucket === undefined) {
+            if (this.buckets.size >= MAX_BUCKETS)
+                this.evict(nowMs);
+            bucket = { tokens: exports.NODE_EVENTS_PER_HOUR, updatedAtMs: nowMs };
+            this.buckets.set(nodeId, bucket);
+        }
+        else {
+            const elapsed = Math.max(0, nowMs - bucket.updatedAtMs);
+            bucket.tokens = Math.min(exports.NODE_EVENTS_PER_HOUR, bucket.tokens + (elapsed * exports.NODE_EVENTS_PER_HOUR) / 3_600_000);
+            bucket.updatedAtMs = nowMs;
+        }
+        const granted = Math.min(wanted, Math.floor(bucket.tokens));
+        bucket.tokens -= granted;
+        return granted;
+    }
+    /** Forgets full (idle) buckets first; a fresh bucket starts full, so nothing is lost. */
+    evict(nowMs) {
+        for (const [id, bucket] of this.buckets) {
+            const elapsed = Math.max(0, nowMs - bucket.updatedAtMs);
+            if (bucket.tokens + (elapsed * exports.NODE_EVENTS_PER_HOUR) / 3_600_000 >= exports.NODE_EVENTS_PER_HOUR)
+                this.buckets.delete(id);
+        }
+        if (this.buckets.size >= MAX_BUCKETS)
+            this.buckets.clear();
+    }
+}
+exports.NodeEventRateLimiter = NodeEventRateLimiter;
+/** `occurredAt` after the clamp (see the header). */
+function clampOccurredAt(at, receivedAt) {
+    const parsed = new Date(at);
+    const ms = parsed.getTime();
+    if (Number.isNaN(ms))
+        return receivedAt;
+    const now = receivedAt.getTime();
+    if (ms < now - exports.NODE_EVENT_MAX_AGE_MS || ms > now + exports.NODE_EVENT_MAX_FUTURE_MS)
+        return receivedAt;
+    return parsed;
+}
+/**
+ * Records the events a heartbeat carries and serves the per-node event log:
+ * the rate cap, the clamp, the write, then the metric, span, log line and
+ * `nodes.node.event` domain event. `ingest` never throws.
+ *
+ * @stability experimental
+ */
+let NodeEventsService = NodeEventsService_1 = class NodeEventsService {
+    prisma;
+    events;
+    logger = new common_1.Logger(NodeEventsService_1.name);
+    limiter = new NodeEventRateLimiter();
+    metrics;
+    constructor(prisma, events, metrics) {
+        this.prisma = prisma;
+        this.events = events;
+        this.metrics = metrics ?? new index_2.MetricsHostService();
+    }
+    /**
+     * Persists the events a heartbeat carried and announces them. NEVER THROWS.
+     *
+     * @param node - the node row the heartbeat was proven to belong to.
+     * @param events - the validated `events` of the heartbeat body.
+     */
+    async ingest(node, events) {
+        if (events === undefined || events.length === 0)
+            return { accepted: 0, dropped: 0 };
+        try {
+            const receivedAt = new Date();
+            const granted = this.limiter.take(node.id, events.length, receivedAt.getTime());
+            const accepted = events.slice(0, granted);
+            const dropped = events.length - accepted.length;
+            if (dropped > 0) {
+                this.logger.warn(`Node ${node.id}: dropped ${dropped} event(s) over the ${exports.NODE_EVENTS_PER_HOUR}/hour cap`);
+            }
+            if (accepted.length === 0)
+                return { accepted: 0, dropped };
+            const rows = accepted.map((event) => ({
+                nodeId: node.id,
+                type: event.type,
+                severity: event.severity,
+                attrs: event.attrs === undefined ? null : event.attrs,
+                occurredAt: clampOccurredAt(event.at, receivedAt),
+                receivedAt,
+            }));
+            await this.prisma.workerNodeEvent.createMany({ data: rows });
+            // After the write, outside any transaction: observers only.
+            for (const row of rows)
+                this.announce(node, row);
+            return { accepted: rows.length, dropped };
+        }
+        catch (error) {
+            this.logger.warn(`Node ${node.id}: could not record ${events.length} event(s): ${error instanceof Error ? error.message : String(error)}`);
+            return { accepted: 0, dropped: 0 };
+        }
+    }
+    announce(node, row) {
+        const severity = row.severity;
+        const knownType = nodes_metrics_1.NODE_EVENT_METRIC_TYPES.includes(row.type) ? row.type : 'other';
+        this.metrics.add('nodesEvents', 1, { type: knownType, severity });
+        // A structured log line: with log shipping on, this is the OTel log record
+        // the dashboard's events feed reads. Bounded fields only, never `attrs`.
+        const line = `Node event ${knownType === 'other' ? 'other' : row.type} (${severity}) from node ${node.id}`;
+        if (severity === 'info')
+            this.logger.log(line);
+        else
+            this.logger.warn(line);
+        try {
+            const span = api_1.trace.getTracer((0, index_2.resolveServiceName)()).startSpan('node.event', {
+                kind: api_1.SpanKind.INTERNAL,
+                attributes: {
+                    'node.id': node.id,
+                    'node.name': node.name,
+                    'node.event.type': knownType,
+                    'node.event.severity': severity,
+                    'telemetry.relay': 'node',
+                },
+            });
+            span.end();
+        }
+        catch {
+            // Tracing is an observer.
+        }
+        try {
+            this.events?.emit(node_event_event_1.NODE_EVENT_REPORTED, new node_event_event_1.NodeEventReportedEvent(node.id, node.name, node.createdById ?? null, row.type, severity, (row.attrs ?? {}), row.occurredAt));
+        }
+        catch (error) {
+            this.logger.debug(`A ${node_event_event_1.NODE_EVENT_REPORTED} listener threw: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * One page of a node's events, newest first. The caller has already proven
+     * access to the node; `nodeId` not existing is a 404 here as a backstop.
+     */
+    async list(nodeId, query) {
+        const exists = await this.prisma.workerNode.findUnique({ where: { id: nodeId }, select: { id: true } });
+        if (!exists)
+            throw new common_1.NotFoundException(`Worker node ${nodeId} not found`);
+        const where = {
+            nodeId,
+            ...(query.type !== undefined ? { type: query.type } : {}),
+            ...(query.severity !== undefined ? { severity: query.severity } : {}),
+        };
+        const pageSize = Math.min(Math.max(1, query.pageSize), exports.NODE_EVENTS_MAX_PAGE_SIZE);
+        const page = Math.max(1, query.page);
+        const [total, rows] = await Promise.all([
+            this.prisma.workerNodeEvent.count({ where }),
+            this.prisma.workerNodeEvent.findMany({
+                where,
+                orderBy: [{ receivedAt: 'desc' }, { id: 'desc' }],
+                skip: (page - 1) * pageSize,
+                take: pageSize,
+            }),
+        ]);
+        const items = rows.map((row) => ({
+            id: row.id,
+            nodeId: row.nodeId,
+            type: row.type,
+            severity: row.severity,
+            attrs: (row.attrs ?? {}),
+            occurredAt: row.occurredAt.toISOString(),
+            receivedAt: row.receivedAt.toISOString(),
+        }));
+        return { items, total, page, pageSize, totalPages: Math.max(1, Math.ceil(total / pageSize)) };
+    }
+};
+exports.NodeEventsService = NodeEventsService;
+exports.NodeEventsService = NodeEventsService = NodeEventsService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(index_1.PLATFORM_PRISMA)),
+    __param(1, (0, common_1.Optional)()),
+    __param(2, (0, common_1.Optional)()),
+    __metadata("design:paramtypes", [Object, event_emitter_1.EventEmitter2,
+        index_2.MetricsHostService])
+], NodeEventsService);
+//# sourceMappingURL=node-events.service.js.map

package/dist/nodes/node-events.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-events.service.js","sourceRoot":"","sources":["../../src/nodes/node-events.service.ts"],"names":[],"mappings":"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"}

package/dist/nodes/node-fleet-metrics.service.d.ts

@@ -24,6 +24,15 @@ export interface ExportedVitals {
     slotsUsed?: number;
     slotsTotal?: number;
     uptimeSeconds?: number;
+    /** System-wide host CPU, 0..100. */
+    hostCpuPercent?: number;
+    hostMemoryUsedBytes?: number;
+    hostMemoryTotalBytes?: number;
+    hostMemoryAvailableBytes?: number;
+    hostLoad1?: number;
+    /** 1 on battery, 0 on AC; absent when the source is unknown or unreported. */
+    powerOnBattery?: 0 | 1;
+    powerBatteryPercent?: number;
     counters: Array<{
         counter: string;
         value: number;
@@ -46,7 +55,7 @@ export interface FleetSnapshot {
         value: 0 | 1;
     }> | null;
 }
-type Gauges = Record<'count' | 'cpu' | 'rss' | 'heapUsed' | 'heapLimit' | 'eventLoop' | 'stateFree' | 'stateTotal' | 'slotsUsed' | 'slotsTotal' | 'uptime' | 'counter' | 'noEligibleNode', ObservableGauge>;
+type Gauges = Record<'count' | 'cpu' | 'rss' | 'heapUsed' | 'heapLimit' | 'eventLoop' | 'stateFree' | 'stateTotal' | 'slotsUsed' | 'slotsTotal' | 'uptime' | 'counter' | 'hostCpu' | 'hostMemUsed' | 'hostMemTotal' | 'hostMemAvailable' | 'hostLoad1' | 'onBattery' | 'batteryPercent' | 'noEligibleNode', ObservableGauge>;
 /**
  * A stored `last_vitals` document, read tolerantly field by field (it was
  * validated by `nodeVitalsSchema` on the way in, but a row written by an older

package/dist/nodes/node-fleet-metrics.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-fleet-metrics.service.d.ts","sourceRoot":"","sources":["../../src/nodes/node-fleet-metrics.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"node-fleet-metrics.service.d.ts","sourceRoot":"","sources":["../../src/nodes/node-fleet-metrics.service.ts"],"names":[],"mappings":"AAoFA,OAAO,EAAsB,YAAY,EAAoB,MAAM,gBAAgB,CAAC;AACpF,OAAO,KAAK,EAAE,qBAAqB,EAAS,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAExF,OAAO,EACL,kBAAkB,EAMnB,MAAM,oBAAoB,CAAC;AAE5B,oGAAoG;AACpG,eAAO,MAAM,kBAAkB,QAAS,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAoB,oBAAoB,EAAE,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEnG,kEAAkE;AAClE,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C,yFAAyF;AACzF,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAStC,wEAAwE;AACxE,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWhE,CAAC;AAEF,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,UAAU,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE,KAAK,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,cAAc,CAAA;KAAE,CAAC,CAAC;IAC3E,2DAA2D;IAC3D,cAAc,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;CACjE;AAED,KAAK,MAAM,GAAG,MAAM,CAChB,OAAO,GACP,KAAK,GACL,KAAK,GACL,UAAU,GACV,WAAW,GACX,WAAW,GACX,WAAW,GACX,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,QAAQ,GACR,SAAS,GACT,SAAS,GACT,aAAa,GACb,cAAc,GACd,kBAAkB,GAClB,WAAW,GACX,WAAW,GACX,gBAAgB,GAChB,gBAAgB,EAClB,eAAe,CAChB,CAAC;AAOF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CA4C3D;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAOnD;AAUD,qBACa,gBAAiB,YAAW,YAAY;IAUxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAX1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAE7C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,KAAK,CAAqD;IAClE,OAAO,CAAC,QAAQ,CAA8C;gBAGlB,MAAM,EAAE,UAAU,EAC3C,SAAS,EAAE,oBAAoB,EAC/B,OAAO,EAAE,kBAAkB,EAChC,OAAO,CAAC,EAAE,kBAAkB;IAK1C,YAAY,IAAI,IAAI;IAIpB,yFAAyF;IACzF,cAAc,IAAI,IAAI;IAmBtB,sGAAsG;IACtG,OAAO,CAAC,YAAY;IA2BpB,2FAA2F;IACrF,OAAO,CAAC,MAAM,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+C3E;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;YAyBjC,IAAI;CAqGnB"}

package/dist/nodes/node-fleet-metrics.service.js

@@ -148,7 +148,24 @@ function exportedVitals(raw) {
         if (value !== undefined)
             counters.push({ counter: label, value });
     }
+    const host = v.host && typeof v.host === 'object' && !Array.isArray(v.host) ? v.host : {};
+    const power = v.power && typeof v.power === 'object' && !Array.isArray(v.power) ? v.power : {};
+    const memTotal = num(host.memTotalBytes);
+    const memAvailable = num(host.memAvailableBytes);
+    const memFree = num(host.memFreeBytes);
+    const reclaimable = memAvailable ?? memFree;
+    const batteryPercent = num(power.batteryPercent);
     return {
+        hostCpuPercent: (() => {
+            const value = num(host.cpuPercent);
+            return value === undefined || value > 100 ? undefined : value;
+        })(),
+        hostMemoryUsedBytes: memTotal !== undefined && reclaimable !== undefined && reclaimable <= memTotal ? memTotal - reclaimable : undefined,
+        hostMemoryTotalBytes: memTotal,
+        hostMemoryAvailableBytes: memAvailable,
+        hostLoad1: num(host.loadAvg1),
+        powerOnBattery: power.source === 'battery' ? 1 : power.source === 'ac' ? 0 : undefined,
+        powerBatteryPercent: batteryPercent === undefined || batteryPercent > 100 ? undefined : batteryPercent,
         cpuUtilization: cpu === undefined ? undefined : cpu / 100,
         memoryRssBytes: num(v.rssBytes),
         heapUsedBytes: num(v.heapUsedBytes),
@@ -230,6 +247,13 @@ let NodeFleetMetrics = NodeFleetMetrics_1 = class NodeFleetMetrics {
             slotsTotal: g('nodesSlotsTotal'),
             uptime: g('nodesUptime'),
             counter: g('nodesCounter'),
+            hostCpu: g('nodesHostCpuUtilization'),
+            hostMemUsed: g('nodesHostMemoryUsed'),
+            hostMemTotal: g('nodesHostMemoryTotal'),
+            hostMemAvailable: g('nodesHostMemoryAvailable'),
+            hostLoad1: g('nodesHostLoad1'),
+            onBattery: g('nodesPowerOnBattery'),
+            batteryPercent: g('nodesPowerBatteryPercent'),
             noEligibleNode: g('nodesTypesNoEligibleNode'),
         };
     }
@@ -256,6 +280,13 @@ let NodeFleetMetrics = NodeFleetMetrics_1 = class NodeFleetMetrics {
                     [gauges.slotsUsed, v.slotsUsed],
                     [gauges.slotsTotal, v.slotsTotal],
                     [gauges.uptime, v.uptimeSeconds],
+                    [gauges.hostCpu, v.hostCpuPercent],
+                    [gauges.hostMemUsed, v.hostMemoryUsedBytes],
+                    [gauges.hostMemTotal, v.hostMemoryTotalBytes],
+                    [gauges.hostMemAvailable, v.hostMemoryAvailableBytes],
+                    [gauges.hostLoad1, v.hostLoad1],
+                    [gauges.onBattery, v.powerOnBattery],
+                    [gauges.batteryPercent, v.powerBatteryPercent],
                 ];
                 for (const [gauge, value] of pairs) {
                     if (value !== undefined)