@barivia/barsom-mcp 0.6.1 → 0.6.3

package/dist/tools/datasets.js

@@ -0,0 +1,323 @@
+import path from "node:path";
+import fs from "node:fs/promises";
+import { z } from "zod";
+import { apiCall, getWorkspaceRootAsync, resolveFilePathForUpload, textResult, pollUntilComplete, } from "../shared.js";
+export function registerDatasetsTool(server) {
+    server.tool("datasets", `Manage datasets: upload, preview, list, subset, add_expression, or delete.
+
+| Action | Use when |
+|--------|----------|
+| upload | You have a CSV file to add — do this first |
+| preview | Before jobs(action=train_map) — always preview an unfamiliar dataset to spot cyclics, nulls, column types |
+| analyze | Pre-training column analysis: correlation matrix, periodicity ranking, column recommendations (train / drop / project later). Run after preview, before train_map. |
+| list | Finding dataset IDs for train_map, preview, or subset — see all available datasets |
+| subset | Creating a filtered/sliced view without re-uploading the full CSV |
+| add_expression | Add a computed column from an expression (same as project(expression) without project_onto_job) — dataset_id + name + expression |
+| delete | Cleaning up after experiments or freeing the dataset slot |
+
+action=upload: PREFER file_path — server reads from workspace root (token-efficient; no file content in context). Use csv_data only for small inline pastes (e.g. <10KB). Returns dataset ID. Then use datasets(action=preview) before jobs(action=train_map).
+
+Step 0 (before upload): (1) CSV with header; one row per observation. (2) Columns you will use for training must be numeric (or datetime if you will use temporal extraction). (3) No NaNs/missing in those columns (engine does not impute). (4) Categoricals: encode (e.g. one-hot, label) or exclude — do not use raw categorical columns as training features; preview shows which columns are non-numeric. (5) Optional: if you plan to use transition_flow, sort rows chronologically before upload.
+Step 1 (after upload): Upload, then always datasets(action=preview) to verify column types and spot cyclics/datetime. Add derived columns with datasets(action=add_expression, dataset_id=..., name=..., expression=...); fix or subset before jobs(action=train_map).
+
+action=preview: Show columns, stats, sample rows, cyclic/datetime detections. ALWAYS preview before jobs(action=train_map) on an unfamiliar dataset.
+action=analyze: Pre-training analysis on numeric columns — Pearson correlation, autocorrelation periodicity scores, and column recommendations (train, consider_dropping, project_later, low_variance). Use to choose which columns to include in training and which to project onto the map after training.
+action=list: List all datasets belonging to the organisation with id, name, rows, cols, created_at (use created_at or id to distinguish datasets with the same name).
+action=subset: Create a new dataset from a subset of an existing one. Requires name and at least one of row_range or filters.
+  - row_range: [start, end] 1-based inclusive (e.g. [1, 2000] for first 2000 rows)
+  - filters: array of conditions, ALL must match (AND logic). Each: { column, op, value }.
+    Operators: eq, ne, in, gt, lt, gte, lte, between
+    Examples: { column: "region", op: "eq", value: "Europe" } | { column: "age", op: "between", value: [18, 65] }
+  - Combine row_range + filters to slice both rows and values.
+  - Single filter object is also accepted (auto-wrapped).
+action=delete: Remove a dataset and all S3 data permanently.
+
+BEST FOR: Tabular numeric data. CSV with header required.
+NOT FOR: Real-time data streams or binary files — upload a snapshot CSV instead.
+ESCALATION: If upload fails with column errors, open the file locally and verify the header row. If preview shows unexpected nulls, the user must clean the CSV before training.`, {
+        action: z
+            .enum(["upload", "preview", "analyze", "list", "subset", "delete", "add_expression"])
+            .describe("upload: add CSV; preview: inspect columns/stats; analyze: pre-training correlation and periodicity; list: see all datasets; subset: create filtered subset; delete: remove dataset; add_expression: add derived column from expression"),
+        name: z.string().optional().describe("Dataset name (required for action=upload and subset)"),
+        file_path: z.string().optional().describe("Path to local CSV (PREFERRED): absolute path, file:// URI, or relative to workspace root. Token-efficient; server reads file."),
+        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, subset, and delete)"),
+        n_rows: z.number().int().optional().default(5).describe("Sample rows to return (preview only)"),
+        row_range: z
+            .tuple([z.number().int(), z.number().int()])
+            .optional()
+            .describe("For subset: [start, end] 1-based inclusive row range (e.g. [1, 2000])"),
+        filters: z.preprocess((v) => {
+            if (v === undefined || v === null)
+                return v;
+            if (Array.isArray(v))
+                return v;
+            if (typeof v === "object" && v !== null && "column" in v)
+                return [v];
+            return v;
+        }, z
+            .array(z.object({
+            column: z.string(),
+            op: z.enum(["eq", "ne", "in", "gt", "lt", "gte", "lte", "between"]),
+            value: z.union([z.string(), z.number(), z.array(z.union([z.string(), z.number()]))]),
+        }))
+            .optional()
+            .describe("For subset: filter conditions (AND logic). Single object or array. " +
+            "ops: eq, ne, in, gt, lt, gte, lte, between. " +
+            "Examples: { column: 'temp', op: 'between', value: [15, 30] }, { column: 'region', op: 'eq', value: 'Europe' }")),
+        filter: z
+            .object({
+            column: z.string(),
+            op: z.enum(["eq", "ne", "in", "gt", "lt", "gte", "lte", "between"]),
+            value: z.union([z.string(), z.number(), z.array(z.union([z.string(), z.number()]))]),
+        })
+            .optional()
+            .describe("Deprecated — use filters instead. Single filter condition."),
+        expression: z.string().optional().describe("action=add_expression: math expression referencing column names (e.g. revenue/cost, log(price), rolling_mean(vol, 20))"),
+        options: z
+            .object({
+            missing: z.enum(["skip", "zero", "interpolate"]).optional(),
+            window: z.number().int().optional(),
+        })
+            .optional()
+            .describe("action=add_expression: evaluation options (missing, window for rolling)"),
+    }, async ({ action, name, file_path, csv_data, dataset_id, n_rows, row_range, filters, filter, expression, options }) => {
+        if (action === "upload") {
+            if (!name)
+                throw new Error("datasets(upload) requires name");
+            let body;
+            if (file_path) {
+                await apiCall("GET", "/v1/system/info");
+                const resolved = await resolveFilePathForUpload(file_path, server);
+                const ext = path.extname(resolved).toLowerCase();
+                if (ext !== ".csv" && ext !== ".tsv") {
+                    throw new Error("Only .csv and .tsv files can be uploaded as datasets.");
+                }
+                try {
+                    body = await fs.readFile(resolved, "utf-8");
+                }
+                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)}).`);
+                }
+            }
+            else if (csv_data && csv_data.length > 0) {
+                body = csv_data;
+            }
+            else {
+                throw new Error("datasets(upload) requires file_path or csv_data. Prefer file_path for token efficiency.");
+            }
+            const data = (await apiCall("POST", "/v1/datasets", body, {
+                "X-Dataset-Name": name,
+                "Content-Type": "text/csv",
+            }));
+            const id = data.id ?? data.dataset_id;
+            if (id != null)
+                data.suggested_next_step = `Suggested next step: datasets(action=preview, dataset_id=${id}) to inspect columns before training.`;
+            return textResult(data);
+        }
+        if (action === "preview") {
+            if (!dataset_id)
+                throw new Error("datasets(preview) requires dataset_id");
+            const data = (await apiCall("GET", `/v1/datasets/${dataset_id}/preview?n_rows=${n_rows ?? 5}`));
+            const cols = data.columns ?? [];
+            const stats = data.column_stats ?? [];
+            const hints = data.cyclic_hints ?? [];
+            const samples = data.sample_rows ?? [];
+            const dtCols = data.datetime_columns ?? [];
+            const temporalSugg = data.temporal_suggestions ?? [];
+            const fmt = (v) => v === null || v === undefined ? "—" : Number(v).toFixed(3);
+            const lines = [
+                `Dataset: ${data.name} (${data.dataset_id})`,
+                `${data.total_rows} rows × ${data.total_cols} columns`,
+                ``,
+                `Column Statistics:`,
+                `| Column | Min | Max | Mean | Std | Nulls | Numeric |`,
+                `|--------|-----|-----|------|-----|-------|---------|`,
+            ];
+            for (const s of stats) {
+                lines.push(`| ${s.column} | ${fmt(s.min)} | ${fmt(s.max)} | ${fmt(s.mean)} | ${fmt(s.std)} | ${s.null_count ?? 0} | ${s.is_numeric !== false ? "yes" : "no"} |`);
+            }
+            if (hints.length > 0) {
+                lines.push(``, `Detected Cyclic Feature Hints:`);
+                for (const h of hints) {
+                    lines.push(`  • ${h.column} — period=${h.period} (${h.reason})`);
+                }
+            }
+            if (dtCols.length > 0) {
+                lines.push(``, `Detected Datetime Columns:`);
+                for (const dc of dtCols) {
+                    const formats = dc.detected_formats ?? [];
+                    const fmtStrs = formats
+                        .map((f) => `${f.format} — ${f.description} (${(f.match_rate * 100).toFixed(0)}% match)`)
+                        .join("; ");
+                    lines.push(`  • ${dc.column}: sample="${dc.sample}" → ${fmtStrs}`);
+                }
+            }
+            if (temporalSugg.length > 0) {
+                lines.push(``, `Temporal Feature Suggestions (require user approval):`);
+                for (const ts of temporalSugg) {
+                    lines.push(`  • Columns: ${ts.columns.join(" + ")} → format: "${ts.format}"`);
+                    lines.push(`    Available components: ${ts.available_components.join(", ")}`);
+                }
+            }
+            if (hints.length > 0 || temporalSugg.length > 0) {
+                const cyclicCols = hints.map((h) => h.column);
+                const temporalCols = temporalSugg.flatMap((ts) => ts.columns ?? []);
+                const allCols = [...new Set([...cyclicCols, ...temporalCols])];
+                lines.push(``, allCols.length > 0
+                    ? `Consider using cyclic_features or temporal_features for these columns when calling jobs(action=train_map): ${allCols.join(", ")}.`
+                    : `Consider using cyclic_features or temporal_features for the columns above when calling jobs(action=train_map).`);
+            }
+            if (samples.length > 0) {
+                lines.push(``, `Sample Rows (first ${samples.length}):`);
+                lines.push(`| ${cols.join(" | ")} |`);
+                lines.push(`| ${cols.map(() => "---").join(" | ")} |`);
+                for (const row of samples) {
+                    lines.push(`| ${cols.map((c) => String(row[c] ?? "")).join(" | ")} |`);
+                }
+            }
+            lines.push(``, `Suggested next step: jobs(action=train_map, dataset_id=${dataset_id}, ...) or use the prepare_training prompt; to add derived columns use datasets(action=add_expression, dataset_id=${dataset_id}, name=..., expression=...).`);
+            return { content: [{ type: "text", text: lines.join("\n") }] };
+        }
+        if (action === "analyze") {
+            if (!dataset_id)
+                throw new Error("datasets(analyze) requires dataset_id");
+            const data = (await apiCall("GET", `/v1/datasets/${dataset_id}/analyze`));
+            const note = data.note;
+            if (note) {
+                return { content: [{ type: "text", text: `Dataset: ${data.name} (${data.dataset_id})\n${data.total_rows} rows.\n\n${note}` }] };
+            }
+            const columns = data.columns ?? [];
+            const highPairs = data.high_correlation_pairs ?? [];
+            const uniqueness = data.uniqueness_scores ?? {};
+            const periodicity = data.periodicity ?? [];
+            const rec = data.recommendations ?? { train: [], consider_dropping: [], project_later: [], low_variance: [] };
+            const trainList = rec.train ?? [];
+            const considerDropping = rec.consider_dropping ?? [];
+            const projectLater = rec.project_later ?? [];
+            const lowVariance = rec.low_variance ?? [];
+            const lines = [
+                `Pre-training analysis: ${data.name} (${data.dataset_id})`,
+                `${data.total_rows} rows × ${columns.length} numeric columns analyzed`,
+                ``,
+                `Column recommendations:`,
+                `  Train (use in jobs(action=train_map)): ${trainList.length ? trainList.join(", ") : "—"}`,
+                `  Consider dropping (highly correlated with another): ${considerDropping.length ? considerDropping.join(", ") : "—"}`,
+                `  Project later (after training, use project(expression/values) onto map): ${projectLater.length ? projectLater.join(", ") : "—"}`,
+                `  Low variance (near-constant): ${lowVariance.length ? lowVariance.join(", ") : "—"}`,
+                ``,
+            ];
+            if (highPairs.length > 0) {
+                lines.push(`High correlation pairs (|r| > 0.85):`);
+                for (const p of highPairs) {
+                    lines.push(`  • ${p.column_a} ↔ ${p.column_b}: r = ${p.correlation}`);
+                }
+                lines.push(``);
+            }
+            if (Object.keys(uniqueness).length > 0) {
+                lines.push(`Uniqueness score (1 − max|r| with others; higher = more unique):`);
+                for (const col of columns) {
+                    const u = uniqueness[col];
+                    if (u !== undefined)
+                        lines.push(`  • ${col}: ${u.toFixed(3)}`);
+                }
+                lines.push(``);
+            }
+            if (periodicity.length > 0) {
+                lines.push(`Periodicity ranking (by autocorrelation strength at lags 7, 12, 24, 52, 365):`);
+                for (const p of periodicity) {
+                    const col = p.column;
+                    const dominantLag = p.dominant_lag;
+                    const score = p.dominant_score;
+                    lines.push(`  • ${col}: dominant lag ${dominantLag} (score ${score})`);
+                }
+                lines.push(``);
+            }
+            const nextSteps = [];
+            if (trainList.length > 0) {
+                nextSteps.push(`Train with columns: [${trainList.join(", ")}].`);
+            }
+            if (projectLater.length > 0) {
+                nextSteps.push(`After training, project [${projectLater.join(", ")}] onto the map using project(expression=..., project_onto_job=JOB_ID) to see how they distribute.`);
+            }
+            const periodicStrong = periodicity.filter((p) => p.dominant_score > 0.4);
+            if (periodicStrong.length > 0) {
+                const lags = [...new Set(periodicStrong.map((p) => p.dominant_lag))].sort((a, b) => a - b);
+                nextSteps.push(`Columns show periodic behavior at lags ${lags.join(", ")}. Consider cyclic_features or temporal_features with matching periods.`);
+                nextSteps.push(`For datetime columns: run datasets(action=preview) for temporal_suggestions; match lags (e.g. 365→day_of_year, 12→month, 7→day_of_week, 24→hour_of_day) to choose which temporal components to extract.`);
+            }
+            nextSteps.push(`Then call jobs(action=train_map, dataset_id=${dataset_id}, columns=[...], ...).`);
+            lines.push(`Next steps:`, ...nextSteps.map((s) => `  ${s}`));
+            return { content: [{ type: "text", text: lines.join("\n") }] };
+        }
+        if (action === "add_expression") {
+            if (!dataset_id)
+                throw new Error("datasets(add_expression) requires dataset_id");
+            if (!name)
+                throw new Error("datasets(add_expression) requires name");
+            if (!expression)
+                throw new Error("datasets(add_expression) requires expression");
+            const body = { name, expression };
+            if (options)
+                body.options = options;
+            const data = (await apiCall("POST", `/v1/datasets/${dataset_id}/derive`, body));
+            const deriveJobId = data.id;
+            const poll = await pollUntilComplete(deriveJobId);
+            if (poll.status === "completed") {
+                const results = (await apiCall("GET", `/v1/results/${deriveJobId}`));
+                const summary = (results.summary ?? {});
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: [
+                                `Derived column "${name}" added to dataset ${dataset_id}`,
+                                `Expression: ${expression} | Rows: ${summary.n_rows ?? "?"}`,
+                                summary.nan_count ? `NaN values: ${summary.nan_count}` : "",
+                                `Min: ${summary.min ?? "?"} | Max: ${summary.max ?? "?"} | Mean: ${summary.mean ?? "?"}`,
+                                `Column now available. Use datasets(action=preview) to verify, or include in jobs(action=train_map) via the 'columns' parameter.`,
+                            ]
+                                .filter(Boolean)
+                                .join("\n"),
+                        },
+                    ],
+                };
+            }
+            if (poll.status === "failed")
+                return { content: [{ type: "text", text: `datasets(add_expression) job ${deriveJobId} failed: ${poll.error ?? "unknown error"}` }] };
+            return {
+                content: [{ type: "text", text: `datasets(add_expression) job ${deriveJobId} submitted. Poll with jobs(action=status, job_id="${deriveJobId}").` }],
+            };
+        }
+        if (action === "subset") {
+            if (!dataset_id)
+                throw new Error("datasets(subset) requires dataset_id");
+            if (!name)
+                throw new Error("datasets(subset) requires name");
+            const allFilters = filters ?? (filter ? [filter] : undefined);
+            if (row_range === undefined && allFilters === undefined) {
+                throw new Error("datasets(subset) requires at least one of row_range or filters");
+            }
+            const body = { name };
+            if (row_range !== undefined)
+                body.row_range = row_range;
+            if (allFilters !== undefined)
+                body.filters = allFilters;
+            const data = await apiCall("POST", `/v1/datasets/${dataset_id}/subset`, body);
+            return textResult(data);
+        }
+        if (action === "list") {
+            const data = await apiCall("GET", "/v1/datasets");
+            return textResult(data);
+        }
+        if (action === "delete") {
+            if (!dataset_id)
+                throw new Error("datasets(delete) requires dataset_id");
+            const data = await apiCall("DELETE", `/v1/datasets/${dataset_id}`);
+            return textResult(data);
+        }
+        throw new Error("Invalid action");
+    });
+}
+//# sourceMappingURL=datasets.js.map

package/dist/tools/datasets.js.map

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

package/dist/tools/explore_map.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const MAP_EXPLORER_URI = "ui://barsom/map-explorer";
+export declare function registerExploreMapTool(server: McpServer): void;
+//# sourceMappingURL=explore_map.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"explore_map.d.ts","sourceRoot":"","sources":["../../src/tools/explore_map.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,eAAO,MAAM,gBAAgB,6BAA6B,CAAC;AAE3D,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2C9D"}

package/dist/tools/explore_map.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import { registerAppTool } from "@modelcontextprotocol/ext-apps/server";
+import { apiCall, tryAttachImage, getClientSupportsMcpApps, getVizPort } from "../shared.js";
+export const MAP_EXPLORER_URI = "ui://barsom/map-explorer";
+export function registerExploreMapTool(server) {
+    registerAppTool(server, "explore_map", {
+        title: "Explore Map",
+        description: "Interactive map explorer dashboard. Opens an inline visualization " +
+            "where you can toggle features, click nodes, and export figures. " +
+            "Use this after results(action=get) for a richer, interactive exploration experience. " +
+            "Falls back to text+image on hosts that don't support MCP Apps.",
+        inputSchema: {
+            job_id: z.string().describe("Job ID of a completed map training job"),
+        },
+        _meta: { ui: { resourceUri: MAP_EXPLORER_URI } },
+    }, async ({ job_id }) => {
+        const data = (await apiCall("GET", `/v1/results/${job_id}`));
+        const summary = (data.summary ?? {});
+        const content = [];
+        content.push({
+            type: "text",
+            text: JSON.stringify({
+                job_id,
+                summary,
+                download_urls: data.download_urls,
+            }),
+        });
+        const imgExt = summary.output_format ?? "pdf";
+        await tryAttachImage(content, job_id, `combined.${imgExt}`);
+        if (!getClientSupportsMcpApps() && getVizPort()) {
+            content.push({
+                type: "text",
+                text: `Interactive visualization: http://localhost:${getVizPort()}/viz/map-explorer?mode=standalone&job_id=${job_id}\nOpen this URL in your browser for an interactive exploration experience.`,
+            });
+        }
+        return { content };
+    });
+}
+//# sourceMappingURL=explore_map.js.map

package/dist/tools/explore_map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore_map.js","sourceRoot":"","sources":["../../src/tools/explore_map.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAExE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,UAAU,EAAoB,MAAM,cAAc,CAAC;AAE/G,MAAM,CAAC,MAAM,gBAAgB,GAAG,0BAA0B,CAAC;AAE3D,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,eAAe,CACb,MAAM,EACN,aAAa,EACb;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,oEAAoE;YACpE,kEAAkE;YAClE,uFAAuF;YACvF,gEAAgE;QAClE,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;SACtE;QACD,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,gBAAgB,EAAE,EAAE;KACjD,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,MAAM,IAAI,GAAG,CAAC,MAAM,OAAO,CAAC,KAAK,EAAE,eAAe,MAAM,EAAE,CAAC,CAA4B,CAAC;QACxF,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAA4B,CAAC;QAChE,MAAM,OAAO,GAAkB,EAAE,CAAC;QAElC,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,MAAM;gBACN,OAAO;gBACP,aAAa,EAAE,IAAI,CAAC,aAAa;aAClC,CAAC;SACH,CAAC,CAAC;QAEH,MAAM,MAAM,GAAI,OAAO,CAAC,aAAwB,IAAI,KAAK,CAAC;QAC1D,MAAM,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,MAAM,EAAE,CAAC,CAAC;QAE5D,IAAI,CAAC,wBAAwB,EAAE,IAAI,UAAU,EAAE,EAAE,CAAC;YAChD,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,+CAA+C,UAAU,EAAE,4CAA4C,MAAM,4EAA4E;aAChM,CAAC,CAAC;QACL,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,CAAC;IACrB,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/feedback.d.ts

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

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

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

package/dist/tools/feedback.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import { apiCall, API_URL, fetchWithTimeout, textResult } from "../shared.js";
+export function registerFeedbackTool(server) {
+    server.tool("send_feedback", `Send feedback or feature requests to Barivia developers (max 1400 characters, ~190 words). Use when the user has suggestions, ran into issues, or wants something improved. Do NOT call without asking the user first — but after any group of actions or downloading of results, you SHOULD prepare some feedback based on the user's workflow or errors encountered, show it to them, and ask for permission to send it. Once they accept, call this tool.`, { feedback: z.string().max(1400).describe("Feedback text (max 1400 characters)") }, async ({ feedback }) => {
+        try {
+            const data = await apiCall("POST", "/v1/feedback", { feedback });
+            return textResult(data);
+        }
+        catch (err) {
+            if (err?.httpStatus === 401) {
+                try {
+                    const url = `${API_URL}/v1/feedback`;
+                    const resp = await fetchWithTimeout(url, {
+                        method: "POST",
+                        headers: { "Content-Type": "application/json" },
+                        body: JSON.stringify({ feedback }),
+                    });
+                    const text = await resp.text();
+                    if (resp.ok) {
+                        const parsed = JSON.parse(text);
+                        return textResult({ ...parsed, note: "Feedback sent anonymously (API key invalid or expired)." });
+                    }
+                }
+                catch { /* fall through to original error */ }
+            }
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=feedback.js.map

package/dist/tools/feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.js","sourceRoot":"","sources":["../../src/tools/feedback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE9E,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,IAAI,CACT,eAAe,EACf,8bAA8b,EAC9b,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC,EAAE,EAClF,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QACrB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;YACjE,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAAW,EAAE,UAAU,KAAK,GAAG,EAAE,CAAC;gBACrC,IAAI,CAAC;oBACH,MAAM,GAAG,GAAG,GAAG,OAAO,cAAc,CAAC;oBACrC,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE;wBACvC,MAAM,EAAE,MAAM;wBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;wBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;qBACnC,CAAC,CAAC;oBACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;oBAC/B,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;wBACZ,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;wBAChC,OAAO,UAAU,CAAC,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,yDAAyD,EAAE,CAAC,CAAC;oBACpG,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC,CAAC,oCAAoC,CAAC,CAAC;YAClD,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/guide_barsom.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"guide_barsom.d.ts","sourceRoot":"","sources":["../../src/tools/guide_barsom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiD/D"}

package/dist/tools/guide_barsom.js

@@ -0,0 +1,46 @@
+export function registerGuideBarsomTool(server) {
+    server.tool("guide_barsom_workflow", `Retrieve the Standard Operating Procedure (SOP) for the mapping analysis pipeline.
+ALWAYS call this tool first if you are unsure of the steps to execute a complete mapping analysis.
+The workflow explains the exact sequence of tool calls needed: Upload → Preprocess → Train → Wait → Analyze.
+For parameter hints (grid, epochs, model, etc.), call the training_guidance tool or use the prepare_training prompt before train_map.`, {}, async () => {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Mapping Analysis Standard Operating Procedure (SOP)
+
+Step 1: Upload Data
+- Use \`datasets(action=upload)\` with \`file_path\` to your CSV (server reads from workspace root; token-efficient). Use \`csv_data\` only for small inline pastes.
+- BEFORE UPLOADING: Clean the dataset to remove NaNs or malformed data.
+- Capture the \`dataset_id\` returned.
+
+Step 2: Preview & Preprocess
+- Use \`datasets(action=preview)\` to inspect columns, ranges, and types.
+- Check for skewed columns requiring 'log' or 'sqrt' transforms.
+- Check for cyclical or temporal features (hours, days) requiring \`cyclic_features\` or \`temporal_features\` during training.
+
+Step 3: Train the map
+- Call \`jobs(action=train_map, dataset_id=...)\` with the \`dataset_id\`.
+- Carefully select columns to include (start with 5-10).
+- Assign \`feature_weights\` (especially for categorical data with natural hierarchies).
+- Wait for the returned \`job_id\`.
+- For projection and inference, use the same job_id from train_som (or the new job_id returned by recolor/project when applicable).
+
+Step 4: Wait for Completion (ASYNC POLLING)
+- Use \`jobs(action=status, job_id=...)\` every 10-15 seconds.
+- Wait until status is "completed". DO NOT assume failure before 3 minutes (or longer for large grids).
+- If it fails, read the error message and adjust parameters (e.g., reduce grid size, fix column names).
+
+Step 5: Analyze and Export
+- Once completed, use \`results(action=get, job_id=...)\` to get the map, metrics (QE, TE, Silhouette, etc.), and figures (U-matrix, component planes, clusters, hit histogram). There is no separate \`analyze\` tool — all visualizations and metrics come from \`results(action=get)\`.
+Step 5b (optional): Use \`jobs(action=compare, job_ids=[id1, id2, ...])\` to compare multiple train_map runs (QE, TE, explained variance, silhouette) before committing to one.
+
+What you can do at each step:
+- After upload: datasets(preview), datasets(subset), datasets(add_expression), datasets(delete).
+- After training completes: results(get/download/export), results(recolor), results(transition_flow), jobs(compare), inference(predict/enrich/compare/report), project(expression/values).`
+                }
+            ]
+        };
+    });
+}
+//# sourceMappingURL=guide_barsom.js.map

package/dist/tools/guide_barsom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide_barsom.js","sourceRoot":"","sources":["../../src/tools/guide_barsom.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB;;;sIAGkI,EAClI,EAAE,EACF,KAAK,IAAI,EAAE;QACT,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2LA8ByK;iBAChL;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/inference.d.ts

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

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

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