@imenam/mcp-gui-interface 1.0.10 → 1.0.11

package/README.md

@@ -174,6 +174,21 @@ await proxy.unregister();
 - Registration HTTP timeout: **1000 ms** (unregister: **2000 ms**).
 - On failure, `RegisterResult.port` is **`0`** in the current implementation.
 
+**Grouping (`group` / `APP_GROUP`):** pass an optional `group` in the register
+options to place the app under a collapsible section (folded by default) in the
+proxy dashboard. Apps sharing the same `group` are shown together; apps without
+one land in a default "ungrouped" section. When `group` is omitted, `register`
+falls back to the **`APP_GROUP`** environment variable, so an MCP can enable
+grouping purely from its `.env` without touching code:
+
+```typescript
+// Explicit:
+await proxy.register({ path: "/my-app", name: "My App", group: "Google" });
+
+// Or, with APP_GROUP=Google in the environment, simply:
+await proxy.register({ path: "/my-app", name: "My App" });
+```
+
 > **Older npm versions** may have exposed `register(options, fallbackPort)`. Check `node_modules/@imenam/mcp-gui-interface/dist/src/proxy-client.d.ts` for the exact signature you have installed.
 
 **`getStatus()`:** `"connected" | "fallback" | "error"` — many failure paths set `"error"`.

package/dist/src/proxy-client.js

@@ -13,6 +13,14 @@ export class ProxyClient {
     }
     async register(options) {
         this.registeredPath = options.path;
+        // The group can be provided explicitly or, more conveniently, through the
+        // APP_GROUP env var — so any MCP using this library can opt into grouping
+        // from its .env alone. An empty/whitespace value means "ungrouped".
+        const rawGroup = options.group ?? process.env.APP_GROUP;
+        const group = typeof rawGroup === "string" && rawGroup.trim() !== ""
+            ? rawGroup.trim()
+            : undefined;
+        const payload = { ...options, ...(group ? { group } : {}) };
         return new Promise((resolve) => {
             let url;
             try {
@@ -77,7 +85,7 @@ export class ProxyClient {
                 this.status = "error";
                 resolve({ success: false, port: 0, error: "Timeout" });
             });
-            req.write(JSON.stringify(options));
+            req.write(JSON.stringify(payload));
             req.end();
         });
     }

package/dist/src/types.d.ts

@@ -21,6 +21,16 @@ export interface RegisterOptions {
     path: string;
     name?: string;
     port?: number;
+    /**
+     * Optional visual group. The proxy dashboard places every app sharing the
+     * same `group` under one collapsible section (folded by default). Apps left
+     * without a group land in a default "ungrouped" section.
+     *
+     * When omitted, {@link ProxyClient.register} falls back to the `APP_GROUP`
+     * environment variable, so an MCP can enable grouping purely from its `.env`
+     * without touching code.
+     */
+    group?: string;
 }
 export interface Logger {
     debug: (message: string, ...meta: unknown[]) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imenam/mcp-gui-interface",
-  "version": "1.0.10",
+  "version": "1.0.11",
   "description": "Shared library for MCP GUI lifecycle management — spawning, IPC, proxy registration, logging",
   "type": "module",
   "main": "./dist/src/index.js",