@ncukondo/reference-manager 0.29.6 → 0.30.1

package/dist/chunks/{index-Czz9ZhIH.js → index-4w0pu_0o.js}

@@ -1,13 +1,13 @@
 import { Command, Option } from "commander";
+import { n as normalizePathForOutput, d as deleteDirectoryIfEmpty, p as parseFilename, i as isReservedRole, e as ensureDirectory, a as addAttachment, R as RESERVED_ROLES, b as generateFilename, c as findFulltextFiles, h as findFulltextFile, j as extensionToFormat, k as fulltextAttach, l as fulltextDiscover, m as fulltextFetch, o as fulltextConvert, q as fulltextGet, r as getExtension, s as getDefaultExportFromCjs, B as BUILTIN_STYLES, t as packageJson, u as getFulltextAttachmentTypes, v as startServerWithFileWatcher, w as BUILTIN_CONVERTER_NAMES, x as BUILTIN_CONVERTER_INFO } from "./index-C_mW5LMY.js";
 import { i as isEqual, M as MANAGED_CUSTOM_FIELDS, w as writeFileAtomic, L as Library, h as CslItemSchema, p as pickDefined, a as sortOrderSchema, z as paginationOptionsSchema, F as FileWatcher, b as sortFieldSchema, y as searchSortFieldSchema } from "./file-watcher-CWHg1yol.js";
 import * as fs from "node:fs";
 import { promises, readFileSync, existsSync, mkdirSync, writeFileSync } from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
 import path__default, { join, basename, dirname } from "node:path";
-import { n as normalizePathForOutput, d as deleteDirectoryIfEmpty, p as parseFilename, i as isReservedRole, e as ensureDirectory, a as addAttachment, R as RESERVED_ROLES, b as generateFilename, c as findFulltextFiles, h as findFulltextFile, j as extensionToFormat, k as fulltextAttach, l as fulltextDiscover, m as fulltextFetch, o as fulltextConvert, q as fulltextGet, r as getExtension, s as getDefaultExportFromCjs, B as BUILTIN_STYLES, t as getFulltextAttachmentTypes, u as startServerWithFileWatcher } from "./index-6Aild0Uk.js";
 import { readFile, unlink, stat, readdir, rename } from "node:fs/promises";
-import { o as openWithSystemApp, l as loadConfig, e as getDefaultCurrentDirConfigFilename, h as getDefaultUserConfigPath } from "./loader-B6sytmQd.js";
+import { o as openWithSystemApp, l as loadConfig, e as getDefaultCurrentDirConfigFilename, h as getDefaultUserConfigPath } from "./loader-BG2eomDC.js";
 import { spawn, spawnSync } from "node:child_process";
 import process$1, { stdin, stdout } from "node:process";
 import * as readline from "node:readline";
@@ -18,14 +18,6 @@ import "@citation-js/core";
 import "@citation-js/plugin-csl";
 import { ZodOptional as ZodOptional$2, z } from "zod";
 import { serve } from "@hono/node-server";
-const name = "@ncukondo/reference-manager";
-const version$1 = "0.29.6";
-const description$1 = "A local reference management tool using CSL-JSON as the single source of truth";
-const packageJson = {
-  name,
-  version: version$1,
-  description: description$1
-};
 const ISO_DATE_REGEX$1 = /^\d{4}(-\d{2})?(-\d{2})?$/;
 function datePartsToIso(dateParts) {
   if (!dateParts || dateParts.length === 0 || !dateParts[0]) {
@@ -901,15 +893,15 @@ class OperationsLibrary {
   }
   // High-level operations
   async search(options) {
-    const { searchReferences } = await import("./index-6Aild0Uk.js").then((n) => n.E);
+    const { searchReferences } = await import("./index-C_mW5LMY.js").then((n) => n.H);
     return searchReferences(this.library, options);
   }
   async list(options) {
-    const { listReferences } = await import("./index-6Aild0Uk.js").then((n) => n.D);
+    const { listReferences } = await import("./index-C_mW5LMY.js").then((n) => n.G);
     return listReferences(this.library, options ?? {});
   }
   async cite(options) {
-    const { citeReferences } = await import("./index-6Aild0Uk.js").then((n) => n.C);
+    const { citeReferences } = await import("./index-C_mW5LMY.js").then((n) => n.F);
     const defaultStyle = options.defaultStyle ?? this.citationConfig?.defaultStyle;
     const cslDirectory = options.cslDirectory ?? this.citationConfig?.cslDirectory;
     const mergedOptions = {
@@ -920,36 +912,36 @@ class OperationsLibrary {
     return citeReferences(this.library, mergedOptions);
   }
   async import(inputs, options) {
-    const { addReferences } = await import("./index-6Aild0Uk.js").then((n) => n.z);
+    const { addReferences } = await import("./index-C_mW5LMY.js").then((n) => n.D);
     return addReferences(inputs, this.library, options ?? {});
   }
   async check(options) {
-    const { checkReferences } = await import("./index-6Aild0Uk.js").then((n) => n.A);
+    const { checkReferences } = await import("./index-C_mW5LMY.js").then((n) => n.E);
     return checkReferences(this.library, options);
   }
   // Attachment operations
   async attachAdd(options) {
-    const { addAttachment: addAttachment2 } = await import("./index-CGV9-f_j.js");
+    const { addAttachment: addAttachment2 } = await import("./index-BZMfDG4M.js");
     return addAttachment2(this.library, options);
   }
   async attachList(options) {
-    const { listAttachments: listAttachments2 } = await import("./index-CGV9-f_j.js");
+    const { listAttachments: listAttachments2 } = await import("./index-BZMfDG4M.js");
     return listAttachments2(this.library, options);
   }
   async attachGet(options) {
-    const { getAttachment: getAttachment2 } = await import("./index-CGV9-f_j.js");
+    const { getAttachment: getAttachment2 } = await import("./index-BZMfDG4M.js");
     return getAttachment2(this.library, options);
   }
   async attachDetach(options) {
-    const { detachAttachment: detachAttachment2 } = await import("./index-CGV9-f_j.js");
+    const { detachAttachment: detachAttachment2 } = await import("./index-BZMfDG4M.js");
     return detachAttachment2(this.library, options);
   }
   async attachSync(options) {
-    const { syncAttachments: syncAttachments2 } = await import("./index-CGV9-f_j.js");
+    const { syncAttachments: syncAttachments2 } = await import("./index-BZMfDG4M.js");
     return syncAttachments2(this.library, options);
   }
   async attachOpen(options) {
-    const { openAttachment: openAttachment2 } = await import("./index-CGV9-f_j.js");
+    const { openAttachment: openAttachment2 } = await import("./index-BZMfDG4M.js");
     return openAttachment2(this.library, options);
   }
 }
@@ -1814,7 +1806,7 @@ function getAttachExitCode(result) {
 }
 async function executeInteractiveSelect$2(context, config2) {
   const { withAlternateScreen: withAlternateScreen2 } = await Promise.resolve().then(() => alternateScreen);
-  const { selectReferencesOrExit } = await import("./reference-select-Hc3wU8jL.js");
+  const { selectReferencesOrExit } = await import("./reference-select-Bm-05R0u.js");
   const allReferences = await context.library.getAll();
   const identifiers = await withAlternateScreen2(
     () => selectReferencesOrExit(allReferences, { multiSelect: false }, config2.cli.tui)
@@ -2479,7 +2471,7 @@ async function handleCheckAction(identifiers, options, globalOpts) {
     const jsonOptions = buildJsonOptionsFromRefs(options, outputFormat, result, allRefs);
     outputCheckResult(result, outputFormat, jsonOptions);
     if (options.fix && result.summary.warnings > 0 && allRefs) {
-      const { runFixInteraction } = await import("./fix-interaction-B6FGIOz8.js");
+      const { runFixInteraction } = await import("./fix-interaction-C3OrF3yU.js");
       const findItem = (id2) => allRefs.find((item) => item.id === id2);
       const fixResult = await runFixInteraction(result.results, context.library, findItem);
       const removedSuffix = fixResult.removed.length > 0 ? `, ${fixResult.removed.length} removed` : "";
@@ -2547,7 +2539,7 @@ function outputCheckError(error, format2) {
 }
 async function selectReferencesInteractively(context, config2) {
   const { withAlternateScreen: withAlternateScreen2 } = await Promise.resolve().then(() => alternateScreen);
-  const { selectReferenceItemsOrExit } = await import("./reference-select-Hc3wU8jL.js");
+  const { selectReferenceItemsOrExit } = await import("./reference-select-Bm-05R0u.js");
   const allReferences = await context.library.getAll();
   if (allReferences.length === 0) {
     process.stderr.write("No references in library.\n");
@@ -2615,8 +2607,8 @@ function getCiteExitCode(result) {
 }
 async function executeInteractiveCite(options, context, config2) {
   const { withAlternateScreen: withAlternateScreen2 } = await Promise.resolve().then(() => alternateScreen);
-  const { runCiteFlow } = await import("./index-KAr1YWtM.js");
-  const { buildStyleChoices, listCustomStyles } = await import("./style-select-CcRnu0nC.js");
+  const { runCiteFlow } = await import("./index-CA9y5wSm.js");
+  const { buildStyleChoices, listCustomStyles } = await import("./style-select-kfWjEg1X.js");
   const { search } = await import("./file-watcher-CWHg1yol.js").then((n) => n.B);
   const { tokenize } = await import("./file-watcher-CWHg1yol.js").then((n) => n.A);
   const { checkTTY } = await import("./tty-BMyaEOhX.js");
@@ -2790,6 +2782,21 @@ const CONFIG_KEY_REGISTRY = [
     type: "boolean",
     description: "Auto-fetch fulltext when adding references"
   },
+  {
+    key: "fulltext.pdf_converter",
+    type: "string",
+    description: "PDF converter: auto, marker, docling, mineru, pymupdf, or custom name"
+  },
+  {
+    key: "fulltext.pdf_converter_priority",
+    type: "string[]",
+    description: "PDF converter auto-detection priority order"
+  },
+  {
+    key: "fulltext.pdf_converter_timeout",
+    type: "integer",
+    description: "PDF converter timeout in seconds"
+  },
   {
     key: "fulltext.sources.unpaywall_email",
     type: "string",
@@ -2860,19 +2867,86 @@ const CONFIG_KEY_REGISTRY = [
   // mcp section
   { key: "mcp.default_limit", type: "integer", description: "Default result limit for MCP" }
 ];
+const DYNAMIC_KEY_PATTERNS = [
+  {
+    key: "fulltext.converters.*.command",
+    type: "string",
+    description: "Shell command template for the converter"
+  },
+  {
+    key: "fulltext.converters.*.output_mode",
+    type: "enum",
+    description: "Output mode",
+    enumValues: ["file", "stdout"],
+    optional: true
+  },
+  {
+    key: "fulltext.converters.*.check_command",
+    type: "string",
+    description: "Command to check converter availability",
+    optional: true
+  },
+  {
+    key: "fulltext.converters.*.timeout",
+    type: "integer",
+    description: "Converter timeout in seconds",
+    optional: true
+  },
+  {
+    key: "fulltext.converters.*.progress",
+    type: "enum",
+    description: "Progress display mode",
+    enumValues: ["inherit", "quiet"],
+    optional: true
+  },
+  {
+    key: "fulltext.converters.*.command_windows",
+    type: "string",
+    description: "Windows-specific command template",
+    optional: true
+  },
+  {
+    key: "fulltext.converters.*.check_command_windows",
+    type: "string",
+    description: "Windows-specific availability check command",
+    optional: true
+  }
+];
+const DYNAMIC_PATTERN_MAP = new Map(
+  DYNAMIC_KEY_PATTERNS.map((info) => [info.key, info])
+);
 const KEY_MAP = new Map(CONFIG_KEY_REGISTRY.map((info) => [info.key, info]));
 let allKeysCache = null;
 function parseConfigKey(key) {
   return key.split(".");
 }
+function toDynamicPattern(key) {
+  const segments = key.split(".");
+  if (segments.length >= 4 && segments[0] === "fulltext" && segments[1] === "converters") {
+    return `${segments[0]}.${segments[1]}.*.${segments.slice(3).join(".")}`;
+  }
+  return null;
+}
 function isValidConfigKey(key) {
   if (!key) {
     return false;
   }
-  return KEY_MAP.has(key);
+  if (KEY_MAP.has(key)) {
+    return true;
+  }
+  const pattern2 = toDynamicPattern(key);
+  return pattern2 !== null && DYNAMIC_PATTERN_MAP.has(pattern2);
 }
 function getConfigKeyInfo(key) {
-  return KEY_MAP.get(key) ?? null;
+  const info = KEY_MAP.get(key);
+  if (info) {
+    return info;
+  }
+  const pattern2 = toDynamicPattern(key);
+  if (pattern2) {
+    return DYNAMIC_PATTERN_MAP.get(pattern2) ?? null;
+  }
+  return null;
 }
 function getAllConfigKeys(section) {
   if (!allKeysCache) {
@@ -3896,8 +3970,8 @@ function requireReactJsxRuntime_development() {
       if ("object" === typeof type2 && null !== type2 && type2.$$typeof === REACT_LAZY_TYPE)
         return "<...>";
       try {
-        var name2 = getComponentNameFromType(type2);
-        return name2 ? "<" + name2 + ">" : "<...>";
+        var name = getComponentNameFromType(type2);
+        return name ? "<" + name + ">" : "<...>";
       } catch (x) {
         return "<...>";
       }
@@ -4391,9 +4465,9 @@ function compileStyleAliases(map2) {
 }
 function Type$1(tag, options) {
   options = options || {};
-  Object.keys(options).forEach(function(name2) {
-    if (TYPE_CONSTRUCTOR_OPTIONS.indexOf(name2) === -1) {
-      throw new exception('Unknown option "' + name2 + '" is met in definition of "' + tag + '" YAML type.');
+  Object.keys(options).forEach(function(name) {
+    if (TYPE_CONSTRUCTOR_OPTIONS.indexOf(name) === -1) {
+      throw new exception('Unknown option "' + name + '" is met in definition of "' + tag + '" YAML type.');
     }
   });
   this.options = options;
@@ -4417,9 +4491,9 @@ function Type$1(tag, options) {
   }
 }
 var type$2 = Type$1;
-function compileList(schema2, name2) {
+function compileList(schema2, name) {
   var result = [];
-  schema2[name2].forEach(function(currentType) {
+  schema2[name].forEach(function(currentType) {
     var newIndex = result.length;
     result.forEach(function(previousType, previousIndex) {
       if (previousType.tag === currentType.tag && previousType.kind === currentType.kind && previousType.multi === currentType.multi) {
@@ -5133,7 +5207,7 @@ function throwWarning(state, message) {
   }
 }
 var directiveHandlers = {
-  YAML: function handleYamlDirective(state, name2, args) {
+  YAML: function handleYamlDirective(state, name, args) {
     var match, major, minor;
     if (state.version !== null) {
       throwError(state, "duplication of %YAML directive");
@@ -5156,7 +5230,7 @@ var directiveHandlers = {
       throwWarning(state, "unsupported YAML version of the document");
     }
   },
-  TAG: function handleTagDirective(state, name2, args) {
+  TAG: function handleTagDirective(state, name, args) {
     var handle, prefix;
     if (args.length !== 2) {
       throwError(state, "TAG directive accepts exactly two arguments");
@@ -7217,7 +7291,7 @@ function formatEditOutput(result) {
 }
 async function executeInteractiveEdit(options, context, config2) {
   const { withAlternateScreen: withAlternateScreen2 } = await Promise.resolve().then(() => alternateScreen);
-  const { selectReferencesOrExit } = await import("./reference-select-Hc3wU8jL.js");
+  const { selectReferencesOrExit } = await import("./reference-select-Bm-05R0u.js");
   const allReferences = await context.library.getAll();
   const identifiers = await withAlternateScreen2(
     () => selectReferencesOrExit(allReferences, { multiSelect: true }, config2.cli.tui)
@@ -7476,8 +7550,8 @@ class Directives {
       this.atNextDocument = false;
     }
     const parts = line.trim().split(/[ \t]+/);
-    const name2 = parts.shift();
-    switch (name2) {
+    const name = parts.shift();
+    switch (name) {
       case "%TAG": {
         if (parts.length !== 2) {
           onError(0, "%TAG directive should contain exactly two parts");
@@ -7505,7 +7579,7 @@ class Directives {
         }
       }
       default:
-        onError(0, `Unknown directive ${name2}`, true);
+        onError(0, `Unknown directive ${name}`, true);
         return false;
     }
   }
@@ -7604,9 +7678,9 @@ function anchorNames(root) {
 }
 function findNewAnchor(prefix, exclude) {
   for (let i = 1; true; ++i) {
-    const name2 = `${prefix}${i}`;
-    if (!exclude.has(name2))
-      return name2;
+    const name = `${prefix}${i}`;
+    if (!exclude.has(name))
+      return name;
   }
 }
 function createNodeAnchors(doc, prefix) {
@@ -8515,8 +8589,8 @@ function getTagObject(tags, item) {
     tagObj = tags.find((t) => t.nodeClass && obj instanceof t.nodeClass);
   }
   if (!tagObj) {
-    const name2 = obj?.constructor?.name ?? (obj === null ? "null" : typeof obj);
-    throw new Error(`Tag not resolved for ${name2} value`);
+    const name = obj?.constructor?.name ?? (obj === null ? "null" : typeof obj);
+    throw new Error(`Tag not resolved for ${name} value`);
   }
   return tagObj;
 }
@@ -10104,11 +10178,11 @@ class Document {
    * `name` will be used as a prefix for a new unique anchor.
    * If `name` is undefined, the generated anchor will use 'a' as a prefix.
    */
-  createAlias(node, name2) {
+  createAlias(node, name) {
     if (!node.anchor) {
       const prev = anchorNames(this);
       node.anchor = // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing
-      !name2 || prev.has(name2) ? findNewAnchor(name2 || "a", prev) : name2;
+      !name || prev.has(name) ? findNewAnchor(name || "a", prev) : name;
     }
     return new Alias(node.anchor);
   }
@@ -10362,8 +10436,8 @@ function formatBibtexAuthor(author) {
 function formatBibtexAuthors(authors) {
   return authors.map(formatBibtexAuthor).join(" and ");
 }
-function formatField(name2, value) {
-  return `  ${name2} = {${value}},`;
+function formatField(name, value) {
+  return `  ${name} = {${value}},`;
 }
 function addBasicFields(lines, item) {
   if (item.title) {
@@ -10659,7 +10733,10 @@ async function executeFulltextConvert(options, context) {
   const operationOptions = {
     identifier: options.identifier,
     idType: options.idType,
-    fulltextDirectory: options.fulltextDirectory
+    fulltextDirectory: options.fulltextDirectory,
+    from: options.from,
+    converter: options.converter,
+    fulltextConfig: options.fulltextConfig
   };
   return fulltextConvert(context.library, operationOptions);
 }
@@ -10770,16 +10847,27 @@ function formatFetchErrorOutput(result) {
 }
 function formatFulltextConvertOutput(result) {
   if (!result.success) {
-    return `Error: ${result.error}`;
+    const lines = [`Error: ${result.error}`];
+    if (result.stderr) {
+      const stderrLines = result.stderr.trim().split("\n").slice(-5);
+      lines.push("", "  stderr (last lines):");
+      for (const line of stderrLines) {
+        lines.push(`    ${line}`);
+      }
+    }
+    if (result.hints) {
+      lines.push("", result.hints);
+    }
+    return lines.join("\n");
   }
-  return `Converted PMC XML to Markdown: ${result.filename}`;
+  return `Converted to Markdown: ${result.filename}`;
 }
 function getFulltextExitCode(result) {
   return result.success ? 0 : 1;
 }
 async function executeInteractiveSelect$1(context, config2, multiSelect = false) {
   const { withAlternateScreen: withAlternateScreen2 } = await Promise.resolve().then(() => alternateScreen);
-  const { selectReferencesOrExit } = await import("./reference-select-Hc3wU8jL.js");
+  const { selectReferencesOrExit } = await import("./reference-select-Bm-05R0u.js");
   const allReferences = await context.library.getAll();
   const identifiers = await withAlternateScreen2(
     () => selectReferencesOrExit(allReferences, { multiSelect }, config2.cli.tui)
@@ -11158,7 +11246,11 @@ async function handleFulltextConvertAction(identifierArg, options, globalOpts) {
     const convertOptions = {
       identifier,
       fulltextDirectory: config2.attachments.directory,
-      ...options.uuid && { idType: "uuid" }
+      ...options.uuid && { idType: "uuid" },
+      ...options.from && { from: options.from },
+      ...options.converter && { converter: options.converter },
+      ...options.force && { force: options.force },
+      fulltextConfig: config2.fulltext
     };
     const result = await executeFulltextConvert(convertOptions, context);
     const output = formatFulltextConvertOutput(result);
@@ -14971,7 +15063,7 @@ ZodEnum$1.create;
 ZodPromise.create;
 ZodOptional$1.create;
 ZodNullable$1.create;
-function $constructor(name2, initializer2, params) {
+function $constructor(name, initializer2, params) {
   function init(inst, def) {
     if (!inst._zod) {
       Object.defineProperty(inst, "_zod", {
@@ -14983,10 +15075,10 @@ function $constructor(name2, initializer2, params) {
         enumerable: false
       });
     }
-    if (inst._zod.traits.has(name2)) {
+    if (inst._zod.traits.has(name)) {
       return;
     }
-    inst._zod.traits.add(name2);
+    inst._zod.traits.add(name);
     initializer2(inst, def);
     const proto = _.prototype;
     const keys = Object.keys(proto);
@@ -15000,7 +15092,7 @@ function $constructor(name2, initializer2, params) {
   const Parent = params?.Parent ?? Object;
   class Definition extends Parent {
   }
-  Object.defineProperty(Definition, "name", { value: name2 });
+  Object.defineProperty(Definition, "name", { value: name });
   function _(def) {
     var _a2;
     const inst = params?.Parent ? new Definition() : this;
@@ -15016,10 +15108,10 @@ function $constructor(name2, initializer2, params) {
     value: (inst) => {
       if (params?.Parent && inst instanceof params.Parent)
         return true;
-      return inst?._zod?.traits?.has(name2);
+      return inst?._zod?.traits?.has(name);
     }
   });
-  Object.defineProperty(_, "name", { value: name2 });
+  Object.defineProperty(_, "name", { value: name });
   return _;
 }
 class $ZodAsyncError extends Error {
@@ -15028,8 +15120,8 @@ class $ZodAsyncError extends Error {
   }
 }
 class $ZodEncodeError extends Error {
-  constructor(name2) {
-    super(`Encountered unidirectional transform during encode: ${name2}`);
+  constructor(name) {
+    super(`Encountered unidirectional transform during encode: ${name}`);
     this.name = "ZodEncodeError";
   }
 }
@@ -21042,11 +21134,11 @@ const getRefs = (options) => {
     flags: { hasReferencedOpenAiAnyType: false },
     currentPath,
     propertyPath: void 0,
-    seen: new Map(Object.entries(_options.definitions).map(([name2, def]) => [
+    seen: new Map(Object.entries(_options.definitions).map(([name, def]) => [
       def._def,
       {
         def: def._def,
-        path: [..._options.basePath, _options.definitionPath, name2],
+        path: [..._options.basePath, _options.definitionPath, name],
         // Resolution of references will be forced even though seen, so it's ok that the schema is undefined here for now.
         jsonSchema: void 0
       }
@@ -22147,17 +22239,17 @@ const addMeta = (def, refs, jsonSchema) => {
 };
 const zodToJsonSchema = (schema2, options) => {
   const refs = getRefs(options);
-  let definitions2 = typeof options === "object" && options.definitions ? Object.entries(options.definitions).reduce((acc, [name3, schema3]) => ({
+  let definitions2 = typeof options === "object" && options.definitions ? Object.entries(options.definitions).reduce((acc, [name2, schema3]) => ({
     ...acc,
-    [name3]: parseDef(schema3._def, {
+    [name2]: parseDef(schema3._def, {
       ...refs,
-      currentPath: [...refs.basePath, refs.definitionPath, name3]
+      currentPath: [...refs.basePath, refs.definitionPath, name2]
     }, true) ?? parseAnyDef(refs)
   }), {}) : void 0;
-  const name2 = typeof options === "string" ? options : options?.nameStrategy === "title" ? void 0 : options?.name;
-  const main2 = parseDef(schema2._def, name2 === void 0 ? refs : {
+  const name = typeof options === "string" ? options : options?.nameStrategy === "title" ? void 0 : options?.name;
+  const main2 = parseDef(schema2._def, name === void 0 ? refs : {
     ...refs,
-    currentPath: [...refs.basePath, refs.definitionPath, name2]
+    currentPath: [...refs.basePath, refs.definitionPath, name]
   }, false) ?? parseAnyDef(refs);
   const title2 = typeof options === "object" && options.name !== void 0 && options.nameStrategy === "title" ? options.name : void 0;
   if (title2 !== void 0) {
@@ -22181,18 +22273,18 @@ const zodToJsonSchema = (schema2, options) => {
       };
     }
   }
-  const combined = name2 === void 0 ? definitions2 ? {
+  const combined = name === void 0 ? definitions2 ? {
     ...main2,
     [refs.definitionPath]: definitions2
   } : main2 : {
     $ref: [
       ...refs.$refStrategy === "relative" ? [] : refs.basePath,
       refs.definitionPath,
-      name2
+      name
     ].join("/"),
     [refs.definitionPath]: {
       ...definitions2,
-      [name2]: main2
+      [name]: main2
     }
   };
   if (refs.target === "jsonSchema7") {
@@ -23351,9 +23443,9 @@ function requireScope() {
     exports$1.ValueScope = exports$1.ValueScopeName = exports$1.Scope = exports$1.varKinds = exports$1.UsedValueState = void 0;
     const code_1 = requireCode$1();
     class ValueError extends Error {
-      constructor(name2) {
-        super(`CodeGen: "code" for ${name2} not defined`);
-        this.value = name2.value;
+      constructor(name) {
+        super(`CodeGen: "code" for ${name} not defined`);
+        this.value = name.value;
       }
     }
     var UsedValueState;
@@ -23420,8 +23512,8 @@ function requireScope() {
         var _a2;
         if (value.ref === void 0)
           throw new Error("CodeGen: ref must be passed in value");
-        const name2 = this.toName(nameOrPrefix);
-        const { prefix } = name2;
+        const name = this.toName(nameOrPrefix);
+        const { prefix } = name;
         const valueKey = (_a2 = value.key) !== null && _a2 !== void 0 ? _a2 : value.ref;
         let vs = this._values[prefix];
         if (vs) {
@@ -23431,12 +23523,12 @@ function requireScope() {
         } else {
           vs = this._values[prefix] = /* @__PURE__ */ new Map();
         }
-        vs.set(valueKey, name2);
+        vs.set(valueKey, name);
         const s = this._scope[prefix] || (this._scope[prefix] = []);
         const itemIndex = s.length;
         s[itemIndex] = value.ref;
-        name2.setValue(value, { property: prefix, itemIndex });
-        return name2;
+        name.setValue(value, { property: prefix, itemIndex });
+        return name;
       }
       getValue(prefix, keyOrRef) {
         const vs = this._values[prefix];
@@ -23445,17 +23537,17 @@ function requireScope() {
         return vs.get(keyOrRef);
       }
       scopeRefs(scopeName, values = this._values) {
-        return this._reduceValues(values, (name2) => {
-          if (name2.scopePath === void 0)
-            throw new Error(`CodeGen: name "${name2}" has no value`);
-          return (0, code_1._)`${scopeName}${name2.scopePath}`;
+        return this._reduceValues(values, (name) => {
+          if (name.scopePath === void 0)
+            throw new Error(`CodeGen: name "${name}" has no value`);
+          return (0, code_1._)`${scopeName}${name.scopePath}`;
         });
       }
       scopeCode(values = this._values, usedValues, getCode) {
-        return this._reduceValues(values, (name2) => {
-          if (name2.value === void 0)
-            throw new Error(`CodeGen: name "${name2}" has no value`);
-          return name2.value.code;
+        return this._reduceValues(values, (name) => {
+          if (name.value === void 0)
+            throw new Error(`CodeGen: name "${name}" has no value`);
+          return name.value.code;
         }, usedValues, getCode);
       }
       _reduceValues(values, valueCode, usedValues = {}, getCode) {
@@ -23465,20 +23557,20 @@ function requireScope() {
           if (!vs)
             continue;
           const nameSet = usedValues[prefix] = usedValues[prefix] || /* @__PURE__ */ new Map();
-          vs.forEach((name2) => {
-            if (nameSet.has(name2))
+          vs.forEach((name) => {
+            if (nameSet.has(name))
               return;
-            nameSet.set(name2, UsedValueState.Started);
-            let c = valueCode(name2);
+            nameSet.set(name, UsedValueState.Started);
+            let c = valueCode(name);
             if (c) {
               const def = this.opts.es5 ? exports$1.varKinds.var : exports$1.varKinds.const;
-              code2 = (0, code_1._)`${code2}${def} ${name2} = ${c};${this.opts._n}`;
-            } else if (c = getCode === null || getCode === void 0 ? void 0 : getCode(name2)) {
+              code2 = (0, code_1._)`${code2}${def} ${name} = ${c};${this.opts._n}`;
+            } else if (c = getCode === null || getCode === void 0 ? void 0 : getCode(name)) {
               code2 = (0, code_1._)`${code2}${c}${this.opts._n}`;
             } else {
-              throw new ValueError(name2);
+              throw new ValueError(name);
             }
-            nameSet.set(name2, UsedValueState.Completed);
+            nameSet.set(name, UsedValueState.Completed);
           });
         }
         return code2;
@@ -23556,10 +23648,10 @@ function requireCodegen() {
       }
     }
     class Def extends Node {
-      constructor(varKind, name2, rhs) {
+      constructor(varKind, name, rhs) {
         super();
         this.varKind = varKind;
-        this.name = name2;
+        this.name = name;
         this.rhs = rhs;
       }
       render({ es5, _n }) {
@@ -23779,17 +23871,17 @@ function requireCodegen() {
       }
     }
     class ForRange extends For {
-      constructor(varKind, name2, from, to) {
+      constructor(varKind, name, from, to) {
         super();
         this.varKind = varKind;
-        this.name = name2;
+        this.name = name;
         this.from = from;
         this.to = to;
       }
       render(opts) {
         const varKind = opts.es5 ? scope_1.varKinds.var : this.varKind;
-        const { name: name2, from, to } = this;
-        return `for(${varKind} ${name2}=${from}; ${name2}<${to}; ${name2}++)` + super.render(opts);
+        const { name, from, to } = this;
+        return `for(${varKind} ${name}=${from}; ${name}<${to}; ${name}++)` + super.render(opts);
       }
       get names() {
         const names2 = addExprNames(super.names, this.from);
@@ -23797,11 +23889,11 @@ function requireCodegen() {
       }
     }
     class ForIter extends For {
-      constructor(loop, varKind, name2, iterable) {
+      constructor(loop, varKind, name, iterable) {
         super();
         this.loop = loop;
         this.varKind = varKind;
-        this.name = name2;
+        this.name = name;
         this.iterable = iterable;
       }
       render(opts) {
@@ -23818,9 +23910,9 @@ function requireCodegen() {
       }
     }
     class Func extends BlockNode {
-      constructor(name2, args, async) {
+      constructor(name, args, async) {
         super();
-        this.name = name2;
+        this.name = name;
         this.args = args;
         this.async = async;
       }
@@ -23907,10 +23999,10 @@ function requireCodegen() {
       }
       // reserves unique name in the external scope and assigns value to it
       scopeValue(prefixOrName, value) {
-        const name2 = this._extScope.value(prefixOrName, value);
-        const vs = this._values[name2.prefix] || (this._values[name2.prefix] = /* @__PURE__ */ new Set());
-        vs.add(name2);
-        return name2;
+        const name = this._extScope.value(prefixOrName, value);
+        const vs = this._values[name.prefix] || (this._values[name.prefix] = /* @__PURE__ */ new Set());
+        vs.add(name);
+        return name;
       }
       getScopeValue(prefix, keyOrRef) {
         return this._extScope.getValue(prefix, keyOrRef);
@@ -23924,11 +24016,11 @@ function requireCodegen() {
         return this._extScope.scopeCode(this._values);
       }
       _def(varKind, nameOrPrefix, rhs, constant) {
-        const name2 = this._scope.toName(nameOrPrefix);
+        const name = this._scope.toName(nameOrPrefix);
         if (rhs !== void 0 && constant)
-          this._constants[name2.str] = rhs;
-        this._leafNode(new Def(varKind, name2, rhs));
-        return name2;
+          this._constants[name.str] = rhs;
+        this._leafNode(new Def(varKind, name, rhs));
+        return name;
       }
       // `const` declaration (`var` in es5 mode)
       const(nameOrPrefix, rhs, _constant) {
@@ -24009,20 +24101,20 @@ function requireCodegen() {
       }
       // `for` statement for a range of values
       forRange(nameOrPrefix, from, to, forBody, varKind = this.opts.es5 ? scope_1.varKinds.var : scope_1.varKinds.let) {
-        const name2 = this._scope.toName(nameOrPrefix);
-        return this._for(new ForRange(varKind, name2, from, to), () => forBody(name2));
+        const name = this._scope.toName(nameOrPrefix);
+        return this._for(new ForRange(varKind, name, from, to), () => forBody(name));
       }
       // `for-of` statement (in es5 mode replace with a normal for loop)
       forOf(nameOrPrefix, iterable, forBody, varKind = scope_1.varKinds.const) {
-        const name2 = this._scope.toName(nameOrPrefix);
+        const name = this._scope.toName(nameOrPrefix);
         if (this.opts.es5) {
           const arr = iterable instanceof code_1.Name ? iterable : this.var("_arr", iterable);
           return this.forRange("_i", 0, (0, code_1._)`${arr}.length`, (i) => {
-            this.var(name2, (0, code_1._)`${arr}[${i}]`);
-            forBody(name2);
+            this.var(name, (0, code_1._)`${arr}[${i}]`);
+            forBody(name);
           });
         }
-        return this._for(new ForIter("of", varKind, name2, iterable), () => forBody(name2));
+        return this._for(new ForIter("of", varKind, name, iterable), () => forBody(name));
       }
       // `for-in` statement.
       // With option `ownProperties` replaced with a `for-of` loop for object keys
@@ -24030,8 +24122,8 @@ function requireCodegen() {
         if (this.opts.ownProperties) {
           return this.forOf(nameOrPrefix, (0, code_1._)`Object.keys(${obj})`, forBody);
         }
-        const name2 = this._scope.toName(nameOrPrefix);
-        return this._for(new ForIter("in", varKind, name2, obj), () => forBody(name2));
+        const name = this._scope.toName(nameOrPrefix);
+        return this._for(new ForIter("in", varKind, name, obj), () => forBody(name));
       }
       // end `for` loop
       endFor() {
@@ -24096,8 +24188,8 @@ function requireCodegen() {
         return this;
       }
       // `function` heading (or definition if funcBody is passed)
-      func(name2, args = code_1.nil, async, funcBody) {
-        this._blockNode(new Func(name2, args, async));
+      func(name, args = code_1.nil, async, funcBody) {
+        this._blockNode(new Func(name, args, async));
         if (funcBody)
           this.code(funcBody).endFunc();
         return this;
@@ -26530,10 +26622,10 @@ function requireSchemes() {
       "urn:uuid"
     ]
   );
-  function isValidSchemeName(name2) {
+  function isValidSchemeName(name) {
     return supportedSchemeNames.indexOf(
       /** @type {*} */
-      name2
+      name
     ) !== -1;
   }
   function wsIsSecure(wsComponent) {
@@ -27370,10 +27462,10 @@ function requireCore$1() {
         return this;
       }
       // Add format
-      addFormat(name2, format2) {
+      addFormat(name, format2) {
         if (typeof format2 == "string")
           format2 = new RegExp(format2);
-        this.formats[name2] = format2;
+        this.formats[name] = format2;
         return this;
       }
       errorsText(errors2 = this.errors, { separator = ", ", dataVar = "data" } = {}) {
@@ -27490,10 +27582,10 @@ function requireCore$1() {
           this.addSchema(optsSchemas[key], key);
     }
     function addInitialFormats() {
-      for (const name2 in this.opts.formats) {
-        const format2 = this.opts.formats[name2];
+      for (const name in this.opts.formats) {
+        const format2 = this.opts.formats[name];
         if (format2)
-          this.addFormat(name2, format2);
+          this.addFormat(name, format2);
       }
     }
     function addInitialKeywords(defs) {
@@ -29793,11 +29885,11 @@ function requireDist() {
         (0, limit_1.default)(ajv2);
       return ajv2;
     };
-    formatsPlugin.get = (name2, mode = "full") => {
+    formatsPlugin.get = (name, mode = "full") => {
       const formats2 = mode === "fast" ? formats_1.fastFormats : formats_1.fullFormats;
-      const f = formats2[name2];
+      const f = formats2[name];
       if (!f)
-        throw new Error(`Unknown format "${name2}"`);
+        throw new Error(`Unknown format "${name}"`);
       return f;
     };
     function addFormats(ajv2, list, fs2, exportName) {
@@ -30410,11 +30502,11 @@ class UriTemplate {
         const operator = this.getOperator(expr);
         const exploded = expr.includes("*");
         const names2 = this.getNames(expr);
-        const name2 = names2[0];
-        for (const name3 of names2) {
-          UriTemplate.validateLength(name3, MAX_VARIABLE_LENGTH, "Variable name");
+        const name = names2[0];
+        for (const name2 of names2) {
+          UriTemplate.validateLength(name2, MAX_VARIABLE_LENGTH, "Variable name");
         }
-        parts.push({ name: name2, operator, names: names2, exploded });
+        parts.push({ name, operator, names: names2, exploded });
         i = end + 1;
       } else {
         currentText += template[i];
@@ -30432,7 +30524,7 @@ class UriTemplate {
   }
   getNames(expr) {
     const operator = this.getOperator(expr);
-    return expr.slice(operator.length).split(",").map((name2) => name2.replace("*", "").trim()).filter((name2) => name2.length > 0);
+    return expr.slice(operator.length).split(",").map((name) => name.replace("*", "").trim()).filter((name) => name.length > 0);
   }
   encodeValue(value, operator) {
     UriTemplate.validateLength(value, MAX_VARIABLE_LENGTH, "Variable value");
@@ -30443,12 +30535,12 @@ class UriTemplate {
   }
   expandPart(part, variables) {
     if (part.operator === "?" || part.operator === "&") {
-      const pairs2 = part.names.map((name2) => {
-        const value2 = variables[name2];
+      const pairs2 = part.names.map((name) => {
+        const value2 = variables[name];
         if (value2 === void 0)
           return "";
         const encoded2 = Array.isArray(value2) ? value2.map((v) => this.encodeValue(v, part.operator)).join(",") : this.encodeValue(value2.toString(), part.operator);
-        return `${name2}=${encoded2}`;
+        return `${name}=${encoded2}`;
       }).filter((pair) => pair.length > 0);
       if (pairs2.length === 0)
         return "";
@@ -30456,7 +30548,7 @@ class UriTemplate {
       return separator + pairs2.join("&");
     }
     if (part.names.length > 1) {
-      const values2 = part.names.map((name2) => variables[name2]).filter((v) => v !== void 0);
+      const values2 = part.names.map((name) => variables[name]).filter((v) => v !== void 0);
       if (values2.length === 0)
         return "";
       return values2.map((v) => Array.isArray(v) ? v[0] : v).join(",");
@@ -30508,22 +30600,22 @@ class UriTemplate {
   }
   partToRegExp(part) {
     const patterns = [];
-    for (const name3 of part.names) {
-      UriTemplate.validateLength(name3, MAX_VARIABLE_LENGTH, "Variable name");
+    for (const name2 of part.names) {
+      UriTemplate.validateLength(name2, MAX_VARIABLE_LENGTH, "Variable name");
     }
     if (part.operator === "?" || part.operator === "&") {
       for (let i = 0; i < part.names.length; i++) {
-        const name3 = part.names[i];
+        const name2 = part.names[i];
         const prefix = i === 0 ? "\\" + part.operator : "&";
         patterns.push({
-          pattern: prefix + this.escapeRegExp(name3) + "=([^&]+)",
-          name: name3
+          pattern: prefix + this.escapeRegExp(name2) + "=([^&]+)",
+          name: name2
         });
       }
       return patterns;
     }
     let pattern2;
-    const name2 = part.name;
+    const name = part.name;
     switch (part.operator) {
       case "":
         pattern2 = part.exploded ? "([^/]+(?:,[^/]+)*)" : "([^/,]+)";
@@ -30541,7 +30633,7 @@ class UriTemplate {
       default:
         pattern2 = "([^/]+)";
     }
-    patterns.push({ pattern: pattern2, name: name2 });
+    patterns.push({ pattern: pattern2, name });
     return patterns;
   }
   match(uri2) {
@@ -30553,9 +30645,9 @@ class UriTemplate {
         pattern2 += this.escapeRegExp(part);
       } else {
         const patterns = this.partToRegExp(part);
-        for (const { pattern: partPattern, name: name2 } of patterns) {
+        for (const { pattern: partPattern, name } of patterns) {
           pattern2 += partPattern;
-          names2.push({ name: name2, exploded: part.exploded });
+          names2.push({ name, exploded: part.exploded });
         }
       }
     }
@@ -30567,9 +30659,9 @@ class UriTemplate {
       return null;
     const result = {};
     for (let i = 0; i < names2.length; i++) {
-      const { name: name2, exploded } = names2[i];
+      const { name, exploded } = names2[i];
       const value = match[i + 1];
-      const cleanName = name2.replace("*", "");
+      const cleanName = name.replace("*", "");
       if (exploded && value.includes(",")) {
         result[cleanName] = value.split(",");
       } else {
@@ -30580,34 +30672,34 @@ class UriTemplate {
   }
 }
 const TOOL_NAME_REGEX = /^[A-Za-z0-9._-]{1,128}$/;
-function validateToolName(name2) {
+function validateToolName(name) {
   const warnings = [];
-  if (name2.length === 0) {
+  if (name.length === 0) {
     return {
       isValid: false,
       warnings: ["Tool name cannot be empty"]
     };
   }
-  if (name2.length > 128) {
+  if (name.length > 128) {
     return {
       isValid: false,
-      warnings: [`Tool name exceeds maximum length of 128 characters (current: ${name2.length})`]
+      warnings: [`Tool name exceeds maximum length of 128 characters (current: ${name.length})`]
     };
   }
-  if (name2.includes(" ")) {
+  if (name.includes(" ")) {
     warnings.push("Tool name contains spaces, which may cause parsing issues");
   }
-  if (name2.includes(",")) {
+  if (name.includes(",")) {
     warnings.push("Tool name contains commas, which may cause parsing issues");
   }
-  if (name2.startsWith("-") || name2.endsWith("-")) {
+  if (name.startsWith("-") || name.endsWith("-")) {
     warnings.push("Tool name starts or ends with a dash, which may cause parsing issues in some contexts");
   }
-  if (name2.startsWith(".") || name2.endsWith(".")) {
+  if (name.startsWith(".") || name.endsWith(".")) {
     warnings.push("Tool name starts or ends with a dot, which may cause parsing issues in some contexts");
   }
-  if (!TOOL_NAME_REGEX.test(name2)) {
-    const invalidChars = name2.split("").filter((char) => !/[A-Za-z0-9._-]/.test(char)).filter((char, index, arr) => arr.indexOf(char) === index);
+  if (!TOOL_NAME_REGEX.test(name)) {
+    const invalidChars = name.split("").filter((char) => !/[A-Za-z0-9._-]/.test(char)).filter((char, index, arr) => arr.indexOf(char) === index);
     warnings.push(`Tool name contains invalid characters: ${invalidChars.map((c) => `"${c}"`).join(", ")}`, "Allowed characters are: A-Z, a-z, 0-9, underscore (_), dash (-), and dot (.)");
     return {
       isValid: false,
@@ -30619,9 +30711,9 @@ function validateToolName(name2) {
     warnings
   };
 }
-function issueToolNameWarning(name2, warnings) {
+function issueToolNameWarning(name, warnings) {
   if (warnings.length > 0) {
-    console.warn(`Tool name validation warning for "${name2}":`);
+    console.warn(`Tool name validation warning for "${name}":`);
     for (const warning of warnings) {
       console.warn(`  - ${warning}`);
     }
@@ -30630,22 +30722,22 @@ function issueToolNameWarning(name2, warnings) {
     console.warn("See SEP: Specify Format for Tool Names (https://github.com/modelcontextprotocol/modelcontextprotocol/issues/986) for more details.");
   }
 }
-function validateAndWarnToolName(name2) {
-  const result = validateToolName(name2);
-  issueToolNameWarning(name2, result.warnings);
+function validateAndWarnToolName(name) {
+  const result = validateToolName(name);
+  issueToolNameWarning(name, result.warnings);
   return result.isValid;
 }
 class ExperimentalMcpServerTasks {
   constructor(_mcpServer) {
     this._mcpServer = _mcpServer;
   }
-  registerToolTask(name2, config2, handler) {
+  registerToolTask(name, config2, handler) {
     const execution = { taskSupport: "required", ...config2.execution };
     if (execution.taskSupport === "forbidden") {
-      throw new Error(`Cannot register task-based tool '${name2}' with taskSupport 'forbidden'. Use registerTool() instead.`);
+      throw new Error(`Cannot register task-based tool '${name}' with taskSupport 'forbidden'. Use registerTool() instead.`);
     }
     const mcpServerInternal = this._mcpServer;
-    return mcpServerInternal._createRegisteredTool(name2, config2.title, config2.description, config2.inputSchema, config2.outputSchema, config2.annotations, execution, config2._meta, handler);
+    return mcpServerInternal._createRegisteredTool(name, config2.title, config2.description, config2.inputSchema, config2.outputSchema, config2.annotations, execution, config2._meta, handler);
   }
 }
 class McpServer {
@@ -30701,9 +30793,9 @@ class McpServer {
       }
     });
     this.server.setRequestHandler(ListToolsRequestSchema, () => ({
-      tools: Object.entries(this._registeredTools).filter(([, tool]) => tool.enabled).map(([name2, tool]) => {
+      tools: Object.entries(this._registeredTools).filter(([, tool]) => tool.enabled).map(([name, tool]) => {
         const toolDefinition = {
-          name: name2,
+          name,
           title: tool.title,
           description: tool.description,
           inputSchema: (() => {
@@ -30975,8 +31067,8 @@ class McpServer {
       return { resources: [...resources, ...templateResources] };
     });
     this.server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => {
-      const resourceTemplates = Object.entries(this._registeredResourceTemplates).map(([name2, template]) => ({
-        name: name2,
+      const resourceTemplates = Object.entries(this._registeredResourceTemplates).map(([name, template]) => ({
+        name,
         uriTemplate: template.resourceTemplate.uriTemplate.toString(),
         ...template.metadata
       }));
@@ -31013,9 +31105,9 @@ class McpServer {
       }
     });
     this.server.setRequestHandler(ListPromptsRequestSchema, () => ({
-      prompts: Object.entries(this._registeredPrompts).filter(([, prompt]) => prompt.enabled).map(([name2, prompt]) => {
+      prompts: Object.entries(this._registeredPrompts).filter(([, prompt]) => prompt.enabled).map(([name, prompt]) => {
         return {
-          name: name2,
+          name,
           title: prompt.title,
           description: prompt.description,
           arguments: prompt.argsSchema ? promptArgumentsFromSchema(prompt.argsSchema) : void 0
@@ -31048,7 +31140,7 @@ class McpServer {
     });
     this._promptHandlersInitialized = true;
   }
-  resource(name2, uriOrTemplate, ...rest) {
+  resource(name, uriOrTemplate, ...rest) {
     let metadata2;
     if (typeof rest[0] === "object") {
       metadata2 = rest.shift();
@@ -31058,42 +31150,42 @@ class McpServer {
       if (this._registeredResources[uriOrTemplate]) {
         throw new Error(`Resource ${uriOrTemplate} is already registered`);
       }
-      const registeredResource = this._createRegisteredResource(name2, void 0, uriOrTemplate, metadata2, readCallback);
+      const registeredResource = this._createRegisteredResource(name, void 0, uriOrTemplate, metadata2, readCallback);
       this.setResourceRequestHandlers();
       this.sendResourceListChanged();
       return registeredResource;
     } else {
-      if (this._registeredResourceTemplates[name2]) {
-        throw new Error(`Resource template ${name2} is already registered`);
+      if (this._registeredResourceTemplates[name]) {
+        throw new Error(`Resource template ${name} is already registered`);
       }
-      const registeredResourceTemplate = this._createRegisteredResourceTemplate(name2, void 0, uriOrTemplate, metadata2, readCallback);
+      const registeredResourceTemplate = this._createRegisteredResourceTemplate(name, void 0, uriOrTemplate, metadata2, readCallback);
       this.setResourceRequestHandlers();
       this.sendResourceListChanged();
       return registeredResourceTemplate;
     }
   }
-  registerResource(name2, uriOrTemplate, config2, readCallback) {
+  registerResource(name, uriOrTemplate, config2, readCallback) {
     if (typeof uriOrTemplate === "string") {
       if (this._registeredResources[uriOrTemplate]) {
         throw new Error(`Resource ${uriOrTemplate} is already registered`);
       }
-      const registeredResource = this._createRegisteredResource(name2, config2.title, uriOrTemplate, config2, readCallback);
+      const registeredResource = this._createRegisteredResource(name, config2.title, uriOrTemplate, config2, readCallback);
       this.setResourceRequestHandlers();
       this.sendResourceListChanged();
       return registeredResource;
     } else {
-      if (this._registeredResourceTemplates[name2]) {
-        throw new Error(`Resource template ${name2} is already registered`);
+      if (this._registeredResourceTemplates[name]) {
+        throw new Error(`Resource template ${name} is already registered`);
       }
-      const registeredResourceTemplate = this._createRegisteredResourceTemplate(name2, config2.title, uriOrTemplate, config2, readCallback);
+      const registeredResourceTemplate = this._createRegisteredResourceTemplate(name, config2.title, uriOrTemplate, config2, readCallback);
       this.setResourceRequestHandlers();
       this.sendResourceListChanged();
       return registeredResourceTemplate;
     }
   }
-  _createRegisteredResource(name2, title2, uri2, metadata2, readCallback) {
+  _createRegisteredResource(name, title2, uri2, metadata2, readCallback) {
     const registeredResource = {
-      name: name2,
+      name,
       title: title2,
       metadata: metadata2,
       readCallback,
@@ -31123,7 +31215,7 @@ class McpServer {
     this._registeredResources[uri2] = registeredResource;
     return registeredResource;
   }
-  _createRegisteredResourceTemplate(name2, title2, template, metadata2, readCallback) {
+  _createRegisteredResourceTemplate(name, title2, template, metadata2, readCallback) {
     const registeredResourceTemplate = {
       resourceTemplate: template,
       title: title2,
@@ -31134,8 +31226,8 @@ class McpServer {
       enable: () => registeredResourceTemplate.update({ enabled: true }),
       remove: () => registeredResourceTemplate.update({ name: null }),
       update: (updates) => {
-        if (typeof updates.name !== "undefined" && updates.name !== name2) {
-          delete this._registeredResourceTemplates[name2];
+        if (typeof updates.name !== "undefined" && updates.name !== name) {
+          delete this._registeredResourceTemplates[name];
           if (updates.name)
             this._registeredResourceTemplates[updates.name] = registeredResourceTemplate;
         }
@@ -31152,7 +31244,7 @@ class McpServer {
         this.sendResourceListChanged();
       }
     };
-    this._registeredResourceTemplates[name2] = registeredResourceTemplate;
+    this._registeredResourceTemplates[name] = registeredResourceTemplate;
     const variableNames = template.uriTemplate.variableNames;
     const hasCompleter = Array.isArray(variableNames) && variableNames.some((v) => !!template.completeCallback(v));
     if (hasCompleter) {
@@ -31160,7 +31252,7 @@ class McpServer {
     }
     return registeredResourceTemplate;
   }
-  _createRegisteredPrompt(name2, title2, description2, argsSchema, callback) {
+  _createRegisteredPrompt(name, title2, description2, argsSchema, callback) {
     const registeredPrompt = {
       title: title2,
       description: description2,
@@ -31171,8 +31263,8 @@ class McpServer {
       enable: () => registeredPrompt.update({ enabled: true }),
       remove: () => registeredPrompt.update({ name: null }),
       update: (updates) => {
-        if (typeof updates.name !== "undefined" && updates.name !== name2) {
-          delete this._registeredPrompts[name2];
+        if (typeof updates.name !== "undefined" && updates.name !== name) {
+          delete this._registeredPrompts[name];
           if (updates.name)
             this._registeredPrompts[updates.name] = registeredPrompt;
         }
@@ -31189,7 +31281,7 @@ class McpServer {
         this.sendPromptListChanged();
       }
     };
-    this._registeredPrompts[name2] = registeredPrompt;
+    this._registeredPrompts[name] = registeredPrompt;
     if (argsSchema) {
       const hasCompletable = Object.values(argsSchema).some((field) => {
         const inner = field instanceof ZodOptional$2 ? field._def?.innerType : field;
@@ -31201,8 +31293,8 @@ class McpServer {
     }
     return registeredPrompt;
   }
-  _createRegisteredTool(name2, title2, description2, inputSchema, outputSchema, annotations, execution, _meta, handler) {
-    validateAndWarnToolName(name2);
+  _createRegisteredTool(name, title2, description2, inputSchema, outputSchema, annotations, execution, _meta, handler) {
+    validateAndWarnToolName(name);
     const registeredTool = {
       title: title2,
       description: description2,
@@ -31217,11 +31309,11 @@ class McpServer {
       enable: () => registeredTool.update({ enabled: true }),
       remove: () => registeredTool.update({ name: null }),
       update: (updates) => {
-        if (typeof updates.name !== "undefined" && updates.name !== name2) {
+        if (typeof updates.name !== "undefined" && updates.name !== name) {
           if (typeof updates.name === "string") {
             validateAndWarnToolName(updates.name);
           }
-          delete this._registeredTools[name2];
+          delete this._registeredTools[name];
           if (updates.name)
             this._registeredTools[updates.name] = registeredTool;
         }
@@ -31244,7 +31336,7 @@ class McpServer {
         this.sendToolListChanged();
       }
     };
-    this._registeredTools[name2] = registeredTool;
+    this._registeredTools[name] = registeredTool;
     this.setToolRequestHandlers();
     this.sendToolListChanged();
     return registeredTool;
@@ -31252,9 +31344,9 @@ class McpServer {
   /**
    * tool() implementation. Parses arguments passed to overrides defined above.
    */
-  tool(name2, ...rest) {
-    if (this._registeredTools[name2]) {
-      throw new Error(`Tool ${name2} is already registered`);
+  tool(name, ...rest) {
+    if (this._registeredTools[name]) {
+      throw new Error(`Tool ${name} is already registered`);
     }
     let description2;
     let inputSchema;
@@ -31275,21 +31367,21 @@ class McpServer {
       }
     }
     const callback = rest[0];
-    return this._createRegisteredTool(name2, void 0, description2, inputSchema, outputSchema, annotations, { taskSupport: "forbidden" }, void 0, callback);
+    return this._createRegisteredTool(name, void 0, description2, inputSchema, outputSchema, annotations, { taskSupport: "forbidden" }, void 0, callback);
   }
   /**
    * Registers a tool with a config object and callback.
    */
-  registerTool(name2, config2, cb) {
-    if (this._registeredTools[name2]) {
-      throw new Error(`Tool ${name2} is already registered`);
+  registerTool(name, config2, cb) {
+    if (this._registeredTools[name]) {
+      throw new Error(`Tool ${name} is already registered`);
     }
     const { title: title2, description: description2, inputSchema, outputSchema, annotations, _meta } = config2;
-    return this._createRegisteredTool(name2, title2, description2, inputSchema, outputSchema, annotations, { taskSupport: "forbidden" }, _meta, cb);
+    return this._createRegisteredTool(name, title2, description2, inputSchema, outputSchema, annotations, { taskSupport: "forbidden" }, _meta, cb);
   }
-  prompt(name2, ...rest) {
-    if (this._registeredPrompts[name2]) {
-      throw new Error(`Prompt ${name2} is already registered`);
+  prompt(name, ...rest) {
+    if (this._registeredPrompts[name]) {
+      throw new Error(`Prompt ${name} is already registered`);
     }
     let description2;
     if (typeof rest[0] === "string") {
@@ -31300,7 +31392,7 @@ class McpServer {
       argsSchema = rest.shift();
     }
     const cb = rest[0];
-    const registeredPrompt = this._createRegisteredPrompt(name2, void 0, description2, argsSchema, cb);
+    const registeredPrompt = this._createRegisteredPrompt(name, void 0, description2, argsSchema, cb);
     this.setPromptRequestHandlers();
     this.sendPromptListChanged();
     return registeredPrompt;
@@ -31308,12 +31400,12 @@ class McpServer {
   /**
    * Registers a prompt with a config object and callback.
    */
-  registerPrompt(name2, config2, cb) {
-    if (this._registeredPrompts[name2]) {
-      throw new Error(`Prompt ${name2} is already registered`);
+  registerPrompt(name, config2, cb) {
+    if (this._registeredPrompts[name]) {
+      throw new Error(`Prompt ${name} is already registered`);
     }
     const { title: title2, description: description2, argsSchema } = config2;
-    const registeredPrompt = this._createRegisteredPrompt(name2, title2, description2, argsSchema, cb);
+    const registeredPrompt = this._createRegisteredPrompt(name, title2, description2, argsSchema, cb);
     this.setPromptRequestHandlers();
     this.sendPromptListChanged();
     return registeredPrompt;
@@ -31419,11 +31511,11 @@ function promptArgumentsFromSchema(schema2) {
   const shape = getObjectShape(schema2);
   if (!shape)
     return [];
-  return Object.entries(shape).map(([name2, field]) => {
+  return Object.entries(shape).map(([name, field]) => {
     const description2 = getSchemaDescription(field);
     const isOptional = isSchemaOptional(field);
     return {
-      name: name2,
+      name,
       description: description2,
       required: !isOptional
     };
@@ -32015,9 +32107,11 @@ function registerFulltextConvertTool(server, getLibraryOperations, getConfig) {
   server.registerTool(
     "fulltext_convert",
     {
-      description: "Convert an attached PMC JATS XML file to Markdown for a reference.",
+      description: "Convert an attached fulltext file (PMC JATS XML or PDF) to Markdown for a reference. Auto-detects format (XML preferred over PDF). Use 'from' to force a specific format.",
       inputSchema: {
-        id: z.string().describe("Reference ID")
+        id: z.string().describe("Reference ID"),
+        from: z.enum(["xml", "pdf"]).optional().describe("Input format: xml, pdf (default: auto-detect)"),
+        converter: z.string().optional().describe("PDF converter: auto, marker, docling, mineru, pymupdf, or custom name")
       }
     },
     async (args) => {
@@ -32025,11 +32119,18 @@ function registerFulltextConvertTool(server, getLibraryOperations, getConfig) {
       const config2 = getConfig();
       const result = await fulltextConvert(libraryOps, {
         identifier: args.id,
-        fulltextDirectory: config2.attachments.directory
+        fulltextDirectory: config2.attachments.directory,
+        from: args.from,
+        converter: args.converter,
+        fulltextConfig: config2.fulltext
       });
       if (!result.success) {
+        const errorParts = [result.error ?? "Unknown error"];
+        if (result.hints) {
+          errorParts.push(result.hints);
+        }
         return {
-          content: [{ type: "text", text: result.error ?? "Unknown error" }],
+          content: [{ type: "text", text: errorParts.join("\n\n") }],
           isError: true
         };
       }
@@ -32037,7 +32138,7 @@ function registerFulltextConvertTool(server, getLibraryOperations, getConfig) {
         content: [
           {
             type: "text",
-            text: `Converted PMC XML to Markdown for '${args.id}': ${result.filename}`
+            text: `Converted to Markdown for '${args.id}': ${result.filename}`
           }
         ]
       };
@@ -32234,7 +32335,7 @@ async function mcpStart(options) {
 async function executeRemove(options, context) {
   const { identifier, idType = "id", fulltextDirectory, deleteFulltext = false } = options;
   if (context.mode === "local" && deleteFulltext && fulltextDirectory) {
-    const { removeReference } = await import("./index-6Aild0Uk.js").then((n) => n.x);
+    const { removeReference } = await import("./index-C_mW5LMY.js").then((n) => n.A);
     return removeReference(context.library, {
       identifier,
       idType,
@@ -32289,7 +32390,7 @@ Continue?`;
 }
 async function executeInteractiveRemove(context, config2) {
   const { withAlternateScreen: withAlternateScreen2 } = await Promise.resolve().then(() => alternateScreen);
-  const { selectReferenceItemsOrExit } = await import("./reference-select-Hc3wU8jL.js");
+  const { selectReferenceItemsOrExit } = await import("./reference-select-Bm-05R0u.js");
   const allReferences = await context.library.getAll();
   const selectedItems = await withAlternateScreen2(
     () => selectReferenceItemsOrExit(allReferences, { multiSelect: false }, config2.cli.tui)
@@ -32514,7 +32615,7 @@ async function executeInteractiveSearch(options, context, config2) {
   validateInteractiveOptions(options);
   const { checkTTY } = await import("./tty-BMyaEOhX.js");
   const { withAlternateScreen: withAlternateScreen2 } = await Promise.resolve().then(() => alternateScreen);
-  const { runSearchFlow } = await import("./index-KAr1YWtM.js");
+  const { runSearchFlow } = await import("./index-CA9y5wSm.js");
   const { search } = await import("./file-watcher-CWHg1yol.js").then((n) => n.B);
   const { tokenize } = await import("./file-watcher-CWHg1yol.js").then((n) => n.A);
   checkTTY();
@@ -32533,7 +32634,7 @@ async function executeInteractiveSearch(options, context, config2) {
     })
   );
   if (result.selectedItems && !result.cancelled) {
-    const { isSideEffectAction } = await import("./action-menu-C4nIA-Sl.js");
+    const { isSideEffectAction } = await import("./action-menu-DCZcb0HB.js");
     if (isSideEffectAction(result.action)) {
       await executeSideEffectAction(result.action, result.selectedItems, context, config2);
       return { output: "", cancelled: false, action: result.action };
@@ -32549,7 +32650,7 @@ async function executeSideEffectAction(action, items2, context, config2) {
   switch (action) {
     case "open-url": {
       const { resolveDefaultUrl: resolveDefaultUrl2 } = await Promise.resolve().then(() => url);
-      const { openWithSystemApp: openWithSystemApp2 } = await import("./loader-B6sytmQd.js").then((n) => n.j);
+      const { openWithSystemApp: openWithSystemApp2 } = await import("./loader-BG2eomDC.js").then((n) => n.j);
       const item = items2[0];
       if (!item) return;
       const url$1 = resolveDefaultUrl2(item);
@@ -32944,7 +33045,7 @@ function formatUpdateOutput(result, identifier) {
 }
 async function executeInteractiveUpdate(context, config2) {
   const { withAlternateScreen: withAlternateScreen2 } = await Promise.resolve().then(() => alternateScreen);
-  const { selectReferencesOrExit } = await import("./reference-select-Hc3wU8jL.js");
+  const { selectReferencesOrExit } = await import("./reference-select-Bm-05R0u.js");
   const allReferences = await context.library.getAll();
   const identifiers = await withAlternateScreen2(
     () => selectReferencesOrExit(allReferences, { multiSelect: false }, config2.cli.tui)
@@ -33239,7 +33340,7 @@ function getUrlExitCode(result) {
 }
 async function executeInteractiveSelect(context, config2) {
   const { withAlternateScreen: withAlternateScreen2 } = await Promise.resolve().then(() => alternateScreen);
-  const { selectReferencesOrExit } = await import("./reference-select-Hc3wU8jL.js");
+  const { selectReferencesOrExit } = await import("./reference-select-Bm-05R0u.js");
   const allReferences = await context.library.getAll();
   const identifiers = await withAlternateScreen2(
     () => selectReferencesOrExit(allReferences, { multiSelect: false }, config2.cli.tui)
@@ -33351,7 +33452,7 @@ const ID_COMPLETION_COMMANDS = /* @__PURE__ */ new Set(["cite", "remove", "updat
 const ID_COMPLETION_FULLTEXT_SUBCOMMANDS = /* @__PURE__ */ new Set(["attach", "get", "detach", "open"]);
 const ID_COMPLETION_ATTACH_SUBCOMMANDS = /* @__PURE__ */ new Set(["open", "add", "list", "get", "detach", "sync"]);
 function toCompletionItems(values) {
-  return values.map((name2) => ({ name: name2 }));
+  return values.map((name) => ({ name }));
 }
 function extractSubcommands(program) {
   return program.commands.map((cmd) => ({
@@ -33380,8 +33481,8 @@ function extractGlobalOptions(program) {
   options.push({ name: "--version", description: "output the version number" });
   return options;
 }
-function findSubcommand(program, name2) {
-  return program.commands.find((cmd) => cmd.name() === name2);
+function findSubcommand(program, name) {
+  return program.commands.find((cmd) => cmd.name() === name);
 }
 function parseCommandContext(env) {
   const words = env.line.trim().split(/\s+/);
@@ -33574,6 +33675,54 @@ function registerCompletionCommand(program) {
     }
   });
 }
+function buildConvertHelpText() {
+  const rows = BUILTIN_CONVERTER_NAMES.map((name) => {
+    const info = BUILTIN_CONVERTER_INFO[name];
+    return `  ${name.padEnd(10)}${info.install.padEnd(28)}${info.description}`;
+  });
+  const priority = BUILTIN_CONVERTER_NAMES.join(" > ");
+  return `
+BUILT-IN CONVERTERS
+  Name      Install                     Notes
+${rows.join("\n")}
+
+  In auto mode (default), the first available converter is used.
+  Priority: ${priority}
+
+CUSTOM CONVERTERS
+  Add via config set:
+    ref config set fulltext.converters.my-tool.command "my-tool {input} -o {output}"
+    ref config set fulltext.converters.my-tool.check_command "my-tool --version"
+
+  Or edit config.toml directly (ref config edit):
+    [fulltext.converters.my-tool]
+    command = "my-tool convert {input} -o {output}"
+    check_command = "my-tool --version"
+
+  Template placeholders:
+    {input}        Input PDF path
+    {output}       Output Markdown path
+    {input_dir}    Directory of input file
+    {input_name}   Basename of input file
+    {output_name}  Basename of output file
+
+  Additional options:
+    output_mode    "file" (default) or "stdout"
+    timeout        Seconds (default: 300)
+    progress       "inherit" (default) or "quiet"
+
+  Use with:  ref fulltext convert <ref> --converter my-tool
+
+CONFIGURATION
+  ref config set fulltext.pdf_converter marker
+  ref config set fulltext.pdf_converter_timeout 600
+  ref config edit                  # Edit config.toml directly
+
+EXAMPLES
+  $ ref fulltext convert smith2023
+  $ ref fulltext convert smith2023 --converter marker
+  $ ref fulltext convert smith2023 --from pdf --force`;
+}
 function buildSearchHelpText() {
   return `
 QUERY SYNTAX
@@ -33796,7 +33945,7 @@ function shouldAutoFetch(cliFlag, configEnabled) {
   return configEnabled;
 }
 async function performAutoFetch(addedItems, context, config2) {
-  const { fulltextFetch: fulltextFetch2 } = await import("./index-6Aild0Uk.js").then((n) => n.w);
+  const { fulltextFetch: fulltextFetch2 } = await import("./index-C_mW5LMY.js").then((n) => n.z);
   const fetchResults = await autoFetchFulltext(addedItems, context, {
     fulltextConfig: config2.fulltext,
     fulltextDirectory: config2.attachments.directory,
@@ -34049,7 +34198,10 @@ function registerFulltextCommand(program) {
   fulltextCmd.command("fetch").description("Download OA full text and auto-attach to a reference").argument("[identifier]", "Citation key or UUID (interactive selection if omitted)").option("--source <source>", "Preferred source: pmc, arxiv, unpaywall, core").option("-f, --force", "Overwrite existing fulltext attachment").option("--uuid", "Interpret identifier as UUID").action(async (identifier, options) => {
     await handleFulltextFetchAction(identifier, options, program.opts());
   });
-  fulltextCmd.command("convert").description("Convert attached PMC XML to Markdown").argument("[identifier]", "Citation key or UUID (interactive selection if omitted)").option("--uuid", "Interpret identifier as UUID").action(async (identifier, options) => {
+  fulltextCmd.command("convert").description("Convert attached fulltext (XML or PDF) to Markdown").argument("[identifier]", "Citation key or UUID (interactive selection if omitted)").option("--uuid", "Interpret identifier as UUID").option("--from <format>", "Input format: xml, pdf (default: auto-detect)").option(
+    "--converter <name>",
+    "PDF converter: auto, marker, docling, mineru, pymupdf, or custom name"
+  ).option("--force", "Overwrite existing markdown attachment").addHelpText("after", buildConvertHelpText()).action(async (identifier, options) => {
     await handleFulltextConvertAction(identifier, options, program.opts());
   });
 }
@@ -34088,4 +34240,4 @@ export {
   restoreStdinAfterInk as r,
   syncAttachments as s
 };
-//# sourceMappingURL=index-Czz9ZhIH.js.map
+//# sourceMappingURL=index-4w0pu_0o.js.map