@cyanheads/eur-lex-mcp-server 0.1.1

package/changelog/template.md

@@ -0,0 +1,127 @@
+---
+# FORMAT REFERENCE — do not edit. Copy this file to
+# `changelog/<major.minor>.x/<version>.md` (e.g. `changelog/0.8.x/0.8.6.md`)
+# to author a new release. Set that file's H1 to `# <version> — YYYY-MM-DD`
+# with a concrete date.
+
+# Required. One-line GitHub Release-style headline. 350 character cap.
+# Default short and scannable. Don't pad, don't stitch unrelated changes with
+# semicolons — pick the headline. Quotes required: unquoted YAML treats `: `
+# inside the value as a key separator and fails GitHub's strict parser.
+summary: ""
+
+# Set `true` when consumers must change code to upgrade: API removals,
+# signature changes, config renames, behavior changes that break existing
+# usage. Flagged as `Breaking` in the rollup.
+breaking: false
+
+# Set `true` if this release contains any security fix. Pairs with the
+# `## Security` section below. Flagged as `Security` in the rollup so
+# users can triage upgrade urgency at a glance.
+security: false
+
+# Optional free-form notes for maintenance agents processing this release.
+# Not rendered in CHANGELOG — consumed by agents running `maintenance` on
+# downstream servers. Use for adoption instructions that don't fit the
+# human-facing sections: new files to create, fields to populate, one-time
+# migration steps. Omit the field entirely when there's nothing to say.
+# agent-notes: |
+#   <instructions for downstream maintenance agents>
+---
+
+# <version> — YYYY-MM-DD
+
+<!--
+  AUTHORING GUIDE — applies to the new per-version file you create from this
+  template.
+
+  Audience: someone scanning release notes to decide what affects them. Lead
+  each bullet with the symbol or concept name in **bold** so they can skip
+  what's irrelevant and zoom in on what's not.
+
+  Tone: terse, fact-dense, not verbose. Default to one sentence per bullet —
+  name the symbol, state what changed, stop. Use a second sentence only when
+  it carries weight. If a bullet feels long, it is.
+
+  Cut: mechanism walkthroughs (those belong in JSDoc, CLAUDE.md/AGENTS.md, or the
+  relevant skill), ceremonial framings ("This release introduces…",
+  backwards-compat paragraphs), file-by-file test enumerations, internal
+  implementation notes. Prefer code/symbol names over English re-explanations.
+
+  Narrative intro: skip by default. Add one short sentence only when the
+  release theme genuinely needs framing the bullets can't carry.
+
+  Sections: Keep a Changelog order — Added, Changed, Deprecated, Removed,
+  Fixed, Security. Include only sections with entries; delete the rest
+  (including the commented-out scaffolding below). Don't ship empty headers.
+
+  Include: every distinct fact a reader needs to adopt or audit the release —
+  new exports, signatures, lint rule IDs, env vars, breaking changes, version
+  bumps on shipped skills. Nothing more.
+
+  Links: link issues, PRs, docs, or skills where they help a reader jump to
+  context. Once per item per entry — don't re-link the same issue in summary,
+  narrative, and bullet. Skip links for inline symbol names; code spans speak
+  for themselves.
+
+  Issue/PR URLs: use full URLs. GitHub's bare `#NN` auto-link only resolves
+  inside its own UI, not in npm reads or local editors.
+
+      [#38](https://github.com/cyanheads/mcp-ts-core/issues/38)   ← issue
+      [#42](https://github.com/cyanheads/mcp-ts-core/pull/42)     ← PR
+
+  Verify numbers exist before linking (`gh issue view NN`, `gh pr view NN`).
+  Never speculate on a future number — `#42` for an upcoming PR silently
+  resolves to whatever real item already owns 42, and timeline previews pull
+  in that unrelated item's metadata.
+
+  TAG ANNOTATIONS — the annotated tag body renders as the GitHub Release body
+  via `gh release create --notes-from-tag`. The tag is a derivative of this
+  changelog entry — a condensed, scannable version, not a copy. Format:
+
+    <theme — omit version number, GitHub prepends it>
+                                                          ← blank line
+    <1-2 sentence context: what this release does>
+                                                          ← blank line
+    Dependency bumps:                                     ← section header
+                                                          ← blank line
+    - `@cyanheads/mcp-ts-core` ^0.9.1 → ^0.9.6          ← bullet
+                                                          ← blank line
+    Changed:                                              ← only sections with entries
+                                                          ← blank line
+    - `format()` output includes `query` in text mode
+                                                          ← blank line
+    Added:
+                                                          ← blank line
+    - `manifest.json` scaffolded for MCPB bundle support
+    - Install badges (Claude Desktop, Cursor, VS Code)
+                                                          ← blank line
+    <N> tests pass; `bun run devcheck` clean.             ← footer
+
+  Never a flat comma-separated string. Always structured markdown with
+  sections. The tag must scan well as a rendered GitHub Release page.
+-->
+
+## Added
+
+-
+
+## Changed
+
+-
+
+<!-- ## Deprecated
+
+- -->
+
+<!-- ## Removed
+
+- -->
+
+## Fixed
+
+-
+
+<!-- ## Security
+
+- -->

package/dist/config/server-config.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview Server-specific configuration for eur-lex-mcp-server.
+ * Parses environment variables for CELLAR SPARQL and EUR-Lex content API settings.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+declare const ServerConfigSchema: z.ZodObject<{
+    cellarSparqlEndpoint: z.ZodDefault<z.ZodString>;
+    eurLexContentBaseUrl: z.ZodDefault<z.ZodString>;
+    sparqlQueryTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    maxSparqlResults: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export type ServerConfig = z.infer<typeof ServerConfigSchema>;
+export declare function getServerConfig(): ServerConfig;
+export {};
+//# sourceMappingURL=server-config.d.ts.map

package/dist/config/server-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAG3C,QAAA,MAAM,kBAAkB;;;;;iBAwBtB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,wBAAgB,eAAe,IAAI,YAAY,CAQ9C"}

package/dist/config/server-config.js

@@ -0,0 +1,43 @@
+/**
+ * @fileoverview Server-specific configuration for eur-lex-mcp-server.
+ * Parses environment variables for CELLAR SPARQL and EUR-Lex content API settings.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { parseEnvConfig } from '@cyanheads/mcp-ts-core/config';
+const ServerConfigSchema = z.object({
+    cellarSparqlEndpoint: z
+        .string()
+        .url()
+        .default('http://publications.europa.eu/webapi/rdf/sparql')
+        .describe('CELLAR SPARQL endpoint URL (Virtuoso)'),
+    eurLexContentBaseUrl: z
+        .string()
+        .url()
+        .default('https://eur-lex.europa.eu')
+        .describe('EUR-Lex content API base URL'),
+    sparqlQueryTimeoutMs: z.coerce
+        .number()
+        .int()
+        .positive()
+        .default(55_000)
+        .describe('Client-side timeout for SPARQL requests in milliseconds'),
+    maxSparqlResults: z.coerce
+        .number()
+        .int()
+        .positive()
+        .max(100)
+        .default(100)
+        .describe('Enforced ceiling on LIMIT in all generated SPARQL queries'),
+});
+let _config;
+export function getServerConfig() {
+    _config ??= parseEnvConfig(ServerConfigSchema, {
+        cellarSparqlEndpoint: 'CELLAR_SPARQL_ENDPOINT',
+        eurLexContentBaseUrl: 'EURLEX_CONTENT_BASE_URL',
+        sparqlQueryTimeoutMs: 'SPARQL_QUERY_TIMEOUT_MS',
+        maxSparqlResults: 'MAX_SPARQL_RESULTS',
+    });
+    return _config;
+}
+//# sourceMappingURL=server-config.js.map

package/dist/config/server-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,oBAAoB,EAAE,CAAC;SACpB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,OAAO,CAAC,iDAAiD,CAAC;SAC1D,QAAQ,CAAC,uCAAuC,CAAC;IACpD,oBAAoB,EAAE,CAAC;SACpB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,OAAO,CAAC,2BAA2B,CAAC;SACpC,QAAQ,CAAC,8BAA8B,CAAC;IAC3C,oBAAoB,EAAE,CAAC,CAAC,MAAM;SAC3B,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,OAAO,CAAC,MAAM,CAAC;SACf,QAAQ,CAAC,yDAAyD,CAAC;IACtE,gBAAgB,EAAE,CAAC,CAAC,MAAM;SACvB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,GAAG,CAAC;SACZ,QAAQ,CAAC,2DAA2D,CAAC;CACzE,CAAC,CAAC;AAIH,IAAI,OAAiC,CAAC;AAEtC,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,cAAc,CAAC,kBAAkB,EAAE;QAC7C,oBAAoB,EAAE,wBAAwB;QAC9C,oBAAoB,EAAE,yBAAyB;QAC/C,oBAAoB,EAAE,yBAAyB;QAC/C,gBAAgB,EAAE,oBAAoB;KACvC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview eur-lex-mcp-server MCP server entry point.
+ * Provides access to the EU CELLAR repository and EUR-Lex content API.
+ * @module index
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;GAIG"}

package/dist/index.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview eur-lex-mcp-server MCP server entry point.
+ * Provides access to the EU CELLAR repository and EUR-Lex content API.
+ * @module index
+ */
+import { createApp } from '@cyanheads/mcp-ts-core';
+import { getServerConfig } from './config/server-config.js';
+import { allPromptDefinitions } from './mcp-server/prompts/definitions/index.js';
+import { allResourceDefinitions } from './mcp-server/resources/definitions/index.js';
+import { allToolDefinitions } from './mcp-server/tools/definitions/index.js';
+import { initCellarSparqlService } from './services/cellar-sparql/cellar-sparql-service.js';
+import { initEurLexContentService } from './services/eurlex-content/eurlex-content-service.js';
+await createApp({
+    tools: allToolDefinitions,
+    resources: allResourceDefinitions,
+    prompts: allPromptDefinitions,
+    instructions: 'EUR-Lex MCP server provides access to the EU CELLAR semantic repository (2.7M+ EU legal works).\n' +
+        '- Use eurlex_browse_subjects first to resolve subject keywords to EuroVoc concept URIs before filtering searches.\n' +
+        '- Use eurlex_lookup_celex to validate an identifier before calling eurlex_get_document.\n' +
+        '- CELEX format: {sector}{year}{type}{number} — e.g. 32016R0679 (GDPR), 62024CJ0629 (case).\n' +
+        '- Document text comes from the EUR-Lex REST API; metadata and relations come from CELLAR SPARQL.\n' +
+        '- eurlex_query_sparql is an escape hatch for CDM ontology traversal not covered by curated tools.',
+    setup(core) {
+        const serverConfig = getServerConfig();
+        initCellarSparqlService(core.config, core.storage, serverConfig);
+        initEurLexContentService(core.config, core.storage, serverConfig);
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,mDAAmD,CAAC;AAC5F,OAAO,EAAE,wBAAwB,EAAE,MAAM,qDAAqD,CAAC;AAE/F,MAAM,SAAS,CAAC;IACd,KAAK,EAAE,kBAAkB;IACzB,SAAS,EAAE,sBAAsB;IACjC,OAAO,EAAE,oBAAoB;IAC7B,YAAY,EACV,mGAAmG;QACnG,qHAAqH;QACrH,2FAA2F;QAC3F,8FAA8F;QAC9F,oGAAoG;QACpG,mGAAmG;IACrG,KAAK,CAAC,IAAI;QACR,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;QACvC,uBAAuB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACjE,wBAAwB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACpE,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/prompts/definitions/eurlex-comparative-analysis.prompt.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview eurlex_comparative_analysis — Comparative EU ↔ US legal analysis prompt.
+ * @module mcp-server/prompts/definitions/eurlex-comparative-analysis
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const eurlex_comparative_analysis: import("@cyanheads/mcp-ts-core").PromptDefinition<z.ZodObject<{
+    domain: z.ZodString;
+    focus: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+//# sourceMappingURL=eurlex-comparative-analysis.prompt.d.ts.map

package/dist/mcp-server/prompts/definitions/eurlex-comparative-analysis.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eurlex-comparative-analysis.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/eurlex-comparative-analysis.prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAU,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAEnD,eAAO,MAAM,2BAA2B;;;kBA4DtC,CAAC"}

package/dist/mcp-server/prompts/definitions/eurlex-comparative-analysis.prompt.js

@@ -0,0 +1,60 @@
+/**
+ * @fileoverview eurlex_comparative_analysis — Comparative EU ↔ US legal analysis prompt.
+ * @module mcp-server/prompts/definitions/eurlex-comparative-analysis
+ */
+import { prompt, z } from '@cyanheads/mcp-ts-core';
+export const eurlex_comparative_analysis = prompt('eurlex_comparative_analysis', {
+    description: 'Frames a comparative legal analysis across EU and US law for a given policy domain. ' +
+        'Structures the inquiry to use eurlex_search_documents and eurlex_get_document for the EU side, ' +
+        'and courtlistener_search_opinions for the US counterpart. ' +
+        'Useful for policy analysts, legal researchers, and practitioners needing a cross-jurisdictional overview.',
+    args: z.object({
+        domain: z
+            .string()
+            .min(1)
+            .describe('Policy domain for the comparison (e.g. "data privacy", "antitrust", "AI regulation", "food safety").'),
+        focus: z
+            .string()
+            .optional()
+            .describe('Optional sub-topic or specific aspect to focus on (e.g. "enforcement mechanisms", "data subject rights", "remedies").'),
+    }),
+    generate: (args) => {
+        const focusLine = args.focus ? ` with emphasis on **${args.focus}**` : '';
+        const domain = args.domain;
+        return [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Please provide a comparative legal analysis of **${domain}**${focusLine} across EU and US jurisdictions.
+
+## Research Plan
+
+### EU Side
+1. Call **eurlex_browse_subjects** with keyword "${domain}" to identify relevant EuroVoc concept URIs.
+2. Call **eurlex_search_documents** filtered by the EuroVoc concept(s) found, document_type REG or DIR, to find key legislative acts.
+3. Call **eurlex_get_document** on the most significant act(s) to retrieve full text and metadata.
+4. Call **eurlex_get_relations** on key acts to understand the legislative history and amendments.
+
+### US Side
+5. Call **courtlistener_search_opinions** with query "${domain}" to find significant US court decisions.
+6. Supplement with relevant federal statutes or regulations where applicable.
+
+## Analysis Framework
+
+After gathering sources, structure your analysis around:
+
+1. **Regulatory scope** — What conduct or activity is covered? Who are the regulated entities?
+2. **Core obligations** — What must regulated parties do or refrain from?
+3. ${args.focus ? `**${args.focus}** — Deep dive into this specific aspect` : '**Key differences** — Where do the EU and US approaches diverge most significantly?'}
+4. **Enforcement** — Who enforces the rules and what are the penalties?
+5. **Recent developments** — Recent legislation, court decisions, or regulatory guidance.
+6. **Practical implications** — For a multinational entity operating in both jurisdictions.
+
+Please cite specific EU acts (with CELEX numbers) and US cases/statutes as you go.`,
+                },
+            },
+        ];
+    },
+});
+//# sourceMappingURL=eurlex-comparative-analysis.prompt.js.map

package/dist/mcp-server/prompts/definitions/eurlex-comparative-analysis.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eurlex-comparative-analysis.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/eurlex-comparative-analysis.prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,CAAC,MAAM,2BAA2B,GAAG,MAAM,CAAC,6BAA6B,EAAE;IAC/E,WAAW,EACT,sFAAsF;QACtF,iGAAiG;QACjG,4DAA4D;QAC5D,2GAA2G;IAC7G,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACb,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CACP,sGAAsG,CACvG;QACH,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,uHAAuH,CACxH;KACJ,CAAC;IAEF,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;QACjB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,uBAAuB,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAE3B,OAAO;YACL;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,oDAAoD,MAAM,KAAK,SAAS;;;;;mDAKrC,MAAM;;;;;;wDAMD,MAAM;;;;;;;;;KASzD,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,0CAA0C,CAAC,CAAC,CAAC,qFAAqF;;;;;mFAKhF;iBAC1E;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Barrel export for all EUR-Lex MCP prompt definitions.
+ * @module mcp-server/prompts/definitions/index
+ */
+export declare const allPromptDefinitions: import("@cyanheads/mcp-ts-core").PromptDefinition<import("zod").ZodObject<{
+    domain: import("zod").ZodString;
+    focus: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>>[];
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Barrel export for all EUR-Lex MCP prompt definitions.
+ * @module mcp-server/prompts/definitions/index
+ */
+import { eurlex_comparative_analysis } from './eurlex-comparative-analysis.prompt.js';
+export const allPromptDefinitions = [eurlex_comparative_analysis];
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AAEtF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,2BAA2B,CAAC,CAAC"}

package/dist/mcp-server/resources/definitions/eurlex-document-relations.resource.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview eurlex://document/{celexNumber}/relations — Relationship summary for a CELLAR work.
+ * @module mcp-server/resources/definitions/eurlex-document-relations
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const eurlex_document_relations_resource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{
+    celexNumber: z.ZodString;
+}, z.core.$strip>, undefined, undefined>;
+//# sourceMappingURL=eurlex-document-relations.resource.d.ts.map

package/dist/mcp-server/resources/definitions/eurlex-document-relations.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eurlex-document-relations.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/eurlex-document-relations.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AA2BrD,eAAO,MAAM,kCAAkC;;wCAqF9C,CAAC"}

package/dist/mcp-server/resources/definitions/eurlex-document-relations.resource.js

@@ -0,0 +1,91 @@
+/**
+ * @fileoverview eurlex://document/{celexNumber}/relations — Relationship summary for a CELLAR work.
+ * @module mcp-server/resources/definitions/eurlex-document-relations
+ */
+import { resource, z } from '@cyanheads/mcp-ts-core';
+import { notFound } from '@cyanheads/mcp-ts-core/errors';
+import { CellarSparqlService, getCellarSparqlService, } from '../../../services/cellar-sparql/cellar-sparql-service.js';
+/** CDM relation predicates for the summary resource. */
+const RELATION_PREDICATES = [
+    'cdm:work_cites_work',
+    'cdm:resource_legal_amends_resource_legal',
+    'cdm:resource_legal_amended_by_resource_legal',
+    'cdm:resource_legal_based_on_resource_legal',
+    'cdm:resource_legal_has_consolidated_version',
+];
+const PREDICATE_TO_TYPE = {
+    'http://publications.europa.eu/ontology/cdm#work_cites_work': 'cites',
+    'http://publications.europa.eu/ontology/cdm#resource_legal_amends_resource_legal': 'amends',
+    'http://publications.europa.eu/ontology/cdm#resource_legal_amended_by_resource_legal': 'amended_by',
+    'http://publications.europa.eu/ontology/cdm#resource_legal_based_on_resource_legal': 'legal_basis',
+    'http://publications.europa.eu/ontology/cdm#resource_legal_has_consolidated_version': 'consolidated_version',
+};
+export const eurlex_document_relations_resource = resource('eurlex://document/{celexNumber}/relations', {
+    name: 'EUR-Lex document relations',
+    description: 'Relationship summary for a CELLAR work: amendment chain, consolidations, legal basis, and cited-by information. ' +
+        'Returns direct one-hop CDM relations for the work identified by CELEX number. ' +
+        'For deeper traversal or additional relation types, use the eurlex_get_relations tool.',
+    mimeType: 'application/json',
+    params: z.object({
+        celexNumber: z.string().describe('CELEX number of the EU act (e.g. 32016R0679 for GDPR).'),
+    }),
+    async handler(params, ctx) {
+        const svc = getCellarSparqlService();
+        const celexNumber = params.celexNumber.trim();
+        const safeCelexNumber = celexNumber.replace(/"/g, '\\"');
+        // Resolve to work URI first
+        const resolveSparql = `
+SELECT ?work WHERE {
+  ?work cdm:resource_legal_id_celex ?celex .
+  FILTER(STR(?celex) = "${safeCelexNumber}")
+} LIMIT 1`;
+        const resolveBindings = await svc.query(resolveSparql, ctx);
+        if (resolveBindings.length === 0) {
+            throw notFound(`No CELLAR work found for CELEX: ${celexNumber}`, { celexNumber });
+        }
+        const workUri = CellarSparqlService.bindingValue(resolveBindings[0], 'work') ?? '';
+        // Fetch relations
+        const relSparql = `
+SELECT ?relatedWork ?relatedCelex ?relationType ?direction WHERE {
+  {
+    <${workUri}> ?relationType ?relatedWork .
+    OPTIONAL { ?relatedWork cdm:resource_legal_id_celex ?relatedCelex . }
+    BIND("outgoing" AS ?direction)
+    FILTER(?relationType IN (${RELATION_PREDICATES.join(', ')}))
+  } UNION {
+    ?relatedWork ?relationType <${workUri}> .
+    OPTIONAL { ?relatedWork cdm:resource_legal_id_celex ?relatedCelex . }
+    BIND("incoming" AS ?direction)
+    FILTER(?relationType IN (${RELATION_PREDICATES.join(', ')}))
+  }
+} LIMIT 50`;
+        const relBindings = await svc.query(relSparql, ctx);
+        const relations = [];
+        const seen = new Set();
+        for (const b of relBindings) {
+            const relatedWorkUri = CellarSparqlService.bindingValue(b, 'relatedWork') ?? '';
+            const predicateUri = CellarSparqlService.bindingValue(b, 'relationType') ?? '';
+            const direction = CellarSparqlService.bindingValue(b, 'direction') ?? 'outgoing';
+            const key = `${predicateUri}|${relatedWorkUri}|${direction}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            const entry = {
+                relation_type: PREDICATE_TO_TYPE[predicateUri] ?? predicateUri,
+                direction,
+                related_work_uri: relatedWorkUri,
+            };
+            const relatedCelex = CellarSparqlService.bindingValue(b, 'relatedCelex');
+            if (relatedCelex)
+                entry.related_celex_number = relatedCelex;
+            relations.push(entry);
+        }
+        return {
+            celex_number: celexNumber,
+            work_uri: workUri,
+            relations,
+            total: relations.length,
+        };
+    },
+});
+//# sourceMappingURL=eurlex-document-relations.resource.js.map

package/dist/mcp-server/resources/definitions/eurlex-document-relations.resource.js.map

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

package/dist/mcp-server/resources/definitions/eurlex-document.resource.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview eurlex://document/{celexNumber} — Metadata snapshot for a CELLAR work.
+ * @module mcp-server/resources/definitions/eurlex-document
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const eurlex_document_resource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{
+    celexNumber: z.ZodString;
+}, z.core.$strip>, undefined, undefined>;
+//# sourceMappingURL=eurlex-document.resource.d.ts.map

package/dist/mcp-server/resources/definitions/eurlex-document.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eurlex-document.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/eurlex-document.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAOrD,eAAO,MAAM,wBAAwB;;wCAsDnC,CAAC"}

package/dist/mcp-server/resources/definitions/eurlex-document.resource.js

@@ -0,0 +1,61 @@
+/**
+ * @fileoverview eurlex://document/{celexNumber} — Metadata snapshot for a CELLAR work.
+ * @module mcp-server/resources/definitions/eurlex-document
+ */
+import { resource, z } from '@cyanheads/mcp-ts-core';
+import { notFound } from '@cyanheads/mcp-ts-core/errors';
+import { CellarSparqlService, getCellarSparqlService, } from '../../../services/cellar-sparql/cellar-sparql-service.js';
+export const eurlex_document_resource = resource('eurlex://document/{celexNumber}', {
+    name: 'EUR-Lex document metadata',
+    description: 'Metadata snapshot for a CELLAR work identified by CELEX number. ' +
+        'Returns document type, date, title (where available), author institution, and in-force flag. ' +
+        'Read-only, stable-URI injectable context for EU acts. ' +
+        'Full content and relations are available via the eurlex_get_document and eurlex_get_relations tools.',
+    mimeType: 'application/json',
+    params: z.object({
+        celexNumber: z.string().describe('CELEX number of the EU act (e.g. 32016R0679 for GDPR).'),
+    }),
+    async handler(params, ctx) {
+        const svc = getCellarSparqlService();
+        const celexNumber = params.celexNumber.trim();
+        const safeCelexNumber = celexNumber.replace(/"/g, '\\"');
+        const sparql = `
+SELECT ?work ?celexNumber ?type ?date ?title ?inForce ?author 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 . }
+} LIMIT 5`;
+        const bindings = await svc.query(sparql, ctx);
+        if (bindings.length === 0) {
+            throw notFound(`No CELLAR work found for CELEX: ${celexNumber}`, { celexNumber });
+        }
+        const first = bindings[0];
+        const result = {
+            celex_number: CellarSparqlService.bindingValue(first, 'celexNumber') ?? celexNumber,
+        };
+        const workUri = CellarSparqlService.bindingValue(first, 'work');
+        if (workUri)
+            result.work_uri = workUri;
+        const resourceType = CellarSparqlService.bindingValue(first, 'type');
+        if (resourceType)
+            result.resource_type = resourceType;
+        const date = CellarSparqlService.bindingValue(first, 'date');
+        if (date)
+            result.date = date;
+        const title = CellarSparqlService.bindingValue(first, 'title');
+        if (title)
+            result.title = title;
+        const inForceStr = CellarSparqlService.bindingValue(first, 'inForce');
+        if (inForceStr !== undefined)
+            result.in_force = inForceStr === 'true';
+        const author = CellarSparqlService.bindingValue(first, 'author');
+        if (author)
+            result.author_institution = author;
+        return result;
+    },
+});
+//# sourceMappingURL=eurlex-document.resource.js.map

package/dist/mcp-server/resources/definitions/eurlex-document.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eurlex-document.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/eurlex-document.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EACL,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,mDAAmD,CAAC;AAE3D,MAAM,CAAC,MAAM,wBAAwB,GAAG,QAAQ,CAAC,iCAAiC,EAAE;IAClF,IAAI,EAAE,2BAA2B;IACjC,WAAW,EACT,kEAAkE;QAClE,+FAA+F;QAC/F,wDAAwD;QACxD,sGAAsG;IACxG,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;KAC3F,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG;QACvB,MAAM,GAAG,GAAG,sBAAsB,EAAE,CAAC;QACrC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAC9C,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAEzD,MAAM,MAAM,GAAG;;;gCAGa,eAAe;;;;;;UAMrC,CAAC;QAEP,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAE9C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,QAAQ,CAAC,mCAAmC,WAAW,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;QACpF,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,MAAM,GAA4B;YACtC,YAAY,EAAE,mBAAmB,CAAC,YAAY,CAAC,KAAK,EAAE,aAAa,CAAC,IAAI,WAAW;SACpF,CAAC;QAEF,MAAM,OAAO,GAAG,mBAAmB,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAChE,IAAI,OAAO;YAAE,MAAM,CAAC,QAAQ,GAAG,OAAO,CAAC;QACvC,MAAM,YAAY,GAAG,mBAAmB,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrE,IAAI,YAAY;YAAE,MAAM,CAAC,aAAa,GAAG,YAAY,CAAC;QACtD,MAAM,IAAI,GAAG,mBAAmB,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC7D,IAAI,IAAI;YAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QAC7B,MAAM,KAAK,GAAG,mBAAmB,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC/D,IAAI,KAAK;YAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QAChC,MAAM,UAAU,GAAG,mBAAmB,CAAC,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACtE,IAAI,UAAU,KAAK,SAAS;YAAE,MAAM,CAAC,QAAQ,GAAG,UAAU,KAAK,MAAM,CAAC;QACtE,MAAM,MAAM,GAAG,mBAAmB,CAAC,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACjE,IAAI,MAAM;YAAE,MAAM,CAAC,kBAAkB,GAAG,MAAM,CAAC;QAE/C,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Barrel export for all EUR-Lex MCP resource definitions.
+ * @module mcp-server/resources/definitions/index
+ */
+export declare const allResourceDefinitions: import("@cyanheads/mcp-ts-core").ResourceDefinition<import("zod").ZodObject<{
+    celexNumber: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, undefined, undefined>[];
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Barrel export for all EUR-Lex MCP resource definitions.
+ * @module mcp-server/resources/definitions/index
+ */
+import { eurlex_document_resource } from './eurlex-document.resource.js';
+import { eurlex_document_relations_resource } from './eurlex-document-relations.resource.js';
+export const allResourceDefinitions = [
+    eurlex_document_resource,
+    eurlex_document_relations_resource,
+];
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,kCAAkC,EAAE,MAAM,yCAAyC,CAAC;AAE7F,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,wBAAwB;IACxB,kCAAkC;CACnC,CAAC"}

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

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview eurlex_browse_subjects — Search the EuroVoc multilingual thesaurus.
+ * @module mcp-server/tools/definitions/eurlex-browse-subjects
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const eurlex_browse_subjects: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    keyword: z.ZodString;
+    language: z.ZodDefault<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    concepts: z.ZodArray<z.ZodObject<{
+        concept_uri: z.ZodString;
+        pref_label: z.ZodString;
+        concept_code: z.ZodOptional<z.ZodString>;
+        broader_label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+}, z.core.$strip>, readonly [{
+    readonly reason: "no_concepts";
+    readonly code: 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>;
+//# sourceMappingURL=eurlex-browse-subjects.tool.d.ts.map

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

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