@cyanheads/ris-austria-mcp-server 0.1.5

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

@@ -0,0 +1,178 @@
+/**
+ * @fileoverview ris_search_case_law — search Austrian case law (Judikatur) in one
+ * court/tribunal application per call across the 17 court codes, including the
+ * Parteien-Transparenz-Senat (upts), which the service routes to the Sonstige controller.
+ * The full court-conditional filter matrix is guarded locally before any upstream call,
+ * and decision_kind / subject_area values are validated against the static reference
+ * tables — RIS silently ignores unknown params, so local strictness is the only safety.
+ * @module mcp-server/tools/definitions/ris-search-case-law
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import type { RisHit } from '../../../services/ris/types.js';
+export declare const CaseLawRecordSchema: z.ZodObject<{
+    document_number: z.ZodString;
+    court: z.ZodString;
+    organ: z.ZodOptional<z.ZodString>;
+    case_numbers: z.ZodArray<z.ZodString>;
+    decision_date: z.ZodOptional<z.ZodString>;
+    decision_type: z.ZodOptional<z.ZodString>;
+    decision_kind: z.ZodOptional<z.ZodString>;
+    party: z.ZodOptional<z.ZodString>;
+    summary: z.ZodOptional<z.ZodString>;
+    guiding_principle: z.ZodOptional<z.ZodString>;
+    norms_cited: z.ZodArray<z.ZodString>;
+    keywords: z.ZodOptional<z.ZodString>;
+    collection_number: z.ZodOptional<z.ZodString>;
+    ecli: z.ZodOptional<z.ZodString>;
+    decision_url: z.ZodOptional<z.ZodString>;
+    headnotes_url: z.ZodOptional<z.ZodString>;
+    legal_force_note: 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 CaseLawRecord = z.infer<typeof CaseLawRecordSchema>;
+/** Map a normalized RIS hit (Judikatur, or Sonstige for upts) to the tool's record shape. */
+export declare function toRecord(hit: RisHit, fallbackApplication: string): CaseLawRecord;
+export declare const risSearchCaseLaw: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    court: z.ZodEnum<{
+        vfgh: "vfgh";
+        vwgh: "vwgh";
+        justiz: "justiz";
+        bvwg: "bvwg";
+        lvwg: "lvwg";
+        dsk: "dsk";
+        normenliste: "normenliste";
+        dok: "dok";
+        pvak: "pvak";
+        gbk: "gbk";
+        uvs: "uvs";
+        asylgh: "asylgh";
+        ubas: "ubas";
+        umse: "umse";
+        bks: "bks";
+        verg: "verg";
+        upts: "upts";
+    }>;
+    query: z.ZodOptional<z.ZodString>;
+    norm: z.ZodOptional<z.ZodString>;
+    case_number: z.ZodOptional<z.ZodString>;
+    decision_type: z.ZodDefault<z.ZodEnum<{
+        headnote: "headnote";
+        full_text: "full_text";
+        all: "all";
+    }>>;
+    decided_from: z.ZodOptional<z.ZodString>;
+    decided_to: z.ZodOptional<z.ZodString>;
+    decision_kind: z.ZodOptional<z.ZodString>;
+    collection_number: z.ZodOptional<z.ZodString>;
+    issuing_body: z.ZodOptional<z.ZodString>;
+    court_name: z.ZodOptional<z.ZodString>;
+    legal_area: z.ZodOptional<z.ZodEnum<{
+        civil: "civil";
+        criminal: "criminal";
+    }>>;
+    subject_area: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodEnum<{
+        burgenland: "burgenland";
+        kaernten: "kaernten";
+        niederoesterreich: "niederoesterreich";
+        oberoesterreich: "oberoesterreich";
+        salzburg: "salzburg";
+        steiermark: "steiermark";
+        tirol: "tirol";
+        vorarlberg: "vorarlberg";
+        wien: "wien";
+    }>>;
+    party: z.ZodOptional<z.ZodString>;
+    commission: z.ZodOptional<z.ZodEnum<{
+        federal: "federal";
+        general: "general";
+    }>>;
+    senate: z.ZodOptional<z.ZodEnum<{
+        I: "I";
+        II: "II";
+        III: "III";
+    }>>;
+    discrimination_ground: z.ZodOptional<z.ZodEnum<{
+        Alter: "Alter";
+        EthnischeZugehoerigkeit: "EthnischeZugehoerigkeit";
+        Geschlecht: "Geschlecht";
+        Mehrfachdiskriminierung: "Mehrfachdiskriminierung";
+        Religion: "Religion";
+        SexuelleOrientierung: "SexuelleOrientierung";
+        Weltanschauung: "Weltanschauung";
+    }>>;
+    subject_law: z.ZodOptional<z.ZodString>;
+    changed_since: z.ZodOptional<z.ZodEnum<{
+        one_week: "one_week";
+        two_weeks: "two_weeks";
+        one_month: "one_month";
+        three_months: "three_months";
+        six_months: "six_months";
+        one_year: "one_year";
+    }>>;
+    sort_by: z.ZodOptional<z.ZodEnum<{
+        case_number: "case_number";
+        decision_date: "decision_date";
+    }>>;
+    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;
+        court: z.ZodString;
+        organ: z.ZodOptional<z.ZodString>;
+        case_numbers: z.ZodArray<z.ZodString>;
+        decision_date: z.ZodOptional<z.ZodString>;
+        decision_type: z.ZodOptional<z.ZodString>;
+        decision_kind: z.ZodOptional<z.ZodString>;
+        party: z.ZodOptional<z.ZodString>;
+        summary: z.ZodOptional<z.ZodString>;
+        guiding_principle: z.ZodOptional<z.ZodString>;
+        norms_cited: z.ZodArray<z.ZodString>;
+        keywords: z.ZodOptional<z.ZodString>;
+        collection_number: z.ZodOptional<z.ZodString>;
+        ecli: z.ZodOptional<z.ZodString>;
+        decision_url: z.ZodOptional<z.ZodString>;
+        headnotes_url: z.ZodOptional<z.ZodString>;
+        legal_force_note: 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: "court_filter_mismatch";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "A court-conditional filter was sent with the wrong court, or case_number/dates/decision_type were sent with normenliste (a norm index, not decisions) — rejected locally before any upstream call; the message names the offending pair.";
+    readonly recovery: "Drop the filter or switch court: issuing_body → dsk/dok/pvak/verg, court_name/legal_area/subject_area → justiz, state → lvwg/uvs, party → upts, commission/senate/discrimination_ground → gbk, subject_law → bks, collection_number → vfgh/vwgh/uvs. Court codes: ris_list_reference topic courts.";
+}, {
+    readonly reason: "invalid_query";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "A parameter value failed validation — decision_kind/subject_area checked locally against the reference tables, or RIS rejected the value in-band (message passed through verbatim).";
+    readonly recovery: "Correct the parameter RIS names in the message. Valid court codes, decision types/kinds, and syntax: ris_list_reference (topic: courts, decision_types, decision_kinds, or search_syntax).";
+}, {
+    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 notice: z.ZodOptional<z.ZodString>;
+}>;
+//# sourceMappingURL=ris-search-case-law.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ris-search-case-law.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/ris-search-case-law.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAkB3E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAkCtD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;iBAkEqD,CAAC;AAEtF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAahE,6FAA6F;AAC7F,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,GAAG,aAAa,CAwChF;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsa3B,CAAC"}