@wentorai/research-plugins 1.3.1 → 1.4.0

package/skills/tools/scraping/web-scraping-ethics-guide/SKILL.md

@@ -3,7 +3,7 @@ name: web-scraping-ethics-guide
 description: "Scrape web data ethically and legally for research purposes"
 metadata:
   openclaw:
-    emoji: "globe_with_meridians"
+    emoji: "🌐"
     category: "tools"
     subcategory: "scraping"
     keywords: ["web scraping", "ethical scraping", "robots.txt", "rate limiting", "research data collection", "crawling"]

package/skills/writing/citation/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: citation-skills
-description: "22 citation management skills (academic-citation-manager, bibtex-management, citation-assistant-skill, citation-style...). Trigger: managing references, formatting citations, BibTeX, bibliographies. Design: reference manager integrations and citation style guides (APA, IEEE, etc.)."
+description: "22 citation management skills. Trigger: managing references, formatting citations, BibTeX, bibliographies. Design: reference manager integrations and citation style guides (APA, IEEE, etc.)."
 ---
 
 # Citation Management — 22 Skills

package/skills/writing/citation/academic-citation-manager/SKILL.md

@@ -3,11 +3,11 @@ name: academic-citation-manager
 description: "Manage academic citations across BibTeX, APA, MLA, and Chicago formats"
 metadata:
   openclaw:
-    emoji: "bookmark"
+    emoji: "🔖"
     category: "writing"
     subcategory: "citation"
     keywords: ["citation", "BibTeX", "APA", "reference management", "bibliography", "formatting"]
-    source: "https://github.com/wentor-ai/research-plugins"
+    source: "wentor-research-plugins"
 ---
 
 # Academic Citation Manager

package/skills/writing/citation/bibtex-management-guide/SKILL.md

@@ -3,7 +3,7 @@ name: bibtex-management-guide
 description: "Clean, format, deduplicate, and manage BibTeX bibliography files for LaTeX"
 metadata:
   openclaw:
-    emoji: "card_file_box"
+    emoji: "🗃️"
     category: "writing"
     subcategory: "citation"
     keywords: ["BibTeX formatting", "BibTeX conversion", "bibliography cleanup", "reference deduplication", "citation management"]

package/skills/writing/citation/citation-style-guide/SKILL.md

@@ -3,7 +3,7 @@ name: citation-style-guide
 description: "APA, MLA, Chicago citation format guide with CSL configuration"
 metadata:
   openclaw:
-    emoji: "book"
+    emoji: "📖"
     category: "writing"
     subcategory: "citation"
     keywords: ["citation formatting", "CSL", "citation style", "reference management"]

package/skills/writing/citation/mendeley-api/SKILL.md

@@ -7,7 +7,7 @@ metadata:
     category: "writing"
     subcategory: "citation"
     keywords: ["mendeley", "reference manager", "bibliography", "catalog search", "research library", "citations"]
-    source: "https://dev.elsevier.com/mendeley.html"
+    source: "wentor-research-plugins"
 ---
 
 # Mendeley REST API
@@ -226,6 +226,6 @@ def get_popular_papers(topic: str, limit: int = 10) -> list:
 
 ## References
 
-- [Mendeley API Documentation](https://dev.elsevier.com/mendeley.html)
+- [Mendeley API Documentation](wentor-research-plugins)
 - [Mendeley Developer Portal](https://dev.elsevier.com/)
 - [Mendeley API Reference](https://api.mendeley.com/apidocs/)

package/skills/writing/citation/obsidian-citation-guide/SKILL.md

@@ -8,6 +8,7 @@ metadata:
   openclaw:
     category: "writing"
     subcategory: "citation"
+    emoji: "📚"
     keywords:
       - obsidian
       - citations

package/skills/writing/citation/obsidian-zotero-guide/SKILL.md

@@ -8,6 +8,7 @@ metadata:
   openclaw:
     category: "writing"
     subcategory: "citation"
+    emoji: "🔗"
     keywords:
       - obsidian
       - zotero

package/skills/writing/citation/papersgpt-zotero-guide/SKILL.md

@@ -8,6 +8,7 @@ metadata:
   openclaw:
     category: "writing"
     subcategory: "citation"
+    emoji: "📑"
     keywords:
       - zotero
       - ai-assistant

package/skills/writing/citation/reference-manager-comparison/SKILL.md

@@ -3,7 +3,7 @@ name: reference-manager-comparison
 description: "Compare Zotero, Mendeley, EndNote, and Paperpile for research use"
 metadata:
   openclaw:
-    emoji: "card_index_dividers"
+    emoji: "🗂️"
     category: "writing"
     subcategory: "citation"
     keywords: ["reference manager", "Zotero", "Mendeley", "EndNote", "Paperpile", "citation management"]

package/skills/writing/citation/zotero-mdnotes-guide/SKILL.md

@@ -8,6 +8,7 @@ metadata:
   openclaw:
     category: "writing"
     subcategory: "citation"
+    emoji: "📝"
     keywords:
       - zotero
       - markdown

package/skills/writing/citation/zotero-reference-guide/SKILL.md

@@ -8,6 +8,7 @@ metadata:
   openclaw:
     category: "writing"
     subcategory: "citation"
+    emoji: "📖"
     keywords:
       - zotero
       - references

package/skills/writing/composition/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: composition-skills
-description: "11 academic writing skills (abstract-writing, discussion-writing, introduction-writing, literature-review-writing...). Trigger: writing paper sections, structuring arguments, academic prose. Design: section-by-section guides (abstract, intro, methods, discussion) with templates."
+description: "11 academic writing skills. Trigger: writing paper sections, structuring arguments, academic prose. Design: section-by-section guides (abstract, intro, methods, discussion) with templates."
 ---
 
 # Academic Writing — 11 Skills

package/skills/writing/composition/abstract-writing-guide/SKILL.md

@@ -3,7 +3,7 @@ name: abstract-writing-guide
 description: "Craft structured research abstracts that maximize clarity and journal acceptance"
 metadata:
   openclaw:
-    emoji: "memo"
+    emoji: "📝"
     category: "writing"
     subcategory: "composition"
     keywords: ["abstract writing", "summary writing", "research abstract", "paper title writing", "structured abstract"]

package/skills/writing/composition/discussion-writing-guide/SKILL.md

@@ -3,7 +3,7 @@ name: discussion-writing-guide
 description: "Write effective discussion sections that interpret results and impact"
 metadata:
   openclaw:
-    emoji: "thought_balloon"
+    emoji: "💭"
     category: "writing"
     subcategory: "composition"
     keywords: ["discussion section", "academic writing", "results interpretation", "paper structure", "research implications"]

package/skills/writing/composition/introduction-writing-guide/SKILL.md

@@ -3,7 +3,7 @@ name: introduction-writing-guide
 description: "Guide to writing effective research paper introductions"
 metadata:
   openclaw:
-    emoji: "pen"
+    emoji: "🖊️"
     category: "writing"
     subcategory: "composition"
     keywords: ["introduction writing", "research background", "literature gap"]

package/skills/writing/composition/literature-review-writing/SKILL.md

@@ -3,7 +3,7 @@ name: literature-review-writing
 description: "Structure and write comprehensive literature reviews for any field"
 metadata:
   openclaw:
-    emoji: "scroll"
+    emoji: "📜"
     category: "writing"
     subcategory: "composition"
     keywords: ["literature review", "systematic review", "narrative review", "synthesis", "academic writing", "review paper"]

package/skills/writing/composition/methods-section-guide/SKILL.md

@@ -3,7 +3,7 @@ name: methods-section-guide
 description: "Guide to writing clear and reproducible methodology sections"
 metadata:
   openclaw:
-    emoji: "gear"
+    emoji: "⚙️"
     category: "writing"
     subcategory: "composition"
     keywords: ["methods writing", "methodology section", "reproducible methods"]

package/skills/writing/composition/response-to-reviewers/SKILL.md

@@ -3,7 +3,7 @@ name: response-to-reviewers
 description: "Write effective point-by-point responses to peer reviewer comments for revisions"
 metadata:
   openclaw:
-    emoji: "envelope"
+    emoji: "✉️"
     category: "writing"
     subcategory: "composition"
     keywords: ["response to reviewers", "revision letter", "point-by-point response", "cover letter writing", "manuscript revision"]

package/skills/writing/composition/scientific-writing-resources/SKILL.md

@@ -8,6 +8,7 @@ metadata:
   openclaw:
     category: "writing"
     subcategory: "composition"
+    emoji: "✍️"
     keywords:
       - scientific-writing
       - writing-tools

package/skills/writing/latex/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: latex-skills
-description: "11 latex skills (academic-writing-latex, bibliography-management, latex-drawing-collection, latex-drawing...). Trigger: LaTeX typesetting, formatting papers, mathematical notation, Beamer. Design: template-based guides with package recommendations and compilation tips."
+description: "11 latex skills. Trigger: LaTeX typesetting, formatting papers, mathematical notation, Beamer. Design: template-based guides with package recommendations and compilation tips."
 ---
 
 # LaTeX — 11 Skills

package/skills/writing/latex/bibliography-management-guide/SKILL.md

@@ -3,7 +3,7 @@ name: bibliography-management-guide
 description: "Manage references with BibLaTeX, natbib, and LaTeX bibliography styles"
 metadata:
   openclaw:
-    emoji: "bookmark_tabs"
+    emoji: "📑"
     category: "writing"
     subcategory: "latex"
     keywords: ["BibLaTeX", "natbib", "bibliography", "BibTeX", "citation styles", "reference management"]

package/skills/writing/latex/latex-drawing-collection/SKILL.md

@@ -8,6 +8,7 @@ metadata:
   openclaw:
     category: "writing"
     subcategory: "latex"
+    emoji: "🎨"
     keywords:
       - latex-drawing
       - tikz

package/skills/writing/latex/latex-templates-collection/SKILL.md

@@ -8,6 +8,7 @@ metadata:
   openclaw:
     category: "writing"
     subcategory: "latex"
+    emoji: "📋"
     keywords:
       - latex-templates
       - paper-templates

package/skills/writing/latex/math-typesetting-guide/SKILL.md

@@ -3,7 +3,7 @@ name: math-typesetting-guide
 description: "LaTeX math typesetting, equation formatting, and cross-referencing"
 metadata:
   openclaw:
-    emoji: "sigma"
+    emoji: "∑"
     category: "writing"
     subcategory: "latex"
     keywords: ["LaTeX math typesetting", "equation formatting", "mathematical notation", "cross-reference"]

package/skills/writing/latex/overleaf-collaboration-guide/SKILL.md

@@ -3,7 +3,7 @@ name: overleaf-collaboration-guide
 description: "Guide to collaborative LaTeX editing with Overleaf"
 metadata:
   openclaw:
-    emoji: "team"
+    emoji: "👥"
     category: "writing"
     subcategory: "latex"
     keywords: ["online LaTeX editor", "collaborative LaTeX", "Overleaf", "LaTeX environment setup"]

package/skills/writing/latex/tex-render-guide/SKILL.md

@@ -7,7 +7,7 @@ metadata:
     category: "writing"
     subcategory: "latex"
     keywords: ["LaTeX rendering", "math images", "equation rendering", "SVG math", "KaTeX", "MathJax"]
-    source: "https://github.com/nicolewhite/latex2image"
+    source: "wentor-research-plugins"
 ---
 
 # TeX Render Guide
@@ -239,5 +239,5 @@ $\displaystyle \textcolor{blue}{\nabla} \times \textcolor{red}{\mathbf{E}} = -\f
 - MathJax: https://www.mathjax.org
 - dvipng documentation: https://ctan.org/pkg/dvipng
 - dvisvgm: https://dvisvgm.de
-- latex2image: https://github.com/nicolewhite/latex2image
+- latex2image: wentor-research-plugins
 - CodeCogs equation editor: https://latex.codecogs.com

package/skills/writing/latex/tikz-diagrams-guide/SKILL.md

@@ -3,7 +3,7 @@ name: tikz-diagrams-guide
 description: "Create publication-quality scientific diagrams with TikZ in LaTeX"
 metadata:
   openclaw:
-    emoji: "triangular_ruler"
+    emoji: "📐"
     category: "writing"
     subcategory: "latex"
     keywords: ["TikZ", "LaTeX diagrams", "scientific figures", "flowcharts", "PGFplots", "vector graphics"]

package/skills/writing/polish/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: polish-skills
-description: "9 editing & proofreading skills (academic-tone, academic-translation, academic-writing-refiner, ai-writing-humanizer...). Trigger: polishing drafts, academic tone, proofreading, translation. Design: style checkers and editing workflows for clear, concise academic English."
+description: "9 editing & proofreading skills. Trigger: polishing drafts, academic tone, proofreading, translation. Design: style checkers and editing workflows for clear, concise academic English."
 ---
 
 # Editing & Proofreading — 9 Skills

package/skills/writing/polish/academic-tone-guide/SKILL.md

@@ -3,7 +3,7 @@ name: academic-tone-guide
 description: "Adjust writing tone and register for academic audiences and venues"
 metadata:
   openclaw:
-    emoji: "mortar_board"
+    emoji: "🎓"
     category: "writing"
     subcategory: "polish"
     keywords: ["academic tone", "register", "formal writing", "scholarly voice", "hedging", "disciplinary conventions"]

package/skills/writing/polish/academic-translation-guide/SKILL.md

@@ -3,7 +3,7 @@ name: academic-translation-guide
 description: "Academic translation, post-editing, and Chinglish correction guide"
 metadata:
   openclaw:
-    emoji: "globe"
+    emoji: "🌐"
     category: "writing"
     subcategory: "polish"
     keywords: ["academic translation", "machine translation", "post-editing", "Chinglish correction"]

package/skills/writing/polish/ai-writing-humanizer/SKILL.md

@@ -3,7 +3,7 @@ name: ai-writing-humanizer
 description: "Remove AI-generated patterns to produce natural, authentic academic writing"
 metadata:
   openclaw:
-    emoji: "pencil2"
+    emoji: "✏️"
     category: "writing"
     subcategory: "polish"
     keywords: ["humanize", "AI pattern removal", "natural writing", "AI-assisted writing", "writing style"]

package/skills/writing/polish/conciseness-editing-guide/SKILL.md

@@ -3,7 +3,7 @@ name: conciseness-editing-guide
 description: "Eliminate wordiness and redundancy in academic prose for clarity"
 metadata:
   openclaw:
-    emoji: "scissors"
+    emoji: "✂️"
     category: "writing"
     subcategory: "polish"
     keywords: ["conciseness", "wordiness", "academic editing", "prose clarity", "redundancy", "word count reduction"]

package/skills/writing/polish/grammar-checker-guide/SKILL.md

@@ -3,7 +3,7 @@ name: grammar-checker-guide
 description: "Use grammar and style checking tools to polish academic manuscripts"
 metadata:
   openclaw:
-    emoji: "pencil2"
+    emoji: "✏️"
     category: "writing"
     subcategory: "polish"
     keywords: ["grammar checker", "academic style", "proofreading", "writing tools", "language editing"]

package/skills/writing/polish/paper-polish-guide/SKILL.md

@@ -7,7 +7,7 @@ metadata:
     category: "writing"
     subcategory: "polish"
     keywords: ["paper polishing", "academic editing", "LaTeX review", "writing quality", "style guide", "proofreading"]
-    source: "https://github.com/yzhao062/writing-style"
+    source: "wentor-research-plugins"
 ---
 
 # Paper Polish Guide
@@ -154,7 +154,7 @@ Before declaring the paper polished:
 
 ## References
 
-- Writing Style Guide: https://github.com/yzhao062/writing-style
+- Writing Style Guide: wentor-research-plugins
 - Strunk, W. & White, E.B. "The Elements of Style"
 - Zobel, J. "Writing for Computer Science" (Springer)
 - Chktex LaTeX linter: https://www.nongnu.org/chktex/

package/skills/writing/polish/plagiarism-detection-guide/SKILL.md

@@ -3,7 +3,7 @@ name: plagiarism-detection-guide
 description: "Use plagiarism detection tools and ensure manuscript originality"
 metadata:
   openclaw:
-    emoji: "shield"
+    emoji: "🛡️"
     category: "writing"
     subcategory: "polish"
     keywords: ["plagiarism detection", "originality check", "Turnitin", "iThenticate", "self-plagiarism", "text similarity"]

package/skills/writing/templates/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: templates-skills
-description: "11 paper templates skills (arxiv-preprint-template, beamer-presentation, conference-paper-template, elegant-paper-template...). Trigger: starting a new paper, formatting for submission, venue-specific layouts. Design: ready-to-use templates for arXiv preprint, conferences, thesis, and posters."
+description: "11 paper templates skills. Trigger: starting a new paper, formatting for submission, venue-specific layouts. Design: ready-to-use templates for arXiv preprint, conferences, thesis, and posters."
 ---
 
 # Paper Templates — 11 Skills

package/skills/writing/templates/beamer-presentation-guide/SKILL.md

@@ -3,7 +3,7 @@ name: beamer-presentation-guide
 description: "Guide to creating academic presentations with LaTeX Beamer"
 metadata:
   openclaw:
-    emoji: "slides"
+    emoji: "📊"
     category: "writing"
     subcategory: "templates"
     keywords: ["Beamer presentation", "LaTeX slides", "conference paper template"]

package/skills/writing/templates/conference-paper-template/SKILL.md

@@ -3,7 +3,7 @@ name: conference-paper-template
 description: "Templates and formatting guides for major academic conference submissions"
 metadata:
   openclaw:
-    emoji: "page_facing_up"
+    emoji: "📄"
     category: "writing"
     subcategory: "templates"
     keywords: ["conference paper template", "proceedings format", "camera-ready", "journal formatting requirements", "LaTeX template"]

package/skills/writing/templates/novathesis-guide/SKILL.md

@@ -8,6 +8,7 @@ metadata:
   openclaw:
     category: "writing"
     subcategory: "templates"
+    emoji: "🎓"
     keywords:
       - thesis-template
       - latex-thesis

package/skills/writing/templates/thesis-template-guide/SKILL.md

@@ -3,7 +3,7 @@ name: thesis-template-guide
 description: "Set up LaTeX templates for PhD and Master's thesis documents"
 metadata:
   openclaw:
-    emoji: "mortar_board"
+    emoji: "🎓"
     category: "writing"
     subcategory: "templates"
     keywords: ["thesis template", "dissertation", "LaTeX thesis", "PhD writing", "graduate thesis", "document class"]

package/src/tools/arxiv.ts

@@ -1,43 +1,65 @@
 import { Type } from "@sinclair/typebox";
 import type { OpenClawPluginApi, OpenClawPluginToolContext } from "openclaw/plugin-sdk";
-import { toolResult } from "./util.js";
+import { toolResult, trackedFetch, isTrackedError } from "./util.js";
 
 const BASE = "https://export.arxiv.org/api/query";
 
-function parseArxivXml(xml: string) {
+/**
+ * Parse arXiv Atom XML response into structured paper objects.
+ *
+ * Uses regex-based extraction (arXiv returns Atom 1.0 XML).
+ * Handles edge cases: namespace prefixes, missing fields, HTML error pages.
+ */
+function parseArxivXml(xml: string): Record<string, unknown>[] {
+  // Guard: if arXiv returned an error page (HTML) or empty response
+  if (!xml || !xml.includes("<entry>")) return [];
+
   const entries: Record<string, unknown>[] = [];
-  const entryBlocks = xml.split("<entry>").slice(1);
 
-  for (const block of entryBlocks) {
-    const getText = (tag: string) => {
+  // Use regex to extract <entry>...</entry> blocks robustly
+  const entryRegex = /<entry>([\s\S]*?)<\/entry>/g;
+  let entryMatch: RegExpExecArray | null;
+
+  while ((entryMatch = entryRegex.exec(xml)) !== null) {
+    const block = entryMatch[1];
+
+    const getText = (tag: string): string => {
+      // Match tags with or without namespace prefixes and attributes
       const m = block.match(new RegExp(`<${tag}[^>]*>([\\s\\S]*?)</${tag}>`));
       return m ? m[1].trim() : "";
     };
 
-    const getAll = (tag: string) => {
+    const getAll = (tag: string): string[] => {
       const results: string[] = [];
       const re = new RegExp(`<${tag}[^>]*>([\\s\\S]*?)</${tag}>`, "g");
-      let m;
+      let m: RegExpExecArray | null;
       while ((m = re.exec(block)) !== null) results.push(m[1].trim());
       return results;
     };
 
-    const getAttr = (tag: string, attr: string) => {
-      const m = block.match(new RegExp(`<${tag}[^>]*${attr}="([^"]*)"[^>]*/?>`, "g"));
-      return m
-        ? m.map((s) => {
-            const am = s.match(new RegExp(`${attr}="([^"]*)"`));
-            return am ? am[1] : "";
-          })
-        : [];
+    const getAttr = (tag: string, attr: string): string[] => {
+      const results: string[] = [];
+      const re = new RegExp(`<${tag}[^>]*?${attr}="([^"]*)"[^>]*/?>`, "g");
+      let m: RegExpExecArray | null;
+      while ((m = re.exec(block)) !== null) {
+        if (m[1]) results.push(m[1]);
+      }
+      return results;
     };
 
-    const id = getText("id");
-    const arxivId = id.replace("http://arxiv.org/abs/", "").replace(/v\d+$/, "");
+    const rawId = getText("id");
+    if (!rawId) continue; // skip malformed entries
+
+    const arxivId = rawId
+      .replace(/https?:\/\/arxiv\.org\/abs\//, "")
+      .replace(/v\d+$/, "");
+
+    const title = getText("title").replace(/\s+/g, " ");
+    if (!title) continue; // skip entries without title
 
     entries.push({
       arxiv_id: arxivId,
-      title: getText("title").replace(/\s+/g, " "),
+      title,
       summary: getText("summary").replace(/\s+/g, " "),
       authors: getAll("name"),
       published: getText("published"),
@@ -45,8 +67,8 @@ function parseArxivXml(xml: string) {
       categories: getAttr("category", "term"),
       pdf_url: `https://arxiv.org/pdf/${arxivId}`,
       abs_url: `https://arxiv.org/abs/${arxivId}`,
-      doi: getText("arxiv:doi"),
-      comment: getText("arxiv:comment"),
+      doi: getText("arxiv:doi") || undefined,
+      comment: getText("arxiv:comment") || undefined,
     });
   }
 
@@ -62,7 +84,7 @@ export function createArxivTools(
       name: "search_arxiv",
       label: "Search Papers (arXiv)",
       description:
-        "Search arXiv preprint repository. Covers physics, math, CS, biology, quantitative finance, statistics, and more.",
+        "Search arXiv preprint repository. Covers physics, math, CS, biology, quantitative finance, statistics, and more. All results are open access.",
       parameters: Type.Object({
         query: Type.String({
           description:
@@ -94,9 +116,17 @@ export function createArxivTools(
           sortOrder: input.sort_order ?? "descending",
         });
 
-        const res = await fetch(`${BASE}?${params}`);
-        if (!res.ok) return toolResult({ error: `API error: ${res.status} ${res.statusText}` });
-        const xml = await res.text();
+        const tracked = await trackedFetch("arxiv", `${BASE}?${params}`, undefined, 15_000);
+        if (isTrackedError(tracked)) return tracked;
+        const xml = await tracked.res.text();
+
+        // Check if response is actually XML (not HTML error page)
+        if (!xml.includes("<feed")) {
+          return toolResult({
+            error: "arXiv returned non-XML response (possibly rate-limited or error page)",
+            _source_health: { source: "arxiv", latency_ms: tracked.latency_ms },
+          });
+        }
 
         const totalMatch = xml.match(
           /<opensearch:totalResults[^>]*>(\d+)<\/opensearch:totalResults>/,
@@ -106,6 +136,7 @@ export function createArxivTools(
         return toolResult({
           total_results: total,
           papers: parseArxivXml(xml),
+          _source_health: { source: "arxiv", latency_ms: tracked.latency_ms },
         });
       },
     },
@@ -120,14 +151,31 @@ export function createArxivTools(
         }),
       }),
       execute: async (input: { arxiv_id: string }) => {
-        const id = input.arxiv_id.replace("arXiv:", "");
+        const id = input.arxiv_id.replace("arXiv:", "").replace(/https?:\/\/arxiv\.org\/abs\//, "");
         const params = new URLSearchParams({ id_list: id });
-        const res = await fetch(`${BASE}?${params}`);
-        if (!res.ok) return toolResult({ error: `API error: ${res.status} ${res.statusText}` });
-        const xml = await res.text();
+
+        const tracked = await trackedFetch("arxiv", `${BASE}?${params}`, undefined, 15_000);
+        if (isTrackedError(tracked)) return tracked;
+        const xml = await tracked.res.text();
+
+        if (!xml.includes("<feed")) {
+          return toolResult({
+            error: "arXiv returned non-XML response",
+            _source_health: { source: "arxiv", latency_ms: tracked.latency_ms },
+          });
+        }
+
         const papers = parseArxivXml(xml);
-        if (papers.length === 0) return toolResult({ error: "Paper not found" });
-        return toolResult(papers[0]);
+        if (papers.length === 0) {
+          return toolResult({
+            error: `Paper not found: ${id}`,
+            _source_health: { source: "arxiv", latency_ms: tracked.latency_ms },
+          });
+        }
+        return toolResult({
+          ...papers[0],
+          _source_health: { source: "arxiv", latency_ms: tracked.latency_ms },
+        });
       },
     },
   ];