@autorag/librarian 2.13.8 → 2.13.10

package/dist/mcp/index.js

@@ -3669,20 +3669,30 @@ var init_bundle = __esm(() => {
 });
 
 // src/filesystem/path-exclusions.ts
-import { posix as posix2, win32 as win322 } from "node:path";
+import { matchesGlob, posix as posix2, win32 as win322 } from "node:path";
+function isGlobExclusion(entry) {
+  return /[*?[]/u.test(entry);
+}
+function matchesGlobExclusion(path, glob) {
+  const slashed = path.replaceAll("\\", "/");
+  if (matchesGlob(slashed, glob))
+    return true;
+  return glob.startsWith("**/") && matchesGlob(slashed, glob.slice(3));
+}
 function createPathExclusionMatcher(excludedPaths, platform = process.platform) {
   const paths = platform === "win32" ? win322 : posix2;
   const normalize = (path) => {
     const absolute = paths.resolve(path);
     return platform === "win32" ? absolute.toLowerCase() : absolute;
   };
-  const excluded = excludedPaths.map((path) => {
+  const globs = excludedPaths.filter(isGlobExclusion).map((glob) => platform === "win32" ? glob.toLowerCase() : glob);
+  const excluded = excludedPaths.filter((path) => !isGlobExclusion(path)).map((path) => {
     const absolute = normalize(path);
     return { absolute, prefix: absolute.endsWith(paths.sep) ? absolute : `${absolute}${paths.sep}` };
   });
   return (path) => {
     const absolute = normalize(path);
-    return excluded.some((entry) => absolute === entry.absolute || absolute.startsWith(entry.prefix));
+    return excluded.some((entry) => absolute === entry.absolute || absolute.startsWith(entry.prefix)) || globs.some((glob) => matchesGlobExclusion(absolute, glob));
   };
 }
 var init_path_exclusions = () => {};
@@ -7619,6 +7629,34 @@ var init_memory = __esm(() => {
   });
 });
 
+// src/minsync/channel-union.ts
+function unionChannelResults(channels, options = {}) {
+  const byChunk = new Map;
+  const depth = Math.max(0, ...channels.map((channel) => channel.results.length));
+  for (let rank = 0;rank < depth; rank++) {
+    for (const channel of channels) {
+      const result = channel.results[rank];
+      if (result === undefined)
+        continue;
+      const key = `${result.source}\x00${result.id}`;
+      const existing = byChunk.get(key);
+      if (existing === undefined)
+        byChunk.set(key, { result, ranks: { [channel.channel]: rank + 1 } });
+      else
+        existing.ranks[channel.channel] ??= rank + 1;
+    }
+  }
+  const union = [...byChunk.values()].map(({ result, ranks }) => ({
+    ...result,
+    metadata: {
+      ...result.metadata,
+      minsyncChannels: Object.keys(ranks).sort(),
+      minsyncChannelRanks: ranks
+    }
+  }));
+  return options.limit === undefined ? union : union.slice(0, options.limit);
+}
+
 // src/minsync/local-embedder.ts
 import { spawn as spawn11 } from "node:child_process";
 import { request } from "node:http";
@@ -10306,7 +10344,7 @@ var init_cloud = __esm(() => {
 // src/mirror/sync.ts
 import { createHash as createHash11 } from "node:crypto";
 import { opendir, readFile, stat as stat3 } from "node:fs/promises";
-import { basename as basename9, dirname as dirname12, extname as extname6, join as join27, resolve as resolve11, sep as sep6 } from "node:path";
+import { basename as basename9, dirname as dirname12, extname as extname6, join as join27, resolve as resolve11 } from "node:path";
 import { setTimeout as sleep3 } from "node:timers/promises";
 function errorCode(error) {
   if (!(error instanceof Error))
@@ -10853,13 +10891,14 @@ function normalizeExtension2(extension) {
   return lower.startsWith(".") ? lower : `.${lower}`;
 }
 function isPathExcluded(sourcePath, excluded) {
-  if (excluded === undefined)
+  if (excluded === undefined || excluded.size === 0)
     return false;
-  for (const excludedPath of excluded) {
-    if (sourcePath === excludedPath || sourcePath.startsWith(`${excludedPath}${sep6}`))
-      return true;
+  let matcher = matcherBySet.get(excluded);
+  if (matcher === undefined) {
+    matcher = createPathExclusionMatcher([...excluded]);
+    matcherBySet.set(excluded, matcher);
   }
-  return false;
+  return matcher(sourcePath);
 }
 function walkLimits(options) {
   return {
@@ -11026,10 +11065,11 @@ async function collectFiles(state, directory, depth) {
     warnDirectoryUnreadable(state, directory, code);
   }
 }
-var DEFAULT_MAX_SOURCE_BYTES, DEFAULT_MAX_DELETE_RATIO = 0.3, MASS_DELETE_FLOOR = 100, DEFAULT_MAX_SCANNED_ENTRIES = 2000000, DEFAULT_MAX_WALK_DEPTH = 64, DEFAULT_MIRROR_BATCH_SIZE = 25, PRODUCT_ARTIFACT_FILE_NAMES, SKIP_DIR_NAMES, PARSER_FAILURE_MESSAGE = "The registered parser failed on this file; it was skipped during indexing.", PARSER_CRASH_MESSAGE = "The registered parser crashed unexpectedly on this file; it was skipped during indexing.", DEFAULT_TRANSIENT_RETRIES = 3, DEFAULT_TRANSIENT_BACKOFF_MS = 50, TRANSIENT_ERROR_CODES, WORKSPACE_ERROR_CODES, MirrorWorkspaceError, STANDALONE_OCR_IMAGE_EXTENSIONS, SEARCH_ROOT_UNAVAILABLE_MESSAGES;
+var DEFAULT_MAX_SOURCE_BYTES, DEFAULT_MAX_DELETE_RATIO = 0.3, MASS_DELETE_FLOOR = 100, DEFAULT_MAX_SCANNED_ENTRIES = 2000000, DEFAULT_MAX_WALK_DEPTH = 64, DEFAULT_MIRROR_BATCH_SIZE = 25, PRODUCT_ARTIFACT_FILE_NAMES, SKIP_DIR_NAMES, PARSER_FAILURE_MESSAGE = "The registered parser failed on this file; it was skipped during indexing.", PARSER_CRASH_MESSAGE = "The registered parser crashed unexpectedly on this file; it was skipped during indexing.", DEFAULT_TRANSIENT_RETRIES = 3, DEFAULT_TRANSIENT_BACKOFF_MS = 50, TRANSIENT_ERROR_CODES, WORKSPACE_ERROR_CODES, MirrorWorkspaceError, STANDALONE_OCR_IMAGE_EXTENSIONS, matcherBySet, SEARCH_ROOT_UNAVAILABLE_MESSAGES;
 var init_sync = __esm(() => {
   init_cli2();
   init_cloud_placeholder();
+  init_path_exclusions();
   init_source_paths();
   init_binary();
   init_stage();
@@ -11088,6 +11128,7 @@ var init_sync = __esm(() => {
     }
   };
   STANDALONE_OCR_IMAGE_EXTENSIONS = new Set(KORDOC_IMAGE_EXTENSIONS);
+  matcherBySet = new WeakMap;
   SEARCH_ROOT_UNAVAILABLE_MESSAGES = {
     gone: "A search root no longer exists; its previously indexed documents were left untouched.",
     "not-a-directory": "A search root is no longer a directory; its previously indexed documents were left untouched.",
@@ -16162,7 +16203,7 @@ var init_automation_profiles = __esm(() => {
 
 // src/automation/config.ts
 import { existsSync as existsSync19, readFileSync as readFileSync14, realpathSync as realpathSync7 } from "node:fs";
-import { basename as basename10, dirname as dirname15, isAbsolute as isAbsolute8, join as join30, matchesGlob, relative as relative5, resolve as resolve12 } from "node:path";
+import { basename as basename10, dirname as dirname15, isAbsolute as isAbsolute8, join as join30, matchesGlob as matchesGlob2, relative as relative5, resolve as resolve12 } from "node:path";
 function automationsConfigPath(env = process.env) {
   return join30(resolveAutoRAGHome(env), "automations.json");
 }
@@ -16338,9 +16379,9 @@ function deleteAutomation(configPath, id) {
 function globMatches(relPosix, pattern) {
   if (pattern === "**")
     return true;
-  if (matchesGlob(relPosix, pattern))
+  if (matchesGlob2(relPosix, pattern))
     return true;
-  if (pattern.startsWith("**/") && matchesGlob(relPosix, pattern.slice(3)))
+  if (pattern.startsWith("**/") && matchesGlob2(relPosix, pattern.slice(3)))
     return true;
   return false;
 }
@@ -17137,7 +17178,7 @@ var init_permission_judgment = __esm(() => {
 
 // src/agent/permission-gate.ts
 import { statSync as statSync7 } from "node:fs";
-import { isAbsolute as isAbsolute9, relative as relative6, sep as sep7 } from "node:path";
+import { isAbsolute as isAbsolute9, relative as relative6, sep as sep6 } from "node:path";
 import { matchesKey } from "@earendil-works/pi-tui";
 function pathExists(path) {
   try {
@@ -17200,7 +17241,7 @@ class PermissionController {
       if (path === root)
         return true;
       const rel = relative6(root, path);
-      if (rel !== "" && rel !== ".." && !rel.startsWith(`..${sep7}`) && !isAbsolute9(rel))
+      if (rel !== "" && rel !== ".." && !rel.startsWith(`..${sep6}`) && !isAbsolute9(rel))
         return true;
     }
     return false;
@@ -18652,7 +18693,7 @@ var init_connector = () => {};
 // src/datasource/sidecar/config.ts
 import { readFileSync as readFileSync17 } from "node:fs";
 import { homedir as homedir5 } from "node:os";
-import { dirname as dirname17, isAbsolute as isAbsolute10, join as join34, resolve as resolve14, sep as sep8 } from "node:path";
+import { dirname as dirname17, isAbsolute as isAbsolute10, join as join34, resolve as resolve14, sep as sep7 } from "node:path";
 import { parse as parseToml } from "smol-toml";
 function resolveSidecarOptions(input) {
   const { connector, workspaceRoot } = input;
@@ -18692,7 +18733,7 @@ function archivePathFromCrawlerConfig(input) {
 function expandHome(path) {
   if (path === "~")
     return homedir5();
-  const prefixed = path.startsWith("~/") || sep8 === "\\" && path.startsWith("~\\");
+  const prefixed = path.startsWith("~/") || sep7 === "\\" && path.startsWith("~\\");
   return prefixed ? join34(homedir5(), path.slice(2)) : path;
 }
 var init_config3 = __esm(() => {
@@ -25946,7 +25987,7 @@ import {
   writeFileSync as writeFileSync13
 } from "node:fs";
 import { opendir as opendir2, stat as stat4 } from "node:fs/promises";
-import { basename as basename11, dirname as dirname23, extname as extname8, join as join40, relative as relative7, sep as sep9 } from "node:path";
+import { basename as basename11, dirname as dirname23, extname as extname8, join as join40, relative as relative7, sep as sep8 } from "node:path";
 function errnoCode2(error) {
   const code = error instanceof Error ? error.code : undefined;
   return typeof code === "string" ? code : "UNKNOWN";
@@ -26016,7 +26057,7 @@ async function listVaultNotes(vaultPath) {
   return { notes, unreadableFolders, collisions };
 }
 function toRelative(vaultPath, path) {
-  return relative7(vaultPath, path).split(sep9).join("/").normalize("NFC");
+  return relative7(vaultPath, path).split(sep8).join("/").normalize("NFC");
 }
 function loadStagingState2(statePath) {
   try {
@@ -26100,7 +26141,7 @@ function removeUnexpected(filesRoot, directory, wanted) {
   return removed;
 }
 function toStagedRelative(filesRoot, path) {
-  return relative7(filesRoot, path).split(sep9).join("/").normalize("NFC");
+  return relative7(filesRoot, path).split(sep8).join("/").normalize("NFC");
 }
 var NOTE_EXTENSIONS, SKIPPED_DIRECTORIES, MAX_WALK_DEPTH = 64, VaultUnavailableError;
 var init_staging = __esm(() => {
@@ -28021,7 +28062,7 @@ function resolveExcludePaths(value, origin) {
   if (!Array.isArray(value) || value.some((path) => typeof path !== "string" || path.length === 0)) {
     throw new ConfigError("Config field 'excludePaths' must be a non-empty string array");
   }
-  return resolveSearchPaths(value, origin);
+  return value.map((entry) => isGlobExclusion(entry) ? entry : resolvePersistedPath(entry, origin));
 }
 function resolvePersistedPath(path, origin) {
   return isAbsolute11(path) ? path : resolve15(origin, path);
@@ -29326,6 +29367,7 @@ var init_config5 = __esm(() => {
   init_factory();
   init_embedding();
   init_file_lock();
+  init_path_exclusions();
   init_language();
   init_atomic_write();
   init_rerank();
@@ -38579,7 +38621,7 @@ var init_web_search_tool = __esm(() => {
 // src/agent/agent.ts
 import { randomUUID as randomUUID7 } from "node:crypto";
 import { existsSync as existsSync34, watch as fsWatch, mkdirSync as mkdirSync24, realpathSync as realpathSync8, statSync as statSync11, writeFileSync as writeFileSync17 } from "node:fs";
-import { basename as basename15, dirname as dirname27, join as join55, relative as relative8, resolve as resolve18, sep as sep10 } from "node:path";
+import { basename as basename15, dirname as dirname27, join as join55, relative as relative8, resolve as resolve18, sep as sep9 } from "node:path";
 import { clampThinkingLevel } from "@earendil-works/pi-ai/compat";
 import { getAgentDir as getAgentDir6, keyText } from "@earendil-works/pi-coding-agent";
 function describeDecisionModel(status) {
@@ -38722,6 +38764,7 @@ class AutoRAGAgent {
   reranker;
   rerankTopN;
   minSyncMethod;
+  minSyncSparseMethod;
   minSyncEmbedderConfig;
   minSyncBinaryPath;
   jikjiClient;
@@ -38844,6 +38887,7 @@ class AutoRAGAgent {
       ...this.limits.recordCut === undefined ? {} : { recordCut: this.limits.recordCut }
     };
     this.minSyncMethod = new MinSyncVectorMethod(minSyncDefaults);
+    this.minSyncSparseMethod = isSparseOnlyEmbedder(options.minSync?.embedder) ? undefined : new MinSyncVectorMethod({ ...minSyncDefaults, mode: "sparse" });
     this.methodRegistry.register(new MinSyncHybridMethod(minSyncDefaults));
     const registeredDatasourceIds = new Set;
     for (const skill of this.datasourceSkills) {
@@ -40318,13 +40362,7 @@ Warning: the edited config did not validate, so the previous config was restored
 ${list.map((entry, index) => `[${index + 1}] ${entry}`).join(`
 `)}`;
     const perQuery = await Promise.all(searchQueries.map((searchQuery) => Promise.all([
-      this.searchProgress.track("minsync", "MinSync semantic search", this.minSyncMethod.retrieve(searchQuery, retrieveOptions), {
-        count: (found) => found.length
-      }).catch((error) => {
-        if (error instanceof MinSyncRequiredError)
-          throw error;
-        return [];
-      }),
+      this.prefetchMinSyncCandidates(searchQuery, retrieveOptions),
       Promise.all(datasources.map((datasourceId) => this.searchProgress.track(`datasource:${datasourceId}`, `Datasource ${datasourceId}`, this.searchSingleDatasourceDocuments(datasourceId, searchQuery, {
         topK: this.limits.prefetch.datasourceTopK,
         scope: options.scope,
@@ -40439,6 +40477,30 @@ ${result.content.replace(/\s+/gu, " ")}`).join(`
 
 `);
   }
+  async prefetchMinSyncCandidates(searchQuery, options) {
+    const sparse = this.reranker === undefined ? undefined : this.minSyncSparseMethod;
+    const run = (id, label, method) => this.searchProgress.track(id, label, method.retrieve(searchQuery, options), { count: (found) => found.length }).catch((error) => {
+      if (error instanceof MinSyncRequiredError)
+        throw error;
+      if (sparse !== undefined) {
+        this.routingDiagnostics.push({
+          code: "retrieval-method-failed",
+          severity: "warning",
+          message: `MinSync ${id === "minsync" ? "dense" : "SPLADE"} search failed and its candidates were skipped; the other channel's were used: ${describeRetrievalError(error)}`,
+          source: id
+        });
+      }
+      return [];
+    });
+    const dense = run("minsync", "MinSync semantic search", this.minSyncMethod);
+    if (sparse === undefined)
+      return dense;
+    const [vector, splade] = await Promise.all([dense, run("minsync-sparse", "MinSync SPLADE search", sparse)]);
+    return unionChannelResults([
+      { channel: "vector", results: vector },
+      { channel: "sparse", results: splade }
+    ]);
+  }
   async prefetchWebSearch(searchQuery, signal) {
     const web = this.webSearchOptions;
     if (web === undefined)
@@ -41232,7 +41294,7 @@ ${this.discoveryHint((tools) => `When exploring local files and folders, activel
         return { ok: false, reason: "cloud-root-skipped", stdout: "", stderr: "", code: null };
       }
       const canonicalSourcePath = canonicalPath(sourcePath);
-      const exclude = scope.nestedCloudRoots.map((root) => relative8(canonicalSourcePath, root.path).split(sep10).join("/")).filter((pattern) => pattern !== "" && !pattern.startsWith(".."));
+      const exclude = scope.nestedCloudRoots.map((root) => relative8(canonicalSourcePath, root.path).split(sep9).join("/")).filter((pattern) => pattern !== "" && !pattern.startsWith(".."));
       return client.prepare(sourcePath, { ...options, ...exclude.length === 0 ? {} : { exclude } });
     }));
   }
@@ -41746,6 +41808,8 @@ function toMinSyncReasonDiagnostic(reason) {
   };
 }
 function pinExcludedPath(path) {
+  if (isGlobExclusion(path))
+    return path;
   const resolvedPath = resolve18(path);
   try {
     return join55(realpathSync8(dirname27(resolvedPath)), basename15(resolvedPath));
@@ -41794,6 +41858,7 @@ var init_agent = __esm(() => {
   init_embedding();
   init_everything();
   init_cloud_placeholder();
+  init_path_exclusions();
   init_fsearch();
   init_diagnostics();
   init_jikji();
@@ -41816,6 +41881,7 @@ var init_agent = __esm(() => {
   init_merger();
   init_rerank();
   init_scope();
+  init_skip();
   init_search();
   init_model_auth();
   init_answer_citations();
@@ -41953,6 +42019,12 @@ class AutoRAGLite {
   getMemorySchema() {
     return structuredClone(this.memory.getSchema());
   }
+  convertFiles(request, signal) {
+    return this.agent.convertFiles(request, signal);
+  }
+  listFileConversions(from, signal) {
+    return this.agent.listFileConversions(from, signal);
+  }
 }
 function createAutoRAGLite(options = {}) {
   const input = { flags: options.flags ?? {} };
@@ -42644,6 +42716,48 @@ import { realpathSync as realpathSync10 } from "node:fs";
 import { fileURLToPath as fileURLToPath6 } from "node:url";
 import { StdioServerTransport } from "@modelcontextprotocol/server/stdio";
 
+// src/mcp/reloading-lite.ts
+init_config5();
+import { statSync as statSync12 } from "node:fs";
+function createReloadingLite(options) {
+  let attempted = options.signature();
+  let current = options.create();
+  const sync = () => {
+    const next = options.signature();
+    if (next === attempted)
+      return current;
+    attempted = next;
+    try {
+      current = options.create();
+    } catch (error) {
+      options.onError?.(error instanceof Error ? error : new Error(String(error)));
+    }
+    return current;
+  };
+  return new Proxy({}, {
+    get(_target, property) {
+      const runtime = sync();
+      const value = Reflect.get(runtime, property, runtime);
+      return typeof value === "function" ? value.bind(runtime) : value;
+    },
+    has(_target, property) {
+      return property in sync();
+    }
+  });
+}
+function configSignature(env = process.env) {
+  const { configPath, legacyPath } = resolveConfigPath({ flags: {}, env });
+  return [configPath, legacyPath].map((path) => path === undefined ? "-" : fingerprint(path)).join("|");
+}
+function fingerprint(path) {
+  try {
+    const stats = statSync12(path);
+    return `${stats.ino}:${stats.size}:${stats.mtimeMs}`;
+  } catch {
+    return "absent";
+  }
+}
+
 // src/mcp/server.ts
 init_evidence();
 init_report();
@@ -42657,7 +42771,7 @@ import { z as z4 } from "zod";
 // src/filesystem/name-search.ts
 import { realpathSync as realpathSync9 } from "node:fs";
 import { lstat as lstat2, readdir as readdir5 } from "node:fs/promises";
-import { basename as basename16, dirname as dirname28, isAbsolute as isAbsolute14, join as join56, relative as relative9, resolve as resolve19, sep as sep11 } from "node:path";
+import { basename as basename16, dirname as dirname28, isAbsolute as isAbsolute14, join as join56, relative as relative9, resolve as resolve19, sep as sep10 } from "node:path";
 var SKIP_DIR_NAMES2 = {
   ".git": true,
   ".autorag": true,
@@ -42685,7 +42799,7 @@ function fsErrorCode(error) {
   return typeof code === "string" ? code : undefined;
 }
 function isContained(childReal, parentReal) {
-  const prefix = parentReal.endsWith(sep11) ? parentReal : `${parentReal}${sep11}`;
+  const prefix = parentReal.endsWith(sep10) ? parentReal : `${parentReal}${sep10}`;
   return childReal === parentReal || childReal.startsWith(prefix);
 }
 function pinExcludedPath2(path) {
@@ -42698,14 +42812,14 @@ function pinExcludedPath2(path) {
 }
 function isExcluded2(absPath, excluded) {
   for (const excludedPath of excluded) {
-    const prefix = excludedPath.endsWith(sep11) ? excludedPath : `${excludedPath}${sep11}`;
+    const prefix = excludedPath.endsWith(sep10) ? excludedPath : `${excludedPath}${sep10}`;
     if (absPath === excludedPath || absPath.startsWith(prefix))
       return true;
   }
   return false;
 }
 function matchesEntry(context, absPath, name) {
-  const haystackRaw = context.matchPath ? relative9(context.rootReal, absPath).split(sep11).join("/") : name;
+  const haystackRaw = context.matchPath ? relative9(context.rootReal, absPath).split(sep10).join("/") : name;
   const haystack = context.matchCase ? haystackRaw : haystackRaw.toLowerCase();
   const needle = context.matchCase ? context.query : context.query.toLowerCase();
   return haystack.includes(needle);
@@ -42846,7 +42960,7 @@ async function filterFileNameSearchMatches(roots, candidates, excludePaths = [])
       continue;
     if (isExcluded2(real, excluded))
       continue;
-    const segments = real.split(sep11);
+    const segments = real.split(sep10);
     if (segments.some((segment) => SKIP_DIR_NAMES2[segment] === true))
       continue;
     matches.push({ path: real, type: stat.isDirectory() ? "folder" : "file" });
@@ -42970,6 +43084,16 @@ var evidenceInput = z4.strictObject({
   sessionId: z4.string().trim().min(1),
   resultNumber: z4.number().int().positive().optional()
 });
+var convertInput = z4.strictObject({
+  inputs: z4.array(z4.string().trim().min(1)).min(1).max(500),
+  to: z4.string().trim().min(1),
+  outputDir: z4.string().trim().min(1).optional(),
+  recursive: z4.boolean().optional(),
+  quality: z4.number().int().min(1).max(100).optional(),
+  keepDates: z4.boolean().optional()
+});
+var convertFormatsInput = z4.strictObject({ from: z4.string().trim().min(1).optional() });
+var MAX_CONVERT_FILES = 200;
 function exactGroupsFromScan(scan) {
   const groups = new Map;
   for (const file of scan.files) {
@@ -42991,6 +43115,26 @@ function jsonResult(value, isError = false) {
 function toolError(code, message, extra = {}) {
   return jsonResult({ ok: false, errorCode: code, message, ...extra }, true);
 }
+function convertResult(details) {
+  const { result, links } = details;
+  const files = result.files.slice(0, MAX_CONVERT_FILES).map((file) => ({
+    source: file.source,
+    state: file.state,
+    outputs: file.outputs,
+    ...file.error !== undefined ? { error: file.error } : {},
+    ...file.notice !== undefined ? { notice: file.notice } : {}
+  }));
+  const body = {
+    target: result.target,
+    converted: result.converted,
+    skipped: result.skipped,
+    failed: result.failed,
+    files,
+    ...result.files.length > files.length ? { omittedFiles: result.files.length - files.length } : {},
+    links
+  };
+  return result.converted === 0 && result.failed > 0 ? toolError("convert-failed", "No file was converted.", body) : jsonResult({ ok: true, ...body });
+}
 function isToolEnabled(name, options) {
   return options.tools === undefined || options.tools.includes(name);
 }
@@ -43285,6 +43429,46 @@ function createAutoRAGMcpServer(lite, options = {}) {
       return datasource === undefined ? toolError("datasource-not-found", `No configured datasource named ${datasourceId}.`, { datasourceId }) : jsonResult({ ok: true, datasource });
     });
   }
+  const convertEnabled = lite.config.filee?.enabled !== false;
+  if (convertEnabled && !readOnly && isToolEnabled("autorag.convert", options)) {
+    server.registerTool("autorag.convert", {
+      title: "Convert Files",
+      description: "Convert local files to another format offline with Filee: documents, spreadsheets, slides, HWP/HWPX, images, e-books, archives, audio, video, data. Writes new files next to each source (or into outputDir) and never replaces an existing file: a colliding name gets a number added. Each output is compared with its source by Dupey, so the result says whether the copy would count as a duplicate. Use autorag.convert.formats when unsure what a source can become.",
+      inputSchema: convertInput,
+      outputSchema: objectOutput,
+      annotations: { readOnlyHint: false, idempotentHint: false, destructiveHint: false, openWorldHint: false }
+    }, async ({ inputs, to, outputDir, recursive, quality, keepDates }, ctx) => {
+      try {
+        const details = await lite.convertFiles({
+          inputs,
+          to,
+          ...outputDir !== undefined ? { outputDir } : {},
+          ...recursive !== undefined ? { recursive } : {},
+          ...quality !== undefined ? { quality } : {},
+          ...keepDates !== undefined ? { keepDates } : {}
+        }, ctx.mcpReq.signal);
+        return convertResult(details);
+      } catch (error) {
+        return toolError("convert-failed", error instanceof Error ? error.message : String(error));
+      }
+    });
+  }
+  if (convertEnabled && isToolEnabled("autorag.convert.formats", options)) {
+    server.registerTool("autorag.convert.formats", {
+      title: "List Convertible Formats",
+      description: "List the file formats Filee knows, or what one source format (heic, docx, hwp, mkv) can be converted to, including targets that need an optional engine. Read-only.",
+      inputSchema: convertFormatsInput,
+      outputSchema: objectOutput,
+      annotations: { readOnlyHint: true, openWorldHint: false }
+    }, async ({ from }, ctx) => {
+      try {
+        const formats = await lite.listFileConversions(from, ctx.mcpReq.signal);
+        return jsonResult({ ok: true, ...from !== undefined ? { from } : {}, formats });
+      } catch (error) {
+        return toolError("convert-failed", error instanceof Error ? error.message : String(error));
+      }
+    });
+  }
   if (!readOnly && isToolEnabled("autorag.report", options)) {
     server.registerTool("autorag.report", {
       title: "Persist AutoRAG Curated Report",
@@ -43372,9 +43556,11 @@ function isInvokedDirectly() {
 async function main() {
   const readOnly = parseBoolean(process.env.AUTORAG_MCP_READ_ONLY);
   const tools = parseTools(process.env.AUTORAG_MCP_TOOLS);
-  const lite = createAutoRAGLite({
-    env: process.env,
-    readOnly
+  const lite = createReloadingLite({
+    create: () => createAutoRAGLite({ env: process.env, readOnly }),
+    signature: () => configSignature(process.env),
+    onError: (error) => process.stderr.write(`autorag-mcp: keeping the previous config, the new one failed: ${error.message}
+`)
   });
   const server = createAutoRAGMcpServer(lite, { readOnly, tools });
   await server.connect(new StdioServerTransport);

package/dist/mcp/reloading-lite.d.ts

@@ -0,0 +1,25 @@
+import type { AutoRAGLite } from "../core.js";
+export interface ReloadingLiteOptions {
+    /** Build a runtime from the config as it is now. May throw (missing or unparsable config). */
+    readonly create: () => AutoRAGLite;
+    /** A cheap fingerprint of whatever `create` reads; a different value means the runtime is out of date. */
+    readonly signature: () => string;
+    /** A config that could not be loaded. Called once per distinct broken config, never on every call. */
+    readonly onError?: (error: Error) => void;
+}
+/**
+ * A runtime that follows its config file. An MCP server is started once and then lives for as long as its host
+ * keeps it (Hermes keeps one per gateway, across chat sessions), so a config written after it started, which is
+ * exactly what first-time setup does, would otherwise never be seen: every search kept answering `index-not-ready`.
+ *
+ * Each access compares the config's signature (two `stat` calls) and rebuilds the runtime when it changed. The first
+ * build happens eagerly, so a bad config still fails at start. A later config that cannot be loaded (half-written,
+ * mistyped) keeps the last working runtime and is reported once, then retried when the file changes again.
+ */
+export declare function createReloadingLite(options: ReloadingLiteOptions): AutoRAGLite;
+/**
+ * Fingerprint of the config file `createAutoRAGLite` would read: its inode, size and modification time, or `absent`.
+ * An explicit `AUTORAG_CONFIG`, else `<AUTORAG_HOME>/config.json` (and the legacy `autorag.config.json` beside the
+ * working directory) are covered, in the same order the resolver uses.
+ */
+export declare function configSignature(env?: NodeJS.ProcessEnv): string;

package/dist/minsync/channel-union.d.ts

@@ -0,0 +1,23 @@
+import type { RetrievalResult } from "../retrieval/types.js";
+/** Ranked results of one MinSync query mode (`vector` or `sparse`), best first. */
+export interface MinSyncChannelResults {
+    readonly channel: string;
+    readonly results: readonly RetrievalResult[];
+}
+export interface UnionChannelOptions {
+    /** Keep at most this many chunks after interleaving. Unset keeps the whole union. */
+    readonly limit?: number;
+}
+/**
+ * Union of independently ranked MinSync channels, built for a reranker that decides the final order.
+ *
+ * Channels are interleaved by rank (rank 1 of each channel, then rank 2, ...) so a limit never cuts one
+ * channel's head to keep the other's tail, and a chunk found by several channels appears once, at its
+ * best interleaved position. Scores are left as the first channel reported them: dense and SPLADE scores
+ * are not comparable and nothing here ranks across them. Each chunk records which channels found it and
+ * at what 1-based rank (`minsyncChannels`, `minsyncChannelRanks`).
+ *
+ * Identity is `source` + `id`, the same key the cross-method merger uses, so two chunks of one document
+ * stay distinct while the same chunk reached by two channels collapses.
+ */
+export declare function unionChannelResults(channels: readonly MinSyncChannelResults[], options?: UnionChannelOptions): RetrievalResult[];

package/dist/mirror/sync.d.ts

@@ -187,4 +187,5 @@ export declare class MirrorWorkspaceError extends Error {
 export declare function syncParsedMirrors(options: ParsedMirrorSyncOptions): Promise<ParsedMirrorSyncResult>;
 /** Ask MinSync's read-only plan which current source revisions still need work. */
 export declare function detectMirrorStaleness(options: ParsedMirrorSyncOptions): Promise<ParsedMirrorDiagnostic[]>;
+/** A path is excluded when it equals an excluded path, sits under one, or matches an excluded glob. */
 export declare function isPathExcluded(sourcePath: string, excluded: ReadonlySet<string> | undefined): boolean;