@cyanheads/eurostat-mcp-server 0.11.1 → 0.11.3

package/dist/mcp-server/tools/narrowing-advice.js

@@ -1,14 +1,74 @@
 /**
- * @fileoverview Recovery wording that names a dataset's own dimensions, shared by the two
- * data tools: the best-effort structure read behind it, and the advice for a request
- * Eurostat refused as too large.
+ * @fileoverview Recovery wording shared by the two data tools: the best-effort reads
+ * behind a hint that names a dataset's own dimensions or values, the advice for a
+ * request Eurostat refused as too large, and the wording for a filter key or value that
+ * cannot match the dataset.
  * @module mcp-server/tools/narrowing-advice
  */
 import { getEurostatDataService } from '../../services/eurostat-data/eurostat-data-service.js';
+import { isComextDataset } from '../../services/eurostat-hosts.js';
+/**
+ * The opening of both data tools' `invalid_dimension` `when`. Each tool appends the
+ * further causes its own path raises.
+ */
+export const UNKNOWN_FILTER_KEY_WHEN = "A filter key is not a dimension of this dataset; the error names every such key and lists the dataset's dimensions in key order";
+/** The hint for a filter key that names no dimension, shared by both data tools. */
+export const RENAME_FILTER_KEYS_HINT = 'Rename each filter key the error names to one of the dimensions it lists.';
+/**
+ * Advice for filter values holding ".", which no Eurostat code contains, as one hint:
+ * the opening sentence once, then one piece of advice per value. A Comext `DS-*`
+ * collection's classification codes are bare digits, so there a value of digits and dots
+ * is a code printed with separators and its stripped form is the code to send
+ * (`2204.21` → `220421`). Elsewhere stripping can yield a non-code (COICOP `01.1.1` is
+ * `CP0111`), so the advice is a value search on the stripped form instead. `literals`
+ * holds the values the hint quotes for the caller to send back.
+ */
+export function dottedValueAdvice(datasetCode, entries) {
+    const advise = ({ dimension, value }) => {
+        const stripped = value.replaceAll('.', '');
+        if (isComextDataset(datasetCode) && value.split('.').every((part) => /^\d+$/.test(part))) {
+            return {
+                joiner: '. ',
+                literals: [stripped, value, dimension],
+                text: `Write "${stripped}" for "${value}" in filters.${dimension}.`,
+            };
+        }
+        if (stripped.trim() === '') {
+            return {
+                joiner: '. ',
+                literals: [dimension],
+                text: `List the codes of "${dimension}" with eurostat_get_dimension_values.`,
+            };
+        }
+        return {
+            joiner: ', and ',
+            literals: [value, stripped, dimension],
+            text: `"${value}" without its dots may not be a code of "${datasetCode}" either. Find the code with eurostat_get_dimension_values, dimension "${dimension}" and filter "${stripped}".`,
+        };
+    };
+    const [head, ...tail] = entries;
+    const first = advise(head);
+    const rest = tail.map(advise);
+    return {
+        hint: `No Eurostat code contains "."${first.joiner}${first.text}${rest.map(({ text }) => ` ${text}`).join('')}`,
+        literals: [first, ...rest].flatMap(({ literals }) => literals),
+    };
+}
+/**
+ * `geo=[DE, XX]; age=[ZZZ]`, each dimension code and value passed through `encode`.
+ * Authored Markdown (a notice, a `format()` line, the filters trailer) passes
+ * `escapeMarkdownInline`, so a caller's value renders as sent; an error message stays
+ * raw, as the framework escapes it.
+ */
+export function formatValues(values, encode = (text) => text) {
+    return Object.entries(values)
+        .map(([dim, codes]) => `${encode(dim)}=[${codes.map((code) => encode(code)).join(', ')}]`)
+        .join('; ');
+}
 /**
  * Total allowance for the read behind a hint, every attempt and backoff included. It
  * runs after the request it explains, which can have spent its own 30 s, and MCP SDK
- * clients give up at 60 s. The structure definition answers in about half a second.
+ * clients give up at 60 s.
  */
 const HINT_READ_DEADLINE_MS = 5_000;
 /**
@@ -35,6 +95,102 @@ export async function dimensionsToNarrow(datasetCode, known, ctx) {
         return;
     }
 }
+/**
+ * The dataset's metadata, for a recovery hint to name its dimension values, or
+ * `undefined` when it is not in hand within {@link HINT_READ_DEADLINE_MS}. The metadata
+ * load is shared and takes no deadline of its own (a cold Comext dataflow outlasts the
+ * allowance several times over), so the read races a timer instead; a load the timer
+ * beats keeps running and fills the cache, so a follow-up value lookup is served from
+ * it. A failed read degrades the hint the same way, and a cancelled call is rethrown.
+ */
+export async function dimensionValuesForHint(datasetCode, ctx) {
+    let timer;
+    const late = new Promise((resolve) => {
+        timer = setTimeout(() => resolve(undefined), HINT_READ_DEADLINE_MS);
+    });
+    try {
+        return await Promise.race([getEurostatDataService().getSdmxMetadata(datasetCode, ctx), late]);
+    }
+    catch (error) {
+        if (ctx.signal.aborted)
+            throw error;
+        ctx.log.debug('Could not read dimension values for a recovery hint', {
+            datasetCode,
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Most values a hint lists for one dimension: eurostat_get_dimension_values' default
+ * page. A longer list is not cut to its first values, which in Eurostat's order say
+ * nothing about the value sent (a CN product list opens with confidential-trade totals).
+ */
+const VALUES_LISTED_MAX = 25;
+/**
+ * What to send instead of each unmatched filter value, from the dataset's own value
+ * lists. A dimension with at most {@link VALUES_LISTED_MAX} values has every code and
+ * label listed; a longer one has its total and, per value sent, a value search for it,
+ * or {@link dottedValueAdvice} for a value holding ".". `totalCount` counts every value
+ * the dimension lists, every `geo` level included, where eurostat_get_dimension_values
+ * defaults `geo` to countries. A key the metadata lists no values for lands in
+ * `unresolved`, for the caller's generic sentence. `literals` holds the codes and values
+ * the sentences quote for sending back.
+ */
+export function unmatchedValuesAdvice(datasetCode, unmatched, { meta, valuesByDimension }) {
+    const sentences = [];
+    const literals = new Set();
+    const validValues = {};
+    const unresolved = [];
+    const dotted = [];
+    let dottedAt = -1;
+    for (const [key, sent] of Object.entries(unmatched)) {
+        const folded = key.toLowerCase();
+        const dimension = meta.dimensions.find(({ code }) => code === key) ??
+            meta.dimensions.find(({ code }) => code.toLowerCase() === folded);
+        const values = dimension && valuesByDimension[dimension.code];
+        if (!dimension || !values?.length) {
+            unresolved.push(key);
+            continue;
+        }
+        if (values.length <= VALUES_LISTED_MAX) {
+            validValues[key] = {
+                totalCount: values.length,
+                values: values.map(({ code, label }) => ({ code, label })),
+            };
+            const listed = values.map(({ code, label }) => `${code} (${label})`).join(', ');
+            sentences.push(`"${key}" has ${values.length === 1 ? '1 code' : `${values.length} codes`}: ${listed}.`);
+            for (const { code } of values)
+                literals.add(code);
+            continue;
+        }
+        validValues[key] = { totalCount: values.length };
+        sentences.push(`"${key}" has ${values.length.toLocaleString('en-US')} codes, too many to list here.`);
+        for (const value of sent) {
+            if (value.includes('.')) {
+                dotted.push({ dimension: key, value });
+                if (dotted.length === 1) {
+                    dottedAt = sentences.length;
+                    sentences.push('');
+                }
+                continue;
+            }
+            sentences.push(`Find the code for "${value}" with eurostat_get_dimension_values, dimension "${key}" and filter "${value}"${dimension.code === 'geo' ? ', adding geo_level for a code below country level' : ''}.`);
+            literals.add(value).add(key);
+        }
+    }
+    const [firstDotted, ...otherDotted] = dotted;
+    if (firstDotted) {
+        const advice = dottedValueAdvice(datasetCode, [firstDotted, ...otherDotted]);
+        sentences[dottedAt] = advice.hint;
+        for (const literal of advice.literals)
+            literals.add(literal);
+    }
+    return { literals: [...literals], sentences, unresolved, validValues };
+}
 /**
  * Tell the caller how to shrink a refused request, naming the dimensions of this
  * dataset it left unfiltered. `dimensions` is the dataset's key dimensions, or

package/dist/mcp-server/tools/narrowing-advice.js.map

@@ -1 +1 @@
-{"version":3,"file":"narrowing-advice.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/narrowing-advice.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,mDAAmD,CAAC;AAE3F;;;;GAIG;AACH,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAmB,EACnB,KAAe,EACf,GAAY;IAEZ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,IAAI,CAAC;QACH,OAAO,MAAM,sBAAsB,EAAE,CAAC,iBAAiB,CACrD,WAAW,EACX,GAAG,EACH,qBAAqB,CACtB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO;YAAE,MAAM,KAAK,CAAC;QACpC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,+CAA+C,EAAE;YAC7D,WAAW;YACX,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC,CAAC;QACH,OAAO;IACT,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,WAAmB,EACnB,UAAgC,EAChC,QAAkB;IAElB,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,8EAA8E,WAAW,oDAAoD,CAAC;IACvJ,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACxF,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC;QACpB,CAAC,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,yBAAyB,WAAW,uEAAuE;QACzI,CAAC,CAAC,uBAAuB,WAAW,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,0GAA0G,CAAC;AAC9K,CAAC"}
+{"version":3,"file":"narrowing-advice.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/narrowing-advice.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/notice-text.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview Wording the two data tools' notices share: counts, period spans, and the
+ * listing of filter values that matched no data.
+ * @module mcp-server/tools/notice-text
+ */
+/** `1 period`, `3 periods`. */
+export declare const countOf: (n: number, noun: string) => string;
+/** `2026-08`, or `1975 – 1980` for several periods. */
+export declare function spanOf(periods: string[]): string;
+/**
+ * The filter values that matched no data: their total, and the first {@link VALUES_LISTED}
+ * as `geo=[DE, XX]; age=[ZZZ]` (escaped for Markdown) with a count of those left out.
+ */
+export declare function listEmptyValues(values: Record<string, string[]>): {
+    list: string;
+    total: number;
+};
+//# sourceMappingURL=notice-text.d.ts.map

package/dist/mcp-server/tools/notice-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notice-text.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/notice-text.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,+BAA+B;AAC/B,eAAO,MAAM,OAAO,MAAO,MAAM,QAAQ,MAAM,KAAG,MACW,CAAC;AAE9D,uDAAuD;AACvD,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAEhD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAejG"}

package/dist/mcp-server/tools/notice-text.js

@@ -0,0 +1,40 @@
+/**
+ * @fileoverview Wording the two data tools' notices share: counts, period spans, and the
+ * listing of filter values that matched no data.
+ * @module mcp-server/tools/notice-text
+ */
+import { escapeMarkdownInline } from '@cyanheads/mcp-ts-core/utils';
+import { formatValues } from './narrowing-advice.js';
+/**
+ * Filter values named in a notice; the structured `emptyValues` keeps every one. A
+ * `geo_level` query can have hundreds.
+ */
+const VALUES_LISTED = 24;
+/** `1 period`, `3 periods`. */
+export const countOf = (n, noun) => `${n.toLocaleString('en-US')} ${noun}${n === 1 ? '' : 's'}`;
+/** `2026-08`, or `1975 – 1980` for several periods. */
+export function spanOf(periods) {
+    return periods.length === 1 ? (periods[0] ?? '') : `${periods[0]} – ${periods.at(-1)}`;
+}
+/**
+ * The filter values that matched no data: their total, and the first {@link VALUES_LISTED}
+ * as `geo=[DE, XX]; age=[ZZZ]` (escaped for Markdown) with a count of those left out.
+ */
+export function listEmptyValues(values) {
+    const total = Object.values(values).reduce((n, codes) => n + codes.length, 0);
+    const listed = {};
+    let room = VALUES_LISTED;
+    for (const [key, codes] of Object.entries(values)) {
+        if (room === 0)
+            break;
+        const shown = codes.slice(0, room);
+        listed[key] = shown;
+        room -= shown.length;
+    }
+    const omitted = total - (VALUES_LISTED - room);
+    return {
+        list: `${formatValues(listed, escapeMarkdownInline)}${omitted ? ` (${omitted.toLocaleString('en-US')} more omitted; emptyValues lists all ${total.toLocaleString('en-US')})` : ''}`,
+        total,
+    };
+}
+//# sourceMappingURL=notice-text.js.map

package/dist/mcp-server/tools/notice-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notice-text.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/notice-text.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAEtE;;;GAGG;AACH,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB,+BAA+B;AAC/B,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,IAAY,EAAU,EAAE,CACzD,GAAG,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;AAE9D,uDAAuD;AACvD,MAAM,UAAU,MAAM,CAAC,OAAiB;IACtC,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACzF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAgC;IAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC9E,MAAM,MAAM,GAA6B,EAAE,CAAC;IAC5C,IAAI,IAAI,GAAG,aAAa,CAAC;IACzB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,IAAI,KAAK,CAAC;YAAE,MAAM;QACtB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACpB,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC;IACvB,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAC/C,OAAO;QACL,IAAI,EAAE,GAAG,YAAY,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,wCAAwC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACnL,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/mcp-server/tools/value-list-paging.d.ts

@@ -1,5 +1,6 @@
 /**
- * @fileoverview Case- and accent-blind word filtering for dimension code/label lists.
+ * @fileoverview Case- and accent-blind word filtering, and case-blind code-prefix
+ * matching, for dimension code/label lists.
  * @module mcp-server/tools/value-list-paging
  */
 /** Lowercase, compatibility-decompose, and drop combining marks: "Zürich" → "zurich". */
@@ -18,4 +19,13 @@ export declare function matchValues<T extends {
     code: string;
     label: string;
 }>(values: readonly T[], tokens: readonly string[]): T[];
+/**
+ * A code prefix folded for comparison: trimmed and lowercased. Eurostat codes are
+ * uppercase ASCII letters, digits, `-` and `_`, so case is the only fold they need.
+ */
+export declare function foldCodePrefix(prefix: string): string;
+/** The values whose code starts with a folded prefix, ignoring case, in the list's own order. */
+export declare function matchCodePrefix<T extends {
+    code: string;
+}>(values: readonly T[], foldedPrefix: string): T[];
 //# sourceMappingURL=value-list-paging.d.ts.map

package/dist/mcp-server/tools/value-list-paging.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"value-list-paging.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/value-list-paging.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAErD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EACnE,MAAM,EAAE,SAAS,CAAC,EAAE,EACpB,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,CAAC,EAAE,CAKL"}
+{"version":3,"file":"value-list-paging.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/value-list-paging.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAErD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EACnE,MAAM,EAAE,SAAS,CAAC,EAAE,EACpB,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,CAAC,EAAE,CAKL;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,iGAAiG;AACjG,wBAAgB,eAAe,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EACxD,MAAM,EAAE,SAAS,CAAC,EAAE,EACpB,YAAY,EAAE,MAAM,GACnB,CAAC,EAAE,CAEL"}

package/dist/mcp-server/tools/value-list-paging.js

@@ -1,5 +1,6 @@
 /**
- * @fileoverview Case- and accent-blind word filtering for dimension code/label lists.
+ * @fileoverview Case- and accent-blind word filtering, and case-blind code-prefix
+ * matching, for dimension code/label lists.
  * @module mcp-server/tools/value-list-paging
  */
 /** Lowercase, compatibility-decompose, and drop combining marks: "Zürich" → "zurich". */
@@ -24,4 +25,15 @@ export function matchValues(values, tokens) {
         return tokens.every((token) => haystack.includes(token));
     });
 }
+/**
+ * A code prefix folded for comparison: trimmed and lowercased. Eurostat codes are
+ * uppercase ASCII letters, digits, `-` and `_`, so case is the only fold they need.
+ */
+export function foldCodePrefix(prefix) {
+    return prefix.trim().toLowerCase();
+}
+/** The values whose code starts with a folded prefix, ignoring case, in the list's own order. */
+export function matchCodePrefix(values, foldedPrefix) {
+    return values.filter(({ code }) => code.toLowerCase().startsWith(foldedPrefix));
+}
 //# sourceMappingURL=value-list-paging.js.map

package/dist/mcp-server/tools/value-list-paging.js.map

@@ -1 +1 @@
-{"version":3,"file":"value-list-paging.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/value-list-paging.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,yFAAyF;AACzF,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;AACrE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,MAAoB,EACpB,MAAyB;IAEzB,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QAC7B,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"value-list-paging.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/value-list-paging.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,yFAAyF;AACzF,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;AACrE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,MAAoB,EACpB,MAAyB;IAEzB,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QAC7B,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACrC,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,eAAe,CAC7B,MAAoB,EACpB,YAAoB;IAEpB,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;AAClF,CAAC"}

package/dist/services/eurostat-bulk/eurostat-bulk-service.d.ts

@@ -3,7 +3,7 @@
  * dissemination endpoint. Builds the positional dimension key, sniffs gzip off
  * the stream, enforces a byte budget mid-transfer, classifies XML SOAP faults
  * and the asynchronous queue envelope, and expands the wide TSV layout into
- * one row per observation.
+ * one row per non-blank cell.
  * @module services/eurostat-bulk/eurostat-bulk-service
  */
 import type { Context } from '@cyanheads/mcp-ts-core';
@@ -29,9 +29,10 @@ export declare function classifyXmlBody(xml: string, datasetCode: string): never
  * The grammar, read off live responses, is `<value>` `SPACE` `<flags>`, where
  * flags is `<obs_flag>` optionally followed by `@<conf_status>` and either part
  * may be empty: `429634.3 `, `3853937.0 p`, `: `, `: @C`. A cell that is empty
- * on both sides of the split is not an observation at all and yields
- * `undefined` — distinct from `: `, which is an observation Eurostat reports as
- * unavailable.
+ * on both sides of the split yields `undefined` — distinct from `: `, an unflagged
+ * `:` that comes back with every field null: a period the series has no cell in, where
+ * the Statistics API has none either. A flagged `:` (`: u`, `: @C`) is an observation
+ * Eurostat publishes without a value.
  *
  * A value that is not a number is read by {@link decodeTextValue}: PRODCOM's flag
  * and unit indicators publish `:C` (confidential, no space before the `C`) and `KG`
@@ -63,7 +64,8 @@ export declare function parseHeader(line: string): TsvHeader;
  *
  * A filter key names its dimension in any case (`GEO` places the same as `geo`),
  * as the Statistics API reads it; keys that differ only in case pool their values.
- * A blank value is unset rather than an empty member of the `+` list.
+ * A blank value is unset rather than an empty member of the `+` list, and a value
+ * holding `+` arrives here already split into its codes.
  *
  * Returns `undefined` when no filter applies. An all-wildcard key is accepted
  * by Eurostat, but omitting the segment asks the same question without staking

package/dist/services/eurostat-bulk/eurostat-bulk-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eurostat-bulk-service.d.ts","sourceRoot":"","sources":["../../../src/services/eurostat-bulk/eurostat-bulk-service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAS/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAuBrE,OAAO,EACL,KAAK,YAAY,EAIjB,KAAK,SAAS,EACf,MAAM,YAAY,CAAC;AAyCpB;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,KAAK,CAqEvE;AAuBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,SAAS,CAqB/F;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAkBnD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAC1B,cAAc,EAAE,MAAM,EAAE,EACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAChC,MAAM,GAAG,SAAS,CAmBpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,SAAS,UAAQ,GAAG,YAAY,EAAE,CAarF;AAED,qBAAa,mBAAmB;IAI9B,YAAY,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAI;IAE5D,OAAO,CAAC,QAAQ;IAgBhB;;;;;;;;;;;OAWG;IACG,aAAa,CACjB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EAAE,EACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EACjC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,YAAY,CAAC,CA4HvB;CACF;AAkUD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAExF;AAED,wBAAgB,sBAAsB,IAAI,mBAAmB,CAO5D"}
+{"version":3,"file":"eurostat-bulk-service.d.ts","sourceRoot":"","sources":["../../../src/services/eurostat-bulk/eurostat-bulk-service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAS/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AA+BrE,OAAO,EACL,KAAK,YAAY,EAIjB,KAAK,SAAS,EACf,MAAM,YAAY,CAAC;AAmCpB;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,KAAK,CAqEvE;AAuBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,SAAS,CAqB/F;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAkBnD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAC1B,cAAc,EAAE,MAAM,EAAE,EACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAChC,MAAM,GAAG,SAAS,CAmBpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,SAAS,UAAQ,GAAG,YAAY,EAAE,CAarF;AAED,qBAAa,mBAAmB;IAI9B,YAAY,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAI;IAE5D,OAAO,CAAC,QAAQ;IAgBhB;;;;;;;;;;;OAWG;IACG,aAAa,CACjB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EAAE,EACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EACjC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,YAAY,CAAC,CAgIvB;CACF;AAgbD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAExF;AAED,wBAAgB,sBAAsB,IAAI,mBAAmB,CAO5D"}