@serve.zone/interfaces 7.22.1 → 7.24.0

package/changelog.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 2026-06-12 - 7.24.0
+
+### Features
+
+- add live health status to node resource usage entries (node)
+  - INodeDeploymentResourceUsage gains an optional healthStatus reported by coreflow's in-process health prober.
+
+## 2026-06-12 - 7.23.0
+
+### Features
+
+- add live node resource usage request contracts (node)
+  - getNodeResourceUsage lets the admin UI fetch live per-deployment CPU/memory for one node via Cloudly; coreflowGetNodeResourceUsage is the relayed coreflow request.
+  - INodeDeploymentResourceUsage is keyed by the swarm task id (= IDeployment.id) and reports CPU as percent of the whole node (0-100).
+
 ## 2026-06-12 - 7.22.1
 
 ### Fixes

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@serve.zone/interfaces',
-    version: '7.22.1',
+    version: '7.24.0',
     description: 'Shared TypeScript interfaces and TypedRequest contracts for the serve.zone ecosystem.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSx3QkFBd0I7SUFDOUIsT0FBTyxFQUFFLFFBQVE7SUFDakIsV0FBVyxFQUFFLHVGQUF1RjtDQUNyRyxDQUFBIn0=

package/dist_ts/requests/node.d.ts

@@ -144,6 +144,45 @@ export interface IReq_Any_Cloudly_GetNodeTrafficStats extends plugins.typedreque
         timestamp: number;
     };
 }
+/**
+ * Live resource usage of one deployment on a node. deploymentId is the swarm
+ * task id, which is also IDeployment.id — the join key for UI rows.
+ * cpuUsagePercent is percent of the whole node's CPU capacity (0-100).
+ */
+export interface INodeDeploymentResourceUsage {
+    deploymentId: string;
+    cpuUsagePercent: number;
+    memoryUsedMB: number;
+    /** Live verdict from coreflow's in-process health prober, when available. */
+    healthStatus?: 'healthy' | 'unhealthy' | 'unknown';
+}
+/**
+ * Admin UI asks Cloudly for a node's live per-deployment resource usage;
+ * Cloudly relays to the node's coreflow which samples docker stats.
+ * Polled only while a node detail view is open; not persisted.
+ */
+export interface IReq_Any_Cloudly_GetNodeResourceUsage extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_Cloudly_GetNodeResourceUsage> {
+    method: 'getNodeResourceUsage';
+    request: {
+        identity: IIdentity;
+        nodeId: string;
+    };
+    response: {
+        deployments: INodeDeploymentResourceUsage[];
+        timestamp: number;
+    };
+}
+/**
+ * Cloudly asks a node's coreflow for live per-deployment resource usage.
+ */
+export interface IReq_Cloudly_Coreflow_GetNodeResourceUsage extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Cloudly_Coreflow_GetNodeResourceUsage> {
+    method: 'coreflowGetNodeResourceUsage';
+    request: {};
+    response: {
+        deployments: INodeDeploymentResourceUsage[];
+        timestamp: number;
+    };
+}
 /**
  * Cloudly -> admin UIs: live node metrics relay (1s cadence, not persisted).
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serve.zone/interfaces",
-  "version": "7.22.1",
+  "version": "7.24.0",
   "private": false,
   "description": "Shared TypeScript interfaces and TypedRequest contracts for the serve.zone ecosystem.",
   "exports": {

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@serve.zone/interfaces',
-  version: '7.22.1',
+  version: '7.24.0',
   description: 'Shared TypeScript interfaces and TypedRequest contracts for the serve.zone ecosystem.'
 }

package/ts/requests/node.ts

@@ -184,6 +184,54 @@ export interface IReq_Any_Cloudly_GetNodeTrafficStats extends plugins.typedreque
   };
 }
 
+/**
+ * Live resource usage of one deployment on a node. deploymentId is the swarm
+ * task id, which is also IDeployment.id — the join key for UI rows.
+ * cpuUsagePercent is percent of the whole node's CPU capacity (0-100).
+ */
+export interface INodeDeploymentResourceUsage {
+  deploymentId: string;
+  cpuUsagePercent: number;
+  memoryUsedMB: number;
+  /** Live verdict from coreflow's in-process health prober, when available. */
+  healthStatus?: 'healthy' | 'unhealthy' | 'unknown';
+}
+
+/**
+ * Admin UI asks Cloudly for a node's live per-deployment resource usage;
+ * Cloudly relays to the node's coreflow which samples docker stats.
+ * Polled only while a node detail view is open; not persisted.
+ */
+export interface IReq_Any_Cloudly_GetNodeResourceUsage extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_Cloudly_GetNodeResourceUsage
+> {
+  method: 'getNodeResourceUsage';
+  request: {
+    identity: IIdentity;
+    nodeId: string;
+  };
+  response: {
+    deployments: INodeDeploymentResourceUsage[];
+    timestamp: number;
+  };
+}
+
+/**
+ * Cloudly asks a node's coreflow for live per-deployment resource usage.
+ */
+export interface IReq_Cloudly_Coreflow_GetNodeResourceUsage extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Cloudly_Coreflow_GetNodeResourceUsage
+> {
+  method: 'coreflowGetNodeResourceUsage';
+  request: {};
+  response: {
+    deployments: INodeDeploymentResourceUsage[];
+    timestamp: number;
+  };
+}
+
 /**
  * Cloudly -> admin UIs: live node metrics relay (1s cadence, not persisted).
  */