@barivia/barsom-mcp 0.6.2 → 0.6.3

package/dist/tools/results.js

@@ -0,0 +1,455 @@
+import path from "node:path";
+import fs from "node:fs/promises";
+import { z } from "zod";
+import { apiCall, apiRawCall, getWorkspaceRootAsync, sandboxPath, pollUntilComplete, tryAttachImage, getResultsImagesToFetch, getCaptionForImage, mimeForFilename, } from "../shared.js";
+export function registerResultsTool(server) {
+    server.tool("results", `Retrieve, recolor, download, export, or run temporal flow on a completed map job.
+
+| Action | Use when | Sync/Async |
+|--------|----------|------------|
+| get | First look after training — combined view + quality metrics | instant |
+| export | Learning curve, raw weights, or per-node stats | instant |
+| download | Saving figures to a local folder | instant |
+| recolor | Changing colormap or output format without retraining | async (~10–30s) |
+| transition_flow | Temporal dynamics on time-ordered data | async (~30–60s) |
+
+ONLY call this after jobs(action=status) returns "completed".
+ESCALATION: If job not found, verify job_id. If "job not complete", poll with jobs(action=status).
+
+action=get: Returns text summary with quality metrics and inline images.
+  - figures: omit = combined only. "all" = all plots. Array = specific logical names (combined, umatrix, hit_histogram, learning_curve, correlation, component_1..N).
+  - include_individual: if true (and figures omitted), inlines every component plane.
+  - After recolor or project, use the job_id returned by that operation to get the new artifacts, not the original training job_id.
+  - After showing results, guide the user: QE interpretation, whether to retrain, which features to explore.
+  - METRIC INTERPRETATION: QE lower=better (<1.5 good) | TE<0.1 good | Explained variance>0.7 good | Silhouette higher=better | Davies-Bouldin lower=better.
+
+action=export: Structured data exports. Use export_type= to choose what to export.
+  - export_type=training_log: learning curve sparklines + plot. Diagnose convergence/plateau/divergence.
+  - export_type=weights: full weight matrix + normalization stats. For external analysis or custom viz.
+  - export_type=nodes: per-node hit count + feature stats. Profile clusters and operating modes.
+
+action=download: Save figures to disk. Use so user can open, share, or version files locally.
+  - folder: e.g. "." or "./results". Interpreted relative to the client's current working directory (or workspace). If job has a label, a named subfolder may be created.
+  - figures: "all" (default) or array of filenames.
+  - include_json: also save summary.json.
+
+action=recolor: Change colormap or output format — no retraining. Returns a new job_id; auto-polls 60s.
+  AFTER: use results(action=get, job_id=NEW_JOB_ID).
+  Colormaps: viridis, plasma, inferno, magma, cividis, turbo, coolwarm, balance, RdBu, Spectral.
+
+action=transition_flow: Temporal state transition arrows on the map grid. Only use when rows are in chronological order. If your data has no temporal ordering, transition_flow will still run but the arrows are meaningless — use for time-ordered data only.
+  - You pass the training job_id; the API returns a new result job_id. Use that new job_id for results(get) or results(download).
+  - To persist the figure: results(action=download, job_id=<returned_job_id>).
+  - lag=1 (default): immediate next-step | lag=N: N-step horizon (e.g. 24 for daily cycles in hourly data).
+  - min_transitions: filter noisy arrows. Increase for large datasets.
+NOT FOR: Jobs that haven't completed. Use jobs(action=status) to check first.`, {
+        action: z
+            .enum(["get", "recolor", "download", "export", "transition_flow"])
+            .describe("get: inline results + metrics; recolor: new colormap/format (async); download: save to disk; export: structured data (training_log/weights/nodes); transition_flow: temporal dynamics (async)"),
+        job_id: z.string().describe("Job ID of a completed job"),
+        figures: z
+            .union([z.enum(["default", "combined_only", "all", "images"]), z.array(z.string())])
+            .optional()
+            .describe("action=get: omit=combined only; 'all'=all plots; array=specific (combined,umatrix,hit_histogram,correlation,component_1..N). action=download: 'all'=all image files; array=specific filenames."),
+        include_individual: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("action=get only: if true and figures omitted, inline each component plane, umatrix, hit histogram"),
+        include_json: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("action=download only: also save summary.json and JSON artifacts"),
+        folder: z
+            .string()
+            .optional()
+            .describe("action=download: directory path to save files (e.g. '.' or './results'). Relative to the client's current working directory (or workspace)."),
+        colormap: z
+            .string()
+            .optional()
+            .describe("action=recolor: colormap name (default: coolwarm). action=transition_flow: U-matrix background colormap (default: grays). Examples: viridis, plasma, balance, RdBu."),
+        output_format: z
+            .enum(["png", "pdf", "svg"])
+            .optional()
+            .default("png")
+            .describe("action=recolor / transition_flow: output image format (default: png)"),
+        output_dpi: z
+            .enum(["standard", "retina", "print"])
+            .optional()
+            .default("retina")
+            .describe("Resolution: standard (1x), retina (2x, default), print (4x)"),
+        recolor_figures: z
+            .array(z.string())
+            .optional()
+            .describe("action=recolor: which figures to re-render (default: [combined]). Options: combined, umatrix, hit_histogram, correlation, component_1..N"),
+        export_type: z
+            .enum(["training_log", "weights", "nodes"])
+            .optional()
+            .describe("action=export: training_log=learning curve+sparklines; weights=full weight matrix; nodes=per-node stats"),
+        lag: z
+            .number().int().min(1)
+            .optional().default(1)
+            .describe("action=transition_flow: step lag (default 1 = consecutive rows). Use larger for periodic analysis (e.g. 24 for daily in hourly data)."),
+        min_transitions: z
+            .number().int().min(1)
+            .optional()
+            .describe("action=transition_flow: minimum transition count to draw an arrow (default: auto). Increase to filter noise."),
+        top_k: z
+            .number().int().min(1)
+            .optional().default(10)
+            .describe("action=transition_flow: number of top-flow nodes in statistics (default 10)"),
+    }, async ({ action, job_id, figures, include_individual, include_json, folder, colormap, output_format, output_dpi, recolor_figures, export_type: exportType, lag, min_transitions, top_k }) => {
+        const dpiMap = { standard: 1, retina: 2, print: 4 };
+        if (action === "get") {
+            const data = (await apiCall("GET", `/v1/results/${job_id}`));
+            const summary = (data.summary ?? {});
+            const jobLabel = data.label != null && data.label !== "" ? String(data.label) : null;
+            const resultsHeader = jobLabel ? `Results for ${jobLabel} (job_id: ${job_id})` : `Results for job_id: ${job_id}`;
+            const content = [];
+            const inlinedImages = new Set();
+            const jobType = summary.job_type ?? "train_som";
+            if (jobType === "transition_flow") {
+                const lagVal = summary.lag ?? 1;
+                const stats = summary.flow_stats ?? {};
+                const topNodes = stats.top_flow_nodes ?? [];
+                const topLines = topNodes.length > 0
+                    ? topNodes.slice(0, 5).map((n) => {
+                        const dir = n.direction_deg != null ? ` ${Number(n.direction_deg).toFixed(1)}°` : "";
+                        const coords = Array.isArray(n.coords) ? ` [${n.coords.map((c) => Number(c).toFixed(2)).join(", ")}]` : "";
+                        return `  Node ${n.node_index}: magnitude ${Number(n.magnitude).toFixed(4)}, count ${n.count}${dir}${coords}`;
+                    }).join("\n")
+                    : "  (none)";
+                content.push({ type: "text", text: [
+                        `Transition Flow ${resultsHeader}`,
+                        `Parent map job: ${summary.parent_job_id ?? "N/A"} | Lag: ${lagVal} | Samples: ${summary.n_samples ?? 0}`,
+                        ``, `Flow Statistics:`,
+                        `  Mean flow magnitude: ${stats.mean_magnitude !== undefined ? Number(stats.mean_magnitude).toFixed(4) : "N/A"}`,
+                        `  Max flow magnitude:  ${stats.max_magnitude !== undefined ? Number(stats.max_magnitude).toFixed(4) : "N/A"}`,
+                        `  Nodes with flow:     ${stats.n_nodes_with_flow ?? "N/A"}`,
+                        `  Dead flow nodes:     ${stats.dead_flow_nodes ?? "N/A"} (no transitions)`,
+                        `  Top flow nodes:`,
+                        topLines,
+                        ``, `Arrows show net directional drift. Long/bright = frequent transitions. Short = stable states.`,
+                        `Background = U-matrix. Use results(action=transition_flow, lag=N) with larger N for longer-term structure.`,
+                    ].join("\n") });
+                for (const name of getResultsImagesToFetch(jobType, summary, figures, include_individual)) {
+                    const cap = getCaptionForImage(name);
+                    if (cap)
+                        content.push({ type: "text", text: cap });
+                    await tryAttachImage(content, job_id, name);
+                    inlinedImages.add(name);
+                }
+            }
+            else if (jobType === "project_variable") {
+                const varName = summary.variable_name ?? "variable";
+                const agg = summary.aggregation ?? "mean";
+                const stats = summary.variable_stats ?? {};
+                content.push({ type: "text", text: [
+                        `Projected Variable: ${varName} (${agg}) — ${resultsHeader}`,
+                        `Parent map job: ${summary.parent_job_id ?? "N/A"} | Samples: ${summary.n_samples ?? 0}`,
+                        ``, `Variable Statistics (per-node ${agg}):`,
+                        `  Min: ${stats.min !== undefined ? Number(stats.min).toFixed(3) : "N/A"}`,
+                        `  Max: ${stats.max !== undefined ? Number(stats.max).toFixed(3) : "N/A"}`,
+                        `  Mean: ${stats.mean !== undefined ? Number(stats.mean).toFixed(3) : "N/A"}`,
+                        `  Nodes with data: ${stats.n_nodes_with_data ?? "N/A"}`,
+                    ].join("\n") });
+                for (const name of getResultsImagesToFetch(jobType, summary, figures, include_individual)) {
+                    const cap = getCaptionForImage(name);
+                    if (cap)
+                        content.push({ type: "text", text: cap });
+                    await tryAttachImage(content, job_id, name);
+                    inlinedImages.add(name);
+                }
+            }
+            else {
+                const grid = summary.grid ?? [0, 0];
+                const features = summary.features ?? [];
+                const epochs = summary.epochs;
+                const epochStr = Array.isArray(epochs) ? (epochs[1] === 0 ? `${epochs[0]} ordering only` : `${epochs[0]} ordering + ${epochs[1]} convergence`) : String(epochs ?? "N/A");
+                const fmt = (v) => v !== null && v !== undefined ? Number(v).toFixed(4) : "N/A";
+                const duration = summary.training_duration_seconds;
+                const ordErrors = summary.ordering_errors;
+                const nNodes = grid[0] * grid[1];
+                const hitStats = summary.hit_stats;
+                const hitLine = hitStats
+                    ? `  Dead nodes: ${hitStats.dead_nodes ?? "N/A"} of ${nNodes} (${nNodes ? ((Number(hitStats.dead_nodes) / nNodes) * 100).toFixed(1) : "0"}%) | Max hits: ${hitStats.max_hits ?? "N/A"} | Median: ${hitStats.median_hits ?? "N/A"}`
+                    : "";
+                const uRange = summary.u_matrix_range;
+                const uRangeLine = uRange && uRange.length >= 2 ? `  U-matrix range: ${fmt(uRange[0])} — ${fmt(uRange[1])}` : "";
+                const compRanges = summary.component_ranges;
+                const compLines = compRanges && Object.keys(compRanges).length > 0
+                    ? Object.entries(compRanges).map(([f, r]) => `  ${f}: ${fmt(r[0])} — ${fmt(r[1])}`).join("\n")
+                    : "";
+                const clusterSummary = summary.cluster_summary;
+                const clusterLines = clusterSummary && clusterSummary.length > 0
+                    ? clusterSummary.map((c) => {
+                        const id = c.cluster_id ?? "?";
+                        const nodes = c.n_nodes ?? "?";
+                        const hits = c.total_hits ?? "?";
+                        const top = c.top_features ?? [];
+                        return `  Cluster ${id} (${nodes} nodes, ${hits} hits): defined by [${top.join(", ")}]`;
+                    }).join("\n")
+                    : "";
+                const topCorrs = summary.top_correlations;
+                const topCorrLine = topCorrs && topCorrs.length > 0
+                    ? `Strongest feature correlations: ${topCorrs.map((t) => `${t.f1 ?? "?"} & ${t.f2 ?? "?"} (${typeof t.r === "number" ? Number(t.r).toFixed(2) : t.r})`).join(", ")}`
+                    : "";
+                const textSummary = [
+                    `Map training ${resultsHeader}`,
+                    `Grid: ${grid[0]}×${grid[1]} | Features: ${summary.n_features ?? 0} | Samples: ${summary.n_samples ?? 0}`,
+                    `Model: ${summary.model ?? "SOM"} | Epochs: ${epochStr}`,
+                    `Periodic: ${summary.periodic ?? true} | Normalize: ${summary.normalize ?? "auto"}`,
+                    summary.sigma_f !== undefined ? `Sigma_f: ${summary.sigma_f}` : "",
+                    duration !== undefined ? `Training duration: ${duration}s` : "",
+                    ``, `Quality Metrics:`,
+                    `  Quantization Error: ${fmt(summary.quantization_error)}  (lower is better)`,
+                    `  Topographic Error:  ${fmt(summary.topographic_error)}   (<0.1 is good)`,
+                    `  Explained Variance: ${fmt(summary.explained_variance)}  (>0.7 is good)`,
+                    `  Silhouette Score:   ${fmt(summary.silhouette)}          (higher is better)`,
+                    `  Davies-Bouldin:     ${fmt(summary.davies_bouldin)}      (lower is better)`,
+                    `  Calinski-Harabasz:  ${fmt(summary.calinski_harabasz)}   (higher is better)`,
+                    ordErrors && ordErrors.length > 0 ? `  Final ordering QE: ${ordErrors.at(-1)?.toFixed(4)} (use results(action=export, export_type=training_log) for full curve)` : "",
+                    ...(hitLine ? ["", "Hit / U-matrix:", hitLine] : []),
+                    ...(uRangeLine ? [uRangeLine] : []),
+                    ...(compLines ? [`Component value ranges:\n${compLines}`] : []),
+                    ...(clusterLines ? ["", "Cluster map (defining features):", clusterLines] : []),
+                    ...(topCorrLine ? ["", topCorrLine] : []),
+                    ``, `Features: ${features.join(", ")}`,
+                    summary.selected_columns ? `Selected columns: ${summary.selected_columns.join(", ")}` : "",
+                    summary.transforms ? `Transforms: ${Object.entries(summary.transforms).map(([k, v]) => `${k}=${v}`).join(", ")}` : "",
+                    (() => {
+                        const selected = summary.selected_columns;
+                        const original = summary.original_features;
+                        if (!selected?.length || !original?.length)
+                            return "";
+                        const excluded = original.filter((c) => !selected.includes(c));
+                        if (excluded.length === 0)
+                            return "";
+                        return `Columns not used in training: ${excluded.join(", ")}. You can project them onto this map with project(expression=..., project_onto_job=${job_id}) to see how they distribute across the topology. If you ran datasets(action=analyze) before training, any columns it recommended as "project later" are especially good candidates.`;
+                    })(),
+                    ``, `Next: results(action=export, export_type=training_log) for learning curve; results(action=download) to save figures; jobs(action=compare, job_ids=[...]) to compare runs; inference(action=predict) to score new data; project(expression/values) to project other variables onto the map.`,
+                ].filter((l) => l !== "").join("\n");
+                content.push({ type: "text", text: textSummary });
+                const imagesToFetch = getResultsImagesToFetch(jobType, summary, figures, include_individual);
+                for (const name of imagesToFetch) {
+                    const cap = getCaptionForImage(name);
+                    if (cap)
+                        content.push({ type: "text", text: cap });
+                    await tryAttachImage(content, job_id, name);
+                    inlinedImages.add(name);
+                }
+            }
+            const files = summary.files ?? [];
+            const isImage = (f) => f.endsWith(".png") || f.endsWith(".svg") || f.endsWith(".pdf");
+            for (const fname of files) {
+                if (isImage(fname) && !inlinedImages.has(fname)) {
+                    const cap = getCaptionForImage(fname);
+                    if (cap)
+                        content.push({ type: "text", text: cap });
+                    await tryAttachImage(content, job_id, fname);
+                }
+                else if (fname.endsWith(".json") && fname !== "summary.json") {
+                    const hint = fname === "weights.json" ? `Use results(action=export, export_type=weights) for full weight matrix.`
+                        : fname === "node_stats.json" ? `Use results(action=export, export_type=nodes) for per-node statistics.`
+                            : `Use results(action=export) for structured data.`;
+                    content.push({ type: "text", text: `${fname}: ${hint}` });
+                }
+            }
+            const featuresForLog = summary.features ?? [];
+            const jobType2 = summary.job_type ?? "train_som";
+            if (files.length > 0) {
+                const logicalNames = jobType2 === "train_som" || jobType2 === "render_variant"
+                    ? `Logical names: combined, umatrix, hit_histogram, correlation, ${featuresForLog.map((_, i) => `component_${i + 1}`).join(", ")}. `
+                    : "";
+                content.push({ type: "text", text: `Available: ${files.join(", ")}. ${logicalNames}Use results(action=get, figures=[...]) for specific plots or results(action=get, figures=all) for all plots.` });
+            }
+            return { content };
+        }
+        if (action === "export") {
+            if (!exportType)
+                throw new Error("results(export) requires export_type param: training_log, weights, or nodes");
+            if (exportType === "training_log") {
+                const data = (await apiCall("GET", `/v1/results/${job_id}/training-log`));
+                const ordErrors = data.ordering_errors ?? [];
+                const convErrors = data.convergence_errors ?? [];
+                const duration = data.training_duration_seconds;
+                const epochs = data.epochs;
+                const sparkline = (arr) => {
+                    if (arr.length === 0)
+                        return "(no data)";
+                    const blocks = "▁▂▃▄▅▆▇█";
+                    const min = Math.min(...arr);
+                    const max = Math.max(...arr);
+                    const range = max - min || 1;
+                    return arr.map((v) => blocks[Math.min(7, Math.floor(((v - min) / range) * 7))]).join("");
+                };
+                const lines = [
+                    `Training Log — Job ${job_id}`,
+                    `Grid: ${JSON.stringify(data.grid)} | Model: ${data.model ?? "SOM"}`,
+                    `Epochs: ${epochs ? `[${epochs[0]} ordering, ${epochs[1]} convergence]` : "N/A"}`,
+                    `Duration: ${duration !== null && duration !== undefined ? `${duration}s` : "N/A"}`,
+                    `Features: ${data.n_features ?? "?"} | Samples: ${data.n_samples ?? "?"}`,
+                    ``, `Ordering Phase (${ordErrors.length} epochs):`,
+                    `  Start QE: ${ordErrors[0]?.toFixed(4) ?? "—"}  →  End QE: ${ordErrors.at(-1)?.toFixed(4) ?? "—"}`,
+                    `  Curve:    ${sparkline(ordErrors)}`,
+                ];
+                if (convErrors.length > 0) {
+                    lines.push(``, `Convergence Phase (${convErrors.length} epochs):`, `  Start QE: ${convErrors[0]?.toFixed(4) ?? "—"}  →  End QE: ${convErrors.at(-1)?.toFixed(4) ?? "—"}`, `  Curve:    ${sparkline(convErrors)}`);
+                }
+                else if ((epochs?.[1] ?? 0) === 0) {
+                    lines.push(``, `Convergence phase: skipped (epochs[1]=0)`);
+                }
+                const finalQe = data.quantization_error;
+                const finalEv = data.explained_variance;
+                if (finalQe !== null && finalQe !== undefined) {
+                    lines.push(``, `Final QE: ${finalQe.toFixed(4)} | Explained Variance: ${(finalEv ?? 0).toFixed(4)}`);
+                }
+                const content = [{ type: "text", text: lines.join("\n") }];
+                let attached = false;
+                for (const lcExt of ["png", "svg"]) {
+                    try {
+                        const { data: lcBuf } = await apiRawCall(`/v1/results/${job_id}/image/learning_curve.${lcExt}`);
+                        const mime = mimeForFilename(`learning_curve.${lcExt}`);
+                        content.push({ type: "image", data: lcBuf.toString("base64"), mimeType: mime, annotations: { audience: ["user"], priority: 0.8 } });
+                        attached = true;
+                        break;
+                    }
+                    catch {
+                        continue;
+                    }
+                }
+                if (!attached)
+                    content.push({ type: "text", text: "(learning curve plot not available — use results(action=download, figures=[\"learning_curve\"]) to save as PDF if the job uses output_format=pdf)" });
+                return { content };
+            }
+            if (exportType === "weights") {
+                const data = (await apiCall("GET", `/v1/results/${job_id}/weights`));
+                const features = data.features ?? [];
+                const nNodes = data.n_nodes ?? 0;
+                const grid = data.grid ?? [0, 0];
+                const lines = [
+                    `Map weights — Job ${job_id}`,
+                    `Grid: ${grid[0]}×${grid[1]} | Nodes: ${nNodes} | Features: ${features.length}`,
+                    `Features: ${features.join(", ")}`,
+                    ``, `Normalization Stats:`,
+                ];
+                const normStats = data.normalization_stats ?? {};
+                for (const [feat, s] of Object.entries(normStats)) {
+                    lines.push(`  ${feat}: mean=${s.mean?.toFixed(4)}, std=${s.std?.toFixed(4)}`);
+                }
+                lines.push(``, `Full weight matrix in JSON below. Use denormalized_weights for original-scale values.`);
+                return { content: [{ type: "text", text: lines.join("\n") }, { type: "text", text: JSON.stringify(data, null, 2) }] };
+            }
+            const data = (await apiCall("GET", `/v1/results/${job_id}/nodes`));
+            const topNodes = [...data].sort((a, b) => (b.hit_count ?? 0) - (a.hit_count ?? 0)).slice(0, 10);
+            const emptyNodes = data.filter((n) => n.hit_count === 0).length;
+            const totalHits = data.reduce((sum, n) => sum + (n.hit_count ?? 0), 0);
+            const lines = [
+                `Node Statistics — Job ${job_id}`,
+                `Total nodes: ${data.length} | Active: ${data.length - emptyNodes} | Empty: ${emptyNodes} | Total hits: ${totalHits}`,
+                ``, `Top 10 Most Populated Nodes:`,
+                `| Node | Coords | Hits | Hit% |`, `|------|--------|------|------|`,
+            ];
+            for (const n of topNodes) {
+                if (n.hit_count === 0)
+                    break;
+                const coords = n.coords;
+                const pct = ((n.hit_count / totalHits) * 100).toFixed(1);
+                lines.push(`| ${n.node_index} | (${coords?.[0]?.toFixed(1)}, ${coords?.[1]?.toFixed(1)}) | ${n.hit_count} | ${pct}% |`);
+            }
+            return { content: [{ type: "text", text: lines.join("\n") }, { type: "text", text: `\nFull node statistics JSON:\n${JSON.stringify(data, null, 2)}` }] };
+        }
+        if (action === "download") {
+            if (!folder)
+                throw new Error("results(download) requires folder");
+            const data = (await apiCall("GET", `/v1/results/${job_id}`));
+            const summary = (data.summary ?? {});
+            const jobLabel = data.label != null && data.label !== "" ? String(data.label) : null;
+            const files = summary.files ?? [];
+            const isImage = (f) => f.endsWith(".png") || f.endsWith(".svg") || f.endsWith(".pdf");
+            let toDownload;
+            if (figures === "all" || figures === "images" || figures === undefined) {
+                toDownload = include_json ? files : files.filter(isImage);
+            }
+            else if (Array.isArray(figures)) {
+                toDownload = figures;
+                if (include_json && !toDownload.includes("summary.json"))
+                    toDownload = [...toDownload, "summary.json"];
+            }
+            else {
+                toDownload = files.filter(isImage);
+            }
+            let resolvedDir = sandboxPath(folder, await getWorkspaceRootAsync(server));
+            if (jobLabel && (folder === "." || folder === "./results" || folder === "results")) {
+                resolvedDir = path.join(resolvedDir, jobLabel);
+            }
+            await fs.mkdir(resolvedDir, { recursive: true });
+            const saved = [];
+            for (const filename of toDownload) {
+                try {
+                    const { data: buf } = await apiRawCall(`/v1/results/${job_id}/image/${filename}`);
+                    await fs.writeFile(path.join(resolvedDir, filename), buf);
+                    saved.push(filename);
+                }
+                catch { /* skip missing files */ }
+            }
+            return { content: [{ type: "text", text: saved.length > 0 ? `Saved ${saved.length} file(s) to ${folder}: ${saved.join(", ")}` : `No files saved. Check job_id and that the job is completed.` }] };
+        }
+        if (action === "recolor") {
+            if (!colormap)
+                throw new Error("results(recolor) requires colormap");
+            const body = {
+                colormap,
+                figures: recolor_figures ?? ["combined"],
+                output_format: output_format ?? "png",
+                output_dpi: dpiMap[output_dpi ?? "retina"] ?? 2,
+            };
+            const data = (await apiCall("POST", `/v1/results/${job_id}/render`, body));
+            const newJobId = data.id;
+            const poll = await pollUntilComplete(newJobId, 60_000);
+            if (poll.status === "completed") {
+                const content = [{ type: "text", text: `Re-rendered with colormap "${colormap}". New job_id: ${newJobId}.` }];
+                for (const fig of recolor_figures ?? ["combined"]) {
+                    const ext = output_format ?? "png";
+                    const fname = fig.includes(".") ? fig : `${fig}.${ext}`;
+                    await tryAttachImage(content, newJobId, fname);
+                }
+                return { content };
+            }
+            return { content: [{ type: "text", text: `Recolor job ${newJobId} submitted. Poll with jobs(action=status, job_id="${newJobId}"), then results(action=get, job_id="${newJobId}").` }] };
+        }
+        if (action === "transition_flow") {
+            const body = { lag: lag ?? 1, output_format: output_format ?? "png" };
+            if (min_transitions !== undefined)
+                body.min_transitions = min_transitions;
+            if (top_k !== undefined)
+                body.top_k = top_k;
+            if (colormap !== undefined)
+                body.colormap = colormap;
+            if (output_dpi && output_dpi !== "retina")
+                body.output_dpi = dpiMap[output_dpi] ?? 2;
+            const data = (await apiCall("POST", `/v1/results/${job_id}/transition-flow`, body));
+            const flowJobId = data.id;
+            const poll = await pollUntilComplete(flowJobId, 120_000);
+            if (poll.status === "completed") {
+                const res = (await apiCall("GET", `/v1/results/${flowJobId}`));
+                const summary = (res.summary ?? {});
+                const stats = (summary.flow_stats ?? {});
+                const content = [{ type: "text", text: [
+                            `Transition Flow (job: ${flowJobId}) | Parent map: ${job_id} | Lag: ${lag ?? 1}`,
+                            `Active flow nodes: ${stats.active_flow_nodes ?? "N/A"} | Total transitions: ${stats.total_transitions ?? "N/A"}`,
+                            `Mean magnitude: ${stats.mean_magnitude !== undefined ? Number(stats.mean_magnitude).toFixed(4) : "N/A"}`,
+                        ].join("\n") }];
+                await tryAttachImage(content, flowJobId, `transition_flow_lag${lag ?? 1}.${output_format ?? "png"}`);
+                return { content };
+            }
+            if (poll.status === "failed") {
+                return { content: [{ type: "text", text: `Transition flow job ${flowJobId} failed: ${poll.error ?? "unknown error"}` }] };
+            }
+            return { content: [{ type: "text", text: `Transition flow job ${flowJobId} submitted. Poll with jobs(action=status, job_id="${flowJobId}"), retrieve with results(action=get, job_id="${flowJobId}").` }] };
+        }
+        throw new Error("Invalid action");
+    });
+}
+//# sourceMappingURL=results.js.map

package/dist/tools/results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"results.js","sourceRoot":"","sources":["../../src/tools/results.ts"],"names":[],"mappings":"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"}

package/dist/tools/training_guidance.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerTrainingGuidanceTool(server: McpServer): void;
+//# sourceMappingURL=training_guidance.d.ts.map

package/dist/tools/training_guidance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"training_guidance.d.ts","sourceRoot":"","sources":["../../src/tools/training_guidance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAUpE"}

package/dist/tools/training_guidance.js

@@ -0,0 +1,8 @@
+import { fetchTrainingGuidanceFromApi } from "../shared.js";
+export function registerTrainingGuidanceTool(server) {
+    server.tool("training_guidance", "Returns parameter guidance for jobs(action=train_map). Call when you need hints for grid, epochs, batch size, model, or periodic. Domain knowledge is served from the API; requires valid API key. Best for: Before or alongside jobs(action=train_map) when you need hints for grid, epochs, batch, model, or periodic. Not for: Full workflow steps — use guide_barsom_workflow or the prepare_training prompt for that.", {}, async () => {
+        const text = await fetchTrainingGuidanceFromApi();
+        return { content: [{ type: "text", text }] };
+    });
+}
+//# sourceMappingURL=training_guidance.js.map

package/dist/tools/training_guidance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"training_guidance.js","sourceRoot":"","sources":["../../src/tools/training_guidance.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAE5D,MAAM,UAAU,4BAA4B,CAAC,MAAiB;IAC5D,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,4ZAA4Z,EAC5Z,EAAE,EACF,KAAK,IAAI,EAAE;QACT,MAAM,IAAI,GAAG,MAAM,4BAA4B,EAAE,CAAC;QAClD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IACxD,CAAC,CACF,CAAC;AACJ,CAAC"}

package/package.json

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