@barivia/barsom-mcp 0.18.0 → 0.18.1

package/dist/shared.js

@@ -26,7 +26,7 @@ export const RETRYABLE_STATUS = new Set([502, 503, 504]);
  * 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.18.0";
+export const CLIENT_VERSION = "0.18.1";
 /** 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). */
@@ -289,7 +289,8 @@ export async function resolveFilePathForUpload(filePath, mcpServer) {
         if (err instanceof Error && (err.message.includes("escapes") || err.message.includes("regular file"))) {
             throw err;
         }
-        throw new Error(`File not accessible. For relative paths, set BARIVIA_WORKSPACE_ROOT in your MCP config. Or use an absolute path or file:// URI.`);
+        throw new Error(`File not accessible. Easiest fix: pass an ABSOLUTE path (e.g. "/home/you/project/data.csv" or ` +
+            `"C:\\\\Users\\\\you\\\\data.csv") or a file:// URI. For relative paths, set BARIVIA_WORKSPACE_ROOT in your MCP config.`);
     }
 }
 /** User-visible API error line (includes request id for support). Exported for tests. */

package/dist/tools/datasets.js

@@ -278,8 +278,10 @@ ESCALATION: If upload fails with column errors, open the file locally and verify
                     stat = await fs.stat(resolved);
                 }
                 catch {
-                    throw new Error(`File not accessible at resolved path. file_path is relative to workspace root. ` +
-                        `Set BARIVIA_WORKSPACE_ROOT in your MCP config env if needed (current: ${await getWorkspaceRootAsync(server)}).`);
+                    throw new Error(`File not accessible at resolved path. Easiest fix: pass an ABSOLUTE path ` +
+                        `(e.g. "/home/you/project/data.csv" or "C:\\\\Users\\\\you\\\\data.csv") or a file:// URI. ` +
+                        `Relative paths resolve against the MCP workspace root (current: ${await getWorkspaceRootAsync(server)}); ` +
+                        `set BARIVIA_WORKSPACE_ROOT in your MCP config env to your project directory to use them.`);
                 }
                 if (stat.size > HARD_MAX_BYTES) {
                     const gzipHint = isGzipInput ? "" : ` ${GZIP_UPLOAD_HINT}`;

package/dist/tools/explore_map.js

@@ -152,8 +152,8 @@ async function handleResultsExplorer(job_id) {
     if (!getClientSupportsMcpApps() && payload.standaloneUrl) {
         content.push({
             type: "text",
-            text: `Interactive visualization: ${payload.standaloneUrl}\n` +
-                `Open this URL in your browser for a richer results exploration experience. ` +
+            text: `Interactive results explorer: [Open results explorer](${payload.standaloneUrl})\n` +
+                `AGENT: surface this to the user as a clickable markdown link (e.g. "[Open results explorer](${payload.standaloneUrl})") in your reply — do not leave it buried in tool output. ` +
                 `This localhost port is assigned per MCP session and changes if the proxy restarts — if the page won't load, re-run results_explorer for a fresh URL, or set BARIVIA_VIZ_PORT in your MCP env for a persistent port.`,
         });
     }

package/dist/tools/training_monitor.js

@@ -96,7 +96,8 @@ export function registerTrainingMonitorTool(server) {
         if (!getClientSupportsMcpApps() && standaloneUrl) {
             content.push({
                 type: "text",
-                text: `Open in browser (best kept open during training): ${standaloneUrl}\n` +
+                text: `Live training monitor: [Open training monitor](${standaloneUrl})\n` +
+                    `AGENT: surface this to the user as a clickable markdown link (e.g. "[Open training monitor](${standaloneUrl})") in your reply — do not leave it buried in tool output. Re-post the link after the job completes so the user can return to the curves.\n` +
                     `This localhost port is assigned per MCP session and changes if the proxy restarts — if the page stays at "running 0%" or stops updating, the link is stale: re-run training_monitor for a fresh URL, or set BARIVIA_VIZ_PORT in your MCP env for a persistent port. Health check: http://localhost:${port}/api/health?job_id=${encodeURIComponent(job_id)}`,
             });
         }

package/dist/tools/training_prep.js

@@ -481,7 +481,8 @@ function buildTrainingPrepContent(payload) {
     if (!getClientSupportsMcpApps() && payload.standaloneUrl) {
         content.push({
             type: "text",
-            text: `Interactive review: ${payload.standaloneUrl}\nOpen this URL in your browser to review and submit the prepared job.`,
+            text: `Interactive training prep review: [Open training prep](${payload.standaloneUrl})\n` +
+                `AGENT: surface this to the user as a clickable markdown link (e.g. "[Open training prep](${payload.standaloneUrl})") in your reply — do not leave it buried in tool output. The user opens it to review and submit the prepared job.`,
         });
     }
     return content;

package/package.json

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