@meshagent/meshagent 0.38.2 → 0.38.4

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [0.38.4]
+- Stability
+
+## [0.38.3]
+- Breaking: TypeScript container image summaries now use `references`/`preferredRef` and metadata fields (timestamps/media type), and `inspectImage` returns manifests/layers/content size; `tags`/`size` are removed.
+- `getUsage` now supports filters for users, room, provider, model, and usage type.
+- Room connection and errors improved: `RoomServerException` now carries `statusCode` and `retryable`, and `RoomClient` can route OAuth/secret requests via handler options.
+- React hooks add robust connection retry/backoff, new authorization helpers, and optional secret/OAuth handlers; document connection now supports schema/initial JSON and improved cleanup.
+- New Livekit support (client + protocol channel) and room participant hook; hosted toolkits are now shared per room to avoid duplicate starts.
+- Breaking: `meshagent-react` no longer exports the legacy chat and file-upload modules.
+- Tailwind chat UI is rebuilt with multi-thread support, new thread creation via agent tools, and file attachment utilities, with new exports for thread and conversation helpers.
+
 ## [0.38.2]
 - Stability
 

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

@@ -9,9 +9,33 @@ export interface DockerSecret {
 }
 export interface ContainerImage {
     id: string;
-    tags: string[];
-    size?: number;
+    preferredRef?: string | null;
+    references: string[];
     labels: Record<string, string>;
+    createdAt?: Date | null;
+    updatedAt?: Date | null;
+    targetMediaType?: string | null;
+}
+export interface ContainerImageDescriptor {
+    digest: string;
+    mediaType?: string | null;
+    size?: number;
+    annotations: Record<string, string>;
+}
+export interface ContainerImageManifest {
+    descriptor: ContainerImageDescriptor;
+    platformOs?: string | null;
+    platformArchitecture?: string | null;
+    platformVariant?: string | null;
+}
+export interface ContainerImageInspection {
+    image: ContainerImage;
+    target: ContainerImageDescriptor;
+    selectedManifest?: ContainerImageDescriptor | null;
+    manifests: ContainerImageManifest[];
+    config?: ContainerImageDescriptor | null;
+    layers: ContainerImageDescriptor[];
+    contentSize?: number;
 }
 export interface ImportedImage {
     resolvedRef: string;
@@ -96,6 +120,9 @@ export declare class ContainersClient {
     private unexpectedResponseError;
     private invoke;
     listImages(): Promise<ContainerImage[]>;
+    inspectImage(params: {
+        imageId: string;
+    }): Promise<ContainerImageInspection>;
     deleteImage(params: {
         image: string;
     }): Promise<void>;

package/dist/browser/containers-client.js

@@ -52,6 +52,30 @@ function readOptionalIntegerField(data, field, operation) {
     }
     return value;
 }
+function readOptionalStringField(data, field, operation) {
+    const value = data[field];
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (typeof value !== "string") {
+        throw new room_server_client_1.RoomServerException(`unexpected return type from containers.${operation}`);
+    }
+    return value;
+}
+function parseTimestampField(data, field, operation) {
+    const value = data[field];
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (typeof value !== "string") {
+        throw new room_server_client_1.RoomServerException(`unexpected return type from containers.${operation}`);
+    }
+    const timestamp = new Date(value);
+    if (Number.isNaN(timestamp.getTime())) {
+        throw new room_server_client_1.RoomServerException(`unexpected return type from containers.${operation}`);
+    }
+    return timestamp;
+}
 function decodeUtf8(data, operation) {
     try {
         return new TextDecoder("utf-8", { fatal: true }).decode(data);
@@ -109,6 +133,98 @@ function normalizeImageLabels(labelsRaw, operation) {
     }
     throw new room_server_client_1.RoomServerException(`unexpected return type from containers.${operation}`);
 }
+function normalizeImageReferences(entry, operation) {
+    const referencesRaw = entry["references"];
+    if (Array.isArray(referencesRaw)) {
+        const references = referencesRaw.filter((item) => typeof item === "string");
+        if (references.length !== referencesRaw.length) {
+            throw new room_server_client_1.RoomServerException(`unexpected return type from containers.${operation}`);
+        }
+        return references;
+    }
+    const tagsRaw = entry["tags"];
+    if (Array.isArray(tagsRaw)) {
+        const references = tagsRaw.filter((item) => typeof item === "string");
+        if (references.length !== tagsRaw.length) {
+            throw new room_server_client_1.RoomServerException(`unexpected return type from containers.${operation}`);
+        }
+        return references;
+    }
+    if (referencesRaw === undefined || referencesRaw === null) {
+        return [];
+    }
+    throw new room_server_client_1.RoomServerException(`unexpected return type from containers.${operation}`);
+}
+function parseContainerImage(entry, operation) {
+    const references = normalizeImageReferences(entry, operation);
+    const preferredRef = readOptionalStringField(entry, "preferred_ref", operation) ?? references[0];
+    return {
+        id: readStringField(entry, "id", operation),
+        preferredRef,
+        references,
+        labels: normalizeImageLabels(entry["labels"], operation),
+        createdAt: parseTimestampField(entry, "created_at", operation),
+        updatedAt: parseTimestampField(entry, "updated_at", operation),
+        targetMediaType: readOptionalStringField(entry, "target_media_type", operation),
+    };
+}
+function parseContainerImageDescriptor(entry, operation) {
+    return {
+        digest: readStringField(entry, "digest", operation),
+        mediaType: readOptionalStringField(entry, "media_type", operation),
+        size: readOptionalIntegerField(entry, "size", operation),
+        annotations: normalizeImageLabels(entry["annotations"], operation),
+    };
+}
+function parseOptionalContainerImageDescriptor(value, operation) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (!isRecord(value)) {
+        throw new room_server_client_1.RoomServerException(`unexpected return type from containers.${operation}`);
+    }
+    return parseContainerImageDescriptor(value, operation);
+}
+function parseContainerImageManifest(entry, operation) {
+    const descriptorRaw = entry["descriptor"];
+    if (!isRecord(descriptorRaw)) {
+        throw new room_server_client_1.RoomServerException(`unexpected return type from containers.${operation}`);
+    }
+    return {
+        descriptor: parseContainerImageDescriptor(descriptorRaw, operation),
+        platformOs: readOptionalStringField(entry, "platform_os", operation),
+        platformArchitecture: readOptionalStringField(entry, "platform_architecture", operation),
+        platformVariant: readOptionalStringField(entry, "platform_variant", operation),
+    };
+}
+function parseContainerImageInspection(entry, operation) {
+    const imageRaw = entry["image"];
+    const targetRaw = entry["target"];
+    const manifestsRaw = entry["manifests"];
+    const layersRaw = entry["layers"];
+    if (!isRecord(imageRaw) || !isRecord(targetRaw) || !Array.isArray(manifestsRaw) || !Array.isArray(layersRaw)) {
+        throw new room_server_client_1.RoomServerException(`unexpected return type from containers.${operation}`);
+    }
+    return {
+        image: parseContainerImage(imageRaw, operation),
+        target: parseContainerImageDescriptor(targetRaw, operation),
+        selectedManifest: parseOptionalContainerImageDescriptor(entry["selected_manifest"], operation),
+        manifests: manifestsRaw.map((manifest) => {
+            if (!isRecord(manifest)) {
+                throw new room_server_client_1.RoomServerException(`unexpected return type from containers.${operation}`);
+            }
+            return parseContainerImageManifest(manifest, operation);
+        }),
+        config: parseOptionalContainerImageDescriptor(entry["config"], operation),
+        layers: layersRaw.map((layer) => {
+            if (!isRecord(layer)) {
+                throw new room_server_client_1.RoomServerException(`unexpected return type from containers.${operation}`);
+            }
+            return parseContainerImageDescriptor(layer, operation);
+        }),
+        contentSize: readOptionalIntegerField(entry, "content_size", operation),
+    };
+}
 function parseImportedImage(data, operation) {
     const resolvedRef = data["resolved_ref"];
     const refsRaw = data["refs"];
@@ -303,23 +419,19 @@ class ContainersClient {
             if (!isRecord(entry)) {
                 throw this.unexpectedResponseError("list_images");
             }
-            const id = entry["id"];
-            const tags = entry["tags"];
-            const labelsRaw = entry["labels"];
-            if (typeof id !== "string" || !Array.isArray(tags)) {
-                throw this.unexpectedResponseError("list_images");
-            }
-            const normalizedTags = tags.filter((tag) => typeof tag === "string");
-            const size = entry["size"];
-            images.push({
-                id,
-                tags: normalizedTags,
-                size: typeof size === "number" ? size : undefined,
-                labels: normalizeImageLabels(labelsRaw, "list_images"),
-            });
+            images.push(parseContainerImage(entry, "list_images"));
         }
         return images;
     }
+    async inspectImage(params) {
+        const output = await this.invoke("inspect_image", {
+            image_id: params.imageId,
+        });
+        if (!(output instanceof response_1.JsonContent) || !isRecord(output.json)) {
+            throw this.unexpectedResponseError("inspect_image");
+        }
+        return parseContainerImageInspection(output.json, "inspect_image");
+    }
     async deleteImage(params) {
         await this.invoke("delete_image", {
             image: params.image,

package/dist/browser/helpers.d.ts

@@ -1,7 +1,7 @@
 import { MeshSchema } from './schema';
 import { RoomClient } from './room-client';
 import { ParticipantToken } from './participant-token';
-import { ProtocolFactory } from './protocol';
+import type { ProtocolFactory } from './protocol';
 export declare function validateSchemaName(name: string): void;
 export declare function deploySchema({ room, schema, name, overwrite }: {
     room: RoomClient;

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

@@ -360,6 +360,11 @@ export declare class Meshagent {
         end?: Date;
         interval?: string;
         report?: string;
+        users?: string[];
+        room?: string;
+        provider?: string;
+        model?: string;
+        usageType?: string;
     }): Promise<Record<string, unknown>[]>;
     getSession(projectId: string, sessionId: string): Promise<Record<string, unknown>>;
     listActiveSessions(projectId: string): Promise<RoomSession[]>;

package/dist/browser/meshagent-client.js

@@ -784,13 +784,18 @@ class Meshagent {
         });
     }
     async getUsage(projectId, options = {}) {
-        const { start, end, interval, report } = options;
+        const { start, end, interval, report, users, room, provider, model, usageType } = options;
         const data = await this.request(`/accounts/projects/${projectId}/usage`, {
             query: {
                 start: start ? start.toISOString() : undefined,
                 end: end ? end.toISOString() : undefined,
                 interval,
                 report,
+                users: users && users.length > 0 ? users.join(",") : undefined,
+                room: room && room.trim().length > 0 ? room.trim() : undefined,
+                provider: provider && provider.trim().length > 0 ? provider.trim() : undefined,
+                model: model && model.trim().length > 0 ? model.trim() : undefined,
+                usage_type: usageType && usageType.trim().length > 0 ? usageType.trim() : undefined,
             },
             action: "retrieve usage",
         });

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

@@ -4,12 +4,12 @@ import { type EventHandler, type EventName } from "./event-emitter";
 import { MessagingClient } from "./messaging-client";
 import { MemoryClient } from "./memory-client";
 import { LocalParticipant } from "./participant";
-import { Protocol, ProtocolCloseKind, ProtocolFactory, type MessageHandler } from "./protocol";
+import { Protocol, ProtocolCloseKind, type MessageHandler, type ProtocolFactory } from "./protocol";
 import { QueuesClient } from "./queues-client";
-import { Content } from "./response";
+import type { Content } from "./response";
 import { RoomEvent } from "./room-event";
 import { RoomServerException } from "./room-server-client";
-import { SecretsClient } from "./secrets-client";
+import { SecretsClient, type OAuthTokenRequestHandler, type SecretRequestHandler } from "./secrets-client";
 import { ServicesClient } from "./services-client";
 import { StorageClient } from "./storage-client";
 import { SyncClient } from "./sync-client";
@@ -91,9 +91,11 @@ export declare class RoomClient {
     private readonly _handleParticipantBound;
     private readonly _handleResponseBound;
     private readonly _handleToolCallResponseChunkBound;
-    constructor({ protocolFactory, reconnectTimeout, }?: {
+    constructor({ protocolFactory, reconnectTimeout, oauthTokenRequestHandler, secretRequestHandler, }?: {
         protocolFactory?: ProtocolFactory | null;
         reconnectTimeout?: number | null;
+        oauthTokenRequestHandler?: OAuthTokenRequestHandler;
+        secretRequestHandler?: SecretRequestHandler;
     });
     get localParticipant(): LocalParticipant | null;
     get ready(): Promise<void>;

package/dist/browser/room-client.js

@@ -203,7 +203,7 @@ class RoomProtocolProxy {
 }
 exports.RoomProtocolProxy = RoomProtocolProxy;
 class RoomClient {
-    constructor({ protocolFactory = null, reconnectTimeout = null, } = {}) {
+    constructor({ protocolFactory = null, reconnectTimeout = null, oauthTokenRequestHandler, secretRequestHandler, } = {}) {
         this._entered = false;
         this._allowDisconnectedRequests = false;
         this._eventsController = new stream_controller_1.StreamController();
@@ -250,7 +250,11 @@ class RoomClient {
         this.queues = new queues_client_1.QueuesClient({ room: this });
         this.database = new database_client_1.DatabaseClient({ room: this });
         this.agents = new agent_client_1.AgentsClient({ room: this });
-        this.secrets = new secrets_client_1.SecretsClient({ room: this });
+        this.secrets = new secrets_client_1.SecretsClient({
+            room: this,
+            oauthTokenRequestHandler,
+            secretRequestHandler,
+        });
         this.containers = new containers_client_1.ContainersClient({ room: this });
         this.memory = new memory_client_1.MemoryClient({ room: this });
         this.services = new services_client_1.ServicesClient({ room: this });

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

@@ -2,8 +2,13 @@ import { RuntimeDocument } from "./document";
 import { MeshSchema } from "./schema";
 export type Uint8List = Uint8Array;
 export declare class RoomServerException extends Error {
+    readonly statusCode?: number;
     readonly code?: number;
-    constructor(message: string, code?: number);
+    readonly retryable: boolean;
+    constructor(message: string, code?: number, { statusCode, retryable, }?: {
+        statusCode?: number;
+        retryable?: boolean;
+    });
 }
 export declare class MeshDocument extends RuntimeDocument {
     private _synchronized;

package/dist/browser/room-server-client.js

@@ -6,10 +6,12 @@ const document_1 = require("./document");
 const completer_1 = require("./completer");
 const runtime_1 = require("./runtime");
 class RoomServerException extends Error {
-    constructor(message, code) {
+    constructor(message, code, { statusCode, retryable = false, } = {}) {
         super(message);
         this.name = "RoomServerException";
+        this.statusCode = statusCode;
         this.code = code;
+        this.retryable = retryable;
     }
 }
 exports.RoomServerException = RoomServerException;

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

@@ -9,9 +9,33 @@ export interface DockerSecret {
 }
 export interface ContainerImage {
     id: string;
-    tags: string[];
-    size?: number;
+    preferredRef?: string | null;
+    references: string[];
     labels: Record<string, string>;
+    createdAt?: Date | null;
+    updatedAt?: Date | null;
+    targetMediaType?: string | null;
+}
+export interface ContainerImageDescriptor {
+    digest: string;
+    mediaType?: string | null;
+    size?: number;
+    annotations: Record<string, string>;
+}
+export interface ContainerImageManifest {
+    descriptor: ContainerImageDescriptor;
+    platformOs?: string | null;
+    platformArchitecture?: string | null;
+    platformVariant?: string | null;
+}
+export interface ContainerImageInspection {
+    image: ContainerImage;
+    target: ContainerImageDescriptor;
+    selectedManifest?: ContainerImageDescriptor | null;
+    manifests: ContainerImageManifest[];
+    config?: ContainerImageDescriptor | null;
+    layers: ContainerImageDescriptor[];
+    contentSize?: number;
 }
 export interface ImportedImage {
     resolvedRef: string;
@@ -96,6 +120,9 @@ export declare class ContainersClient {
     private unexpectedResponseError;
     private invoke;
     listImages(): Promise<ContainerImage[]>;
+    inspectImage(params: {
+        imageId: string;
+    }): Promise<ContainerImageInspection>;
     deleteImage(params: {
         image: string;
     }): Promise<void>;

package/dist/esm/containers-client.js

@@ -49,6 +49,30 @@ function readOptionalIntegerField(data, field, operation) {
     }
     return value;
 }
+function readOptionalStringField(data, field, operation) {
+    const value = data[field];
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (typeof value !== "string") {
+        throw new RoomServerException(`unexpected return type from containers.${operation}`);
+    }
+    return value;
+}
+function parseTimestampField(data, field, operation) {
+    const value = data[field];
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (typeof value !== "string") {
+        throw new RoomServerException(`unexpected return type from containers.${operation}`);
+    }
+    const timestamp = new Date(value);
+    if (Number.isNaN(timestamp.getTime())) {
+        throw new RoomServerException(`unexpected return type from containers.${operation}`);
+    }
+    return timestamp;
+}
 function decodeUtf8(data, operation) {
     try {
         return new TextDecoder("utf-8", { fatal: true }).decode(data);
@@ -106,6 +130,98 @@ function normalizeImageLabels(labelsRaw, operation) {
     }
     throw new RoomServerException(`unexpected return type from containers.${operation}`);
 }
+function normalizeImageReferences(entry, operation) {
+    const referencesRaw = entry["references"];
+    if (Array.isArray(referencesRaw)) {
+        const references = referencesRaw.filter((item) => typeof item === "string");
+        if (references.length !== referencesRaw.length) {
+            throw new RoomServerException(`unexpected return type from containers.${operation}`);
+        }
+        return references;
+    }
+    const tagsRaw = entry["tags"];
+    if (Array.isArray(tagsRaw)) {
+        const references = tagsRaw.filter((item) => typeof item === "string");
+        if (references.length !== tagsRaw.length) {
+            throw new RoomServerException(`unexpected return type from containers.${operation}`);
+        }
+        return references;
+    }
+    if (referencesRaw === undefined || referencesRaw === null) {
+        return [];
+    }
+    throw new RoomServerException(`unexpected return type from containers.${operation}`);
+}
+function parseContainerImage(entry, operation) {
+    const references = normalizeImageReferences(entry, operation);
+    const preferredRef = readOptionalStringField(entry, "preferred_ref", operation) ?? references[0];
+    return {
+        id: readStringField(entry, "id", operation),
+        preferredRef,
+        references,
+        labels: normalizeImageLabels(entry["labels"], operation),
+        createdAt: parseTimestampField(entry, "created_at", operation),
+        updatedAt: parseTimestampField(entry, "updated_at", operation),
+        targetMediaType: readOptionalStringField(entry, "target_media_type", operation),
+    };
+}
+function parseContainerImageDescriptor(entry, operation) {
+    return {
+        digest: readStringField(entry, "digest", operation),
+        mediaType: readOptionalStringField(entry, "media_type", operation),
+        size: readOptionalIntegerField(entry, "size", operation),
+        annotations: normalizeImageLabels(entry["annotations"], operation),
+    };
+}
+function parseOptionalContainerImageDescriptor(value, operation) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (!isRecord(value)) {
+        throw new RoomServerException(`unexpected return type from containers.${operation}`);
+    }
+    return parseContainerImageDescriptor(value, operation);
+}
+function parseContainerImageManifest(entry, operation) {
+    const descriptorRaw = entry["descriptor"];
+    if (!isRecord(descriptorRaw)) {
+        throw new RoomServerException(`unexpected return type from containers.${operation}`);
+    }
+    return {
+        descriptor: parseContainerImageDescriptor(descriptorRaw, operation),
+        platformOs: readOptionalStringField(entry, "platform_os", operation),
+        platformArchitecture: readOptionalStringField(entry, "platform_architecture", operation),
+        platformVariant: readOptionalStringField(entry, "platform_variant", operation),
+    };
+}
+function parseContainerImageInspection(entry, operation) {
+    const imageRaw = entry["image"];
+    const targetRaw = entry["target"];
+    const manifestsRaw = entry["manifests"];
+    const layersRaw = entry["layers"];
+    if (!isRecord(imageRaw) || !isRecord(targetRaw) || !Array.isArray(manifestsRaw) || !Array.isArray(layersRaw)) {
+        throw new RoomServerException(`unexpected return type from containers.${operation}`);
+    }
+    return {
+        image: parseContainerImage(imageRaw, operation),
+        target: parseContainerImageDescriptor(targetRaw, operation),
+        selectedManifest: parseOptionalContainerImageDescriptor(entry["selected_manifest"], operation),
+        manifests: manifestsRaw.map((manifest) => {
+            if (!isRecord(manifest)) {
+                throw new RoomServerException(`unexpected return type from containers.${operation}`);
+            }
+            return parseContainerImageManifest(manifest, operation);
+        }),
+        config: parseOptionalContainerImageDescriptor(entry["config"], operation),
+        layers: layersRaw.map((layer) => {
+            if (!isRecord(layer)) {
+                throw new RoomServerException(`unexpected return type from containers.${operation}`);
+            }
+            return parseContainerImageDescriptor(layer, operation);
+        }),
+        contentSize: readOptionalIntegerField(entry, "content_size", operation),
+    };
+}
 function parseImportedImage(data, operation) {
     const resolvedRef = data["resolved_ref"];
     const refsRaw = data["refs"];
@@ -299,23 +415,19 @@ export class ContainersClient {
             if (!isRecord(entry)) {
                 throw this.unexpectedResponseError("list_images");
             }
-            const id = entry["id"];
-            const tags = entry["tags"];
-            const labelsRaw = entry["labels"];
-            if (typeof id !== "string" || !Array.isArray(tags)) {
-                throw this.unexpectedResponseError("list_images");
-            }
-            const normalizedTags = tags.filter((tag) => typeof tag === "string");
-            const size = entry["size"];
-            images.push({
-                id,
-                tags: normalizedTags,
-                size: typeof size === "number" ? size : undefined,
-                labels: normalizeImageLabels(labelsRaw, "list_images"),
-            });
+            images.push(parseContainerImage(entry, "list_images"));
         }
         return images;
     }
+    async inspectImage(params) {
+        const output = await this.invoke("inspect_image", {
+            image_id: params.imageId,
+        });
+        if (!(output instanceof JsonContent) || !isRecord(output.json)) {
+            throw this.unexpectedResponseError("inspect_image");
+        }
+        return parseContainerImageInspection(output.json, "inspect_image");
+    }
     async deleteImage(params) {
         await this.invoke("delete_image", {
             image: params.image,

package/dist/esm/helpers.d.ts

@@ -1,7 +1,7 @@
 import { MeshSchema } from './schema';
 import { RoomClient } from './room-client';
 import { ParticipantToken } from './participant-token';
-import { ProtocolFactory } from './protocol';
+import type { ProtocolFactory } from './protocol';
 export declare function validateSchemaName(name: string): void;
 export declare function deploySchema({ room, schema, name, overwrite }: {
     room: RoomClient;

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

@@ -360,6 +360,11 @@ export declare class Meshagent {
         end?: Date;
         interval?: string;
         report?: string;
+        users?: string[];
+        room?: string;
+        provider?: string;
+        model?: string;
+        usageType?: string;
     }): Promise<Record<string, unknown>[]>;
     getSession(projectId: string, sessionId: string): Promise<Record<string, unknown>>;
     listActiveSessions(projectId: string): Promise<RoomSession[]>;

package/dist/esm/meshagent-client.js

@@ -781,13 +781,18 @@ export class Meshagent {
         });
     }
     async getUsage(projectId, options = {}) {
-        const { start, end, interval, report } = options;
+        const { start, end, interval, report, users, room, provider, model, usageType } = options;
         const data = await this.request(`/accounts/projects/${projectId}/usage`, {
             query: {
                 start: start ? start.toISOString() : undefined,
                 end: end ? end.toISOString() : undefined,
                 interval,
                 report,
+                users: users && users.length > 0 ? users.join(",") : undefined,
+                room: room && room.trim().length > 0 ? room.trim() : undefined,
+                provider: provider && provider.trim().length > 0 ? provider.trim() : undefined,
+                model: model && model.trim().length > 0 ? model.trim() : undefined,
+                usage_type: usageType && usageType.trim().length > 0 ? usageType.trim() : undefined,
             },
             action: "retrieve usage",
         });

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

@@ -4,12 +4,12 @@ import { type EventHandler, type EventName } from "./event-emitter";
 import { MessagingClient } from "./messaging-client";
 import { MemoryClient } from "./memory-client";
 import { LocalParticipant } from "./participant";
-import { Protocol, ProtocolCloseKind, ProtocolFactory, type MessageHandler } from "./protocol";
+import { Protocol, ProtocolCloseKind, type MessageHandler, type ProtocolFactory } from "./protocol";
 import { QueuesClient } from "./queues-client";
-import { Content } from "./response";
+import type { Content } from "./response";
 import { RoomEvent } from "./room-event";
 import { RoomServerException } from "./room-server-client";
-import { SecretsClient } from "./secrets-client";
+import { SecretsClient, type OAuthTokenRequestHandler, type SecretRequestHandler } from "./secrets-client";
 import { ServicesClient } from "./services-client";
 import { StorageClient } from "./storage-client";
 import { SyncClient } from "./sync-client";
@@ -91,9 +91,11 @@ export declare class RoomClient {
     private readonly _handleParticipantBound;
     private readonly _handleResponseBound;
     private readonly _handleToolCallResponseChunkBound;
-    constructor({ protocolFactory, reconnectTimeout, }?: {
+    constructor({ protocolFactory, reconnectTimeout, oauthTokenRequestHandler, secretRequestHandler, }?: {
         protocolFactory?: ProtocolFactory | null;
         reconnectTimeout?: number | null;
+        oauthTokenRequestHandler?: OAuthTokenRequestHandler;
+        secretRequestHandler?: SecretRequestHandler;
     });
     get localParticipant(): LocalParticipant | null;
     get ready(): Promise<void>;

package/dist/esm/room-client.js

@@ -199,7 +199,7 @@ export class RoomProtocolProxy {
     }
 }
 export class RoomClient {
-    constructor({ protocolFactory = null, reconnectTimeout = null, } = {}) {
+    constructor({ protocolFactory = null, reconnectTimeout = null, oauthTokenRequestHandler, secretRequestHandler, } = {}) {
         this._entered = false;
         this._allowDisconnectedRequests = false;
         this._eventsController = new StreamController();
@@ -246,7 +246,11 @@ export class RoomClient {
         this.queues = new QueuesClient({ room: this });
         this.database = new DatabaseClient({ room: this });
         this.agents = new AgentsClient({ room: this });
-        this.secrets = new SecretsClient({ room: this });
+        this.secrets = new SecretsClient({
+            room: this,
+            oauthTokenRequestHandler,
+            secretRequestHandler,
+        });
         this.containers = new ContainersClient({ room: this });
         this.memory = new MemoryClient({ room: this });
         this.services = new ServicesClient({ room: this });

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

@@ -2,8 +2,13 @@ import { RuntimeDocument } from "./document";
 import { MeshSchema } from "./schema";
 export type Uint8List = Uint8Array;
 export declare class RoomServerException extends Error {
+    readonly statusCode?: number;
     readonly code?: number;
-    constructor(message: string, code?: number);
+    readonly retryable: boolean;
+    constructor(message: string, code?: number, { statusCode, retryable, }?: {
+        statusCode?: number;
+        retryable?: boolean;
+    });
 }
 export declare class MeshDocument extends RuntimeDocument {
     private _synchronized;

package/dist/esm/room-server-client.js

@@ -3,10 +3,12 @@ import { RuntimeDocument } from "./document";
 import { Completer } from "./completer";
 import { registerDocument, unregisterDocument, applyChanges, getState, getStateVector, } from "./runtime";
 export class RoomServerException extends Error {
-    constructor(message, code) {
+    constructor(message, code, { statusCode, retryable = false, } = {}) {
         super(message);
         this.name = "RoomServerException";
+        this.statusCode = statusCode;
         this.code = code;
+        this.retryable = retryable;
     }
 }
 export class MeshDocument extends RuntimeDocument {

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

@@ -9,9 +9,33 @@ export interface DockerSecret {
 }
 export interface ContainerImage {
     id: string;
-    tags: string[];
-    size?: number;
+    preferredRef?: string | null;
+    references: string[];
     labels: Record<string, string>;
+    createdAt?: Date | null;
+    updatedAt?: Date | null;
+    targetMediaType?: string | null;
+}
+export interface ContainerImageDescriptor {
+    digest: string;
+    mediaType?: string | null;
+    size?: number;
+    annotations: Record<string, string>;
+}
+export interface ContainerImageManifest {
+    descriptor: ContainerImageDescriptor;
+    platformOs?: string | null;
+    platformArchitecture?: string | null;
+    platformVariant?: string | null;
+}
+export interface ContainerImageInspection {
+    image: ContainerImage;
+    target: ContainerImageDescriptor;
+    selectedManifest?: ContainerImageDescriptor | null;
+    manifests: ContainerImageManifest[];
+    config?: ContainerImageDescriptor | null;
+    layers: ContainerImageDescriptor[];
+    contentSize?: number;
 }
 export interface ImportedImage {
     resolvedRef: string;
@@ -96,6 +120,9 @@ export declare class ContainersClient {
     private unexpectedResponseError;
     private invoke;
     listImages(): Promise<ContainerImage[]>;
+    inspectImage(params: {
+        imageId: string;
+    }): Promise<ContainerImageInspection>;
     deleteImage(params: {
         image: string;
     }): Promise<void>;

package/dist/node/containers-client.js

@@ -52,6 +52,30 @@ function readOptionalIntegerField(data, field, operation) {
     }
     return value;
 }
+function readOptionalStringField(data, field, operation) {
+    const value = data[field];
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (typeof value !== "string") {
+        throw new room_server_client_1.RoomServerException(`unexpected return type from containers.${operation}`);
+    }
+    return value;
+}
+function parseTimestampField(data, field, operation) {
+    const value = data[field];
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (typeof value !== "string") {
+        throw new room_server_client_1.RoomServerException(`unexpected return type from containers.${operation}`);
+    }
+    const timestamp = new Date(value);
+    if (Number.isNaN(timestamp.getTime())) {
+        throw new room_server_client_1.RoomServerException(`unexpected return type from containers.${operation}`);
+    }
+    return timestamp;
+}
 function decodeUtf8(data, operation) {
     try {
         return new TextDecoder("utf-8", { fatal: true }).decode(data);
@@ -109,6 +133,98 @@ function normalizeImageLabels(labelsRaw, operation) {
     }
     throw new room_server_client_1.RoomServerException(`unexpected return type from containers.${operation}`);
 }
+function normalizeImageReferences(entry, operation) {
+    const referencesRaw = entry["references"];
+    if (Array.isArray(referencesRaw)) {
+        const references = referencesRaw.filter((item) => typeof item === "string");
+        if (references.length !== referencesRaw.length) {
+            throw new room_server_client_1.RoomServerException(`unexpected return type from containers.${operation}`);
+        }
+        return references;
+    }
+    const tagsRaw = entry["tags"];
+    if (Array.isArray(tagsRaw)) {
+        const references = tagsRaw.filter((item) => typeof item === "string");
+        if (references.length !== tagsRaw.length) {
+            throw new room_server_client_1.RoomServerException(`unexpected return type from containers.${operation}`);
+        }
+        return references;
+    }
+    if (referencesRaw === undefined || referencesRaw === null) {
+        return [];
+    }
+    throw new room_server_client_1.RoomServerException(`unexpected return type from containers.${operation}`);
+}
+function parseContainerImage(entry, operation) {
+    const references = normalizeImageReferences(entry, operation);
+    const preferredRef = readOptionalStringField(entry, "preferred_ref", operation) ?? references[0];
+    return {
+        id: readStringField(entry, "id", operation),
+        preferredRef,
+        references,
+        labels: normalizeImageLabels(entry["labels"], operation),
+        createdAt: parseTimestampField(entry, "created_at", operation),
+        updatedAt: parseTimestampField(entry, "updated_at", operation),
+        targetMediaType: readOptionalStringField(entry, "target_media_type", operation),
+    };
+}
+function parseContainerImageDescriptor(entry, operation) {
+    return {
+        digest: readStringField(entry, "digest", operation),
+        mediaType: readOptionalStringField(entry, "media_type", operation),
+        size: readOptionalIntegerField(entry, "size", operation),
+        annotations: normalizeImageLabels(entry["annotations"], operation),
+    };
+}
+function parseOptionalContainerImageDescriptor(value, operation) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (!isRecord(value)) {
+        throw new room_server_client_1.RoomServerException(`unexpected return type from containers.${operation}`);
+    }
+    return parseContainerImageDescriptor(value, operation);
+}
+function parseContainerImageManifest(entry, operation) {
+    const descriptorRaw = entry["descriptor"];
+    if (!isRecord(descriptorRaw)) {
+        throw new room_server_client_1.RoomServerException(`unexpected return type from containers.${operation}`);
+    }
+    return {
+        descriptor: parseContainerImageDescriptor(descriptorRaw, operation),
+        platformOs: readOptionalStringField(entry, "platform_os", operation),
+        platformArchitecture: readOptionalStringField(entry, "platform_architecture", operation),
+        platformVariant: readOptionalStringField(entry, "platform_variant", operation),
+    };
+}
+function parseContainerImageInspection(entry, operation) {
+    const imageRaw = entry["image"];
+    const targetRaw = entry["target"];
+    const manifestsRaw = entry["manifests"];
+    const layersRaw = entry["layers"];
+    if (!isRecord(imageRaw) || !isRecord(targetRaw) || !Array.isArray(manifestsRaw) || !Array.isArray(layersRaw)) {
+        throw new room_server_client_1.RoomServerException(`unexpected return type from containers.${operation}`);
+    }
+    return {
+        image: parseContainerImage(imageRaw, operation),
+        target: parseContainerImageDescriptor(targetRaw, operation),
+        selectedManifest: parseOptionalContainerImageDescriptor(entry["selected_manifest"], operation),
+        manifests: manifestsRaw.map((manifest) => {
+            if (!isRecord(manifest)) {
+                throw new room_server_client_1.RoomServerException(`unexpected return type from containers.${operation}`);
+            }
+            return parseContainerImageManifest(manifest, operation);
+        }),
+        config: parseOptionalContainerImageDescriptor(entry["config"], operation),
+        layers: layersRaw.map((layer) => {
+            if (!isRecord(layer)) {
+                throw new room_server_client_1.RoomServerException(`unexpected return type from containers.${operation}`);
+            }
+            return parseContainerImageDescriptor(layer, operation);
+        }),
+        contentSize: readOptionalIntegerField(entry, "content_size", operation),
+    };
+}
 function parseImportedImage(data, operation) {
     const resolvedRef = data["resolved_ref"];
     const refsRaw = data["refs"];
@@ -303,23 +419,19 @@ class ContainersClient {
             if (!isRecord(entry)) {
                 throw this.unexpectedResponseError("list_images");
             }
-            const id = entry["id"];
-            const tags = entry["tags"];
-            const labelsRaw = entry["labels"];
-            if (typeof id !== "string" || !Array.isArray(tags)) {
-                throw this.unexpectedResponseError("list_images");
-            }
-            const normalizedTags = tags.filter((tag) => typeof tag === "string");
-            const size = entry["size"];
-            images.push({
-                id,
-                tags: normalizedTags,
-                size: typeof size === "number" ? size : undefined,
-                labels: normalizeImageLabels(labelsRaw, "list_images"),
-            });
+            images.push(parseContainerImage(entry, "list_images"));
         }
         return images;
     }
+    async inspectImage(params) {
+        const output = await this.invoke("inspect_image", {
+            image_id: params.imageId,
+        });
+        if (!(output instanceof response_1.JsonContent) || !isRecord(output.json)) {
+            throw this.unexpectedResponseError("inspect_image");
+        }
+        return parseContainerImageInspection(output.json, "inspect_image");
+    }
     async deleteImage(params) {
         await this.invoke("delete_image", {
             image: params.image,

package/dist/node/helpers.d.ts

@@ -1,7 +1,7 @@
 import { MeshSchema } from './schema';
 import { RoomClient } from './room-client';
 import { ParticipantToken } from './participant-token';
-import { ProtocolFactory } from './protocol';
+import type { ProtocolFactory } from './protocol';
 export declare function validateSchemaName(name: string): void;
 export declare function deploySchema({ room, schema, name, overwrite }: {
     room: RoomClient;

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

@@ -360,6 +360,11 @@ export declare class Meshagent {
         end?: Date;
         interval?: string;
         report?: string;
+        users?: string[];
+        room?: string;
+        provider?: string;
+        model?: string;
+        usageType?: string;
     }): Promise<Record<string, unknown>[]>;
     getSession(projectId: string, sessionId: string): Promise<Record<string, unknown>>;
     listActiveSessions(projectId: string): Promise<RoomSession[]>;

package/dist/node/meshagent-client.js

@@ -784,13 +784,18 @@ class Meshagent {
         });
     }
     async getUsage(projectId, options = {}) {
-        const { start, end, interval, report } = options;
+        const { start, end, interval, report, users, room, provider, model, usageType } = options;
         const data = await this.request(`/accounts/projects/${projectId}/usage`, {
             query: {
                 start: start ? start.toISOString() : undefined,
                 end: end ? end.toISOString() : undefined,
                 interval,
                 report,
+                users: users && users.length > 0 ? users.join(",") : undefined,
+                room: room && room.trim().length > 0 ? room.trim() : undefined,
+                provider: provider && provider.trim().length > 0 ? provider.trim() : undefined,
+                model: model && model.trim().length > 0 ? model.trim() : undefined,
+                usage_type: usageType && usageType.trim().length > 0 ? usageType.trim() : undefined,
             },
             action: "retrieve usage",
         });

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

@@ -4,12 +4,12 @@ import { type EventHandler, type EventName } from "./event-emitter";
 import { MessagingClient } from "./messaging-client";
 import { MemoryClient } from "./memory-client";
 import { LocalParticipant } from "./participant";
-import { Protocol, ProtocolCloseKind, ProtocolFactory, type MessageHandler } from "./protocol";
+import { Protocol, ProtocolCloseKind, type MessageHandler, type ProtocolFactory } from "./protocol";
 import { QueuesClient } from "./queues-client";
-import { Content } from "./response";
+import type { Content } from "./response";
 import { RoomEvent } from "./room-event";
 import { RoomServerException } from "./room-server-client";
-import { SecretsClient } from "./secrets-client";
+import { SecretsClient, type OAuthTokenRequestHandler, type SecretRequestHandler } from "./secrets-client";
 import { ServicesClient } from "./services-client";
 import { StorageClient } from "./storage-client";
 import { SyncClient } from "./sync-client";
@@ -91,9 +91,11 @@ export declare class RoomClient {
     private readonly _handleParticipantBound;
     private readonly _handleResponseBound;
     private readonly _handleToolCallResponseChunkBound;
-    constructor({ protocolFactory, reconnectTimeout, }?: {
+    constructor({ protocolFactory, reconnectTimeout, oauthTokenRequestHandler, secretRequestHandler, }?: {
         protocolFactory?: ProtocolFactory | null;
         reconnectTimeout?: number | null;
+        oauthTokenRequestHandler?: OAuthTokenRequestHandler;
+        secretRequestHandler?: SecretRequestHandler;
     });
     get localParticipant(): LocalParticipant | null;
     get ready(): Promise<void>;

package/dist/node/room-client.js

@@ -203,7 +203,7 @@ class RoomProtocolProxy {
 }
 exports.RoomProtocolProxy = RoomProtocolProxy;
 class RoomClient {
-    constructor({ protocolFactory = null, reconnectTimeout = null, } = {}) {
+    constructor({ protocolFactory = null, reconnectTimeout = null, oauthTokenRequestHandler, secretRequestHandler, } = {}) {
         this._entered = false;
         this._allowDisconnectedRequests = false;
         this._eventsController = new stream_controller_1.StreamController();
@@ -250,7 +250,11 @@ class RoomClient {
         this.queues = new queues_client_1.QueuesClient({ room: this });
         this.database = new database_client_1.DatabaseClient({ room: this });
         this.agents = new agent_client_1.AgentsClient({ room: this });
-        this.secrets = new secrets_client_1.SecretsClient({ room: this });
+        this.secrets = new secrets_client_1.SecretsClient({
+            room: this,
+            oauthTokenRequestHandler,
+            secretRequestHandler,
+        });
         this.containers = new containers_client_1.ContainersClient({ room: this });
         this.memory = new memory_client_1.MemoryClient({ room: this });
         this.services = new services_client_1.ServicesClient({ room: this });

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

@@ -2,8 +2,13 @@ import { RuntimeDocument } from "./document";
 import { MeshSchema } from "./schema";
 export type Uint8List = Uint8Array;
 export declare class RoomServerException extends Error {
+    readonly statusCode?: number;
     readonly code?: number;
-    constructor(message: string, code?: number);
+    readonly retryable: boolean;
+    constructor(message: string, code?: number, { statusCode, retryable, }?: {
+        statusCode?: number;
+        retryable?: boolean;
+    });
 }
 export declare class MeshDocument extends RuntimeDocument {
     private _synchronized;

package/dist/node/room-server-client.js

@@ -6,10 +6,12 @@ const document_1 = require("./document");
 const completer_1 = require("./completer");
 const runtime_1 = require("./runtime");
 class RoomServerException extends Error {
-    constructor(message, code) {
+    constructor(message, code, { statusCode, retryable = false, } = {}) {
         super(message);
         this.name = "RoomServerException";
+        this.statusCode = statusCode;
         this.code = code;
+        this.retryable = retryable;
     }
 }
 exports.RoomServerException = RoomServerException;

package/package.json

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