@barivia/barsom-mcp 0.23.11 → 0.23.12

package/README.md

@@ -194,7 +194,7 @@ The right viewer depends on **(MCP App support)** **and** **(can the human reach
 ### Migration notes
 
 - **Results explorer figure dropdown (0.23.2):** `results_explorer` puts a grouped `<select>` above the plot (no scrolling the sidebar to switch figures), matching barmesh explorer UX. Sidebar keeps Metrics + Highlights only.
-- **UI delivery + train auto-open (0.22.4+):** `train()` returns `training_monitor` App structured content so supporting hosts open the monitor in the same turn. App tools emit structured `ui_delivery` (`delivery`, `urls`, `hint_for_agent`) and always put the standalone viz URL first. Env: `BARIVIA_UI_DELIVERY`, `BARIVIA_VIZ_PORT`. Cyclic cos/sin component PNGs are omitted from default `summary.files` / `figures=all` (encoding for training; panels still appear in `combined` / recolor); opt in with train param `viz_upload_cyclic_components=true`.
+- **UI delivery + train auto-open (0.22.4+ / 0.23.11+):** `train()` returns `training_monitor` App structured content so supporting hosts open the monitor in the same turn. App tools emit structured `ui_delivery` (`delivery`, `urls`, `hint_for_agent`) and always put the standalone viz URL first. Env: `BARIVIA_UI_DELIVERY` (`auto` \| `apps` \| `localhost` \| `inline` \| `text_only`), `BARIVIA_UI_PREFER_LOCALHOST=1` (opt-in localhost under `auto`), `BARIVIA_VIZ_PORT`. Cyclic cos/sin component PNGs are omitted from default `summary.files` / `figures=all` (encoding for training; panels still appear in `combined` / recolor); opt in with train param `viz_upload_cyclic_components=true`.
 - **Account surface (0.22.0, breaking):** `account(request_compute|compute_status|release_compute)` removed — AWS cloud burst leases are gone. Use `account(status|history|add_funds)`. Capacity is shared LOCAL/GKE pools.
 - **Structured results + train hints (0.21.x, non-breaking):**
   - **`results(action=get)`** returns **`structuredContent`** (job id/type, label, summary metrics, file list) alongside the text summary — same pattern as `training_monitor` / `results_explorer`. Agent hosts can read fields without parsing prose.

package/dist/figure_sections.js

@@ -0,0 +1,63 @@
+/**
+ * Canonical figure taxonomy for barsom results_explorer dropdown sections.
+ * Labels match the prior GROUP_LABELS (Summary → Diagnostics → Components → Other).
+ */
+export const FIGURE_SECTION_ORDER = [
+    "summary",
+    "diagnostic",
+    "component",
+    "artifact",
+];
+export const FIGURE_SECTION_LABELS = {
+    summary: "Summary",
+    diagnostic: "Diagnostics",
+    component: "Components",
+    artifact: "Other",
+};
+/** Map a figure base key into one of four explorer sections. */
+export function figureSection(key) {
+    if (key === "combined" || key === "coverage_overview")
+        return "summary";
+    if (key.startsWith("component_"))
+        return "component";
+    if (key === "umatrix" ||
+        key === "hit_histogram" ||
+        key === "learning_curve" ||
+        key === "correlation" ||
+        key === "divergence_kl" ||
+        key === "divergence_w1" ||
+        key.startsWith("cluster")) {
+        return "diagnostic";
+    }
+    if (key.startsWith("component"))
+        return "component";
+    return "artifact";
+}
+export const FIGURE_SORT_RANK = {
+    combined: 0,
+    coverage_overview: 1,
+    umatrix: 10,
+    hit_histogram: 11,
+    learning_curve: 12,
+    correlation: 13,
+    divergence_kl: 14,
+    divergence_w1: 15,
+};
+export function sortRank(key) {
+    if (key in FIGURE_SORT_RANK)
+        return FIGURE_SORT_RANK[key];
+    if (key.startsWith("component_")) {
+        const n = Number(key.replace(/^component_/, "").split("_")[0]);
+        return 20 + (Number.isFinite(n) ? n : 0);
+    }
+    if (key.startsWith("cluster"))
+        return 16;
+    return 50;
+}
+/** Sort by section order, then canonical rank, then label. */
+export function sortFiguresBySection(figures) {
+    return [...figures].sort((a, b) => FIGURE_SECTION_ORDER.indexOf(a.kind ?? figureSection(a.key)) -
+        FIGURE_SECTION_ORDER.indexOf(b.kind ?? figureSection(b.key)) ||
+        sortRank(a.key) - sortRank(b.key) ||
+        a.label.localeCompare(b.label));
+}

package/dist/shared.js

@@ -66,7 +66,7 @@ function newRequestId() {
  * X-Barsom-Client-Version so the server can annotate tool guidance with the
  * wrapper version each action requires. Keep in sync with package.json on bump.
  */
-export const CLIENT_VERSION = "0.23.11";
+export const CLIENT_VERSION = "0.23.12";
 /** User-facing links; keep aligned with barivia.se / api.barivia.se. */
 export const PUBLIC_SITE_ORIGIN = "https://barivia.se";
 /** Self-serve account dashboard (manage plan, billing, and API keys). */
@@ -1096,6 +1096,11 @@ export async function fetchTrainingGuidanceFromApi() {
     catch (e) {
         if (e?.httpStatus === 401 || e?.httpStatus === 403)
             throw e;
+        // Prefer last successful payload over a hard failure (TTL may have expired).
+        if (_trainingGuidanceCache?.text) {
+            return (_trainingGuidanceCache.text +
+                "\n\n(Note: API unreachable — showing last cached guidance; may be stale.)");
+        }
         return "Could not fetch parameter guidance. Check API key and connectivity.";
     }
 }

package/dist/tools/explore_map.js

@@ -4,7 +4,9 @@ import { registerAuditedTool, runMcpToolAudit } from "../audit.js";
 import { apiCall, apiRawCall, BARSOM_VIZ_VIEWS, buildStandaloneVizPageUrl, buildVizRelatedUrls, getVizPort, getCaptionForImage, getResultsImagesToFetch, mimeForFilename, structuredTextResult, tryAttachImage, } from "../shared.js";
 import { buildVizStandaloneUrl } from "../viz_links.js";
 import { appendUiDeliveryContent, beginInlineFallback, buildStandaloneVizUrl, resolveUiDelivery, } from "../ui-delivery.js";
+import { figureSection, sortFiguresBySection } from "../figure_sections.js";
 export const RESULTS_EXPLORER_URI = "ui://barsom/results-explorer";
+export { FIGURE_SECTION_LABELS, FIGURE_SECTION_ORDER, figureSection } from "../figure_sections.js";
 function labelForFigure(filename) {
     const base = filename.replace(/\.(png|pdf|svg)$/i, "");
     if (base === "combined")
@@ -34,7 +36,7 @@ function buildAvailableFigures(jobId, summary) {
     // `_fetch_figure` server-tool bridge (the default figure also arrives as a
     // base64 image via the tool result). The standalone browser page builds its
     // own relative-URL payload separately (see views/results-explorer/app.ts).
-    return figureFiles.map((filename) => {
+    return sortFiguresBySection(figureFiles.map((filename) => {
         const base = filename.replace(/\.(png|pdf|svg)$/i, "");
         const featureName = base.startsWith("component_")
             ? base.replace(/^component_\d+_/, "").replace(/_/g, " ")
@@ -44,11 +46,11 @@ function buildAvailableFigures(jobId, summary) {
             key: base,
             label: labelForFigure(filename),
             filename,
-            kind: base.startsWith("component_") ? "component" : base === "combined" ? "summary" : "diagnostic",
+            kind: figureSection(base),
             featureName,
             caption: getCaptionForImage(filename) || (!isRaster ? "This figure is available for download, but it is not inline-displayable in this first iteration." : undefined),
         };
-    });
+    }));
 }
 function buildMetrics(summary) {
     const jobType = String(summary.job_type ?? "train_som");
@@ -179,7 +181,7 @@ async function handleResultsExplorer(job_id) {
     }
     return {
         ...structuredTextResult({ ...payload, ui_delivery: uiDelivery }, undefined, content),
-        _meta: { ui: { resourceUri: RESULTS_EXPLORER_URI } },
+        _meta: { ui: { resourceUri: RESULTS_EXPLORER_URI, visibility: ["app"] } },
     };
 }
 export function registerExploreMapTool(server) {
@@ -189,7 +191,7 @@ export function registerExploreMapTool(server) {
         inputSchema: {
             job_id: z.string().describe("Job ID of a completed map training job"),
         },
-        _meta: { ui: { resourceUri: RESULTS_EXPLORER_URI } },
+        _meta: { ui: { resourceUri: RESULTS_EXPLORER_URI, visibility: ["app"] } },
     };
     registerAppTool(server, "results_explorer", toolConfig, async (args) => runMcpToolAudit("results_explorer", "default", args, () => handleResultsExplorer(String(args.job_id))));
     // NOTE: this MUST stay a registered tool — the Results Explorer MCP App view

package/dist/tools/training_monitor.js

@@ -100,10 +100,11 @@ async function enrichWithTrainingLog(job_id, data) {
     }
 }
 export async function buildTrainingMonitorResult(job_id, opts) {
-    const { fetch_training_log, preamble } = opts ?? {};
+    const { preamble } = opts ?? {};
     let data = (await apiCall("GET", `/v1/jobs/${job_id}`));
     const jobStatus = String(data.status ?? "");
-    if (fetch_training_log || needsTrainingLogEnrichment(data)) {
+    // Enrich terminal jobs for curve arrays (App refresh uses job_id only — no public flag).
+    if (needsTrainingLogEnrichment(data) || ["completed", "failed", "cancelled"].includes(jobStatus)) {
         data = await enrichWithTrainingLog(job_id, data);
     }
     const port = getVizPort();
@@ -178,21 +179,15 @@ export function registerTrainingMonitorTool(server) {
         description: "Optional view of training progress for a job_id. Prefer the standalone localhost URL in the tool result (always surfaced when the viz server is up) — some hosts list MCP Apps without mounting panels. When a host mounts the App, the panel auto-refreshes every 5s: QE/TE curves (≤1000 batch samples per phase) plus a hit-distribution heatmap. Set BARIVIA_VIZ_PORT for a stable port; re-run for a fresh link after proxy restart. Headless: jobs(action=status) has the same scalars — not required to finish training or read results.",
         inputSchema: {
             job_id: z.string().describe("Training job ID to monitor"),
-            fetch_training_log: z
-                .boolean()
-                .optional()
-                .describe("[INTERNAL — App/refresh path] Merge completed-job training-log arrays when live progress is empty. Agents should omit this."),
         },
-        _meta: { ui: { resourceUri: TRAINING_MONITOR_URI } },
+        _meta: { ui: { resourceUri: TRAINING_MONITOR_URI, visibility: ["model", "app"] } },
     }, async (args) => runMcpToolAudit("training_monitor", "default", args, async () => {
         beginInlineFallback();
-        const { job_id, fetch_training_log } = args;
-        const { structuredContent, content, text } = await buildTrainingMonitorResult(job_id, {
-            fetch_training_log,
-        });
+        const { job_id } = args;
+        const { structuredContent, content, text } = await buildTrainingMonitorResult(job_id);
         return {
             ...structuredTextResult(structuredContent, text, content),
-            _meta: { ui: { resourceUri: TRAINING_MONITOR_URI } },
+            _meta: { ui: { resourceUri: TRAINING_MONITOR_URI, visibility: ["model", "app"] } },
         };
     }));
 }