@cyanheads/ris-austria-mcp-server 0.1.5

package/dist/mcp-server/tools/definitions/ris-search-drafts.tool.js

@@ -0,0 +1,264 @@
+/**
+ * @fileoverview ris_search_drafts — search the federal lawmaking pipeline before promulgation:
+ * ministerial review drafts (Begut) and government bills adopted by the council of ministers
+ * (RegV, 2004+). `stage` routes to the owning application; the two stage-specific date filters
+ * (in_review_on, decided_from/to) are guarded locally before any upstream call. Ministry inputs
+ * accept an abbreviation ("BMF") — the service expands it to RIS's exact-match designation.
+ * @module mcp-server/tools/definitions/ris-search-drafts
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
+import { RIS_CHANGED_SINCE_INTERVALS, RIS_STAGES } from '../../../services/ris/reference/index.js';
+import { getRisService } from '../../../services/ris/ris-service.js';
+import { isoDateString } from './_shared.js';
+const STAGE_CODES = RIS_STAGES.map((s) => s.code);
+const CHANGED_SINCE_CODES = RIS_CHANGED_SINCE_INTERVALS.map((i) => i.code);
+/** Map an empty string from a form-based client to `undefined`. */
+function meaningful(value) {
+    return value !== undefined && value !== '' ? value : undefined;
+}
+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('Rendition URLs of the main document (attachments are excluded).');
+const DraftRecordSchema = z
+    .object({
+    document_number: z
+        .string()
+        .describe('Technical RIS document number (BEGUT_… or REGV_-prefixed) — pass together with the stage’s application to ris_get_document.'),
+    stage: z
+        .string()
+        .describe('Pipeline stage the record belongs to: review_drafts (Begut) or government_bills (RegV).'),
+    title: z.string().optional().describe('Full document title, HTML markup stripped.'),
+    short_title: z.string().optional().describe('Short title (Kurztitel), where assigned.'),
+    ministry: z
+        .string()
+        .optional()
+        .describe('Submitting ministry (EinbringendeStelle / Organ), where the record carries one.'),
+    review_deadline: z
+        .string()
+        .optional()
+        .describe('End of the public review window (Ende der Begutachtungsfrist) — review_drafts only.'),
+    decided: z
+        .string()
+        .optional()
+        .describe('Council-of-ministers adoption date (Beschlussdatum) — government_bills only.'),
+    content_urls: ContentUrlsSchema,
+})
+    .describe('One pipeline document — a review draft or a government bill.');
+/** Pick the four core rendition URLs off a normalized hit. */
+function pickContentUrls(hit) {
+    const { html, pdf, rtf, xml } = hit.contentUrls;
+    return {
+        ...(xml !== undefined && { xml }),
+        ...(html !== undefined && { html }),
+        ...(pdf !== undefined && { pdf }),
+        ...(rtf !== undefined && { rtf }),
+    };
+}
+/** Map a normalized RIS hit (Begut/RegV ride the Bundesrecht controller) to the record shape. */
+function toRecord(hit, stage) {
+    const base = {
+        content_urls: pickContentUrls(hit),
+        document_number: hit.documentNumber,
+        stage,
+    };
+    const md = hit.metadata;
+    if (md.controller === 'Bundesrecht') {
+        const ministry = md.ministry ?? hit.submitter ?? hit.organ;
+        return {
+            ...base,
+            ...(md.decided !== undefined && { decided: md.decided }),
+            ...(ministry !== undefined && { ministry }),
+            ...(md.reviewDeadline !== undefined && { review_deadline: md.reviewDeadline }),
+            ...(md.shortTitle !== undefined && { short_title: md.shortTitle }),
+            ...(md.title !== undefined && { title: md.title }),
+        };
+    }
+    return base;
+}
+export const risSearchDrafts = tool('ris_search_drafts', {
+    title: 'Search Draft Legislation',
+    description: 'Search Austria’s federal lawmaking pipeline BEFORE promulgation — the monitoring counterpart to ris_search_gazette (what will become law). stage selects the phase: review_drafts (Begutachtungsentwürfe — draft laws a ministry has put into public review, before any government bill exists) or government_bills (Regierungsvorlagen — bills the council of ministers adopted and submitted to parliament, 2004+). Filter by query (full text), title, ministry (accepts an abbreviation like "BMF" — expanded server-side to RIS’s exact designation; the historical name at submission time counts), in_review_on (review_drafts only — drafts whose review window covers the date; today = "what is in Begutachtung right now"), or decided_from/to (government_bills only — council adoption date). changed_since gives coarse recency. Documents are preparatory, not binding law. Ministry codes: ris_list_reference topic ministries.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        stage: z
+            .enum(STAGE_CODES)
+            .describe('Which pipeline stage to search — one per call. review_drafts (Begut, ministerial review) or government_bills (RegV, council-adopted bills). Details: ris_list_reference topic stages.'),
+        query: z
+            .string()
+            .optional()
+            .describe('Full-text search (Suchworte). Boolean operators UND/ODER/NICHT or AND/OR/NOT, parentheses, quoted phrases; wildcard * is trailing-only.'),
+        title: z
+            .string()
+            .optional()
+            .describe('Title search (Titel) — phrase field: * allowed leading or trailing with ≥2 characters beside it.'),
+        ministry: z
+            .string()
+            .optional()
+            .describe('Submitting ministry (EinbringendeStelle). Accepts an abbreviation ("BMF") — expanded server-side to RIS’s exact-match designation; use the ministry’s name at the time of submission. Table: ris_list_reference topic ministries.'),
+        in_review_on: isoDateString
+            .optional()
+            .describe('review_drafts only. Drafts whose public-review window covers this date (YYYY-MM-DD). Today = drafts currently in Begutachtung.'),
+        decided_from: isoDateString
+            .optional()
+            .describe('government_bills only. Earliest council-of-ministers adoption date (YYYY-MM-DD).'),
+        decided_to: isoDateString
+            .optional()
+            .describe('government_bills only. Latest adoption date (YYYY-MM-DD).'),
+        changed_since: z
+            .enum(CHANGED_SINCE_CODES)
+            .optional()
+            .describe('Coarse recency filter — documents changed in RIS within the interval. For exact windows use ris_track_changes.'),
+        sort_by: z
+            .enum(['date', 'ministry', 'title'])
+            .optional()
+            .describe('Sort column: date (review deadline or adoption date per stage), ministry, or title. Default: upstream order.'),
+        sort_direction: z
+            .enum(['ascending', 'descending'])
+            .optional()
+            .describe('Sort direction; applies with sort_by.'),
+        page: z.number().int().min(1).optional().describe('1-based result page. Default 1.'),
+        page_size: z
+            .union([z.literal(10), z.literal(20), z.literal(50), z.literal(100)])
+            .optional()
+            .describe('Documents per page — RIS accepts 10, 20, 50, or 100. Default 20.'),
+    }),
+    output: z.object({
+        results: z
+            .array(DraftRecordSchema)
+            .describe('Matching pipeline documents for the requested page. Totals and paging in enrichment.'),
+    }),
+    enrichment: {
+        totalCount: z.number().describe('Total matching documents across all pages.'),
+        page: z.number().describe('1-based page number RIS served.'),
+        pageSize: z.number().describe('Page size RIS applied.'),
+        truncated: z
+            .boolean()
+            .optional()
+            .describe('Present and true when more pages exist beyond this one — raise page to continue.'),
+        notice: z
+            .string()
+            .optional()
+            .describe('Zero-hit guidance — names the likely cause and the concrete next call.'),
+    },
+    errors: [
+        {
+            reason: 'stage_filter_mismatch',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'in_review_on was combined with stage: government_bills, or decided_from/to with stage: review_drafts — rejected locally before any upstream call; the message names the offending pair.',
+            recovery: 'Drop the named filter or switch stage: in_review_on applies only to stage: review_drafts; decided_from/to only to stage: government_bills.',
+        },
+        {
+            reason: 'invalid_query',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'RIS rejected a parameter value — the in-band Client error message is passed through verbatim; it names the invalid element and its valid values.',
+            recovery: 'Correct the parameter RIS names in the message. Ministry codes: ris_list_reference topic ministries.',
+        },
+        {
+            reason: 'upstream_error',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'RIS is unreachable, returned a server error, or served an HTML error page.',
+            retryable: true,
+            recovery: 'RIS is temporarily unavailable — retry after a short delay. If it persists, reduce page_size or narrow the query.',
+        },
+    ],
+    async handler(input, ctx) {
+        const { stage } = input;
+        const query = meaningful(input.query);
+        const title = meaningful(input.title);
+        const ministry = meaningful(input.ministry);
+        const inReviewOn = meaningful(input.in_review_on);
+        const decidedFrom = meaningful(input.decided_from);
+        const decidedTo = meaningful(input.decided_to);
+        const mismatch = (message) => ctx.fail('stage_filter_mismatch', message, { ...ctx.recoveryFor('stage_filter_mismatch') });
+        if (inReviewOn !== undefined && stage === 'government_bills') {
+            throw mismatch("in_review_on applies only to stage: review_drafts — got stage: 'government_bills'.");
+        }
+        if ((decidedFrom !== undefined || decidedTo !== undefined) && stage === 'review_drafts') {
+            throw mismatch(`${decidedFrom !== undefined ? 'decided_from' : 'decided_to'} applies only to stage: government_bills — got stage: 'review_drafts'.`);
+        }
+        const params = {
+            stage,
+            ...(query !== undefined && { query }),
+            ...(title !== undefined && { title }),
+            ...(ministry !== undefined && { ministry }),
+            ...(inReviewOn !== undefined && { inReviewOn }),
+            ...(decidedFrom !== undefined && { decidedFrom }),
+            ...(decidedTo !== undefined && { decidedTo }),
+            ...(input.changed_since !== undefined && { changedSince: input.changed_since }),
+            ...(input.sort_by !== undefined && { sortBy: input.sort_by }),
+            ...(input.sort_direction !== undefined && { sortDirection: input.sort_direction }),
+            ...(input.page !== undefined && { page: input.page }),
+            ...(input.page_size !== undefined && { pageSize: input.page_size }),
+        };
+        // Map in-band RIS errors onto this tool's declared contract so reason +
+        // recovery reach the wire (service-level throws carry neither).
+        const result = await getRisService()
+            .searchDrafts(params, ctx)
+            .catch((err) => {
+            if (err instanceof McpError && err.code === JsonRpcErrorCode.InvalidParams) {
+                throw ctx.fail('invalid_query', err.message, { ...ctx.recoveryFor('invalid_query') });
+            }
+            if (err instanceof McpError && err.code === JsonRpcErrorCode.ServiceUnavailable) {
+                throw ctx.fail('upstream_error', err.message, { ...ctx.recoveryFor('upstream_error') });
+            }
+            throw err;
+        });
+        ctx.log.info('Drafts search completed', {
+            hits: result.hits.length,
+            stage,
+            total: result.total,
+        });
+        ctx.enrich.total(result.total);
+        ctx.enrich({ page: result.page, pageSize: result.pageSize });
+        if (result.total > (result.page - 1) * result.pageSize + result.hits.length) {
+            ctx.enrich({ truncated: true });
+        }
+        if (result.total === 0) {
+            const fragments = [`0 ${stage} matched.`];
+            if (ministry !== undefined) {
+                fragments.push("ministry must match a RIS ministry designation — abbreviations are expanded server-side; the historical name at submission time counts ('BMDW', not today's successor). Table: ris_list_reference topic ministries.");
+            }
+            if (inReviewOn !== undefined) {
+                fragments.push(`No drafts in review on ${inReviewOn} matching the filters — drop in_review_on to search all drafts including closed reviews.`);
+            }
+            ctx.enrich.notice(fragments.join(' '));
+        }
+        return { results: result.hits.map((hit) => toRecord(hit, stage)) };
+    },
+    // format() populates content[] — the markdown twin of structuredContent. Every output
+    // field renders here; totals and paging ride the enrichment trailer.
+    format: (result) => {
+        if (result.results.length === 0) {
+            return [{ type: 'text', text: '_No pipeline documents on this page._' }];
+        }
+        const blocks = result.results.map((r) => {
+            const lines = [`## ${r.title ?? r.short_title ?? r.document_number}`];
+            lines.push(`**Document:** ${r.document_number} (${r.stage})`);
+            if (r.short_title !== undefined)
+                lines.push(`**Short title:** ${r.short_title}`);
+            if (r.ministry !== undefined)
+                lines.push(`**Ministry:** ${r.ministry}`);
+            const dates = [];
+            if (r.review_deadline !== undefined)
+                dates.push(`**Review deadline:** ${r.review_deadline}`);
+            if (r.decided !== undefined)
+                dates.push(`**Decided:** ${r.decided}`);
+            if (dates.length > 0)
+                lines.push(dates.join(' | '));
+            const urls = ['html', 'pdf', 'rtf', 'xml']
+                .filter((key) => r.content_urls[key] !== undefined)
+                .map((key) => `[${key.toUpperCase()}](${r.content_urls[key]})`);
+            if (urls.length > 0)
+                lines.push(`**Text:** ${urls.join(' · ')}`);
+            return lines.join('\n');
+        });
+        return [{ type: 'text', text: blocks.join('\n\n') }];
+    },
+});
+//# sourceMappingURL=ris-search-drafts.tool.js.map

package/dist/mcp-server/tools/definitions/ris-search-drafts.tool.js.map

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

package/dist/mcp-server/tools/definitions/ris-search-gazette.tool.d.ts

@@ -0,0 +1,147 @@
+/**
+ * @fileoverview ris_search_gazette — browse Austria's promulgation record at every level of
+ * government. `scope` selects the jurisdiction; the three federal era tiers (BgblAuth 2004+,
+ * BgblPdf 1945–2003, BgblAlt 1848–1940) are auto-routed by the year in the number or date
+ * range, and the resolved application is echoed in enrichment. State scopes pick a `series`
+ * (law vs ordinance gazette) and an `include_non_authentic` toggle; conditional filters are
+ * guarded locally before any upstream call. Ordinance gazettes (Vbl) currently cover Tirol
+ * only — a non-Tirol request short-circuits to a zero-hit notice rather than a server error.
+ * @module mcp-server/tools/definitions/ris-search-gazette
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import type { GazetteApplication } from '../../../services/ris/request-builder.js';
+import type { RisHit } from '../../../services/ris/types.js';
+export declare const GazetteRecordSchema: z.ZodObject<{
+    document_number: z.ZodString;
+    gazette_number: z.ZodOptional<z.ZodString>;
+    part: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+    published: z.ZodOptional<z.ZodString>;
+    issuer: z.ZodOptional<z.ZodString>;
+    district_authority: z.ZodOptional<z.ZodString>;
+    municipality: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    short_title: z.ZodOptional<z.ZodString>;
+    eli: z.ZodOptional<z.ZodString>;
+    binding: z.ZodEnum<{
+        authentic: "authentic";
+        consolidated_informational: "consolidated_informational";
+        historical_record: "historical_record";
+    }>;
+    authentic_pdf_url: z.ZodOptional<z.ZodString>;
+    alex_url: z.ZodOptional<z.ZodString>;
+    document_url: z.ZodOptional<z.ZodString>;
+    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>;
+}, z.core.$strip>;
+export type GazetteRecord = z.infer<typeof GazetteRecordSchema>;
+/** Map a normalized RIS hit to the tool's record shape (application drives the binding label). */
+export declare function toRecord(hit: RisHit, application: GazetteApplication): GazetteRecord;
+export declare const risSearchGazette: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    scope: z.ZodDefault<z.ZodEnum<{
+        burgenland: "burgenland";
+        kaernten: "kaernten";
+        niederoesterreich: "niederoesterreich";
+        oberoesterreich: "oberoesterreich";
+        salzburg: "salzburg";
+        steiermark: "steiermark";
+        tirol: "tirol";
+        vorarlberg: "vorarlberg";
+        wien: "wien";
+        district: "district";
+        federal: "federal";
+        municipal: "municipal";
+    }>>;
+    series: z.ZodOptional<z.ZodEnum<{
+        law_gazette: "law_gazette";
+        ordinance_gazette: "ordinance_gazette";
+    }>>;
+    include_non_authentic: z.ZodOptional<z.ZodBoolean>;
+    query: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    number: z.ZodOptional<z.ZodString>;
+    part: z.ZodOptional<z.ZodEnum<{
+        part1: "part1";
+        part2: "part2";
+        part3: "part3";
+        pre_1997: "pre_1997";
+    }>>;
+    type: z.ZodOptional<z.ZodEnum<{
+        other: "other";
+        announcements: "announcements";
+        laws: "laws";
+        regulations: "regulations";
+    }>>;
+    published_from: z.ZodOptional<z.ZodString>;
+    published_to: z.ZodOptional<z.ZodString>;
+    issuer: z.ZodOptional<z.ZodString>;
+    district_authority: z.ZodOptional<z.ZodString>;
+    municipality: z.ZodOptional<z.ZodString>;
+    sort_by: z.ZodOptional<z.ZodEnum<{
+        number: "number";
+        published: "published";
+    }>>;
+    sort_direction: z.ZodOptional<z.ZodEnum<{
+        ascending: "ascending";
+        descending: "descending";
+    }>>;
+    page: z.ZodOptional<z.ZodNumber>;
+    page_size: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<10>, z.ZodLiteral<20>, z.ZodLiteral<50>, z.ZodLiteral<100>]>>;
+}, z.core.$strip>, z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        document_number: z.ZodString;
+        gazette_number: z.ZodOptional<z.ZodString>;
+        part: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        published: z.ZodOptional<z.ZodString>;
+        issuer: z.ZodOptional<z.ZodString>;
+        district_authority: z.ZodOptional<z.ZodString>;
+        municipality: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        short_title: z.ZodOptional<z.ZodString>;
+        eli: z.ZodOptional<z.ZodString>;
+        binding: z.ZodEnum<{
+            authentic: "authentic";
+            consolidated_informational: "consolidated_informational";
+            historical_record: "historical_record";
+        }>;
+        authentic_pdf_url: z.ZodOptional<z.ZodString>;
+        alex_url: z.ZodOptional<z.ZodString>;
+        document_url: z.ZodOptional<z.ZodString>;
+        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>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "scope_filter_mismatch";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "A filter was combined with a scope that does not support it (part off federal; series/include_non_authentic off a state scope; district_authority off district; municipality off municipal; issuer outside federal/ordinance gazettes) — rejected locally before any upstream call; the message names the offending pair.";
+    readonly recovery: "Drop the named filter or adjust scope: part applies only to scope: federal; series and include_non_authentic only to a state scope; district_authority only to scope: district; municipality only to scope: municipal; issuer only to federal or ordinance gazettes. Semantics: ris_list_reference topic gazette_parts or applications.";
+}, {
+    readonly reason: "invalid_query";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "RIS rejected a parameter value — the in-band Client error message is passed through verbatim; it names the invalid element and its valid values.";
+    readonly recovery: "Correct the parameter RIS names in the message. Part and type semantics: ris_list_reference topic gazette_parts or law_types.";
+}, {
+    readonly reason: "upstream_error";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "RIS is unreachable, returned a server error, or served an HTML error page.";
+    readonly retryable: true;
+    readonly recovery: "RIS is temporarily unavailable — retry after a short delay. If it persists, reduce page_size or narrow the query.";
+}], {
+    readonly totalCount: z.ZodNumber;
+    readonly page: z.ZodNumber;
+    readonly pageSize: z.ZodNumber;
+    readonly truncated: z.ZodOptional<z.ZodBoolean>;
+    readonly servedApplication: z.ZodString;
+    readonly notice: z.ZodOptional<z.ZodString>;
+}>;
+//# sourceMappingURL=ris-search-gazette.tool.d.ts.map

package/dist/mcp-server/tools/definitions/ris-search-gazette.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ris-search-gazette.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/ris-search-gazette.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAG3E,OAAO,KAAK,EACV,kBAAkB,EAGnB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AA2FtD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;iBAsE+B,CAAC;AAEhE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAahE,kGAAkG;AAClG,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,kBAAkB,GAAG,aAAa,CA+DpF;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyV3B,CAAC"}