@meshagent/meshagent 0.41.7 → 0.42.0

package/CHANGELOG.md

@@ -1,3 +1,18 @@
+## [0.42.0]
+- Added project lookup by key.
+- Container and room APIs now return structured `containerPort`/`hostPort` entries instead of integer port lists, which is a breaking response-shape change.
+- `ContainerSpec`, `PortSpec`, and `RoutePathSpec` now support `template`, `host_port`, and `stripPrefix`, and room service URL resolution uses `host_port` when available.
+- `createRoom` now serializes typed permissions, and container creation now accepts a `template` option.
+
+## [0.41.10]
+- Stability
+
+## [0.41.9]
+- Stability
+
+## [0.41.8]
+- Stability
+
 ## [0.41.7]
 - Stability
 

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

@@ -52,11 +52,15 @@ export interface ContainerParticipantInfo {
     id: string;
     name: string;
 }
+export interface RoomContainerPort {
+    containerPort: number;
+    hostPort: number;
+}
 export interface RoomContainer {
     id: string;
     image: string;
     name?: string;
-    ports: number[];
+    ports: RoomContainerPort[];
     startedBy: ContainerParticipantInfo;
     state: string;
     private: boolean;
@@ -170,6 +174,7 @@ export declare class ContainersClient {
         credentials?: DockerSecret[];
         name?: string;
         mounts?: ContainerMountSpec;
+        template?: "agent" | "none";
         writableRootFs?: boolean;
         private?: boolean;
     }): Promise<string>;

package/dist/browser/containers-client.js

@@ -504,6 +504,7 @@ class ContainersClient {
             credentials: toCredentials(params.credentials ?? []),
             name: params.name,
             mounts: params.mounts,
+            template: params.template,
             writable_root_fs: params.writableRootFs,
             private: params.private,
         });
@@ -889,14 +890,27 @@ class ContainersClient {
             const nameRaw = entry["name"];
             const portsRaw = entry["ports"];
             const serviceIdRaw = entry["service_id"];
-            if (!Array.isArray(portsRaw) || !portsRaw.every((port) => typeof port === "number" && Number.isInteger(port))) {
+            if (!Array.isArray(portsRaw) ||
+                !portsRaw.every((port) => {
+                    if (!isRecord(port)) {
+                        return false;
+                    }
+                    return (typeof port["container_port"] === "number" &&
+                        Number.isInteger(port["container_port"]) &&
+                        typeof port["host_port"] === "number" &&
+                        Number.isInteger(port["host_port"]));
+                })) {
                 throw this.unexpectedResponseError("list");
             }
+            const ports = portsRaw.map((port) => ({
+                containerPort: port["container_port"],
+                hostPort: port["host_port"],
+            }));
             items.push({
                 id,
                 image,
                 name: typeof nameRaw === "string" ? nameRaw : undefined,
-                ports: portsRaw,
+                ports,
                 startedBy: {
                     id: startedById,
                     name: startedByName,

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

@@ -148,6 +148,7 @@ export interface ServiceMetadata {
 }
 export interface ContainerSpec {
     private?: boolean | null;
+    template?: "agent" | "none" | null;
     command?: string | null;
     working_dir?: string | null;
     image: string;
@@ -193,9 +194,13 @@ export interface EndpointSpec {
 }
 export interface PortSpec {
     num: "*" | number;
+    host_port?: number | null;
     type?: "http" | "tcp" | null;
+    published?: boolean | null;
+    public?: boolean | null;
     endpoints?: EndpointSpec[];
     liveness?: string | null;
+    annotations?: Record<string, string>;
 }
 export interface ServiceSpec {
     version: "v1";
@@ -221,6 +226,7 @@ export interface RouteBackend {
 export interface RoutePathSpec {
     path?: string;
     pathType?: "prefix" | "exact";
+    stripPrefix?: boolean;
     targetPort: string | number;
 }
 export interface RouteSpec {
@@ -432,6 +438,7 @@ export declare class Meshagent {
     updateUserProfile(userId: string, firstName: string, lastName: string): Promise<Record<string, unknown>>;
     listProjects(): Promise<Record<string, unknown>>;
     getProject(projectId: string): Promise<Record<string, unknown>>;
+    getProjectByKey(projectKey: string): Promise<Record<string, unknown>>;
     createApiKey(projectId: string, name: string, description: string): Promise<Record<string, unknown>>;
     deleteApiKey(projectId: string, id: string): Promise<void>;
     listApiKeys(projectId: string): Promise<Record<string, unknown>>;

package/dist/browser/meshagent-client.js

@@ -842,6 +842,11 @@ class Meshagent {
             action: "get project",
         });
     }
+    async getProjectByKey(projectKey) {
+        return await this.request(`/accounts/projects/by-key/${encodeURIComponent(projectKey)}`, {
+            action: "get project by key",
+        });
+    }
     async createApiKey(projectId, name, description) {
         return await this.request(`/accounts/projects/${projectId}/api-keys`, {
             method: "POST",

package/dist/browser/toolkit-config.js

@@ -221,7 +221,7 @@ function bracketIpv6Host(host) {
 }
 function roomServiceMcpServerUrl({ service, port, endpoint, }) {
     const endpointPath = normalizeEndpointPath(endpoint.path);
-    const portValue = typeof port.num === "number" ? port.num : null;
+    const portValue = port.host_port ?? (typeof port.num === "number" ? port.num : null);
     if (service.external == null) {
         if (portValue == null) {
             return `http://localhost${endpointPath}`;

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

@@ -52,11 +52,15 @@ export interface ContainerParticipantInfo {
     id: string;
     name: string;
 }
+export interface RoomContainerPort {
+    containerPort: number;
+    hostPort: number;
+}
 export interface RoomContainer {
     id: string;
     image: string;
     name?: string;
-    ports: number[];
+    ports: RoomContainerPort[];
     startedBy: ContainerParticipantInfo;
     state: string;
     private: boolean;
@@ -170,6 +174,7 @@ export declare class ContainersClient {
         credentials?: DockerSecret[];
         name?: string;
         mounts?: ContainerMountSpec;
+        template?: "agent" | "none";
         writableRootFs?: boolean;
         private?: boolean;
     }): Promise<string>;

package/dist/esm/containers-client.js

@@ -504,6 +504,7 @@ class ContainersClient {
             credentials: toCredentials(params.credentials ?? []),
             name: params.name,
             mounts: params.mounts,
+            template: params.template,
             writable_root_fs: params.writableRootFs,
             private: params.private,
         });
@@ -889,14 +890,27 @@ class ContainersClient {
             const nameRaw = entry["name"];
             const portsRaw = entry["ports"];
             const serviceIdRaw = entry["service_id"];
-            if (!Array.isArray(portsRaw) || !portsRaw.every((port) => typeof port === "number" && Number.isInteger(port))) {
+            if (!Array.isArray(portsRaw) ||
+                !portsRaw.every((port) => {
+                    if (!isRecord(port)) {
+                        return false;
+                    }
+                    return (typeof port["container_port"] === "number" &&
+                        Number.isInteger(port["container_port"]) &&
+                        typeof port["host_port"] === "number" &&
+                        Number.isInteger(port["host_port"]));
+                })) {
                 throw this.unexpectedResponseError("list");
             }
+            const ports = portsRaw.map((port) => ({
+                containerPort: port["container_port"],
+                hostPort: port["host_port"],
+            }));
             items.push({
                 id,
                 image,
                 name: typeof nameRaw === "string" ? nameRaw : undefined,
-                ports: portsRaw,
+                ports,
                 startedBy: {
                     id: startedById,
                     name: startedByName,

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

@@ -148,6 +148,7 @@ export interface ServiceMetadata {
 }
 export interface ContainerSpec {
     private?: boolean | null;
+    template?: "agent" | "none" | null;
     command?: string | null;
     working_dir?: string | null;
     image: string;
@@ -193,9 +194,13 @@ export interface EndpointSpec {
 }
 export interface PortSpec {
     num: "*" | number;
+    host_port?: number | null;
     type?: "http" | "tcp" | null;
+    published?: boolean | null;
+    public?: boolean | null;
     endpoints?: EndpointSpec[];
     liveness?: string | null;
+    annotations?: Record<string, string>;
 }
 export interface ServiceSpec {
     version: "v1";
@@ -221,6 +226,7 @@ export interface RouteBackend {
 export interface RoutePathSpec {
     path?: string;
     pathType?: "prefix" | "exact";
+    stripPrefix?: boolean;
     targetPort: string | number;
 }
 export interface RouteSpec {
@@ -432,6 +438,7 @@ export declare class Meshagent {
     updateUserProfile(userId: string, firstName: string, lastName: string): Promise<Record<string, unknown>>;
     listProjects(): Promise<Record<string, unknown>>;
     getProject(projectId: string): Promise<Record<string, unknown>>;
+    getProjectByKey(projectKey: string): Promise<Record<string, unknown>>;
     createApiKey(projectId: string, name: string, description: string): Promise<Record<string, unknown>>;
     deleteApiKey(projectId: string, id: string): Promise<void>;
     listApiKeys(projectId: string): Promise<Record<string, unknown>>;

package/dist/esm/meshagent-client.js

@@ -842,6 +842,11 @@ class Meshagent {
             action: "get project",
         });
     }
+    async getProjectByKey(projectKey) {
+        return await this.request(`/accounts/projects/by-key/${encodeURIComponent(projectKey)}`, {
+            action: "get project by key",
+        });
+    }
     async createApiKey(projectId, name, description) {
         return await this.request(`/accounts/projects/${projectId}/api-keys`, {
             method: "POST",

package/dist/esm/toolkit-config.js

@@ -221,7 +221,7 @@ function bracketIpv6Host(host) {
 }
 function roomServiceMcpServerUrl({ service, port, endpoint, }) {
     const endpointPath = normalizeEndpointPath(endpoint.path);
-    const portValue = typeof port.num === "number" ? port.num : null;
+    const portValue = port.host_port ?? (typeof port.num === "number" ? port.num : null);
     if (service.external == null) {
         if (portValue == null) {
             return `http://localhost${endpointPath}`;

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

@@ -52,11 +52,15 @@ export interface ContainerParticipantInfo {
     id: string;
     name: string;
 }
+export interface RoomContainerPort {
+    containerPort: number;
+    hostPort: number;
+}
 export interface RoomContainer {
     id: string;
     image: string;
     name?: string;
-    ports: number[];
+    ports: RoomContainerPort[];
     startedBy: ContainerParticipantInfo;
     state: string;
     private: boolean;
@@ -170,6 +174,7 @@ export declare class ContainersClient {
         credentials?: DockerSecret[];
         name?: string;
         mounts?: ContainerMountSpec;
+        template?: "agent" | "none";
         writableRootFs?: boolean;
         private?: boolean;
     }): Promise<string>;

package/dist/node/containers-client.js

@@ -504,6 +504,7 @@ class ContainersClient {
             credentials: toCredentials(params.credentials ?? []),
             name: params.name,
             mounts: params.mounts,
+            template: params.template,
             writable_root_fs: params.writableRootFs,
             private: params.private,
         });
@@ -889,14 +890,27 @@ class ContainersClient {
             const nameRaw = entry["name"];
             const portsRaw = entry["ports"];
             const serviceIdRaw = entry["service_id"];
-            if (!Array.isArray(portsRaw) || !portsRaw.every((port) => typeof port === "number" && Number.isInteger(port))) {
+            if (!Array.isArray(portsRaw) ||
+                !portsRaw.every((port) => {
+                    if (!isRecord(port)) {
+                        return false;
+                    }
+                    return (typeof port["container_port"] === "number" &&
+                        Number.isInteger(port["container_port"]) &&
+                        typeof port["host_port"] === "number" &&
+                        Number.isInteger(port["host_port"]));
+                })) {
                 throw this.unexpectedResponseError("list");
             }
+            const ports = portsRaw.map((port) => ({
+                containerPort: port["container_port"],
+                hostPort: port["host_port"],
+            }));
             items.push({
                 id,
                 image,
                 name: typeof nameRaw === "string" ? nameRaw : undefined,
-                ports: portsRaw,
+                ports,
                 startedBy: {
                     id: startedById,
                     name: startedByName,

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

@@ -148,6 +148,7 @@ export interface ServiceMetadata {
 }
 export interface ContainerSpec {
     private?: boolean | null;
+    template?: "agent" | "none" | null;
     command?: string | null;
     working_dir?: string | null;
     image: string;
@@ -193,9 +194,13 @@ export interface EndpointSpec {
 }
 export interface PortSpec {
     num: "*" | number;
+    host_port?: number | null;
     type?: "http" | "tcp" | null;
+    published?: boolean | null;
+    public?: boolean | null;
     endpoints?: EndpointSpec[];
     liveness?: string | null;
+    annotations?: Record<string, string>;
 }
 export interface ServiceSpec {
     version: "v1";
@@ -221,6 +226,7 @@ export interface RouteBackend {
 export interface RoutePathSpec {
     path?: string;
     pathType?: "prefix" | "exact";
+    stripPrefix?: boolean;
     targetPort: string | number;
 }
 export interface RouteSpec {
@@ -432,6 +438,7 @@ export declare class Meshagent {
     updateUserProfile(userId: string, firstName: string, lastName: string): Promise<Record<string, unknown>>;
     listProjects(): Promise<Record<string, unknown>>;
     getProject(projectId: string): Promise<Record<string, unknown>>;
+    getProjectByKey(projectKey: string): Promise<Record<string, unknown>>;
     createApiKey(projectId: string, name: string, description: string): Promise<Record<string, unknown>>;
     deleteApiKey(projectId: string, id: string): Promise<void>;
     listApiKeys(projectId: string): Promise<Record<string, unknown>>;

package/dist/node/meshagent-client.js

@@ -842,6 +842,11 @@ class Meshagent {
             action: "get project",
         });
     }
+    async getProjectByKey(projectKey) {
+        return await this.request(`/accounts/projects/by-key/${encodeURIComponent(projectKey)}`, {
+            action: "get project by key",
+        });
+    }
     async createApiKey(projectId, name, description) {
         return await this.request(`/accounts/projects/${projectId}/api-keys`, {
             method: "POST",

package/dist/node/toolkit-config.js

@@ -221,7 +221,7 @@ function bracketIpv6Host(host) {
 }
 function roomServiceMcpServerUrl({ service, port, endpoint, }) {
     const endpointPath = normalizeEndpointPath(endpoint.path);
-    const portValue = typeof port.num === "number" ? port.num : null;
+    const portValue = port.host_port ?? (typeof port.num === "number" ? port.num : null);
     if (service.external == null) {
         if (portValue == null) {
             return `http://localhost${endpointPath}`;

package/package.json

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