@autorag/librarian 2.13.10 → 2.13.11

package/dist/index.js

@@ -43294,6 +43294,37 @@ function jsonResult(value, isError = false) {
 function toolError(code, message, extra = {}) {
   return jsonResult({ ok: false, errorCode: code, message, ...extra }, true);
 }
+var DIAGNOSTIC_EXAMPLES_PER_CODE = 3;
+function capDiagnostics(diagnostics) {
+  const byCode = new Map;
+  for (const entry of diagnostics) {
+    const list = byCode.get(entry.code);
+    if (list === undefined)
+      byCode.set(entry.code, [entry]);
+    else
+      list.push(entry);
+  }
+  const out = [];
+  for (const [code, entries] of byCode) {
+    out.push(...entries.slice(0, DIAGNOSTIC_EXAMPLES_PER_CODE));
+    const rest = entries.slice(DIAGNOSTIC_EXAMPLES_PER_CODE);
+    if (rest.length === 0)
+      continue;
+    const reasons = new Map;
+    for (const entry of rest) {
+      const key = entry.reason ?? "unspecified";
+      reasons.set(key, (reasons.get(key) ?? 0) + 1);
+    }
+    const split = [...reasons].map(([reason, count]) => `${reason}: ${count}`).join(", ");
+    const severity = entries.some((entry) => entry.severity === "error") ? "error" : entries.some((entry) => entry.severity === "warning") ? "warning" : "info";
+    out.push({
+      code,
+      severity,
+      message: `${rest.length} more ${code} entries omitted (${split}); the first ${DIAGNOSTIC_EXAMPLES_PER_CODE} are shown above.`
+    });
+  }
+  return out;
+}
 function convertResult(details) {
   const { result, links } = details;
   const files = result.files.slice(0, MAX_CONVERT_FILES).map((file) => ({
@@ -43439,7 +43470,10 @@ function createAutoRAGMcpServer(lite, options = {}) {
       inputSchema: emptyInput,
       outputSchema: objectOutput,
       annotations: { readOnlyHint: true, openWorldHint: false }
-    }, async () => jsonResult(await lite.getRefreshStatus()));
+    }, async () => {
+      const status = await lite.getRefreshStatus();
+      return jsonResult({ ...status, diagnostics: capDiagnostics(status.diagnostics) });
+    });
   }
   if (isToolEnabled("autorag.search", options)) {
     server.registerTool("autorag.search", {
@@ -43478,7 +43512,7 @@ function createAutoRAGMcpServer(lite, options = {}) {
             content: result.content
           })),
           unsearched: retrieved.unsearched,
-          diagnostics: [...status.diagnostics, ...retrieved.diagnostics]
+          diagnostics: capDiagnostics([...status.diagnostics, ...retrieved.diagnostics])
         });
       } catch (error) {
         return toolError(error instanceof RetrievalSelectionError ? "invalid-selection" : "search-failed", error instanceof Error ? error.message : String(error), { retryable: !(error instanceof RetrievalSelectionError) });
@@ -43533,7 +43567,7 @@ function createAutoRAGMcpServer(lite, options = {}) {
             content: result.content
           })),
           unsearched: retrieved.unsearched,
-          diagnostics: [...status.diagnostics, ...retrieved.diagnostics]
+          diagnostics: capDiagnostics([...status.diagnostics, ...retrieved.diagnostics])
         });
       } catch (error) {
         return toolError(error instanceof RetrievalSelectionError ? "invalid-selection" : "search-failed", error instanceof Error ? error.message : String(error), { datasourceId: entry.datasourceId, retryable: !(error instanceof RetrievalSelectionError) });

package/dist/mcp/index.js

@@ -43115,6 +43115,37 @@ function jsonResult(value, isError = false) {
 function toolError(code, message, extra = {}) {
   return jsonResult({ ok: false, errorCode: code, message, ...extra }, true);
 }
+var DIAGNOSTIC_EXAMPLES_PER_CODE = 3;
+function capDiagnostics(diagnostics) {
+  const byCode = new Map;
+  for (const entry of diagnostics) {
+    const list = byCode.get(entry.code);
+    if (list === undefined)
+      byCode.set(entry.code, [entry]);
+    else
+      list.push(entry);
+  }
+  const out = [];
+  for (const [code, entries] of byCode) {
+    out.push(...entries.slice(0, DIAGNOSTIC_EXAMPLES_PER_CODE));
+    const rest = entries.slice(DIAGNOSTIC_EXAMPLES_PER_CODE);
+    if (rest.length === 0)
+      continue;
+    const reasons = new Map;
+    for (const entry of rest) {
+      const key = entry.reason ?? "unspecified";
+      reasons.set(key, (reasons.get(key) ?? 0) + 1);
+    }
+    const split = [...reasons].map(([reason, count]) => `${reason}: ${count}`).join(", ");
+    const severity = entries.some((entry) => entry.severity === "error") ? "error" : entries.some((entry) => entry.severity === "warning") ? "warning" : "info";
+    out.push({
+      code,
+      severity,
+      message: `${rest.length} more ${code} entries omitted (${split}); the first ${DIAGNOSTIC_EXAMPLES_PER_CODE} are shown above.`
+    });
+  }
+  return out;
+}
 function convertResult(details) {
   const { result, links } = details;
   const files = result.files.slice(0, MAX_CONVERT_FILES).map((file) => ({
@@ -43260,7 +43291,10 @@ function createAutoRAGMcpServer(lite, options = {}) {
       inputSchema: emptyInput,
       outputSchema: objectOutput,
       annotations: { readOnlyHint: true, openWorldHint: false }
-    }, async () => jsonResult(await lite.getRefreshStatus()));
+    }, async () => {
+      const status = await lite.getRefreshStatus();
+      return jsonResult({ ...status, diagnostics: capDiagnostics(status.diagnostics) });
+    });
   }
   if (isToolEnabled("autorag.search", options)) {
     server.registerTool("autorag.search", {
@@ -43299,7 +43333,7 @@ function createAutoRAGMcpServer(lite, options = {}) {
             content: result.content
           })),
           unsearched: retrieved.unsearched,
-          diagnostics: [...status.diagnostics, ...retrieved.diagnostics]
+          diagnostics: capDiagnostics([...status.diagnostics, ...retrieved.diagnostics])
         });
       } catch (error) {
         return toolError(error instanceof RetrievalSelectionError ? "invalid-selection" : "search-failed", error instanceof Error ? error.message : String(error), { retryable: !(error instanceof RetrievalSelectionError) });
@@ -43354,7 +43388,7 @@ function createAutoRAGMcpServer(lite, options = {}) {
             content: result.content
           })),
           unsearched: retrieved.unsearched,
-          diagnostics: [...status.diagnostics, ...retrieved.diagnostics]
+          diagnostics: capDiagnostics([...status.diagnostics, ...retrieved.diagnostics])
         });
       } catch (error) {
         return toolError(error instanceof RetrievalSelectionError ? "invalid-selection" : "search-failed", error instanceof Error ? error.message : String(error), { datasourceId: entry.datasourceId, retryable: !(error instanceof RetrievalSelectionError) });

package/dist/mcp/server.d.ts

@@ -6,4 +6,20 @@ export interface AutoRAGMcpServerOptions {
     /** Test/embedded override; defaults to the current Node platform. */
     readonly platform?: NodeJS.Platform;
 }
+interface DiagnosticLike {
+    readonly code: string;
+    readonly severity: string;
+    readonly message: string;
+    readonly source?: string;
+    readonly reason?: string;
+}
+/**
+ * Keep an MCP response small when one code repeats once per file. A corpus whose parser changed reports one
+ * `stale-index` entry per source (1,100 of them, about 750 KB, on a real 160k-file index), which the model then has to
+ * read through on every search and status call. Each code keeps its first few entries verbatim and one summary entry
+ * says how many more there were and how they split by `reason`, so "why is it stale" survives and a different code is
+ * never hidden behind a flood of this one. Short lists pass through unchanged.
+ */
+export declare function capDiagnostics<T extends DiagnosticLike>(diagnostics: readonly T[]): (T | DiagnosticLike)[];
 export declare function createAutoRAGMcpServer(lite: AutoRAGLite, options?: AutoRAGMcpServerOptions): McpServer;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autorag/librarian",
-  "version": "2.13.10",
+  "version": "2.13.11",
   "description": "Personal librarian agent for office work on the Pi framework, with pluggable retrieval methods",
   "license": "Apache-2.0",
   "repository": {