@cyanheads/brapi-mcp-server 0.4.13 → 0.5.0

package/dist/index.js

@@ -6,45 +6,91 @@
  *
  * @module index
  */
+// Default the framework canvas provider to DuckDB. The framework defaults
+// `CANVAS_PROVIDER_TYPE` to `'none'`; this server requires a live canvas
+// for spillover, so we override the default before `createApp` reads
+// config. Operator-set values (including `'none'` for diagnostic runs)
+// pass through untouched.
+//
+// ESM hoists the import below ahead of this statement, but the framework's
+// `config` is a lazy Proxy — importing it only declares the Proxy, the
+// underlying `parseConfig()` runs on first property access (which happens
+// inside `createApp`). So this line lands in the window between
+// import-time evaluation and `createApp`'s config read.
+process.env.CANVAS_PROVIDER_TYPE ??= 'duckdb';
+// Bridge `BRAPI_EXPORT_DIR` → `CANVAS_EXPORT_PATH` so the framework's canvas
+// path-traversal sandbox uses the operator-set export root. `??=` so an
+// explicit `CANVAS_EXPORT_PATH` wins (operators who configure the framework
+// directly retain control). When `BRAPI_EXPORT_DIR` is unset, neither is
+// set — the export tool's registration gate fails closed and the canvas
+// runs without an export root (any export call would hit the framework's
+// sandbox check).
+if (process.env.BRAPI_EXPORT_DIR) {
+    process.env.CANVAS_EXPORT_PATH ??= process.env.BRAPI_EXPORT_DIR;
+}
 import { createApp } from '@cyanheads/mcp-ts-core';
+import { configurationError } from '@cyanheads/mcp-ts-core/errors';
 import { disabledTool } from '@cyanheads/mcp-ts-core/tools';
 import { getServerConfig } from './config/server-config.js';
 import { initBrapiClient } from './services/brapi-client/index.js';
 import { initBrapiDialectRegistry } from './services/brapi-dialect/index.js';
 import { initCanvasBridge } from './services/canvas-bridge/index.js';
 import { initCapabilityRegistry } from './services/capability-registry/index.js';
-import { initDatasetStore } from './services/dataset-store/index.js';
 import { initOntologyResolver } from './services/ontology-resolver/index.js';
 import { initReferenceDataCache } from './services/reference-data-cache/index.js';
 import { initServerRegistry } from './services/server-registry/index.js';
 import { brapiEdaStudy } from './mcp-server/prompts/definitions/brapi-eda-study.prompt.js';
 import { brapiMetaAnalysis } from './mcp-server/prompts/definitions/brapi-meta-analysis.prompt.js';
 import { brapiCallsResource } from './mcp-server/resources/definitions/brapi-calls.resource.js';
-import { brapiDatasetResource } from './mcp-server/resources/definitions/brapi-dataset.resource.js';
 import { brapiFiltersResource } from './mcp-server/resources/definitions/brapi-filters.resource.js';
 import { brapiGermplasmResource } from './mcp-server/resources/definitions/brapi-germplasm.resource.js';
 import { brapiServerInfoResource } from './mcp-server/resources/definitions/brapi-server-info.resource.js';
 import { brapiStudyResource } from './mcp-server/resources/definitions/brapi-study.resource.js';
-import { dataframeToolDefinitions, readOnlyToolDefinitions, writeToolDefinitions, } from './mcp-server/tools/definitions/index.js';
+import { dropToolDefinitions, exportToolDefinitions, readOnlyToolDefinitions, writeToolDefinitions, } from './mcp-server/tools/definitions/index.js';
 const serverConfig = getServerConfig();
 /**
- * Operator-facing metadata for the dataframe surface gate (BRAPI_CANVAS_ENABLED).
- * Surfaces in /.well-known/mcp.json and the HTML landing page so operators see
- * the gated tools with reason + hint. The framework's CANVAS_PROVIDER_TYPE
- * acts as a second runtime gate inside the bridge — when that's missing the
- * tools still register but throw `dataframe_disabled`.
+ * Operator-facing metadata for the dataframe-drop gate. Surfaces in
+ * /.well-known/mcp.json and the HTML landing page so operators see the
+ * gated tool with reason + hint.
  */
-const dataframeDisabled = {
-    reason: 'Dataframe surface is gated off (BRAPI_CANVAS_ENABLED=false).',
-    hint: 'Set BRAPI_CANVAS_ENABLED=true and CANVAS_PROVIDER_TYPE=duckdb to enable.',
+const dropDisabled = {
+    reason: 'Dataframe drop is gated off (BRAPI_CANVAS_DROP_ENABLED=false).',
+    hint: 'Set BRAPI_CANVAS_DROP_ENABLED=true to enable explicit drop. Dataframes also expire via TTL when left unmanaged.',
 };
 const writesDisabled = {
     reason: 'Writes are disabled (BRAPI_ENABLE_WRITES=false).',
     hint: 'Set BRAPI_ENABLE_WRITES=true to enable observation submission.',
 };
+/**
+ * Resolve the dataframe-export gate. Two reasons it can be off:
+ * (1) running under HTTP transport — file paths only make sense when the
+ *     server lives on the user's machine,
+ * (2) `BRAPI_EXPORT_DIR` unset — setting it is the opt-in (no separate
+ *     enable flag).
+ * Returns `null` when the tool should register, otherwise the operator
+ * metadata to wrap the disabled tool with.
+ */
+function resolveExportGate() {
+    const transportMode = process.env.MCP_TRANSPORT_TYPE ?? 'stdio';
+    if (transportMode !== 'stdio') {
+        return {
+            reason: 'Dataframe export requires stdio transport.',
+            hint: 'File paths must resolve on the same machine as the user — run the server with MCP_TRANSPORT_TYPE=stdio to enable.',
+        };
+    }
+    if (!serverConfig.exportDir) {
+        return {
+            reason: 'Dataframe export is unconfigured (BRAPI_EXPORT_DIR unset).',
+            hint: 'Set BRAPI_EXPORT_DIR to a writable directory on the server host to enable file export.',
+        };
+    }
+    return null;
+}
+const exportDisabled = resolveExportGate();
 const tools = [
     ...readOnlyToolDefinitions,
-    ...dataframeToolDefinitions.map((d) => serverConfig.canvasEnabled ? d : disabledTool(d, dataframeDisabled)),
+    ...dropToolDefinitions.map((d) => serverConfig.canvasDropEnabled ? d : disabledTool(d, dropDisabled)),
+    ...exportToolDefinitions.map((d) => (exportDisabled ? disabledTool(d, exportDisabled) : d)),
     ...writeToolDefinitions.map((d) => serverConfig.enableWrites ? d : disabledTool(d, writesDisabled)),
 ];
 await createApp({
@@ -54,17 +100,18 @@ await createApp({
         brapiCallsResource,
         brapiStudyResource,
         brapiGermplasmResource,
-        brapiDatasetResource,
         brapiFiltersResource,
     ],
     prompts: [brapiEdaStudy, brapiMetaAnalysis],
     setup(core) {
-        const canvasBridge = initCanvasBridge(core.canvas, serverConfig);
+        if (!core.canvas) {
+            throw configurationError('brapi-mcp-server requires the framework canvas service (DuckDB) for dataframe spillover. Set CANVAS_PROVIDER_TYPE=duckdb (the default) and ensure @duckdb/node-api is installed.', { canvasProviderType: process.env.CANVAS_PROVIDER_TYPE ?? 'duckdb' });
+        }
+        initCanvasBridge(core.canvas, serverConfig);
         initBrapiClient(serverConfig);
         initCapabilityRegistry(serverConfig);
         initBrapiDialectRegistry();
         initReferenceDataCache(serverConfig);
-        initDatasetStore(serverConfig, canvasBridge);
         initServerRegistry(serverConfig);
         initOntologyResolver();
     },

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,4DAA4D,CAAC;AAC3F,OAAO,EAAE,iBAAiB,EAAE,MAAM,gEAAgE,CAAC;AACnG,OAAO,EAAE,kBAAkB,EAAE,MAAM,4DAA4D,CAAC;AAChG,OAAO,EAAE,oBAAoB,EAAE,MAAM,8DAA8D,CAAC;AACpG,OAAO,EAAE,oBAAoB,EAAE,MAAM,8DAA8D,CAAC;AACpG,OAAO,EAAE,sBAAsB,EAAE,MAAM,gEAAgE,CAAC;AACxG,OAAO,EAAE,uBAAuB,EAAE,MAAM,kEAAkE,CAAC;AAC3G,OAAO,EAAE,kBAAkB,EAAE,MAAM,4DAA4D,CAAC;AAChG,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,yCAAyC,CAAC;AAEjD,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,iBAAiB,GAAG;IACxB,MAAM,EAAE,8DAA8D;IACtE,IAAI,EAAE,0EAA0E;CACjF,CAAC;AAEF,MAAM,cAAc,GAAG;IACrB,MAAM,EAAE,kDAAkD;IAC1D,IAAI,EAAE,gEAAgE;CACvE,CAAC;AAEF,MAAM,KAAK,GAAG;IACZ,GAAG,uBAAuB;IAC1B,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACpC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,EAAE,iBAAiB,CAAC,CACpE;IACD,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAChC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,EAAE,cAAc,CAAC,CAChE;CACF,CAAC;AAEF,MAAM,SAAS,CAAC;IACd,KAAK;IACL,SAAS,EAAE;QACT,uBAAuB;QACvB,kBAAkB;QAClB,kBAAkB;QAClB,sBAAsB;QACtB,oBAAoB;QACpB,oBAAoB;KACrB;IACD,OAAO,EAAE,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC3C,KAAK,CAAC,IAAI;QACR,MAAM,YAAY,GAAG,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACjE,eAAe,CAAC,YAAY,CAAC,CAAC;QAC9B,sBAAsB,CAAC,YAAY,CAAC,CAAC;QACrC,wBAAwB,EAAE,CAAC;QAC3B,sBAAsB,CAAC,YAAY,CAAC,CAAC;QACrC,gBAAgB,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QAC7C,kBAAkB,CAAC,YAAY,CAAC,CAAC;QACjC,oBAAoB,EAAE,CAAC;IACzB,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/prompts/definitions/brapi-eda-study.prompt.js

@@ -35,7 +35,7 @@ export const brapiEdaStudy = prompt('brapi_eda_study', {
             '3. Group variables by trait class and by scale data type — the breakdown drives which downstream checks make sense (numerical → outlier checks; categorical → distribution checks).',
             '',
             '## Step 3 — Observation coverage',
-            `1. Call \`brapi_find_observations\` with \`studies: ["${args.studyDbId}"]${aliasArg}\` and a \`loadLimit\` large enough to materialize the full study in one shot if \`observationCount\` from Step 1 fits, otherwise spill to a dataset and read it back via \`brapi_manage_dataset\` (mode: \`load\`).`,
+            `1. Call \`brapi_find_observations\` with \`studies: ["${args.studyDbId}"]${aliasArg}\` and a \`loadLimit\` large enough to materialize the full study in one shot if \`observationCount\` from Step 1 fits. Otherwise, the call spills to a dataframe — note the \`dataframe.tableName\` from the response, then describe + query it via \`brapi_dataframe_describe\` and \`brapi_dataframe_query\` (use SQL \`LIMIT/OFFSET\` to walk pages, projection to trim columns, aggregation for summaries).`,
             '2. From the response `distributions`, capture: observations per variable, observations per germplasm, observations per observation level (plot / plant / field), and observations per season.',
             '3. Compute coverage = `observationCount` ÷ (`observationUnitCount` × `variableCount`). Anything materially below 1.0 implies missing measurements.',
             '',

package/dist/mcp-server/prompts/definitions/brapi-eda-study.prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"brapi-eda-study.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/brapi-eda-study.prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,iBAAiB,EAAE;IACrD,WAAW,EACT,6JAA6J;IAC/J,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACb,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CAAC,6DAA6D,CAAC;QAC1E,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,KAAK,CAAC,kBAAkB,CAAC;aACzB,QAAQ,EAAE;aACV,QAAQ,CACP,oFAAoF,CACrF;KACJ,CAAC;IACF,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;QACjB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,GAAG;YACX,uEAAuE,IAAI,CAAC,SAAS,gOAAgO;YACrT,EAAE;YACF,oBAAoB;YACpB,kDAAkD,IAAI,CAAC,SAAS,IAAI,QAAQ,yJAAyJ;YACrO,yHAAyH;YACzH,EAAE;YACF,uBAAuB;YACvB,sDAAsD,IAAI,CAAC,SAAS,KAAK,QAAQ,mEAAmE;YACpJ,wIAAwI;YACxI,qLAAqL;YACrL,EAAE;YACF,kCAAkC;YAClC,yDAAyD,IAAI,CAAC,SAAS,KAAK,QAAQ,sNAAsN;YAC1S,+LAA+L;YAC/L,oJAAoJ;YACpJ,EAAE;YACF,0BAA0B;YAC1B,wLAAwL;YACxL,yGAAyG;YACzG,EAAE;YACF,iDAAiD;YACjD,+EAA+E;YAC/E,8EAA8E;YAC9E,6MAA6M;YAC7M,EAAE;YACF,yCAAyC;YACzC,uKAAuK,QAAQ,oCAAoC;YACnN,mEAAmE;YACnE,EAAE;YACF,WAAW;YACX,wDAAwD;YACxD,kGAAkG;YAClG,2EAA2E;YAC3E,iGAAiG;YACjG,4EAA4E;YAC5E,yFAAyF;YACzF,wEAAwE;YACxE,sJAAsJ;YACtJ,EAAE;YACF,6MAA6M;SAC9M,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,OAAO;YACL;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;aAChC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"brapi-eda-study.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/brapi-eda-study.prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,iBAAiB,EAAE;IACrD,WAAW,EACT,6JAA6J;IAC/J,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACb,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CAAC,6DAA6D,CAAC;QAC1E,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,KAAK,CAAC,kBAAkB,CAAC;aACzB,QAAQ,EAAE;aACV,QAAQ,CACP,oFAAoF,CACrF;KACJ,CAAC;IACF,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;QACjB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,GAAG;YACX,uEAAuE,IAAI,CAAC,SAAS,gOAAgO;YACrT,EAAE;YACF,oBAAoB;YACpB,kDAAkD,IAAI,CAAC,SAAS,IAAI,QAAQ,yJAAyJ;YACrO,yHAAyH;YACzH,EAAE;YACF,uBAAuB;YACvB,sDAAsD,IAAI,CAAC,SAAS,KAAK,QAAQ,mEAAmE;YACpJ,wIAAwI;YACxI,qLAAqL;YACrL,EAAE;YACF,kCAAkC;YAClC,yDAAyD,IAAI,CAAC,SAAS,KAAK,QAAQ,kZAAkZ;YACte,+LAA+L;YAC/L,oJAAoJ;YACpJ,EAAE;YACF,0BAA0B;YAC1B,wLAAwL;YACxL,yGAAyG;YACzG,EAAE;YACF,iDAAiD;YACjD,+EAA+E;YAC/E,8EAA8E;YAC9E,6MAA6M;YAC7M,EAAE;YACF,yCAAyC;YACzC,uKAAuK,QAAQ,oCAAoC;YACnN,mEAAmE;YACnE,EAAE;YACF,WAAW;YACX,wDAAwD;YACxD,kGAAkG;YAClG,2EAA2E;YAC3E,iGAAiG;YACjG,4EAA4E;YAC5E,yFAAyF;YACzF,wEAAwE;YACxE,sJAAsJ;YACtJ,EAAE;YACF,6MAA6M;SAC9M,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,OAAO;YACL;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;aAChC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/prompts/definitions/brapi-meta-analysis.prompt.js

@@ -41,9 +41,9 @@ export const brapiMetaAnalysis = prompt('brapi_meta_analysis', {
             '3. Record the resulting `observationVariableDbId[]` and the scale `dataType` and `scaleName` for each. Numeric scales can be averaged across studies; categorical scales need a mapping table before pooling.',
             '',
             '## Step 2 — Discover studies that measured the trait on the target germplasm',
-            `1. Call \`brapi_find_observations\` with \`germplasm: ${idsLiteral}\` and \`variables: [<resolved variable DbIds from Step 1>]\`${aliasArg}, \`loadLimit: 200\`.`,
+            `1. Call \`brapi_find_observations\` with \`germplasm: ${idsLiteral}\` and \`variables: [<resolved variable DbIds from Step 1>]\`${aliasArg}.`,
             '2. If the response warns that an unanchored observation query stalled, do not retry the same germplasm-only shape. Use study anchors when available: re-call `brapi_find_observations` with both `studies: ["<studyDbId>"]` and the target `germplasm` / `variables` filters, one candidate study at a time.',
-            '3. From `distributions.studyName`, capture the distinct studies returning observations. If `hasMore` is true and a `dataset` handle is returned, page through with `brapi_manage_dataset` (mode: `load`) to materialize the full set.',
+            '3. From `distributions.studyName`, capture the distinct studies returning observations. If `hasMore` is true and a `dataframe` handle is returned, work with the full set via `brapi_dataframe_query` — SQL `LIMIT/OFFSET` is the paging idiom; projection (`SELECT col1, col2`) and aggregation (`COUNT`, `GROUP BY`) summarize without materializing every row.',
             '4. For each study, call `brapi_get_study` to capture program, location, season, and trial context — these are the moderators in the meta-analysis.',
             '',
             '## Step 3 — Build the per-observation table',
@@ -97,7 +97,7 @@ export const brapiMetaAnalysis = prompt('brapi_meta_analysis', {
             '7. **Pedigree notes** — Step 7 if you ran it.',
             '8. **Caveats** — missing data rates, dropped observations, sample-size warnings, capability gaps from the server (e.g. ontology endpoint missing).',
             '',
-            'Reproducibility is non-negotiable: cite the dataset handle returned by every `find_*` call so a future run can reproduce the same upstream snapshot.',
+            'Reproducibility is non-negotiable: cite the dataframe handle (or the full filter map) returned by every `find_*` call so a future run can reproduce the same upstream snapshot.',
         ].join('\n');
         return [
             {

package/dist/mcp-server/prompts/definitions/brapi-meta-analysis.prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"brapi-meta-analysis.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/brapi-meta-analysis.prompt.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"brapi-meta-analysis.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/brapi-meta-analysis.prompt.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/brapi-dataframe-describe.tool.d.ts

@@ -1,14 +1,17 @@
 /**
  * @fileoverview `brapi_dataframe_describe` — list dataframes (or describe one)
- * with column schema, row count, and originating-dataset provenance.
- * Auto-registered dataset dataframes (`ds_<datasetId>`) carry full source
- * metadata (originating tool, baseUrl, query, expiry); user-derived dataframes
+ * with column schema, row count, and originating-source provenance.
+ * Auto-registered spillover dataframes (`df_<uuid>`) carry full provenance
+ * (originating tool, baseUrl, query, expiry); user-derived dataframes
  * created via `brapi_dataframe_query({ registerAs })` only show structural info.
  *
+ * Start here after a find_* tool spillover — the dataframe handle on the
+ * find result and `brapi_dataframe_describe` together orient you to schema +
+ * provenance before you write the first SQL query.
+ *
  * @module mcp-server/tools/definitions/brapi-dataframe-describe.tool
  */
 import { z } from '@cyanheads/mcp-ts-core';
-import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
 export declare const brapiDataframeDescribe: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
     dataframe: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
@@ -22,7 +25,6 @@ export declare const brapiDataframeDescribe: import("@cyanheads/mcp-ts-core").To
         }, z.core.$strip>>;
         approxSizeBytes: z.ZodOptional<z.ZodNumber>;
         provenance: z.ZodOptional<z.ZodObject<{
-            datasetId: z.ZodString;
             source: z.ZodString;
             baseUrl: z.ZodString;
             query: z.ZodUnknown;
@@ -30,10 +32,5 @@ export declare const brapiDataframeDescribe: import("@cyanheads/mcp-ts-core").To
             expiresAt: z.ZodString;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
-}, z.core.$strip>, readonly [{
-    readonly reason: "dataframe_disabled";
-    readonly code: JsonRpcErrorCode.ServiceUnavailable;
-    readonly when: "Dataframe surface is not enabled on this deployment";
-    readonly recovery: "Use brapi_manage_dataset (mode=list) to enumerate datasets directly — the dataframe surface is gated off here.";
-}]>;
+}, z.core.$strip>, undefined>;
 //# sourceMappingURL=brapi-dataframe-describe.tool.d.ts.map

package/dist/mcp-server/tools/definitions/brapi-dataframe-describe.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brapi-dataframe-describe.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/brapi-dataframe-describe.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAgDjE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCjC,CAAC"}
+{"version":3,"file":"brapi-dataframe-describe.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/brapi-dataframe-describe.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AA6CjD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;6BAgBjC,CAAC"}

package/dist/mcp-server/tools/definitions/brapi-dataframe-describe.tool.js

@@ -1,14 +1,17 @@
 /**
  * @fileoverview `brapi_dataframe_describe` — list dataframes (or describe one)
- * with column schema, row count, and originating-dataset provenance.
- * Auto-registered dataset dataframes (`ds_<datasetId>`) carry full source
- * metadata (originating tool, baseUrl, query, expiry); user-derived dataframes
+ * with column schema, row count, and originating-source provenance.
+ * Auto-registered spillover dataframes (`df_<uuid>`) carry full provenance
+ * (originating tool, baseUrl, query, expiry); user-derived dataframes
  * created via `brapi_dataframe_query({ registerAs })` only show structural info.
  *
+ * Start here after a find_* tool spillover — the dataframe handle on the
+ * find result and `brapi_dataframe_describe` together orient you to schema +
+ * provenance before you write the first SQL query.
+ *
  * @module mcp-server/tools/definitions/brapi-dataframe-describe.tool
  */
 import { tool, z } from '@cyanheads/mcp-ts-core';
-import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
 import { getCanvasBridge } from '../../../services/canvas-bridge/index.js';
 const ColumnSchema = z.object({
     name: z.string().describe('Column name.'),
@@ -16,14 +19,13 @@ const ColumnSchema = z.object({
     nullable: z.boolean().optional().describe('True when NULL values are allowed.'),
 });
 const ProvenanceSchema = z.object({
-    datasetId: z
+    source: z
         .string()
-        .describe('Originating dataset ID — pass to brapi_manage_dataset to operate on the underlying rows.'),
-    source: z.string().describe('Tool/operation that produced the dataset (e.g. find_observations).'),
-    baseUrl: z.string().describe('BrAPI base URL the dataset was pulled from.'),
+        .describe('Tool/operation that produced the dataframe (e.g. find_observations).'),
+    baseUrl: z.string().describe('BrAPI base URL the rows were pulled from.'),
     query: z.unknown().describe('Original filter map / search body.'),
-    createdAt: z.string().describe('ISO 8601 dataset creation time.'),
-    expiresAt: z.string().describe('ISO 8601 expiry — when the dataframe will be evicted.'),
+    createdAt: z.string().describe('ISO 8601 dataframe creation time.'),
+    expiresAt: z.string().describe('ISO 8601 expiry — when the dataframe metadata will be evicted.'),
 });
 const DescribedTableSchema = z.object({
     name: z.string().describe('Dataframe name. Use this in SQL queries.'),
@@ -32,7 +34,7 @@ const DescribedTableSchema = z.object({
         .array(ColumnSchema.describe('Column declaration.'))
         .describe('Schema in declaration order.'),
     approxSizeBytes: z.number().int().nonnegative().optional().describe('Approximate size in bytes.'),
-    provenance: ProvenanceSchema.optional().describe('Originating dataset provenance — present only for auto-registered dataframes (`ds_*`).'),
+    provenance: ProvenanceSchema.optional().describe('Originating-source provenance — present only for auto-registered dataframes (`df_*`).'),
 });
 const OutputSchema = z.object({
     tables: z
@@ -47,23 +49,12 @@ const InputSchema = z.object({
         .describe('When set, return only the named dataframe. Omit to list all dataframes.'),
 });
 export const brapiDataframeDescribe = tool('brapi_dataframe_describe', {
-    description: 'List dataframes (or describe one) with columns, row counts, and originating-dataset provenance. Use this to discover what dataframes are available before writing a brapi_dataframe_query.',
+    description: 'Start here after a spillover. Lists dataframes (or describes one) with columns, row counts, and originating-source provenance. The schema and provenance answer "what tool produced this and what filters were used" before you write the first brapi_dataframe_query.',
     annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
-    errors: [
-        {
-            reason: 'dataframe_disabled',
-            code: JsonRpcErrorCode.ServiceUnavailable,
-            when: 'Dataframe surface is not enabled on this deployment',
-            recovery: 'Use brapi_manage_dataset (mode=list) to enumerate datasets directly — the dataframe surface is gated off here.',
-        },
-    ],
     input: InputSchema,
     output: OutputSchema,
     async handler(input, ctx) {
         const bridge = getCanvasBridge();
-        if (!bridge.isEnabled()) {
-            throw ctx.fail('dataframe_disabled', 'brapi_dataframe_describe is unavailable — dataframes are not enabled on this deployment.', { ...ctx.recoveryFor('dataframe_disabled') });
-        }
         const describeOpts = {};
         if (input.dataframe !== undefined)
             describeOpts.tableName = input.dataframe;
@@ -77,7 +68,7 @@ function renderDescribe(tables) {
     lines.push(`# ${tables.length} dataframe(s)`);
     if (tables.length === 0) {
         lines.push('');
-        lines.push('_No dataframes. Run a find_* tool that spills to a dataset, or use brapi_dataframe_query with `registerAs` to materialize one._');
+        lines.push('_No dataframes. Run a find_* tool whose result exceeds loadLimit, or use brapi_dataframe_query with `registerAs` to materialize one._');
         return lines.join('\n');
     }
     for (const table of tables) {
@@ -94,7 +85,6 @@ function renderDescribe(tables) {
         }
         if (table.provenance) {
             lines.push('- provenance:');
-            lines.push(`  - datasetId: \`${table.provenance.datasetId}\``);
             lines.push(`  - source: ${table.provenance.source}`);
             lines.push(`  - baseUrl: ${table.provenance.baseUrl}`);
             lines.push(`  - createdAt: ${table.provenance.createdAt}`);

package/dist/mcp-server/tools/definitions/brapi-dataframe-describe.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"brapi-dataframe-describe.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/brapi-dataframe-describe.tool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"brapi-dataframe-describe.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/brapi-dataframe-describe.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/brapi-dataframe-drop.tool.d.ts

@@ -1,23 +1,19 @@
 /**
  * @fileoverview `brapi_dataframe_drop` — release a single dataframe by name.
  * Idempotent (returns `dropped: false` for unknown names rather than failing).
- * Drops the dataframe and any provenance metadata stored alongside it. The
- * originating dataset is unaffected — use `brapi_manage_dataset mode=delete`
- * to drop both.
+ * Drops the dataframe and its provenance metadata.
+ *
+ * Gated opt-in via `BRAPI_CANVAS_DROP_ENABLED` — when the operator hasn't
+ * opted in, the tool is omitted from `tools/list` entirely and dataframes
+ * expire via TTL when left unmanaged.
  *
  * @module mcp-server/tools/definitions/brapi-dataframe-drop.tool
  */
 import { z } from '@cyanheads/mcp-ts-core';
-import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
 export declare const brapiDataframeDrop: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
     dataframe: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
     dataframe: z.ZodString;
     dropped: z.ZodBoolean;
-}, z.core.$strip>, readonly [{
-    readonly reason: "dataframe_disabled";
-    readonly code: JsonRpcErrorCode.ServiceUnavailable;
-    readonly when: "Dataframe surface is not enabled on this deployment";
-    readonly recovery: "Use brapi_manage_dataset (mode=delete) to drop the underlying dataset — the dataframe surface is gated off here.";
-}]>;
+}, z.core.$strip>, undefined>;
 //# sourceMappingURL=brapi-dataframe-drop.tool.d.ts.map

package/dist/mcp-server/tools/definitions/brapi-dataframe-drop.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brapi-dataframe-drop.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/brapi-dataframe-drop.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAmBjE,eAAO,MAAM,kBAAkB;;;;;;;;;;GAqC7B,CAAC"}
+{"version":3,"file":"brapi-dataframe-drop.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/brapi-dataframe-drop.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAmBjD,eAAO,MAAM,kBAAkB;;;;;6BAqB7B,CAAC"}

package/dist/mcp-server/tools/definitions/brapi-dataframe-drop.tool.js

@@ -1,14 +1,15 @@
 /**
  * @fileoverview `brapi_dataframe_drop` — release a single dataframe by name.
  * Idempotent (returns `dropped: false` for unknown names rather than failing).
- * Drops the dataframe and any provenance metadata stored alongside it. The
- * originating dataset is unaffected — use `brapi_manage_dataset mode=delete`
- * to drop both.
+ * Drops the dataframe and its provenance metadata.
+ *
+ * Gated opt-in via `BRAPI_CANVAS_DROP_ENABLED` — when the operator hasn't
+ * opted in, the tool is omitted from `tools/list` entirely and dataframes
+ * expire via TTL when left unmanaged.
  *
  * @module mcp-server/tools/definitions/brapi-dataframe-drop.tool
  */
 import { tool, z } from '@cyanheads/mcp-ts-core';
-import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
 import { getCanvasBridge } from '../../../services/canvas-bridge/index.js';
 const InputSchema = z.object({
     dataframe: z
@@ -23,23 +24,12 @@ const OutputSchema = z.object({
         .describe('True when the dataframe existed and was removed; false when it did not exist.'),
 });
 export const brapiDataframeDrop = tool('brapi_dataframe_drop', {
-    description: 'Drop a dataframe by name. Idempotent — returns dropped:false rather than failing when the name is unknown. The underlying dataset is untouched (use brapi_manage_dataset mode=delete to drop both).',
+    description: 'Drop a dataframe by name. Idempotent — returns dropped:false rather than failing when the name is unknown. Dataframes also expire via TTL automatically; explicit drop is only needed when the operator wants to free workspace memory immediately.',
     annotations: { readOnlyHint: false, idempotentHint: true, openWorldHint: false },
-    errors: [
-        {
-            reason: 'dataframe_disabled',
-            code: JsonRpcErrorCode.ServiceUnavailable,
-            when: 'Dataframe surface is not enabled on this deployment',
-            recovery: 'Use brapi_manage_dataset (mode=delete) to drop the underlying dataset — the dataframe surface is gated off here.',
-        },
-    ],
     input: InputSchema,
     output: OutputSchema,
     async handler(input, ctx) {
         const bridge = getCanvasBridge();
-        if (!bridge.isEnabled()) {
-            throw ctx.fail('dataframe_disabled', 'brapi_dataframe_drop is unavailable — dataframes are not enabled on this deployment.', { ...ctx.recoveryFor('dataframe_disabled') });
-        }
         const dropped = await bridge.drop(ctx, input.dataframe);
         return { dataframe: input.dataframe, dropped };
     },

package/dist/mcp-server/tools/definitions/brapi-dataframe-drop.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"brapi-dataframe-drop.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/brapi-dataframe-drop.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEpE,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,+HAA+H,CAChI;CACJ,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;IACjF,OAAO,EAAE,CAAC;SACP,OAAO,EAAE;SACT,QAAQ,CAAC,+EAA+E,CAAC;CAC7F,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,sBAAsB,EAAE;IAC7D,WAAW,EACT,qMAAqM;IACvM,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;IAChF,MAAM,EAAE;QACN;YACE,MAAM,EAAE,oBAAoB;YAC5B,IAAI,EAAE,gBAAgB,CAAC,kBAAkB;YACzC,IAAI,EAAE,qDAAqD;YAC3D,QAAQ,EACN,kHAAkH;SACrH;KACO;IACV,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,YAAY;IAEpB,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC;YACxB,MAAM,GAAG,CAAC,IAAI,CACZ,oBAAoB,EACpB,sFAAsF,EACtF,EAAE,GAAG,GAAG,CAAC,WAAW,CAAC,oBAAoB,CAAC,EAAE,CAC7C,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACxD,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC;IACjD,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC;QAClB;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,MAAM,CAAC,OAAO;gBAClB,CAAC,CAAC,eAAe,MAAM,CAAC,SAAS,qBAAqB;gBACtD,CAAC,CAAC,eAAe,MAAM,CAAC,SAAS,gCAAgC;SACpE;KACF;CACF,CAAC,CAAC"}
+{"version":3,"file":"brapi-dataframe-drop.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/brapi-dataframe-drop.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEpE,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,+HAA+H,CAChI;CACJ,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;IACjF,OAAO,EAAE,CAAC;SACP,OAAO,EAAE;SACT,QAAQ,CAAC,+EAA+E,CAAC;CAC7F,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,sBAAsB,EAAE;IAC7D,WAAW,EACT,qPAAqP;IACvP,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;IAChF,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,YAAY;IAEpB,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACxD,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC;IACjD,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC;QAClB;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,MAAM,CAAC,OAAO;gBAClB,CAAC,CAAC,eAAe,MAAM,CAAC,SAAS,qBAAqB;gBACtD,CAAC,CAAC,eAAe,MAAM,CAAC,SAAS,gCAAgC;SACpE;KACF;CACF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/brapi-dataframe-export.tool.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @fileoverview `brapi_dataframe_export` — write a dataframe to disk in a
+ * researcher-friendly format (CSV, Parquet, JSON) and return the absolute
+ * path. Hands off the file to the human; the agent doesn't read it back.
+ *
+ * Stdio-only and gated behind `BRAPI_EXPORT_DIR` — the entry point bridges
+ * `BRAPI_EXPORT_DIR` → the framework's `CANVAS_EXPORT_PATH` so the canvas
+ * provider's path-traversal sandbox stays in charge of resolution. Under
+ * `MCP_TRANSPORT_TYPE=http` or with `BRAPI_EXPORT_DIR` unset, the tool is
+ * omitted from `tools/list` entirely (operators see the gate reason on
+ * `/.well-known/mcp.json`).
+ *
+ * Optional `columns` (thin projection) or `sql` (full SELECT) materialize a
+ * temporary canvas table first, export it, then drop it. The dataframe input
+ * always identifies the *source* dataframe — that's the name the paired-drop
+ * cleanup keys off of when `brapi_dataframe_drop` later removes it.
+ *
+ * @module mcp-server/tools/definitions/brapi-dataframe-export.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const brapiDataframeExport: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    dataframe: z.ZodString;
+    format: z.ZodEnum<{
+        csv: "csv";
+        parquet: "parquet";
+        json: "json";
+    }>;
+    filename: z.ZodOptional<z.ZodString>;
+    columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sql: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    dataframe: z.ZodString;
+    format: z.ZodEnum<{
+        csv: "csv";
+        parquet: "parquet";
+        json: "json";
+    }>;
+    path: z.ZodString;
+    filename: z.ZodString;
+    sizeBytes: z.ZodNumber;
+    rowCount: z.ZodNumber;
+    columns: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+    }, z.core.$strip>>;
+    expiresAt: z.ZodString;
+}, z.core.$strip>, readonly [{
+    readonly reason: "export_dir_unset";
+    readonly code: JsonRpcErrorCode.ConfigurationError;
+    readonly when: "BRAPI_EXPORT_DIR is not configured (defensive — the registration gate normally hides the tool when this happens)";
+    readonly recovery: "Set BRAPI_EXPORT_DIR on the server before retrying.";
+}, {
+    readonly reason: "dataframe_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No dataframe with this name exists on the canvas (expired, dropped, or typo)";
+    readonly recovery: "Call brapi_dataframe_describe to list available dataframes.";
+}, {
+    readonly reason: "invalid_filename";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "filename contains path separators or traversal segments";
+    readonly recovery: "Provide a filename without \"/\", \"\\\", or \"..\" — leave it unset to use the default.";
+}, {
+    readonly reason: "mutually_exclusive_projection";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "Both `columns` and `sql` were supplied";
+    readonly recovery: "Pass either `columns` for a thin projection or `sql` for filtering/aggregation, not both.";
+}]>;
+//# sourceMappingURL=brapi-dataframe-export.tool.d.ts.map

package/dist/mcp-server/tools/definitions/brapi-dataframe-export.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brapi-dataframe-export.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/brapi-dataframe-export.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAAsB,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAoEjE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkH/B,CAAC"}