@cyanheads/eurostat-mcp-server 0.3.0 → 0.4.0

package/CLAUDE.md

@@ -1,7 +1,7 @@
 # Agent Protocol
 
 **Server:** @cyanheads/eurostat-mcp-server
-**Version:** 0.3.0
+**Version:** 0.4.0
 **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.11.1`
 **Engines:** Bun ≥1.3.0, Node ≥24.0.0
 **Zod:** `^4.4.3`

package/Dockerfile

@@ -47,7 +47,10 @@ LABEL org.opencontainers.image.source="https://github.com/cyanheads/eurostat-mcp
 COPY package.json bun.lock ./
 
 # Install only production dependencies, ignoring any lifecycle scripts (like 'prepare')
-# that are not needed in the final production image.
+# that are not needed in the final production image. This installs every direct
+# runtime dependency, including the @duckdb/node-api binding that backs DataCanvas —
+# the canvas is gated at runtime by CANVAS_PROVIDER_TYPE, not at build time, so the
+# image always carries the binding and a deployment turns the feature on with an env var.
 RUN --mount=type=cache,target=/root/.bun/install/cache \
     bun install --production --frozen-lockfile --ignore-scripts
 
@@ -75,8 +78,16 @@ COPY --from=build /usr/src/app/dist ./dist
 # The 'oven/bun' image already provides a non-root user named 'bun'.
 # We will use this existing user for enhanced security.
 
-# Create and set permissions for the log directory, assigning ownership to the 'bun' user.
-RUN mkdir -p /var/log/eurostat-mcp-server && chown -R bun:bun /var/log/eurostat-mcp-server
+# Create and set permissions for the log and canvas directories, assigning ownership
+# to the 'bun' user. DuckDB writes spill files under CANVAS_TEMP_PATH and the framework
+# sandboxes path exports to CANVAS_EXPORT_PATH. The export root is the one that breaks
+# by default: it resolves under the working directory /usr/src/app, which this non-root
+# user does not own. Both are pointed at owned directories below so neither depends on
+# the image's writable-by-accident paths.
+RUN mkdir -p /var/log/eurostat-mcp-server \
+             /var/lib/eurostat-mcp-server/canvas-tmp \
+             /var/lib/eurostat-mcp-server/canvas-exports \
+    && chown -R bun:bun /var/log/eurostat-mcp-server /var/lib/eurostat-mcp-server
 
 # Switch to the non-root user
 USER bun
@@ -94,6 +105,8 @@ ENV MCP_SESSION_MODE="stateless"
 ENV MCP_LOG_LEVEL="info"
 ENV LOGS_DIR="/var/log/eurostat-mcp-server"
 ENV MCP_FORCE_CONSOLE_LOGGING="true"
+ENV CANVAS_TEMP_PATH="/var/lib/eurostat-mcp-server/canvas-tmp"
+ENV CANVAS_EXPORT_PATH="/var/lib/eurostat-mcp-server/canvas-exports"
 
 # Expose the port the server listens on
 EXPOSE ${MCP_HTTP_PORT}

package/README.md

@@ -1,7 +1,7 @@
 <div align="center">
   <h1>@cyanheads/eurostat-mcp-server</h1>
   <p><b>Search and query the Eurostat catalogue — EU economy, demography, trade, health, and NUTS regional data via MCP. STDIO or Streamable HTTP.</b>
-  <div>5 Tools • 1 Resource</div>
+  <div>5 Tools (7 with the dataframe canvas) • 1 Resource</div>
   </p>
 </div>
 
@@ -9,7 +9,7 @@
 
 
 
-[![Version](https://img.shields.io/badge/Version-0.3.0-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/eurostat-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.30.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/eurostat-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/eurostat-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^7.0.2-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3.14-blueviolet.svg?style=flat-square)](https://bun.sh/)
+[![Version](https://img.shields.io/badge/Version-0.4.0-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/eurostat-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.30.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/eurostat-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/eurostat-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^7.0.2-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3.14-blueviolet.svg?style=flat-square)](https://bun.sh/)
 
 </div>
 
@@ -31,7 +31,7 @@
 
 ## Tools
 
-5 tools for discovering and querying Eurostat statistical datasets:
+5 tools for discovering and querying Eurostat statistical datasets, plus 2 more when the optional dataframe canvas is enabled:
 
 | Tool | Description |
 |:---|:---|
@@ -40,6 +40,8 @@
 | `eurostat_get_dataset_info` | Fetch metadata for a dataset: dimensions with sample values, time range, observation count, and last-update date |
 | `eurostat_get_dimension_values` | List all valid codes for a specific dimension (e.g., all geo codes, all unit codes); supports NUTS hierarchy filtering |
 | `eurostat_query_dataset` | Fetch decoded statistical observations with dimension filters, NUTS geo-level, and time-range controls |
+| `eurostat_dataframe_describe` | List the tables staged on a dataframe canvas with their row counts and column types — canvas only |
+| `eurostat_dataframe_query` | Run a read-only SQL SELECT across staged tables — canvas only |
 
 ### `eurostat_search_datasets`
 
@@ -99,9 +101,22 @@ Fetch statistical data from a Eurostat dataset.
 - Time range via `since_period`/`until_period` (e.g., `"2020"`, `"2023-Q1"`) or `last_n_periods` for the N most recent
 - Returns decoded observations with dimension codes and labels, numeric values, and status flags (`p` = provisional, `e` = estimated, etc.)
 - Reports total observation count, missing value count, and the effective time range of the result, each period bound omitted when neither the observations nor Eurostat report it
-- Returned rows are capped at 5,000, applied while decoding so a broad query never builds the rest; `obsCount`, `missingObsCount` and `timeRange` still describe the whole match, and `truncated` flags when rows were dropped. Filter the query to shrink what Eurostat sends — the cap bounds the decode, not the transfer
+- Inline rows are capped at 5,000, applied while decoding so a broad query never builds the rest; `obsCount`, `missingObsCount` and `timeRange` still describe the whole match, and `truncated` flags when the cap bit. Filter the query to shrink what Eurostat sends — the cap bounds the decode, not the transfer
+- With the dataframe canvas enabled, a match past the cap is also staged whole as a SQL table and the response returns `canvasId` / `tableName` / `stagedRowCount`; the rows are streamed into the table one at a time from the response body already in memory, so nothing extra is fetched and the match is never materialized as an array. Without a canvas those fields are absent and narrowing the query is the way to the rest
+- Pass `canvas_id` from an earlier response to stage several results side by side and join across them
 - Async-response detection — large unfiltered queries return an actionable, non-retryable error with filter guidance rather than silently timing out
 
+---
+
+### `eurostat_dataframe_describe` / `eurostat_dataframe_query`
+
+SQL over the results `eurostat_query_dataset` stages. **Listed only when the dataframe canvas is enabled** (`CANVAS_PROVIDER_TYPE=duckdb`); the server is fully functional without it, and clients never see tools they cannot call.
+
+- `eurostat_dataframe_describe` lists the staged tables with row counts and column names and types — call it before writing SQL
+- `eurostat_dataframe_query` runs a single read-only `SELECT`. Statement chaining, non-`SELECT` verbs, and functions that read files or external data are rejected with a typed error
+- Staged columns are flat: each dimension contributes a code column named after the dimension (`geo`) and a label column beside it (`geo_label`), followed by `obs_value`, `obs_flag`, and `obs_flag_label`
+- The DuckDB binding ships with the server, so `CANVAS_PROVIDER_TYPE=duckdb` is the only switch. The exception is the one-click `.mcpb` bundle, which strips platform-specific native bindings to stay portable — a bundle install cannot run the canvas, so reach for the npm, Docker, or from-source install for SQL analytics
+
 ## Resource
 
 | Type | Name | Description |
@@ -126,6 +141,7 @@ Eurostat-specific:
 - Async-response detection — Eurostat returns a warning object rather than an error for over-limit queries; the server intercepts it and returns an actionable error with filter guidance
 - NUTS hierarchy geo-level filtering across query and dimension-value tools
 - Status flag decoding (provisional, estimated, definition differs, etc.)
+- Optional DuckDB dataframe canvas — a query matching more than the inline cap is streamed row by row into a SQL table, reaching the observations the cap drops without a second request to Eurostat
 
 Agent-friendly output:
 
@@ -251,6 +267,10 @@ All configuration is validated at startup via Zod schemas in `src/config/server-
 | `EUROSTAT_BASE_URL` | Eurostat API base URL | `https://ec.europa.eu/eurostat/api/dissemination` |
 | `EUROSTAT_REQUEST_TIMEOUT_MS` | HTTP request timeout in ms | `30000` |
 | `EUROSTAT_TOC_CACHE_TTL_MS` | Catalogue TOC cache lifetime in ms — the first search or browse call past this age refreshes it | `43200000` (12 hours) |
+| `CANVAS_PROVIDER_TYPE` | `duckdb` enables the dataframe canvas: lists the two dataframe tools and lets `eurostat_query_dataset` stage a match past its inline cap | `none` |
+| `CANVAS_TEMP_PATH` | Directory DuckDB writes canvas spill files to. Must be writable by the server process | `<os tmpdir>/mcp-canvas` |
+| `CANVAS_TTL_MS` | Sliding lifetime of a staged canvas in ms; every call against it extends the window | `86400000` (24 hours) |
+| `CANVAS_DEFAULT_ROW_LIMIT` | Max rows one `eurostat_dataframe_query` returns before reporting `truncated` | `10000` |
 | `OTEL_ENABLED` | Enable OpenTelemetry | `false` |
 
 ## Running the server
@@ -279,10 +299,11 @@ All configuration is validated at startup via Zod schemas in `src/config/server-
 
 | Directory | Purpose |
 |:---|:---|
-| `src/mcp-server/tools` | Tool definitions (`*.tool.ts`). Five tools for discovery and data access. |
+| `src/mcp-server/tools` | Tool definitions (`*.tool.ts`). Five tools for discovery and data access, plus two canvas-gated dataframe tools. |
 | `src/mcp-server/resources` | Resource definitions. Dataset metadata resource. |
 | `src/services/eurostat-catalogue` | Catalogue service — fetches and parses the Eurostat TOC TXT file; TTL-bounded in-memory cache. |
-| `src/services/eurostat-data` | Data service — Statistics API HTTP client, JSON-stat 2.0 decoder, async-response detection. |
+| `src/services/eurostat-data` | Data service — Statistics API HTTP client, JSON-stat 2.0 decoder, async-response detection, dataframe row source. |
+| `src/services/canvas-accessor.ts` | Module-level accessor for the optional DataCanvas, plus the acquire helper that names the misconfigured path on a permission failure. |
 | `src/config` | Server-specific environment variable parsing and validation with Zod. |
 | `tests/` | Unit and integration tests, mirroring the `src/` structure. |
 

package/dist/index.js

@@ -3,15 +3,32 @@
  * @fileoverview eurostat-mcp-server MCP server entry point.
  * @module index
  */
-import { createApp } from '@cyanheads/mcp-ts-core';
+import { createApp, disabledTool } from '@cyanheads/mcp-ts-core';
+import { config } from '@cyanheads/mcp-ts-core/config';
 import { eurostatDatasetResource } from './mcp-server/resources/definitions/eurostat-dataset.resource.js';
 import { eurostatBrowseThemes } from './mcp-server/tools/definitions/eurostat-browse-themes.tool.js';
+import { eurostatDataframeDescribe } from './mcp-server/tools/definitions/eurostat-dataframe-describe.tool.js';
+import { eurostatDataframeQuery } from './mcp-server/tools/definitions/eurostat-dataframe-query.tool.js';
 import { eurostatGetDatasetInfo } from './mcp-server/tools/definitions/eurostat-get-dataset-info.tool.js';
 import { eurostatGetDimensionValues } from './mcp-server/tools/definitions/eurostat-get-dimension-values.tool.js';
 import { eurostatQueryDataset } from './mcp-server/tools/definitions/eurostat-query-dataset.tool.js';
 import { eurostatSearchDatasets } from './mcp-server/tools/definitions/eurostat-search-datasets.tool.js';
+import { setCanvas } from './services/canvas-accessor.js';
 import { initEurostatCatalogueService } from './services/eurostat-catalogue/eurostat-catalogue-service.js';
 import { initEurostatDataService } from './services/eurostat-data/eurostat-data-service.js';
+/**
+ * The dataframe tools address tables on a canvas, so without one they have
+ * nothing to talk to. `disabledTool` keeps them off `tools/list` — clients
+ * cannot call them — while leaving them visible on the landing page and the
+ * server card with the variable that turns them on, so an operator can see the
+ * capability exists rather than wondering why the README documents a tool the
+ * server does not advertise.
+ */
+const canvasEnabled = config.canvas.providerType !== 'none';
+const CANVAS_OFF = {
+    reason: 'This deployment runs without a dataframe canvas, so there are no tables to address.',
+    hint: 'CANVAS_PROVIDER_TYPE=duckdb',
+};
 await createApp({
     name: 'eurostat-mcp-server',
     title: 'eurostat-mcp-server',
@@ -21,16 +38,20 @@ await createApp({
         eurostatGetDatasetInfo,
         eurostatGetDimensionValues,
         eurostatQueryDataset,
+        canvasEnabled ? eurostatDataframeDescribe : disabledTool(eurostatDataframeDescribe, CANVAS_OFF),
+        canvasEnabled ? eurostatDataframeQuery : disabledTool(eurostatDataframeQuery, CANVAS_OFF),
     ],
     resources: [eurostatDatasetResource],
     prompts: [],
     instructions: `Eurostat MCP server — EU statistical data across the Eurostat catalogue.
 Workflow: eurostat_search_datasets or eurostat_browse_themes to find a dataset code → eurostat_get_dataset_info to see dimensions → eurostat_get_dimension_values to list valid filter values → eurostat_query_dataset to fetch observations.
-Apply dimension filters to avoid async response errors on large datasets.`,
+Apply dimension filters to keep queries small: an unfiltered query on a large dataset is slow and can return an async response error instead of data.
+eurostat_query_dataset returns at most 5,000 observations inline. When the match is larger and this deployment runs a dataframe canvas, the whole match is also staged as a SQL table named in the response — read it with eurostat_dataframe_query (eurostat_dataframe_describe lists the table and column names). The dataframe tools are not listed when the canvas is off; there, narrowing the filters is what brings the rest of a capped match into reach.`,
     landing: { requireAuth: false },
     setup(core) {
         initEurostatCatalogueService(core.config, core.storage);
         initEurostatDataService(core.config, core.storage);
+        setCanvas(core.canvas);
     },
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,EAAE,oBAAoB,EAAE,MAAM,+DAA+D,CAAC;AACrG,OAAO,EAAE,sBAAsB,EAAE,MAAM,kEAAkE,CAAC;AAC1G,OAAO,EAAE,0BAA0B,EAAE,MAAM,sEAAsE,CAAC;AAClH,OAAO,EAAE,oBAAoB,EAAE,MAAM,+DAA+D,CAAC;AACrG,OAAO,EAAE,sBAAsB,EAAE,MAAM,iEAAiE,CAAC;AACzG,OAAO,EAAE,4BAA4B,EAAE,MAAM,6DAA6D,CAAC;AAC3G,OAAO,EAAE,uBAAuB,EAAE,MAAM,mDAAmD,CAAC;AAE5F,MAAM,SAAS,CAAC;IACd,IAAI,EAAE,qBAAqB;IAC3B,KAAK,EAAE,qBAAqB;IAC5B,KAAK,EAAE;QACL,sBAAsB;QACtB,oBAAoB;QACpB,sBAAsB;QACtB,0BAA0B;QAC1B,oBAAoB;KACrB;IACD,SAAS,EAAE,CAAC,uBAAuB,CAAC;IACpC,OAAO,EAAE,EAAE;IACX,YAAY,EAAE;;0EAE0D;IACxE,OAAO,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE;IAC/B,KAAK,CAAC,IAAI;QACR,4BAA4B,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACxD,uBAAuB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,EAAE,oBAAoB,EAAE,MAAM,+DAA+D,CAAC;AACrG,OAAO,EAAE,yBAAyB,EAAE,MAAM,oEAAoE,CAAC;AAC/G,OAAO,EAAE,sBAAsB,EAAE,MAAM,iEAAiE,CAAC;AACzG,OAAO,EAAE,sBAAsB,EAAE,MAAM,kEAAkE,CAAC;AAC1G,OAAO,EAAE,0BAA0B,EAAE,MAAM,sEAAsE,CAAC;AAClH,OAAO,EAAE,oBAAoB,EAAE,MAAM,+DAA+D,CAAC;AACrG,OAAO,EAAE,sBAAsB,EAAE,MAAM,iEAAiE,CAAC;AACzG,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,4BAA4B,EAAE,MAAM,6DAA6D,CAAC;AAC3G,OAAO,EAAE,uBAAuB,EAAE,MAAM,mDAAmD,CAAC;AAE5F;;;;;;;GAOG;AACH,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,KAAK,MAAM,CAAC;AAC5D,MAAM,UAAU,GAAG;IACjB,MAAM,EAAE,qFAAqF;IAC7F,IAAI,EAAE,6BAA6B;CAC3B,CAAC;AAEX,MAAM,SAAS,CAAC;IACd,IAAI,EAAE,qBAAqB;IAC3B,KAAK,EAAE,qBAAqB;IAC5B,KAAK,EAAE;QACL,sBAAsB;QACtB,oBAAoB;QACpB,sBAAsB;QACtB,0BAA0B;QAC1B,oBAAoB;QACpB,aAAa,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,YAAY,CAAC,yBAAyB,EAAE,UAAU,CAAC;QAC/F,aAAa,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,YAAY,CAAC,sBAAsB,EAAE,UAAU,CAAC;KAC1F;IACD,SAAS,EAAE,CAAC,uBAAuB,CAAC;IACpC,OAAO,EAAE,EAAE;IACX,YAAY,EAAE;;;kcAGkb;IAChc,OAAO,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE;IAC/B,KAAK,CAAC,IAAI;QACR,4BAA4B,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACxD,uBAAuB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACnD,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,40 @@
+/**
+ * @fileoverview Tool for listing the tables staged on a Eurostat DataCanvas.
+ * @module mcp-server/tools/definitions/eurostat-dataframe-describe.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const eurostatDataframeDescribe: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    canvas_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    canvasId: z.ZodString;
+    expiresAt: z.ZodString;
+    tables: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodEnum<{
+            table: "table";
+            view: "view";
+        }>;
+        rowCount: z.ZodNumber;
+        expiresAt: z.ZodOptional<z.ZodString>;
+        columns: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+            nullable: z.ZodBoolean;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "canvas_disabled";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "This deployment runs without a dataframe canvas, so there is nothing to describe.";
+    readonly retryable: false;
+    readonly recovery: "Query the data inline with eurostat_query_dataset, narrowing dimension filters until the result fits.";
+}, {
+    readonly reason: "canvas_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The canvas_id is unknown or its lifetime has elapsed.";
+    readonly recovery: "Re-run eurostat_query_dataset to stage the data again and use the canvasId it returns.";
+}], {
+    readonly notice: z.ZodOptional<z.ZodString>;
+}>;
+//# sourceMappingURL=eurostat-dataframe-describe.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"eurostat-dataframe-describe.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/eurostat-dataframe-describe.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgIpC,CAAC"}

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

@@ -0,0 +1,113 @@
+/**
+ * @fileoverview Tool for listing the tables staged on a Eurostat DataCanvas.
+ * @module mcp-server/tools/definitions/eurostat-dataframe-describe.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { acquireCanvas, getCanvas } from '../../../services/canvas-accessor.js';
+export const eurostatDataframeDescribe = tool('eurostat_dataframe_describe', {
+    title: 'Describe Eurostat Dataframes',
+    description: 'List the tables staged on a Eurostat dataframe canvas, with their row counts and column names and types. Call this before eurostat_dataframe_query to learn the table and column names to write SQL against. The canvas_id comes from a eurostat_query_dataset response that reported a staged table. Every observation column is flat: each dimension contributes a code column named after the dimension (e.g. "geo") and a label column beside it (e.g. "geo_label"), alongside obs_value, obs_flag, and obs_flag_label.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    input: z.object({
+        canvas_id: z
+            .string()
+            .min(1)
+            .describe('Canvas identifier returned by eurostat_query_dataset as canvasId. Identifies the workspace holding the staged tables.'),
+    }),
+    output: z.object({
+        canvasId: z.string().describe('Canvas identifier the tables were read from.'),
+        expiresAt: z
+            .string()
+            .describe('ISO 8601 timestamp when the canvas expires. Every call on it slides this forward.'),
+        tables: z
+            .array(z
+            .object({
+            name: z.string().describe('Table name to reference in SQL.'),
+            kind: z
+                .enum(['table', 'view'])
+                .describe('Whether the entry is a base table or a view.'),
+            rowCount: z.number().describe('Rows the table holds.'),
+            expiresAt: z
+                .string()
+                .optional()
+                .describe('ISO 8601 expiry of this table specifically. Omitted when the table ages with the canvas rather than on its own clock.'),
+            columns: z
+                .array(z
+                .object({
+                name: z.string().describe('Column name.'),
+                type: z.string().describe('SQL column type (e.g. "VARCHAR", "DOUBLE").'),
+                nullable: z.boolean().describe('Whether the column admits NULL.'),
+            })
+                .describe('One column of the table.'))
+                .describe('Columns in declaration order.'),
+        })
+            .describe('One table or view staged on the canvas.'))
+            .describe('Tables staged on this canvas. Empty when nothing has been staged yet, or when every staged table has expired.'),
+    }),
+    enrichment: {
+        notice: z
+            .string()
+            .optional()
+            .describe('Guidance when the canvas holds no tables. Omitted when it holds at least one.'),
+    },
+    errors: [
+        {
+            reason: 'canvas_disabled',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'This deployment runs without a dataframe canvas, so there is nothing to describe.',
+            retryable: false,
+            recovery: 'Query the data inline with eurostat_query_dataset, narrowing dimension filters until the result fits.',
+        },
+        {
+            reason: 'canvas_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The canvas_id is unknown or its lifetime has elapsed.',
+            recovery: 'Re-run eurostat_query_dataset to stage the data again and use the canvasId it returns.',
+        },
+    ],
+    async handler(input, ctx) {
+        const canvas = getCanvas();
+        if (!canvas) {
+            throw ctx.fail('canvas_disabled', undefined, ctx.recoveryFor('canvas_disabled'));
+        }
+        const instance = await acquireCanvas(canvas, input.canvas_id, ctx);
+        const tables = await instance.describe();
+        ctx.log.info('Described canvas', { canvasId: instance.canvasId, tableCount: tables.length });
+        if (tables.length === 0) {
+            ctx.enrich.notice(`Canvas ${instance.canvasId} holds no tables. Staged tables expire on their own schedule — re-run eurostat_query_dataset to stage the data again.`);
+        }
+        return {
+            canvasId: instance.canvasId,
+            expiresAt: instance.expiresAt,
+            tables: tables.map((t) => ({
+                name: t.name,
+                kind: t.kind,
+                rowCount: t.rowCount,
+                ...(t.expiresAt !== undefined && { expiresAt: t.expiresAt }),
+                columns: t.columns.map((c) => ({
+                    name: c.name,
+                    type: c.type,
+                    nullable: c.nullable ?? true,
+                })),
+            })),
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `# Canvas \`${result.canvasId}\``,
+            `**Expires:** ${result.expiresAt} | **Tables:** ${result.tables.length}\n`,
+        ];
+        for (const table of result.tables) {
+            const expiry = table.expiresAt === undefined ? '' : ` | **expiresAt:** ${table.expiresAt}`;
+            lines.push(`## \`${table.name}\` (${table.kind})`);
+            lines.push(`**Rows:** ${table.rowCount}${expiry}`);
+            for (const col of table.columns) {
+                lines.push(`- \`${col.name}\` ${col.type} (nullable: ${col.nullable})`);
+            }
+            lines.push('');
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=eurostat-dataframe-describe.tool.js.map

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

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

package/dist/mcp-server/tools/definitions/eurostat-dataframe-query.tool.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview Tool for running read-only SQL against tables staged on a
+ * Eurostat DataCanvas.
+ * @module mcp-server/tools/definitions/eurostat-dataframe-query.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const eurostatDataframeQuery: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    canvas_id: z.ZodString;
+    sql: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    canvasId: z.ZodString;
+    columns: z.ZodArray<z.ZodString>;
+    rows: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    rowCount: z.ZodNumber;
+    truncated: z.ZodBoolean;
+}, z.core.$strip>, readonly [{
+    readonly reason: "canvas_disabled";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "This deployment runs without a dataframe canvas, so there is nothing to query.";
+    readonly retryable: false;
+    readonly recovery: "Query the data inline with eurostat_query_dataset, narrowing dimension filters until the result fits.";
+}, {
+    readonly reason: "canvas_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The canvas_id is unknown or its lifetime has elapsed.";
+    readonly recovery: "Re-run eurostat_query_dataset to stage the data again and use the canvasId it returns.";
+}, {
+    readonly reason: "missing_table";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The SQL names a table that is not staged on this canvas, or that has expired.";
+    readonly recovery: "Call eurostat_dataframe_describe for the staged table names, or re-run eurostat_query_dataset to stage them again.";
+}], undefined>;
+//# sourceMappingURL=eurostat-dataframe-query.tool.d.ts.map

package/dist/mcp-server/tools/definitions/eurostat-dataframe-query.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eurostat-dataframe-query.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/eurostat-dataframe-query.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;cAiHjC,CAAC"}

package/dist/mcp-server/tools/definitions/eurostat-dataframe-query.tool.js

@@ -0,0 +1,98 @@
+/**
+ * @fileoverview Tool for running read-only SQL against tables staged on a
+ * Eurostat DataCanvas.
+ * @module mcp-server/tools/definitions/eurostat-dataframe-query.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { acquireCanvas, getCanvas } from '../../../services/canvas-accessor.js';
+export const eurostatDataframeQuery = tool('eurostat_dataframe_query', {
+    title: 'Query Eurostat Dataframes',
+    description: 'Run a read-only SQL SELECT against tables staged on a Eurostat dataframe canvas — the way to reach observations past the 5,000-row inline cap of eurostat_query_dataset, and to aggregate, group, or join across staged tables without re-fetching from Eurostat. Call eurostat_dataframe_describe first for the table and column names. Only a single SELECT statement runs: statement chaining, non-SELECT verbs, and functions that read files or external data are rejected. Columns are flat — each dimension appears as a code column named after the dimension plus a "_label" companion, with the measure in obs_value and the status flag in obs_flag / obs_flag_label.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    input: z.object({
+        canvas_id: z
+            .string()
+            .min(1)
+            .describe('Canvas identifier returned by eurostat_query_dataset as canvasId. Identifies the workspace holding the staged tables.'),
+        sql: z
+            .string()
+            .min(1)
+            .describe("A single read-only SELECT statement. Reference tables by the names eurostat_dataframe_describe reports. Example: SELECT geo, geo_label, AVG(obs_value) AS mean FROM df_a1b2c3d4 WHERE time >= '2020' GROUP BY geo, geo_label ORDER BY mean DESC."),
+    }),
+    output: z.object({
+        canvasId: z.string().describe('Canvas identifier the query ran against.'),
+        columns: z.array(z.string()).describe('Column names in projection order.'),
+        rows: z
+            .array(z.record(z.string(), z.unknown()))
+            .describe('Result rows, each keyed by column name. Bounded by the canvas row limit. 64-bit integer results — COUNT(*) among them — arrive as strings so values outside the JSON number range survive intact; cast to DOUBLE in the SQL if a number is wanted.'),
+        rowCount: z
+            .number()
+            .describe('Rows materialized into this response. Equals the full result size unless truncated is true.'),
+        truncated: z
+            .boolean()
+            .describe('True when the result exceeded the canvas row limit and was cut short. Add a LIMIT, an aggregate, or a narrower WHERE clause to see the rest.'),
+    }),
+    errors: [
+        {
+            reason: 'canvas_disabled',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'This deployment runs without a dataframe canvas, so there is nothing to query.',
+            retryable: false,
+            recovery: 'Query the data inline with eurostat_query_dataset, narrowing dimension filters until the result fits.',
+        },
+        {
+            reason: 'canvas_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The canvas_id is unknown or its lifetime has elapsed.',
+            recovery: 'Re-run eurostat_query_dataset to stage the data again and use the canvasId it returns.',
+        },
+        {
+            reason: 'missing_table',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The SQL names a table that is not staged on this canvas, or that has expired.',
+            recovery: 'Call eurostat_dataframe_describe for the staged table names, or re-run eurostat_query_dataset to stage them again.',
+        },
+    ],
+    async handler(input, ctx) {
+        const canvas = getCanvas();
+        if (!canvas) {
+            throw ctx.fail('canvas_disabled', undefined, ctx.recoveryFor('canvas_disabled'));
+        }
+        const instance = await acquireCanvas(canvas, input.canvas_id, ctx);
+        /**
+         * The SQL is not sanitized here on purpose. The canvas gate rejects
+         * anything that is not a single SELECT — statement count, statement type,
+         * an EXPLAIN-plan operator allowlist, and a table-function deny-list — and
+         * a rejection there is a typed ValidationError carrying the reason. A
+         * second, weaker string filter in front of it would only shadow those
+         * reasons with a vaguer message.
+         */
+        const result = await instance.query(input.sql, { signal: ctx.signal });
+        ctx.log.info('Canvas query complete', {
+            canvasId: instance.canvasId,
+            rowCount: result.rowCount,
+            truncated: result.truncated === true,
+        });
+        return {
+            canvasId: instance.canvasId,
+            columns: result.columns,
+            rows: result.rows,
+            rowCount: result.rowCount,
+            truncated: result.truncated === true,
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `# Query result (canvas \`${result.canvasId}\`)`,
+            `**Rows:** ${result.rowCount} | **Truncated:** ${result.truncated}${result.truncated ? ' — add a LIMIT, an aggregate, or a narrower WHERE clause' : ''}`,
+            `**Columns:** ${result.columns.join(', ')}\n`,
+        ];
+        // Every row renders, so content[] carries the same set structuredContent does.
+        for (const row of result.rows) {
+            lines.push(result.columns.map((col) => `${col}=${row[col] === null ? 'NULL' : row[col]}`).join(' | '));
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=eurostat-dataframe-query.tool.js.map

package/dist/mcp-server/tools/definitions/eurostat-dataframe-query.tool.js.map

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

package/dist/mcp-server/tools/definitions/eurostat-query-dataset.tool.d.ts

@@ -22,6 +22,7 @@ export declare const eurostatQueryDataset: import("@cyanheads/mcp-ts-core").Tool
         EN: "EN";
         FR: "FR";
     }>>;
+    canvas_id: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     datasetCode: z.ZodString;
     datasetLabel: z.ZodString;
@@ -36,6 +37,9 @@ export declare const eurostatQueryDataset: import("@cyanheads/mcp-ts-core").Tool
     }, z.core.$strip>>;
     obsCount: z.ZodNumber;
     truncated: z.ZodBoolean;
+    canvasId: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    stagedRowCount: z.ZodOptional<z.ZodNumber>;
     timeRange: z.ZodObject<{
         start: z.ZodOptional<z.ZodString>;
         end: z.ZodOptional<z.ZodString>;
@@ -67,6 +71,11 @@ export declare const eurostatQueryDataset: import("@cyanheads/mcp-ts-core").Tool
     readonly code: JsonRpcErrorCode.ValidationError;
     readonly when: "Mutually exclusive parameters were combined: \"geo\" filter + geo_level, or since_period/until_period + last_n_periods.";
     readonly recovery: "Use \"geo\" or geo_level (not both); use since_period/until_period or last_n_periods (not both).";
+}, {
+    readonly reason: "canvas_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "A canvas_id was supplied for staging but is unknown or its lifetime has elapsed.";
+    readonly recovery: "Omit canvas_id so the response starts a fresh canvas and returns its canvasId.";
 }], {
     readonly appliedFilters: z.ZodObject<{
         filters: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;

package/dist/mcp-server/tools/definitions/eurostat-query-dataset.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eurostat-query-dataset.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/eurostat-query-dataset.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAiB,MAAM,+BAA+B,CAAC;AAIhF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyT/B,CAAC"}
+{"version":3,"file":"eurostat-query-dataset.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/eurostat-query-dataset.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAiB,MAAM,+BAA+B,CAAC;AAahF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6X/B,CAAC"}