@barivia/barmesh-mcp 0.7.0 → 0.8.0

package/dist/tools/results.js

@@ -2,8 +2,9 @@ import fs from "node:fs/promises";
 import path from "node:path";
 import { z } from "zod";
 import { registerAuditedTool } from "../audit.js";
-import { apiCall, apiRawCall, getWorkspaceRootAsync, sandboxPath, textResult, tryAttachImage, resetInlineAttachBudget, pollUntilComplete, POLL_STAGE_MAX_MS, } from "../shared.js";
+import { apiCall, apiRawCall, getWorkspaceRootAsync, sandboxPath, textResult, tryAttachImage, resetInlineAttachBudget, pollUntilComplete, POLL_STAGE_MAX_MS, suggestAfterRender, } from "../shared.js";
 import { formatConvergenceReading } from "../convergence_reading.js";
+import { formatRichardsonResultsSummary, isRichardsonJob } from "../richardson_results.js";
 const MESH_DEFAULT_FIGURES = ["combined", "overview_distances", "plot_vol_all_meshes", "plot_vol_steps", "learning_curve"];
 function formatMeshResultsSummary(jobId, data, summary) {
     const label = data.label != null && data.label !== "" ? String(data.label) : null;
@@ -39,13 +40,14 @@ const TEXT_ARTIFACTS = [
     "distances_to_ref.txt",
     "emd_stepwise.txt",
     "cfd_metrics.json",
+    "richardson_gci.csv",
 ];
 export function registerResultsTool(server) {
-    registerAuditedTool(server, "barmesh_results", `Fetch results of a completed CFD job: distances, convergence reading, and figures.
+    registerAuditedTool(server, "barmesh_results", `Fetch results of a completed CFD job: distances, convergence reading, and figures (mesh_convergence) or Richardson/GCI triplets (richardson).
 
 | Action | Use when |
 |--------|----------|
-| get | Read the summary (distances per mesh, stepwise, convergence reading) and inline key figures. |
+| get | Read the summary. mesh_convergence: distances + inline figures. richardson: triplet p/GCI table + topology_warning; see richardson_gci.csv. |
 | image | Download one figure by filename (e.g. KL_ref.png, combined.pdf). |
 | render | Re-render the figures as publication PDFs (or SVG) on demand — PDFs are NOT generated by default. |
 | download | Save figures and metrics to a local folder (headless / agent path). |
@@ -54,6 +56,7 @@ BEST FOR: After barmesh_jobs(action=status) shows completed (and finalize finish
 FIGURES: Default bundle is combined.png, overview_distances.png (all KL/EMD panels), plot_vol_all_meshes.png, plot_vol_steps.png, and learning_curve.png — not redundant per-feature PNGs. action=get inlines the headline set; pass figures="all" for every artifact listed in summary.files, figures="none" for metrics only (recommended for agents).
 PDFs ON DEMAND: vector PDFs are not produced by default. Use action=render (format=pdf) once, then action=image or action=download.
 If GET /v1/results returns 404 shortly after status=completed, cfd_finalize may still be rendering — poll barmesh_jobs(status) until finalize_job_id completes.
+UNAVAILABLE: If the mesh analysis API is temporarily unavailable, say so plainly and suggest retry later (~retry_after_sec). Figures already downloaded stay usable.
 NOT FOR: Submitting jobs.`, {
         action: z.enum(["get", "image", "render", "download"]).describe("get: summary + figures; image: one file; render: lazy PDF/SVG; download: save to disk"),
         job_id: z.string().describe("Job ID"),
@@ -84,7 +87,7 @@ NOT FOR: Submitting jobs.`, {
                 status: "completed",
                 render_job_id: renderId,
                 format: fmt,
-                suggested_next_step: `Figures rendered as ${fmt}. Download with barmesh_results(action=download, job_id="${job_id}") or fetch one file with action=image.`,
+                suggested_next_step: suggestAfterRender(job_id, fmt),
             });
         }
         if (action === "image") {
@@ -193,7 +196,10 @@ NOT FOR: Submitting jobs.`, {
             throw err;
         }
         const summary = (data.summary ?? {});
-        const content = [{ type: "text", text: formatMeshResultsSummary(job_id, data, summary) }];
+        const summaryText = isRichardsonJob(summary)
+            ? formatRichardsonResultsSummary(job_id, data, summary)
+            : formatMeshResultsSummary(job_id, data, summary);
+        const content = [{ type: "text", text: summaryText }];
         if (figures === "none")
             return { content };
         const allFiles = summary.files ?? [];

package/dist/tools/training_monitor.js

@@ -1,13 +1,15 @@
 import { z } from "zod";
 import { registerAppTool } from "@modelcontextprotocol/ext-apps/server";
 import { runMcpToolAudit } from "../audit.js";
-import { apiCall, getClientSupportsMcpApps, getVizPort, structuredTextResult, } from "../shared.js";
+import { apiCall, BARMESH_VIZ_VIEWS, buildStandaloneVizPageUrl, buildVizRelatedUrls, getVizPort, structuredTextResult, } from "../shared.js";
+import { appendUiDeliveryContent, resolveUiDelivery, } from "../ui-delivery.js";
 import { enrichWithTrainingLog, needsTrainingLogEnrichment } from "../training_review.js";
 import { formatRunConfigTable } from "../run_config.js";
 export const TRAINING_MONITOR_URI = "ui://barmesh/training-monitor";
 export const TRAINING_MONITOR_REFRESH_MS = 5000;
-function buildStructuredContent(job_id, data) {
+function buildStructuredContent(job_id, data, port) {
     const id = String(data.id ?? job_id);
+    const standaloneUrl = buildStandaloneVizPageUrl(port, BARMESH_VIZ_VIEWS.trainingMonitor, id);
     return {
         ...data,
         type: "barmesh-training-monitor",
@@ -15,6 +17,8 @@ function buildStructuredContent(job_id, data) {
         id,
         job_id: id,
         refresh_interval_ms: TRAINING_MONITOR_REFRESH_MS,
+        standaloneUrl,
+        relatedUrls: buildVizRelatedUrls(port, id, BARMESH_VIZ_VIEWS),
     };
 }
 export function registerTrainingMonitorTool(server) {
@@ -37,7 +41,7 @@ export function registerTrainingMonitorTool(server) {
         if (fetch_training_log || needsTrainingLogEnrichment(data)) {
             data = await enrichWithTrainingLog(job_id, data);
         }
-        const structuredContent = buildStructuredContent(job_id, data);
+        const structuredContent = buildStructuredContent(job_id, data, getVizPort());
         const progress = (data.progress ?? 0) * 100;
         const etaSec = data.training_eta_sec != null ? Number(data.training_eta_sec) : null;
         const elapsedSec = data.training_elapsed_sec != null ? Number(data.training_elapsed_sec) : null;
@@ -56,24 +60,25 @@ export function registerTrainingMonitorTool(server) {
         const text = (runConfigNote ? `${runConfigNote}\n` : "") +
             `Training monitor (visual MCP App, refreshes every ${TRAINING_MONITOR_REFRESH_MS / 1000}s): job ${job_id} — ${jobStatus} (${progress.toFixed(1)}%).${modeNote}${timingNote}`;
         const content = [{ type: "text", text }];
-        const port = getVizPort();
-        const standaloneUrl = port
-            ? `http://localhost:${port}/viz/barmesh-training-monitor?mode=standalone&job_id=${encodeURIComponent(job_id)}`
-            : undefined;
-        if (standaloneUrl) {
-            content.push({
-                type: "text",
-                text: `Standalone training monitor URL (copy if Open is blocked):\n${standaloneUrl}\n` +
-                    `AGENT: surface this URL to the user — use a markdown link or tell them to copy/paste into a browser when the inline panel cannot open localhost. Re-post after the job completes so they can review curves.\n` +
-                    `This localhost port is per MCP session and goes stale if the proxy restarts — re-run barmesh_training_monitor for a fresh URL, or set BARIVIA_VIZ_PORT for a persistent port. Health check: http://localhost:${port}/api/health?job_id=${encodeURIComponent(job_id)}`,
-            });
-        }
-        if (!getClientSupportsMcpApps() && standaloneUrl) {
-            content.push({
-                type: "text",
-                text: `Interactive training monitor: [Open training monitor](${standaloneUrl})`,
-            });
+        const uiDelivery = resolveUiDelivery({
+            tool: "training_monitor",
+            jobId: job_id,
+            jobStatus,
+        });
+        appendUiDeliveryContent(content, uiDelivery, {
+            linkLabel: "Open training monitor",
+            primaryUrl: structuredContent.standaloneUrl,
+        });
+        if (jobStatus === "completed" && uiDelivery.urls?.length) {
+            const resultsUrl = uiDelivery.urls.find((u) => u.includes("results-explorer"));
+            if (resultsUrl) {
+                content.push({
+                    type: "text",
+                    text: `Job completed — browse figures: [Open results explorer](${resultsUrl})`,
+                });
+            }
         }
+        structuredContent.ui_delivery = uiDelivery;
         return {
             ...structuredTextResult(structuredContent, text, content),
             _meta: { ui: { resourceUri: TRAINING_MONITOR_URI } },

package/dist/training_monitor_curve.js

@@ -16,7 +16,7 @@ export function isKernelTrainingComplete(data, status) {
         return true;
     return status === "completed";
 }
-export function teCurveLabel(base, _kernelComplete = false) {
+export function teCurveLabel(base) {
     return `${base} (panel)`;
 }
 export function formatCurveSourceNote(data) {

package/dist/ui-delivery.js

@@ -0,0 +1,155 @@
+/**
+ * Client-capability adaptation for barmesh MCP App tools.
+ * Mirrors barsom ui-delivery; uses barmesh viz paths via viz_links.
+ */
+import { getClientSupportsMcpApps, getVizPort, } from "./shared.js";
+import { buildBarmeshVizStandaloneUrl } from "./viz_links.js";
+export function parseUiDeliveryOverride() {
+    const raw = (process.env.BARIVIA_UI_DELIVERY ?? "auto").trim().toLowerCase();
+    if (raw === "apps" || raw === "localhost" || raw === "inline" || raw === "auto") {
+        return raw;
+    }
+    return "auto";
+}
+function vizPortPinned() {
+    return Boolean(process.env.BARIVIA_VIZ_PORT?.trim());
+}
+function viewForTool(tool) {
+    return tool === "training_monitor" ? "barmesh-training-monitor" : "barmesh-results-explorer";
+}
+export function buildStandaloneVizUrl(view, jobId) {
+    return buildBarmeshVizStandaloneUrl(viewForTool(view), jobId);
+}
+export function buildHealthUrl(jobId) {
+    const port = getVizPort();
+    if (!port)
+        return undefined;
+    const base = `http://localhost:${port}/api/health`;
+    return jobId ? `${base}?job_id=${encodeURIComponent(jobId)}` : base;
+}
+function hintForTier(tier, tool, opts) {
+    const label = tool === "training_monitor" ? "training monitor" : "results explorer";
+    switch (tier) {
+        case "embedded":
+            return `The ${label} MCP App panel may embed. Always mention the standalone URL — some hosts list ui:// but never mount widgets.`;
+        case "localhost":
+            return opts.standaloneUrl
+                ? `AGENT: Post a clickable markdown link (e.g. "[Open ${label}](${opts.standaloneUrl})") — do not bury it after metrics.`
+                : `AGENT: Viz server unavailable — use barmesh_jobs(status) and barmesh_results(get).`;
+        case "inline_image":
+            return `AGENT: Inline raster figure(s) are attached. Summarize metrics; offer barmesh_results_explorer for more figures.`;
+        case "text_only":
+            return `AGENT: No embedded panel or localhost viz — use barmesh_jobs(status) and barmesh_results(get).`;
+    }
+}
+export function resolveUiDelivery(options) {
+    const override = parseUiDeliveryOverride();
+    const mcpApps = getClientSupportsMcpApps();
+    const port = getVizPort() || null;
+    const standaloneUrl = buildStandaloneVizUrl(options.tool, options.jobId);
+    let delivery;
+    if (override === "apps") {
+        delivery = mcpApps ? "embedded" : port ? "localhost" : "text_only";
+    }
+    else if (override === "localhost") {
+        delivery = port ? "localhost" : options.inlineImageAttached ? "inline_image" : "text_only";
+    }
+    else if (override === "inline") {
+        delivery = options.inlineImageAttached ? "inline_image" : "text_only";
+    }
+    else if (mcpApps) {
+        delivery = "embedded";
+    }
+    else if (port) {
+        delivery = "localhost";
+    }
+    else if (options.inlineImageAttached) {
+        delivery = "inline_image";
+    }
+    else {
+        delivery = "text_only";
+    }
+    const urls = [];
+    if (standaloneUrl && (delivery === "embedded" || delivery === "localhost")) {
+        urls.push(standaloneUrl);
+    }
+    const healthUrl = buildHealthUrl(options.jobId);
+    if (healthUrl && delivery === "localhost") {
+        urls.push(healthUrl);
+    }
+    const crossLink = options.tool === "training_monitor" && options.jobStatus === "completed"
+        ? buildStandaloneVizUrl("results_explorer", options.jobId)
+        : options.tool === "results_explorer"
+            ? buildStandaloneVizUrl("training_monitor", options.jobId)
+            : undefined;
+    if (crossLink && !urls.includes(crossLink)) {
+        urls.push(crossLink);
+    }
+    return {
+        delivery,
+        urls: urls.length > 0 ? urls : undefined,
+        hint_for_agent: hintForTier(delivery, options.tool, { standaloneUrl }),
+        mcp_apps_supported: mcpApps,
+        viz_port: port,
+        port_pinned: vizPortPinned(),
+        override,
+    };
+}
+/** Prepend prominent standalone URL + structured ui_delivery (Apps handshake may lie). */
+export function appendUiDeliveryContent(content, block, options) {
+    const primary = options?.primaryUrl ?? block.urls?.[0];
+    const label = options?.linkLabel ?? "Open interactive view";
+    const prefix = [];
+    if (primary) {
+        const embedNote = block.delivery === "embedded"
+            ? "Embedded panel if your host supports MCP Apps — otherwise open the standalone URL below (expected on some Cursor builds)."
+            : "Open the standalone URL below when no inline panel appears.";
+        prefix.push({
+            type: "text",
+            text: `${embedNote}\n` +
+                `Standalone URL (copy if Open is blocked):\n${primary}\n` +
+                `[${label}](${primary})\n` +
+                `${block.hint_for_agent}`,
+        });
+    }
+    prefix.push({
+        type: "text",
+        text: "```json\n" + JSON.stringify({ ui_delivery: block }, null, 2) + "\n```",
+    });
+    if (primary && !block.port_pinned && block.delivery !== "text_only") {
+        prefix.push({
+            type: "text",
+            text: "Tip: set BARIVIA_VIZ_PORT in MCP env for a session-stable localhost port; re-run this tool if the page stops updating.",
+        });
+    }
+    content.unshift(...prefix);
+}
+export function getMcpClientDiagnostics() {
+    const override = parseUiDeliveryOverride();
+    const mcpApps = getClientSupportsMcpApps();
+    const port = getVizPort() || null;
+    let activeTier = "text_only";
+    if (override === "apps") {
+        activeTier = mcpApps ? "embedded" : port ? "localhost" : "text_only";
+    }
+    else if (override === "localhost") {
+        activeTier = port ? "localhost" : "text_only";
+    }
+    else if (override === "inline") {
+        activeTier = "inline_image";
+    }
+    else if (mcpApps) {
+        activeTier = "embedded";
+    }
+    else if (port) {
+        activeTier = "localhost";
+    }
+    return {
+        mcp_apps_supported: mcpApps,
+        viz_port: port,
+        viz_port_pinned: vizPortPinned(),
+        ui_delivery_override: override,
+        active_delivery_tier: activeTier,
+        health_url: buildHealthUrl(),
+    };
+}