@meshagent/meshagent 0.42.0 → 0.42.2

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+## [0.42.2]
+- Added `ContainerExitStatus`, `RoomContainerStats`, and published build image metadata to the TypeScript container client models.
+- Added `waitForExitStatus` while keeping `waitForExit` as the exit-code convenience wrapper.
+- Container list parsing now preserves image IDs, runtime stats, and exit-status metadata from API responses.
+
+## [0.42.1]
+- Stability
+
 ## [0.42.0]
 - Added project lookup by key.
 - Container and room APIs now return structured `containerPort`/`hostPort` entries instead of integer port lists, which is a breaking response-shape change.

package/dist/browser/containers-client.d.ts

@@ -56,15 +56,30 @@ export interface RoomContainerPort {
     containerPort: number;
     hostPort: number;
 }
+export interface RoomContainerStats {
+    cpuUsageNanoCores?: number;
+    memoryUsageBytes?: number;
+    memoryWorkingSetBytes?: number;
+    timestampNs?: number;
+}
 export interface RoomContainer {
     id: string;
     image: string;
+    imageId?: string;
     name?: string;
     ports: RoomContainerPort[];
     startedBy: ContainerParticipantInfo;
     state: string;
     private: boolean;
     serviceId?: string;
+    stats?: RoomContainerStats;
+    exitStatus?: ContainerExitStatus;
+}
+export interface ContainerExitStatus {
+    exitCode: number;
+    reason?: string;
+    message?: string;
+    oomKilled?: boolean;
 }
 export interface LogProgress {
     layer?: string | null;
@@ -211,6 +226,9 @@ export declare class ContainersClient {
         containerId: string;
         force?: boolean;
     }): Promise<void>;
+    waitForExitStatus(params: {
+        containerId: string;
+    }): Promise<ContainerExitStatus>;
     waitForExit(params: {
         containerId: string;
     }): Promise<number>;

package/dist/browser/containers-client.js

@@ -618,14 +618,27 @@ class ContainersClient {
             force: params.force ?? false,
         });
     }
-    async waitForExit(params) {
+    async waitForExitStatus(params) {
         const output = await this.invoke("wait_for_exit", {
             container_id: params.containerId,
         });
         if (!(output instanceof response_1.JsonContent) || !isRecord(output.json)) {
             throw this.unexpectedResponseError("wait_for_exit");
         }
-        return readIntegerField(output.json, "exit_code", "wait_for_exit");
+        const exitCode = readIntegerField(output.json, "exit_code", "wait_for_exit");
+        const reason = output.json["reason"];
+        const message = output.json["message"];
+        const oomKilled = output.json["oom_killed"];
+        return {
+            exitCode,
+            reason: typeof reason === "string" ? reason : undefined,
+            message: typeof message === "string" ? message : undefined,
+            oomKilled: typeof oomKilled === "boolean" ? oomKilled : undefined,
+        };
+    }
+    async waitForExit(params) {
+        const status = await this.waitForExitStatus(params);
+        return status.exitCode;
     }
     async deleteContainer(params) {
         await this.invoke("delete_container", {
@@ -888,8 +901,11 @@ class ContainersClient {
                 throw this.unexpectedResponseError("list");
             }
             const nameRaw = entry["name"];
+            const imageIdRaw = entry["image_id"];
             const portsRaw = entry["ports"];
             const serviceIdRaw = entry["service_id"];
+            const statsRaw = entry["stats"];
+            const exitStatusRaw = entry["exit_status"];
             if (!Array.isArray(portsRaw) ||
                 !portsRaw.every((port) => {
                     if (!isRecord(port)) {
@@ -906,9 +922,39 @@ class ContainersClient {
                 containerPort: port["container_port"],
                 hostPort: port["host_port"],
             }));
+            let stats;
+            if (isRecord(statsRaw)) {
+                const cpuUsageNanoCores = statsRaw["cpu_usage_nano_cores"];
+                const memoryUsageBytes = statsRaw["memory_usage_bytes"];
+                const memoryWorkingSetBytes = statsRaw["memory_working_set_bytes"];
+                const timestampNs = statsRaw["timestamp_ns"];
+                stats = {
+                    cpuUsageNanoCores: typeof cpuUsageNanoCores === "number" ? cpuUsageNanoCores : undefined,
+                    memoryUsageBytes: typeof memoryUsageBytes === "number" ? memoryUsageBytes : undefined,
+                    memoryWorkingSetBytes: typeof memoryWorkingSetBytes === "number" ? memoryWorkingSetBytes : undefined,
+                    timestampNs: typeof timestampNs === "number" ? timestampNs : undefined,
+                };
+            }
+            let exitStatus;
+            if (isRecord(exitStatusRaw)) {
+                const exitCode = exitStatusRaw["exit_code"];
+                if (typeof exitCode === "number" &&
+                    Number.isInteger(exitCode)) {
+                    const reason = exitStatusRaw["reason"];
+                    const message = exitStatusRaw["message"];
+                    const oomKilled = exitStatusRaw["oom_killed"];
+                    exitStatus = {
+                        exitCode,
+                        reason: typeof reason === "string" ? reason : undefined,
+                        message: typeof message === "string" ? message : undefined,
+                        oomKilled: typeof oomKilled === "boolean" ? oomKilled : undefined,
+                    };
+                }
+            }
             items.push({
                 id,
                 image,
+                imageId: typeof imageIdRaw === "string" ? imageIdRaw : undefined,
                 name: typeof nameRaw === "string" ? nameRaw : undefined,
                 ports,
                 startedBy: {
@@ -918,6 +964,8 @@ class ContainersClient {
                 state,
                 private: privateFlag,
                 serviceId: typeof serviceIdRaw === "string" ? serviceIdRaw : undefined,
+                stats,
+                exitStatus,
             });
         }
         return items;

package/dist/esm/containers-client.d.ts

@@ -56,15 +56,30 @@ export interface RoomContainerPort {
     containerPort: number;
     hostPort: number;
 }
+export interface RoomContainerStats {
+    cpuUsageNanoCores?: number;
+    memoryUsageBytes?: number;
+    memoryWorkingSetBytes?: number;
+    timestampNs?: number;
+}
 export interface RoomContainer {
     id: string;
     image: string;
+    imageId?: string;
     name?: string;
     ports: RoomContainerPort[];
     startedBy: ContainerParticipantInfo;
     state: string;
     private: boolean;
     serviceId?: string;
+    stats?: RoomContainerStats;
+    exitStatus?: ContainerExitStatus;
+}
+export interface ContainerExitStatus {
+    exitCode: number;
+    reason?: string;
+    message?: string;
+    oomKilled?: boolean;
 }
 export interface LogProgress {
     layer?: string | null;
@@ -211,6 +226,9 @@ export declare class ContainersClient {
         containerId: string;
         force?: boolean;
     }): Promise<void>;
+    waitForExitStatus(params: {
+        containerId: string;
+    }): Promise<ContainerExitStatus>;
     waitForExit(params: {
         containerId: string;
     }): Promise<number>;

package/dist/esm/containers-client.js

@@ -618,14 +618,27 @@ class ContainersClient {
             force: params.force ?? false,
         });
     }
-    async waitForExit(params) {
+    async waitForExitStatus(params) {
         const output = await this.invoke("wait_for_exit", {
             container_id: params.containerId,
         });
         if (!(output instanceof response_1.JsonContent) || !isRecord(output.json)) {
             throw this.unexpectedResponseError("wait_for_exit");
         }
-        return readIntegerField(output.json, "exit_code", "wait_for_exit");
+        const exitCode = readIntegerField(output.json, "exit_code", "wait_for_exit");
+        const reason = output.json["reason"];
+        const message = output.json["message"];
+        const oomKilled = output.json["oom_killed"];
+        return {
+            exitCode,
+            reason: typeof reason === "string" ? reason : undefined,
+            message: typeof message === "string" ? message : undefined,
+            oomKilled: typeof oomKilled === "boolean" ? oomKilled : undefined,
+        };
+    }
+    async waitForExit(params) {
+        const status = await this.waitForExitStatus(params);
+        return status.exitCode;
     }
     async deleteContainer(params) {
         await this.invoke("delete_container", {
@@ -888,8 +901,11 @@ class ContainersClient {
                 throw this.unexpectedResponseError("list");
             }
             const nameRaw = entry["name"];
+            const imageIdRaw = entry["image_id"];
             const portsRaw = entry["ports"];
             const serviceIdRaw = entry["service_id"];
+            const statsRaw = entry["stats"];
+            const exitStatusRaw = entry["exit_status"];
             if (!Array.isArray(portsRaw) ||
                 !portsRaw.every((port) => {
                     if (!isRecord(port)) {
@@ -906,9 +922,39 @@ class ContainersClient {
                 containerPort: port["container_port"],
                 hostPort: port["host_port"],
             }));
+            let stats;
+            if (isRecord(statsRaw)) {
+                const cpuUsageNanoCores = statsRaw["cpu_usage_nano_cores"];
+                const memoryUsageBytes = statsRaw["memory_usage_bytes"];
+                const memoryWorkingSetBytes = statsRaw["memory_working_set_bytes"];
+                const timestampNs = statsRaw["timestamp_ns"];
+                stats = {
+                    cpuUsageNanoCores: typeof cpuUsageNanoCores === "number" ? cpuUsageNanoCores : undefined,
+                    memoryUsageBytes: typeof memoryUsageBytes === "number" ? memoryUsageBytes : undefined,
+                    memoryWorkingSetBytes: typeof memoryWorkingSetBytes === "number" ? memoryWorkingSetBytes : undefined,
+                    timestampNs: typeof timestampNs === "number" ? timestampNs : undefined,
+                };
+            }
+            let exitStatus;
+            if (isRecord(exitStatusRaw)) {
+                const exitCode = exitStatusRaw["exit_code"];
+                if (typeof exitCode === "number" &&
+                    Number.isInteger(exitCode)) {
+                    const reason = exitStatusRaw["reason"];
+                    const message = exitStatusRaw["message"];
+                    const oomKilled = exitStatusRaw["oom_killed"];
+                    exitStatus = {
+                        exitCode,
+                        reason: typeof reason === "string" ? reason : undefined,
+                        message: typeof message === "string" ? message : undefined,
+                        oomKilled: typeof oomKilled === "boolean" ? oomKilled : undefined,
+                    };
+                }
+            }
             items.push({
                 id,
                 image,
+                imageId: typeof imageIdRaw === "string" ? imageIdRaw : undefined,
                 name: typeof nameRaw === "string" ? nameRaw : undefined,
                 ports,
                 startedBy: {
@@ -918,6 +964,8 @@ class ContainersClient {
                 state,
                 private: privateFlag,
                 serviceId: typeof serviceIdRaw === "string" ? serviceIdRaw : undefined,
+                stats,
+                exitStatus,
             });
         }
         return items;

package/dist/node/containers-client.d.ts

@@ -56,15 +56,30 @@ export interface RoomContainerPort {
     containerPort: number;
     hostPort: number;
 }
+export interface RoomContainerStats {
+    cpuUsageNanoCores?: number;
+    memoryUsageBytes?: number;
+    memoryWorkingSetBytes?: number;
+    timestampNs?: number;
+}
 export interface RoomContainer {
     id: string;
     image: string;
+    imageId?: string;
     name?: string;
     ports: RoomContainerPort[];
     startedBy: ContainerParticipantInfo;
     state: string;
     private: boolean;
     serviceId?: string;
+    stats?: RoomContainerStats;
+    exitStatus?: ContainerExitStatus;
+}
+export interface ContainerExitStatus {
+    exitCode: number;
+    reason?: string;
+    message?: string;
+    oomKilled?: boolean;
 }
 export interface LogProgress {
     layer?: string | null;
@@ -211,6 +226,9 @@ export declare class ContainersClient {
         containerId: string;
         force?: boolean;
     }): Promise<void>;
+    waitForExitStatus(params: {
+        containerId: string;
+    }): Promise<ContainerExitStatus>;
     waitForExit(params: {
         containerId: string;
     }): Promise<number>;

package/dist/node/containers-client.js

@@ -618,14 +618,27 @@ class ContainersClient {
             force: params.force ?? false,
         });
     }
-    async waitForExit(params) {
+    async waitForExitStatus(params) {
         const output = await this.invoke("wait_for_exit", {
             container_id: params.containerId,
         });
         if (!(output instanceof response_1.JsonContent) || !isRecord(output.json)) {
             throw this.unexpectedResponseError("wait_for_exit");
         }
-        return readIntegerField(output.json, "exit_code", "wait_for_exit");
+        const exitCode = readIntegerField(output.json, "exit_code", "wait_for_exit");
+        const reason = output.json["reason"];
+        const message = output.json["message"];
+        const oomKilled = output.json["oom_killed"];
+        return {
+            exitCode,
+            reason: typeof reason === "string" ? reason : undefined,
+            message: typeof message === "string" ? message : undefined,
+            oomKilled: typeof oomKilled === "boolean" ? oomKilled : undefined,
+        };
+    }
+    async waitForExit(params) {
+        const status = await this.waitForExitStatus(params);
+        return status.exitCode;
     }
     async deleteContainer(params) {
         await this.invoke("delete_container", {
@@ -888,8 +901,11 @@ class ContainersClient {
                 throw this.unexpectedResponseError("list");
             }
             const nameRaw = entry["name"];
+            const imageIdRaw = entry["image_id"];
             const portsRaw = entry["ports"];
             const serviceIdRaw = entry["service_id"];
+            const statsRaw = entry["stats"];
+            const exitStatusRaw = entry["exit_status"];
             if (!Array.isArray(portsRaw) ||
                 !portsRaw.every((port) => {
                     if (!isRecord(port)) {
@@ -906,9 +922,39 @@ class ContainersClient {
                 containerPort: port["container_port"],
                 hostPort: port["host_port"],
             }));
+            let stats;
+            if (isRecord(statsRaw)) {
+                const cpuUsageNanoCores = statsRaw["cpu_usage_nano_cores"];
+                const memoryUsageBytes = statsRaw["memory_usage_bytes"];
+                const memoryWorkingSetBytes = statsRaw["memory_working_set_bytes"];
+                const timestampNs = statsRaw["timestamp_ns"];
+                stats = {
+                    cpuUsageNanoCores: typeof cpuUsageNanoCores === "number" ? cpuUsageNanoCores : undefined,
+                    memoryUsageBytes: typeof memoryUsageBytes === "number" ? memoryUsageBytes : undefined,
+                    memoryWorkingSetBytes: typeof memoryWorkingSetBytes === "number" ? memoryWorkingSetBytes : undefined,
+                    timestampNs: typeof timestampNs === "number" ? timestampNs : undefined,
+                };
+            }
+            let exitStatus;
+            if (isRecord(exitStatusRaw)) {
+                const exitCode = exitStatusRaw["exit_code"];
+                if (typeof exitCode === "number" &&
+                    Number.isInteger(exitCode)) {
+                    const reason = exitStatusRaw["reason"];
+                    const message = exitStatusRaw["message"];
+                    const oomKilled = exitStatusRaw["oom_killed"];
+                    exitStatus = {
+                        exitCode,
+                        reason: typeof reason === "string" ? reason : undefined,
+                        message: typeof message === "string" ? message : undefined,
+                        oomKilled: typeof oomKilled === "boolean" ? oomKilled : undefined,
+                    };
+                }
+            }
             items.push({
                 id,
                 image,
+                imageId: typeof imageIdRaw === "string" ? imageIdRaw : undefined,
                 name: typeof nameRaw === "string" ? nameRaw : undefined,
                 ports,
                 startedBy: {
@@ -918,6 +964,8 @@ class ContainersClient {
                 state,
                 private: privateFlag,
                 serviceId: typeof serviceIdRaw === "string" ? serviceIdRaw : undefined,
+                stats,
+                exitStatus,
             });
         }
         return items;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@meshagent/meshagent",
-    "version": "0.42.0",
+    "version": "0.42.2",
     "description": "Meshagent Client",
     "homepage": "https://github.com/meshagent/meshagent-ts",
     "scripts": {