@meshagent/meshagent 0.49.1 → 0.51.0

package/CHANGELOG.md

@@ -1,7 +1,21 @@
+## [0.51.0]
+- Refactored the chat UI to split input from feed, simplifying thread and dataset views and removing suggestion-driven behavior.
+- Updated the JavaScript entrypoint and related tests to match the slimmer chat experience.
+
+## [0.50.1]
+- Stability
+
+## [0.50.0]
+- Chat clients now support per-turn LLM authorization providers, and websocket chat tokens are optional for `auth=none` deployments.
+- The typed client gained `connectLlm`, optional access-subject IDs, service-account principals, room and service enabled flags, `llm_quota_manager`, and the `router` project settings document.
+- Chat-thread constructors now take a chat client instead of requiring a room client, which is a breaking signature change for callers.
+- The Tailwind chat package was updated to `tailwindcss` 4.3.3, and the chat and thread UI was refactored for more reliable optimistic streaming plus richer attachment and thread handling.
+
 ## [0.49.1]
 - Stability
 
 ## [0.49.0]
+- Added typed service enable/disable state with backward-compatible enabled defaults.
 - Breaking: `createProject` no longer accepts inline settings; project settings are now document-based with `room_roles` support.
 - Route path models now use a service-port/content-target union and support CORS, compression, index, and IAP for room-content routes.
 - `RoomRole` now includes `guest`, and missing project-settings documents return `undefined`.

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

@@ -1,8 +1,8 @@
 import { ApiScope } from "./participant-token.js";
-export type ProjectRole = "member" | "admin" | "developer" | "room_creator" | "room_inventory" | "room_manager" | "session_inventory" | "agent_creator" | "agent_inventory" | "agent_manager" | "repository_creator" | "repository_inventory" | "repository_manager" | "feed_creator" | "feed_inventory" | "feed_manager" | "oauth_client_creator" | "oauth_client_inventory" | "oauth_client_manager" | "api_key_creator" | "api_key_inventory" | "api_key_manager" | "service_creator" | "service_inventory" | "service_manager" | "service_account_creator" | "service_account_inventory" | "service_account_manager" | "participant_token_creator" | "mailbox_creator" | "mailbox_inventory" | "mailbox_manager" | "route_creator" | "route_inventory" | "route_manager" | "scheduled_task_creator" | "scheduled_task_inventory" | "scheduled_task_manager" | "feed_subscription_creator" | "feed_subscription_inventory" | "feed_subscription_manager" | "llm_logger_creator" | "llm_logger_inventory" | "llm_logger_manager" | "llm_proxy_user" | "usage_reporter" | "billing_manager" | "group_manager";
+export type ProjectRole = "member" | "admin" | "developer" | "room_creator" | "room_inventory" | "room_manager" | "session_inventory" | "agent_creator" | "agent_inventory" | "agent_manager" | "repository_creator" | "repository_inventory" | "repository_manager" | "feed_creator" | "feed_inventory" | "feed_manager" | "oauth_client_creator" | "oauth_client_inventory" | "oauth_client_manager" | "api_key_creator" | "api_key_inventory" | "api_key_manager" | "service_creator" | "service_inventory" | "service_manager" | "service_account_creator" | "service_account_inventory" | "service_account_manager" | "participant_token_creator" | "mailbox_creator" | "mailbox_inventory" | "mailbox_manager" | "route_creator" | "route_inventory" | "route_manager" | "scheduled_task_creator" | "scheduled_task_inventory" | "scheduled_task_manager" | "feed_subscription_creator" | "feed_subscription_inventory" | "feed_subscription_manager" | "llm_logger_creator" | "llm_logger_inventory" | "llm_logger_manager" | "llm_proxy_user" | "llm_quota_manager" | "usage_reporter" | "billing_manager" | "group_manager";
 export type ResourceRole = "viewer" | "operator" | "developer" | "admin";
 export type RoomRole = "site_user" | "guest" | ResourceRole;
-export type ProjectSettingsDocumentName = "openai" | "anthropic" | "otel" | "admission" | "room" | "room_roles";
+export type ProjectSettingsDocumentName = "openai" | "anthropic" | "otel" | "admission" | "room" | "room_roles" | "router";
 export type FeedRole = "reader" | "subscriber" | "publisher" | "manager";
 export type SecretRole = "use_proxy";
 export type AccessRole = ProjectRole | RoomRole | FeedRole | SecretRole | "list";
@@ -10,13 +10,25 @@ export type AccessSubjectType = "user" | "group" | "agent" | "service_account" |
 export type AccessResourceType = "project" | "room" | "agent" | "group" | "repository" | "feed" | "secret";
 export interface AccessSubject {
     type: AccessSubjectType;
-    id: string;
+    id?: string | null;
     name?: string | null;
     firstName?: string | null;
     lastName?: string | null;
     email?: string | null;
     objectType?: "project" | null;
-    relation?: "member" | "developer" | "agent" | null;
+    relation?: "member" | "developer" | "agent" | "service_account" | null;
+}
+export type LlmProvider = "openai" | "anthropic";
+export interface LlmDelegation {
+    id: string;
+    token: string;
+    expiresAt: string;
+    projectId: string;
+    delegator: AccessSubject;
+    subject: AccessSubject;
+    providers?: LlmProvider[] | null;
+    models?: string[] | null;
+    maxBudget: string;
 }
 export interface AccessResource {
     type: AccessResourceType;
@@ -66,6 +78,21 @@ export interface RoomInfo {
     metadata: Record<string, unknown>;
     annotations: Record<string, string>;
 }
+export type RoomAllocationStatus = "Allocated" | "Unallocated";
+export interface RoomStatus {
+    status: RoomAllocationStatus;
+    allocatedAt?: Date | null;
+    runningForSeconds?: number | null;
+}
+export interface RoomLifecycleEvent {
+    id: string;
+    roomName: string;
+    sessionId?: string | null;
+    type: string;
+    message: string;
+    severity?: string | null;
+    createdAt: Date;
+}
 export interface GroupInfo {
     id: string;
     name: string;
@@ -401,6 +428,7 @@ export interface ServiceSpec {
     version: "v1";
     kind: "Service";
     id?: string | null;
+    enabled?: boolean;
     metadata: ServiceMetadata;
     agents?: AgentSpec[] | null;
     ports?: PortSpec[];
@@ -578,6 +606,8 @@ export declare class Meshagent {
     private secretVersionPayload;
     private parseRoomSession;
     private parseRoom;
+    private parseRoomStatus;
+    private parseRoomLifecycleEvent;
     private parseGroup;
     private parseRoute;
     private parseFeed;
@@ -587,6 +617,7 @@ export declare class Meshagent {
     private parseAccessResource;
     private parseAccessSubject;
     private serializeAccessSubject;
+    private parseLlmDelegation;
     private serializeAccessResource;
     private parseProjectMember;
     private parseGroupMember;
@@ -900,6 +931,10 @@ export declare class Meshagent {
         annotations?: Record<string, string>;
     }): Promise<RoomInfo>;
     getRoom(projectId: string, name: string): Promise<RoomInfo>;
+    getRoomStatus(projectId: string, name: string): Promise<RoomStatus>;
+    listRoomEvents(projectId: string, name: string, options?: {
+        limit?: number;
+    }): Promise<RoomLifecycleEvent[]>;
     updateRoom(projectId: string, roomId: string, name: string, options?: {
         metadata?: Record<string, unknown>;
         annotations?: Record<string, string>;
@@ -949,6 +984,14 @@ export declare class Meshagent {
     }): Promise<void>;
     connectRoom(projectId: string, room: string): Promise<RoomConnectionInfo>;
     connectAgent(projectId: string, agentName: string): Promise<AgentConnectionInfo>;
+    connectLlm(params: {
+        projectId: string;
+        subject: AccessSubject;
+        maxBudget: string;
+        providers?: LlmProvider[];
+        models?: string[];
+        expiresInSeconds?: number;
+    }): Promise<LlmDelegation>;
     listRooms(projectId: string, options?: {
         pageSize?: number;
         continuationToken?: string;

package/dist/browser/meshagent-client.js

@@ -83,7 +83,7 @@ function normalizeServiceSpec(service) {
                     })),
                 },
         };
-    return { ...service, agents, container };
+    return { ...service, enabled: service.enabled ?? true, agents, container };
 }
 class ServiceTemplateSpec {
     constructor(template) {
@@ -199,6 +199,7 @@ function serializeServiceSpec(service) {
         };
     return pruneUndefinedValues({
         ...service,
+        enabled: service.enabled ?? true,
         container,
         agents,
     });
@@ -399,6 +400,54 @@ class Meshagent {
             annotations: annotations && typeof annotations === "object" ? annotations : {},
         };
     }
+    parseRoomStatus(data) {
+        if (!data || typeof data !== "object") {
+            throw new requirement_js_1.RoomException("Invalid room status payload");
+        }
+        const { status, allocated_at: allocatedAt, running_for_seconds: runningForSeconds, } = data;
+        if (status !== "Allocated" && status !== "Unallocated") {
+            throw new requirement_js_1.RoomException("Invalid room status payload: unknown status");
+        }
+        if (allocatedAt != null && typeof allocatedAt !== "string") {
+            throw new requirement_js_1.RoomException("Invalid room status payload: allocated_at must be a timestamp");
+        }
+        if (runningForSeconds != null && typeof runningForSeconds !== "number") {
+            throw new requirement_js_1.RoomException("Invalid room status payload: running_for_seconds must be a number");
+        }
+        return {
+            status,
+            allocatedAt: allocatedAt == null ? null : new Date(allocatedAt),
+            runningForSeconds: runningForSeconds == null ? null : runningForSeconds,
+        };
+    }
+    parseRoomLifecycleEvent(data) {
+        if (!data || typeof data !== "object") {
+            throw new requirement_js_1.RoomException("Invalid room lifecycle event payload");
+        }
+        const { id, room_name: roomName, session_id: sessionId, type, message, severity, created_at: createdAt, } = data;
+        if (typeof id !== "string"
+            || typeof roomName !== "string"
+            || typeof type !== "string"
+            || typeof message !== "string"
+            || typeof createdAt !== "string") {
+            throw new requirement_js_1.RoomException("Invalid room lifecycle event payload: missing required fields");
+        }
+        if (sessionId != null && typeof sessionId !== "string") {
+            throw new requirement_js_1.RoomException("Invalid room lifecycle event payload: session_id must be a string");
+        }
+        if (severity != null && typeof severity !== "string") {
+            throw new requirement_js_1.RoomException("Invalid room lifecycle event payload: severity must be a string");
+        }
+        return {
+            id,
+            roomName,
+            sessionId: sessionId == null ? null : sessionId,
+            type,
+            message,
+            severity: severity == null ? null : severity,
+            createdAt: new Date(createdAt),
+        };
+    }
     parseGroup(data) {
         if (!data || typeof data !== "object") {
             throw new requirement_js_1.RoomException("Invalid group payload");
@@ -595,7 +644,7 @@ class Meshagent {
     serializeAccessSubject(subject) {
         return {
             type: subject.type,
-            id: subject.id,
+            ...(subject.id !== undefined ? { id: subject.id } : {}),
             ...(subject.name !== undefined ? { name: subject.name } : {}),
             ...(subject.firstName !== undefined ? { first_name: subject.firstName } : {}),
             ...(subject.lastName !== undefined ? { last_name: subject.lastName } : {}),
@@ -604,6 +653,24 @@ class Meshagent {
             ...(subject.relation !== undefined ? { relation: subject.relation } : {}),
         };
     }
+    parseLlmDelegation(data) {
+        if (!data || typeof data !== "object" || typeof data.id !== "string" || typeof data.token !== "string"
+            || typeof data.expires_at !== "string" || typeof data.project_id !== "string"
+            || typeof data.max_budget !== "string") {
+            throw new requirement_js_1.RoomException("Invalid LLM delegation payload");
+        }
+        return {
+            id: data.id,
+            token: data.token,
+            expiresAt: data.expires_at,
+            projectId: data.project_id,
+            delegator: this.parseAccessSubject(data.delegator),
+            subject: this.parseAccessSubject(data.subject),
+            providers: Array.isArray(data.providers) ? data.providers : null,
+            models: Array.isArray(data.models) ? data.models.filter((value) => typeof value === "string") : null,
+            maxBudget: data.max_budget,
+        };
+    }
     serializeAccessResource(resource) {
         return {
             type: resource.type,
@@ -724,6 +791,9 @@ class Meshagent {
             metadata: parsedResource.metadata ?? {},
             annotations: parsedResource.annotations ?? {},
         };
+        if (!parsedSubject.id) {
+            throw new requirement_js_1.RoomException("Invalid room grant payload: missing subject id");
+        }
         return {
             resource: parsedResource,
             subject: parsedSubject,
@@ -1770,6 +1840,22 @@ class Meshagent {
         });
         return this.parseRoom(data);
     }
+    async getRoomStatus(projectId, name) {
+        const roomName = this.encodePathComponent(name);
+        const data = await this.request(`/accounts/projects/${projectId}/rooms/${roomName}/status`, {
+            action: "get room status",
+        });
+        return this.parseRoomStatus(data);
+    }
+    async listRoomEvents(projectId, name, options = {}) {
+        const roomName = this.encodePathComponent(name);
+        const data = await this.request(`/accounts/projects/${projectId}/rooms/${roomName}/events`, {
+            query: { limit: options.limit ?? 100 },
+            action: "list room lifecycle events",
+        });
+        const events = Array.isArray(data?.events) ? data.events : [];
+        return events.map((event) => this.parseRoomLifecycleEvent(event));
+    }
     async updateRoom(projectId, roomId, name, options = {}) {
         const payload = { name };
         if (options.metadata !== undefined) {
@@ -1893,6 +1979,21 @@ class Meshagent {
         });
         return this.parseAgentConnectionInfo(data);
     }
+    async connectLlm(params) {
+        const data = await this.request("/llm/connect", {
+            method: "POST",
+            headers: { "Meshagent-Project-Id": params.projectId },
+            json: {
+                subject: this.serializeAccessSubject(params.subject),
+                max_budget: params.maxBudget,
+                ...(params.providers !== undefined ? { providers: params.providers } : {}),
+                ...(params.models !== undefined ? { models: params.models } : {}),
+                ...(params.expiresInSeconds !== undefined ? { expires_in_seconds: params.expiresInSeconds } : {}),
+            },
+            action: "connect LLM delegation",
+        });
+        return this.parseLlmDelegation(data);
+    }
     async listRooms(projectId, options = {}) {
         const { pageSize = 50, continuationToken, filter, view } = options;
         const data = await this.request(`/accounts/projects/${projectId}/rooms`, {

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

@@ -1,8 +1,8 @@
 import { ApiScope } from "./participant-token.js";
-export type ProjectRole = "member" | "admin" | "developer" | "room_creator" | "room_inventory" | "room_manager" | "session_inventory" | "agent_creator" | "agent_inventory" | "agent_manager" | "repository_creator" | "repository_inventory" | "repository_manager" | "feed_creator" | "feed_inventory" | "feed_manager" | "oauth_client_creator" | "oauth_client_inventory" | "oauth_client_manager" | "api_key_creator" | "api_key_inventory" | "api_key_manager" | "service_creator" | "service_inventory" | "service_manager" | "service_account_creator" | "service_account_inventory" | "service_account_manager" | "participant_token_creator" | "mailbox_creator" | "mailbox_inventory" | "mailbox_manager" | "route_creator" | "route_inventory" | "route_manager" | "scheduled_task_creator" | "scheduled_task_inventory" | "scheduled_task_manager" | "feed_subscription_creator" | "feed_subscription_inventory" | "feed_subscription_manager" | "llm_logger_creator" | "llm_logger_inventory" | "llm_logger_manager" | "llm_proxy_user" | "usage_reporter" | "billing_manager" | "group_manager";
+export type ProjectRole = "member" | "admin" | "developer" | "room_creator" | "room_inventory" | "room_manager" | "session_inventory" | "agent_creator" | "agent_inventory" | "agent_manager" | "repository_creator" | "repository_inventory" | "repository_manager" | "feed_creator" | "feed_inventory" | "feed_manager" | "oauth_client_creator" | "oauth_client_inventory" | "oauth_client_manager" | "api_key_creator" | "api_key_inventory" | "api_key_manager" | "service_creator" | "service_inventory" | "service_manager" | "service_account_creator" | "service_account_inventory" | "service_account_manager" | "participant_token_creator" | "mailbox_creator" | "mailbox_inventory" | "mailbox_manager" | "route_creator" | "route_inventory" | "route_manager" | "scheduled_task_creator" | "scheduled_task_inventory" | "scheduled_task_manager" | "feed_subscription_creator" | "feed_subscription_inventory" | "feed_subscription_manager" | "llm_logger_creator" | "llm_logger_inventory" | "llm_logger_manager" | "llm_proxy_user" | "llm_quota_manager" | "usage_reporter" | "billing_manager" | "group_manager";
 export type ResourceRole = "viewer" | "operator" | "developer" | "admin";
 export type RoomRole = "site_user" | "guest" | ResourceRole;
-export type ProjectSettingsDocumentName = "openai" | "anthropic" | "otel" | "admission" | "room" | "room_roles";
+export type ProjectSettingsDocumentName = "openai" | "anthropic" | "otel" | "admission" | "room" | "room_roles" | "router";
 export type FeedRole = "reader" | "subscriber" | "publisher" | "manager";
 export type SecretRole = "use_proxy";
 export type AccessRole = ProjectRole | RoomRole | FeedRole | SecretRole | "list";
@@ -10,13 +10,25 @@ export type AccessSubjectType = "user" | "group" | "agent" | "service_account" |
 export type AccessResourceType = "project" | "room" | "agent" | "group" | "repository" | "feed" | "secret";
 export interface AccessSubject {
     type: AccessSubjectType;
-    id: string;
+    id?: string | null;
     name?: string | null;
     firstName?: string | null;
     lastName?: string | null;
     email?: string | null;
     objectType?: "project" | null;
-    relation?: "member" | "developer" | "agent" | null;
+    relation?: "member" | "developer" | "agent" | "service_account" | null;
+}
+export type LlmProvider = "openai" | "anthropic";
+export interface LlmDelegation {
+    id: string;
+    token: string;
+    expiresAt: string;
+    projectId: string;
+    delegator: AccessSubject;
+    subject: AccessSubject;
+    providers?: LlmProvider[] | null;
+    models?: string[] | null;
+    maxBudget: string;
 }
 export interface AccessResource {
     type: AccessResourceType;
@@ -66,6 +78,21 @@ export interface RoomInfo {
     metadata: Record<string, unknown>;
     annotations: Record<string, string>;
 }
+export type RoomAllocationStatus = "Allocated" | "Unallocated";
+export interface RoomStatus {
+    status: RoomAllocationStatus;
+    allocatedAt?: Date | null;
+    runningForSeconds?: number | null;
+}
+export interface RoomLifecycleEvent {
+    id: string;
+    roomName: string;
+    sessionId?: string | null;
+    type: string;
+    message: string;
+    severity?: string | null;
+    createdAt: Date;
+}
 export interface GroupInfo {
     id: string;
     name: string;
@@ -401,6 +428,7 @@ export interface ServiceSpec {
     version: "v1";
     kind: "Service";
     id?: string | null;
+    enabled?: boolean;
     metadata: ServiceMetadata;
     agents?: AgentSpec[] | null;
     ports?: PortSpec[];
@@ -578,6 +606,8 @@ export declare class Meshagent {
     private secretVersionPayload;
     private parseRoomSession;
     private parseRoom;
+    private parseRoomStatus;
+    private parseRoomLifecycleEvent;
     private parseGroup;
     private parseRoute;
     private parseFeed;
@@ -587,6 +617,7 @@ export declare class Meshagent {
     private parseAccessResource;
     private parseAccessSubject;
     private serializeAccessSubject;
+    private parseLlmDelegation;
     private serializeAccessResource;
     private parseProjectMember;
     private parseGroupMember;
@@ -900,6 +931,10 @@ export declare class Meshagent {
         annotations?: Record<string, string>;
     }): Promise<RoomInfo>;
     getRoom(projectId: string, name: string): Promise<RoomInfo>;
+    getRoomStatus(projectId: string, name: string): Promise<RoomStatus>;
+    listRoomEvents(projectId: string, name: string, options?: {
+        limit?: number;
+    }): Promise<RoomLifecycleEvent[]>;
     updateRoom(projectId: string, roomId: string, name: string, options?: {
         metadata?: Record<string, unknown>;
         annotations?: Record<string, string>;
@@ -949,6 +984,14 @@ export declare class Meshagent {
     }): Promise<void>;
     connectRoom(projectId: string, room: string): Promise<RoomConnectionInfo>;
     connectAgent(projectId: string, agentName: string): Promise<AgentConnectionInfo>;
+    connectLlm(params: {
+        projectId: string;
+        subject: AccessSubject;
+        maxBudget: string;
+        providers?: LlmProvider[];
+        models?: string[];
+        expiresInSeconds?: number;
+    }): Promise<LlmDelegation>;
     listRooms(projectId: string, options?: {
         pageSize?: number;
         continuationToken?: string;

package/dist/esm/meshagent-client.js

@@ -79,7 +79,7 @@ function normalizeServiceSpec(service) {
                     })),
                 },
         };
-    return { ...service, agents, container };
+    return { ...service, enabled: service.enabled ?? true, agents, container };
 }
 export class ServiceTemplateSpec {
     constructor(template) {
@@ -194,6 +194,7 @@ function serializeServiceSpec(service) {
         };
     return pruneUndefinedValues({
         ...service,
+        enabled: service.enabled ?? true,
         container,
         agents,
     });
@@ -394,6 +395,54 @@ export class Meshagent {
             annotations: annotations && typeof annotations === "object" ? annotations : {},
         };
     }
+    parseRoomStatus(data) {
+        if (!data || typeof data !== "object") {
+            throw new RoomException("Invalid room status payload");
+        }
+        const { status, allocated_at: allocatedAt, running_for_seconds: runningForSeconds, } = data;
+        if (status !== "Allocated" && status !== "Unallocated") {
+            throw new RoomException("Invalid room status payload: unknown status");
+        }
+        if (allocatedAt != null && typeof allocatedAt !== "string") {
+            throw new RoomException("Invalid room status payload: allocated_at must be a timestamp");
+        }
+        if (runningForSeconds != null && typeof runningForSeconds !== "number") {
+            throw new RoomException("Invalid room status payload: running_for_seconds must be a number");
+        }
+        return {
+            status,
+            allocatedAt: allocatedAt == null ? null : new Date(allocatedAt),
+            runningForSeconds: runningForSeconds == null ? null : runningForSeconds,
+        };
+    }
+    parseRoomLifecycleEvent(data) {
+        if (!data || typeof data !== "object") {
+            throw new RoomException("Invalid room lifecycle event payload");
+        }
+        const { id, room_name: roomName, session_id: sessionId, type, message, severity, created_at: createdAt, } = data;
+        if (typeof id !== "string"
+            || typeof roomName !== "string"
+            || typeof type !== "string"
+            || typeof message !== "string"
+            || typeof createdAt !== "string") {
+            throw new RoomException("Invalid room lifecycle event payload: missing required fields");
+        }
+        if (sessionId != null && typeof sessionId !== "string") {
+            throw new RoomException("Invalid room lifecycle event payload: session_id must be a string");
+        }
+        if (severity != null && typeof severity !== "string") {
+            throw new RoomException("Invalid room lifecycle event payload: severity must be a string");
+        }
+        return {
+            id,
+            roomName,
+            sessionId: sessionId == null ? null : sessionId,
+            type,
+            message,
+            severity: severity == null ? null : severity,
+            createdAt: new Date(createdAt),
+        };
+    }
     parseGroup(data) {
         if (!data || typeof data !== "object") {
             throw new RoomException("Invalid group payload");
@@ -590,7 +639,7 @@ export class Meshagent {
     serializeAccessSubject(subject) {
         return {
             type: subject.type,
-            id: subject.id,
+            ...(subject.id !== undefined ? { id: subject.id } : {}),
             ...(subject.name !== undefined ? { name: subject.name } : {}),
             ...(subject.firstName !== undefined ? { first_name: subject.firstName } : {}),
             ...(subject.lastName !== undefined ? { last_name: subject.lastName } : {}),
@@ -599,6 +648,24 @@ export class Meshagent {
             ...(subject.relation !== undefined ? { relation: subject.relation } : {}),
         };
     }
+    parseLlmDelegation(data) {
+        if (!data || typeof data !== "object" || typeof data.id !== "string" || typeof data.token !== "string"
+            || typeof data.expires_at !== "string" || typeof data.project_id !== "string"
+            || typeof data.max_budget !== "string") {
+            throw new RoomException("Invalid LLM delegation payload");
+        }
+        return {
+            id: data.id,
+            token: data.token,
+            expiresAt: data.expires_at,
+            projectId: data.project_id,
+            delegator: this.parseAccessSubject(data.delegator),
+            subject: this.parseAccessSubject(data.subject),
+            providers: Array.isArray(data.providers) ? data.providers : null,
+            models: Array.isArray(data.models) ? data.models.filter((value) => typeof value === "string") : null,
+            maxBudget: data.max_budget,
+        };
+    }
     serializeAccessResource(resource) {
         return {
             type: resource.type,
@@ -719,6 +786,9 @@ export class Meshagent {
             metadata: parsedResource.metadata ?? {},
             annotations: parsedResource.annotations ?? {},
         };
+        if (!parsedSubject.id) {
+            throw new RoomException("Invalid room grant payload: missing subject id");
+        }
         return {
             resource: parsedResource,
             subject: parsedSubject,
@@ -1765,6 +1835,22 @@ export class Meshagent {
         });
         return this.parseRoom(data);
     }
+    async getRoomStatus(projectId, name) {
+        const roomName = this.encodePathComponent(name);
+        const data = await this.request(`/accounts/projects/${projectId}/rooms/${roomName}/status`, {
+            action: "get room status",
+        });
+        return this.parseRoomStatus(data);
+    }
+    async listRoomEvents(projectId, name, options = {}) {
+        const roomName = this.encodePathComponent(name);
+        const data = await this.request(`/accounts/projects/${projectId}/rooms/${roomName}/events`, {
+            query: { limit: options.limit ?? 100 },
+            action: "list room lifecycle events",
+        });
+        const events = Array.isArray(data?.events) ? data.events : [];
+        return events.map((event) => this.parseRoomLifecycleEvent(event));
+    }
     async updateRoom(projectId, roomId, name, options = {}) {
         const payload = { name };
         if (options.metadata !== undefined) {
@@ -1888,6 +1974,21 @@ export class Meshagent {
         });
         return this.parseAgentConnectionInfo(data);
     }
+    async connectLlm(params) {
+        const data = await this.request("/llm/connect", {
+            method: "POST",
+            headers: { "Meshagent-Project-Id": params.projectId },
+            json: {
+                subject: this.serializeAccessSubject(params.subject),
+                max_budget: params.maxBudget,
+                ...(params.providers !== undefined ? { providers: params.providers } : {}),
+                ...(params.models !== undefined ? { models: params.models } : {}),
+                ...(params.expiresInSeconds !== undefined ? { expires_in_seconds: params.expiresInSeconds } : {}),
+            },
+            action: "connect LLM delegation",
+        });
+        return this.parseLlmDelegation(data);
+    }
     async listRooms(projectId, options = {}) {
         const { pageSize = 50, continuationToken, filter, view } = options;
         const data = await this.request(`/accounts/projects/${projectId}/rooms`, {

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

@@ -1,8 +1,8 @@
 import { ApiScope } from "./participant-token.js";
-export type ProjectRole = "member" | "admin" | "developer" | "room_creator" | "room_inventory" | "room_manager" | "session_inventory" | "agent_creator" | "agent_inventory" | "agent_manager" | "repository_creator" | "repository_inventory" | "repository_manager" | "feed_creator" | "feed_inventory" | "feed_manager" | "oauth_client_creator" | "oauth_client_inventory" | "oauth_client_manager" | "api_key_creator" | "api_key_inventory" | "api_key_manager" | "service_creator" | "service_inventory" | "service_manager" | "service_account_creator" | "service_account_inventory" | "service_account_manager" | "participant_token_creator" | "mailbox_creator" | "mailbox_inventory" | "mailbox_manager" | "route_creator" | "route_inventory" | "route_manager" | "scheduled_task_creator" | "scheduled_task_inventory" | "scheduled_task_manager" | "feed_subscription_creator" | "feed_subscription_inventory" | "feed_subscription_manager" | "llm_logger_creator" | "llm_logger_inventory" | "llm_logger_manager" | "llm_proxy_user" | "usage_reporter" | "billing_manager" | "group_manager";
+export type ProjectRole = "member" | "admin" | "developer" | "room_creator" | "room_inventory" | "room_manager" | "session_inventory" | "agent_creator" | "agent_inventory" | "agent_manager" | "repository_creator" | "repository_inventory" | "repository_manager" | "feed_creator" | "feed_inventory" | "feed_manager" | "oauth_client_creator" | "oauth_client_inventory" | "oauth_client_manager" | "api_key_creator" | "api_key_inventory" | "api_key_manager" | "service_creator" | "service_inventory" | "service_manager" | "service_account_creator" | "service_account_inventory" | "service_account_manager" | "participant_token_creator" | "mailbox_creator" | "mailbox_inventory" | "mailbox_manager" | "route_creator" | "route_inventory" | "route_manager" | "scheduled_task_creator" | "scheduled_task_inventory" | "scheduled_task_manager" | "feed_subscription_creator" | "feed_subscription_inventory" | "feed_subscription_manager" | "llm_logger_creator" | "llm_logger_inventory" | "llm_logger_manager" | "llm_proxy_user" | "llm_quota_manager" | "usage_reporter" | "billing_manager" | "group_manager";
 export type ResourceRole = "viewer" | "operator" | "developer" | "admin";
 export type RoomRole = "site_user" | "guest" | ResourceRole;
-export type ProjectSettingsDocumentName = "openai" | "anthropic" | "otel" | "admission" | "room" | "room_roles";
+export type ProjectSettingsDocumentName = "openai" | "anthropic" | "otel" | "admission" | "room" | "room_roles" | "router";
 export type FeedRole = "reader" | "subscriber" | "publisher" | "manager";
 export type SecretRole = "use_proxy";
 export type AccessRole = ProjectRole | RoomRole | FeedRole | SecretRole | "list";
@@ -10,13 +10,25 @@ export type AccessSubjectType = "user" | "group" | "agent" | "service_account" |
 export type AccessResourceType = "project" | "room" | "agent" | "group" | "repository" | "feed" | "secret";
 export interface AccessSubject {
     type: AccessSubjectType;
-    id: string;
+    id?: string | null;
     name?: string | null;
     firstName?: string | null;
     lastName?: string | null;
     email?: string | null;
     objectType?: "project" | null;
-    relation?: "member" | "developer" | "agent" | null;
+    relation?: "member" | "developer" | "agent" | "service_account" | null;
+}
+export type LlmProvider = "openai" | "anthropic";
+export interface LlmDelegation {
+    id: string;
+    token: string;
+    expiresAt: string;
+    projectId: string;
+    delegator: AccessSubject;
+    subject: AccessSubject;
+    providers?: LlmProvider[] | null;
+    models?: string[] | null;
+    maxBudget: string;
 }
 export interface AccessResource {
     type: AccessResourceType;
@@ -66,6 +78,21 @@ export interface RoomInfo {
     metadata: Record<string, unknown>;
     annotations: Record<string, string>;
 }
+export type RoomAllocationStatus = "Allocated" | "Unallocated";
+export interface RoomStatus {
+    status: RoomAllocationStatus;
+    allocatedAt?: Date | null;
+    runningForSeconds?: number | null;
+}
+export interface RoomLifecycleEvent {
+    id: string;
+    roomName: string;
+    sessionId?: string | null;
+    type: string;
+    message: string;
+    severity?: string | null;
+    createdAt: Date;
+}
 export interface GroupInfo {
     id: string;
     name: string;
@@ -401,6 +428,7 @@ export interface ServiceSpec {
     version: "v1";
     kind: "Service";
     id?: string | null;
+    enabled?: boolean;
     metadata: ServiceMetadata;
     agents?: AgentSpec[] | null;
     ports?: PortSpec[];
@@ -578,6 +606,8 @@ export declare class Meshagent {
     private secretVersionPayload;
     private parseRoomSession;
     private parseRoom;
+    private parseRoomStatus;
+    private parseRoomLifecycleEvent;
     private parseGroup;
     private parseRoute;
     private parseFeed;
@@ -587,6 +617,7 @@ export declare class Meshagent {
     private parseAccessResource;
     private parseAccessSubject;
     private serializeAccessSubject;
+    private parseLlmDelegation;
     private serializeAccessResource;
     private parseProjectMember;
     private parseGroupMember;
@@ -900,6 +931,10 @@ export declare class Meshagent {
         annotations?: Record<string, string>;
     }): Promise<RoomInfo>;
     getRoom(projectId: string, name: string): Promise<RoomInfo>;
+    getRoomStatus(projectId: string, name: string): Promise<RoomStatus>;
+    listRoomEvents(projectId: string, name: string, options?: {
+        limit?: number;
+    }): Promise<RoomLifecycleEvent[]>;
     updateRoom(projectId: string, roomId: string, name: string, options?: {
         metadata?: Record<string, unknown>;
         annotations?: Record<string, string>;
@@ -949,6 +984,14 @@ export declare class Meshagent {
     }): Promise<void>;
     connectRoom(projectId: string, room: string): Promise<RoomConnectionInfo>;
     connectAgent(projectId: string, agentName: string): Promise<AgentConnectionInfo>;
+    connectLlm(params: {
+        projectId: string;
+        subject: AccessSubject;
+        maxBudget: string;
+        providers?: LlmProvider[];
+        models?: string[];
+        expiresInSeconds?: number;
+    }): Promise<LlmDelegation>;
     listRooms(projectId: string, options?: {
         pageSize?: number;
         continuationToken?: string;

package/dist/node/meshagent-client.js

@@ -83,7 +83,7 @@ function normalizeServiceSpec(service) {
                     })),
                 },
         };
-    return { ...service, agents, container };
+    return { ...service, enabled: service.enabled ?? true, agents, container };
 }
 class ServiceTemplateSpec {
     constructor(template) {
@@ -199,6 +199,7 @@ function serializeServiceSpec(service) {
         };
     return pruneUndefinedValues({
         ...service,
+        enabled: service.enabled ?? true,
         container,
         agents,
     });
@@ -399,6 +400,54 @@ class Meshagent {
             annotations: annotations && typeof annotations === "object" ? annotations : {},
         };
     }
+    parseRoomStatus(data) {
+        if (!data || typeof data !== "object") {
+            throw new requirement_js_1.RoomException("Invalid room status payload");
+        }
+        const { status, allocated_at: allocatedAt, running_for_seconds: runningForSeconds, } = data;
+        if (status !== "Allocated" && status !== "Unallocated") {
+            throw new requirement_js_1.RoomException("Invalid room status payload: unknown status");
+        }
+        if (allocatedAt != null && typeof allocatedAt !== "string") {
+            throw new requirement_js_1.RoomException("Invalid room status payload: allocated_at must be a timestamp");
+        }
+        if (runningForSeconds != null && typeof runningForSeconds !== "number") {
+            throw new requirement_js_1.RoomException("Invalid room status payload: running_for_seconds must be a number");
+        }
+        return {
+            status,
+            allocatedAt: allocatedAt == null ? null : new Date(allocatedAt),
+            runningForSeconds: runningForSeconds == null ? null : runningForSeconds,
+        };
+    }
+    parseRoomLifecycleEvent(data) {
+        if (!data || typeof data !== "object") {
+            throw new requirement_js_1.RoomException("Invalid room lifecycle event payload");
+        }
+        const { id, room_name: roomName, session_id: sessionId, type, message, severity, created_at: createdAt, } = data;
+        if (typeof id !== "string"
+            || typeof roomName !== "string"
+            || typeof type !== "string"
+            || typeof message !== "string"
+            || typeof createdAt !== "string") {
+            throw new requirement_js_1.RoomException("Invalid room lifecycle event payload: missing required fields");
+        }
+        if (sessionId != null && typeof sessionId !== "string") {
+            throw new requirement_js_1.RoomException("Invalid room lifecycle event payload: session_id must be a string");
+        }
+        if (severity != null && typeof severity !== "string") {
+            throw new requirement_js_1.RoomException("Invalid room lifecycle event payload: severity must be a string");
+        }
+        return {
+            id,
+            roomName,
+            sessionId: sessionId == null ? null : sessionId,
+            type,
+            message,
+            severity: severity == null ? null : severity,
+            createdAt: new Date(createdAt),
+        };
+    }
     parseGroup(data) {
         if (!data || typeof data !== "object") {
             throw new requirement_js_1.RoomException("Invalid group payload");
@@ -595,7 +644,7 @@ class Meshagent {
     serializeAccessSubject(subject) {
         return {
             type: subject.type,
-            id: subject.id,
+            ...(subject.id !== undefined ? { id: subject.id } : {}),
             ...(subject.name !== undefined ? { name: subject.name } : {}),
             ...(subject.firstName !== undefined ? { first_name: subject.firstName } : {}),
             ...(subject.lastName !== undefined ? { last_name: subject.lastName } : {}),
@@ -604,6 +653,24 @@ class Meshagent {
             ...(subject.relation !== undefined ? { relation: subject.relation } : {}),
         };
     }
+    parseLlmDelegation(data) {
+        if (!data || typeof data !== "object" || typeof data.id !== "string" || typeof data.token !== "string"
+            || typeof data.expires_at !== "string" || typeof data.project_id !== "string"
+            || typeof data.max_budget !== "string") {
+            throw new requirement_js_1.RoomException("Invalid LLM delegation payload");
+        }
+        return {
+            id: data.id,
+            token: data.token,
+            expiresAt: data.expires_at,
+            projectId: data.project_id,
+            delegator: this.parseAccessSubject(data.delegator),
+            subject: this.parseAccessSubject(data.subject),
+            providers: Array.isArray(data.providers) ? data.providers : null,
+            models: Array.isArray(data.models) ? data.models.filter((value) => typeof value === "string") : null,
+            maxBudget: data.max_budget,
+        };
+    }
     serializeAccessResource(resource) {
         return {
             type: resource.type,
@@ -724,6 +791,9 @@ class Meshagent {
             metadata: parsedResource.metadata ?? {},
             annotations: parsedResource.annotations ?? {},
         };
+        if (!parsedSubject.id) {
+            throw new requirement_js_1.RoomException("Invalid room grant payload: missing subject id");
+        }
         return {
             resource: parsedResource,
             subject: parsedSubject,
@@ -1770,6 +1840,22 @@ class Meshagent {
         });
         return this.parseRoom(data);
     }
+    async getRoomStatus(projectId, name) {
+        const roomName = this.encodePathComponent(name);
+        const data = await this.request(`/accounts/projects/${projectId}/rooms/${roomName}/status`, {
+            action: "get room status",
+        });
+        return this.parseRoomStatus(data);
+    }
+    async listRoomEvents(projectId, name, options = {}) {
+        const roomName = this.encodePathComponent(name);
+        const data = await this.request(`/accounts/projects/${projectId}/rooms/${roomName}/events`, {
+            query: { limit: options.limit ?? 100 },
+            action: "list room lifecycle events",
+        });
+        const events = Array.isArray(data?.events) ? data.events : [];
+        return events.map((event) => this.parseRoomLifecycleEvent(event));
+    }
     async updateRoom(projectId, roomId, name, options = {}) {
         const payload = { name };
         if (options.metadata !== undefined) {
@@ -1893,6 +1979,21 @@ class Meshagent {
         });
         return this.parseAgentConnectionInfo(data);
     }
+    async connectLlm(params) {
+        const data = await this.request("/llm/connect", {
+            method: "POST",
+            headers: { "Meshagent-Project-Id": params.projectId },
+            json: {
+                subject: this.serializeAccessSubject(params.subject),
+                max_budget: params.maxBudget,
+                ...(params.providers !== undefined ? { providers: params.providers } : {}),
+                ...(params.models !== undefined ? { models: params.models } : {}),
+                ...(params.expiresInSeconds !== undefined ? { expires_in_seconds: params.expiresInSeconds } : {}),
+            },
+            action: "connect LLM delegation",
+        });
+        return this.parseLlmDelegation(data);
+    }
     async listRooms(projectId, options = {}) {
         const { pageSize = 50, continuationToken, filter, view } = options;
         const data = await this.request(`/accounts/projects/${projectId}/rooms`, {

package/package.json

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