@serve.zone/interfaces 7.25.0 → 7.26.0

package/changelog.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 2026-06-17 - 7.26.0
+
+### Features
+
+- add node service reconciliation and runtime update interfaces (node)
+  - Add serveZoneServiceUpdate as a supported node action and expose serve.zone service runtime status on node runtime data.
+  - Add typed request contracts for reconciling node base services and pushing node runtime updates.
+
 ## 2026-06-16 - 7.25.0
 
 ### Features

package/dist_ts/00_commitinfo_data.js

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

package/dist_ts/data/clusternode.d.ts

@@ -22,7 +22,7 @@ export interface INodeMetricsSample {
     /** Host-level network transmit rate across non-loopback interfaces. */
     networkTxBytesPerSec?: number;
 }
-export type TNodeActionName = 'systemUpgrade' | 'reboot';
+export type TNodeActionName = 'systemUpgrade' | 'reboot' | 'serveZoneServiceUpdate';
 export type TNodeActionStatus = 'pending' | 'running' | 'succeeded' | 'failed';
 /**
  * An operator-requested action executed by spark on a node.
@@ -43,6 +43,19 @@ export interface INodeAction {
     finishedAt?: number;
     resultText?: string;
 }
+export interface IServeZoneServiceRuntimeInfo {
+    name: string;
+    serviceId?: string;
+    image?: string;
+    desiredImage?: string;
+    imageVersion?: string;
+    runningImageId?: string;
+    runningTaskCount?: number;
+    running: boolean;
+    checkedAt: number;
+    updatedAt?: number;
+    error?: string;
+}
 /** Spark -> Cloudly HTTP body for POST /spark/v1/nodes/metrics-sample */
 export interface ISparkMetricsSampleRequest {
     nodeId: string;
@@ -82,6 +95,7 @@ export interface ISparkNodeRuntimeInfo {
     cloudlyConnectionStatus: TSparkCloudlyConnectionStatus;
     dockerAvailable: boolean;
     swarmNodeId?: string;
+    serveZoneServices?: IServeZoneServiceRuntimeInfo[];
     checkedAt: number;
     lastError?: string;
 }

package/dist_ts/requests/node.d.ts

@@ -172,6 +172,19 @@ export interface IReq_Any_Cloudly_GetNodeResourceUsage extends plugins.typedrequ
         timestamp: number;
     };
 }
+export interface IReq_Any_Cloudly_ReconcileNodeBaseServices extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_Cloudly_ReconcileNodeBaseServices> {
+    method: 'reconcileNodeBaseServices';
+    request: {
+        identity: IIdentity;
+        nodeId: string;
+    };
+    response: {
+        nodeId: string;
+        nodeName: string;
+        success: boolean;
+        message?: string;
+    };
+}
 /**
  * Cloudly asks a node's coreflow for live per-deployment resource usage.
  */
@@ -204,3 +217,10 @@ export interface IReq_Cloudly_Any_PushNodeActionUpdate extends plugins.typedrequ
     };
     response: Record<string, never>;
 }
+export interface IReq_Cloudly_Any_PushNodeRuntimeUpdate extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Cloudly_Any_PushNodeRuntimeUpdate> {
+    method: 'pushNodeRuntimeUpdate';
+    request: {
+        node: IClusterNode;
+    };
+    response: Record<string, never>;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serve.zone/interfaces",
-  "version": "7.25.0",
+  "version": "7.26.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.25.0',
+  version: '7.26.0',
   description: 'Shared TypeScript interfaces and TypedRequest contracts for the serve.zone ecosystem.'
 }

package/ts/data/clusternode.ts

@@ -25,7 +25,7 @@ export interface INodeMetricsSample {
   networkTxBytesPerSec?: number;
 }
 
-export type TNodeActionName = 'systemUpgrade' | 'reboot';
+export type TNodeActionName = 'systemUpgrade' | 'reboot' | 'serveZoneServiceUpdate';
 
 export type TNodeActionStatus = 'pending' | 'running' | 'succeeded' | 'failed';
 
@@ -49,6 +49,20 @@ export interface INodeAction {
   resultText?: string;
 }
 
+export interface IServeZoneServiceRuntimeInfo {
+  name: string;
+  serviceId?: string;
+  image?: string;
+  desiredImage?: string;
+  imageVersion?: string;
+  runningImageId?: string;
+  runningTaskCount?: number;
+  running: boolean;
+  checkedAt: number;
+  updatedAt?: number;
+  error?: string;
+}
+
 /** Spark -> Cloudly HTTP body for POST /spark/v1/nodes/metrics-sample */
 export interface ISparkMetricsSampleRequest {
   nodeId: string;
@@ -98,6 +112,7 @@ export interface ISparkNodeRuntimeInfo {
   cloudlyConnectionStatus: TSparkCloudlyConnectionStatus;
   dockerAvailable: boolean;
   swarmNodeId?: string;
+  serveZoneServices?: IServeZoneServiceRuntimeInfo[];
   checkedAt: number;
   lastError?: string;
 }

package/ts/requests/node.ts

@@ -217,6 +217,23 @@ export interface IReq_Any_Cloudly_GetNodeResourceUsage extends plugins.typedrequ
   };
 }
 
+export interface IReq_Any_Cloudly_ReconcileNodeBaseServices extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_Cloudly_ReconcileNodeBaseServices
+> {
+  method: 'reconcileNodeBaseServices';
+  request: {
+    identity: IIdentity;
+    nodeId: string;
+  };
+  response: {
+    nodeId: string;
+    nodeName: string;
+    success: boolean;
+    message?: string;
+  };
+}
+
 /**
  * Cloudly asks a node's coreflow for live per-deployment resource usage.
  */
@@ -260,3 +277,14 @@ export interface IReq_Cloudly_Any_PushNodeActionUpdate extends plugins.typedrequ
   };
   response: Record<string, never>;
 }
+
+export interface IReq_Cloudly_Any_PushNodeRuntimeUpdate extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Cloudly_Any_PushNodeRuntimeUpdate
+> {
+  method: 'pushNodeRuntimeUpdate';
+  request: {
+    node: IClusterNode;
+  };
+  response: Record<string, never>;
+}