mcp-libraryofcongress 3.0.1 → 3.1.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 3.1.0
+
+- **The live canary no longer reports a slow night at the Library as a broken
+  contract.** A read that meets silence or push-back spends deadlines, waits and
+  spacing in series, and it says what the Library did only once it has spent them
+  all. The runner gave up first, so the case that was meant to be left out failed
+  the run instead. What a read can take is now published by the module that
+  spends it, the live suite takes its deadline from there, and tests hold the
+  bound to what a read actually takes.
+- **Node.js 24.22.1 or later**, inside the Node.js 24 line. The package, the
+  extension manifest and the image all declare it.
+- **zod `^4.6.7`.** Below 4.6.6, zod can exhaust memory while
+  validating oversized constrained collections, and the range accepts none of
+  those versions.
+- **Dependency floors:** `@modelcontextprotocol/sdk` `^1.32.2`.
+
 ## 3.0.1
 
 - **Every tool is documented, with its arguments and what its answer carries.**

package/README.md

@@ -6,6 +6,7 @@
 [![MCP Registry](https://img.shields.io/badge/MCP_Registry-listed-6E56CF)](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.smeet666/mcp-libraryofcongress)
 [![Glama](https://glama.ai/mcp/servers/smeet666/mcp-libraryofcongress/badges/score.svg)](https://glama.ai/mcp/servers/smeet666/mcp-libraryofcongress)
 [![M8ven](https://m8ven.ai/badge/mcp/smeet666-mcp-libraryofcongress-1rr3lc?variant=verified)](https://m8ven.ai/mcp/smeet666-mcp-libraryofcongress-1rr3lc)
+[![LobeHub](https://lobehub.com/badge/mcp/smeet666-mcp-libraryofcongress)](https://lobehub.com/mcp/smeet666-mcp-libraryofcongress)
 [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=libraryofcongress&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm1jcC1saWJyYXJ5b2Zjb25ncmVzcyJdfQ%3D%3D)
 [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=libraryofcongress&config=%7B%22name%22%3A%22libraryofcongress%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22mcp-libraryofcongress%22%5D%7D)
 
@@ -64,7 +65,7 @@ Node 24 or later is required, and no environment variable has to be set.
   "mcpServers": {
     "libraryofcongress": {
       "command": "docker",
-      "args": ["run", "-i", "--rm", "ghcr.io/smeet666/mcp-libraryofcongress:3.0.1"]
+      "args": ["run", "-i", "--rm", "ghcr.io/smeet666/mcp-libraryofcongress:3.1.0"]
     }
   }
 }
@@ -77,7 +78,7 @@ port, no credential.
 
 ### Bundle, without npm
 
-Download `mcp-libraryofcongress-3.0.1.mcpb` from
+Download `mcp-libraryofcongress-3.1.0.mcpb` from
 [the latest release](https://github.com/smeet666/mcp-libraryofcongress/releases/latest)
 and open it. A client that supports MCP bundles installs it on its own, with no
 npm and no configuration file to edit. The bundle carries its dependencies, so
@@ -363,7 +364,7 @@ renseigner.
   "mcpServers": {
     "libraryofcongress": {
       "command": "docker",
-      "args": ["run", "-i", "--rm", "ghcr.io/smeet666/mcp-libraryofcongress:3.0.1"]
+      "args": ["run", "-i", "--rm", "ghcr.io/smeet666/mcp-libraryofcongress:3.1.0"]
     }
   }
 }
@@ -376,7 +377,7 @@ aucun volume, aucun port, aucun identifiant.
 
 ### Bundle, sans npm
 
-Téléchargez `mcp-libraryofcongress-3.0.1.mcpb` depuis
+Téléchargez `mcp-libraryofcongress-3.1.0.mcpb` depuis
 [la dernière publication](https://github.com/smeet666/mcp-libraryofcongress/releases/latest)
 et ouvrez-le. Un client qui gère les bundles MCP l'installe seul, sans npm et
 sans fichier de configuration à modifier. Le bundle emporte ses dépendances, donc

package/dist/index.js

@@ -11,7 +11,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import process from "process";
 
 // src/version.ts
-var PKG_VERSION = "3.0.1";
+var PKG_VERSION = "3.1.0";
 var REPO_URL = "https://github.com/smeet666/mcp-libraryofcongress";
 
 // src/config.ts
@@ -164,6 +164,73 @@ var Cache = class {
   }
 };
 
+// src/loc/rateLimiter.ts
+var WIDEST_SPACING_FACTOR = 8;
+var RateLimiter = class {
+  baseIntervalMs;
+  maxIntervalMs;
+  intervalMs;
+  lastStartedAt = 0;
+  queue = Promise.resolve();
+  calmStreak = 0;
+  constructor(options) {
+    this.baseIntervalMs = options.intervalMs;
+    this.maxIntervalMs = options.maxIntervalMs ?? options.intervalMs * WIDEST_SPACING_FACTOR;
+    this.intervalMs = options.intervalMs;
+  }
+  /** The spacing in force, which callers report rather than guess. */
+  get currentIntervalMs() {
+    return this.intervalMs;
+  }
+  /**
+   * Run `task` with nothing else in flight.
+   *
+   * This only serialises. Spacing is claimed per attempt through
+   * `beforeRequest`, because a task that retries makes several requests and
+   * each of them owes the site the same gap.
+   */
+  schedule(task) {
+    const result = this.queue.then(task, task);
+    this.queue = result.then(
+      () => void 0,
+      () => void 0
+    );
+    return result;
+  }
+  /** Wait until enough time has passed since the previous request began. */
+  async beforeRequest() {
+    const elapsed = Date.now() - this.lastStartedAt;
+    const wait = Math.min(this.intervalMs, this.intervalMs - elapsed);
+    if (wait > 0) {
+      await sleep(wait);
+    }
+    this.lastStartedAt = Date.now();
+  }
+  /** Called when the site asks for room: double the gap, up to the ceiling. */
+  pushBack() {
+    this.calmStreak = 0;
+    this.intervalMs = Math.min(this.maxIntervalMs, this.intervalMs * 2);
+  }
+  /**
+   * Called on a clean answer. Recovery takes several in a row, so one lucky
+   * response after a rough patch does not undo the caution that earned it.
+   */
+  succeeded() {
+    if (this.intervalMs === this.baseIntervalMs) {
+      return;
+    }
+    this.calmStreak += 1;
+    if (this.calmStreak < 3) {
+      return;
+    }
+    this.calmStreak = 0;
+    this.intervalMs = Math.max(this.baseIntervalMs, Math.round(this.intervalMs / 2));
+  }
+};
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
 // src/loc/http.ts
 var ZERO_MAX_AGE = /^(?:max-age|s-maxage)\s*=\s*0$/;
 var RETRYABLE = /* @__PURE__ */ new Set([408, 425, 429, 500, 502, 503, 504]);
@@ -1133,72 +1200,6 @@ function toCollections(payload, url, onSkip, settled = true) {
   return { paging: toPaging(payload, url, settled), collections };
 }
 
-// src/loc/rateLimiter.ts
-var RateLimiter = class {
-  baseIntervalMs;
-  maxIntervalMs;
-  intervalMs;
-  lastStartedAt = 0;
-  queue = Promise.resolve();
-  calmStreak = 0;
-  constructor(options) {
-    this.baseIntervalMs = options.intervalMs;
-    this.maxIntervalMs = options.maxIntervalMs ?? options.intervalMs * 8;
-    this.intervalMs = options.intervalMs;
-  }
-  /** The spacing in force, which callers report rather than guess. */
-  get currentIntervalMs() {
-    return this.intervalMs;
-  }
-  /**
-   * Run `task` with nothing else in flight.
-   *
-   * This only serialises. Spacing is claimed per attempt through
-   * `beforeRequest`, because a task that retries makes several requests and
-   * each of them owes the site the same gap.
-   */
-  schedule(task) {
-    const result = this.queue.then(task, task);
-    this.queue = result.then(
-      () => void 0,
-      () => void 0
-    );
-    return result;
-  }
-  /** Wait until enough time has passed since the previous request began. */
-  async beforeRequest() {
-    const elapsed = Date.now() - this.lastStartedAt;
-    const wait = Math.min(this.intervalMs, this.intervalMs - elapsed);
-    if (wait > 0) {
-      await sleep(wait);
-    }
-    this.lastStartedAt = Date.now();
-  }
-  /** Called when the site asks for room: double the gap, up to the ceiling. */
-  pushBack() {
-    this.calmStreak = 0;
-    this.intervalMs = Math.min(this.maxIntervalMs, this.intervalMs * 2);
-  }
-  /**
-   * Called on a clean answer. Recovery takes several in a row, so one lucky
-   * response after a rough patch does not undo the caution that earned it.
-   */
-  succeeded() {
-    if (this.intervalMs === this.baseIntervalMs) {
-      return;
-    }
-    this.calmStreak += 1;
-    if (this.calmStreak < 3) {
-      return;
-    }
-    this.calmStreak = 0;
-    this.intervalMs = Math.max(this.baseIntervalMs, Math.round(this.intervalMs / 2));
-  }
-};
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
 // src/loc/client.ts
 function withGuarantees(config) {
   const defaults = loadConfig({});
@@ -1444,7 +1445,7 @@ function indentMarkerLines(body) {
   return body.replace(/^(Note:|Source:)/gm, " $1");
 }
 function ok(structured, body, options = {}) {
-  const credit = options.sourceUrl ? `${ATTRIBUTION} \u2014 ${options.sourceUrl}` : ATTRIBUTION;
+  const credit = options.sourceUrl ? `${ATTRIBUTION} (${options.sourceUrl})` : ATTRIBUTION;
   const noteLines = (options.notes ?? []).map((note) => `Note: ${note}`);
   while (noteLines.length > 0 && noteLines.join("\n").length > MAX_TEXT_CHARS / 2) {
     noteLines.pop();
@@ -1685,7 +1686,7 @@ async function runGetItem(client, args) {
     if (resources && resources.length > 0) {
       lines.push("", "Copies served online:");
       for (const resource of resources) {
-        lines.push(`  ${resource.caption ?? "copy"}${resource.url ? ` \u2014 ${resource.url}` : ""}`);
+        lines.push(`  ${resource.caption ?? "copy"}${resource.url ? `: ${resource.url}` : ""}`);
       }
     }
     return ok(structured, lines.join("\n"), { notes, sourceUrl: data.sourceUrl });