@barivia/barsom-mcp 0.17.1 → 0.18.1

package/dist/viz-server.js

@@ -23,6 +23,11 @@ export function startVizServer(apiCall, apiRawCall, loadViewHtml) {
     if (portOverride && (Number.isNaN(port) || port < 0 || port > 65535)) {
         return Promise.reject(new Error(`Invalid BARIVIA_VIZ_PORT: ${portOverride}`));
     }
+    // Resolved at listen time; exposed via /api/health so users/agents can confirm
+    // the viz server is up and on which port (it is ephemeral unless BARIVIA_VIZ_PORT
+    // is set, so standalone URLs from a prior session can become stale).
+    let assignedPort = port;
+    const portIsPinned = Boolean(portOverride);
     const server = http.createServer(async (req, res) => {
         const url = new URL(req.url ?? "/", `http://127.0.0.1`);
         const pathname = url.pathname;
@@ -55,6 +60,35 @@ export function startVizServer(apiCall, apiRawCall, loadViewHtml) {
             send(200, html, "text/html; charset=utf-8");
             return;
         }
+        // GET /api/health (diagnostic: viz server up, port, API reachability, optional job-state echo)
+        if (req.method === "GET" && pathname === "/api/health") {
+            const out = {
+                ok: true,
+                viz_port: assignedPort,
+                port_pinned: portIsPinned,
+            };
+            const jobId = url.searchParams.get("job_id");
+            if (jobId) {
+                if (!ID_REGEX.test(jobId)) {
+                    out.api_reachable = false;
+                    out.error = "Invalid job_id";
+                }
+                else {
+                    try {
+                        const data = (await apiCall("GET", `/v1/jobs/${jobId}`));
+                        out.api_reachable = true;
+                        out.job_status = data.status ?? null;
+                        out.job_progress = data.progress ?? null;
+                    }
+                    catch (err) {
+                        out.api_reachable = false;
+                        out.error = err instanceof Error ? err.message : "Request failed";
+                    }
+                }
+            }
+            sendJson(200, out);
+            return;
+        }
         // GET /api/results/:jobId
         const resultsMatch = pathname.match(/^\/api\/results\/([^/]+)$/);
         if (req.method === "GET" && resultsMatch) {
@@ -222,7 +256,8 @@ export function startVizServer(apiCall, apiRawCall, loadViewHtml) {
     return new Promise((resolve, reject) => {
         server.listen(port, "127.0.0.1", () => {
             const assigned = server.address()?.port;
-            resolve(assigned ?? port);
+            assignedPort = assigned ?? port;
+            resolve(assignedPort);
         });
         server.on("error", reject);
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barivia/barsom-mcp",
-  "version": "0.17.1",
+  "version": "0.18.1",
   "description": "barSOM MCP proxy — connect any MCP client to the barSOM cloud API for Self-Organizing Map analytics",
   "keywords": [
     "mcp",