@cyanheads/eur-lex-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/eurlex-search-documents.tool.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @fileoverview eurlex_search_documents — Search EU legislation, case law, and preparatory acts.
+ * @module mcp-server/tools/definitions/eurlex-search-documents
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const eurlex_search_documents: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    keyword: z.ZodOptional<z.ZodString>;
+    document_type: z.ZodOptional<z.ZodEnum<{
+        REG: "REG";
+        DIR: "DIR";
+        DEC: "DEC";
+        TREATY: "TREATY";
+        JUDG: "JUDG";
+        OPIN_AG: "OPIN_AG";
+        PROP: "PROP";
+        REC: "REC";
+    }>>;
+    date_from: z.ZodOptional<z.ZodString>;
+    date_to: z.ZodOptional<z.ZodString>;
+    eurovoc_concept: z.ZodOptional<z.ZodString>;
+    author_institution: z.ZodOptional<z.ZodString>;
+    in_force: z.ZodOptional<z.ZodBoolean>;
+    offset: z.ZodDefault<z.ZodNumber>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    documents: 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 documents in CELLAR.";
+    readonly recovery: "Broaden the search by removing filters, trying a shorter keyword, or expanding the date range.";
+}, {
+    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-search-documents.tool.d.ts.map

package/dist/mcp-server/tools/definitions/eurlex-search-documents.tool.d.ts.map

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

package/dist/mcp-server/tools/definitions/eurlex-search-documents.tool.js

@@ -0,0 +1,203 @@
+/**
+ * @fileoverview eurlex_search_documents — Search EU legislation, case law, and preparatory acts.
+ * @module mcp-server/tools/definitions/eurlex-search-documents
+ */
+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';
+/** CDM resource type URIs for common document categories. */
+const DOCUMENT_TYPE_URIS = {
+    REG: 'http://publications.europa.eu/resource/authority/resource-type/REG',
+    DIR: 'http://publications.europa.eu/resource/authority/resource-type/DIR',
+    DEC: 'http://publications.europa.eu/resource/authority/resource-type/DEC',
+    TREATY: 'http://publications.europa.eu/resource/authority/resource-type/TREATY',
+    JUDG: 'http://publications.europa.eu/resource/authority/resource-type/JUDG',
+    OPIN_AG: 'http://publications.europa.eu/resource/authority/resource-type/OPIN_AG',
+    PROP: 'http://publications.europa.eu/resource/authority/resource-type/PROP_DIR',
+    REC: 'http://publications.europa.eu/resource/authority/resource-type/REC_SOFT',
+};
+export const eurlex_search_documents = tool('eurlex_search_documents', {
+    title: 'Search EU Documents',
+    description: 'Search EU legislation, treaties, and preparatory acts across the CELLAR corpus of 2.7M+ works. ' +
+        'Filters by document type, date range, EuroVoc subject concept, author institution, and in-force status. ' +
+        'Keyword search applies to document titles and CELEX strings only — full-text body search is not available via this API. ' +
+        'For multi-word searches, supply a single dominant keyword; use other filters to narrow results. ' +
+        'Returns CELEX numbers, work URIs, document types, and dates — use these with eurlex_get_document to fetch full content. ' +
+        'To filter by EuroVoc subject, first call eurlex_browse_subjects to obtain the concept URI. ' +
+        'Case law (CJEU/GC judgments) is better searched via eurlex_get_cases which has court-specific parameters.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        keyword: z
+            .string()
+            .optional()
+            .describe('Keyword to match against document titles. Single dominant word recommended; multi-word phrase uses substring match.'),
+        document_type: z
+            .enum(['REG', 'DIR', 'DEC', 'TREATY', 'JUDG', 'OPIN_AG', 'PROP', 'REC'])
+            .optional()
+            .describe('Document type filter: REG=Regulation, DIR=Directive, DEC=Decision, TREATY=Treaty, ' +
+            'JUDG=Judgment, OPIN_AG=AG Opinion, PROP=Proposal, REC=Recommendation.'),
+        date_from: z
+            .string()
+            .regex(/^\d{4}-\d{2}-\d{2}$/)
+            .optional()
+            .describe('Start of date range in ISO 8601 format (YYYY-MM-DD). Matches document date.'),
+        date_to: z
+            .string()
+            .regex(/^\d{4}-\d{2}-\d{2}$/)
+            .optional()
+            .describe('End of date range in ISO 8601 format (YYYY-MM-DD). Matches document date.'),
+        eurovoc_concept: z
+            .string()
+            .startsWith('http')
+            .refine((v) => !v.includes('>') && !v.includes('"') && !v.includes(' '), {
+            message: 'EuroVoc URI must be a valid http URI with no angle brackets, quotes, or spaces.',
+        })
+            .optional()
+            .describe('EuroVoc concept URI to filter by subject (e.g. http://eurovoc.europa.eu/2828). ' +
+            'Obtain concept URIs from eurlex_browse_subjects first.'),
+        author_institution: z
+            .string()
+            .optional()
+            .describe('Author institution name filter (e.g. "European Parliament", "Council"). Substring match.'),
+        in_force: z
+            .boolean()
+            .optional()
+            .describe('If true, restrict to acts currently in force. Omit to return all regardless of in-force status.'),
+        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({
+        documents: z
+            .array(z
+            .object({
+            work_uri: z.string().describe('CELLAR work URI (stable resource identifier).'),
+            celex_number: z.string().describe('CELEX identifier for the work.'),
+            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.'),
+            date: z.string().optional().describe('Document date in ISO 8601 format (YYYY-MM-DD).'),
+            title: z
+                .string()
+                .optional()
+                .describe('Document title in English where available; absent for many older works and judgments.'),
+        })
+            .describe('A single EU legislative work with its CELEX number, type, and date.'))
+            .describe('Matching EU documents ordered by date descending.'),
+        total: z
+            .number()
+            .describe('Number of documents 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 documents in CELLAR.',
+            recovery: 'Broaden the search by removing filters, trying a shorter keyword, or expanding the date range.',
+        },
+        {
+            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();
+        const filters = [];
+        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.document_type) {
+            const typeUri = DOCUMENT_TYPE_URIS[input.document_type];
+            if (typeUri) {
+                filters.push(`FILTER(?type = <${typeUri}>)`);
+            }
+        }
+        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)`);
+        }
+        if (input.in_force === true) {
+            filters.push(`FILTER(?inForce = true)`);
+        }
+        const eurovocClause = input.eurovoc_concept && input.eurovoc_concept.trim()
+            ? `?work cdm:work_is_about_concept_eurovoc <${input.eurovoc_concept.trim()}> .`
+            : '';
+        const authorClause = input.author_institution && input.author_institution.trim()
+            ? `OPTIONAL { ?work cdm:work_created_by_agent ?agent . ?agent cdm:corporate-body_label ?agentLabel . FILTER(LANG(?agentLabel) = "en") FILTER(CONTAINS(LCASE(STR(?agentLabel)), "${input.author_institution.trim().toLowerCase().replace(/"/g, '\\"')}")) }`
+            : '';
+        const inForceClause = input.in_force === true ? `OPTIONAL { ?work cdm:resource_legal_in-force ?inForce . }` : '';
+        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") }
+  ${eurovocClause}
+  ${authorClause}
+  ${inForceClause}
+  ${filters.join('\n  ')}
+} ORDER BY DESC(?date) LIMIT ${input.limit} OFFSET ${input.offset}`;
+        const bindings = await svc.query(sparql, ctx);
+        ctx.log.info('Document search', {
+            keyword: input.keyword,
+            documentType: input.document_type,
+            resultCount: bindings.length,
+            offset: input.offset,
+        });
+        if (bindings.length === 0) {
+            throw ctx.fail('no_results', 'No documents matched the search criteria.', {
+                ...ctx.recoveryFor('no_results'),
+            });
+        }
+        const documents = bindings.map((b) => {
+            const doc = {
+                work_uri: CellarSparqlService.bindingValue(b, 'work') ?? '',
+                celex_number: CellarSparqlService.bindingValue(b, 'celexNumber') ?? '',
+            };
+            const type = CellarSparqlService.bindingValue(b, 'type');
+            if (type)
+                doc.resource_type = type;
+            const date = CellarSparqlService.bindingValue(b, 'date');
+            if (date)
+                doc.date = date;
+            const title = CellarSparqlService.bindingValue(b, 'title');
+            if (title)
+                doc.title = title;
+            return doc;
+        });
+        return { documents, total: documents.length, offset: input.offset };
+    },
+    format: (result) => {
+        const lines = [
+            `## EU Documents (${result.total} results, offset ${result.offset})\n`,
+        ];
+        for (const doc of result.documents) {
+            lines.push(`### ${doc.celex_number}${doc.title ? ` — ${doc.title}` : ''}`);
+            if (doc.date)
+                lines.push(`**Date:** ${doc.date}`);
+            if (doc.resource_type)
+                lines.push(`**Type:** ${doc.resource_type}`);
+            lines.push(`**Work URI:** ${doc.work_uri}`);
+            lines.push('');
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=eurlex-search-documents.tool.js.map

package/dist/mcp-server/tools/definitions/eurlex-search-documents.tool.js.map

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

package/dist/mcp-server/tools/definitions/index.d.ts

@@ -0,0 +1,207 @@
+/**
+ * @fileoverview Barrel export for all EUR-Lex MCP tool definitions.
+ * @module mcp-server/tools/definitions/index
+ */
+export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    keyword: import("zod").ZodString;
+    language: import("zod").ZodDefault<import("zod").ZodString>;
+    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    concepts: import("zod").ZodArray<import("zod").ZodObject<{
+        concept_uri: import("zod").ZodString;
+        pref_label: import("zod").ZodString;
+        concept_code: import("zod").ZodOptional<import("zod").ZodString>;
+        broader_label: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+    total: import("zod").ZodNumber;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "no_concepts";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "No EuroVoc concepts matched the keyword in the requested language.";
+    readonly recovery: "Try a broader or simpler term, or retry with language \"en\" for wider coverage.";
+}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    case_number: import("zod").ZodOptional<import("zod").ZodString>;
+    keyword: import("zod").ZodOptional<import("zod").ZodString>;
+    court: import("zod").ZodOptional<import("zod").ZodEnum<{
+        CJEU: "CJEU";
+        GC: "GC";
+    }>>;
+    case_type: import("zod").ZodOptional<import("zod").ZodEnum<{
+        judgment: "judgment";
+        order: "order";
+        ag_opinion: "ag_opinion";
+    }>>;
+    date_from: import("zod").ZodOptional<import("zod").ZodString>;
+    date_to: import("zod").ZodOptional<import("zod").ZodString>;
+    offset: import("zod").ZodDefault<import("zod").ZodNumber>;
+    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    cases: import("zod").ZodArray<import("zod").ZodObject<{
+        work_uri: import("zod").ZodString;
+        celex_number: import("zod").ZodString;
+        resource_type: import("zod").ZodOptional<import("zod").ZodString>;
+        date: import("zod").ZodOptional<import("zod").ZodString>;
+        title: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+    total: import("zod").ZodNumber;
+    offset: import("zod").ZodNumber;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "no_results";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").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: import("@cyanheads/mcp-ts-core/errors").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> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    celex_number: import("zod").ZodString;
+    eli_uri: import("zod").ZodOptional<import("zod").ZodString>;
+    language: import("zod").ZodDefault<import("zod").ZodString>;
+    format: import("zod").ZodDefault<import("zod").ZodEnum<{
+        html: "html";
+        xml: "xml";
+    }>>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    celex_number: import("zod").ZodString;
+    work_uri: import("zod").ZodOptional<import("zod").ZodString>;
+    title: import("zod").ZodOptional<import("zod").ZodString>;
+    date: import("zod").ZodOptional<import("zod").ZodString>;
+    resource_type: import("zod").ZodOptional<import("zod").ZodString>;
+    author_institution: import("zod").ZodOptional<import("zod").ZodString>;
+    legal_basis: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    eurovoc_subjects: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    in_force: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    content: import("zod").ZodOptional<import("zod").ZodString>;
+    content_available: import("zod").ZodBoolean;
+    language: import("zod").ZodString;
+    language_fallback: import("zod").ZodOptional<import("zod").ZodString>;
+    content_format: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").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: import("@cyanheads/mcp-ts-core/errors").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: import("@cyanheads/mcp-ts-core/errors").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> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    celex_number: import("zod").ZodString;
+    work_uri: import("zod").ZodOptional<import("zod").ZodString>;
+    relation_types: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
+        cites: "cites";
+        amends: "amends";
+        amended_by: "amended_by";
+        legal_basis: "legal_basis";
+        consolidated_version: "consolidated_version";
+    }>>>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    celex_number: import("zod").ZodString;
+    work_uri: import("zod").ZodOptional<import("zod").ZodString>;
+    relations: import("zod").ZodArray<import("zod").ZodObject<{
+        relation_type: import("zod").ZodString;
+        direction: import("zod").ZodString;
+        related_work_uri: import("zod").ZodString;
+        related_celex_number: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+    total: import("zod").ZodNumber;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "CELEX/work URI not found in CELLAR — resolve the identifier with eurlex_lookup_celex first.";
+    readonly recovery: "Use eurlex_lookup_celex to confirm the CELEX number exists, then retry.";
+}, {
+    readonly reason: "no_relations";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "Work exists but has no CDM relations of the requested types.";
+    readonly recovery: "Try other relation_types or omit the filter to fetch all available relation types.";
+}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    identifier: import("zod").ZodString;
+    identifier_type: import("zod").ZodDefault<import("zod").ZodEnum<{
+        auto: "auto";
+        celex: "celex";
+        eli: "eli";
+        oj: "oj";
+    }>>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    found: import("zod").ZodBoolean;
+    work_uri: import("zod").ZodOptional<import("zod").ZodString>;
+    celex_number: import("zod").ZodOptional<import("zod").ZodString>;
+    resource_type: import("zod").ZodOptional<import("zod").ZodString>;
+    date: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "The identifier resolves to no CELLAR work — check the CELEX/ELI/OJ format and try again.";
+    readonly recovery: "Verify the CELEX number format or try eurlex_search_documents to find the work by keyword.";
+}, {
+    readonly reason: "ambiguous_identifier";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
+    readonly when: "identifier_type is \"auto\" and the identifier format could not be determined.";
+    readonly recovery: "Supply identifier_type explicitly as \"celex\", \"eli\", or \"oj\" to resolve the ambiguity.";
+}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    sparql_query: import("zod").ZodString;
+    timeout_hint: import("zod").ZodOptional<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    bindings: import("zod").ZodArray<import("zod").ZodObject<{}, import("zod/v4/core").$loose>>;
+    variables: import("zod").ZodArray<import("zod").ZodString>;
+    total: import("zod").ZodNumber;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "sparql_error";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
+    readonly when: "Virtuoso returned a syntax or semantic error — the query is malformed.";
+    readonly recovery: "Fix the SPARQL query syntax, ensure predicates use the cdm: prefix, and verify variable names.";
+}, {
+    readonly reason: "sparql_timeout";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "Query exceeded the 60-second Virtuoso hard limit.";
+    readonly recovery: "Add more specific FILTER conditions, reduce the scope, or use LIMIT with a smaller value.";
+}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    keyword: import("zod").ZodOptional<import("zod").ZodString>;
+    document_type: import("zod").ZodOptional<import("zod").ZodEnum<{
+        REG: "REG";
+        DIR: "DIR";
+        DEC: "DEC";
+        TREATY: "TREATY";
+        JUDG: "JUDG";
+        OPIN_AG: "OPIN_AG";
+        PROP: "PROP";
+        REC: "REC";
+    }>>;
+    date_from: import("zod").ZodOptional<import("zod").ZodString>;
+    date_to: import("zod").ZodOptional<import("zod").ZodString>;
+    eurovoc_concept: import("zod").ZodOptional<import("zod").ZodString>;
+    author_institution: import("zod").ZodOptional<import("zod").ZodString>;
+    in_force: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    offset: import("zod").ZodDefault<import("zod").ZodNumber>;
+    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    documents: import("zod").ZodArray<import("zod").ZodObject<{
+        work_uri: import("zod").ZodString;
+        celex_number: import("zod").ZodString;
+        resource_type: import("zod").ZodOptional<import("zod").ZodString>;
+        date: import("zod").ZodOptional<import("zod").ZodString>;
+        title: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+    total: import("zod").ZodNumber;
+    offset: import("zod").ZodNumber;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "no_results";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "The query returned zero bindings — no matching documents in CELLAR.";
+    readonly recovery: "Broaden the search by removing filters, trying a shorter keyword, or expanding the date range.";
+}, {
+    readonly reason: "sparql_error";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").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=index.d.ts.map

package/dist/mcp-server/tools/definitions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQ9B,CAAC"}

package/dist/mcp-server/tools/definitions/index.js

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Barrel export for all EUR-Lex MCP tool definitions.
+ * @module mcp-server/tools/definitions/index
+ */
+import { eurlex_browse_subjects } from './eurlex-browse-subjects.tool.js';
+import { eurlex_get_cases } from './eurlex-get-cases.tool.js';
+import { eurlex_get_document } from './eurlex-get-document.tool.js';
+import { eurlex_get_relations } from './eurlex-get-relations.tool.js';
+import { eurlex_lookup_celex } from './eurlex-lookup-celex.tool.js';
+import { eurlex_query_sparql } from './eurlex-query-sparql.tool.js';
+import { eurlex_search_documents } from './eurlex-search-documents.tool.js';
+export const allToolDefinitions = [
+    eurlex_lookup_celex,
+    eurlex_browse_subjects,
+    eurlex_search_documents,
+    eurlex_get_cases,
+    eurlex_get_document,
+    eurlex_get_relations,
+    eurlex_query_sparql,
+];
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/tools/definitions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAE5E,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,mBAAmB;IACnB,sBAAsB;IACtB,uBAAuB;IACvB,gBAAgB;IAChB,mBAAmB;IACnB,oBAAoB;IACpB,mBAAmB;CACpB,CAAC"}

package/dist/services/cellar-sparql/cellar-sparql-service.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview CellarSparqlService — HTTP client for the EU Publications Office CELLAR
+ * Virtuoso SPARQL endpoint. Handles POST queries, LIMIT enforcement, and Virtuoso-specific
+ * error detection (HTTP 200 with error body).
+ * @module services/cellar-sparql/cellar-sparql-service
+ */
+import type { Context } from '@cyanheads/mcp-ts-core';
+import type { AppConfig } from '@cyanheads/mcp-ts-core/config';
+import type { StorageService } from '@cyanheads/mcp-ts-core/storage';
+import type { ServerConfig } from '../../config/server-config.js';
+import type { SparqlBinding } from './types.js';
+export declare class CellarSparqlService {
+    private readonly endpoint;
+    private readonly timeoutMs;
+    private readonly maxResults;
+    constructor(_config: AppConfig, _storage: StorageService, serverConfig: ServerConfig);
+    /**
+     * Execute a raw SPARQL SELECT query. Prefixes are prepended automatically
+     * if not already present. LIMIT is injected/capped at `maxResults`.
+     */
+    query(rawQuery: string, ctx: Context): Promise<SparqlBinding[]>;
+    /** Extract a string value from a binding field, returning undefined if absent. */
+    static bindingValue(binding: SparqlBinding | undefined, field: string): string | undefined;
+}
+export declare function initCellarSparqlService(config: AppConfig, storage: StorageService, serverConfig: ServerConfig): void;
+export declare function getCellarSparqlService(): CellarSparqlService;
+//# sourceMappingURL=cellar-sparql-service.d.ts.map

package/dist/services/cellar-sparql/cellar-sparql-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cellar-sparql-service.d.ts","sourceRoot":"","sources":["../../../src/services/cellar-sparql/cellar-sparql-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAErE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAqB,MAAM,YAAY,CAAC;AA8BnE,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY;IAMpF;;;OAGG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAuErE,kFAAkF;IAClF,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAG3F;AAMD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,YAAY,GACzB,IAAI,CAEN;AAED,wBAAgB,sBAAsB,IAAI,mBAAmB,CAO5D"}