ai4l-library-dev 0.1.3 → 0.1.4

package/dist/index.js

@@ -10,6 +10,7 @@ function dotenvFile(env = process.env) {
   const lib = env.AI4L_LIBRARY_DIR?.trim() || (existsSync("/library") ? "/library" : "library");
   return join(resolve(lib), ".env");
 }
+var loadedFromDotenv = /* @__PURE__ */ new Set();
 function loadDotenv(file = dotenvFile()) {
   if (!existsSync(file)) return [];
   const loaded = [];
@@ -24,81 +25,46 @@ function loadDotenv(file = dotenvFile()) {
     if (process.env[m[1]] === void 0) {
       process.env[m[1]] = v;
       loaded.push(m[1]);
+      loadedFromDotenv.add(m[1]);
     }
   }
   return loaded;
 }
+function sourceOf(name, env = process.env) {
+  if (!env[name]?.trim()) return "default";
+  return loadedFromDotenv.has(name) ? ".env" : "environment";
+}
+var str = (name, env = process.env) => env[name]?.trim() ?? "";
+function num(name, def, env = process.env, ok = (n) => n >= 0) {
+  const v = str(name, env);
+  if (!v) return def;
+  const n = Number(v);
+  return Number.isFinite(n) && ok(n) ? n : def;
+}
+function bool(name, def, env = process.env) {
+  const v = str(name, env).toLowerCase();
+  return ["true", "1", "yes", "on"].includes(v) ? true : ["false", "0", "no", "off"].includes(v) ? false : def;
+}
 
 // src/index.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
 // src/tools.ts
-import { existsSync as existsSync10, readFileSync as readFileSync9 } from "fs";
+import { existsSync as existsSync8, readFileSync as readFileSync7 } from "fs";
 import { z } from "zod";
 
 // src/entry.ts
-import { copyFileSync, existsSync as existsSync4, mkdirSync, readdirSync, readFileSync as readFileSync3, renameSync, rmSync, writeFileSync } from "fs";
-import { join as join4 } from "path";
+import { copyFileSync, existsSync as existsSync2, mkdirSync, readdirSync, readFileSync as readFileSync2, renameSync, rmSync, writeFileSync } from "fs";
+import { join as join2 } from "path";
 import { basename, dirname } from "path";
 
 // src/pubmed.ts
 import { XMLParser } from "fast-xml-parser";
 
-// src/contact.ts
-import { existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
-import { join as join3 } from "path";
-
-// src/layout.ts
-import { createHash } from "crypto";
-import { existsSync as existsSync2 } from "fs";
-import { join as join2, resolve as resolve2 } from "path";
-var AI4L_LIBRARY_DIR = (() => {
-  const env = process.env.AI4L_LIBRARY_DIR;
-  if (env && env.trim()) return resolve2(env.trim());
-  if (existsSync2("/library")) return "/library";
-  return resolve2("library");
-})();
-var doiSlug = (doi) => doi.toLowerCase().replace(/[^a-z0-9.-]+/g, "_");
-function entryDirRel(type, num) {
-  if (type === "doi") {
-    const h = createHash("sha1").update(num).digest("hex");
-    return `${type}/${h.slice(0, 2)}/${h.slice(0, 4)}/${num}`;
-  }
-  if (!/^\d+$/.test(num)) return `${type}/${num.slice(0, 2)}/${num.slice(0, 4)}/${num}`;
-  const l1 = num.length > 6 ? num.slice(0, -6) : "0";
-  const l2 = num.length > 4 ? num.slice(0, -4) : "0";
-  return `${type}/${l1}/${l2}/${num}`;
-}
-function entryPaths(libraryDir, type, num) {
-  if (type === "doi") num = doiSlug(num);
-  const entry = `${type}-${num}`;
-  const entryDir = join2(libraryDir, entryDirRel(type, num));
-  return {
-    entry,
-    entryDir,
-    xml: join2(entryDir, `${entry}-abstract.xml`),
-    md: join2(entryDir, `${entry}-abstract.md`),
-    meta: join2(entryDir, `${entry}-meta.md`),
-    fulltextMd: join2(entryDir, `${entry}-fulltext.md`),
-    fulltextRaw: (format) => join2(entryDir, `${entry}-fulltext.${format}`)
-  };
-}
-
 // src/contact.ts
 var DEFAULT = "hello@forever-healthy.org";
-function contactEmail() {
-  const file = process.env.AI4L_LIBRARY_CONFIG?.trim() || join3(AI4L_LIBRARY_DIR, "config.json");
-  let v = "";
-  if (existsSync3(file)) {
-    try {
-      v = String(JSON.parse(readFileSync2(file, "utf8")).contact_email ?? "");
-    } catch {
-    }
-  }
-  v = v.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g, (_, n) => process.env[n] ?? "").trim();
-  return v || process.env.CONTACT_EMAIL?.trim() || DEFAULT;
-}
+var contactEmail = (env = process.env) => str("AI4L_LIBRARY_CONTACT_EMAIL", env) || DEFAULT;
 
 // src/http.ts
 var TIMEOUT_MS = 3e4;
@@ -1047,7 +1013,7 @@ ${body}
 }
 function readHeadLine(p) {
   try {
-    const lines = readFileSync3(p.md, "utf8").split("\n").filter((l) => l.trim());
+    const lines = readFileSync2(p.md, "utf8").split("\n").filter((l) => l.trim());
     return lines[1] ?? "";
   } catch {
     return "";
@@ -1169,28 +1135,28 @@ function splitPublicationTypes(v) {
 }
 function abstractMissing(p) {
   try {
-    return readFileSync3(p.md, "utf8").includes("_No abstract available._");
+    return readFileSync2(p.md, "utf8").includes("_No abstract available._");
   } catch {
     return false;
   }
 }
 function correctionsFromXml(p) {
   try {
-    return parsePubmedXml(readFileSync3(p.xml, "utf8"))?.corrections ?? [];
+    return parsePubmedXml(readFileSync2(p.xml, "utf8"))?.corrections ?? [];
   } catch {
     return [];
   }
 }
 function declarationsFromXml(p) {
   try {
-    const r = parsePubmedXml(readFileSync3(p.xml, "utf8"));
+    const r = parsePubmedXml(readFileSync2(p.xml, "utf8"));
     return { coi: r?.coi ?? null, funding: r?.funding ?? [] };
   } catch {
     return { coi: null, funding: [] };
   }
 }
 function readMeta(p) {
-  const { fm, all } = parseFrontmatter(readFileSync3(p.meta, "utf8"));
+  const { fm, all } = parseFrontmatter(readFileSync2(p.meta, "utf8"));
   let title = fm.title ?? "";
   if (title.startsWith('"')) {
     try {
@@ -1251,12 +1217,12 @@ function copyEntry(from, to) {
   rmSync(tmp, { recursive: true, force: true });
   mkdirSync(tmp, { recursive: true });
   const rename = (n) => n.startsWith(from.entry) ? to.entry + n.slice(from.entry.length) : n;
-  for (const n of readdirSync(from.entryDir)) if (join4(from.entryDir, n) !== from.meta && !n.endsWith(".tmp")) copyFileSync(join4(from.entryDir, n), join4(tmp, rename(n)));
+  for (const n of readdirSync(from.entryDir)) if (join2(from.entryDir, n) !== from.meta && !n.endsWith(".tmp")) copyFileSync(join2(from.entryDir, n), join2(tmp, rename(n)));
   const m = readMeta(from);
   const copy = { ...m, files: m.files.map(rename) };
-  writeFileSync(join4(tmp, basename(to.meta)), renderMeta(copy));
+  writeFileSync(join2(tmp, basename(to.meta)), renderMeta(copy));
   mkdirSync(dirname(to.entryDir), { recursive: true });
-  if (existsSync4(to.entryDir)) renameSync(to.entryDir, old);
+  if (existsSync2(to.entryDir)) renameSync(to.entryDir, old);
   renameSync(tmp, to.entryDir);
   rmSync(old, { recursive: true, force: true });
   return copy;
@@ -1276,7 +1242,7 @@ function citability(m) {
   return { citable: true, comment: notes.length ? notes.join("; ") : null };
 }
 function statusFromMeta(p, m, base) {
-  const full = existsSync4(p.fulltextMd) ? readFileSync3(p.fulltextMd, "utf8") : null;
+  const full = existsSync2(p.fulltextMd) ? readFileSync2(p.fulltextMd, "utf8") : null;
   const cit = citability(m);
   if (full?.includes(`
 ${CORRECTED_HEADING}
@@ -1318,7 +1284,7 @@ function readStatus(p, base) {
   return statusFromMeta(p, readMeta(p), base);
 }
 function entryExists(p) {
-  return existsSync4(p.meta);
+  return existsSync2(p.meta);
 }
 function writeEntry(p, r, xml, converter) {
   mkdirSync(p.entryDir, { recursive: true });
@@ -1401,15 +1367,15 @@ ${sentences.join("\n\n")}
 `;
 }
 function syncCorrectedBlock(p) {
-  if (!existsSync4(p.fulltextMd) || !existsSync4(p.xml)) return;
+  if (!existsSync2(p.fulltextMd) || !existsSync2(p.xml)) return;
   let r;
   try {
-    r = parsePubmedXml(readFileSync3(p.xml, "utf8"));
+    r = parsePubmedXml(readFileSync2(p.xml, "utf8"));
   } catch {
     return;
   }
   if (!r) return;
-  const md = readFileSync3(p.fulltextMd, "utf8");
+  const md = readFileSync2(p.fulltextMd, "utf8");
   const next = withCorrectedBlock(md, correctedSentences(r));
   if (next !== md) writeAtomic(p.fulltextMd, next);
 }
@@ -1518,10 +1484,6 @@ function writeDoiEntry(p, r, json2, converter, abstractFrom = "crossref", record
   return meta;
 }
 
-// src/config.ts
-import { existsSync as existsSync7, readFileSync as readFileSync6 } from "fs";
-import { join as join7 } from "path";
-
 // src/checks.ts
 var GREEK = { "\u03B1": "alpha", "\u03B2": "beta", "\xDF": "beta", "\u03B3": "gamma", "\u03B4": "delta", "\u03B5": "epsilon", "\u03B6": "zeta", "\u03B7": "eta", "\u03B8": "theta", "\u03B9": "iota", "\u03BA": "kappa", "\u03BB": "lambda", "\u03BC": "mu", "\xB5": "mu", "\u03BD": "nu", "\u03BE": "xi", "\u03C0": "pi", "\u03C1": "rho", "\u03C3": "sigma", "\u03C4": "tau", "\u03C5": "upsilon", "\u03C6": "phi", "\u03C7": "chi", "\u03C8": "psi", "\u03C9": "omega", "\u0391": "alpha", "\u0392": "beta", "\u0393": "gamma", "\u0394": "delta", "\u03A9": "omega", "\u03A3": "sigma", "\u039A": "kappa", "\u039B": "lambda", "\u03A0": "pi", "\u03A6": "phi", "\u03A8": "psi" };
 var greek = (s) => s.replace(/[\u0370-\u03ff\u00b5\u00df]/g, (c) => GREEK[c] ?? c);
@@ -1934,24 +1896,55 @@ function renderFulltextMd(doc, headLine2) {
 }
 
 // src/browser.ts
-import { existsSync as existsSync5, mkdirSync as mkdirSync2, readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "fs";
-import { join as join5 } from "path";
+import { existsSync as existsSync4, mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
+import { join as join4 } from "path";
 import { chromium } from "playwright-core";
-function browserConfig(file = CONFIG_FILE) {
+
+// src/layout.ts
+import { createHash } from "crypto";
+import { existsSync as existsSync3 } from "fs";
+import { join as join3, resolve as resolve2 } from "path";
+var AI4L_LIBRARY_DIR = (() => {
+  const env = process.env.AI4L_LIBRARY_DIR;
+  if (env && env.trim()) return resolve2(env.trim());
+  if (existsSync3("/library")) return "/library";
+  return resolve2("library");
+})();
+var doiSlug = (doi) => doi.toLowerCase().replace(/[^a-z0-9.-]+/g, "_");
+function entryDirRel(type, num2) {
+  if (type === "doi") {
+    const h = createHash("sha1").update(num2).digest("hex");
+    return `${type}/${h.slice(0, 2)}/${h.slice(0, 4)}/${num2}`;
+  }
+  if (!/^\d+$/.test(num2)) return `${type}/${num2.slice(0, 2)}/${num2.slice(0, 4)}/${num2}`;
+  const l1 = num2.length > 6 ? num2.slice(0, -6) : "0";
+  const l2 = num2.length > 4 ? num2.slice(0, -4) : "0";
+  return `${type}/${l1}/${l2}/${num2}`;
+}
+function entryPaths(libraryDir, type, num2) {
+  if (type === "doi") num2 = doiSlug(num2);
+  const entry = `${type}-${num2}`;
+  const entryDir = join3(libraryDir, entryDirRel(type, num2));
+  return {
+    entry,
+    entryDir,
+    xml: join3(entryDir, `${entry}-abstract.xml`),
+    md: join3(entryDir, `${entry}-abstract.md`),
+    meta: join3(entryDir, `${entry}-meta.md`),
+    fulltextMd: join3(entryDir, `${entry}-fulltext.md`),
+    fulltextRaw: (format) => join3(entryDir, `${entry}-fulltext.${format}`)
+  };
+}
+
+// src/browser.ts
+function browserConfig(env = process.env) {
   const out = { browsers: [], headless: "auto" };
-  if (!existsSync5(file)) return out;
-  try {
-    const d = JSON.parse(readFileSync4(file, "utf8")).download ?? {};
-    if (Array.isArray(d.browsers)) {
-      for (const b of d.browsers) {
-        if (typeof b !== "string") continue;
-        const v = resolveEnv(b).trim();
-        if (v && !/^\$\{[A-Z0-9_]+\}$/.test(v) && !out.browsers.includes(v)) out.browsers.push(v);
-      }
-    }
-    if (d.headless === "auto" || typeof d.headless === "boolean") out.headless = d.headless;
-  } catch {
+  for (let i = 1; i <= 9; i++) {
+    const v = str(`AI4L_LIBRARY_BROWSER_${i}`, env);
+    if (v && !out.browsers.includes(v)) out.browsers.push(v);
   }
+  const h = str("AI4L_LIBRARY_BROWSER_HEADLESS", env).toLowerCase();
+  if (h === "true" || h === "false") out.headless = h === "true";
   return out;
 }
 var INSTALL_HINT = "npx playwright-core install chromium";
@@ -1962,7 +1955,7 @@ var rungKind = (endpoint) => isCdp(endpoint) ? "chrome" : isRemote(endpoint) ? "
 function localChromium() {
   try {
     const p = chromium.executablePath();
-    return existsSync5(p) ? p : null;
+    return existsSync4(p) ? p : null;
   } catch {
     return null;
   }
@@ -1999,12 +1992,12 @@ var IDLE_CLOSE_MS = 12e4;
 var ctxs = /* @__PURE__ */ new Map();
 var idleTimer = null;
 function profileDir() {
-  const dir = join5(AI4L_LIBRARY_DIR, ".browser");
-  mkdirSync2(join5(dir, "Default"), { recursive: true });
-  const prefs = join5(dir, "Default", "Preferences");
+  const dir = join4(AI4L_LIBRARY_DIR, ".browser");
+  mkdirSync2(join4(dir, "Default"), { recursive: true });
+  const prefs = join4(dir, "Default", "Preferences");
   let p = {};
   try {
-    p = JSON.parse(readFileSync4(prefs, "utf8"));
+    p = JSON.parse(readFileSync3(prefs, "utf8"));
   } catch {
   }
   p.plugins = { ...p.plugins ?? {}, always_open_pdf_externally: true };
@@ -2017,9 +2010,9 @@ var LOCAL_WINDOW_ARGS = [...LAUNCH_ARGS, "--window-position=4000,4000"];
 var TIMEZONE = Intl.DateTimeFormat().resolvedOptions().timeZone || "Europe/Berlin";
 var CONTEXT_OPTS = { acceptDownloads: true, viewport: null, locale: "en-US", timezoneId: TIMEZONE };
 function stateFile(endpoint) {
-  const dir = join5(AI4L_LIBRARY_DIR, ".browser");
+  const dir = join4(AI4L_LIBRARY_DIR, ".browser");
   mkdirSync2(dir, { recursive: true });
-  return join5(dir, `${browserLabel(endpoint).replace(/[^A-Za-z0-9.-]+/g, "_")}.json`);
+  return join4(dir, `${browserLabel(endpoint).replace(/[^A-Za-z0-9.-]+/g, "_")}.json`);
 }
 async function context(endpoint, cfg) {
   let p = ctxs.get(endpoint);
@@ -2042,7 +2035,7 @@ async function context(endpoint, cfg) {
         });
         browser.on("disconnected", drop);
         const state = stateFile(endpoint);
-        const ctx2 = await browser.newContext({ ...CONTEXT_OPTS, ...existsSync5(state) ? { storageState: state } : {} });
+        const ctx2 = await browser.newContext({ ...CONTEXT_OPTS, ...existsSync4(state) ? { storageState: state } : {} });
         return { ctx: ctx2, browser };
       }
       if (!localChromium()) throw new Error(`no local Chromium (${INSTALL_HINT})`);
@@ -2137,7 +2130,7 @@ async function browserFetch(url, endpoint, cfg = browserConfig()) {
     }
     if (download2) {
       const d = download2;
-      return { bytes: readFileSync4(await d.path()), contentType: "application/pdf", url: d.url(), via: "download" };
+      return { bytes: readFileSync3(await d.path()), contentType: "application/pdf", url: d.url(), via: "download" };
     }
     const title = await page.title().catch(() => "");
     if (CHALLENGE.test(title)) throw new Error(`challenge not cleared (${title.slice(0, 40)})`);
@@ -2456,16 +2449,16 @@ function europepmcCandidates(r, pmcid) {
 }
 
 // src/tiers/inbox.ts
-import { existsSync as existsSync6, readdirSync as readdirSync2, readFileSync as readFileSync5, unlinkSync } from "fs";
-import { join as join6 } from "path";
-var INBOX_DIR = join6(AI4L_LIBRARY_DIR, "inbox");
+import { existsSync as existsSync5, readdirSync as readdirSync2, readFileSync as readFileSync4, unlinkSync } from "fs";
+import { join as join5 } from "path";
+var INBOX_DIR = join5(AI4L_LIBRARY_DIR, "inbox");
 var EXT = { ".pdf": "application/pdf", ".xml": "text/xml", ".html": "text/html", ".htm": "text/html" };
 function findInboxFile(dir, pmid) {
-  if (!existsSync6(dir)) return null;
+  if (!existsSync5(dir)) return null;
   const re = new RegExp(`(^|[^0-9])${pmid}([^0-9]|$)`);
   for (const name of readdirSync2(dir).sort()) {
     const ext = name.slice(name.lastIndexOf(".")).toLowerCase();
-    if (ext in EXT && re.test(name.slice(0, -ext.length))) return join6(dir, name);
+    if (ext in EXT && re.test(name.slice(0, -ext.length))) return join5(dir, name);
   }
   return null;
 }
@@ -2479,7 +2472,7 @@ function inboxTier(dir = INBOX_DIR) {
       if (!file) return { ...miss("inbox", "no file"), skipped: true, ephemeral: true };
       const name = file.slice(file.lastIndexOf("/") + 1);
       const ext = name.slice(name.lastIndexOf(".")).toLowerCase();
-      const bytes = readFileSync5(file);
+      const bytes = readFileSync4(file);
       const r = await convertBytes(p, bytes, EXT[ext]);
       if (!r.ok) return miss("inbox", `${name}: ${r.reason}`);
       ctx.onTry?.(`${name} ok, removed from the inbox`);
@@ -2678,74 +2671,70 @@ function urlTier(name, template, headers) {
 }
 
 // src/config.ts
-var CONFIG_FILE = process.env.AI4L_LIBRARY_CONFIG?.trim() || join7(AI4L_LIBRARY_DIR, "config.json");
-function resolveEnv(v, env = process.env) {
-  return v.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g, (_, n) => env[n] ?? "");
-}
-var resolveMap = (m) => m ? Object.fromEntries(Object.entries(m).map(([k, v]) => [k, resolveEnv(String(v))])) : void 0;
-function settings(file = CONFIG_FILE) {
-  const out = { retry_after_days: 1, retry_blocked: false, refresh_after_days: 30 };
-  if (!existsSync7(file)) return out;
-  try {
-    const cfg = JSON.parse(readFileSync6(file, "utf8"));
-    if (typeof cfg.retry_after_days === "number" && cfg.retry_after_days >= 0) out.retry_after_days = cfg.retry_after_days;
-    if (typeof cfg.retry_blocked === "boolean") out.retry_blocked = cfg.retry_blocked;
-    if (typeof cfg.refresh_after_days === "number" && cfg.refresh_after_days >= 0) out.refresh_after_days = cfg.refresh_after_days;
-  } catch {
+var VARIABLES = [
+  "AI4L_LIBRARY_DIR",
+  "AI4L_LIBRARY_ENV",
+  "AI4L_LIBRARY_TIERS",
+  "AI4L_LIBRARY_CONTACT_EMAIL",
+  "AI4L_LIBRARY_ELSEVIER_API_KEY",
+  "AI4L_LIBRARY_WILEY_TDM_TOKEN",
+  "AI4L_LIBRARY_CORE_API_KEY",
+  "AI4L_LIBRARY_PROXY_URL",
+  "AI4L_LIBRARY_PROXY_HEADERS",
+  "AI4L_LIBRARY_BROWSER_1",
+  "AI4L_LIBRARY_BROWSER_2",
+  "AI4L_LIBRARY_BROWSER_3",
+  "AI4L_LIBRARY_BROWSER_HEADLESS",
+  "AI4L_LIBRARY_VERIFY_URL",
+  "AI4L_LIBRARY_VERIFY_API_KEY",
+  "AI4L_LIBRARY_VERIFY_MODEL",
+  "AI4L_LIBRARY_VERIFY_THRESHOLD",
+  "AI4L_LIBRARY_VERIFY_TIMEOUT_SECS",
+  "AI4L_LIBRARY_RETRY_AFTER_DAYS",
+  "AI4L_LIBRARY_RETRY_BLOCKED",
+  "AI4L_LIBRARY_REFRESH_AFTER_DAYS",
+  "NCBI_API_KEY",
+  "BRIGHTDATA_API_TOKEN",
+  "BRIGHTDATA_ZONE"
+];
+var sources = (env = process.env) => Object.fromEntries(VARIABLES.map((v) => [v, sourceOf(v, env)]));
+function settings(env = process.env) {
+  return {
+    retry_after_days: num("AI4L_LIBRARY_RETRY_AFTER_DAYS", 1, env),
+    retry_blocked: bool("AI4L_LIBRARY_RETRY_BLOCKED", false, env),
+    refresh_after_days: num("AI4L_LIBRARY_REFRESH_AFTER_DAYS", 30, env)
+  };
+}
+function proxyHeaders(spec) {
+  const out = {};
+  for (const part of spec.split(";")) {
+    const i = part.indexOf(":");
+    if (i < 0) continue;
+    const name = part.slice(0, i).trim(), value = part.slice(i + 1).trim();
+    if (name && value) out[name] = value;
   }
   return out;
 }
-function resolveTiers(env = process.env.AI4L_LIBRARY_TIERS, file = CONFIG_FILE) {
+function resolveTiers(env = process.env) {
   const problems = [];
-  const builtin = new Map(BUILTIN.map((t) => [t.name, t]));
-  const known = /* @__PURE__ */ new Map();
-  let source = "default";
-  for (const t of BUILTIN) known.set(t.name, { tier: t.make({}), enabled: true, kind: "builtin" });
-  if (existsSync7(file)) {
-    source = "file";
-    let cfg = {};
-    try {
-      cfg = JSON.parse(readFileSync6(file, "utf8"));
-    } catch (e) {
-      problems.push(`${file}: ${e instanceof Error ? e.message : String(e)}`);
-    }
-    if (Array.isArray(cfg.tiers)) {
-      for (const k of known.keys()) known.get(k).enabled = false;
-      const ordered = /* @__PURE__ */ new Map();
-      for (const e of cfg.tiers) {
-        if (!e || typeof e.name !== "string" || !e.name.trim()) {
-          problems.push(`${file}: tier entry without name`);
-          continue;
-        }
-        const enabled = e.enabled !== false;
-        const description = typeof e.description === "string" ? e.description : void 0;
-        if (typeof e.url === "string" && e.url.trim()) ordered.set(e.name, { tier: urlTier(e.name, resolveEnv(e.url.trim()), resolveMap(e.headers)), enabled, kind: "url", description });
-        else if (builtin.has(e.name)) ordered.set(e.name, { tier: builtin.get(e.name).make({ tokens: resolveMap(e.tokens), api_key: typeof e.api_key === "string" ? resolveEnv(e.api_key) : void 0 }), enabled, kind: "builtin", description });
-        else problems.push(`${file}: unknown tier "${e.name}" (built-in: ${[...builtin.keys()].join(", ")}; a user tier needs "url")`);
-      }
-      for (const [k, v] of known) if (!ordered.has(k)) ordered.set(k, v);
-      known.clear();
-      for (const [k, v] of ordered) known.set(k, v);
-    }
-  }
-  if (env && env.trim()) {
-    source = "env";
-    for (const v of known.values()) v.enabled = false;
-    const ordered = /* @__PURE__ */ new Map();
-    for (const name of env.split(",").map((s) => s.trim()).filter(Boolean)) {
-      const v = known.get(name);
-      if (!v) {
-        problems.push(`AI4L_LIBRARY_TIERS: unknown tier "${name}"`);
-        continue;
-      }
-      ordered.set(name, { ...v, enabled: true });
-    }
-    for (const [k, v] of known) if (!ordered.has(k)) ordered.set(k, v);
-    known.clear();
-    for (const [k, v] of ordered) known.set(k, v);
-  }
-  const all = [...known.entries()].map(([name, v]) => ({ name, enabled: v.enabled, description: v.description ?? (v.kind === "url" ? "url tier" : "built-in") }));
-  return { tiers: [...known.values()].filter((v) => v.enabled).map((v) => v.tier), all, source, file, problems };
+  const available = /* @__PURE__ */ new Map();
+  const tokens = { elsevier: str("AI4L_LIBRARY_ELSEVIER_API_KEY", env) || void 0, wiley: str("AI4L_LIBRARY_WILEY_TDM_TOKEN", env) || void 0 };
+  for (const t of BUILTIN) available.set(t.name, t.make({ tokens, api_key: str("AI4L_LIBRARY_CORE_API_KEY", env) || void 0 }));
+  const proxyUrl = str("AI4L_LIBRARY_PROXY_URL", env);
+  if (proxyUrl) available.set("proxy", urlTier("proxy", proxyUrl, proxyHeaders(str("AI4L_LIBRARY_PROXY_HEADERS", env))));
+  const listed = str("AI4L_LIBRARY_TIERS", env);
+  const order2 = listed ? listed.split(",").map((s) => s.trim()).filter(Boolean) : [...available.keys()];
+  const tiers = [], seen = /* @__PURE__ */ new Set();
+  for (const name of order2) {
+    if (seen.has(name)) continue;
+    seen.add(name);
+    const t = available.get(name);
+    if (t) tiers.push(t);
+    else if (name === "proxy") problems.push('AI4L_LIBRARY_TIERS: "proxy" listed, but AI4L_LIBRARY_PROXY_URL is unset');
+    else problems.push(`AI4L_LIBRARY_TIERS: unknown tier "${name}" (built-in: ${BUILTIN.map((t2) => t2.name).join(", ")}; proxy when AI4L_LIBRARY_PROXY_URL is set)`);
+  }
+  const all = [...tiers.map((t) => ({ name: t.name, enabled: true })), ...[...available.keys()].filter((n) => !seen.has(n)).map((name) => ({ name, enabled: false }))];
+  return { tiers, all, source: sourceOf("AI4L_LIBRARY_TIERS", env), problems };
 }
 
 // src/cascade.ts
@@ -2820,34 +2809,26 @@ function parseId(raw) {
 }
 
 // src/info.ts
-import { existsSync as existsSync9, readdirSync as readdirSync3, readFileSync as readFileSync8, statSync } from "fs";
-import { dirname as dirname2, join as join8 } from "path";
+import { existsSync as existsSync7, readdirSync as readdirSync3, readFileSync as readFileSync6, statSync } from "fs";
+import { dirname as dirname2, join as join6 } from "path";
 
 // src/verify.ts
-import { existsSync as existsSync8, readFileSync as readFileSync7 } from "fs";
+import { existsSync as existsSync6, readFileSync as readFileSync5 } from "fs";
 var DEFAULT_MODEL = "pplx-decider-flash-v1.2";
 var QUESTION = "Does the paper state this, in substance? Ignore section labels and definitions of terms in parentheses. Every fact and number of the statement must be stated in the paper or follow from its numbers; a rounded number counts. If any part of the statement is absent from the paper or contradicted by it, answer false.";
-function verifyConfig(file = CONFIG_FILE) {
-  if (!existsSync8(file)) return null;
-  try {
-    const v = JSON.parse(readFileSync7(file, "utf8")).verify;
-    if (!v || typeof v.base_url !== "string") return null;
-    const base_url = resolveEnv(v.base_url).trim().replace(/\/+$/, "");
-    if (!base_url) return null;
-    const key = typeof v.api_key === "string" ? resolveEnv(v.api_key).trim() : "";
-    return {
-      base_url,
-      api_key: key || null,
-      model: typeof v.model === "string" && resolveEnv(v.model).trim() ? resolveEnv(v.model).trim() : DEFAULT_MODEL,
-      threshold: typeof v.threshold === "number" && v.threshold > 0 && v.threshold < 1 ? v.threshold : 0.5,
-      // Hosted takes 256k tokens in one request (a 50k-token paper in 2 s); the
-      // Mac app is limited to 32k and slows steeply beyond 25k, so it windows.
-      window_chars: typeof v.window_chars === "number" && v.window_chars >= 1e4 ? v.window_chars : isHosted(base_url) ? 8e5 : 9e4,
-      timeout_seconds: typeof v.timeout_seconds === "number" && v.timeout_seconds > 0 ? v.timeout_seconds : 60
-    };
-  } catch {
-    return null;
-  }
+function verifyConfig(env = process.env) {
+  const base_url = str("AI4L_LIBRARY_VERIFY_URL", env).replace(/\/+$/, "");
+  if (!base_url) return null;
+  return {
+    base_url,
+    api_key: str("AI4L_LIBRARY_VERIFY_API_KEY", env) || null,
+    model: str("AI4L_LIBRARY_VERIFY_MODEL", env) || DEFAULT_MODEL,
+    threshold: num("AI4L_LIBRARY_VERIFY_THRESHOLD", 0.5, env, (n) => n > 0 && n < 1),
+    // Hosted takes 256k tokens in one request (a 50k-token paper in 2 s); the
+    // Mac app is limited to 32k and slows steeply beyond 25k, so it windows.
+    window_chars: isHosted(base_url) ? 8e5 : 9e4,
+    timeout_seconds: num("AI4L_LIBRARY_VERIFY_TIMEOUT_SECS", 60, env, (n) => n > 0)
+  };
 }
 var isHosted = (baseUrl) => {
   try {
@@ -2933,10 +2914,10 @@ async function readPaper(raw, libraryDir = AI4L_LIBRARY_DIR) {
   if (p.error) return { id: p.requested, error: p.error };
   const paths = entryPaths(libraryDir, p.type, p.id);
   if (!entryExists(paths)) return { id: p.requested, error: "not in library" };
-  const full = existsSync8(paths.fulltextMd);
-  if (full) return { id: p.requested, basis: "full_text", text: readFileSync7(paths.fulltextMd, "utf8") };
+  const full = existsSync6(paths.fulltextMd);
+  if (full) return { id: p.requested, basis: "full_text", text: readFileSync5(paths.fulltextMd, "utf8") };
   const meta = readMeta(paths);
-  return { id: p.requested, basis: meta.has_abstract ? "abstract" : "title", text: readFileSync7(paths.md, "utf8") };
+  return { id: p.requested, basis: meta.has_abstract ? "abstract" : "title", text: readFileSync5(paths.md, "utf8") };
 }
 async function verifyClaim(claim, id, cfg, decide, read = readPaper) {
   const out = { claim, id, verdict: "error", score: null, basis: null, windows: 0, glyphs_unresolved: 0, superseded: null, model: cfg?.model ?? null };
@@ -2950,7 +2931,7 @@ async function verifyClaim(claim, id, cfg, decide, read = readPaper) {
   const paper = await read(id);
   out.id = paper.id;
   if ("error" in paper) return { ...out, error: paper.error };
-  if (!cfg || !decide) return { ...out, error: "no verify model configured (config.json: verify)" };
+  if (!cfg || !decide) return { ...out, error: "no verify model configured (AI4L_LIBRARY_VERIFY_URL)" };
   out.basis = paper.basis;
   out.glyphs_unresolved = countUnresolved(paper.text);
   if (paper.basis === "title") return { ...out, verdict: "na" };
@@ -2977,9 +2958,9 @@ async function verifyClaim(claim, id, cfg, decide, read = readPaper) {
 
 // src/info.ts
 function* metaFiles(dir) {
-  if (!existsSync9(dir)) return;
+  if (!existsSync7(dir)) return;
   for (const name of readdirSync3(dir)) {
-    const p = join8(dir, name);
+    const p = join6(dir, name);
     if (statSync(p).isDirectory()) yield* metaFiles(p);
     else if (name.endsWith("-meta.md")) yield p;
   }
@@ -3002,7 +2983,7 @@ function libraryInfo(libraryDir, host, withIds, tiers = resolveTiers()) {
     library_dir: libraryDir,
     host,
     tiers: tiers.all,
-    tiers_config: { source: tiers.source, file: tiers.file, problems: tiers.problems, retry_after_days: settings().retry_after_days, retry_blocked: settings().retry_blocked },
+    config: { ...settings(), problems: tiers.problems, sources: sources() },
     download: downloadInfo(),
     verify: verifyInfo(),
     entries: 0,
@@ -3018,11 +2999,11 @@ function libraryInfo(libraryDir, host, withIds, tiers = resolveTiers()) {
     updates: 0
   };
   const ids = [];
-  for (const type of existsSync9(libraryDir) ? readdirSync3(libraryDir) : []) {
-    const typeDir = join8(libraryDir, type);
+  for (const type of existsSync7(libraryDir) ? readdirSync3(libraryDir) : []) {
+    const typeDir = join6(libraryDir, type);
     if (!statSync(typeDir).isDirectory()) continue;
     for (const meta of metaFiles(typeDir)) {
-      const md = readFileSync8(meta, "utf8");
+      const md = readFileSync6(meta, "utf8");
       const raw = field(md, "level") || "unknown";
       const level = raw === "abstract" && field(md, "has_abstract") === "no" ? "title" : raw;
       info.entries++;
@@ -3034,7 +3015,7 @@ function libraryInfo(libraryDir, host, withIds, tiers = resolveTiers()) {
       const dir = dirname2(meta);
       for (const f of readdirSync3(dir)) {
         try {
-          const st = statSync(join8(dir, f));
+          const st = statSync(join6(dir, f));
           if (st.isFile()) info.size_bytes += st.size;
         } catch {
         }
@@ -3063,7 +3044,7 @@ function noticeTypes(md, metaPath) {
     return out;
   }
   try {
-    const xml = readFileSync8(metaPath.replace(/-meta\.md$/, "-abstract.xml"), "utf8");
+    const xml = readFileSync6(metaPath.replace(/-meta\.md$/, "-abstract.xml"), "utf8");
     for (const m of xml.matchAll(/<CommentsCorrections RefType="([A-Za-z]+)"/g)) if (XML_TYPES[m[1]]) out.add(XML_TYPES[m[1]]);
   } catch {
   }
@@ -3165,9 +3146,9 @@ var escape = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 // src/log.ts
 import { appendFileSync, mkdirSync as mkdirSync3, renameSync as renameSync2, statSync as statSync2 } from "fs";
 import { hostname } from "os";
-import { join as join9 } from "path";
+import { join as join7 } from "path";
 var HOST = hostname();
-var LOG_FILE = join9(AI4L_LIBRARY_DIR, "library.log");
+var LOG_FILE = join7(AI4L_LIBRARY_DIR, "library.log");
 function stamp() {
   const d = /* @__PURE__ */ new Date();
   const p = (n) => String(n).padStart(2, "0");
@@ -3355,7 +3336,7 @@ function parseCsl(json2) {
 // src/tools.ts
 var pkg = (() => {
   try {
-    return JSON.parse(readFileSync9(new URL("../package.json", import.meta.url), "utf8"));
+    return JSON.parse(readFileSync7(new URL("../package.json", import.meta.url), "utf8"));
   } catch {
     return { name: "ai4l-library", version: "0.0.0" };
   }
@@ -3367,7 +3348,7 @@ Tools:
 - library_status(id) \u2014 read-only: the entry's status, or level "missing".
 - library_read(id, section?, query?, max_chars?, max_hits?) \u2014 one small piece of a stored paper's Markdown, never the whole paper. No section/query: the outline (headings with word counts, and whether it is the full text or the abstract only). section: a heading from the outline (case-insensitive substring) \u2192 that section's text, capped at max_chars. query: search terms \u2192 the paragraphs containing all of them, each with its section, best first, at most max_hits; with no hit the answer lists the headings instead. Every full text converted from PMC/JATS XML has a "Declarations" section \u2014 funding, conflicts of interest, author notes \u2014 so section "Declarations" answers who paid and who declares what in one call; an empty answer there means the paper states nothing. Reads are read-only and may run in parallel.
 - library_verify(claim, id) \u2014 is one finding of a review stated by one source it cites? claim: the finding alone as a complete statement (subject, intervention, outcome, number), without its citations and without the review's framing or inference; id: one source the review cites for it \u2014 a paper, a drug label (dailymed:\u2026) or a trial record (nct:\u2026), each judged on its stored full text the same way. A finding cited to three papers is three calls with the same claim; a claim that names a source, joins two findings or is a fragment is refused. The server reads the paper (full text, else abstract) and asks a decision model; nothing of the paper enters your context. Result: verdict "pass" (score is the probability), "fail" (the full text does not state it), "na" (only the abstract is in the library and does not state it, or only the title) or "error" (claim empty, too short, a fragment, naming a source or compound; paper not in the library; no model; model failure); basis full_text, abstract or title; glyphs_unresolved, the symbols the paper's PDF font gave no character for (above 0: a fail may be the font, not the paper); superseded, true when the claim uses a figure a stored correction replaced (the verdict is kept), null without a stored correction. Call library_add on the paper first.
-- library_info(ids?) \u2014 library-wide, everything the TUI shows: the library directory, the decision model and whether it answers, entries and size on disk, per type (pmid, doi, dailymed, nct) the entries with their levels (full_text, abstract, title) and retractions; entry counts by type and level, counts of retracted and not-citable entries and of entries with errata, expressions of concern and updates, the configured tiers (enabled/disabled, in order), the verify model with its endpoint and whether it answers right now (ok, ms, error); ids=true lists every entry ID.
+- library_info(ids?) \u2014 library-wide, everything the TUI shows: the library directory, the decision model and whether it answers, entries and size on disk, per type (pmid, doi, dailymed, nct) the entries with their levels (full_text, abstract, title) and retractions; entry counts by type and level, counts of retracted and not-citable entries and of entries with errata, expressions of concern and updates, the retrieval tiers in run order (and which are off), the configuration (config: retry and refresh settings, problems with AI4L_LIBRARY_TIERS, and per variable whether its value came from the environment, .env or the default \u2014 never the value), the verify model with its endpoint and whether it answers right now (ok, ms, error); ids=true lists every entry ID.
 - get_version() \u2014 package name, version and the resolved library directory.
 
 Every action is appended to <library>/library.log, one line per action, prefixed with the host the server runs on.
@@ -3674,8 +3655,8 @@ function registerTools(server2) {
         log("library_read", parsed.requested, "error missing");
         return out({ requested: parsed.requested, entry: paths.entry, error: "missing \u2014 call library_add first" });
       }
-      const full = existsSync10(paths.fulltextMd);
-      const md = readFileSync9(full ? paths.fulltextMd : paths.md, "utf8");
+      const full = existsSync8(paths.fulltextMd);
+      const md = readFileSync7(full ? paths.fulltextMd : paths.md, "utf8");
       const text3 = full ? "full_text" : "abstract";
       const base = { requested: parsed.requested, entry: paths.entry, text: text3 };
       if (section2) {
@@ -3713,7 +3694,7 @@ function registerTools(server2) {
   );
   server2.tool(
     "library_info",
-    "Library-wide summary \u2014 everything the TUI shows: the library directory and host; the decision model with its endpoint and whether it answers; the entry count and the size on disk (size, size_bytes); per entry type (types) the entries and their levels (full_text, abstract, title) and retractions; entry counts by type and level, counts of retracted and not-citable entries and of entries with errata, expressions of concern and updates, the configured retrieval tiers (enabled/disabled, in order, and where that configuration came from), the decision model behind library_verify (model, endpoint, whether it runs on this machine, and whether it answers right now: ok with the answer time, or the error), the library directory and host. ids=true also lists every entry ID.",
+    "Library-wide summary \u2014 everything the TUI shows: the library directory and host; the decision model with its endpoint and whether it answers; the entry count and the size on disk (size, size_bytes); per entry type (types) the entries and their levels (full_text, abstract, title) and retractions; entry counts by type and level, counts of retracted and not-citable entries and of entries with errata, expressions of concern and updates, the retrieval tiers in run order and which are off (tiers), the configuration (config: settings, problems, and per variable the source of its value \u2014 environment, .env or default \u2014 never the value), the decision model behind library_verify (model, endpoint, whether it runs on this machine, and whether it answers right now: ok with the answer time, or the error), the library directory and host. ids=true also lists every entry ID.",
     { ids: z.boolean().optional().describe("Also list every entry ID (type:value).") },
     async ({ ids }) => {
       const info = libraryInfo(AI4L_LIBRARY_DIR, HOST, ids === true);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai4l-library-dev",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Internal development build of ai4l-library. Not for public use.",
   "type": "module",
   "bin": {