@cyanheads/eur-lex-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/eurlex-browse-subjects.tool.js

@@ -0,0 +1,121 @@
+/**
+ * @fileoverview eurlex_browse_subjects — Search the EuroVoc multilingual thesaurus.
+ * @module mcp-server/tools/definitions/eurlex-browse-subjects
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { CellarSparqlService, getCellarSparqlService, } from '../../../services/cellar-sparql/cellar-sparql-service.js';
+export const eurlex_browse_subjects = tool('eurlex_browse_subjects', {
+    title: 'Browse EuroVoc Subjects',
+    description: 'Search the EuroVoc multilingual thesaurus to resolve a human-readable term or keyword into EuroVoc concept IDs. ' +
+        'This tool is required before using the eurovoc_concept filter in eurlex_search_documents — ' +
+        'agents cannot guess numeric EuroVoc concept IDs. ' +
+        'Returns concept URI, preferred label in the requested language, concept code, and broader/narrower hierarchy hints. ' +
+        'EuroVoc covers all EU policy domains: agriculture, environment, finance, health, trade, transport, and more. ' +
+        'If no results are found in a non-English language, retry with language "en" and a broader English term.',
+    annotations: { readOnlyHint: true, openWorldHint: true, idempotentHint: true },
+    input: z.object({
+        keyword: z
+            .string()
+            .min(1)
+            .describe('Search term to match against EuroVoc concept labels (e.g. "privacy", "agriculture", "trade").'),
+        language: z
+            .string()
+            .regex(/^[a-z]{2,3}$/)
+            .default('en')
+            .describe('Language code for concept labels (e.g. "en", "fr", "de"). Defaults to English.'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(50)
+            .default(20)
+            .describe('Maximum number of EuroVoc concepts to return (1–50). Defaults to 20.'),
+    }),
+    output: z.object({
+        concepts: z
+            .array(z
+            .object({
+            concept_uri: z
+                .string()
+                .describe('Full URI for the EuroVoc concept, usable in the eurovoc_concept filter.'),
+            pref_label: z
+                .string()
+                .describe('Preferred label for the concept in the requested language.'),
+            concept_code: z.string().optional().describe('Numeric EuroVoc concept code.'),
+            broader_label: z
+                .string()
+                .optional()
+                .describe('Preferred label of the broader (parent) concept, if available.'),
+        })
+            .describe('A single EuroVoc concept with its URI, label, code, and hierarchy context.'))
+            .describe('Matching EuroVoc concepts ordered by relevance of the label match.'),
+        total: z.number().describe('Number of concepts returned in this response.'),
+    }),
+    errors: [
+        {
+            reason: 'no_concepts',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No EuroVoc concepts matched the keyword in the requested language.',
+            recovery: 'Try a broader or simpler term, or retry with language "en" for wider coverage.',
+        },
+    ],
+    async handler(input, ctx) {
+        const svc = getCellarSparqlService();
+        const keyword = input.keyword.toLowerCase().trim();
+        const lang = input.language.toLowerCase().trim() || 'en';
+        const limit = input.limit;
+        const sparql = `
+SELECT ?concept ?label ?code ?broaderLabel WHERE {
+  ?concept a skos:Concept .
+  ?concept skos:prefLabel ?label .
+  OPTIONAL { ?concept skos:notation ?code . }
+  OPTIONAL {
+    ?concept skos:broader ?broader .
+    ?broader skos:prefLabel ?broaderLabel .
+    FILTER(LANG(?broaderLabel) = "${lang}")
+  }
+  FILTER(LANG(?label) = "${lang}")
+  FILTER(CONTAINS(LCASE(STR(?label)), "${keyword.replace(/"/g, '\\"')}"))
+} LIMIT ${limit}`;
+        const bindings = await svc.query(sparql, ctx);
+        ctx.log.info('EuroVoc subject browse', {
+            keyword,
+            language: lang,
+            resultCount: bindings.length,
+        });
+        if (bindings.length === 0) {
+            throw ctx.fail('no_concepts', `No EuroVoc concepts found for "${input.keyword}" in language "${lang}"`, {
+                ...ctx.recoveryFor('no_concepts'),
+            });
+        }
+        const concepts = bindings.map((b) => {
+            const entry = {
+                concept_uri: CellarSparqlService.bindingValue(b, 'concept') ?? '',
+                pref_label: CellarSparqlService.bindingValue(b, 'label') ?? '',
+            };
+            const code = CellarSparqlService.bindingValue(b, 'code');
+            if (code)
+                entry.concept_code = code;
+            const broaderLabel = CellarSparqlService.bindingValue(b, 'broaderLabel');
+            if (broaderLabel)
+                entry.broader_label = broaderLabel;
+            return entry;
+        });
+        return { concepts, total: concepts.length };
+    },
+    format: (result) => {
+        const lines = [`## EuroVoc Concepts (${result.total} found)\n`];
+        for (const c of result.concepts) {
+            lines.push(`### ${c.pref_label}`);
+            lines.push(`**URI:** ${c.concept_uri}`);
+            if (c.concept_code)
+                lines.push(`**Code:** ${c.concept_code}`);
+            if (c.broader_label)
+                lines.push(`**Broader:** ${c.broader_label}`);
+            lines.push('');
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=eurlex-browse-subjects.tool.js.map

package/dist/mcp-server/tools/definitions/eurlex-browse-subjects.tool.js.map

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

package/dist/mcp-server/tools/definitions/eurlex-get-cases.tool.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @fileoverview eurlex_get_cases — Search CJEU and General Court case law.
+ * @module mcp-server/tools/definitions/eurlex-get-cases
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const eurlex_get_cases: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    case_number: z.ZodOptional<z.ZodString>;
+    keyword: z.ZodOptional<z.ZodString>;
+    court: z.ZodOptional<z.ZodEnum<{
+        CJEU: "CJEU";
+        GC: "GC";
+    }>>;
+    case_type: z.ZodOptional<z.ZodEnum<{
+        judgment: "judgment";
+        order: "order";
+        ag_opinion: "ag_opinion";
+    }>>;
+    date_from: z.ZodOptional<z.ZodString>;
+    date_to: z.ZodOptional<z.ZodString>;
+    offset: z.ZodDefault<z.ZodNumber>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    cases: z.ZodArray<z.ZodObject<{
+        work_uri: z.ZodString;
+        celex_number: z.ZodString;
+        resource_type: z.ZodOptional<z.ZodString>;
+        date: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+    offset: z.ZodNumber;
+}, z.core.$strip>, readonly [{
+    readonly reason: "no_results";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The query returned zero bindings — no matching cases in CELLAR sector 6.";
+    readonly recovery: "Try a different keyword, broader date range, or remove the court/case_type filter.";
+}, {
+    readonly reason: "sparql_error";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "Virtuoso returned HTTP 200 with an error body — query malformed or timed out.";
+    readonly recovery: "Simplify the query or reduce the date range and retry.";
+}], undefined>;
+//# sourceMappingURL=eurlex-get-cases.tool.d.ts.map

package/dist/mcp-server/tools/definitions/eurlex-get-cases.tool.d.ts.map

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

package/dist/mcp-server/tools/definitions/eurlex-get-cases.tool.js

@@ -0,0 +1,189 @@
+/**
+ * @fileoverview eurlex_get_cases — Search CJEU and General Court case law.
+ * @module mcp-server/tools/definitions/eurlex-get-cases
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { CellarSparqlService, getCellarSparqlService, } from '../../../services/cellar-sparql/cellar-sparql-service.js';
+/** Case type to CELEX type substring mapping. */
+const CASE_TYPE_PATTERN = {
+    judgment: 'CJ',
+    order: 'CO',
+    ag_opinion: 'CC',
+};
+export const eurlex_get_cases = tool('eurlex_get_cases', {
+    title: 'Search CJEU/GC Case Law',
+    description: 'Search CJEU (Court of Justice of the EU) and General Court case law — judgments, orders, and Advocate General opinions. ' +
+        'Distinct from eurlex_search_documents because case law uses CELEX sector 6 and practitioners search it differently: ' +
+        'by case number, court, party name, or AG opinion type. ' +
+        'Keyword search applies to case titles and CELEX strings only — full-text body search is not available. ' +
+        'Case numbers follow the pattern C-{num}/{year} for CJEU and T-{num}/{year} for General Court. ' +
+        'Returns case identifier, court, date, document type, and title (where available). ' +
+        'Use eurlex_get_document with the CELEX number to fetch the full judgment text.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        case_number: z
+            .string()
+            .optional()
+            .describe('Case number in standard format: C-{num}/{year} for CJEU or T-{num}/{year} for General Court (e.g. C-131/12).'),
+        keyword: z
+            .string()
+            .optional()
+            .describe('Keyword to match against case titles and CELEX strings.'),
+        court: z
+            .enum(['CJEU', 'GC'])
+            .optional()
+            .describe('Court filter: CJEU = Court of Justice of the EU, GC = General Court.'),
+        case_type: z
+            .enum(['judgment', 'order', 'ag_opinion'])
+            .optional()
+            .describe('Case type filter: judgment, order (procedural decision), or ag_opinion (Advocate General opinion).'),
+        date_from: z
+            .string()
+            .regex(/^\d{4}-\d{2}-\d{2}$/)
+            .optional()
+            .describe('Start of date range in ISO 8601 format (YYYY-MM-DD).'),
+        date_to: z
+            .string()
+            .regex(/^\d{4}-\d{2}-\d{2}$/)
+            .optional()
+            .describe('End of date range in ISO 8601 format (YYYY-MM-DD).'),
+        offset: z
+            .number()
+            .int()
+            .min(0)
+            .default(0)
+            .describe('Pagination offset — number of results to skip. Defaults to 0.'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(100)
+            .default(20)
+            .describe('Maximum number of results to return (1–100). Defaults to 20.'),
+    }),
+    output: z.object({
+        cases: z
+            .array(z
+            .object({
+            work_uri: z.string().describe('CELLAR work URI.'),
+            celex_number: z.string().describe('CELEX identifier for the case (e.g. 62024CJ0629).'),
+            resource_type: z
+                .string()
+                .optional()
+                .describe('CDM resource type URI indicating the case type (e.g. .../resource-type/JUDG for Judgment). Absent for some older cases.'),
+            date: z.string().optional().describe('Judgment/opinion date in ISO 8601 format.'),
+            title: z
+                .string()
+                .optional()
+                .describe('Case title where available (e.g. "Google Spain SL v AEPD"). Absent for many older cases.'),
+        })
+            .describe('A single CJEU or General Court case law record.'))
+            .describe('Matching case law records ordered by date descending.'),
+        total: z.number().describe('Number of cases returned in this page (not a corpus-wide count).'),
+        offset: z.number().describe('Pagination offset used for this response.'),
+    }),
+    errors: [
+        {
+            reason: 'no_results',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The query returned zero bindings — no matching cases in CELLAR sector 6.',
+            recovery: 'Try a different keyword, broader date range, or remove the court/case_type filter.',
+        },
+        {
+            reason: 'sparql_error',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'Virtuoso returned HTTP 200 with an error body — query malformed or timed out.',
+            recovery: 'Simplify the query or reduce the date range and retry.',
+        },
+    ],
+    async handler(input, ctx) {
+        const svc = getCellarSparqlService();
+        // All case law is in CELEX sector 6
+        const filters = [`FILTER(STRSTARTS(STR(?celexNumber), "6"))`];
+        if (input.case_number && input.case_number.trim()) {
+            // Convert standard case number format to CELEX substring
+            // e.g. C-131/12 → search for "131" and "12" in celex
+            const cn = input.case_number.trim().replace(/"/g, '\\"');
+            filters.push(`FILTER(CONTAINS(LCASE(STR(?title)), LCASE("${cn}")) || CONTAINS(LCASE(STR(?celexNumber)), LCASE("${cn}")))`);
+        }
+        if (input.keyword && input.keyword.trim()) {
+            const kw = input.keyword.trim().toLowerCase().replace(/"/g, '\\"');
+            filters.push(`FILTER(CONTAINS(LCASE(COALESCE(STR(?title), "")), "${kw}") || CONTAINS(LCASE(STR(?celexNumber)), "${kw}"))`);
+        }
+        if (input.court === 'CJEU') {
+            // CJEU cases have CELEX pattern 6{year}CJ or 6{year}CC (AG opinions)
+            filters.push(`FILTER(CONTAINS(STR(?celexNumber), "CJ") || CONTAINS(STR(?celexNumber), "CC") || CONTAINS(STR(?celexNumber), "CO"))`);
+        }
+        else if (input.court === 'GC') {
+            // General Court cases have pattern 6{year}TJ
+            filters.push(`FILTER(CONTAINS(STR(?celexNumber), "TJ") || CONTAINS(STR(?celexNumber), "TO"))`);
+        }
+        if (input.case_type) {
+            const pattern = CASE_TYPE_PATTERN[input.case_type];
+            if (pattern) {
+                filters.push(`FILTER(CONTAINS(STR(?celexNumber), "${pattern}"))`);
+            }
+        }
+        if (input.date_from && input.date_from.trim()) {
+            filters.push(`FILTER(?date >= "${input.date_from.trim()}"^^xsd:date)`);
+        }
+        if (input.date_to && input.date_to.trim()) {
+            filters.push(`FILTER(?date <= "${input.date_to.trim()}"^^xsd:date)`);
+        }
+        const sparql = `
+SELECT DISTINCT ?work ?celexNumber ?type ?date ?title WHERE {
+  ?work cdm:resource_legal_id_celex ?celexNumber .
+  OPTIONAL { ?work cdm:work_has_resource-type ?type . }
+  OPTIONAL { ?work cdm:work_date_document ?date . }
+  OPTIONAL { ?work cdm:work_title ?titleNode . ?titleNode cdm:expression_title ?title . FILTER(LANG(?title) = "en") }
+  ${filters.join('\n  ')}
+} ORDER BY DESC(?date) LIMIT ${input.limit} OFFSET ${input.offset}`;
+        const bindings = await svc.query(sparql, ctx);
+        ctx.log.info('Case law search', {
+            caseNumber: input.case_number,
+            keyword: input.keyword,
+            court: input.court,
+            caseType: input.case_type,
+            resultCount: bindings.length,
+        });
+        if (bindings.length === 0) {
+            throw ctx.fail('no_results', 'No case law records matched the search criteria.', {
+                ...ctx.recoveryFor('no_results'),
+            });
+        }
+        const cases = bindings.map((b) => {
+            const c = {
+                work_uri: CellarSparqlService.bindingValue(b, 'work') ?? '',
+                celex_number: CellarSparqlService.bindingValue(b, 'celexNumber') ?? '',
+            };
+            const type = CellarSparqlService.bindingValue(b, 'type');
+            if (type)
+                c.resource_type = type;
+            const date = CellarSparqlService.bindingValue(b, 'date');
+            if (date)
+                c.date = date;
+            const title = CellarSparqlService.bindingValue(b, 'title');
+            if (title)
+                c.title = title;
+            return c;
+        });
+        return { cases, total: cases.length, offset: input.offset };
+    },
+    format: (result) => {
+        const lines = [
+            `## CJEU/GC Case Law (${result.total} results, offset ${result.offset})\n`,
+        ];
+        for (const c of result.cases) {
+            lines.push(`### ${c.celex_number}${c.title ? ` — ${c.title}` : ''}`);
+            if (c.date)
+                lines.push(`**Date:** ${c.date}`);
+            if (c.resource_type)
+                lines.push(`**Type:** ${c.resource_type}`);
+            lines.push(`**Work URI:** ${c.work_uri}`);
+            lines.push('');
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=eurlex-get-cases.tool.js.map

package/dist/mcp-server/tools/definitions/eurlex-get-cases.tool.js.map

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

package/dist/mcp-server/tools/definitions/eurlex-get-document.tool.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @fileoverview eurlex_get_document — Fetch metadata and full text of an EU act by CELEX number.
+ * @module mcp-server/tools/definitions/eurlex-get-document
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const eurlex_get_document: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    celex_number: z.ZodString;
+    eli_uri: z.ZodOptional<z.ZodString>;
+    language: z.ZodDefault<z.ZodString>;
+    format: z.ZodDefault<z.ZodEnum<{
+        html: "html";
+        xml: "xml";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    celex_number: z.ZodString;
+    work_uri: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    date: z.ZodOptional<z.ZodString>;
+    resource_type: z.ZodOptional<z.ZodString>;
+    author_institution: z.ZodOptional<z.ZodString>;
+    legal_basis: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    eurovoc_subjects: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    in_force: z.ZodOptional<z.ZodBoolean>;
+    content: z.ZodOptional<z.ZodString>;
+    content_available: z.ZodBoolean;
+    language: z.ZodString;
+    language_fallback: z.ZodOptional<z.ZodString>;
+    content_format: z.ZodString;
+}, z.core.$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "CELEX number not found in CELLAR — the work does not exist in the corpus.";
+    readonly recovery: "Verify the CELEX number or use eurlex_lookup_celex to confirm it exists.";
+}, {
+    readonly reason: "language_unavailable";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "Requested language has no content in EUR-Lex after fallback to English also failed.";
+    readonly recovery: "Retry with language \"EN\" explicitly, or accept content_available: false and use metadata only.";
+}, {
+    readonly reason: "content_fetch_failed";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "EUR-Lex content API returned non-200 after language fallback attempts.";
+    readonly recovery: "The EUR-Lex content API may be temporarily unavailable. Retry after a short delay.";
+}], undefined>;
+//# sourceMappingURL=eurlex-get-document.tool.d.ts.map

package/dist/mcp-server/tools/definitions/eurlex-get-document.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eurlex-get-document.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/eurlex-get-document.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAWjE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAqP9B,CAAC"}

package/dist/mcp-server/tools/definitions/eurlex-get-document.tool.js

@@ -0,0 +1,222 @@
+/**
+ * @fileoverview eurlex_get_document — Fetch metadata and full text of an EU act by CELEX number.
+ * @module mcp-server/tools/definitions/eurlex-get-document
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { CellarSparqlService, getCellarSparqlService, } from '../../../services/cellar-sparql/cellar-sparql-service.js';
+import { getEurLexContentService, } from '../../../services/eurlex-content/eurlex-content-service.js';
+export const eurlex_get_document = tool('eurlex_get_document', {
+    title: 'Get EU Document',
+    description: 'Fetch the notice (metadata) and full text of an EU act by CELEX number or ELI URI. ' +
+        'Returns structured metadata — title, date, document type, author institution, legal basis, EuroVoc subjects — ' +
+        'plus the HTML or Formex4 XML content in the requested language. ' +
+        'Defaults to English (EN); not all works have content in all 24 official EU languages, ' +
+        'especially older acts pre-2004 EU enlargement. ' +
+        'If the requested language is unavailable, the server automatically falls back to English and notes the fallback. ' +
+        'CELEX format: {sector}{year}{type}{number} e.g. 32016R0679 for GDPR. ' +
+        'Use eurlex_lookup_celex to validate an identifier before calling this tool. ' +
+        'HTML format returns the full act text suitable for reading; XML returns Formex4 for structured processing.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        celex_number: z
+            .string()
+            .min(1)
+            .describe('CELEX number of the act to fetch (e.g. 32016R0679 for GDPR). Preferred over eli_uri.'),
+        eli_uri: z
+            .string()
+            .optional()
+            .describe('ELI URI as alternative to celex_number (e.g. http://data.europa.eu/eli/reg/2016/679/oj). Used only if celex_number is absent or empty.'),
+        language: z
+            .string()
+            .regex(/^[A-Za-z]{2,3}$/)
+            .default('EN')
+            .describe('Language code for document content (ISO 639-1 uppercase, e.g. EN, FR, DE). ' +
+            'Defaults to EN. Falls back to EN if the requested language is unavailable.'),
+        format: z
+            .enum(['html', 'xml'])
+            .default('html')
+            .describe('Content format: "html" for readable HTML text (default), "xml" for Formex4 XML structured format.'),
+    }),
+    output: z.object({
+        celex_number: z.string().describe('Confirmed CELEX number for the retrieved work.'),
+        work_uri: z.string().optional().describe('CELLAR work URI.'),
+        title: z
+            .string()
+            .optional()
+            .describe('Document title in the requested language (absent for some older works and judgments).'),
+        date: z.string().optional().describe('Document date in ISO 8601 format (YYYY-MM-DD).'),
+        resource_type: z
+            .string()
+            .optional()
+            .describe('CDM resource type URI indicating the document category (e.g. .../resource-type/REG for Regulation). Absent for some older works.'),
+        author_institution: z
+            .string()
+            .optional()
+            .describe('URI of the originating EU institution in the CDM authority register. Resolve against eurlex_query_sparql for a human-readable label.'),
+        legal_basis: z
+            .array(z.string().describe('CELEX number or URI of a legal basis act.'))
+            .optional()
+            .describe('Legal basis acts for this work.'),
+        eurovoc_subjects: z
+            .array(z.string().describe('EuroVoc concept URI.'))
+            .optional()
+            .describe('EuroVoc subject classifications.'),
+        in_force: z.boolean().optional().describe('Whether the act is currently in force.'),
+        content: z
+            .string()
+            .optional()
+            .describe('Full text content of the act in the requested format and language.'),
+        content_available: z.boolean().describe('Whether document content was successfully retrieved.'),
+        language: z.string().describe('Language code of the returned content.'),
+        language_fallback: z
+            .string()
+            .optional()
+            .describe('Human-readable note explaining the fallback that occurred (e.g. "Requested FR content unavailable; returned EN"). Present only when a fallback happened.'),
+        content_format: z.string().describe('Format of the returned content: "html" or "xml".'),
+    }),
+    errors: [
+        {
+            reason: 'not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'CELEX number not found in CELLAR — the work does not exist in the corpus.',
+            recovery: 'Verify the CELEX number or use eurlex_lookup_celex to confirm it exists.',
+        },
+        {
+            reason: 'language_unavailable',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'Requested language has no content in EUR-Lex after fallback to English also failed.',
+            recovery: 'Retry with language "EN" explicitly, or accept content_available: false and use metadata only.',
+        },
+        {
+            reason: 'content_fetch_failed',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'EUR-Lex content API returned non-200 after language fallback attempts.',
+            recovery: 'The EUR-Lex content API may be temporarily unavailable. Retry after a short delay.',
+        },
+    ],
+    async handler(input, ctx) {
+        const sparqlSvc = getCellarSparqlService();
+        const contentSvc = getEurLexContentService();
+        const celexNumber = input.celex_number.trim();
+        const language = (input.language.trim().toUpperCase() || 'EN');
+        const format = input.format;
+        const safeCelexNumber = celexNumber.replace(/"/g, '\\"');
+        // Step 1: Fetch metadata via SPARQL
+        const metaSparql = `
+SELECT ?work ?celexNumber ?type ?date ?title ?inForce ?author ?legalBasis ?eurovoc WHERE {
+  ?work cdm:resource_legal_id_celex ?celexNumber .
+  FILTER(STR(?celexNumber) = "${safeCelexNumber}")
+  OPTIONAL { ?work cdm:work_has_resource-type ?type . }
+  OPTIONAL { ?work cdm:work_date_document ?date . }
+  OPTIONAL { ?work cdm:work_title ?titleNode . ?titleNode cdm:expression_title ?title . FILTER(LANG(?title) = "en") }
+  OPTIONAL { ?work cdm:resource_legal_in-force ?inForce . }
+  OPTIONAL { ?work cdm:work_created_by_agent ?author . }
+  OPTIONAL { ?work cdm:resource_legal_based_on_resource_legal ?legalBasis . }
+  OPTIONAL { ?work cdm:work_is_about_concept_eurovoc ?eurovoc . }
+} LIMIT 20`;
+        const metaBindings = await sparqlSvc.query(metaSparql, ctx);
+        ctx.log.info('Document metadata fetch', { celexNumber, resultCount: metaBindings.length });
+        if (metaBindings.length === 0) {
+            throw ctx.fail('not_found', `No CELLAR work found for CELEX: ${celexNumber}`, {
+                ...ctx.recoveryFor('not_found'),
+            });
+        }
+        // Aggregate repeated fields from multi-row result
+        const first = metaBindings[0];
+        const legalBases = new Set();
+        const eurovocConcepts = new Set();
+        for (const b of metaBindings) {
+            const lb = CellarSparqlService.bindingValue(b, 'legalBasis');
+            if (lb)
+                legalBases.add(lb);
+            const ev = CellarSparqlService.bindingValue(b, 'eurovoc');
+            if (ev)
+                eurovocConcepts.add(ev);
+        }
+        const workUri = CellarSparqlService.bindingValue(first, 'work');
+        const confirmedCelex = CellarSparqlService.bindingValue(first, 'celexNumber') ?? celexNumber;
+        const resourceType = CellarSparqlService.bindingValue(first, 'type');
+        const date = CellarSparqlService.bindingValue(first, 'date');
+        const title = CellarSparqlService.bindingValue(first, 'title');
+        const inForceStr = CellarSparqlService.bindingValue(first, 'inForce');
+        const inForce = inForceStr !== undefined ? inForceStr === 'true' : undefined;
+        const authorUri = CellarSparqlService.bindingValue(first, 'author');
+        // Step 2: Fetch document content via EUR-Lex content API
+        const contentResult = await contentSvc.fetchContent(celexNumber, language, format, ctx);
+        const result = {
+            celex_number: confirmedCelex,
+            content_available: contentResult.contentAvailable,
+            language: contentResult.language,
+            content_format: format,
+        };
+        if (workUri)
+            result.work_uri = workUri;
+        if (title)
+            result.title = title;
+        if (date)
+            result.date = date;
+        if (resourceType)
+            result.resource_type = resourceType;
+        if (authorUri)
+            result.author_institution = authorUri;
+        if (legalBases.size > 0)
+            result.legal_basis = [...legalBases];
+        if (eurovocConcepts.size > 0)
+            result.eurovoc_subjects = [...eurovocConcepts];
+        if (typeof inForce === 'boolean')
+            result.in_force = inForce;
+        if (contentResult.contentAvailable && contentResult.content) {
+            result.content = contentResult.content;
+        }
+        if (contentResult.languageFallback) {
+            result.language_fallback = contentResult.languageFallback;
+        }
+        return result;
+    },
+    format: (result) => {
+        const lines = [
+            `## ${result.celex_number}${result.title ? ` — ${result.title}` : ''}\n`,
+        ];
+        if (result.date)
+            lines.push(`**Date:** ${result.date}`);
+        if (result.resource_type)
+            lines.push(`**Type:** ${result.resource_type}`);
+        if (result.author_institution)
+            lines.push(`**Author:** ${result.author_institution}`);
+        if (typeof result.in_force === 'boolean')
+            lines.push(`**In Force:** ${result.in_force}`);
+        if (result.work_uri)
+            lines.push(`**Work URI:** ${result.work_uri}`);
+        if (result.legal_basis && result.legal_basis.length > 0) {
+            lines.push(`**Legal Basis:** ${result.legal_basis.join(', ')}`);
+        }
+        if (result.eurovoc_subjects && result.eurovoc_subjects.length > 0) {
+            lines.push(`**EuroVoc Subjects:** ${result.eurovoc_subjects.slice(0, 5).join(', ')}${result.eurovoc_subjects.length > 5 ? ` (+${result.eurovoc_subjects.length - 5} more)` : ''}`);
+        }
+        lines.push(`**Language:** ${result.language} | **Format:** ${result.content_format}`);
+        if (result.language_fallback)
+            lines.push(`*Note: ${result.language_fallback}*`);
+        lines.push(`**Content Available:** ${result.content_available}`);
+        if (result.content_available && result.content) {
+            lines.push('');
+            lines.push('---');
+            lines.push('');
+            // Truncate very large content for format() output
+            const maxLen = 8000;
+            if (result.content.length > maxLen) {
+                lines.push(result.content.slice(0, maxLen));
+                lines.push(`\n*[Content truncated — ${result.content.length} chars total. Use the CELEX number to fetch directly.]*`);
+            }
+            else {
+                lines.push(result.content);
+            }
+        }
+        else if (!result.content_available) {
+            lines.push('');
+            lines.push('*Document content is not available for this work in the requested language.*');
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=eurlex-get-document.tool.js.map