@meshagent/meshagent 0.47.1 → 0.48.0

package/CHANGELOG.md

@@ -1,4 +1,11 @@
+## [0.48.0]
+- Reworked the TS/JS agent chat stack to preserve ordered threaded messages and support injected-message threads across chat clients and process handling.
+- Added chat feed widgets and virtual scrolling to the React/Tailwind UI, improving large-thread performance.
+- Aligned `meshagent-agents-ts` with the Dart agents implementation and refreshed the shared chat/message contracts.
+- Removed the LiveKit dependency from the React package and updated shared package dependencies for the new chat stack.
+
 ## [0.47.1]
+- Changed room mount discovery to return typed room/container consumers without exposing internal source paths, and added typed container mount specs to listed containers.
 - Added duplex messaging stream subscriptions and replay-state alignment in the TypeScript chat clients, bringing the NodeJS SDK in line with the new streaming model.
 - Reworked messaging and room client flow control so dispatch ordering, close behavior, and presence updates stay consistent under streaming loads.
 - Expanded stream and presence test coverage for the new messaging behavior.

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

@@ -72,6 +72,7 @@ export interface RoomContainer {
     state: string;
     private: boolean;
     serviceId?: string;
+    mounts?: ContainerMountSpec;
     stats?: RoomContainerStats;
     exitStatus?: ContainerExitStatus;
 }

package/dist/browser/containers-client.js

@@ -9,6 +9,38 @@ const stream_controller_js_1 = require("./stream-controller.js");
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+function parseContainerMountSpec(value) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (!isRecord(value)) {
+        throw new room_server_client_js_1.RoomServerException("unexpected return type from containers.list");
+    }
+    const readMounts = (field, validate) => {
+        const raw = value[field];
+        if (raw === undefined || raw === null) {
+            return undefined;
+        }
+        if (!Array.isArray(raw) || !raw.every((mount) => isRecord(mount) && validate(mount))) {
+            throw new room_server_client_js_1.RoomServerException("unexpected return type from containers.list");
+        }
+        return raw;
+    };
+    const optionalMountFieldsAreValid = (mount) => (mount["subpath"] === undefined || mount["subpath"] === null || typeof mount["subpath"] === "string")
+        && (mount["read_only"] === undefined || typeof mount["read_only"] === "boolean");
+    return {
+        room: readMounts("room", (mount) => typeof mount["path"] === "string" && optionalMountFieldsAreValid(mount)),
+        volumes: readMounts("volumes", (mount) => typeof mount["name"] === "string"
+            && typeof mount["path"] === "string"
+            && optionalMountFieldsAreValid(mount)),
+        empty_dirs: readMounts("empty_dirs", (mount) => typeof mount["path"] === "string"
+            && (mount["read_only"] === undefined || typeof mount["read_only"] === "boolean")),
+        configs: readMounts("configs", (mount) => mount["path"] === undefined || mount["path"] === null || typeof mount["path"] === "string"),
+        files: readMounts("files", (mount) => typeof mount["path"] === "string"
+            && (mount["read_only"] === undefined || typeof mount["read_only"] === "boolean")
+            && (mount["text"] === undefined || mount["text"] === null || typeof mount["text"] === "string")),
+    };
+}
 function toStringMapList(values) {
     return Object.entries(values).map(([key, value]) => ({ key, value }));
 }
@@ -904,6 +936,7 @@ class ContainersClient {
             const imageIdRaw = entry["image_id"];
             const portsRaw = entry["ports"];
             const serviceIdRaw = entry["service_id"];
+            const mountsRaw = entry["mounts"];
             const statsRaw = entry["stats"];
             const exitStatusRaw = entry["exit_status"];
             if (!Array.isArray(portsRaw) ||
@@ -964,6 +997,7 @@ class ContainersClient {
                 state,
                 private: privateFlag,
                 serviceId: typeof serviceIdRaw === "string" ? serviceIdRaw : undefined,
+                mounts: parseContainerMountSpec(mountsRaw),
                 stats,
                 exitStatus,
             });

package/dist/browser/entrypoint.d.ts

@@ -16,6 +16,7 @@ export var ServerXmlDocument: {
             ignoreRemoteMapChanges: UndoManagerOptions;
             captureTimeout: UndoManagerOptions;
             afterTransactionHandler: (transaction: any) => void;
+            destroy(): void;
             addToScope(ytypes: Array<any | {
                 gc: DocOpts;
                 gcFilter: DocOpts;

package/dist/browser/entrypoint.js

@@ -3994,10 +3994,9 @@ var UndoManager = class extends ObservableV2 {
         this.emit("stack-item-updated", changeEvent);
       }
     };
+    this.destroy = this.destroy.bind(this);
     this.doc.on("afterTransaction", this.afterTransactionHandler);
-    this.doc.on("destroy", () => {
-      this.destroy();
-    });
+    this.doc.on("destroy", this.destroy);
   }
   /**
    * Extend the scope.
@@ -4114,6 +4113,7 @@ var UndoManager = class extends ObservableV2 {
   destroy() {
     this.trackedOrigins.delete(this);
     this.doc.off("afterTransaction", this.afterTransactionHandler);
+    this.doc.off("destroy", this.destroy);
     super.destroy();
   }
 };

package/dist/browser/index.d.ts

@@ -10,6 +10,7 @@ export * from './document.js';
 export * from './meshagent-client.js';
 export * from './messaging-client.js';
 export * from './memory-client.js';
+export * from './mounts-client.js';
 export * from './oauth-scopes.js';
 export * from './participant-token.js';
 export * from './participant.js';

package/dist/browser/index.js

@@ -26,6 +26,7 @@ __exportStar(require("./document.js"), exports);
 __exportStar(require("./meshagent-client.js"), exports);
 __exportStar(require("./messaging-client.js"), exports);
 __exportStar(require("./memory-client.js"), exports);
+__exportStar(require("./mounts-client.js"), exports);
 __exportStar(require("./oauth-scopes.js"), exports);
 __exportStar(require("./participant-token.js"), exports);
 __exportStar(require("./participant.js"), exports);

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

@@ -235,6 +235,12 @@ export interface RoomStorageMountSpec {
     subpath?: string | null;
     read_only?: boolean;
 }
+export interface VolumeStorageMountSpec {
+    name: string;
+    path: string;
+    subpath?: string | null;
+    read_only?: boolean;
+}
 export interface EmptyDirMountSpec {
     path: string;
     read_only?: boolean;
@@ -249,6 +255,7 @@ export interface FileMountSpec {
 }
 export interface ContainerMountSpec {
     room?: RoomStorageMountSpec[];
+    volumes?: VolumeStorageMountSpec[];
     empty_dirs?: EmptyDirMountSpec[];
     configs?: ConfigMountSpec[];
     files?: FileMountSpec[];

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

@@ -0,0 +1,21 @@
+import type { RoomClient } from "./room-client.js";
+export interface MountedVolumeConsumer {
+    kind: "room" | "container";
+    containerId?: string;
+}
+export interface MountedVolume {
+    id: string;
+    name: string;
+    required: boolean;
+    description: string;
+    metadata: Record<string, unknown>;
+    annotations: Record<string, string>;
+    storageClass: "standard" | "juice" | "zerofs";
+    maxSizeMb?: number;
+    consumers: MountedVolumeConsumer[];
+}
+export declare class MountsClient {
+    private readonly room;
+    constructor(room: RoomClient);
+    list(): Promise<MountedVolume[]>;
+}

package/dist/browser/mounts-client.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MountsClient = void 0;
+const response_js_1 = require("./response.js");
+const room_server_client_js_1 = require("./room-server-client.js");
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseMountedVolume(value) {
+    if (!isRecord(value)
+        || typeof value["id"] !== "string"
+        || typeof value["name"] !== "string"
+        || typeof value["required"] !== "boolean") {
+        throw new room_server_client_js_1.RoomServerException("unexpected return type from mounts.list");
+    }
+    const metadata = isRecord(value["metadata"]) ? value["metadata"] : {};
+    const rawAnnotations = isRecord(value["annotations"]) ? value["annotations"] : {};
+    const annotations = {};
+    for (const [key, item] of Object.entries(rawAnnotations)) {
+        if (typeof item === "string") {
+            annotations[key] = item;
+        }
+    }
+    const rawConsumers = value["consumers"] ?? [];
+    if (!Array.isArray(rawConsumers)) {
+        throw new room_server_client_js_1.RoomServerException("unexpected return type from mounts.list");
+    }
+    const consumers = rawConsumers.map((consumer) => {
+        if (!isRecord(consumer)
+            || (consumer["kind"] !== "room" && consumer["kind"] !== "container")
+            || (consumer["kind"] === "container" && typeof consumer["container_id"] !== "string")
+            || (consumer["kind"] === "room" && consumer["container_id"] !== undefined)) {
+            throw new room_server_client_js_1.RoomServerException("unexpected return type from mounts.list");
+        }
+        return {
+            kind: consumer["kind"],
+            containerId: typeof consumer["container_id"] === "string"
+                ? consumer["container_id"]
+                : undefined,
+        };
+    });
+    const storageClass = value["storage_class"] ?? "standard";
+    if (storageClass !== "standard" && storageClass !== "juice" && storageClass !== "zerofs") {
+        throw new room_server_client_js_1.RoomServerException("unexpected return type from mounts.list");
+    }
+    const maxSizeMb = value["max_size_mb"];
+    if (maxSizeMb !== undefined && (typeof maxSizeMb !== "number" || !Number.isInteger(maxSizeMb) || maxSizeMb <= 0)) {
+        throw new room_server_client_js_1.RoomServerException("unexpected return type from mounts.list");
+    }
+    return {
+        id: value["id"],
+        name: value["name"],
+        required: value["required"],
+        description: typeof value["description"] === "string" ? value["description"] : "",
+        metadata,
+        annotations,
+        storageClass,
+        maxSizeMb,
+        consumers,
+    };
+}
+class MountsClient {
+    constructor(room) {
+        this.room = room;
+    }
+    async list() {
+        const response = await this.room.invokeContent({
+            toolkit: "mounts",
+            tool: "list",
+            input: {},
+        });
+        if (!(response instanceof response_js_1.JsonContent)) {
+            throw new room_server_client_js_1.RoomServerException("unexpected return type from mounts.list");
+        }
+        const volumes = response.json["volumes"];
+        if (!Array.isArray(volumes)) {
+            throw new room_server_client_js_1.RoomServerException("unexpected return type from mounts.list");
+        }
+        return volumes.map(parseMountedVolume);
+    }
+}
+exports.MountsClient = MountsClient;

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

@@ -4,6 +4,7 @@ import { DeveloperClient } from "./developer-client.js";
 import { type EventHandler, type EventName } from "./event-emitter.js";
 import { MessagingClient } from "./messaging-client.js";
 import { MemoryClient } from "./memory-client.js";
+import { MountsClient } from "./mounts-client.js";
 import { LocalParticipant } from "./participant.js";
 import { Protocol, ProtocolCloseKind, type MessageHandler, type ProtocolFactory } from "./protocol.js";
 import { QueuesClient } from "./queues-client.js";
@@ -59,6 +60,7 @@ export declare class RoomClient {
     readonly containers: ContainersClient;
     readonly memory: MemoryClient;
     readonly services: ServicesClient;
+    readonly mounts: MountsClient;
     _protocolInstance: Protocol;
     _entered: boolean;
     _allowDisconnectedRequests: boolean;

package/dist/browser/room-client.js

@@ -8,6 +8,7 @@ const developer_client_js_1 = require("./developer-client.js");
 const event_emitter_js_1 = require("./event-emitter.js");
 const messaging_client_js_1 = require("./messaging-client.js");
 const memory_client_js_1 = require("./memory-client.js");
+const mounts_client_js_1 = require("./mounts-client.js");
 const participant_js_1 = require("./participant.js");
 const protocol_js_1 = require("./protocol.js");
 const queues_client_js_1 = require("./queues-client.js");
@@ -261,6 +262,7 @@ class RoomClient {
         this.containers = new containers_client_js_1.ContainersClient({ room: this });
         this.memory = new memory_client_js_1.MemoryClient({ room: this });
         this.services = new services_client_js_1.ServicesClient({ room: this });
+        this.mounts = new mounts_client_js_1.MountsClient(this);
     }
     static withIAP({ url = "./.well-known/meshagent/room/connect", reconnectTimeout = null, } = {}) {
         return new RoomClient({

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

@@ -72,6 +72,7 @@ export interface RoomContainer {
     state: string;
     private: boolean;
     serviceId?: string;
+    mounts?: ContainerMountSpec;
     stats?: RoomContainerStats;
     exitStatus?: ContainerExitStatus;
 }

package/dist/esm/containers-client.js

@@ -6,6 +6,38 @@ import { StreamController } from "./stream-controller.js";
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+function parseContainerMountSpec(value) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (!isRecord(value)) {
+        throw new RoomServerException("unexpected return type from containers.list");
+    }
+    const readMounts = (field, validate) => {
+        const raw = value[field];
+        if (raw === undefined || raw === null) {
+            return undefined;
+        }
+        if (!Array.isArray(raw) || !raw.every((mount) => isRecord(mount) && validate(mount))) {
+            throw new RoomServerException("unexpected return type from containers.list");
+        }
+        return raw;
+    };
+    const optionalMountFieldsAreValid = (mount) => (mount["subpath"] === undefined || mount["subpath"] === null || typeof mount["subpath"] === "string")
+        && (mount["read_only"] === undefined || typeof mount["read_only"] === "boolean");
+    return {
+        room: readMounts("room", (mount) => typeof mount["path"] === "string" && optionalMountFieldsAreValid(mount)),
+        volumes: readMounts("volumes", (mount) => typeof mount["name"] === "string"
+            && typeof mount["path"] === "string"
+            && optionalMountFieldsAreValid(mount)),
+        empty_dirs: readMounts("empty_dirs", (mount) => typeof mount["path"] === "string"
+            && (mount["read_only"] === undefined || typeof mount["read_only"] === "boolean")),
+        configs: readMounts("configs", (mount) => mount["path"] === undefined || mount["path"] === null || typeof mount["path"] === "string"),
+        files: readMounts("files", (mount) => typeof mount["path"] === "string"
+            && (mount["read_only"] === undefined || typeof mount["read_only"] === "boolean")
+            && (mount["text"] === undefined || mount["text"] === null || typeof mount["text"] === "string")),
+    };
+}
 function toStringMapList(values) {
     return Object.entries(values).map(([key, value]) => ({ key, value }));
 }
@@ -900,6 +932,7 @@ export class ContainersClient {
             const imageIdRaw = entry["image_id"];
             const portsRaw = entry["ports"];
             const serviceIdRaw = entry["service_id"];
+            const mountsRaw = entry["mounts"];
             const statsRaw = entry["stats"];
             const exitStatusRaw = entry["exit_status"];
             if (!Array.isArray(portsRaw) ||
@@ -960,6 +993,7 @@ export class ContainersClient {
                 state,
                 private: privateFlag,
                 serviceId: typeof serviceIdRaw === "string" ? serviceIdRaw : undefined,
+                mounts: parseContainerMountSpec(mountsRaw),
                 stats,
                 exitStatus,
             });

package/dist/esm/entrypoint.d.ts

@@ -16,6 +16,7 @@ export var ServerXmlDocument: {
             ignoreRemoteMapChanges: UndoManagerOptions;
             captureTimeout: UndoManagerOptions;
             afterTransactionHandler: (transaction: any) => void;
+            destroy(): void;
             addToScope(ytypes: Array<any | {
                 gc: DocOpts;
                 gcFilter: DocOpts;

package/dist/esm/entrypoint.js

@@ -3027,10 +3027,9 @@ var UndoManager = class extends ObservableV2 {
                 this.emit("stack-item-updated", changeEvent);
             }
         };
+        this.destroy = this.destroy.bind(this);
         this.doc.on("afterTransaction", this.afterTransactionHandler);
-        this.doc.on("destroy", () => {
-            this.destroy();
-        });
+        this.doc.on("destroy", this.destroy);
     }
     addToScope(ytypes) {
         const tmpSet = new Set(this.scope);
@@ -3099,6 +3098,7 @@ var UndoManager = class extends ObservableV2 {
     destroy() {
         this.trackedOrigins.delete(this);
         this.doc.off("afterTransaction", this.afterTransactionHandler);
+        this.doc.off("destroy", this.destroy);
         super.destroy();
     }
 };

package/dist/esm/index.d.ts

@@ -10,6 +10,7 @@ export * from './document.js';
 export * from './meshagent-client.js';
 export * from './messaging-client.js';
 export * from './memory-client.js';
+export * from './mounts-client.js';
 export * from './oauth-scopes.js';
 export * from './participant-token.js';
 export * from './participant.js';

package/dist/esm/index.js

@@ -10,6 +10,7 @@ export * from './document.js';
 export * from './meshagent-client.js';
 export * from './messaging-client.js';
 export * from './memory-client.js';
+export * from './mounts-client.js';
 export * from './oauth-scopes.js';
 export * from './participant-token.js';
 export * from './participant.js';

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

@@ -235,6 +235,12 @@ export interface RoomStorageMountSpec {
     subpath?: string | null;
     read_only?: boolean;
 }
+export interface VolumeStorageMountSpec {
+    name: string;
+    path: string;
+    subpath?: string | null;
+    read_only?: boolean;
+}
 export interface EmptyDirMountSpec {
     path: string;
     read_only?: boolean;
@@ -249,6 +255,7 @@ export interface FileMountSpec {
 }
 export interface ContainerMountSpec {
     room?: RoomStorageMountSpec[];
+    volumes?: VolumeStorageMountSpec[];
     empty_dirs?: EmptyDirMountSpec[];
     configs?: ConfigMountSpec[];
     files?: FileMountSpec[];

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

@@ -0,0 +1,21 @@
+import type { RoomClient } from "./room-client.js";
+export interface MountedVolumeConsumer {
+    kind: "room" | "container";
+    containerId?: string;
+}
+export interface MountedVolume {
+    id: string;
+    name: string;
+    required: boolean;
+    description: string;
+    metadata: Record<string, unknown>;
+    annotations: Record<string, string>;
+    storageClass: "standard" | "juice" | "zerofs";
+    maxSizeMb?: number;
+    consumers: MountedVolumeConsumer[];
+}
+export declare class MountsClient {
+    private readonly room;
+    constructor(room: RoomClient);
+    list(): Promise<MountedVolume[]>;
+}

package/dist/esm/mounts-client.js

@@ -0,0 +1,78 @@
+import { JsonContent } from "./response.js";
+import { RoomServerException } from "./room-server-client.js";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseMountedVolume(value) {
+    if (!isRecord(value)
+        || typeof value["id"] !== "string"
+        || typeof value["name"] !== "string"
+        || typeof value["required"] !== "boolean") {
+        throw new RoomServerException("unexpected return type from mounts.list");
+    }
+    const metadata = isRecord(value["metadata"]) ? value["metadata"] : {};
+    const rawAnnotations = isRecord(value["annotations"]) ? value["annotations"] : {};
+    const annotations = {};
+    for (const [key, item] of Object.entries(rawAnnotations)) {
+        if (typeof item === "string") {
+            annotations[key] = item;
+        }
+    }
+    const rawConsumers = value["consumers"] ?? [];
+    if (!Array.isArray(rawConsumers)) {
+        throw new RoomServerException("unexpected return type from mounts.list");
+    }
+    const consumers = rawConsumers.map((consumer) => {
+        if (!isRecord(consumer)
+            || (consumer["kind"] !== "room" && consumer["kind"] !== "container")
+            || (consumer["kind"] === "container" && typeof consumer["container_id"] !== "string")
+            || (consumer["kind"] === "room" && consumer["container_id"] !== undefined)) {
+            throw new RoomServerException("unexpected return type from mounts.list");
+        }
+        return {
+            kind: consumer["kind"],
+            containerId: typeof consumer["container_id"] === "string"
+                ? consumer["container_id"]
+                : undefined,
+        };
+    });
+    const storageClass = value["storage_class"] ?? "standard";
+    if (storageClass !== "standard" && storageClass !== "juice" && storageClass !== "zerofs") {
+        throw new RoomServerException("unexpected return type from mounts.list");
+    }
+    const maxSizeMb = value["max_size_mb"];
+    if (maxSizeMb !== undefined && (typeof maxSizeMb !== "number" || !Number.isInteger(maxSizeMb) || maxSizeMb <= 0)) {
+        throw new RoomServerException("unexpected return type from mounts.list");
+    }
+    return {
+        id: value["id"],
+        name: value["name"],
+        required: value["required"],
+        description: typeof value["description"] === "string" ? value["description"] : "",
+        metadata,
+        annotations,
+        storageClass,
+        maxSizeMb,
+        consumers,
+    };
+}
+export class MountsClient {
+    constructor(room) {
+        this.room = room;
+    }
+    async list() {
+        const response = await this.room.invokeContent({
+            toolkit: "mounts",
+            tool: "list",
+            input: {},
+        });
+        if (!(response instanceof JsonContent)) {
+            throw new RoomServerException("unexpected return type from mounts.list");
+        }
+        const volumes = response.json["volumes"];
+        if (!Array.isArray(volumes)) {
+            throw new RoomServerException("unexpected return type from mounts.list");
+        }
+        return volumes.map(parseMountedVolume);
+    }
+}

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

@@ -4,6 +4,7 @@ import { DeveloperClient } from "./developer-client.js";
 import { type EventHandler, type EventName } from "./event-emitter.js";
 import { MessagingClient } from "./messaging-client.js";
 import { MemoryClient } from "./memory-client.js";
+import { MountsClient } from "./mounts-client.js";
 import { LocalParticipant } from "./participant.js";
 import { Protocol, ProtocolCloseKind, type MessageHandler, type ProtocolFactory } from "./protocol.js";
 import { QueuesClient } from "./queues-client.js";
@@ -59,6 +60,7 @@ export declare class RoomClient {
     readonly containers: ContainersClient;
     readonly memory: MemoryClient;
     readonly services: ServicesClient;
+    readonly mounts: MountsClient;
     _protocolInstance: Protocol;
     _entered: boolean;
     _allowDisconnectedRequests: boolean;

package/dist/esm/room-client.js

@@ -5,6 +5,7 @@ import { DeveloperClient } from "./developer-client.js";
 import { EventEmitter } from "./event-emitter.js";
 import { MessagingClient } from "./messaging-client.js";
 import { MemoryClient } from "./memory-client.js";
+import { MountsClient } from "./mounts-client.js";
 import { LocalParticipant } from "./participant.js";
 import { ProtocolCloseException, ProtocolCloseKind, ProtocolHandshakeException, ProtocolReconnectUnsupportedException, WebSocketClientProtocol, } from "./protocol.js";
 import { QueuesClient } from "./queues-client.js";
@@ -257,6 +258,7 @@ export class RoomClient {
         this.containers = new ContainersClient({ room: this });
         this.memory = new MemoryClient({ room: this });
         this.services = new ServicesClient({ room: this });
+        this.mounts = new MountsClient(this);
     }
     static withIAP({ url = "./.well-known/meshagent/room/connect", reconnectTimeout = null, } = {}) {
         return new RoomClient({

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

@@ -72,6 +72,7 @@ export interface RoomContainer {
     state: string;
     private: boolean;
     serviceId?: string;
+    mounts?: ContainerMountSpec;
     stats?: RoomContainerStats;
     exitStatus?: ContainerExitStatus;
 }

package/dist/node/containers-client.js

@@ -9,6 +9,38 @@ const stream_controller_js_1 = require("./stream-controller.js");
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+function parseContainerMountSpec(value) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (!isRecord(value)) {
+        throw new room_server_client_js_1.RoomServerException("unexpected return type from containers.list");
+    }
+    const readMounts = (field, validate) => {
+        const raw = value[field];
+        if (raw === undefined || raw === null) {
+            return undefined;
+        }
+        if (!Array.isArray(raw) || !raw.every((mount) => isRecord(mount) && validate(mount))) {
+            throw new room_server_client_js_1.RoomServerException("unexpected return type from containers.list");
+        }
+        return raw;
+    };
+    const optionalMountFieldsAreValid = (mount) => (mount["subpath"] === undefined || mount["subpath"] === null || typeof mount["subpath"] === "string")
+        && (mount["read_only"] === undefined || typeof mount["read_only"] === "boolean");
+    return {
+        room: readMounts("room", (mount) => typeof mount["path"] === "string" && optionalMountFieldsAreValid(mount)),
+        volumes: readMounts("volumes", (mount) => typeof mount["name"] === "string"
+            && typeof mount["path"] === "string"
+            && optionalMountFieldsAreValid(mount)),
+        empty_dirs: readMounts("empty_dirs", (mount) => typeof mount["path"] === "string"
+            && (mount["read_only"] === undefined || typeof mount["read_only"] === "boolean")),
+        configs: readMounts("configs", (mount) => mount["path"] === undefined || mount["path"] === null || typeof mount["path"] === "string"),
+        files: readMounts("files", (mount) => typeof mount["path"] === "string"
+            && (mount["read_only"] === undefined || typeof mount["read_only"] === "boolean")
+            && (mount["text"] === undefined || mount["text"] === null || typeof mount["text"] === "string")),
+    };
+}
 function toStringMapList(values) {
     return Object.entries(values).map(([key, value]) => ({ key, value }));
 }
@@ -904,6 +936,7 @@ class ContainersClient {
             const imageIdRaw = entry["image_id"];
             const portsRaw = entry["ports"];
             const serviceIdRaw = entry["service_id"];
+            const mountsRaw = entry["mounts"];
             const statsRaw = entry["stats"];
             const exitStatusRaw = entry["exit_status"];
             if (!Array.isArray(portsRaw) ||
@@ -964,6 +997,7 @@ class ContainersClient {
                 state,
                 private: privateFlag,
                 serviceId: typeof serviceIdRaw === "string" ? serviceIdRaw : undefined,
+                mounts: parseContainerMountSpec(mountsRaw),
                 stats,
                 exitStatus,
             });

package/dist/node/entrypoint.d.ts

@@ -16,6 +16,7 @@ export var ServerXmlDocument: {
             ignoreRemoteMapChanges: UndoManagerOptions;
             captureTimeout: UndoManagerOptions;
             afterTransactionHandler: (transaction: any) => void;
+            destroy(): void;
             addToScope(ytypes: Array<any | {
                 gc: DocOpts;
                 gcFilter: DocOpts;

package/dist/node/entrypoint.js

@@ -3038,10 +3038,9 @@ var UndoManager = class extends ObservableV2 {
                 this.emit("stack-item-updated", changeEvent);
             }
         };
+        this.destroy = this.destroy.bind(this);
         this.doc.on("afterTransaction", this.afterTransactionHandler);
-        this.doc.on("destroy", () => {
-            this.destroy();
-        });
+        this.doc.on("destroy", this.destroy);
     }
     addToScope(ytypes) {
         const tmpSet = new Set(this.scope);
@@ -3110,6 +3109,7 @@ var UndoManager = class extends ObservableV2 {
     destroy() {
         this.trackedOrigins.delete(this);
         this.doc.off("afterTransaction", this.afterTransactionHandler);
+        this.doc.off("destroy", this.destroy);
         super.destroy();
     }
 };

package/dist/node/index.d.ts

@@ -10,6 +10,7 @@ export * from './document.js';
 export * from './meshagent-client.js';
 export * from './messaging-client.js';
 export * from './memory-client.js';
+export * from './mounts-client.js';
 export * from './oauth-scopes.js';
 export * from './participant-token.js';
 export * from './participant.js';

package/dist/node/index.js

@@ -26,6 +26,7 @@ __exportStar(require("./document.js"), exports);
 __exportStar(require("./meshagent-client.js"), exports);
 __exportStar(require("./messaging-client.js"), exports);
 __exportStar(require("./memory-client.js"), exports);
+__exportStar(require("./mounts-client.js"), exports);
 __exportStar(require("./oauth-scopes.js"), exports);
 __exportStar(require("./participant-token.js"), exports);
 __exportStar(require("./participant.js"), exports);

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

@@ -235,6 +235,12 @@ export interface RoomStorageMountSpec {
     subpath?: string | null;
     read_only?: boolean;
 }
+export interface VolumeStorageMountSpec {
+    name: string;
+    path: string;
+    subpath?: string | null;
+    read_only?: boolean;
+}
 export interface EmptyDirMountSpec {
     path: string;
     read_only?: boolean;
@@ -249,6 +255,7 @@ export interface FileMountSpec {
 }
 export interface ContainerMountSpec {
     room?: RoomStorageMountSpec[];
+    volumes?: VolumeStorageMountSpec[];
     empty_dirs?: EmptyDirMountSpec[];
     configs?: ConfigMountSpec[];
     files?: FileMountSpec[];

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

@@ -0,0 +1,21 @@
+import type { RoomClient } from "./room-client.js";
+export interface MountedVolumeConsumer {
+    kind: "room" | "container";
+    containerId?: string;
+}
+export interface MountedVolume {
+    id: string;
+    name: string;
+    required: boolean;
+    description: string;
+    metadata: Record<string, unknown>;
+    annotations: Record<string, string>;
+    storageClass: "standard" | "juice" | "zerofs";
+    maxSizeMb?: number;
+    consumers: MountedVolumeConsumer[];
+}
+export declare class MountsClient {
+    private readonly room;
+    constructor(room: RoomClient);
+    list(): Promise<MountedVolume[]>;
+}

package/dist/node/mounts-client.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MountsClient = void 0;
+const response_js_1 = require("./response.js");
+const room_server_client_js_1 = require("./room-server-client.js");
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseMountedVolume(value) {
+    if (!isRecord(value)
+        || typeof value["id"] !== "string"
+        || typeof value["name"] !== "string"
+        || typeof value["required"] !== "boolean") {
+        throw new room_server_client_js_1.RoomServerException("unexpected return type from mounts.list");
+    }
+    const metadata = isRecord(value["metadata"]) ? value["metadata"] : {};
+    const rawAnnotations = isRecord(value["annotations"]) ? value["annotations"] : {};
+    const annotations = {};
+    for (const [key, item] of Object.entries(rawAnnotations)) {
+        if (typeof item === "string") {
+            annotations[key] = item;
+        }
+    }
+    const rawConsumers = value["consumers"] ?? [];
+    if (!Array.isArray(rawConsumers)) {
+        throw new room_server_client_js_1.RoomServerException("unexpected return type from mounts.list");
+    }
+    const consumers = rawConsumers.map((consumer) => {
+        if (!isRecord(consumer)
+            || (consumer["kind"] !== "room" && consumer["kind"] !== "container")
+            || (consumer["kind"] === "container" && typeof consumer["container_id"] !== "string")
+            || (consumer["kind"] === "room" && consumer["container_id"] !== undefined)) {
+            throw new room_server_client_js_1.RoomServerException("unexpected return type from mounts.list");
+        }
+        return {
+            kind: consumer["kind"],
+            containerId: typeof consumer["container_id"] === "string"
+                ? consumer["container_id"]
+                : undefined,
+        };
+    });
+    const storageClass = value["storage_class"] ?? "standard";
+    if (storageClass !== "standard" && storageClass !== "juice" && storageClass !== "zerofs") {
+        throw new room_server_client_js_1.RoomServerException("unexpected return type from mounts.list");
+    }
+    const maxSizeMb = value["max_size_mb"];
+    if (maxSizeMb !== undefined && (typeof maxSizeMb !== "number" || !Number.isInteger(maxSizeMb) || maxSizeMb <= 0)) {
+        throw new room_server_client_js_1.RoomServerException("unexpected return type from mounts.list");
+    }
+    return {
+        id: value["id"],
+        name: value["name"],
+        required: value["required"],
+        description: typeof value["description"] === "string" ? value["description"] : "",
+        metadata,
+        annotations,
+        storageClass,
+        maxSizeMb,
+        consumers,
+    };
+}
+class MountsClient {
+    constructor(room) {
+        this.room = room;
+    }
+    async list() {
+        const response = await this.room.invokeContent({
+            toolkit: "mounts",
+            tool: "list",
+            input: {},
+        });
+        if (!(response instanceof response_js_1.JsonContent)) {
+            throw new room_server_client_js_1.RoomServerException("unexpected return type from mounts.list");
+        }
+        const volumes = response.json["volumes"];
+        if (!Array.isArray(volumes)) {
+            throw new room_server_client_js_1.RoomServerException("unexpected return type from mounts.list");
+        }
+        return volumes.map(parseMountedVolume);
+    }
+}
+exports.MountsClient = MountsClient;

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

@@ -4,6 +4,7 @@ import { DeveloperClient } from "./developer-client.js";
 import { type EventHandler, type EventName } from "./event-emitter.js";
 import { MessagingClient } from "./messaging-client.js";
 import { MemoryClient } from "./memory-client.js";
+import { MountsClient } from "./mounts-client.js";
 import { LocalParticipant } from "./participant.js";
 import { Protocol, ProtocolCloseKind, type MessageHandler, type ProtocolFactory } from "./protocol.js";
 import { QueuesClient } from "./queues-client.js";
@@ -59,6 +60,7 @@ export declare class RoomClient {
     readonly containers: ContainersClient;
     readonly memory: MemoryClient;
     readonly services: ServicesClient;
+    readonly mounts: MountsClient;
     _protocolInstance: Protocol;
     _entered: boolean;
     _allowDisconnectedRequests: boolean;

package/dist/node/room-client.js

@@ -8,6 +8,7 @@ const developer_client_js_1 = require("./developer-client.js");
 const event_emitter_js_1 = require("./event-emitter.js");
 const messaging_client_js_1 = require("./messaging-client.js");
 const memory_client_js_1 = require("./memory-client.js");
+const mounts_client_js_1 = require("./mounts-client.js");
 const participant_js_1 = require("./participant.js");
 const protocol_js_1 = require("./protocol.js");
 const queues_client_js_1 = require("./queues-client.js");
@@ -261,6 +262,7 @@ class RoomClient {
         this.containers = new containers_client_js_1.ContainersClient({ room: this });
         this.memory = new memory_client_js_1.MemoryClient({ room: this });
         this.services = new services_client_js_1.ServicesClient({ room: this });
+        this.mounts = new mounts_client_js_1.MountsClient(this);
     }
     static withIAP({ url = "./.well-known/meshagent/room/connect", reconnectTimeout = null, } = {}) {
         return new RoomClient({

package/package.json

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