@cyanheads/ris-austria-mcp-server 0.1.5

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

@@ -0,0 +1,504 @@
+/**
+ * @fileoverview ris_get_document — read one RIS document's full text (markdown/html/xml)
+ * or its rendition URLs, with explicit binding status and the amtssigniert Authentisch PDF
+ * surfaced wherever it exists. Two addressing modes route to the same fetch path:
+ * `document_number` + `application`, or a `document_url` from a result's content_urls.
+ * Format availability varies by application (full text · authentic-PDF-only · PDF-only ·
+ * metadata-only) — a text-format request against a non-text application degrades to a
+ * `format_unavailable` notice on a success result, never an error. Oversized markdown
+ * overflows to a retrievable §/Artikel/Anlage section outline (never a silent truncation);
+ * a follow-up call with `sections:[…]` returns just the chosen sections. The shared
+ * {@link renderDocument} helper backs both this tool and the `ris://document/…` resource.
+ * @module mcp-server/tools/definitions/ris-get-document
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode, McpError, validationError } from '@cyanheads/mcp-ts-core/errors';
+import { OUTLINE_VARIANT, outlineOnOverflow, } from '@cyanheads/mcp-ts-core/utils';
+import { NodeHtmlMarkdown } from 'node-html-markdown';
+import { getServerConfig } from '../../../config/server-config.js';
+import { RIS_APPLICATIONS } from '../../../services/ris/reference/index.js';
+import { getRisService, RIS_CONTENT_FORMATS, } from '../../../services/ris/ris-service.js';
+/** The seven canonical binding labels (Design Decisions › Binding status). */
+const BINDING_STATUSES = [
+    'authentic',
+    'consolidated_informational',
+    'historical_record',
+    'decision',
+    'preparatory',
+    'administrative_directive',
+    'translation',
+];
+/**
+ * Serialized-length budget for inlining document text. Above it, markdown overflows to a
+ * §/Artikel/Anlage section outline instead of returning whole — generous, so it fires only
+ * on the pathological documents (multi-hundred-KB consolidations and government bills).
+ * Handed to `outlineOnOverflow`, which measures `JSON.stringify` length (≈ UTF-8 bytes for
+ * the mostly-Latin legal text); the exact `byte_size` is reported separately.
+ */
+const OUTLINE_BUDGET_BYTES = 500_000;
+const APPLICATION_CODES = RIS_APPLICATIONS.map((app) => app.code);
+const APPLICATION_BY_CODE = new Map(RIS_APPLICATIONS.map((app) => [app.code, app]));
+/** Content-path segment → application, for reverse-mapping a passed document_url. */
+const APPLICATION_BY_SEGMENT = new Map(RIS_APPLICATIONS.flatMap((app) => app.contentPathSegment !== null ? [[app.contentPathSegment, app]] : []));
+/**
+ * Lowercase file extensions a main-document rendition URL may end in — the constructible
+ * `RisContentFormat` set plus the derived `.pdfsig` authentic variant (see
+ * {@link authenticPdfFrom}). A `document_url`'s trailing filename must be
+ * `{documentNumber}.{ext}` for one of these; any other filename (a `Materialien_`/`Anlagen_…`
+ * content attachment, an unknown extension) addresses non-main content this tool would
+ * otherwise silently swap for the main document.
+ */
+const RENDITION_EXTENSIONS = new Set([...RIS_CONTENT_FORMATS, 'pdfsig']);
+/** Map an empty string from a form-based client to `undefined`. */
+function meaningful(value) {
+    return value !== undefined && value !== '' ? value : undefined;
+}
+/**
+ * Parse a caller-supplied `document_url` into `(application, documentNumber)` — errors as
+ * values (no throw). Enforces the same host + `/Dokumente/` allowlist as the service's
+ * fetch guard, then reverse-maps the content-path segment to its application.
+ */
+export function parseDocumentUrl(url, contentBaseUrl) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return { error: `"${url}" is not a valid URL` };
+    }
+    if (parsed.origin !== new URL(contentBaseUrl).origin) {
+        return { error: `only ${new URL(contentBaseUrl).origin} URLs are fetchable` };
+    }
+    if (!parsed.pathname.startsWith('/Dokumente/')) {
+        return { error: 'the path is outside the /Dokumente/ tree' };
+    }
+    const [, segment, rawDocumentNumber, filename, ...rest] = parsed.pathname
+        .split('/')
+        .filter((part) => part !== '');
+    if (segment === undefined || rawDocumentNumber === undefined) {
+        return { error: 'the path is not /Dokumente/{segment}/{documentNumber}/…' };
+    }
+    const app = APPLICATION_BY_SEGMENT.get(segment);
+    if (!app) {
+        return { error: `path segment "${segment}" is not a recognized RIS application` };
+    }
+    const documentNumber = decodeURIComponent(rawDocumentNumber);
+    // A folder URL (…/{segment}/{documentNumber}[/]) carries no trailing filename and resolves
+    // fine. A trailing filename is a main-document rendition only when it is exactly
+    // {documentNumber}.{ext} for a known rendition extension; a content attachment
+    // (Materialien_/Anlagen_… memoranda and annexes) or any deeper nesting names non-main
+    // content the fetch would silently swap for the main document — reject it here instead.
+    if (filename !== undefined) {
+        const decodedFilename = decodeURIComponent(filename);
+        const dot = decodedFilename.lastIndexOf('.');
+        const stem = dot === -1 ? decodedFilename : decodedFilename.slice(0, dot);
+        const extension = dot === -1 ? '' : decodedFilename.slice(dot + 1).toLowerCase();
+        if (rest.length > 0 || stem !== documentNumber || !RENDITION_EXTENSIONS.has(extension)) {
+            return {
+                error: `"${decodedFilename}" points at a content attachment or non-rendition file, not a main-document rendition — pass a main-document URL as returned in content_urls`,
+            };
+        }
+    }
+    return { application: app.code, documentNumber };
+}
+/** Derive the `.pdfsig` (Authentisch) URL from a constructed `.pdf` rendition URL. */
+function authenticPdfFrom(pdfUrl) {
+    return pdfUrl.replace(/\.pdf$/u, '.pdfsig');
+}
+/**
+ * Construct the rendition URLs for a document from its application's format availability.
+ * `buildDocumentContentUrl` throws `ValidationError` for an unsafe document number.
+ */
+function buildRenditionUrls(service, app, documentNumber) {
+    if (app.formats === 'none')
+        return { contentUrls: {} }; // BgblAlt — no content URLs to build
+    const pdf = service.buildDocumentContentUrl(app.code, documentNumber, 'pdf');
+    const authenticPdfUrl = app.binding === 'authentic' ? authenticPdfFrom(pdf) : undefined;
+    if (app.formats === 'authentic_pdf_only') {
+        // The signed PDF is the only rendition; the plain .pdf is not published separately.
+        return { contentUrls: {}, ...(authenticPdfUrl !== undefined && { authenticPdfUrl }) };
+    }
+    if (app.formats === 'pdf_only')
+        return { contentUrls: { pdf } };
+    return {
+        contentUrls: {
+            xml: service.buildDocumentContentUrl(app.code, documentNumber, 'xml'),
+            html: service.buildDocumentContentUrl(app.code, documentNumber, 'html'),
+            pdf,
+            rtf: service.buildDocumentContentUrl(app.code, documentNumber, 'rtf'),
+        },
+        ...(authenticPdfUrl !== undefined && { authenticPdfUrl }),
+    };
+}
+/** Compose the `format_unavailable` notice for an application with no text rendition. */
+function formatUnavailableNotice(app, format, urls) {
+    if (app.formats === 'authentic_pdf_only') {
+        return `${app.code} publishes only the signed authentic PDF (amtssigniert, .pdfsig) — no ${format} rendition exists. Fetch the authentic PDF from authentic_pdf_url${urls.authenticPdfUrl !== undefined ? ` (${urls.authenticPdfUrl})` : ''}.`;
+    }
+    if (app.formats === 'pdf_only') {
+        return `${app.code} publishes a PDF only — no ${format} rendition exists. Fetch the PDF from content_urls.pdf${urls.contentUrls.pdf !== undefined ? ` (${urls.contentUrls.pdf})` : ''}.`;
+    }
+    return `${app.code} carries no content URLs in RIS — it is metadata-only, with document scans hosted by the Austrian National Library (ÖNB). Retrieve the record and its ÖNB scan link via ris_search_gazette or ris_lookup_citation; RIS serves no fetchable rendition here.`;
+}
+/**
+ * Line-leading structural markers of Austrian legal text as the HTML→markdown rendering
+ * emits them: ATX headings (`##`/`###`) opening with a paragraph (§ / §§), article
+ * (Artikel / Art.), or annex (Anlage) marker. The `#` prefix is required — it is what
+ * separates a real heading from the many in-body `§ n` cross-references, which the
+ * converter leaves as plain (indented) text.
+ */
+const SECTION_HEADING = /^#{1,6}[ \t]+(§§?[ \t]*\d+[ \t]*[a-z]?|Art(?:ikel|\.)[ \t]*[\dIVXLC]+[ \t]*[a-z]?|Anlage(?:[ \t]+[\dA-Za-z]+)?)/gim;
+/**
+ * Segment rendered document text into its §/Artikel/Anlage sections. Each heading starts a
+ * section running to the next heading; text before the first heading becomes `Präambel`.
+ * Paragraph (§) sections are qualified by their containing article (`Artikel 25 § 39`) so
+ * names stay unique across a bill that amends many laws; any residual collision gets a
+ * ` (n)` suffix. Returns `[]` when the text carries no structural headings (e.g. a raw
+ * html/xml rendition) — the caller reads that as "nothing to outline".
+ */
+export function segmentDocument(text) {
+    const marks = [...text.matchAll(SECTION_HEADING)].map((match) => ({
+        index: match.index,
+        marker: (match[1] ?? '').replace(/[ \t]+/gu, ' ').trim(),
+    }));
+    const firstMark = marks[0];
+    if (firstMark === undefined)
+        return [];
+    const encoder = new TextEncoder();
+    const sections = [];
+    const counts = new Map();
+    const push = (name, slice) => {
+        const seen = (counts.get(name) ?? 0) + 1;
+        counts.set(name, seen);
+        sections.push({
+            name: seen > 1 ? `${name} (${seen})` : name,
+            text: slice,
+            bytes: encoder.encode(slice).length,
+        });
+    };
+    if (firstMark.index > 0) {
+        const preamble = text.slice(0, firstMark.index);
+        if (preamble.trim() !== '')
+            push('Präambel', preamble);
+    }
+    let container = '';
+    marks.forEach((mark, i) => {
+        const end = marks[i + 1]?.index ?? text.length;
+        const isContainer = /^(?:Art|Anlage)/iu.test(mark.marker);
+        if (isContainer)
+            container = mark.marker;
+        const name = !isContainer && container !== '' ? `${container} ${mark.marker}` : mark.marker;
+        push(name, text.slice(mark.index, end));
+    });
+    return sections;
+}
+/**
+ * Return the concatenated text of the named sections, or `undefined` when none match — the
+ * selective-retrieval counterpart to the outline. The handler re-fetches the document (the
+ * upstream query is deterministic, so it reproduces the same text) and slices it to the
+ * requested sections; a no-match falls through to a fresh outline so the agent can re-pick.
+ */
+export function selectDocumentSections(text, want) {
+    const wanted = new Set(want);
+    const matched = segmentDocument(text).filter((section) => wanted.has(section.name));
+    return matched.length > 0 ? matched.map((section) => section.text).join('\n\n') : undefined;
+}
+/**
+ * Apply the outline-on-overflow contract to rendered document text: whole under the byte
+ * budget (or with fewer than two structural sections), else a section outline. Shares
+ * {@link segmentDocument} as the section extractor so the tool and the resource segment
+ * identically; the `notice` builder is caller-specific (each points at its own re-call).
+ */
+export function outlineDocument(text, notice) {
+    return outlineOnOverflow({ text }, {
+        budget: OUTLINE_BUDGET_BYTES,
+        extract: (doc) => segmentDocument(doc.text).map(({ name, bytes }) => ({ name, bytes })),
+        notice,
+    });
+}
+/** Name the three largest sections, quoted, as examples for a re-call notice. */
+export function exampleSectionNames(sections) {
+    return sections
+        .slice(0, 3)
+        .map((section) => `"${section.name}"`)
+        .join(', ');
+}
+/**
+ * Render an overflow outline — the section roster the agent picks from — to markdown.
+ * Shared by the tool's `format()` (as a content block) and the resource (as its body), so
+ * both client surfaces list identical sections.
+ */
+export function renderOutlineSections(sections) {
+    return [
+        `**${sections.length} sections** (document too large to inline — retrieve by name):`,
+        ...sections.map((section) => `- \`${section.name}\` — ${section.bytes} bytes`),
+    ].join('\n');
+}
+/**
+ * Resolve, construct URLs for, and (for text formats on text-bearing applications) fetch
+ * and convert one RIS document. Throws framework errors (`validationError` for an unknown
+ * application or unsafe document number; `notFound`/`serviceUnavailable`/`timeout` from the
+ * content fetch) — callers map these onto their own typed contract.
+ */
+export async function renderDocument(applicationCode, documentNumber, format, ctx) {
+    const app = APPLICATION_BY_CODE.get(applicationCode);
+    if (!app) {
+        throw validationError(`Unknown RIS application "${applicationCode}".`, {
+            application: applicationCode,
+            valid: [...APPLICATION_BY_CODE.keys()],
+        });
+    }
+    const service = getRisService();
+    const urls = buildRenditionUrls(service, app, documentNumber);
+    const base = {
+        application: app.code,
+        bindingStatus: app.binding,
+        contentUrls: urls.contentUrls,
+        documentNumber,
+        format,
+        ...(urls.authenticPdfUrl !== undefined && { authenticPdfUrl: urls.authenticPdfUrl }),
+    };
+    // No usable payload for the request: a metadata-only application (no URLs at all, any
+    // format), or a text format against an application with no text rendition.
+    if (app.formats === 'none' || (format !== 'urls_only' && app.formats !== 'full')) {
+        return { ...base, unavailableNotice: formatUnavailableNotice(app, format, urls) };
+    }
+    // urls_only on a full / authentic-PDF-only / PDF-only application — URLs already in base.
+    if (format === 'urls_only')
+        return base;
+    const fetchFormat = format === 'xml' ? 'xml' : 'html';
+    const url = service.buildDocumentContentUrl(app.code, documentNumber, fetchFormat);
+    const fetched = await service.fetchDocumentContent(url, ctx);
+    const rendered = format === 'markdown' ? NodeHtmlMarkdown.translate(fetched.text) : fetched.text;
+    const encoded = new TextEncoder().encode(rendered);
+    ctx.log.info('Document rendered', {
+        application: app.code,
+        byteSize: encoded.length,
+        format,
+    });
+    return { ...base, byteSize: encoded.length, text: rendered };
+}
+const ContentUrlsSchema = z
+    .object({
+    xml: z.string().optional().describe('XML rendition URL (RIS Nutzdaten schema).'),
+    html: z.string().optional().describe('HTML rendition URL.'),
+    pdf: z.string().optional().describe('PDF rendition URL.'),
+    rtf: z.string().optional().describe('RTF rendition URL.'),
+})
+    .describe('Constructed rendition URLs. Empty for authentic-PDF-only (Bvb/GrA/KmGer) and metadata-only (BgblAlt) applications — see authentic_pdf_url and the notice.');
+export const risGetDocument = tool('ris_get_document', {
+    title: 'Get RIS Document',
+    description: 'Fetch one RIS document’s full text or its rendition URLs, with explicit binding status and the amtssigniert authentic PDF surfaced wherever it exists. Address the document exactly one of two ways: document_number plus application (both copied verbatim from a ris_search_* or ris_lookup_citation result), or a document_url from a result’s content_urls. format: markdown (default — the HTML rendition converted to markdown), html (raw HTML rendition), xml (the RIS Nutzdaten XML), or urls_only (no fetch — every rendition URL, including the Authentisch PDF). Format availability varies by application and the tool degrades explicitly, never silently: consolidated law, gazettes, case law, drafts, and most sectoral collections carry full text; district and municipal promulgations and court rules (Bvb, GrA, KmGer) publish only the signed authentic PDF; party-transparency decisions and council minutes (Upts, Mrp) are PDF-only; the 1848–1940 imperial gazettes (BgblAlt) are metadata-only — for these a text-format request returns a format_unavailable notice with the usable URL, not an error. Every result carries binding_status; only authentic (amtssigniert) publications are legally binding. This tool returns content, not fresh metadata — the metadata rides the search/lookup step that produced the document number. When the markdown text overflows the byte budget the tool returns a §/Artikel/Anlage section outline (kind: outline) instead of truncating; re-call with sections:[…] naming outline entries to retrieve just those. Raw html/xml renditions, which carry no such headings, return in full.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        document_number: z
+            .string()
+            .optional()
+            .describe('Technical RIS document number (Technisch.ID), e.g. NOR40262691, JJT_…, BGBLA_2026_II_171 — copy verbatim from a ris_search_* or ris_lookup_citation result. Requires application; mutually exclusive with document_url.'),
+        application: z
+            .enum(APPLICATION_CODES)
+            .optional()
+            .describe('RIS application the document belongs to (e.g. BrKons, Dsk, BgblAuth) — copy verbatim from the same result. Required with document_number. Codes and coverage: ris_list_reference topic applications.'),
+        document_url: z
+            .string()
+            .optional()
+            .describe('A https://www.ris.bka.gv.at/Dokumente/… main-document rendition URL as returned in a result’s content_urls — the alternative to document_number + application. Must address a main-document rendition ({documentNumber}.{ext}); content-attachment URLs (Materialien_/Anlagen_… memoranda and annexes) are not fetchable this way.'),
+        format: z
+            .enum(['markdown', 'html', 'xml', 'urls_only'])
+            .default('markdown')
+            .describe('markdown (default — the HTML rendition converted to markdown), html (raw HTML rendition), xml (RIS Nutzdaten schema), or urls_only (no fetch — all rendition URLs incl. the authentic PDF).'),
+        sections: z
+            .array(z.string())
+            .optional()
+            .describe('Section names to retrieve, each copied verbatim from a prior outline response (kind: outline). Omit for the full document — which returns a §/Artikel/Anlage outline instead when the markdown overflows the byte budget. Applies to text formats; ignored for urls_only.'),
+    }),
+    output: z.object({
+        text: z
+            .string()
+            .optional()
+            .describe('The document text in the requested format. Absent for urls_only and when the application carries no text rendition (see the notice).'),
+        format: z
+            .enum(['markdown', 'html', 'xml', 'urls_only'])
+            .describe('The format served — echoes the requested format.'),
+        byte_size: z
+            .number()
+            .optional()
+            .describe('Full UTF-8 byte size of the document text. Present when text was fetched — for an overflowed document (kind: outline) this reports the full text’s size, not the outline payload’s.'),
+        truncated: z
+            .boolean()
+            .optional()
+            .describe('Present and true when the full text isn’t inline because the document overflowed to a section outline (kind: outline) — retrieve sections via the sections input, or fetch content_urls for the whole artifact.'),
+        kind: z
+            .enum(['full', 'outline'])
+            .describe('full — the complete response (document text, selected sections, or rendition URLs). outline — the text overflowed the byte budget, so sections lists the retrievable §/Artikel/Anlage units; re-call with sections:[…] to fetch specific ones.'),
+        sections: z
+            .array(OUTLINE_VARIANT.shape.sections.element.describe('A retrievable §/Artikel/Anlage section — its name and UTF-8 byte size.'))
+            .optional()
+            .describe('Present when kind = outline: the document’s §/Artikel/Anlage sections, largest first, each with its UTF-8 byte size. Copy names into the sections input to retrieve them.'),
+        binding_status: z
+            .enum(BINDING_STATUSES)
+            .describe('Legal binding status: authentic (amtssigniert, legally binding), consolidated_informational (consolidated view — not binding), historical_record (superseded/pre-e-Recht promulgation), decision (court/tribunal ruling), preparatory (draft/bill/minutes), administrative_directive (binds the administration, not citizens), or translation (unofficial English).'),
+        content_urls: ContentUrlsSchema,
+        authentic_pdf_url: z
+            .string()
+            .optional()
+            .describe('The amtssigniert authentic PDF (.pdfsig, Authentisch DataType) — the legally binding artifact — where the application publishes one.'),
+        document_number: z.string().describe('Technical RIS document number (echoed).'),
+        application: z.string().describe('RIS application the document belongs to (echoed).'),
+    }),
+    enrichment: {
+        notice: z
+            .string()
+            .optional()
+            .describe('Agent-facing notice: either the requested text format is unavailable for this application (names why and the usable URL), or the document overflowed to a section outline (names how to retrieve sections).'),
+    },
+    errors: [
+        {
+            reason: 'invalid_addressing',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'Neither or both addressing modes were provided, document_number was given without application, or the document_number/application pairing is not a valid RIS document — thrown locally before any fetch.',
+            recovery: 'Provide exactly one addressing mode: document_number plus application (both from one search result), or a document_url from a result’s content_urls.',
+        },
+        {
+            reason: 'unsupported_url',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'document_url fails the host + /Dokumente/ path-prefix allowlist, or its path segment is not a recognized RIS application — thrown locally, nothing fetched.',
+            recovery: 'Only ris.bka.gv.at /Dokumente/ URLs are fetchable — pass a URL exactly as returned in content_urls, or switch to document_number + application.',
+        },
+        {
+            reason: 'document_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The constructed or passed content URL returned 404.',
+            recovery: 'The document_number/application pairing didn’t resolve — copy both verbatim from a fresh search result, or resolve the citation with ris_lookup_citation. Document numbers are application-specific.',
+        },
+        {
+            reason: 'upstream_error',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'The RIS content host was unreachable or returned a server error.',
+            retryable: true,
+            recovery: 'The RIS content host is temporarily unavailable — retry the fetch after a short delay.',
+        },
+    ],
+    async handler(input, ctx) {
+        const documentNumber = meaningful(input.document_number);
+        const application = meaningful(input.application);
+        const documentUrl = meaningful(input.document_url);
+        const { format } = input;
+        const failAddressing = (message) => ctx.fail('invalid_addressing', message, { ...ctx.recoveryFor('invalid_addressing') });
+        let resolvedApplication;
+        let resolvedDocumentNumber;
+        if (documentUrl !== undefined) {
+            if (documentNumber !== undefined || application !== undefined) {
+                throw failAddressing('Provide document_url OR document_number + application, not both addressing modes.');
+            }
+            const parsed = parseDocumentUrl(documentUrl, getServerConfig().contentBaseUrl);
+            if ('error' in parsed) {
+                throw ctx.fail('unsupported_url', `document_url is not fetchable — ${parsed.error}.`, {
+                    ...ctx.recoveryFor('unsupported_url'),
+                });
+            }
+            resolvedApplication = parsed.application;
+            resolvedDocumentNumber = parsed.documentNumber;
+        }
+        else {
+            if (documentNumber === undefined || application === undefined) {
+                throw failAddressing('Provide document_number together with application, or a document_url instead.');
+            }
+            resolvedApplication = application;
+            resolvedDocumentNumber = documentNumber;
+        }
+        // Map framework errors from resolution/fetch onto this tool's declared contract.
+        const rendition = await renderDocument(resolvedApplication, resolvedDocumentNumber, format, ctx).catch((err) => {
+            if (err instanceof McpError) {
+                if (err.code === JsonRpcErrorCode.ValidationError) {
+                    throw ctx.fail('invalid_addressing', err.message, {
+                        ...ctx.recoveryFor('invalid_addressing'),
+                    });
+                }
+                if (err.code === JsonRpcErrorCode.NotFound) {
+                    throw ctx.fail('document_not_found', err.message, {
+                        ...ctx.recoveryFor('document_not_found'),
+                    });
+                }
+                if (err.code === JsonRpcErrorCode.ServiceUnavailable) {
+                    throw ctx.fail('upstream_error', err.message, { ...ctx.recoveryFor('upstream_error') });
+                }
+            }
+            throw err;
+        });
+        const base = {
+            application: rendition.application,
+            binding_status: rendition.bindingStatus,
+            content_urls: rendition.contentUrls,
+            document_number: rendition.documentNumber,
+            format: rendition.format,
+            ...(rendition.authenticPdfUrl !== undefined && {
+                authentic_pdf_url: rendition.authenticPdfUrl,
+            }),
+        };
+        // No text payload — format_unavailable (with its notice) or urls_only. Complete either way.
+        if (rendition.text === undefined) {
+            if (rendition.unavailableNotice !== undefined)
+                ctx.enrich.notice(rendition.unavailableNotice);
+            return { ...base, kind: 'full' };
+        }
+        const { byteSize } = rendition;
+        const requestedSections = input.sections?.filter((name) => name.trim() !== '') ?? [];
+        // Selective retrieval — the re-call after an outline. A no-match falls through to a fresh
+        // outline so the agent can re-pick valid section names.
+        if (requestedSections.length > 0) {
+            const selected = selectDocumentSections(rendition.text, requestedSections);
+            if (selected !== undefined) {
+                return {
+                    ...base,
+                    kind: 'full',
+                    text: selected,
+                    byte_size: new TextEncoder().encode(selected).length,
+                };
+            }
+        }
+        // Disclosure — whole text under budget (or unsegmentable), else a section outline.
+        const decision = outlineDocument(rendition.text, (sections) => `Document too large to return in full${byteSize !== undefined ? ` (${byteSize} bytes)` : ''}. Re-call ris_get_document with the same addressing plus sections:[…] naming entries from the outline — e.g. ${exampleSectionNames(sections)}.`);
+        if (decision.kind === 'full') {
+            return {
+                ...base,
+                kind: 'full',
+                text: decision.text,
+                ...(byteSize !== undefined && { byte_size: byteSize }),
+            };
+        }
+        ctx.enrich.notice(decision.notice);
+        return {
+            ...base,
+            kind: 'outline',
+            sections: decision.sections,
+            truncated: true,
+            ...(byteSize !== undefined && { byte_size: byteSize }),
+        };
+    },
+    // format() populates content[] — the markdown twin of structuredContent. Every output
+    // field renders here; the notice rides the enrichment trailer. The full-text (`text`) and
+    // outline (`sections`) arms render on field presence, independently — never branch on
+    // `kind` (format-parity walks one sample with every optional field populated at once).
+    format: (result) => {
+        const lines = [`## ${result.document_number} (${result.application})`];
+        lines.push(`**Binding:** ${result.binding_status} | **Format:** ${result.format} | **Kind:** ${result.kind}`);
+        if (result.byte_size !== undefined) {
+            lines.push(`**Size:** ${result.byte_size} bytes${result.truncated === true ? ' (truncated — retrieve sections from the outline below)' : ''}`);
+        }
+        if (result.authentic_pdf_url !== undefined) {
+            lines.push(`**Authentic PDF:** ${result.authentic_pdf_url}`);
+        }
+        const urls = ['html', 'pdf', 'rtf', 'xml']
+            .filter((key) => result.content_urls[key] !== undefined)
+            .map((key) => `[${key.toUpperCase()}](${result.content_urls[key]})`);
+        if (urls.length > 0)
+            lines.push(`**Renditions:** ${urls.join(' · ')}`);
+        if (result.sections !== undefined)
+            lines.push('', renderOutlineSections(result.sections));
+        if (result.text !== undefined)
+            lines.push('', result.text);
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=ris-get-document.tool.js.map

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

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

package/dist/mcp-server/tools/definitions/ris-list-reference.tool.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview ris_list_reference — static, offline reference for the opaque German codes
+ * across the RIS surface. No service dependency, no upstream calls: every topic renders
+ * from the typed tables in `src/services/ris/reference/`. The other ris_* tools' recovery
+ * hints and zero-hit notices route here.
+ * @module mcp-server/tools/definitions/ris-list-reference
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const risListReference: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    topic: z.ZodEnum<{
+        applications: "applications";
+        courts: "courts";
+        states: "states";
+        decision_types: "decision_types";
+        decision_kinds: "decision_kinds";
+        issuing_bodies: "issuing_bodies";
+        ministries: "ministries";
+        collections: "collections";
+        stages: "stages";
+        changed_since_intervals: "changed_since_intervals";
+        section_types: "section_types";
+        gazette_parts: "gazette_parts";
+        law_types: "law_types";
+        district_authorities: "district_authorities";
+        justiz_subject_areas: "justiz_subject_areas";
+        search_syntax: "search_syntax";
+        citation_formats: "citation_formats";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    topic: z.ZodString;
+    summary: z.ZodString;
+    entries: z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodString;
+        details: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    notes: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, undefined, undefined>;
+//# sourceMappingURL=ris-list-reference.tool.d.ts.map

package/dist/mcp-server/tools/definitions/ris-list-reference.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ris-list-reference.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/ris-list-reference.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AA8UjD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCA8E3B,CAAC"}