mcp-databnf 1.0.0 → 1.0.1

package/dist/index.js

@@ -7,7 +7,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 // src/version.ts
-var PKG_VERSION = "1.0.0";
+var PKG_VERSION = "1.0.1";
 var REPO_URL = "https://github.com/smeet666/mcp-databnf";
 
 // src/config.ts
@@ -1395,6 +1395,14 @@ function truncate(text2, maxChars) {
   return `${text2.slice(0, Math.max(0, maxChars - 1)).trimEnd()}\u2026`;
 }
 var NO_RANKING = "The full-text index answers whether a record matches, and it does not score how well. These rows are in the order the index returned them, so the row a person would call the obvious answer can sit anywhere in the list, or on a later page.";
+async function classifyEmptyPage(page2, firstPageHasRow) {
+  if (page2 === 1) return "absent";
+  try {
+    return await firstPageHasRow() ? "past_the_end" : "absent";
+  } catch {
+    return "undetermined";
+  }
+}
 var GALLICA_CAVEAT = "These are links for a person to open. This server reads the BnF catalogue and never requests gallica.bnf.fr, so it cannot say whether a document opens, what it contains, or on what terms it may be reused.";
 var PROVISIONAL_CAVEAT = "A provisional record is one the BnF created to hold a title it has catalogued and not yet established as a work of its own. Its identifier can change, and it can be merged into an established record.";
 
@@ -1946,6 +1954,25 @@ function lifespan(birthYear, deathYear) {
   if (deathYear !== null) return ` (died ${deathYear})`;
   return "";
 }
+function emptyPageNote(emptiness, page2, words) {
+  const quoted = words.map((word) => `"${word}"`).join(", ");
+  if (emptiness === "past_the_end") {
+    return `Page ${page2} holds no row because it sits past the last row of this search. Records do carry ${quoted} in a name, and they are on earlier pages: call again with page=1, or with a lower page number, to read them.`;
+  }
+  if (emptiness === "undetermined") {
+    return `Page ${page2} holds no row, and reading the first page of the same search to find out why did not answer. This is either a name carrying ${quoted} matching no record, or a page sitting past the last row of a search that does match. Call again with page=1: rows there mean the second.`;
+  }
+  return `No record in the BnF authority file carries every one of these words in a name: ${quoted}. A search here reads names, so a person known by a pen name is found under that name rather than their own.`;
+}
+function emptyPageBody(emptiness, page2, name) {
+  if (emptiness === "past_the_end") {
+    return `Page ${page2} of the search for "${name}" holds no row: it sits past the last row. Call again with page=1.`;
+  }
+  if (emptiness === "undetermined") {
+    return `Page ${page2} of the search for "${name}" holds no row, and whether the rows stop before it could not be read. Call again with page=1.`;
+  }
+  return `No person in the BnF authority file matches "${name}".`;
+}
 async function runSearchAuthors(client, args) {
   try {
     const words = client.words(args.name);
@@ -1995,17 +2022,20 @@ async function runSearchAuthors(client, args) {
         `More matches exist beyond this page. Ask for page ${args.page + 1}, or narrow the name. This server reports no total, because counting every match means asking the endpoint to walk the whole index a second time.`
       );
     }
+    let emptiness = "absent";
     if (authors.length === 0) {
-      notes.push(
-        `No record in the BnF authority file carries every one of these words in a name: ${words.map((word) => `"${word}"`).join(", ")}. A search here reads names, so a person known by a pen name is found under that name rather than their own.`
-      );
+      emptiness = await classifyEmptyPage(args.page, async () => {
+        const first = await client.searchAuthors(args.name, 1, 0);
+        return first.data.rows.length > 0;
+      });
+      notes.push(emptyPageNote(emptiness, args.page, words));
     }
     if (words.length < args.name.trim().split(/\s+/).length) {
       notes.push(
         `The index was asked for ${words.map((word) => `"${word}"`).join(", ")}; anything in the name that was not a word was set aside.`
       );
     }
-    const body = authors.length === 0 ? `No person in the BnF authority file matches "${args.name}".` : `${authors.length} record(s) for "${args.name}":
+    const body = authors.length === 0 ? emptyPageBody(emptiness, args.page, args.name) : `${authors.length} record(s) for "${args.name}":
 ${authors.map((author, index) => {
       const life = lifespan(author.birth_year, author.death_year);
       const role = author.role ? ` \xB7 ${author.role}` : "";
@@ -2063,6 +2093,25 @@ var searchWorksOutput = z8.object({
   retrieved_at: retrievedAtSchema,
   notes: z8.array(z8.string())
 });
+function emptyPageNote2(emptiness, page2, words) {
+  const quoted = words.map((word) => `"${word}"`).join(", ");
+  if (emptiness === "past_the_end") {
+    return `Page ${page2} holds no row because it sits past the last row of this search. Works do carry ${quoted} in their title, and they are on earlier pages: call again with page=1, or with a lower page number, to read them.`;
+  }
+  if (emptiness === "undetermined") {
+    return `Page ${page2} holds no row, and reading the first page of the same search to find out why did not answer. This is either a title carrying ${quoted} matching no record, or a page sitting past the last row of a search that does match. Call again with page=1: rows there mean the second.`;
+  }
+  return `No work in the BnF catalogue has a title carrying every one of these words: ${quoted}. Every word given has to appear, so dropping one widens the search.`;
+}
+function emptyPageBody2(emptiness, page2, title) {
+  if (emptiness === "past_the_end") {
+    return `Page ${page2} of the search for "${title}" holds no row: it sits past the last row. Call again with page=1.`;
+  }
+  if (emptiness === "undetermined") {
+    return `Page ${page2} of the search for "${title}" holds no row, and whether the rows stop before it could not be read. Call again with page=1.`;
+  }
+  return `No work in the BnF catalogue matches "${title}".`;
+}
 async function runSearchWorks(client, args) {
   try {
     const words = client.words(args.title);
@@ -2111,12 +2160,15 @@ async function runSearchWorks(client, args) {
         `More matches exist beyond this page. Ask for page ${args.page + 1}, or add a word to the title. This server reports no total: a count would read as a measure of the search, and this search has none.`
       );
     }
+    let emptiness = "absent";
     if (works.length === 0) {
-      notes.push(
-        `No work in the BnF catalogue has a title carrying every one of these words: ${words.map((word) => `"${word}"`).join(", ")}. Every word given has to appear, so dropping one widens the search.`
-      );
+      emptiness = await classifyEmptyPage(args.page, async () => {
+        const first = await client.searchWorks(args.title, 1, 0);
+        return first.data.rows.length > 0;
+      });
+      notes.push(emptyPageNote2(emptiness, args.page, words));
     }
-    const body = works.length === 0 ? `No work in the BnF catalogue matches "${args.title}".` : `${works.length} work(s) whose title carries ${words.map((word) => `"${word}"`).join(" and ")}:
+    const body = works.length === 0 ? emptyPageBody2(emptiness, args.page, args.title) : `${works.length} work(s) whose title carries ${words.map((word) => `"${word}"`).join(" and ")}:
 ${works.map((work, index) => {
       const by = work.creators.length > 0 ? ` \xB7 ${work.creators.map((creator) => creator.name ?? creator.id).join(", ")}` : "";
       const when = work.date ? ` (${work.date})` : "";