@serve.zone/interfaces 5.8.0 → 5.10.0

package/changelog.md

@@ -3,6 +3,26 @@
 ## Pending
 
 
+## 2026-05-24 - 5.10.0
+
+### Features
+
+- add Spark node telemetry contracts
+  - Adds Spark runtime status fields to cluster node data
+  - Adds a typed Spark-to-Cloudly heartbeat request contract
+
+### Maintenance
+
+- refresh release tooling dependencies
+
+## 2026-05-23 - 5.9.0
+
+### Features
+
+- add Cloudly deployment runtime and app catalog contracts
+  - Adds live deployment task metadata and workspace operation request contracts
+  - Adds app catalog metadata, installation, and upgrade detection interfaces
+  - Adds node jump command and external image reference contract fields
 
 ## 2026-05-14 - 5.8.0
 

package/dist_ts/00_commitinfo_data.js

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

package/dist_ts/appcatalog/index.d.ts

@@ -0,0 +1 @@
+export * from './types.js';

package/dist_ts/appcatalog/index.js

@@ -0,0 +1,2 @@
+export * from './types.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9hcHBjYXRhbG9nL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsWUFBWSxDQUFDIn0=

package/dist_ts/appcatalog/types.d.ts

@@ -0,0 +1,83 @@
+export type TAppCatalogPlatformRequirement = 'mongodb' | 's3' | 'clickhouse' | 'redis' | 'mariadb';
+export interface IAppCatalogEnvVar {
+    key: string;
+    value?: string;
+    description: string;
+    required?: boolean;
+}
+export interface IAppCatalogVolume {
+    /** Stable Docker volume name. If omitted, the runtime derives one from service name and mount path. */
+    name?: string;
+    /** Alias for name when a volume is shared intentionally across services. */
+    source?: string;
+    /** Container path where the volume is mounted. */
+    mountPath: string;
+    /** Docker volume driver. Defaults to the runtime's persistent volume driver. */
+    driver?: string;
+    readOnly?: boolean;
+    /** Whether backup orchestration should snapshot this volume. Defaults to true. */
+    backup?: boolean;
+    /** Driver-specific options forwarded to the container runtime. */
+    options?: Record<string, string>;
+}
+export type TAppCatalogVolumeSpec = string | IAppCatalogVolume;
+export interface IAppCatalogPublishedPort {
+    targetPort: number;
+    targetPortEnd?: number;
+    publishedPort?: number;
+    publishedPortEnd?: number;
+    protocol?: 'tcp' | 'udp';
+    hostIp?: string;
+}
+export interface ICatalogApp {
+    id: string;
+    name: string;
+    description: string;
+    category: string;
+    iconName?: string;
+    iconUrl?: string;
+    latestVersion: string;
+    tags?: string[];
+}
+export interface ICatalog {
+    schemaVersion: number;
+    updatedAt: string;
+    apps: ICatalogApp[];
+}
+export interface IAppMeta {
+    id: string;
+    name: string;
+    description: string;
+    category: string;
+    iconName?: string;
+    latestVersion: string;
+    versions: string[];
+    maintainer?: string;
+    links?: Record<string, string>;
+}
+export interface IAppVersionConfig {
+    image: string;
+    port: number;
+    envVars?: IAppCatalogEnvVar[];
+    volumes?: TAppCatalogVolumeSpec[];
+    publishedPorts?: IAppCatalogPublishedPort[];
+    platformRequirements?: Partial<Record<TAppCatalogPlatformRequirement, boolean>>;
+    minOneboxVersion?: string;
+    minCloudlyVersion?: string;
+}
+export interface IAppInstallRequest {
+    appId: string;
+    version?: string;
+    serviceName: string;
+    domain?: string;
+    port?: number;
+    publishedPorts?: IAppCatalogPublishedPort[];
+    envVars?: Record<string, string>;
+}
+export interface IUpgradeableAppService {
+    serviceName: string;
+    appTemplateId: string;
+    currentVersion: string;
+    latestVersion: string;
+    hasMigration: boolean;
+}

package/dist_ts/appcatalog/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9hcHBjYXRhbG9nL3R5cGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIifQ==

package/dist_ts/data/clusternode.d.ts

@@ -8,6 +8,24 @@ export interface IClusterNodeMetrics {
     containerCount: number;
     timestamp: number;
 }
+export type TSparkNodeMode = 'cloudly' | 'coreflow-node';
+export type TSparkCloudlyConnectionStatus = 'not-configured' | 'connecting' | 'connected' | 'failed';
+export interface ISparkNodeRuntimeInfo {
+    runtime: 'spark';
+    nodeId: string;
+    mode?: TSparkNodeMode;
+    hostname?: string;
+    platform: string;
+    arch: string;
+    osRelease?: string;
+    sparkVersion: string;
+    cloudlyUrl?: string;
+    cloudlyConnectionStatus: TSparkCloudlyConnectionStatus;
+    dockerAvailable: boolean;
+    swarmNodeId?: string;
+    checkedAt: number;
+    lastError?: string;
+}
 export interface IClusterNode {
     id: string;
     data: {
@@ -43,6 +61,10 @@ export interface IClusterNode {
          * Current metrics for the node
          */
         metrics?: IClusterNodeMetrics;
+        /**
+         * Runtime status reported by the Spark node agent.
+         */
+        sparkRuntimeInfo?: ISparkNodeRuntimeInfo;
         /**
          * Docker swarm node ID if part of swarm
          */

package/dist_ts/data/deployment.d.ts

@@ -4,6 +4,10 @@
  */
 export interface IDeployment {
     id: string;
+    /** Docker Swarm task ID when this deployment represents a live runtime task. */
+    taskId?: string;
+    /** Human-readable service name, useful for live runtime views. */
+    serviceName?: string;
     /**
      * The service being deployed (single service per deployment)
      */
@@ -12,10 +16,18 @@ export interface IDeployment {
      * The node this deployment is running on
      */
     nodeId: string;
+    /** Human-readable node hostname when known. */
+    nodeName?: string;
     /**
      * Docker container ID for this deployment
      */
     containerId?: string;
+    /** Docker service ID when known. */
+    dockerServiceId?: string;
+    /** Docker Swarm task slot when known. */
+    slot?: number;
+    /** Docker desired state for this task/deployment. */
+    desiredState?: string;
     /**
      * Image used for this deployment
      */
@@ -28,6 +40,8 @@ export interface IDeployment {
      * Timestamp when deployed
      */
     deployedAt: number;
+    /** Last runtime update timestamp, if reported by the orchestrator. */
+    updatedAt?: number;
     /**
      * Deployment log entries
      */

package/dist_ts/data/image.d.ts

@@ -7,6 +7,7 @@ export interface IImage {
             internal: boolean;
             externalRegistryId: string;
             externalImageTag: string;
+            externalImageRef?: string;
         };
         description: string;
         versions: Array<{

package/dist_ts/data/service.d.ts

@@ -24,6 +24,8 @@ export interface IService {
         imageVersion: string;
         registryTarget?: IRegistryTarget;
         deployOnPush?: boolean;
+        appTemplateId?: string;
+        appTemplateVersion?: string;
         environment: {
             [key: string]: string;
         };

package/dist_ts/index.d.ts

@@ -1,5 +1,6 @@
 import * as data from './data/index.js';
+import * as appcatalog from './appcatalog/index.js';
 import * as platform from './platform/index.js';
 import * as platformservice from './platformservice/index.js';
 import * as requests from './requests/index.js';
-export { data, platform, platformservice, requests };
+export { appcatalog, data, platform, platformservice, requests };

package/dist_ts/index.js

@@ -1,6 +1,7 @@
 import * as data from './data/index.js';
+import * as appcatalog from './appcatalog/index.js';
 import * as platform from './platform/index.js';
 import * as platformservice from './platformservice/index.js';
 import * as requests from './requests/index.js';
-export { data, platform, platformservice, requests };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssSUFBSSxNQUFNLGlCQUFpQixDQUFDO0FBQ3hDLE9BQU8sS0FBSyxRQUFRLE1BQU0scUJBQXFCLENBQUM7QUFDaEQsT0FBTyxLQUFLLGVBQWUsTUFBTSw0QkFBNEIsQ0FBQztBQUM5RCxPQUFPLEtBQUssUUFBUSxNQUFNLHFCQUFxQixDQUFDO0FBRWhELE9BQU8sRUFDTCxJQUFJLEVBQ0osUUFBUSxFQUNSLGVBQWUsRUFDZixRQUFRLEVBQ1QsQ0FBQSJ9
+export { appcatalog, data, platform, platformservice, requests };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssSUFBSSxNQUFNLGlCQUFpQixDQUFDO0FBQ3hDLE9BQU8sS0FBSyxVQUFVLE1BQU0sdUJBQXVCLENBQUM7QUFDcEQsT0FBTyxLQUFLLFFBQVEsTUFBTSxxQkFBcUIsQ0FBQztBQUNoRCxPQUFPLEtBQUssZUFBZSxNQUFNLDRCQUE0QixDQUFDO0FBQzlELE9BQU8sS0FBSyxRQUFRLE1BQU0scUJBQXFCLENBQUM7QUFFaEQsT0FBTyxFQUNMLFVBQVUsRUFDVixJQUFJLEVBQ0osUUFBUSxFQUNSLGVBQWUsRUFDZixRQUFRLEVBQ1QsQ0FBQSJ9

package/dist_ts/requests/appcatalog.d.ts

@@ -0,0 +1,44 @@
+import * as plugins from '../plugins.js';
+import type { IIdentity } from '../data/user.js';
+import type { IService } from '../data/service.js';
+import type { IAppInstallRequest, IAppMeta, IAppVersionConfig, ICatalogApp, IUpgradeableAppService } from '../appcatalog/index.js';
+export interface IReq_Any_GetAppCatalogTemplates extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_GetAppCatalogTemplates> {
+    method: 'getAppCatalogTemplates';
+    request: {
+        identity: IIdentity;
+    };
+    response: {
+        apps: ICatalogApp[];
+    };
+}
+export interface IReq_Any_GetAppCatalogConfig extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_GetAppCatalogConfig> {
+    method: 'getAppCatalogConfig';
+    request: {
+        identity: IIdentity;
+        appId: string;
+        version: string;
+    };
+    response: {
+        config: IAppVersionConfig;
+        appMeta: IAppMeta;
+    };
+}
+export interface IReq_Any_InstallAppCatalogApp extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_InstallAppCatalogApp> {
+    method: 'installAppCatalogApp';
+    request: {
+        identity: IIdentity;
+        install: IAppInstallRequest;
+    };
+    response: {
+        service: IService;
+    };
+}
+export interface IReq_Any_GetUpgradeableAppCatalogServices extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_GetUpgradeableAppCatalogServices> {
+    method: 'getUpgradeableAppCatalogServices';
+    request: {
+        identity: IIdentity;
+    };
+    response: {
+        services: IUpgradeableAppService[];
+    };
+}

package/dist_ts/requests/appcatalog.js

@@ -0,0 +1,2 @@
+import * as plugins from '../plugins.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBwY2F0YWxvZy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL3JlcXVlc3RzL2FwcGNhdGFsb2cudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxlQUFlLENBQUMifQ==

package/dist_ts/requests/deployment.d.ts

@@ -1,6 +1,12 @@
 import * as plugins from '../plugins.js';
 import type { IDeployment } from '../data/deployment.js';
+import type { IService } from '../data/service.js';
 import type { IIdentity } from '../data/user.js';
+export interface IDeploymentWorkspaceFileEntry {
+    type: 'file' | 'directory';
+    name: string;
+    path: string;
+}
 export interface IReq_Any_Cloudly_GetDeploymentById extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_Cloudly_GetDeploymentById> {
     method: 'getDeploymentById';
     request: {
@@ -94,3 +100,198 @@ export interface IReq_Any_Cloudly_ScaleDeployment extends plugins.typedrequestIn
         deployment: IDeployment;
     };
 }
+export interface IReq_Any_Cloudly_KillDeployment extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_Cloudly_KillDeployment> {
+    method: 'killDeployment';
+    request: {
+        identity: IIdentity;
+        deploymentId: string;
+    };
+    response: {
+        success: boolean;
+        deployment: IDeployment;
+    };
+}
+export interface IReq_Any_Cloudly_DeploymentWorkspaceReadFile extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_Cloudly_DeploymentWorkspaceReadFile> {
+    method: 'deploymentWorkspaceReadFile';
+    request: {
+        identity: IIdentity;
+        deploymentId: string;
+        path: string;
+    };
+    response: {
+        content: string;
+    };
+}
+export interface IReq_Any_Cloudly_DeploymentWorkspaceWriteFile extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_Cloudly_DeploymentWorkspaceWriteFile> {
+    method: 'deploymentWorkspaceWriteFile';
+    request: {
+        identity: IIdentity;
+        deploymentId: string;
+        path: string;
+        content: string;
+    };
+    response: Record<string, never>;
+}
+export interface IReq_Any_Cloudly_DeploymentWorkspaceReadDir extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_Cloudly_DeploymentWorkspaceReadDir> {
+    method: 'deploymentWorkspaceReadDir';
+    request: {
+        identity: IIdentity;
+        deploymentId: string;
+        path: string;
+    };
+    response: {
+        entries: IDeploymentWorkspaceFileEntry[];
+    };
+}
+export interface IReq_Any_Cloudly_DeploymentWorkspaceMkdir extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_Cloudly_DeploymentWorkspaceMkdir> {
+    method: 'deploymentWorkspaceMkdir';
+    request: {
+        identity: IIdentity;
+        deploymentId: string;
+        path: string;
+    };
+    response: Record<string, never>;
+}
+export interface IReq_Any_Cloudly_DeploymentWorkspaceRm extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_Cloudly_DeploymentWorkspaceRm> {
+    method: 'deploymentWorkspaceRm';
+    request: {
+        identity: IIdentity;
+        deploymentId: string;
+        path: string;
+        recursive?: boolean;
+    };
+    response: Record<string, never>;
+}
+export interface IReq_Any_Cloudly_DeploymentWorkspaceExists extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_Cloudly_DeploymentWorkspaceExists> {
+    method: 'deploymentWorkspaceExists';
+    request: {
+        identity: IIdentity;
+        deploymentId: string;
+        path: string;
+    };
+    response: {
+        exists: boolean;
+    };
+}
+export interface IReq_Any_Cloudly_DeploymentWorkspaceExec extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_Cloudly_DeploymentWorkspaceExec> {
+    method: 'deploymentWorkspaceExec';
+    request: {
+        identity: IIdentity;
+        deploymentId: string;
+        command: string;
+        args?: string[];
+    };
+    response: {
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+    };
+}
+export interface IReq_Cloudly_Coreflow_GetServiceDeployments extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Cloudly_Coreflow_GetServiceDeployments> {
+    method: 'coreflowGetServiceDeployments';
+    request: {
+        service: IService;
+    };
+    response: {
+        deployments: IDeployment[];
+    };
+}
+export interface IReq_Cloudly_Coreflow_RestartDeployment extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Cloudly_Coreflow_RestartDeployment> {
+    method: 'coreflowRestartDeployment';
+    request: {
+        deploymentId: string;
+    };
+    response: {
+        found: boolean;
+        deployment?: IDeployment;
+    };
+}
+export interface IReq_Cloudly_Coreflow_KillDeployment extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Cloudly_Coreflow_KillDeployment> {
+    method: 'coreflowKillDeployment';
+    request: {
+        deploymentId: string;
+    };
+    response: {
+        found: boolean;
+        deployment?: IDeployment;
+    };
+}
+export interface IReq_Cloudly_Coreflow_DeploymentWorkspaceReadFile extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Cloudly_Coreflow_DeploymentWorkspaceReadFile> {
+    method: 'coreflowDeploymentWorkspaceReadFile';
+    request: {
+        deploymentId: string;
+        path: string;
+    };
+    response: {
+        found: boolean;
+        content?: string;
+    };
+}
+export interface IReq_Cloudly_Coreflow_DeploymentWorkspaceWriteFile extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Cloudly_Coreflow_DeploymentWorkspaceWriteFile> {
+    method: 'coreflowDeploymentWorkspaceWriteFile';
+    request: {
+        deploymentId: string;
+        path: string;
+        content: string;
+    };
+    response: {
+        found: boolean;
+    };
+}
+export interface IReq_Cloudly_Coreflow_DeploymentWorkspaceReadDir extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Cloudly_Coreflow_DeploymentWorkspaceReadDir> {
+    method: 'coreflowDeploymentWorkspaceReadDir';
+    request: {
+        deploymentId: string;
+        path: string;
+    };
+    response: {
+        found: boolean;
+        entries?: IDeploymentWorkspaceFileEntry[];
+    };
+}
+export interface IReq_Cloudly_Coreflow_DeploymentWorkspaceMkdir extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Cloudly_Coreflow_DeploymentWorkspaceMkdir> {
+    method: 'coreflowDeploymentWorkspaceMkdir';
+    request: {
+        deploymentId: string;
+        path: string;
+    };
+    response: {
+        found: boolean;
+    };
+}
+export interface IReq_Cloudly_Coreflow_DeploymentWorkspaceRm extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Cloudly_Coreflow_DeploymentWorkspaceRm> {
+    method: 'coreflowDeploymentWorkspaceRm';
+    request: {
+        deploymentId: string;
+        path: string;
+        recursive?: boolean;
+    };
+    response: {
+        found: boolean;
+    };
+}
+export interface IReq_Cloudly_Coreflow_DeploymentWorkspaceExists extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Cloudly_Coreflow_DeploymentWorkspaceExists> {
+    method: 'coreflowDeploymentWorkspaceExists';
+    request: {
+        deploymentId: string;
+        path: string;
+    };
+    response: {
+        found: boolean;
+        exists?: boolean;
+    };
+}
+export interface IReq_Cloudly_Coreflow_DeploymentWorkspaceExec extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Cloudly_Coreflow_DeploymentWorkspaceExec> {
+    method: 'coreflowDeploymentWorkspaceExec';
+    request: {
+        deploymentId: string;
+        command: string;
+        args?: string[];
+    };
+    response: {
+        found: boolean;
+        stdout?: string;
+        stderr?: string;
+        exitCode?: number;
+    };
+}

package/dist_ts/requests/index.d.ts

@@ -1,4 +1,5 @@
 import * as adminRequests from './admin.js';
+import * as appCatalogRequests from './appcatalog.js';
 import * as baremetalRequests from './baremetal.js';
 import * as baseOsRequests from './baseos.js';
 import * as backupRequests from './backup.js';
@@ -25,5 +26,5 @@ import * as settingsRequests from './settings.js';
 import * as statusRequests from './status.js';
 import * as taskRequests from './task.js';
 import * as versionRequests from './version.js';
-export { adminRequests as admin, baremetalRequests as baremetal, baseOsRequests as baseos, backupRequests as backup, certificateRequests as certificate, clusterRequests as cluster, configRequests as config, deploymentRequests as deployment, dnsRequests as dns, domainRequests as domain, externalRegistryRequests as externalRegistry, identityRequests as identity, imageRequests as image, informRequests as inform, logRequests as log, networkRequests as network, nodeRequests as node, platformRequests as platform, routingRequests as routing, secretBundleRequests as secretbundle, secretGroupRequests as secretgroup, serverRequests as server, serviceRequests as service, settingsRequests as settings, statusRequests as status, taskRequests as task, versionRequests as version, };
+export { adminRequests as admin, appCatalogRequests as appcatalog, baremetalRequests as baremetal, baseOsRequests as baseos, backupRequests as backup, certificateRequests as certificate, clusterRequests as cluster, configRequests as config, deploymentRequests as deployment, dnsRequests as dns, domainRequests as domain, externalRegistryRequests as externalRegistry, identityRequests as identity, imageRequests as image, informRequests as inform, logRequests as log, networkRequests as network, nodeRequests as node, platformRequests as platform, routingRequests as routing, secretBundleRequests as secretbundle, secretGroupRequests as secretgroup, serverRequests as server, serviceRequests as service, settingsRequests as settings, statusRequests as status, taskRequests as task, versionRequests as version, };
 export * from './inform.js';

package/dist_ts/requests/index.js

@@ -1,5 +1,6 @@
 import * as plugins from '../plugins.js';
 import * as adminRequests from './admin.js';
+import * as appCatalogRequests from './appcatalog.js';
 import * as baremetalRequests from './baremetal.js';
 import * as baseOsRequests from './baseos.js';
 import * as backupRequests from './backup.js';
@@ -26,6 +27,6 @@ import * as settingsRequests from './settings.js';
 import * as statusRequests from './status.js';
 import * as taskRequests from './task.js';
 import * as versionRequests from './version.js';
-export { adminRequests as admin, baremetalRequests as baremetal, baseOsRequests as baseos, backupRequests as backup, certificateRequests as certificate, clusterRequests as cluster, configRequests as config, deploymentRequests as deployment, dnsRequests as dns, domainRequests as domain, externalRegistryRequests as externalRegistry, identityRequests as identity, imageRequests as image, informRequests as inform, logRequests as log, networkRequests as network, nodeRequests as node, platformRequests as platform, routingRequests as routing, secretBundleRequests as secretbundle, secretGroupRequests as secretgroup, serverRequests as server, serviceRequests as service, settingsRequests as settings, statusRequests as status, taskRequests as task, versionRequests as version, };
+export { adminRequests as admin, appCatalogRequests as appcatalog, baremetalRequests as baremetal, baseOsRequests as baseos, backupRequests as backup, certificateRequests as certificate, clusterRequests as cluster, configRequests as config, deploymentRequests as deployment, dnsRequests as dns, domainRequests as domain, externalRegistryRequests as externalRegistry, identityRequests as identity, imageRequests as image, informRequests as inform, logRequests as log, networkRequests as network, nodeRequests as node, platformRequests as platform, routingRequests as routing, secretBundleRequests as secretbundle, secretGroupRequests as secretgroup, serverRequests as server, serviceRequests as service, settingsRequests as settings, statusRequests as status, taskRequests as task, versionRequests as version, };
 export * from './inform.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9yZXF1ZXN0cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGVBQWUsQ0FBQztBQUV6QyxPQUFPLEtBQUssYUFBYSxNQUFNLFlBQVksQ0FBQztBQUM1QyxPQUFPLEtBQUssaUJBQWlCLE1BQU0sZ0JBQWdCLENBQUM7QUFDcEQsT0FBTyxLQUFLLGNBQWMsTUFBTSxhQUFhLENBQUM7QUFDOUMsT0FBTyxLQUFLLGNBQWMsTUFBTSxhQUFhLENBQUM7QUFDOUMsT0FBTyxLQUFLLG1CQUFtQixNQUFNLGtCQUFrQixDQUFDO0FBQ3hELE9BQU8sS0FBSyxlQUFlLE1BQU0sY0FBYyxDQUFDO0FBQ2hELE9BQU8sS0FBSyxjQUFjLE1BQU0sYUFBYSxDQUFDO0FBQzlDLE9BQU8sS0FBSyxrQkFBa0IsTUFBTSxpQkFBaUIsQ0FBQztBQUN0RCxPQUFPLEtBQUssV0FBVyxNQUFNLFVBQVUsQ0FBQztBQUN4QyxPQUFPLEtBQUssY0FBYyxNQUFNLGFBQWEsQ0FBQztBQUM5QyxPQUFPLEtBQUssd0JBQXdCLE1BQU0sdUJBQXVCLENBQUM7QUFDbEUsT0FBTyxLQUFLLGdCQUFnQixNQUFNLGVBQWUsQ0FBQztBQUNsRCxPQUFPLEtBQUssYUFBYSxNQUFNLFlBQVksQ0FBQztBQUM1QyxPQUFPLEtBQUssY0FBYyxNQUFNLGFBQWEsQ0FBQztBQUM5QyxPQUFPLEtBQUssV0FBVyxNQUFNLFVBQVUsQ0FBQztBQUN4QyxPQUFPLEtBQUssZUFBZSxNQUFNLGNBQWMsQ0FBQztBQUNoRCxPQUFPLEtBQUssWUFBWSxNQUFNLFdBQVcsQ0FBQztBQUMxQyxPQUFPLEtBQUssZ0JBQWdCLE1BQU0sZUFBZSxDQUFDO0FBQ2xELE9BQU8sS0FBSyxlQUFlLE1BQU0sY0FBYyxDQUFDO0FBQ2hELE9BQU8sS0FBSyxvQkFBb0IsTUFBTSxtQkFBbUIsQ0FBQztBQUMxRCxPQUFPLEtBQUssbUJBQW1CLE1BQU0sa0JBQWtCLENBQUM7QUFDeEQsT0FBTyxLQUFLLGNBQWMsTUFBTSxhQUFhLENBQUM7QUFDOUMsT0FBTyxLQUFLLGVBQWUsTUFBTSxjQUFjLENBQUM7QUFDaEQsT0FBTyxLQUFLLGdCQUFnQixNQUFNLGVBQWUsQ0FBQztBQUNsRCxPQUFPLEtBQUssY0FBYyxNQUFNLGFBQWEsQ0FBQztBQUM5QyxPQUFPLEtBQUssWUFBWSxNQUFNLFdBQVcsQ0FBQztBQUMxQyxPQUFPLEtBQUssZUFBZSxNQUFNLGNBQWMsQ0FBQztBQUVoRCxPQUFPLEVBQ0wsYUFBYSxJQUFJLEtBQUssRUFDdEIsaUJBQWlCLElBQUksU0FBUyxFQUM5QixjQUFjLElBQUksTUFBTSxFQUN4QixjQUFjLElBQUksTUFBTSxFQUN4QixtQkFBbUIsSUFBSSxXQUFXLEVBQ2xDLGVBQWUsSUFBSSxPQUFPLEVBQzFCLGNBQWMsSUFBSSxNQUFNLEVBQ3hCLGtCQUFrQixJQUFJLFVBQVUsRUFDaEMsV0FBVyxJQUFJLEdBQUcsRUFDbEIsY0FBYyxJQUFJLE1BQU0sRUFDeEIsd0JBQXdCLElBQUksZ0JBQWdCLEVBQzVDLGdCQUFnQixJQUFJLFFBQVEsRUFDNUIsYUFBYSxJQUFJLEtBQUssRUFDdEIsY0FBYyxJQUFJLE1BQU0sRUFDeEIsV0FBVyxJQUFJLEdBQUcsRUFDbEIsZUFBZSxJQUFJLE9BQU8sRUFDMUIsWUFBWSxJQUFJLElBQUksRUFDcEIsZ0JBQWdCLElBQUksUUFBUSxFQUM1QixlQUFlLElBQUksT0FBTyxFQUMxQixvQkFBb0IsSUFBSSxZQUFZLEVBQ3BDLG1CQUFtQixJQUFJLFdBQVcsRUFDbEMsY0FBYyxJQUFJLE1BQU0sRUFDeEIsZUFBZSxJQUFJLE9BQU8sRUFDMUIsZ0JBQWdCLElBQUksUUFBUSxFQUM1QixjQUFjLElBQUksTUFBTSxFQUN4QixZQUFZLElBQUksSUFBSSxFQUNwQixlQUFlLElBQUksT0FBTyxHQUMzQixDQUFDO0FBRUYsY0FBYyxhQUFhLENBQUMifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9yZXF1ZXN0cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGVBQWUsQ0FBQztBQUV6QyxPQUFPLEtBQUssYUFBYSxNQUFNLFlBQVksQ0FBQztBQUM1QyxPQUFPLEtBQUssa0JBQWtCLE1BQU0saUJBQWlCLENBQUM7QUFDdEQsT0FBTyxLQUFLLGlCQUFpQixNQUFNLGdCQUFnQixDQUFDO0FBQ3BELE9BQU8sS0FBSyxjQUFjLE1BQU0sYUFBYSxDQUFDO0FBQzlDLE9BQU8sS0FBSyxjQUFjLE1BQU0sYUFBYSxDQUFDO0FBQzlDLE9BQU8sS0FBSyxtQkFBbUIsTUFBTSxrQkFBa0IsQ0FBQztBQUN4RCxPQUFPLEtBQUssZUFBZSxNQUFNLGNBQWMsQ0FBQztBQUNoRCxPQUFPLEtBQUssY0FBYyxNQUFNLGFBQWEsQ0FBQztBQUM5QyxPQUFPLEtBQUssa0JBQWtCLE1BQU0saUJBQWlCLENBQUM7QUFDdEQsT0FBTyxLQUFLLFdBQVcsTUFBTSxVQUFVLENBQUM7QUFDeEMsT0FBTyxLQUFLLGNBQWMsTUFBTSxhQUFhLENBQUM7QUFDOUMsT0FBTyxLQUFLLHdCQUF3QixNQUFNLHVCQUF1QixDQUFDO0FBQ2xFLE9BQU8sS0FBSyxnQkFBZ0IsTUFBTSxlQUFlLENBQUM7QUFDbEQsT0FBTyxLQUFLLGFBQWEsTUFBTSxZQUFZLENBQUM7QUFDNUMsT0FBTyxLQUFLLGNBQWMsTUFBTSxhQUFhLENBQUM7QUFDOUMsT0FBTyxLQUFLLFdBQVcsTUFBTSxVQUFVLENBQUM7QUFDeEMsT0FBTyxLQUFLLGVBQWUsTUFBTSxjQUFjLENBQUM7QUFDaEQsT0FBTyxLQUFLLFlBQVksTUFBTSxXQUFXLENBQUM7QUFDMUMsT0FBTyxLQUFLLGdCQUFnQixNQUFNLGVBQWUsQ0FBQztBQUNsRCxPQUFPLEtBQUssZUFBZSxNQUFNLGNBQWMsQ0FBQztBQUNoRCxPQUFPLEtBQUssb0JBQW9CLE1BQU0sbUJBQW1CLENBQUM7QUFDMUQsT0FBTyxLQUFLLG1CQUFtQixNQUFNLGtCQUFrQixDQUFDO0FBQ3hELE9BQU8sS0FBSyxjQUFjLE1BQU0sYUFBYSxDQUFDO0FBQzlDLE9BQU8sS0FBSyxlQUFlLE1BQU0sY0FBYyxDQUFDO0FBQ2hELE9BQU8sS0FBSyxnQkFBZ0IsTUFBTSxlQUFlLENBQUM7QUFDbEQsT0FBTyxLQUFLLGNBQWMsTUFBTSxhQUFhLENBQUM7QUFDOUMsT0FBTyxLQUFLLFlBQVksTUFBTSxXQUFXLENBQUM7QUFDMUMsT0FBTyxLQUFLLGVBQWUsTUFBTSxjQUFjLENBQUM7QUFFaEQsT0FBTyxFQUNMLGFBQWEsSUFBSSxLQUFLLEVBQ3RCLGtCQUFrQixJQUFJLFVBQVUsRUFDaEMsaUJBQWlCLElBQUksU0FBUyxFQUM5QixjQUFjLElBQUksTUFBTSxFQUN4QixjQUFjLElBQUksTUFBTSxFQUN4QixtQkFBbUIsSUFBSSxXQUFXLEVBQ2xDLGVBQWUsSUFBSSxPQUFPLEVBQzFCLGNBQWMsSUFBSSxNQUFNLEVBQ3hCLGtCQUFrQixJQUFJLFVBQVUsRUFDaEMsV0FBVyxJQUFJLEdBQUcsRUFDbEIsY0FBYyxJQUFJLE1BQU0sRUFDeEIsd0JBQXdCLElBQUksZ0JBQWdCLEVBQzVDLGdCQUFnQixJQUFJLFFBQVEsRUFDNUIsYUFBYSxJQUFJLEtBQUssRUFDdEIsY0FBYyxJQUFJLE1BQU0sRUFDeEIsV0FBVyxJQUFJLEdBQUcsRUFDbEIsZUFBZSxJQUFJLE9BQU8sRUFDMUIsWUFBWSxJQUFJLElBQUksRUFDcEIsZ0JBQWdCLElBQUksUUFBUSxFQUM1QixlQUFlLElBQUksT0FBTyxFQUMxQixvQkFBb0IsSUFBSSxZQUFZLEVBQ3BDLG1CQUFtQixJQUFJLFdBQVcsRUFDbEMsY0FBYyxJQUFJLE1BQU0sRUFDeEIsZUFBZSxJQUFJLE9BQU8sRUFDMUIsZ0JBQWdCLElBQUksUUFBUSxFQUM1QixjQUFjLElBQUksTUFBTSxFQUN4QixZQUFZLElBQUksSUFBSSxFQUNwQixlQUFlLElBQUksT0FBTyxHQUMzQixDQUFDO0FBRUYsY0FBYyxhQUFhLENBQUMifQ==

package/dist_ts/requests/node.d.ts

@@ -1,5 +1,7 @@
-import type { IClusterNode } from '../data/clusternode.js';
+import * as plugins from '../plugins.js';
+import type { IClusterNode, IClusterNodeMetrics, ISparkNodeRuntimeInfo } from '../data/clusternode.js';
 import type { IDeployment } from '../data/deployment.js';
+import type { IIdentity } from '../data/user.js';
 export interface IRequest_Any_Cloudly_GetNodeConfig {
     method: 'getNodeConfig';
     request: {
@@ -27,3 +29,33 @@ export interface IRequest_Any_Cloudly_GetNodeDeployments {
         deployments: IDeployment[];
     };
 }
+export interface IReq_Any_Cloudly_CreateNodeJumpCommand extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_Cloudly_CreateNodeJumpCommand> {
+    method: 'createNodeJumpCommand';
+    request: {
+        identity: IIdentity;
+        clusterId: string;
+        role?: IClusterNode['data']['role'];
+        nodeType?: IClusterNode['data']['nodeType'];
+        ttlMs?: number;
+    };
+    response: {
+        jumpCode: string;
+        jumpUrl: string;
+        setupUrl: string;
+        command: string;
+        expiresAt: number;
+    };
+}
+export interface IRequest_Spark_Cloudly_SendHeartbeat extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IRequest_Spark_Cloudly_SendHeartbeat> {
+    method: 'sparkNodeHeartbeat';
+    request: {
+        nodeId: string;
+        nodeToken: string;
+        metrics: IClusterNodeMetrics;
+        runtimeInfo: ISparkNodeRuntimeInfo;
+    };
+    response: {
+        accepted: boolean;
+        message?: string;
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serve.zone/interfaces",
-  "version": "5.8.0",
+  "version": "5.10.0",
   "private": false,
   "description": "Shared TypeScript interfaces and TypedRequest contracts for the serve.zone ecosystem.",
   "exports": {
@@ -15,11 +15,11 @@
     "@tsclass/tsclass": "^9.5.1"
   },
   "devDependencies": {
-    "@git.zone/tsbuild": "^4.4.0",
-    "@git.zone/tsdoc": "^2.0.3",
-    "@git.zone/tsrun": "^2.0.3",
-    "@git.zone/tstest": "^3.6.3",
-    "@types/node": "^25.6.1"
+    "@git.zone/tsbuild": "^4.4.2",
+    "@git.zone/tsdoc": "^2.0.6",
+    "@git.zone/tsrun": "^2.0.4",
+    "@git.zone/tstest": "^3.6.6",
+    "@types/node": "^25.8.0"
   },
   "files": [
     "ts/**/*",

package/ts/00_commitinfo_data.ts

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

package/ts/appcatalog/index.ts

@@ -0,0 +1 @@
+export * from './types.js';

package/ts/appcatalog/types.ts

@@ -0,0 +1,93 @@
+export type TAppCatalogPlatformRequirement = 'mongodb' | 's3' | 'clickhouse' | 'redis' | 'mariadb';
+
+export interface IAppCatalogEnvVar {
+  key: string;
+  value?: string;
+  description: string;
+  required?: boolean;
+}
+
+export interface IAppCatalogVolume {
+  /** Stable Docker volume name. If omitted, the runtime derives one from service name and mount path. */
+  name?: string;
+  /** Alias for name when a volume is shared intentionally across services. */
+  source?: string;
+  /** Container path where the volume is mounted. */
+  mountPath: string;
+  /** Docker volume driver. Defaults to the runtime's persistent volume driver. */
+  driver?: string;
+  readOnly?: boolean;
+  /** Whether backup orchestration should snapshot this volume. Defaults to true. */
+  backup?: boolean;
+  /** Driver-specific options forwarded to the container runtime. */
+  options?: Record<string, string>;
+}
+
+export type TAppCatalogVolumeSpec = string | IAppCatalogVolume;
+
+export interface IAppCatalogPublishedPort {
+  targetPort: number;
+  targetPortEnd?: number;
+  publishedPort?: number;
+  publishedPortEnd?: number;
+  protocol?: 'tcp' | 'udp';
+  hostIp?: string;
+}
+
+export interface ICatalogApp {
+  id: string;
+  name: string;
+  description: string;
+  category: string;
+  iconName?: string;
+  iconUrl?: string;
+  latestVersion: string;
+  tags?: string[];
+}
+
+export interface ICatalog {
+  schemaVersion: number;
+  updatedAt: string;
+  apps: ICatalogApp[];
+}
+
+export interface IAppMeta {
+  id: string;
+  name: string;
+  description: string;
+  category: string;
+  iconName?: string;
+  latestVersion: string;
+  versions: string[];
+  maintainer?: string;
+  links?: Record<string, string>;
+}
+
+export interface IAppVersionConfig {
+  image: string;
+  port: number;
+  envVars?: IAppCatalogEnvVar[];
+  volumes?: TAppCatalogVolumeSpec[];
+  publishedPorts?: IAppCatalogPublishedPort[];
+  platformRequirements?: Partial<Record<TAppCatalogPlatformRequirement, boolean>>;
+  minOneboxVersion?: string;
+  minCloudlyVersion?: string;
+}
+
+export interface IAppInstallRequest {
+  appId: string;
+  version?: string;
+  serviceName: string;
+  domain?: string;
+  port?: number;
+  publishedPorts?: IAppCatalogPublishedPort[];
+  envVars?: Record<string, string>;
+}
+
+export interface IUpgradeableAppService {
+  serviceName: string;
+  appTemplateId: string;
+  currentVersion: string;
+  latestVersion: string;
+  hasMigration: boolean;
+}

package/ts/data/clusternode.ts

@@ -10,6 +10,31 @@ export interface IClusterNodeMetrics {
   timestamp: number;
 }
 
+export type TSparkNodeMode = 'cloudly' | 'coreflow-node';
+
+export type TSparkCloudlyConnectionStatus =
+  | 'not-configured'
+  | 'connecting'
+  | 'connected'
+  | 'failed';
+
+export interface ISparkNodeRuntimeInfo {
+  runtime: 'spark';
+  nodeId: string;
+  mode?: TSparkNodeMode;
+  hostname?: string;
+  platform: string;
+  arch: string;
+  osRelease?: string;
+  sparkVersion: string;
+  cloudlyUrl?: string;
+  cloudlyConnectionStatus: TSparkCloudlyConnectionStatus;
+  dockerAvailable: boolean;
+  swarmNodeId?: string;
+  checkedAt: number;
+  lastError?: string;
+}
+
 export interface IClusterNode {
   id: string;
   data: {
@@ -52,6 +77,11 @@ export interface IClusterNode {
      * Current metrics for the node
      */
     metrics?: IClusterNodeMetrics;
+
+    /**
+     * Runtime status reported by the Spark node agent.
+     */
+    sparkRuntimeInfo?: ISparkNodeRuntimeInfo;
     
     /**
      * Docker swarm node ID if part of swarm
@@ -68,4 +98,4 @@ export interface IClusterNode {
      */
     requiredDebianPackages: string[];
   };
-}
+}

package/ts/data/deployment.ts

@@ -6,6 +6,12 @@ import * as plugins from '../plugins.js';
  */
 export interface IDeployment {
   id: string;
+
+  /** Docker Swarm task ID when this deployment represents a live runtime task. */
+  taskId?: string;
+
+  /** Human-readable service name, useful for live runtime views. */
+  serviceName?: string;
   
   /**
    * The service being deployed (single service per deployment)
@@ -16,11 +22,23 @@ export interface IDeployment {
    * The node this deployment is running on
    */
   nodeId: string;
+
+  /** Human-readable node hostname when known. */
+  nodeName?: string;
   
   /**
    * Docker container ID for this deployment
    */
   containerId?: string;
+
+  /** Docker service ID when known. */
+  dockerServiceId?: string;
+
+  /** Docker Swarm task slot when known. */
+  slot?: number;
+
+  /** Docker desired state for this task/deployment. */
+  desiredState?: string;
   
   /**
    * Image used for this deployment
@@ -36,6 +54,9 @@ export interface IDeployment {
    * Timestamp when deployed
    */
   deployedAt: number;
+
+  /** Last runtime update timestamp, if reported by the orchestrator. */
+  updatedAt?: number;
   
   /**
    * Deployment log entries
@@ -60,4 +81,4 @@ export interface IDeployment {
     memoryUsedMB: number;
     lastUpdated: number;
   };
-}
+}

package/ts/data/image.ts

@@ -9,6 +9,7 @@ export interface IImage {
       internal: boolean;
       externalRegistryId: string;
       externalImageTag: string;
+      externalImageRef?: string;
     }
     description: string;
     versions: Array<{

package/ts/data/service.ts

@@ -26,6 +26,8 @@ export interface IService {
     imageVersion: string;
     registryTarget?: IRegistryTarget;
     deployOnPush?: boolean;
+    appTemplateId?: string;
+    appTemplateVersion?: string;
     environment: { [key: string]: string };
     /**
      * the main secret bundle id, exclusive to the service

package/ts/index.ts

@@ -1,9 +1,11 @@
 import * as data from './data/index.js';
+import * as appcatalog from './appcatalog/index.js';
 import * as platform from './platform/index.js';
 import * as platformservice from './platformservice/index.js';
 import * as requests from './requests/index.js';
 
 export {
+  appcatalog,
   data,
   platform,
   platformservice,

package/ts/requests/appcatalog.ts

@@ -0,0 +1,66 @@
+import * as plugins from '../plugins.js';
+import type { IIdentity } from '../data/user.js';
+import type { IService } from '../data/service.js';
+import type {
+  IAppInstallRequest,
+  IAppMeta,
+  IAppVersionConfig,
+  ICatalogApp,
+  IUpgradeableAppService,
+} from '../appcatalog/index.js';
+
+export interface IReq_Any_GetAppCatalogTemplates extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_GetAppCatalogTemplates
+> {
+  method: 'getAppCatalogTemplates';
+  request: {
+    identity: IIdentity;
+  };
+  response: {
+    apps: ICatalogApp[];
+  };
+}
+
+export interface IReq_Any_GetAppCatalogConfig extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_GetAppCatalogConfig
+> {
+  method: 'getAppCatalogConfig';
+  request: {
+    identity: IIdentity;
+    appId: string;
+    version: string;
+  };
+  response: {
+    config: IAppVersionConfig;
+    appMeta: IAppMeta;
+  };
+}
+
+export interface IReq_Any_InstallAppCatalogApp extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_InstallAppCatalogApp
+> {
+  method: 'installAppCatalogApp';
+  request: {
+    identity: IIdentity;
+    install: IAppInstallRequest;
+  };
+  response: {
+    service: IService;
+  };
+}
+
+export interface IReq_Any_GetUpgradeableAppCatalogServices extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_GetUpgradeableAppCatalogServices
+> {
+  method: 'getUpgradeableAppCatalogServices';
+  request: {
+    identity: IIdentity;
+  };
+  response: {
+    services: IUpgradeableAppService[];
+  };
+}

package/ts/requests/deployment.ts

@@ -1,7 +1,14 @@
 import * as plugins from '../plugins.js';
 import type { IDeployment } from '../data/deployment.js';
+import type { IService } from '../data/service.js';
 import type { IIdentity } from '../data/user.js';
 
+export interface IDeploymentWorkspaceFileEntry {
+  type: 'file' | 'directory';
+  name: string;
+  path: string;
+}
+
 export interface IReq_Any_Cloudly_GetDeploymentById 
 extends plugins.typedrequestInterfaces.implementsTR<
   plugins.typedrequestInterfaces.ITypedRequest,
@@ -138,4 +145,289 @@ extends plugins.typedrequestInterfaces.implementsTR<
     success: boolean;
     deployment: IDeployment;
   };
-}
+}
+
+export interface IReq_Any_Cloudly_KillDeployment
+extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_Cloudly_KillDeployment
+> {
+  method: 'killDeployment';
+  request: {
+    identity: IIdentity;
+    deploymentId: string;
+  };
+  response: {
+    success: boolean;
+    deployment: IDeployment;
+  };
+}
+
+export interface IReq_Any_Cloudly_DeploymentWorkspaceReadFile
+extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_Cloudly_DeploymentWorkspaceReadFile
+> {
+  method: 'deploymentWorkspaceReadFile';
+  request: {
+    identity: IIdentity;
+    deploymentId: string;
+    path: string;
+  };
+  response: {
+    content: string;
+  };
+}
+
+export interface IReq_Any_Cloudly_DeploymentWorkspaceWriteFile
+extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_Cloudly_DeploymentWorkspaceWriteFile
+> {
+  method: 'deploymentWorkspaceWriteFile';
+  request: {
+    identity: IIdentity;
+    deploymentId: string;
+    path: string;
+    content: string;
+  };
+  response: Record<string, never>;
+}
+
+export interface IReq_Any_Cloudly_DeploymentWorkspaceReadDir
+extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_Cloudly_DeploymentWorkspaceReadDir
+> {
+  method: 'deploymentWorkspaceReadDir';
+  request: {
+    identity: IIdentity;
+    deploymentId: string;
+    path: string;
+  };
+  response: {
+    entries: IDeploymentWorkspaceFileEntry[];
+  };
+}
+
+export interface IReq_Any_Cloudly_DeploymentWorkspaceMkdir
+extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_Cloudly_DeploymentWorkspaceMkdir
+> {
+  method: 'deploymentWorkspaceMkdir';
+  request: {
+    identity: IIdentity;
+    deploymentId: string;
+    path: string;
+  };
+  response: Record<string, never>;
+}
+
+export interface IReq_Any_Cloudly_DeploymentWorkspaceRm
+extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_Cloudly_DeploymentWorkspaceRm
+> {
+  method: 'deploymentWorkspaceRm';
+  request: {
+    identity: IIdentity;
+    deploymentId: string;
+    path: string;
+    recursive?: boolean;
+  };
+  response: Record<string, never>;
+}
+
+export interface IReq_Any_Cloudly_DeploymentWorkspaceExists
+extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_Cloudly_DeploymentWorkspaceExists
+> {
+  method: 'deploymentWorkspaceExists';
+  request: {
+    identity: IIdentity;
+    deploymentId: string;
+    path: string;
+  };
+  response: {
+    exists: boolean;
+  };
+}
+
+export interface IReq_Any_Cloudly_DeploymentWorkspaceExec
+extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_Cloudly_DeploymentWorkspaceExec
+> {
+  method: 'deploymentWorkspaceExec';
+  request: {
+    identity: IIdentity;
+    deploymentId: string;
+    command: string;
+    args?: string[];
+  };
+  response: {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+  };
+}
+
+export interface IReq_Cloudly_Coreflow_GetServiceDeployments
+extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Cloudly_Coreflow_GetServiceDeployments
+> {
+  method: 'coreflowGetServiceDeployments';
+  request: {
+    service: IService;
+  };
+  response: {
+    deployments: IDeployment[];
+  };
+}
+
+export interface IReq_Cloudly_Coreflow_RestartDeployment
+extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Cloudly_Coreflow_RestartDeployment
+> {
+  method: 'coreflowRestartDeployment';
+  request: {
+    deploymentId: string;
+  };
+  response: {
+    found: boolean;
+    deployment?: IDeployment;
+  };
+}
+
+export interface IReq_Cloudly_Coreflow_KillDeployment
+extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Cloudly_Coreflow_KillDeployment
+> {
+  method: 'coreflowKillDeployment';
+  request: {
+    deploymentId: string;
+  };
+  response: {
+    found: boolean;
+    deployment?: IDeployment;
+  };
+}
+
+export interface IReq_Cloudly_Coreflow_DeploymentWorkspaceReadFile
+extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Cloudly_Coreflow_DeploymentWorkspaceReadFile
+> {
+  method: 'coreflowDeploymentWorkspaceReadFile';
+  request: {
+    deploymentId: string;
+    path: string;
+  };
+  response: {
+    found: boolean;
+    content?: string;
+  };
+}
+
+export interface IReq_Cloudly_Coreflow_DeploymentWorkspaceWriteFile
+extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Cloudly_Coreflow_DeploymentWorkspaceWriteFile
+> {
+  method: 'coreflowDeploymentWorkspaceWriteFile';
+  request: {
+    deploymentId: string;
+    path: string;
+    content: string;
+  };
+  response: {
+    found: boolean;
+  };
+}
+
+export interface IReq_Cloudly_Coreflow_DeploymentWorkspaceReadDir
+extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Cloudly_Coreflow_DeploymentWorkspaceReadDir
+> {
+  method: 'coreflowDeploymentWorkspaceReadDir';
+  request: {
+    deploymentId: string;
+    path: string;
+  };
+  response: {
+    found: boolean;
+    entries?: IDeploymentWorkspaceFileEntry[];
+  };
+}
+
+export interface IReq_Cloudly_Coreflow_DeploymentWorkspaceMkdir
+extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Cloudly_Coreflow_DeploymentWorkspaceMkdir
+> {
+  method: 'coreflowDeploymentWorkspaceMkdir';
+  request: {
+    deploymentId: string;
+    path: string;
+  };
+  response: {
+    found: boolean;
+  };
+}
+
+export interface IReq_Cloudly_Coreflow_DeploymentWorkspaceRm
+extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Cloudly_Coreflow_DeploymentWorkspaceRm
+> {
+  method: 'coreflowDeploymentWorkspaceRm';
+  request: {
+    deploymentId: string;
+    path: string;
+    recursive?: boolean;
+  };
+  response: {
+    found: boolean;
+  };
+}
+
+export interface IReq_Cloudly_Coreflow_DeploymentWorkspaceExists
+extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Cloudly_Coreflow_DeploymentWorkspaceExists
+> {
+  method: 'coreflowDeploymentWorkspaceExists';
+  request: {
+    deploymentId: string;
+    path: string;
+  };
+  response: {
+    found: boolean;
+    exists?: boolean;
+  };
+}
+
+export interface IReq_Cloudly_Coreflow_DeploymentWorkspaceExec
+extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Cloudly_Coreflow_DeploymentWorkspaceExec
+> {
+  method: 'coreflowDeploymentWorkspaceExec';
+  request: {
+    deploymentId: string;
+    command: string;
+    args?: string[];
+  };
+  response: {
+    found: boolean;
+    stdout?: string;
+    stderr?: string;
+    exitCode?: number;
+  };
+}

package/ts/requests/index.ts

@@ -1,6 +1,7 @@
 import * as plugins from '../plugins.js';
 
 import * as adminRequests from './admin.js';
+import * as appCatalogRequests from './appcatalog.js';
 import * as baremetalRequests from './baremetal.js';
 import * as baseOsRequests from './baseos.js';
 import * as backupRequests from './backup.js';
@@ -30,6 +31,7 @@ import * as versionRequests from './version.js';
 
 export {
   adminRequests as admin,
+  appCatalogRequests as appcatalog,
   baremetalRequests as baremetal,
   baseOsRequests as baseos,
   backupRequests as backup,

package/ts/requests/node.ts

@@ -1,6 +1,7 @@
 import * as plugins from '../plugins.js';
-import type { IClusterNode } from '../data/clusternode.js';
+import type { IClusterNode, IClusterNodeMetrics, ISparkNodeRuntimeInfo } from '../data/clusternode.js';
 import type { IDeployment } from '../data/deployment.js';
+import type { IIdentity } from '../data/user.js';
 
 export interface IRequest_Any_Cloudly_GetNodeConfig {
   method: 'getNodeConfig';
@@ -30,4 +31,42 @@ export interface IRequest_Any_Cloudly_GetNodeDeployments {
   response: {
     deployments: IDeployment[];
   };
-}
+}
+
+export interface IReq_Any_Cloudly_CreateNodeJumpCommand extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_Cloudly_CreateNodeJumpCommand
+> {
+  method: 'createNodeJumpCommand';
+  request: {
+    identity: IIdentity;
+    clusterId: string;
+    role?: IClusterNode['data']['role'];
+    nodeType?: IClusterNode['data']['nodeType'];
+    ttlMs?: number;
+  };
+  response: {
+    jumpCode: string;
+    jumpUrl: string;
+    setupUrl: string;
+    command: string;
+    expiresAt: number;
+  };
+}
+
+export interface IRequest_Spark_Cloudly_SendHeartbeat extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IRequest_Spark_Cloudly_SendHeartbeat
+> {
+  method: 'sparkNodeHeartbeat';
+  request: {
+    nodeId: string;
+    nodeToken: string;
+    metrics: IClusterNodeMetrics;
+    runtimeInfo: ISparkNodeRuntimeInfo;
+  };
+  response: {
+    accepted: boolean;
+    message?: string;
+  };
+}