@cyanheads/eurostat-mcp-server 0.9.0 → 0.10.1

package/dist/mcp-server/tools/definitions/eurostat-get-dimension-values.tool.js

@@ -5,9 +5,12 @@
 import { tool, z } from '@cyanheads/mcp-ts-core';
 import { CanvasIdSchema } from '@cyanheads/mcp-ts-core/canvas';
 import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
-import { acquireCanvas, getCanvas, newTableName } from '../../../services/canvas-accessor.js';
+import { decodeCursor, encodeCursor } from '@cyanheads/mcp-ts-core/utils';
+import { filterTokens, fitPage, INLINE_BUDGET_BYTES, matchValues, utf8Bytes, } from '../value-list-paging.js';
+import { acquireCanvas, getCanvas, isCanvasFailure, newTableName, } from '../../../services/canvas-accessor.js';
 import { getEurostatDataService } from '../../../services/eurostat-data/eurostat-data-service.js';
 import { GEO_LEVEL_VALUES } from '../../../services/eurostat-data/types.js';
+import { outageAnswer } from '../../../services/eurostat-outage.js';
 /**
  * The staged value list: the same `{code, label}` pairs as the inline `values`,
  * declared rather than sniffed. The service falls back to the code when Eurostat
@@ -17,17 +20,78 @@ const VALUE_TABLE_SCHEMA = [
     { name: 'code', type: 'VARCHAR', nullable: false },
     { name: 'label', type: 'VARCHAR', nullable: false },
 ];
+/** Longest filter accepted: room for many words, while its echo and cursor stay small. */
+const FILTER_MAX_CHARS = 500;
+/** Page length when no limit was given: the byte budget alone ends the page. */
+const NO_LIMIT = Number.MAX_SAFE_INTEGER;
+/** A blank or whitespace-only string from a form client is "unset", never a value to validate. */
+const blankAsUnset = (schema) => z.preprocess((value) => (typeof value === 'string' && value.trim() === '' ? undefined : value), schema);
+const formatCount = (n) => n.toLocaleString('en-US');
+/** The `content[]` text of the payload — `format()`'s body, shared with the byte measure. */
+function renderText(result) {
+    const listed = result.values.length;
+    const partial = (of) => (listed < of ? ` — ${listed} listed below` : '');
+    const lines = [
+        `**Dimension:** ${result.dimensionLabel} (\`${result.dimensionCode}\`)`,
+        ...(result.geoLevel ? [`**Geo level:** \`${result.geoLevel}\``] : []),
+        `**Total values:** ${result.totalCount}${result.matchCount === undefined ? partial(result.totalCount) : ''}`,
+        ...(result.matchCount === undefined
+            ? []
+            : [`**Matching filter:** ${result.matchCount}${partial(result.matchCount)}`]),
+        ...(result.tableName
+            ? [
+                `**Staged:** table \`${result.tableName}\` on canvas \`${result.canvasId}\` (stagedRowCount ${result.stagedRowCount}), columns code and label — inspect it with eurostat_dataframe_describe first, then join it in eurostat_dataframe_query`,
+            ]
+            : []),
+        '',
+    ];
+    for (const v of result.values) {
+        lines.push(`- \`${v.code}\` — ${v.label}`);
+    }
+    return lines.join('\n');
+}
 /**
- * Most values returned inline. Every NUTS level and classification list measured on
- * the main host fits (the largest, NUTS-3 geo, is 1,621); daily time lists (13,900 on
- * ert_bil_eur_d), the largest airport-pair lists (2,383 on avia_par_uk) and the Comext
- * product lists (37,069 CN8 codes on DS-045409, an 11 MB response uncapped) do not.
- * A staged table always holds the whole list.
+ * The framework's `content[]` trailer for one page's enrichment: generic
+ * `**key:** value` lines, then the notice as a block quote, newline-joined. It
+ * is mirrored here so a page is measured as the caller receives it; a paging
+ * test pins the trailer the framework composes to this exact text, so the two
+ * cannot drift apart unnoticed.
  */
-const INLINE_VALUE_CAP = 2_000;
+function renderTrailer(enrichment) {
+    const fields = [
+        ...(enrichment.truncated ? ['**truncated:** true'] : []),
+        ...(enrichment.nextCursor ? [`**nextCursor:** ${enrichment.nextCursor}`] : []),
+        ...(enrichment.notice ? [`> ${enrichment.notice}`] : []),
+    ];
+    return fields.length > 0 ? `\n\n${fields.join('\n')}` : '';
+}
+/**
+ * Decode a cursor and confirm it belongs to this call in every binding the input
+ * alone settles; `undefined` when it does not. Malformed and mismatched cursors
+ * are refused alike: the recovery is the same, and the cursor is opaque. The
+ * effective geo level is left to the caller, which knows it only once the
+ * dimension's values are loaded.
+ */
+function readCursor(cursor, binding, ctx) {
+    try {
+        const state = decodeCursor(cursor, ctx);
+        if (typeof state.after === 'string' &&
+            state.dataset === binding.dataset &&
+            state.dimension === binding.dimension &&
+            state.filter === binding.filter) {
+            return { after: state.after, geoLevel: state.geoLevel, limit: state.limit };
+        }
+    }
+    catch {
+        // Undecodable — the same refusal as one that decodes but belongs to another call.
+    }
+    return;
+}
+/** The refusal of a cursor that is malformed or belongs to another call. */
+const UNUSABLE_CURSOR = 'Unusable cursor: it is malformed, or was issued for a different dataset_code, dimension, geo_level or filter.';
 export const eurostatGetDimensionValues = tool('eurostat_get_dimension_values', {
     title: 'Get Eurostat Dimension Values',
-    description: `List the valid values for a specific dimension in a Eurostat dataset (e.g., all unit codes for nama_10_gdp, all geo codes for a regional dataset). Use this when eurostat_get_dataset_info returns more values than the 10-item sample, or to confirm exact codes before querying. For the "geo" dimension, use geo_level to filter by NUTS hierarchy (country, nuts1, nuts2, nuts3). An invalid code matches nothing: eurostat_query_dataset names it in unmatchedValues, or in its no_results error when the query matched nothing at all, and Eurostat rejects it as a fault on eurostat_download_dataset; use this tool to verify codes first. At most ${INLINE_VALUE_CAP.toLocaleString('en-US')} values come back inline — a longer list, such as the 37,069 CN8 product codes of DS-045409 or a daily time dimension, is cut there and says so. Pass canvas_id to also stage the whole list, whatever its length, as a two-column code/label table on that dataframe canvas: search it with SQL, or join it to a eurostat_download_dataset table, whose columns carry dimension codes only.`,
+    description: `List the valid values for a specific dimension in a Eurostat dataset (e.g., all unit codes for nama_10_gdp, all geo codes for a regional dataset). Use this when eurostat_get_dataset_info returns more values than the 10-item sample, or to confirm exact codes before querying. For the "geo" dimension, use geo_level to filter by NUTS hierarchy (country, nuts1, nuts2, nuts3). An invalid code matches nothing: eurostat_query_dataset names it in unmatchedValues, or in its no_results error when the query matched nothing at all, and Eurostat rejects it as a fault on eurostat_download_dataset; use this tool to verify codes first. To find one code in a long list, such as the 37,069 CN8 product codes of DS-045409, pass filter: words its code or label contains. A long list comes back a page at a time, each response held to ${formatCount(INLINE_BUDGET_BYTES)} bytes; a page with more after it carries nextCursor — pass it back as cursor for the next page. Pass canvas_id to also stage the whole list, whatever its length, as a two-column code/label table on that dataframe canvas: search it with SQL, or join it to a eurostat_download_dataset table, whose columns carry dimension codes only.`,
     annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
     input: z.object({
         dataset_code: z
@@ -42,7 +106,15 @@ export const eurostatGetDimensionValues = tool('eurostat_get_dimension_values',
             .enum(GEO_LEVEL_VALUES)
             .optional()
             .describe('NUTS hierarchy level filter — applies only when dimension is "geo"; passing it with any other dimension is rejected. Options: "aggregate" (EU/EA codes), "country" (2-letter codes, default), "nuts1" (3-char), "nuts2" (4-char), "nuts3" (5-char).'),
-        canvas_id: CanvasIdSchema.optional().describe('Also stage the values on this dataframe canvas as a table with two columns, code and label, holding every value the dimension lists — past the inline cap too — at the geo_level requested, country when it is omitted. Pass the canvasId a eurostat_download_dataset or eurostat_query_dataset response returned, then search the staged table with SQL or join it to a download on the dimension column (e.g., d.geo = g.code). Omit to return the values inline only: this tool never starts a canvas. Ignored on deployments without a dataframe canvas.'),
+        filter: blankAsUnset(z.string().max(FILTER_MAX_CHARS).optional()).describe(`Words to find, up to ${FILTER_MAX_CHARS} characters: keeps only values whose code and label, joined by a space, contain every whitespace-separated word as a substring — in any order, ignoring case and accents ("palma frankfurt" finds DE_EDDF_ES_LEPA, "zurich" finds Zürich). Punctuation is part of a word, and spellings are not transliterated ("münchen" does not find MUENCHEN). Runs over the whole list at the effective geo_level before paging and keeps Eurostat's order, with no ranking; matchCount counts the matches.`),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .optional()
+            .describe(`Most values per page. No default and no maximum: without it a page holds as many whole values as fit ${formatCount(INLINE_BUDGET_BYTES)} bytes, and with it the page ends at whichever comes first. Fixed by the first call: on a call with cursor, the cursor carries that first limit and this field is ignored.`),
+        cursor: blankAsUnset(z.string().optional()).describe("Opaque nextCursor from the previous page; omit for the first page. It resumes after that page's last code and is bound to dataset_code, dimension, geo_level and filter, so send those unchanged. Cannot be combined with canvas_id on a deployment with a dataframe canvas."),
+        canvas_id: CanvasIdSchema.optional().describe('Also stage the values on this dataframe canvas as a table with two columns, code and label, holding every value the dimension lists at the geo_level requested (country when it is omitted), whatever filter and limit are. Pass the canvasId a eurostat_download_dataset or eurostat_query_dataset response returned, then search the staged table with SQL or join it to a download on the dimension column (e.g., d.geo = g.code). Only on a call without cursor; omit to return the values inline only: this tool never starts a canvas. Ignored on deployments without a dataframe canvas.'),
     }),
     output: z.object({
         dimensionCode: z.string().describe('The dimension code that was queried.'),
@@ -60,10 +132,14 @@ export const eurostatGetDimensionValues = tool('eurostat_get_dimension_values',
             label: z.string().describe('Human-readable label for this value.'),
         })
             .describe('A dimension value code and label pair.'))
-            .describe(`Dataset-available values for this dimension, in Eurostat's order — for geo, the subset at geoLevel. Holds every value up to ${INLINE_VALUE_CAP.toLocaleString('en-US')}; past that, the first ${INLINE_VALUE_CAP.toLocaleString('en-US')}, with truncated set and the whole list on the canvas table when canvas_id was passed.`),
+            .describe(`This page of the dataset-available values, in Eurostat's order — for geo, the subset at geoLevel; with filter, only the matches. A page ends between whole values, at limit or at ${formatCount(INLINE_BUDGET_BYTES)} bytes per response surface, whichever comes first, and holds at least one value; truncated and nextCursor are set when more follow.`),
         totalCount: z
             .number()
-            .describe('Number of distinct values the dimension lists, after geoLevel filtering for geo — all of them, including any past the inline cap.'),
+            .describe('Number of distinct values the dimension lists, after geoLevel filtering for geo — every one, whatever filter and paging apply.'),
+        matchCount: z
+            .number()
+            .optional()
+            .describe('Values matching filter across the whole list, before paging. Present only when filter was passed.'),
         canvasId: z
             .string()
             .optional()
@@ -81,13 +157,15 @@ export const eurostatGetDimensionValues = tool('eurostat_get_dimension_values',
         truncated: z
             .boolean()
             .optional()
-            .describe('True when the dimension lists more values than the inline cap and values holds only the first of them. Omitted when values holds every one.'),
-        shown: z.number().optional().describe('Values returned inline. Present alongside truncated.'),
-        cap: z.number().optional().describe('The inline cap applied. Present alongside truncated.'),
+            .describe('True when more values follow this page — pass nextCursor as cursor to fetch them. Omitted on the last page.'),
+        nextCursor: z
+            .string()
+            .optional()
+            .describe("Opaque cursor for the next page. Pass it back as cursor with dataset_code, dimension, geo_level and filter unchanged; it resumes after this page's last code. Omitted on the last page."),
         notice: z
             .string()
             .optional()
-            .describe('Where the values past the inline cap are: the staged table when canvas_id was passed, or how to stage them. Present alongside truncated.'),
+            .describe('On a page with more after it: whether limit or the response budget ended it, and the routes to the rest — nextCursor, filter, and canvas_id. Also explains a filter that matched nothing.'),
     },
     errors: [
         {
@@ -105,13 +183,19 @@ export const eurostatGetDimensionValues = tool('eurostat_get_dimension_values',
         {
             reason: 'conflicting_params',
             code: JsonRpcErrorCode.ValidationError,
-            when: 'geo_level was combined with a dimension other than "geo", where it has no effect.',
-            recovery: 'Drop geo_level to list that dimension, or set dimension to "geo" to filter by NUTS level.',
+            when: 'geo_level was combined with a dimension other than "geo", where it has no effect; or, on a deployment with a dataframe canvas, canvas_id was combined with cursor, which would stage the list again on every page.',
+            recovery: 'Drop geo_level for a dimension other than "geo"; when paging with cursor, drop canvas_id — a first call that carried canvas_id staged every value.',
+        },
+        {
+            reason: 'invalid_cursor',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'The cursor is malformed, was issued for a different dataset_code, dimension, geo_level or filter, or resumes after a code the list no longer holds.',
+            recovery: 'Call again without cursor, keeping dataset_code, dimension, geo_level and filter, then page with the nextCursor that call returns.',
         },
         {
             reason: 'upstream_fault',
             code: JsonRpcErrorCode.ServiceUnavailable,
-            when: "Eurostat returned a dataset structure or content constraint this server cannot read: malformed, truncated, not XML, or missing the requested dataset's dataflow.",
+            when: "Eurostat returned a dataset structure or content constraint this server cannot read — malformed, truncated, not XML, or missing the requested dataset's dataflow — or the structure endpoint answered HTTP 5xx or could not be reached on every retry, which the error marks retryable.",
             recovery: 'Retry in a few minutes, since a failed structure read is not cached. If it fails the same way, filter eurostat_query_dataset on the code in question: a code the dataset lacks comes back in unmatchedValues.',
         },
         {
@@ -119,10 +203,35 @@ export const eurostatGetDimensionValues = tool('eurostat_get_dimension_values',
             code: JsonRpcErrorCode.NotFound,
             when: 'A canvas_id was supplied for staging but is unknown or its lifetime has elapsed.',
             recovery: 'Pass the canvasId a recent eurostat_download_dataset or eurostat_query_dataset response returned, or omit canvas_id to list the values inline only.',
-            thrownBy: 'service',
         },
     ],
     async handler(input, ctx) {
+        /**
+         * Without a dataframe canvas canvas_id is ignored, so it cannot re-stage the
+         * list on every page and there is nothing to refuse.
+         */
+        if (input.cursor && input.canvas_id && getCanvas()) {
+            throw ctx.fail('conflicting_params', 'canvas_id stages the whole list, so it belongs on the first call; sent with cursor it would stage the list again for every page.', {
+                recovery: {
+                    hint: 'Drop canvas_id to keep paging with cursor; a first call that carried canvas_id has already staged every value. To stage the list now, call again with canvas_id and without cursor.',
+                },
+            });
+        }
+        /**
+         * A cursor is checked against everything the input settles before the
+         * dimension's values are loaded, so a cursor replayed for another dataset
+         * fails without downloading that dataset's structure.
+         */
+        const tokens = input.filter ? filterTokens(input.filter) : [];
+        const filtered = tokens.length > 0;
+        const binding = {
+            dataset: input.dataset_code.toLowerCase(),
+            dimension: input.dimension,
+            filter: [...tokens].sort().join(' '),
+        };
+        const resume = input.cursor ? readCursor(input.cursor, binding, ctx) : undefined;
+        if (input.cursor && !resume)
+            throw ctx.fail('invalid_cursor', UNUSABLE_CURSOR);
         const svc = getEurostatDataService();
         let result;
         try {
@@ -152,6 +261,14 @@ export const eurostatGetDimensionValues = tool('eurostat_get_dimension_values',
                     },
                 });
             }
+            if (reason === 'upstream_fault' && err.data?.retryable === true) {
+                throw ctx.fail('upstream_fault', err.message, {
+                    retryable: true,
+                    recovery: {
+                        hint: `Eurostat's SDMX structure endpoint ${outageAnswer(err.data?.status)} on every attempt, so the "${input.dimension}" values of "${input.dataset_code}" cannot be listed — an upstream outage, not a fault in the request. A failed read is not cached, so retry in a few minutes.`,
+                    },
+                });
+            }
             if (reason === 'upstream_fault') {
                 throw ctx.fail('upstream_fault', err.message, {
                     recovery: {
@@ -170,7 +287,13 @@ export const eurostatGetDimensionValues = tool('eurostat_get_dimension_values',
         const canvas = input.canvas_id ? getCanvas() : undefined;
         let staged;
         if (canvas && result.values.length > 0) {
-            const instance = await acquireCanvas(canvas, input.canvas_id, ctx);
+            // Re-thrown so the declared recovery replaces the canvas service's generic one.
+            const instance = await acquireCanvas(canvas, input.canvas_id, ctx).catch((err) => {
+                if (isCanvasFailure(err, 'canvas_not_found')) {
+                    throw ctx.fail('canvas_not_found', err.message, { canvasId: input.canvas_id }, { cause: err });
+                }
+                throw err;
+            });
             const handle = await instance.registerTable(newTableName(), result.values, {
                 schema: VALUE_TABLE_SCHEMA,
                 signal: ctx.signal,
@@ -181,46 +304,105 @@ export const eurostatGetDimensionValues = tool('eurostat_get_dimension_values',
                 tableName: handle.tableName,
             };
         }
-        const values = result.values.slice(0, INLINE_VALUE_CAP);
-        if (values.length < result.totalCount) {
-            const shown = `The first ${values.length.toLocaleString('en-US')} of ${result.totalCount.toLocaleString('en-US')} "${input.dimension}" values of "${input.dataset_code}" are inline, in Eurostat's order.`;
-            ctx.enrich.truncated({
-                shown: values.length,
-                cap: INLINE_VALUE_CAP,
-                guidance: staged
-                    ? `${shown} All ${staged.stagedRowCount.toLocaleString('en-US')} are staged as table "${staged.tableName}" on canvas "${staged.canvasId}" — search them with eurostat_dataframe_query (e.g. SELECT code, label FROM ${staged.tableName} WHERE label ILIKE '%term%').`
-                    : getCanvas()
-                        ? `${shown} To reach the rest, call again with canvas_id set to the canvasId of a eurostat_query_dataset or eurostat_download_dataset response: all ${result.totalCount.toLocaleString('en-US')} are then staged as a code/label table to search with eurostat_dataframe_query.`
-                        : `${shown} This deployment runs without a dataframe canvas, so the other ${(result.totalCount - values.length).toLocaleString('en-US')} cannot be listed; to check one code, filter eurostat_query_dataset on it — a code the dataset does not have comes back in unmatchedValues.`,
-            });
+        const matched = filtered ? matchValues(result.values, tokens) : result.values;
+        const geoLevel = result.geoLevel ?? null;
+        /**
+         * Where this page starts: after the code the cursor names, wherever that code
+         * now sits, so a list that grew between calls still resumes after the right
+         * value. The codec's `offset` is recorded but never trusted for position.
+         */
+        let start = 0;
+        let pageLimit = input.limit ?? NO_LIMIT;
+        if (resume) {
+            if (resume.geoLevel !== geoLevel)
+                throw ctx.fail('invalid_cursor', UNUSABLE_CURSOR);
+            const anchor = matched.findIndex(({ code }) => code === resume.after);
+            if (anchor < 0) {
+                throw ctx.fail('invalid_cursor', `Unusable cursor: it resumes after "${resume.after}", which the "${input.dimension}" values of "${input.dataset_code}" no longer list${filtered ? ' under this filter' : ''}.`);
+            }
+            start = anchor + 1;
+            pageLimit = resume.limit;
         }
+        const filterEcho = input.filter?.trim().replace(/\s+/g, ' ');
+        const pool = filtered
+            ? `${formatCount(matched.length)} values matching filter "${filterEcho}"`
+            : `${formatCount(matched.length)} "${input.dimension}" values`;
+        const canvasRoute = staged
+            ? ` Every one of the ${formatCount(staged.stagedRowCount)} values is staged as table "${staged.tableName}" on canvas "${staged.canvasId}" — search it with eurostat_dataframe_query (e.g. SELECT code, label FROM ${staged.tableName} WHERE label ILIKE '%term%').`
+            : getCanvas()
+                ? ` Or, on a call without cursor, pass canvas_id — the canvasId of a eurostat_query_dataset or eurostat_download_dataset response — to stage all ${formatCount(result.totalCount)} as a code/label table to search with eurostat_dataframe_query.`
+                : '';
+        const page = (k) => {
+            const values = matched.slice(start, start + k);
+            const output = {
+                ...result,
+                values,
+                ...(filtered && { matchCount: matched.length }),
+                ...staged,
+            };
+            if (start + k < matched.length) {
+                const endedBy = k === pageLimit
+                    ? `limit ${formatCount(pageLimit)}`
+                    : `the ${formatCount(INLINE_BUDGET_BYTES)}-byte response budget`;
+                return {
+                    output,
+                    enrichment: {
+                        truncated: true,
+                        nextCursor: encodeCursor({
+                            offset: start + k,
+                            limit: pageLimit,
+                            after: values[k - 1]?.code,
+                            ...binding,
+                            geoLevel,
+                        }),
+                        notice: `Values ${formatCount(start + 1)}–${formatCount(start + k)} of ${pool}, in Eurostat's order; ${endedBy} ended this page. Pass nextCursor as cursor for the next page, or ${filtered ? 'add words to filter' : 'pass filter (words of the code or label)'} to narrow the list.${canvasRoute}`,
+                    },
+                };
+            }
+            // An empty page needs saying only when a cursor or filter emptied it.
+            if (values.length > 0 || !(input.cursor || filtered))
+                return { output, enrichment: {} };
+            return {
+                output,
+                enrichment: {
+                    notice: input.cursor
+                        ? `No "${input.dimension}" values of "${input.dataset_code}" follow the code this cursor resumes after: the list ends there.`
+                        : `No "${input.dimension}" value${result.geoLevel ? ` at geo_level "${result.geoLevel}"` : ''} of "${input.dataset_code}" matched filter "${filterEcho}": every word must appear in a value's code or label, in any order, ignoring case and accents. Drop or shorten a word, or ${staged
+                            ? `search all ${formatCount(staged.stagedRowCount)} values, staged as table "${staged.tableName}" on canvas "${staged.canvasId}", with eurostat_dataframe_query (e.g. SELECT code, label FROM ${staged.tableName} WHERE label ILIKE '%term%').`
+                            : `call without filter to page through all ${formatCount(result.totalCount)}.`}`,
+                },
+            };
+        };
+        const measure = (k) => {
+            const { output, enrichment } = page(k);
+            return {
+                structured: utf8Bytes(JSON.stringify({ ...output, ...enrichment })),
+                text: utf8Bytes(renderText(output) + renderTrailer(enrichment)),
+            };
+        };
+        const costOf = (index) => {
+            const value = matched[start + index];
+            return {
+                structured: utf8Bytes(JSON.stringify(value)) + 1,
+                text: utf8Bytes(`- \`${value.code}\` — ${value.label}`) + 1,
+            };
+        };
+        const { output, enrichment } = page(fitPage(Math.min(pageLimit, matched.length - start), measure, costOf));
+        const { notice, ...fields } = enrichment;
+        ctx.enrich(fields);
+        if (notice)
+            ctx.enrich.notice(notice);
         ctx.log.info('Dimension values fetched', {
             datasetCode: input.dataset_code,
             dimension: input.dimension,
             totalCount: result.totalCount,
-            shown: values.length,
+            ...(filtered && { matchCount: matched.length }),
+            shown: output.values.length,
+            hasMore: enrichment.truncated === true,
             ...(staged && { canvasId: staged.canvasId, tableName: staged.tableName }),
         });
-        return { ...result, values, ...staged };
-    },
-    format: (result) => {
-        const lines = [
-            `**Dimension:** ${result.dimensionLabel} (\`${result.dimensionCode}\`)`,
-            ...(result.geoLevel ? [`**Geo level:** \`${result.geoLevel}\``] : []),
-            `**Total values:** ${result.totalCount}${result.values.length < result.totalCount
-                ? ` — the first ${result.values.length} are listed below`
-                : ''}`,
-            ...(result.tableName
-                ? [
-                    `**Staged:** table \`${result.tableName}\` on canvas \`${result.canvasId}\` (stagedRowCount ${result.stagedRowCount}), columns code and label — inspect it with eurostat_dataframe_describe first, then join it in eurostat_dataframe_query`,
-                ]
-                : []),
-            '',
-        ];
-        for (const v of result.values) {
-            lines.push(`- \`${v.code}\` — ${v.label}`);
-        }
-        return [{ type: 'text', text: lines.join('\n') }];
+        return output;
     },
+    format: (result) => [{ type: 'text', text: renderText(result) }],
 });
 //# sourceMappingURL=eurostat-get-dimension-values.tool.js.map

package/dist/mcp-server/tools/definitions/eurostat-get-dimension-values.tool.js.map

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

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

@@ -4,6 +4,107 @@
  */
 import { z } from '@cyanheads/mcp-ts-core';
 import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+/** Selects the advertised limit policy before registration. */
+export declare const createEurostatQueryDataset: (clampLimits: boolean) => import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    dataset_code: z.ZodString;
+    filters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+    geo_level: z.ZodOptional<z.ZodEnum<{
+        aggregate: "aggregate";
+        country: "country";
+        nuts1: "nuts1";
+        nuts2: "nuts2";
+        nuts3: "nuts3";
+    }>>;
+    since_period: z.ZodOptional<z.ZodString>;
+    until_period: z.ZodOptional<z.ZodString>;
+    last_n_periods: z.ZodOptional<z.ZodNumber>;
+    preview_limit: z.ZodDefault<z.ZodNumber>;
+    lang: z.ZodDefault<z.ZodEnum<{
+        DE: "DE";
+        EN: "EN";
+        FR: "FR";
+    }>>;
+    canvas_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    datasetCode: z.ZodString;
+    datasetLabel: z.ZodString;
+    dimensionsUsed: z.ZodArray<z.ZodString>;
+    observations: z.ZodArray<z.ZodObject<{
+        dimensions: z.ZodObject<{}, z.core.$loose>;
+        value: z.ZodNullable<z.ZodNumber>;
+        valueText: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>>;
+        confStatus: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>>;
+    }, 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>;
+    }, z.core.$strip>;
+    missingObsCount: z.ZodNumber;
+    unmatchedValues: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The dataset code does not exist (HTTP 404 carrying Eurostat error id 100).";
+    readonly recovery: "Use eurostat_search_datasets or eurostat_browse_themes to find a valid dataset code.";
+}, {
+    readonly reason: "no_results";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The query matched no observation cells — including Eurostat HTTP-200 error id 100. The dataset is valid, but no cell carries a value or a status flag for that filter combination and period range. When Eurostat returns the empty table, the error names the filter values that matched nothing (data.unmatchedValues) and the selected periods that carry no value (data.matchedPeriods, the newest 24, with data.matchedPeriodCount counting all of them).";
+    readonly recovery: "Verify dimension values with eurostat_get_dimension_values and keep the period range inside the dataset coverage; both an unmatched value and an out-of-coverage range return no data rather than an error.";
+}, {
+    readonly reason: "invalid_period";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "since_period or until_period is not a period literal, or names a month, quarter, semester, trimester, week or day that does not exist, or since_period starts after until_period ends. Checked before any request; a period Eurostat itself rejects maps here too.";
+    readonly recovery: "Write since_period/until_period as YYYY, YYYY-MM, YYYY-MM-DD, YYYY-Qn (1–4), YYYY-Sn (1–2), YYYY-Tn (1–3), YYYY-Mnn (01–12), YYYY-Wnn (a week the year has, up to 53) or YYYY-Dnnn (a day the year has, up to 366), for example \"2020\", \"2020-01\" or \"2020-Q1\", with since_period starting no later than until_period ends.";
+}, {
+    readonly reason: "async_response";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "Eurostat returned an async warning or an HTTP-413 error array — the query matched too many observations, including an EXTRACTION_TOO_BIG refusal past Eurostat's 5,000,000-row limit.";
+    readonly retryable: false;
+    readonly recovery: "Filter on the dataset dimensions this query left unfiltered, or narrow the period range, then retry.";
+}, {
+    readonly reason: "invalid_dimension";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "A dimension code in filters does not exist in this dataset (HTTP 400, Eurostat error id 150), or a filter key names a request control (lang, format, geoLevel, sinceTimePeriod, untilTimePeriod, lastTimePeriod, in any case) rather than a dimension — rejected before any request, naming the input that sets it.";
+    readonly recovery: "Use eurostat_get_dataset_info to see valid dimension codes for this dataset; set a control through its own input (lang, geo_level, since_period, until_period, last_n_periods), not filters.";
+}, {
+    readonly reason: "conflicting_params";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "Mutually exclusive parameters were combined: \"geo\" filter + geo_level, since_period/until_period + last_n_periods, or a \"time\"/\"time_period\" filter + since_period, until_period or last_n_periods. Checked before any request; Eurostat's own refusal of two time selections maps here too.";
+    readonly recovery: "Keep one of each pair: filters.geo or geo_level; since_period/until_period or last_n_periods; filters.time or a period input.";
+}, {
+    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 reason: "upstream_fault";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "The Statistics API answered HTTP 5xx or could not be reached on every attempt of the retry loop. The error is marked retryable, except for HTTP 501, which is marked not retryable.";
+    readonly recovery: "The failure is on Eurostat's side, not in the request: when the error is marked retryable, call again in a few minutes.";
+}], {
+    readonly appliedFilters: z.ZodObject<{
+        filters: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
+        geoLevel: z.ZodOptional<z.ZodString>;
+        sincePeriod: z.ZodOptional<z.ZodString>;
+        untilPeriod: z.ZodOptional<z.ZodString>;
+        lastNPeriods: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    readonly notice: z.ZodOptional<z.ZodString>;
+}>;
+/** Default-on read-limit policy; startup selects the deployment policy explicitly. */
 export declare const eurostatQueryDataset: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
     dataset_code: z.ZodString;
     filters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
@@ -76,19 +177,23 @@ export declare const eurostatQueryDataset: import("@cyanheads/mcp-ts-core").Tool
 }, {
     readonly reason: "invalid_dimension";
     readonly code: JsonRpcErrorCode.ValidationError;
-    readonly when: "A dimension code in filters does not exist in this dataset (HTTP 400, Eurostat error id 150).";
-    readonly recovery: "Use eurostat_get_dataset_info to see valid dimension codes for this dataset.";
+    readonly when: "A dimension code in filters does not exist in this dataset (HTTP 400, Eurostat error id 150), or a filter key names a request control (lang, format, geoLevel, sinceTimePeriod, untilTimePeriod, lastTimePeriod, in any case) rather than a dimension — rejected before any request, naming the input that sets it.";
+    readonly recovery: "Use eurostat_get_dataset_info to see valid dimension codes for this dataset; set a control through its own input (lang, geo_level, since_period, until_period, last_n_periods), not filters.";
 }, {
     readonly reason: "conflicting_params";
     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 when: "Mutually exclusive parameters were combined: \"geo\" filter + geo_level, since_period/until_period + last_n_periods, or a \"time\"/\"time_period\" filter + since_period, until_period or last_n_periods. Checked before any request; Eurostat's own refusal of two time selections maps here too.";
+    readonly recovery: "Keep one of each pair: filters.geo or geo_level; since_period/until_period or last_n_periods; filters.time or a period input.";
 }, {
     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 thrownBy: "service";
+}, {
+    readonly reason: "upstream_fault";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "The Statistics API answered HTTP 5xx or could not be reached on every attempt of the retry loop. The error is marked retryable, except for HTTP 501, which is marked not retryable.";
+    readonly recovery: "The failure is on Eurostat's side, not in the request: when the error is marked retryable, call again in a few minutes.";
 }], {
     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;AAEjD,OAAO,EAAE,gBAAgB,EAAiB,MAAM,+BAA+B,CAAC;AA0BhF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAue/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;AAEjD,OAAO,EAAE,gBAAgB,EAAiB,MAAM,+BAA+B,CAAC;AAkChF,+DAA+D;AAC/D,eAAO,MAAM,0BAA0B,gBAAiB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAohB3D,CAAC;AAEL,sFAAsF;AACtF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAmC,CAAC"}