@barivia/barsom-mcp 0.17.0 → 0.17.1

package/README.md

@@ -182,6 +182,10 @@ The right viewer depends on **(MCP App support)** **and** **(can the human reach
 
 ### Migration notes
 
+- **Fixes (0.17.1, non-breaking):**
+  - `datasets(action=list/get)` no longer prints `ingest_error=missing` for healthy datasets (a SQL `NULL` was serialized as the literal `"missing"`; fixed server-side, and the proxy now also ignores the `missing`/`null` sentinels).
+  - `file_path` upload help now states that **relative** paths resolve against the MCP **workspace root** — in Cursor/IDE clients that root is often the MCP install dir, so set `BARIVIA_WORKSPACE_ROOT` (or pass an absolute path) if a relative path is "not accessible".
+  - Preprocessing failures now name the **offending column(s)** (e.g. missing cells in a `train(action=map)` column) instead of a generic error.
 - **Surface cleanup (0.17.0, breaking):**
   - `train(action=baseline_study)` **removed** — use `train(action=map, preset=quick)` (the `baseline_explore` preset in `training_guidance`).
   - `results(action=transition_flow)` **removed** — it is now **`inference(action=transition_flow)`** (a frozen-map operation). Read the resulting figure with `results(action=get/download)` on the returned job_id.

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.17.0";
+export const CLIENT_VERSION = "0.17.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). */

package/dist/tools/datasets.js

@@ -6,6 +6,17 @@ import { z } from "zod";
 import { registerAuditedTool } from "../audit.js";
 import { apiCall, getWorkspaceRootAsync, resolveFilePathForUpload, textResult, pollUntilComplete, POLL_DERIVE_MAX_MS, UPLOAD_DATASET_TIMEOUT_MS, LARGE_UPLOAD_BYTES, PRESIGNED_PUT_TIMEOUT_MS, POLL_STAGE_MAX_MS, streamFileSha256, putPresignedStream, } from "../shared.js";
 import { GZIP_UPLOAD_HINT } from "../job_status_format.js";
+/**
+ * Normalize a nullable string field from the API. Returns "" for absent values,
+ * empty strings, and the literal SQL/serialization sentinels "missing"/"null"
+ * (older backends serialized a NULL ingest_error as the string "missing").
+ */
+function cleanNullable(v) {
+    if (v == null)
+        return "";
+    const s = String(v).trim();
+    return s === "" || s.toLowerCase() === "missing" || s.toLowerCase() === "null" ? "" : s;
+}
 /**
  * Format a dataset analyze result (from either the async job summary or the
  * legacy sync GET response) into the human-readable text block.
@@ -165,7 +176,7 @@ ESCALATION: If upload fails with column errors, open the file locally and verify
             .enum(["upload", "preview", "analyze", "list", "get", "subset", "delete", "add_expression", "reduce_spectral"])
             .describe("upload: add CSV or .csv.gz; preview: inspect columns/stats; analyze: pre-training correlation and periodicity; list: see all datasets; get: fetch one dataset metadata (status/staging); subset: create filtered subset; delete: remove dataset; add_expression: add derived column from expression (or, with project_onto_job, project the expression onto a trained map as a component plane); reduce_spectral: collapse a long ordered numeric block (e.g. spectrum, time series) into a small per-row feature set via PCA / log_sample / uniform_sample / stats"),
         name: z.string().optional().describe("Dataset name (required for action=upload and subset)"),
-        file_path: z.string().optional().describe("Path to local CSV or .csv.gz (PREFERRED): absolute path, file:// URI, or relative to workspace root. Token-efficient; server reads file. Use .csv.gz for large scientific tables."),
+        file_path: z.string().optional().describe("Path to local CSV or .csv.gz (PREFERRED): absolute path, file:// URI, or path relative to the workspace root. Token-efficient; server reads file. NOTE: relative paths resolve against the MCP workspace root — in Cursor/IDE clients that root is often the MCP install dir, not your project, so set BARIVIA_WORKSPACE_ROOT in the MCP config env (or just pass an absolute path) if a relative path is 'not accessible'. Use .csv.gz for large scientific tables."),
         csv_data: z.string().optional().describe("Inline CSV string for small pastes only (<10KB). Avoid for large files — use file_path instead to avoid token explosion."),
         dataset_id: z.string().optional().describe("Dataset ID (required for preview, get, subset, and delete)"),
         n_rows: z.number().int().optional().default(5).describe("Sample rows to return (preview only)"),
@@ -632,9 +643,8 @@ ESCALATION: If upload fails with column errors, open the file locally and verify
                     const cols = ds.cols != null ? Number(ds.cols) : "?";
                     const st = ds.status != null ? String(ds.status) : "ready";
                     const statusBit = st !== "ready" ? ` | status=${st}` : "";
-                    const err = ds.ingest_error != null && String(ds.ingest_error) !== ""
-                        ? ` | ingest_error=${String(ds.ingest_error)}`
-                        : "";
+                    const ingestErr = cleanNullable(ds.ingest_error);
+                    const err = ingestErr ? ` | ingest_error=${ingestErr}` : "";
                     return `${name} (${id}) — ${rows}×${cols}${statusBit}${err}`;
                 });
                 return { content: [{ type: "text", text: lines.length > 0 ? lines.join("\n") : "No datasets." }] };
@@ -653,9 +663,7 @@ ESCALATION: If upload fails with column errors, open the file locally and verify
                 ds.staged_prefix != null ? `Staged prefix: ${String(ds.staged_prefix)}` : "",
                 ds.staged_version != null ? `Staged version: ${String(ds.staged_version)}` : "",
                 ds.stage_job_id != null ? `Stage job: ${String(ds.stage_job_id)} (poll jobs(action=status))` : "",
-                ds.ingest_error != null && String(ds.ingest_error) !== ""
-                    ? `Ingest error: ${String(ds.ingest_error)}`
-                    : "",
+                cleanNullable(ds.ingest_error) ? `Ingest error: ${cleanNullable(ds.ingest_error)}` : "",
                 ds.created_at != null ? `Created: ${String(ds.created_at)}` : "",
             ].filter(Boolean);
             return { content: [{ type: "text", text: lines.join("\n") }] };

package/package.json

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