@barivia/barmesh-mcp 0.7.1 → 0.8.2

package/dist/training_monitor_curve.js

@@ -16,6 +16,48 @@ export function isKernelTrainingComplete(data, status) {
         return true;
     return status === "completed";
 }
+/**
+ * True only for actual FLooP / FLOOP_SIOM jobs.
+ * Do NOT infer from "ordering-only" curve shape — mesh_convergence generic/pitz
+ * presets use epochs=[N,0] (regular SOM ordering, no convergence phase).
+ */
+export function isFloopJob(data) {
+    const phase = String(data.training_progress_phase ?? data.progress_phase ?? "").toLowerCase();
+    if (phase === "floop")
+        return true;
+    const jt = String(data.job_type ?? data._job_type ?? "").toLowerCase();
+    if (jt.includes("floop"))
+        return true;
+    const rc = data.run_config;
+    if (rc && typeof rc === "object") {
+        const model = String(rc.model ?? "").toLowerCase();
+        if (model.includes("floop"))
+            return true;
+    }
+    const model = String(data.model ?? "").toLowerCase();
+    if (model.includes("floop"))
+        return true;
+    return false;
+}
+/** Axis / series labels keyed by actual training type (SOM batch steps vs FLooP). */
+export function curveAxisLabel(data) {
+    return isFloopJob(data) ? "FLooP step" : "Batch sample";
+}
+export function qeSeriesLabel(data, phase) {
+    if (phase === "floop" || isFloopJob(data))
+        return "QE (FLooP steps)";
+    if (phase === "convergence")
+        return "QE convergence";
+    return "QE ordering";
+}
+export function teSeriesLabel(data, phase) {
+    const base = phase === "floop" || isFloopJob(data)
+        ? "TE (FLooP steps)"
+        : phase === "convergence"
+            ? "TE convergence"
+            : "TE ordering";
+    return teCurveLabel(base);
+}
 export function teCurveLabel(base) {
     return `${base} (panel)`;
 }

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(),
+    };
+}