@cyanheads/ris-austria-mcp-server 0.2.0 → 0.2.2

package/AGENTS.md

@@ -1,8 +1,8 @@
 # Developer Protocol
 
 **Server:** ris-austria-mcp-server
-**Version:** 0.2.0
-**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.10.14`
+**Version:** 0.2.2
+**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.11.0`
 **Engines:** Bun ≥1.3.0, Node ≥24.0.0
 **MCP SDK:** `@modelcontextprotocol/sdk` ^1.29.0
 **Zod:** ^4.4.3
@@ -334,7 +334,7 @@ When you complete a skill's checklist, check the boxes and add a completion time
 
 ## Bundling
 
-`npm run bundle` produces a `.mcpb` extension bundle for one-click install in Claude Desktop. The pack step is followed by `scripts/clean-mcpb.ts`, which prunes dev dependencies (`mcpb clean`) and strips dependency-shipped agent docs (`node_modules/**` `skills/`, `.claude/`, `.agents/`, `SKILL.md`) that root-anchored `.mcpbignore` patterns cannot reach. MCPB is stdio-only — HTTP and Cloudflare Workers deployments are unaffected. Consumers who don't need it can delete `manifest.json` and `.mcpbignore`; `lint:packaging` skips cleanly.
+`npm run bundle` produces a `.mcpb` extension bundle for one-click install in Claude Desktop. The pack step is followed by `scripts/clean-mcpb.ts`, which prunes dev dependencies (`mcpb clean`) and strips two classes of `node_modules/**` content that root-anchored `.mcpbignore` patterns cannot reach: dependency-shipped agent docs (`skills/`, `.claude/`, `.agents/`, `SKILL.md`) and platform-specific native bindings, which would otherwise lock the bundle to the platform it was packed on. A server using DataCanvas therefore ships a portable bundle without the DuckDB native — `@duckdb/node-api` is an optional peer loaded lazily, so canvas tools report an actionable install hint and every other tool works normally. MCPB is stdio-only — HTTP and Cloudflare Workers deployments are unaffected. Consumers who don't need it can delete `manifest.json` and `.mcpbignore`; `lint:packaging` skips cleanly.
 
 **Adding an env var requires both files:** `server.json` (registry discovery, `environmentVariables[]`) and `manifest.json` (bundle install UX, `mcp_config.env` + `user_config`). `lint:packaging` (run by `devcheck`) verifies the env var names match.
 

package/CLAUDE.md

@@ -1,8 +1,8 @@
 # Developer Protocol
 
 **Server:** ris-austria-mcp-server
-**Version:** 0.2.0
-**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.10.14`
+**Version:** 0.2.2
+**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.11.0`
 **Engines:** Bun ≥1.3.0, Node ≥24.0.0
 **MCP SDK:** `@modelcontextprotocol/sdk` ^1.29.0
 **Zod:** ^4.4.3
@@ -334,7 +334,7 @@ When you complete a skill's checklist, check the boxes and add a completion time
 
 ## Bundling
 
-`npm run bundle` produces a `.mcpb` extension bundle for one-click install in Claude Desktop. The pack step is followed by `scripts/clean-mcpb.ts`, which prunes dev dependencies (`mcpb clean`) and strips dependency-shipped agent docs (`node_modules/**` `skills/`, `.claude/`, `.agents/`, `SKILL.md`) that root-anchored `.mcpbignore` patterns cannot reach. MCPB is stdio-only — HTTP and Cloudflare Workers deployments are unaffected. Consumers who don't need it can delete `manifest.json` and `.mcpbignore`; `lint:packaging` skips cleanly.
+`npm run bundle` produces a `.mcpb` extension bundle for one-click install in Claude Desktop. The pack step is followed by `scripts/clean-mcpb.ts`, which prunes dev dependencies (`mcpb clean`) and strips two classes of `node_modules/**` content that root-anchored `.mcpbignore` patterns cannot reach: dependency-shipped agent docs (`skills/`, `.claude/`, `.agents/`, `SKILL.md`) and platform-specific native bindings, which would otherwise lock the bundle to the platform it was packed on. A server using DataCanvas therefore ships a portable bundle without the DuckDB native — `@duckdb/node-api` is an optional peer loaded lazily, so canvas tools report an actionable install hint and every other tool works normally. MCPB is stdio-only — HTTP and Cloudflare Workers deployments are unaffected. Consumers who don't need it can delete `manifest.json` and `.mcpbignore`; `lint:packaging` skips cleanly.
 
 **Adding an env var requires both files:** `server.json` (registry discovery, `environmentVariables[]`) and `manifest.json` (bundle install UX, `mcp_config.env` + `user_config`). `lint:packaging` (run by `devcheck`) verifies the env var names match.
 

package/Dockerfile

@@ -60,7 +60,7 @@ RUN --mount=type=cache,target=/root/.bun/install/cache \
 ARG OTEL_ENABLED=true
 RUN --mount=type=cache,target=/root/.bun/install/cache \
     if [ "$OTEL_ENABLED" = "true" ]; then \
-      bun add @hono/otel \
+      bun add --omit=dev --ignore-scripts @hono/otel \
         @opentelemetry/instrumentation-http \
         @opentelemetry/exporter-metrics-otlp-http \
         @opentelemetry/exporter-trace-otlp-http \

package/README.md

@@ -7,7 +7,7 @@
 
 <div align="center">
 
-[![Version](https://img.shields.io/badge/Version-0.2.0-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/ris-austria-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/ris-austria-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/ris-austria-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^6.0.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3.2-blueviolet.svg?style=flat-square)](https://bun.sh/)
+[![Version](https://img.shields.io/badge/Version-0.2.2-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/ris-austria-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/ris-austria-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/ris-austria-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^7.0.2-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3.2-blueviolet.svg?style=flat-square)](https://bun.sh/)
 
 </div>
 

package/changelog/0.2.x/0.2.1.md

@@ -0,0 +1,25 @@
+---
+summary: "Schema-valid rejections, generic upstream 5xx, and slow content renders now carry the declared error contract instead of a bare undocumented code."
+breaking: false
+security: false
+---
+
+# 0.2.1 — 2026-07-26
+
+## Added
+
+- **`upstream_timeout` error reason** on every network-backed tool (`ris_search_legislation`, `ris_search_case_law`, `ris_search_gazette`, `ris_search_drafts`, `ris_search_announcements`, `ris_track_changes`, `ris_lookup_citation`, `ris_get_document`) and the `ris://document/{application}/{documentNumber}` resource — code `Timeout` (-32004), `retryable: true`, with recovery distinct from a degraded upstream. `ctx.fail` resolves its code from the contract entry, so folding a deadline into `upstream_error` would report -32000 for it. ([#15](https://github.com/cyanheads/ris-austria-mcp-server/issues/15), [#21](https://github.com/cyanheads/ris-austria-mcp-server/issues/21))
+- **`failSearchError`** in `src/mcp-server/tools/definitions/_shared.ts` — a shared mapper wired into every search-family tool's `.catch()`, mapping `ValidationError`/`InvalidParams` to `invalid_query`, `ServiceUnavailable` to `upstream_error`, and `Timeout` to `upstream_timeout`. Each tool still declares its own `errors[]` contract; the mapper only resolves the reason. ([#12](https://github.com/cyanheads/ris-austria-mcp-server/issues/12))
+
+## Changed
+
+- **Schema-valid request-builder rejections** — an unsupported-but-valid combination (a `sort_by` column the target application has no mapping for, an unresolvable `ministry`/`issuer`, a gazette `state_era` a state doesn't carry) now lands on the tool's declared `invalid_query` contract with `reason` and recovery, instead of a bare `-32007 ValidationError` with no `reason` in `data`. Reproduces and is fixed across `ris_search_case_law`, `ris_search_gazette`, `ris_search_announcements`, and `ris_search_drafts`. Recovery hints no longer claim RIS named the parameter — for a local rejection, it didn't. ([#12](https://github.com/cyanheads/ris-austria-mcp-server/issues/12))
+- **Generic upstream HTTP 5xx** — `RisService` reclassifies an upstream 500/501 carrying no RIS `OgdSearchResult.Error` envelope from a bare `InternalError` (-32603, no `reason`, no `retryable`, no recovery) to `ServiceUnavailable`, so `ris_search_legislation`, `ris_get_document`, and the `ris://document/…` resource now surface their declared `upstream_error` (-32000, `retryable: true`, recovery). The gate keys on the canonical `error.data.status` field (a 500+ value), which also excludes an abort-sourced `InternalError` (no `status`) from reclassification. Runs after the RIS in-band error-envelope translation gets its chance, so a 500 carrying `OgdSearchResult.Error` still becomes `InvalidParams`. ([#15](https://github.com/cyanheads/ris-austria-mcp-server/issues/15))
+- **`CONTENT_TIMEOUT_MS`** 20s → **25s**, and `fetchDocumentContent` now caps at `maxRetries: 1` (2 attempts) instead of `withRetry`'s default of 4 — worst case ~51–52s, inside the MCP SDK's 60s default request timeout (the prior 20s × 4 attempts ran ~93s, past that budget). The content host renders a document on first request and caches it; a render that finishes between attempt 1 and attempt 2 is served from cache on the retry, so the second attempt is still worth making. `SEARCH_TIMEOUT_MS` (15s) is unaffected. ([#21](https://github.com/cyanheads/ris-austria-mcp-server/issues/21))
+- **Content fetches pass `expectedStatuses: [404]`** — a mistyped `document_number` (the most common caller error) now logs at `debug` instead of `error`; 500 is deliberately excluded from the list since a genuine server fault and a RIS input-error 500 are indistinguishable by status.
+- **`@cyanheads/mcp-ts-core`** `^0.10.14` → `^0.11.0`, `typescript` `^6.0.3` → `^7.0.2`, `@biomejs/biome` `2.5.2` → `2.5.5`, `tsc-alias` `^1.8.17` → `^1.9.1`, `vitest` `^4.1.8` → `^4.1.10`. Project skills, scaffold scripts (`clean-mcpb.ts`, `lint-packaging.ts`, `check-dependency-specifiers.ts`, `devcheck.ts`), and template files (`Dockerfile`, `.gitignore`, `devcheck.config.json`) synced from the framework's `0.11.0` templates.
+
+## Fixed
+
+- **`ris_get_document` and the `ris://document/…` resource no longer report a slow cold render as a retryable `upstream_error`** after ~80s of retrying — they now report `upstream_timeout` (or succeed on the retry that lands in cache). A wrong `document_number` still renders a slow 404 indistinguishable from a real cold render on the first attempt; the `upstream_timeout` recovery hint says to check the number against a fresh search result, or re-call with `format: urls_only` and fetch the URL without this deadline. ([#21](https://github.com/cyanheads/ris-austria-mcp-server/issues/21))
+

package/changelog/0.2.x/0.2.2.md

@@ -0,0 +1,18 @@
+---
+summary: "ris_get_document: malformed document_url escapes, duplicated screen-reader citations, and unmatched section selectors now surface their real outcome instead of falling back silently."
+breaking: false
+security: false
+---
+
+# 0.2.2 — 2026-07-26
+
+## Changed
+
+- **`selectDocumentSections()`** returns `{ available, text, unmatched }` instead of `string | undefined` — the selector's full outcome (matched text, unmatched names, the document's full section roster) instead of a bare hit/miss.
+- **`renderOutlineSections()`** drops the hardcoded "document too large to inline" header — the same roster now renders for both a byte-budget overflow and a selector mismatch, so the accompanying notice carries the reason instead of the header.
+
+## Fixed
+
+- **`parseDocumentUrl`** — a malformed percent escape in a `document_url`'s document-number or filename position (e.g. `%ZZ`) no longer lets a native `URIError` escape the errors-as-values boundary; it now maps to the declared `unsupported_url` reason with recovery, in place of a bare `-32007 URI malformed` with no `reason`. ([#13](https://github.com/cyanheads/ris-austria-mcp-server/issues/13))
+- **`ris_get_document` markdown / the `ris://document/…` resource** — drop the `.sr-only` screen-reader twin RIS ships beside every abbreviated citation before HTML→markdown conversion, registered across all six node-html-markdown translator collections (RIS's Inhaltsverzeichnis and Anmerkungen tables carry twins inside table cells, a separate translator collection from the top level). Cuts payload 38–45% on affected documents — `BrKons` NOR40262691 71,655 B → 44,522 B, `RegV` REGV_3A68CE39_6184_4BBF_8F02_57236DCABE91 353,294 B → 195,652 B — and `byte_size` / outline `DocumentSection.bytes` now report the real rendered size. `html` and `xml` renditions are untouched. ([#16](https://github.com/cyanheads/ris-austria-mcp-server/issues/16))
+- **`ris_get_document` `sections:[…]` selector** — an unmatched selector no longer silently returns the whole document when under the byte budget. A total miss now returns the section outline (`kind: outline`) with a notice distinguishing a selector mismatch from a size overflow; a partial miss returns the matched sections plus a notice naming the dropped entries; a rendition with no addressable sections returns whole with a notice explaining why the selector was ignored. ([#20](https://github.com/cyanheads/ris-austria-mcp-server/issues/20))

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

@@ -26,5 +26,11 @@ export declare const risDocumentResource: import("@cyanheads/mcp-ts-core").Resou
     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.";
+}, {
+    readonly reason: "upstream_timeout";
+    readonly code: JsonRpcErrorCode.Timeout;
+    readonly when: "The content host did not return the rendition within the fetch deadline — typically a cold render, which it performs on first request before caching the result.";
+    readonly retryable: true;
+    readonly recovery: "Retry the identical read once or twice — the host renders a document on first request and caches it, so a later read often returns instantly. If it keeps timing out, check the document number against a fresh search result (a wrong number renders a slow 404 that looks identical), or use ris_get_document with format: urls_only and fetch the rendition URL yourself, without this deadline.";
 }]>;
 //# sourceMappingURL=ris-document.resource.d.ts.map

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;GA2F9B,CAAC"}

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

@@ -43,6 +43,13 @@ export const risDocumentResource = resource('ris://document/{application}/{docum
             retryable: true,
             recovery: 'The RIS content host is temporarily unavailable — retry the read after a short delay.',
         },
+        {
+            reason: 'upstream_timeout',
+            code: JsonRpcErrorCode.Timeout,
+            when: 'The content host did not return the rendition within the fetch deadline — typically a cold render, which it performs on first request before caching the result.',
+            retryable: true,
+            recovery: 'Retry the identical read once or twice — the host renders a document on first request and caches it, so a later read often returns instantly. If it keeps timing out, check the document number against a fresh search result (a wrong number renders a slow 404 that looks identical), or use ris_get_document with format: urls_only and fetch the rendition URL yourself, without this deadline.',
+        },
     ],
     async handler(params, ctx) {
         // Map framework errors from resolution/fetch onto this resource's declared contract.
@@ -57,6 +64,14 @@ export const risDocumentResource = resource('ris://document/{application}/{docum
                 if (err.code === JsonRpcErrorCode.ServiceUnavailable) {
                     throw ctx.fail('upstream_error', err.message, { ...ctx.recoveryFor('upstream_error') });
                 }
+                // Its own reason, not a widened upstream_error guard: `ctx.fail` resolves the code
+                // from the contract entry, so folding a deadline into upstream_error would report
+                // -32000 for it — and the two want different recovery (degraded host vs. cold render).
+                if (err.code === JsonRpcErrorCode.Timeout) {
+                    throw ctx.fail('upstream_timeout', err.message, {
+                        ...ctx.recoveryFor('upstream_timeout'),
+                    });
+                }
             }
             throw err;
         });

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

@@ -1 +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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"}
+{"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

@@ -1,8 +1,32 @@
 /**
- * @fileoverview Shared Zod schemas reused across multiple tool definitions.
+ * @fileoverview Shared Zod schemas and error-contract plumbing reused across multiple tool
+ * definitions.
  * @module mcp-server/tools/definitions/_shared
  */
+import type { TypedFail, TypedRecoveryFor } from '@cyanheads/mcp-ts-core';
 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;
+/**
+ * The three reasons every search-family tool declares for a failure raised below the
+ * handler — in the request builder or in `RisService`. Each tool still declares its own
+ * full `errors[]` inline (the contract is part of its public surface); this union is only
+ * the subset {@link failSearchError} resolves against.
+ */
+type SearchFailureReason = 'invalid_query' | 'upstream_error' | 'upstream_timeout';
+/** The slice of a handler `ctx` {@link failSearchError} needs. */
+interface SearchFailureContext {
+    readonly fail: TypedFail<SearchFailureReason>;
+    readonly recoveryFor: TypedRecoveryFor<SearchFailureReason>;
+}
+/**
+ * Map a request-builder or service failure onto the declared contract, so `reason` and
+ * `recovery` reach the wire — neither the builder's `validationError` nor the service's
+ * framework errors carry either on their own. An unmapped code is returned untouched for
+ * the framework to classify.
+ *
+ * Returns the error for the caller to `throw`, keeping the throw visible at the call site.
+ */
+export declare function failSearchError(error: unknown, ctx: SearchFailureContext): unknown;
+export {};
 //# sourceMappingURL=_shared.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/_shared.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAG3C,yFAAyF;AACzF,eAAO,MAAM,aAAa,aAEkD,CAAC;AAE7E;;;;;GAKG;AACH,KAAK,mBAAmB,GAAG,eAAe,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;AAEnF,kEAAkE;AAClE,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,mBAAmB,CAAC,CAAC;IAC9C,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC,mBAAmB,CAAC,CAAC;CAC7D;AAoBD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAMlF"}

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

@@ -1,10 +1,45 @@
 /**
- * @fileoverview Shared Zod schemas reused across multiple tool definitions.
+ * @fileoverview Shared Zod schemas and error-contract plumbing reused across multiple tool
+ * definitions.
  * @module mcp-server/tools/definitions/_shared
  */
 import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
 /** 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.');
+/**
+ * Framework codes raised below the handler, mapped to the contract reason describing them.
+ *
+ * - `ValidationError` — a schema-valid but unsupported parameter combination the request
+ *   builder rejected locally, before any upstream call.
+ * - `InvalidParams` — RIS rejected a parameter value in its in-band error envelope.
+ * - `ServiceUnavailable` — RIS unreachable, degraded, or serving an HTML error page.
+ * - `Timeout` — the request deadline elapsed. Its own reason rather than a widened
+ *   `upstream_error` guard: `ctx.fail` resolves the code from the contract entry, so folding
+ *   the two would put -32000 back on the wire for every deadline.
+ */
+const REASON_BY_CODE = new Map([
+    [JsonRpcErrorCode.ValidationError, 'invalid_query'],
+    [JsonRpcErrorCode.InvalidParams, 'invalid_query'],
+    [JsonRpcErrorCode.ServiceUnavailable, 'upstream_error'],
+    [JsonRpcErrorCode.Timeout, 'upstream_timeout'],
+]);
+/**
+ * Map a request-builder or service failure onto the declared contract, so `reason` and
+ * `recovery` reach the wire — neither the builder's `validationError` nor the service's
+ * framework errors carry either on their own. An unmapped code is returned untouched for
+ * the framework to classify.
+ *
+ * Returns the error for the caller to `throw`, keeping the throw visible at the call site.
+ */
+export function failSearchError(error, ctx) {
+    if (!(error instanceof McpError))
+        return error;
+    const reason = REASON_BY_CODE.get(error.code);
+    return reason === undefined
+        ? error
+        : ctx.fail(reason, error.message, { ...ctx.recoveryFor(reason) });
+}
 //# sourceMappingURL=_shared.js.map

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

@@ -1 +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"}
+{"version":3,"file":"_shared.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/_shared.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAE3E,yFAAyF;AACzF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,MAAM,EAAE;KACR,KAAK,CAAC,sBAAsB,EAAE,0CAA0C,CAAC,CAAC;AAgB7E;;;;;;;;;;GAUG;AACH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAwC;IACpE,CAAC,gBAAgB,CAAC,eAAe,EAAE,eAAe,CAAC;IACnD,CAAC,gBAAgB,CAAC,aAAa,EAAE,eAAe,CAAC;IACjD,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;IACvD,CAAC,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,CAAC;CAC/C,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc,EAAE,GAAyB;IACvE,IAAI,CAAC,CAAC,KAAK,YAAY,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/C,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,MAAM,KAAK,SAAS;QACzB,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACtE,CAAC"}

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

@@ -5,9 +5,12 @@
  * `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
+ * `format_unavailable` notice on a success result, never an error. Markdown conversion drops
+ * the `.sr-only` screen-reader twin RIS ships beside every abbreviated citation, keeping the
+ * visible form; `html` and `xml` pass through untouched. 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, and a selector matching nothing gets
+ * the outline back with a notice rather than the whole document. The shared
  * {@link renderDocument} helper backs both this tool and the `ris://document/…` resource.
  * @module mcp-server/tools/definitions/ris-get-document
  */
@@ -81,13 +84,23 @@ export interface DocumentSection {
  * html/xml rendition) — the caller reads that as "nothing to outline".
  */
 export declare function segmentDocument(text: string): DocumentSection[];
+/** Outcome of resolving a `sections:[…]` selector against a rendered document. */
+export interface SectionSelection {
+    /** The document's whole section roster, largest first — what the caller can re-pick from. */
+    readonly available: SectionMeta[];
+    /** Concatenated text of the matched sections, in document order; `''` when none matched. */
+    readonly text: string;
+    /** Requested names that matched no section, in the order requested. */
+    readonly unmatched: string[];
+}
 /**
- * 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.
+ * Resolve a `sections:[…]` selector against rendered document text — 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.
+ * Reports the unmatched names and the full roster alongside the matched text so the handler
+ * can disclose a mismatch instead of silently returning something the caller didn't ask for.
  */
-export declare function selectDocumentSections(text: string, want: readonly string[]): string | undefined;
+export declare function selectDocumentSections(text: string, want: readonly string[]): SectionSelection;
 /**
  * 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
@@ -100,9 +113,11 @@ export declare function outlineDocument(text: string, notice: (sections: Section
 /** 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.
+ * Render an 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. Deliberately says nothing about *why* the outline was
+ * returned: the tool emits one both on a byte overflow and on an unmatched `sections`
+ * selector, and the accompanying notice is what separates the two.
  */
 export declare function renderOutlineSections(sections: readonly SectionMeta[]): string;
 /**
@@ -120,18 +135,18 @@ export declare const risGetDocument: import("@cyanheads/mcp-ts-core").ToolDefini
     document_url: z.ZodOptional<z.ZodString>;
     format: z.ZodDefault<z.ZodEnum<{
         html: "html";
-        xml: "xml";
         markdown: "markdown";
         urls_only: "urls_only";
+        xml: "xml";
     }>>;
     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";
+        xml: "xml";
     }>;
     byte_size: z.ZodOptional<z.ZodNumber>;
     truncated: z.ZodOptional<z.ZodBoolean>;
@@ -144,13 +159,13 @@ export declare const risGetDocument: import("@cyanheads/mcp-ts-core").ToolDefini
         bytes: z.ZodNumber;
     }, z.core.$strip>>>;
     binding_status: z.ZodEnum<{
-        translation: "translation";
+        administrative_directive: "administrative_directive";
         authentic: "authentic";
         consolidated_informational: "consolidated_informational";
-        historical_record: "historical_record";
         decision: "decision";
+        historical_record: "historical_record";
         preparatory: "preparatory";
-        administrative_directive: "administrative_directive";
+        translation: "translation";
     }>;
     content_urls: z.ZodObject<{
         xml: z.ZodOptional<z.ZodString>;
@@ -182,6 +197,12 @@ export declare const risGetDocument: import("@cyanheads/mcp-ts-core").ToolDefini
     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 reason: "upstream_timeout";
+    readonly code: JsonRpcErrorCode.Timeout;
+    readonly when: "The content host did not return the rendition within the fetch deadline — typically a cold render, which it performs on first request before caching the result.";
+    readonly retryable: true;
+    readonly recovery: "Retry the identical call once or twice — the host renders a document on first request and caches it, so a later fetch often returns instantly. If it keeps timing out, check document_number against a fresh search result (a wrong number renders a slow 404 that looks identical), then re-call with format: urls_only and fetch content_urls yourself, without this deadline.";
 }], {
     readonly notice: z.ZodOptional<z.ZodString>;
 }>;

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

@@ -1 +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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"}
+{"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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"}