@cyanheads/ris-austria-mcp-server 0.1.5

package/changelog/template.md

@@ -0,0 +1,129 @@
+---
+# 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` ONLY for a security fix in THIS project's own source code — a
+# vulnerability or hardening in code you ship. A dependency or transitive CVE
+# bump is routine maintenance, NOT a security release: record it under
+# `## Dependencies` (with the advisory ID) and leave this `false`. When true,
+# pairs with the `## Security` section below and flags `Security` in the rollup.
+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,19 @@
+/**
+ * @fileoverview Server-specific environment configuration for ris-austria-mcp-server.
+ * All three variables are optional — the RIS OGD API is keyless.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+declare const ServerConfigSchema: z.ZodObject<{
+    apiBaseUrl: z.ZodDefault<z.ZodURL>;
+    contentBaseUrl: z.ZodDefault<z.ZodURL>;
+    contact: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ServerConfig = z.infer<typeof ServerConfigSchema>;
+/**
+ * Lazily parse and cache the server config from the environment.
+ * Lazy so Workers-style runtimes can inject env vars before first use.
+ */
+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;;;;iBAetB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D;;;GAGG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAO9C"}

package/dist/config/server-config.js

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview Server-specific environment configuration for ris-austria-mcp-server.
+ * All three variables are optional — the RIS OGD API is keyless.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { parseEnvConfig } from '@cyanheads/mcp-ts-core/config';
+const ServerConfigSchema = z.object({
+    apiBaseUrl: z
+        .url()
+        .default('https://data.bka.gv.at/ris/api/v2.6')
+        .describe('RIS OGD REST API base URL.'),
+    contentBaseUrl: z
+        .url()
+        .default('https://www.ris.bka.gv.at')
+        .describe('RIS document content host — also the allowlist host for document_url fetches.'),
+    contact: z
+        .string()
+        .optional()
+        .describe('Contact string appended to the User-Agent (RIS netiquette asks integrators to be identifiable).'),
+});
+let _config;
+/**
+ * Lazily parse and cache the server config from the environment.
+ * Lazy so Workers-style runtimes can inject env vars before first use.
+ */
+export function getServerConfig() {
+    _config ??= parseEnvConfig(ServerConfigSchema, {
+        apiBaseUrl: 'RIS_API_BASE_URL',
+        contentBaseUrl: 'RIS_CONTENT_BASE_URL',
+        contact: 'RIS_CONTACT',
+    });
+    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,UAAU,EAAE,CAAC;SACV,GAAG,EAAE;SACL,OAAO,CAAC,qCAAqC,CAAC;SAC9C,QAAQ,CAAC,4BAA4B,CAAC;IACzC,cAAc,EAAE,CAAC;SACd,GAAG,EAAE;SACL,OAAO,CAAC,2BAA2B,CAAC;SACpC,QAAQ,CAAC,+EAA+E,CAAC;IAC5F,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,iGAAiG,CAClG;CACJ,CAAC,CAAC;AAIH,IAAI,OAAiC,CAAC;AAEtC;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,cAAc,CAAC,kBAAkB,EAAE;QAC7C,UAAU,EAAE,kBAAkB;QAC9B,cAAc,EAAE,sBAAsB;QACtC,OAAO,EAAE,aAAa;KACvB,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview ris-austria-mcp-server MCP server entry point.
+ * @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;;;GAGG"}

package/dist/index.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview ris-austria-mcp-server MCP server entry point.
+ * @module index
+ */
+import { createApp } from '@cyanheads/mcp-ts-core';
+import { risDocumentResource } from './mcp-server/resources/definitions/ris-document.resource.js';
+import { risGetDocument } from './mcp-server/tools/definitions/ris-get-document.tool.js';
+import { risListReference } from './mcp-server/tools/definitions/ris-list-reference.tool.js';
+import { risLookupCitation } from './mcp-server/tools/definitions/ris-lookup-citation.tool.js';
+import { risSearchAnnouncements } from './mcp-server/tools/definitions/ris-search-announcements.tool.js';
+import { risSearchCaseLaw } from './mcp-server/tools/definitions/ris-search-case-law.tool.js';
+import { risSearchDrafts } from './mcp-server/tools/definitions/ris-search-drafts.tool.js';
+import { risSearchGazette } from './mcp-server/tools/definitions/ris-search-gazette.tool.js';
+import { risSearchLegislation } from './mcp-server/tools/definitions/ris-search-legislation.tool.js';
+import { risTrackChanges } from './mcp-server/tools/definitions/ris-track-changes.tool.js';
+import { initRisService } from './services/ris/ris-service.js';
+await createApp({
+    name: 'ris-austria-mcp-server',
+    title: 'ris-austria-mcp-server',
+    tools: [
+        risSearchLegislation,
+        risSearchCaseLaw,
+        risSearchGazette,
+        risSearchDrafts,
+        risSearchAnnouncements,
+        risLookupCitation,
+        risGetDocument,
+        risTrackChanges,
+        risListReference,
+    ],
+    resources: [risDocumentResource],
+    setup(core) {
+        initRisService(core.config);
+    },
+});
+//# 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;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AAClG,OAAO,EAAE,cAAc,EAAE,MAAM,yDAAyD,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAC7F,OAAO,EAAE,iBAAiB,EAAE,MAAM,4DAA4D,CAAC;AAC/F,OAAO,EAAE,sBAAsB,EAAE,MAAM,iEAAiE,CAAC;AACzG,OAAO,EAAE,gBAAgB,EAAE,MAAM,4DAA4D,CAAC;AAC9F,OAAO,EAAE,eAAe,EAAE,MAAM,0DAA0D,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAC7F,OAAO,EAAE,oBAAoB,EAAE,MAAM,+DAA+D,CAAC;AACrG,OAAO,EAAE,eAAe,EAAE,MAAM,0DAA0D,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,SAAS,CAAC;IACd,IAAI,EAAE,wBAAwB;IAC9B,KAAK,EAAE,wBAAwB;IAC/B,KAAK,EAAE;QACL,oBAAoB;QACpB,gBAAgB;QAChB,gBAAgB;QAChB,eAAe;QACf,sBAAsB;QACtB,iBAAiB;QACjB,cAAc;QACd,eAAe;QACf,gBAAgB;KACjB;IACD,SAAS,EAAE,CAAC,mBAAmB,CAAC;IAChC,KAAK,CAAC,IAAI;QACR,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview ris://document/{application}/{documentNumber} — the injectable markdown twin
+ * of ris_get_document. Reads the same content path (HTML rendition converted to markdown) for
+ * an (application, documentNumber) pair. Applications with no text rendition (authentic-PDF-only,
+ * PDF-only, or metadata-only) return a short note pointing at the usable artifact instead of
+ * text. Oversized text degrades to the same §/Artikel/Anlage section outline the tool emits,
+ * plus a note pointing at ris_get_document (which carries the sections selector this bare-string
+ * resource cannot). Backed by the shared renderDocument helper from the tool definition.
+ * @module mcp-server/resources/definitions/ris-document
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const risDocumentResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{
+    application: z.ZodEnum<{
+        [x: string]: string;
+    }>;
+    documentNumber: z.ZodString;
+}, z.core.$strip>, undefined, readonly [{
+    readonly reason: "document_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The application/documentNumber pair is not a valid RIS document, or its content URL returned 404.";
+    readonly recovery: "Copy the application and document number verbatim from a fresh search result, or resolve the citation with ris_lookup_citation. Document numbers are application-specific.";
+}, {
+    readonly reason: "upstream_error";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "The RIS content host was unreachable or returned a server error.";
+    readonly retryable: true;
+    readonly recovery: "The RIS content host is temporarily unavailable — retry the read after a short delay.";
+}]>;
+//# sourceMappingURL=ris-document.resource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ris-document.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/ris-document.resource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAY3E,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;GA2E9B,CAAC"}

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

@@ -0,0 +1,75 @@
+/**
+ * @fileoverview ris://document/{application}/{documentNumber} — the injectable markdown twin
+ * of ris_get_document. Reads the same content path (HTML rendition converted to markdown) for
+ * an (application, documentNumber) pair. Applications with no text rendition (authentic-PDF-only,
+ * PDF-only, or metadata-only) return a short note pointing at the usable artifact instead of
+ * text. Oversized text degrades to the same §/Artikel/Anlage section outline the tool emits,
+ * plus a note pointing at ris_get_document (which carries the sections selector this bare-string
+ * resource cannot). Backed by the shared renderDocument helper from the tool definition.
+ * @module mcp-server/resources/definitions/ris-document
+ */
+import { resource, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
+import { exampleSectionNames, outlineDocument, renderDocument, renderOutlineSections, } from '../../../mcp-server/tools/definitions/ris-get-document.tool.js';
+import { RIS_APPLICATIONS } from '../../../services/ris/reference/index.js';
+const APPLICATION_CODES = RIS_APPLICATIONS.map((app) => app.code);
+export const risDocumentResource = resource('ris://document/{application}/{documentNumber}', {
+    name: 'ris_document',
+    title: 'RIS Document (Markdown)',
+    description: 'Markdown text of one RIS document — the injectable twin of ris_get_document (markdown format). Addressed by application code and technical document number, both copied verbatim from a ris_search_* or ris_lookup_citation result. Applications that publish no text rendition (district/municipal promulgations, court rules, party-transparency decisions, council minutes, and the 1848–1940 imperial gazettes) return a short note pointing at the authentic PDF or scan instead.',
+    mimeType: 'text/markdown',
+    params: z.object({
+        application: z
+            .enum(APPLICATION_CODES)
+            .describe('RIS application code the document belongs to (e.g. BrKons, Dsk, BgblAuth). Codes: ris_list_reference topic applications.'),
+        documentNumber: z
+            .string()
+            .describe('Technical RIS document number (Technisch.ID), e.g. NOR40262691.'),
+    }),
+    examples: [
+        { name: 'A consolidated federal-law document', uri: 'ris://document/BrKons/NOR40262691' },
+    ],
+    errors: [
+        {
+            reason: 'document_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The application/documentNumber pair is not a valid RIS document, or its content URL returned 404.',
+            recovery: 'Copy the application and document number 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 read after a short delay.',
+        },
+    ],
+    async handler(params, ctx) {
+        // Map framework errors from resolution/fetch onto this resource's declared contract.
+        const rendition = await renderDocument(params.application, params.documentNumber, 'markdown', ctx).catch((err) => {
+            if (err instanceof McpError) {
+                if (err.code === JsonRpcErrorCode.ValidationError ||
+                    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;
+        });
+        if (rendition.unavailableNotice !== undefined)
+            return rendition.unavailableNotice;
+        if (rendition.text === undefined)
+            return '';
+        // Oversized markdown degrades to a section outline plus a notice pointing at the
+        // ris_get_document tool — this bare-string surface carries no section selector.
+        const decision = outlineDocument(rendition.text, (sections) => `Document too large to inline${rendition.byteSize !== undefined ? ` (${rendition.byteSize} bytes)` : ''}. Use the ris_get_document tool with sections:[…] to retrieve specific sections — e.g. ${exampleSectionNames(sections)}. This resource carries no section selector.`);
+        return decision.kind === 'full'
+            ? decision.text
+            : `${renderOutlineSections(decision.sections)}\n\n${decision.notice}`;
+    },
+});
+//# sourceMappingURL=ris-document.resource.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Shared Zod schemas reused across multiple tool definitions.
+ * @module mcp-server/tools/definitions/_shared
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+/** An ISO calendar date (YYYY-MM-DD), validated client-side before any upstream call. */
+export declare const isoDateString: z.ZodString;
+//# sourceMappingURL=_shared.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/_shared.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAE3C,yFAAyF;AACzF,eAAO,MAAM,aAAa,aAEkD,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Shared Zod schemas reused across multiple tool definitions.
+ * @module mcp-server/tools/definitions/_shared
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+/** An ISO calendar date (YYYY-MM-DD), validated client-side before any upstream call. */
+export const isoDateString = z
+    .string()
+    .regex(/^\d{4}-\d{2}-\d{2}$/u, 'Expected an ISO date in YYYY-MM-DD form.');
+//# sourceMappingURL=_shared.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/_shared.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAE3C,yFAAyF;AACzF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,MAAM,EAAE;KACR,KAAK,CAAC,sBAAsB,EAAE,0CAA0C,CAAC,CAAC"}

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

@@ -0,0 +1,189 @@
+/**
+ * @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 type { Context } from '@cyanheads/mcp-ts-core';
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { type OutlineResult, type SectionMeta } from '@cyanheads/mcp-ts-core/utils';
+import type { RisBindingStatus } from '../../../services/ris/reference/index.js';
+/** Requested output format. `markdown` and `html` both read the HTML rendition. */
+type DocumentFormat = 'markdown' | 'html' | 'xml' | 'urls_only';
+/** Constructed rendition URLs for a document, keyed by DataType. */
+interface RenditionContentUrls {
+    html?: string;
+    pdf?: string;
+    rtf?: string;
+    xml?: string;
+}
+/** A resolved document rendition — the shared unit behind the tool and the resource. */
+export interface DocumentRendition {
+    /** Application code the document belongs to (echoed). */
+    readonly application: string;
+    /** The amtssigniert authentic PDF (.pdfsig), where the application publishes one. */
+    readonly authenticPdfUrl?: string;
+    /** Legal binding status of the application's documents. */
+    readonly bindingStatus: RisBindingStatus;
+    /** Full byte size (UTF-8) of the text; present when text was fetched. */
+    readonly byteSize?: number;
+    /** Constructed rendition URLs (empty for authentic-PDF-only and metadata-only apps). */
+    readonly contentUrls: RenditionContentUrls;
+    /** Technical document number (echoed). */
+    readonly documentNumber: string;
+    /** The format served (echoes the request). */
+    readonly format: DocumentFormat;
+    /** Document text in the requested format; absent for urls_only and unavailable formats. */
+    readonly text?: string;
+    /** Present when the requested text format is unavailable for this application. */
+    readonly unavailableNotice?: string;
+}
+/** Result of parsing a caller-supplied document_url into an application + document number. */
+type ParsedDocumentUrl = {
+    readonly application: string;
+    readonly documentNumber: string;
+} | {
+    readonly error: string;
+};
+/**
+ * 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 declare function parseDocumentUrl(url: string, contentBaseUrl: string): ParsedDocumentUrl;
+/**
+ * One addressable section of a rendered RIS document — a structural unit sliced from its
+ * heading up to the next, plus the leading `Präambel` when the document opens with text
+ * before its first heading.
+ */
+export interface DocumentSection {
+    /** UTF-8 byte size of the section text. */
+    readonly bytes: number;
+    /** Section identifier — a §/Artikel/Anlage marker, article-qualified so names stay unique. */
+    readonly name: string;
+    /** The section's text, from its heading up to the next heading. */
+    readonly text: string;
+}
+/**
+ * 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 declare function segmentDocument(text: string): DocumentSection[];
+/**
+ * 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 declare function selectDocumentSections(text: string, want: readonly string[]): string | 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 declare function outlineDocument(text: string, notice: (sections: SectionMeta[]) => string): OutlineResult<{
+    text: string;
+}>;
+/** Name the three largest sections, quoted, as examples for a re-call notice. */
+export declare function exampleSectionNames(sections: readonly SectionMeta[]): string;
+/**
+ * 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 declare function renderOutlineSections(sections: readonly SectionMeta[]): string;
+/**
+ * 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 declare function renderDocument(applicationCode: string, documentNumber: string, format: DocumentFormat, ctx: Context): Promise<DocumentRendition>;
+export declare const risGetDocument: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    document_number: z.ZodOptional<z.ZodString>;
+    application: z.ZodOptional<z.ZodEnum<{
+        [x: string]: string;
+    }>>;
+    document_url: z.ZodOptional<z.ZodString>;
+    format: z.ZodDefault<z.ZodEnum<{
+        html: "html";
+        xml: "xml";
+        markdown: "markdown";
+        urls_only: "urls_only";
+    }>>;
+    sections: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    text: z.ZodOptional<z.ZodString>;
+    format: z.ZodEnum<{
+        html: "html";
+        xml: "xml";
+        markdown: "markdown";
+        urls_only: "urls_only";
+    }>;
+    byte_size: z.ZodOptional<z.ZodNumber>;
+    truncated: z.ZodOptional<z.ZodBoolean>;
+    kind: z.ZodEnum<{
+        full: "full";
+        outline: "outline";
+    }>;
+    sections: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        bytes: z.ZodNumber;
+    }, z.core.$strip>>>;
+    binding_status: z.ZodEnum<{
+        translation: "translation";
+        authentic: "authentic";
+        consolidated_informational: "consolidated_informational";
+        historical_record: "historical_record";
+        decision: "decision";
+        preparatory: "preparatory";
+        administrative_directive: "administrative_directive";
+    }>;
+    content_urls: z.ZodObject<{
+        xml: z.ZodOptional<z.ZodString>;
+        html: z.ZodOptional<z.ZodString>;
+        pdf: z.ZodOptional<z.ZodString>;
+        rtf: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    authentic_pdf_url: z.ZodOptional<z.ZodString>;
+    document_number: z.ZodString;
+    application: z.ZodString;
+}, z.core.$strip>, readonly [{
+    readonly reason: "invalid_addressing";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly 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.";
+    readonly 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.";
+}, {
+    readonly reason: "unsupported_url";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "document_url fails the host + /Dokumente/ path-prefix allowlist, or its path segment is not a recognized RIS application — thrown locally, nothing fetched.";
+    readonly 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.";
+}, {
+    readonly reason: "document_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The constructed or passed content URL returned 404.";
+    readonly 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.";
+}, {
+    readonly reason: "upstream_error";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "The RIS content host was unreachable or returned a server error.";
+    readonly retryable: true;
+    readonly recovery: "The RIS content host is temporarily unavailable — retry the fetch after a short delay.";
+}], {
+    readonly notice: z.ZodOptional<z.ZodString>;
+}>;
+export {};
+//# sourceMappingURL=ris-get-document.tool.d.ts.map

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

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