@wentorai/research-plugins 1.2.0 → 1.2.2

package/openclaw.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "research-plugins",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "name": "Research Plugins",
   "description": "487 academic research skills, 13 agent tools, 150 MCP configs & 6 curated lists for Research-Claw",
   "skills": ["./skills"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wentorai/research-plugins",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "type": "module",
   "description": "487 academic research skills, 150 MCP configs, 13 agent tools, and 6 curated lists for Research-Claw and AI agents",
   "keywords": [

package/src/tools/arxiv.ts

@@ -1,5 +1,6 @@
 import { Type } from "@sinclair/typebox";
 import type { OpenClawPluginApi, OpenClawPluginToolContext } from "openclaw/plugin-sdk";
+import { toolResult } from "./util.js";
 
 const BASE = "https://export.arxiv.org/api/query";
 
@@ -59,9 +60,10 @@ export function createArxivTools(
   return [
     {
       name: "search_arxiv",
+      label: "Search Papers (arXiv)",
       description:
         "Search arXiv preprint repository. Covers physics, math, CS, biology, quantitative finance, statistics, and more.",
-      inputSchema: Type.Object({
+      parameters: Type.Object({
         query: Type.String({
           description:
             "Search query. Supports field prefixes: ti: (title), au: (author), abs: (abstract), cat: (category). E.g. 'ti:transformer AND cat:cs.CL'",
@@ -79,7 +81,7 @@ export function createArxivTools(
           Type.String({ description: "Sort order: 'ascending' or 'descending'" }),
         ),
       }),
-      handler: async (input: {
+      execute: async (input: {
         query: string;
         max_results?: number;
         sort_by?: string;
@@ -93,7 +95,7 @@ export function createArxivTools(
         });
 
         const res = await fetch(`${BASE}?${params}`);
-        if (!res.ok) return { error: `API error: ${res.status} ${res.statusText}` };
+        if (!res.ok) return toolResult({ error: `API error: ${res.status} ${res.statusText}` });
         const xml = await res.text();
 
         const totalMatch = xml.match(
@@ -101,30 +103,31 @@ export function createArxivTools(
         );
         const total = totalMatch ? parseInt(totalMatch[1], 10) : 0;
 
-        return {
+        return toolResult({
           total_results: total,
           papers: parseArxivXml(xml),
-        };
+        });
       },
     },
     {
       name: "get_arxiv_paper",
+      label: "Get Paper Details (arXiv)",
       description:
         "Get detailed information about a specific arXiv paper by its ID.",
-      inputSchema: Type.Object({
+      parameters: Type.Object({
         arxiv_id: Type.String({
           description: "arXiv paper ID, e.g. '2301.00001' or '2301.00001v2'",
         }),
       }),
-      handler: async (input: { arxiv_id: string }) => {
+      execute: async (input: { arxiv_id: string }) => {
         const id = input.arxiv_id.replace("arXiv:", "");
         const params = new URLSearchParams({ id_list: id });
         const res = await fetch(`${BASE}?${params}`);
-        if (!res.ok) return { error: `API error: ${res.status} ${res.statusText}` };
+        if (!res.ok) return toolResult({ error: `API error: ${res.status} ${res.statusText}` });
         const xml = await res.text();
         const papers = parseArxivXml(xml);
-        if (papers.length === 0) return { error: "Paper not found" };
-        return papers[0];
+        if (papers.length === 0) return toolResult({ error: "Paper not found" });
+        return toolResult(papers[0]);
       },
     },
   ];

package/src/tools/crossref.ts

@@ -1,5 +1,6 @@
 import { Type } from "@sinclair/typebox";
 import type { OpenClawPluginApi, OpenClawPluginToolContext } from "openclaw/plugin-sdk";
+import { toolResult } from "./util.js";
 
 const BASE = "https://api.crossref.org";
 
@@ -14,22 +15,23 @@ export function createCrossRefTools(
   return [
     {
       name: "resolve_doi",
+      label: "Resolve DOI (CrossRef)",
       description:
         "Resolve a DOI to get full bibliographic metadata from CrossRef (title, authors, journal, dates, references).",
-      inputSchema: Type.Object({
+      parameters: Type.Object({
         doi: Type.String({
           description: "DOI to resolve, e.g. '10.1038/nature12373'",
         }),
       }),
-      handler: async (input: { doi: string }) => {
+      execute: async (input: { doi: string }) => {
         const doi = input.doi.replace(/^https?:\/\/doi\.org\//, "");
         const res = await fetch(`${BASE}/works/${encodeURIComponent(doi)}`, {
           headers,
         });
-        if (!res.ok) return { error: `API error: ${res.status} ${res.statusText}` };
+        if (!res.ok) return toolResult({ error: `API error: ${res.status} ${res.statusText}` });
         const data = await res.json();
         const w = data.message;
-        return {
+        return toolResult({
           doi: w.DOI,
           title: w.title?.[0],
           authors: w.author?.map(
@@ -44,14 +46,15 @@ export function createCrossRefTools(
           url: w.URL,
           abstract: w.abstract,
           license: w.license?.[0]?.URL,
-        };
+        });
       },
     },
     {
       name: "search_crossref",
+      label: "Search Works (CrossRef)",
       description:
         "Search CrossRef for scholarly works by query. Covers 150M+ DOIs across all publishers.",
-      inputSchema: Type.Object({
+      parameters: Type.Object({
         query: Type.String({ description: "Search query" }),
         limit: Type.Optional(
           Type.Number({ description: "Max results (default 10, max 100)" }),
@@ -71,7 +74,7 @@ export function createCrossRefTools(
           }),
         ),
       }),
-      handler: async (input: {
+      execute: async (input: {
         query: string;
         limit?: number;
         from_year?: number;
@@ -89,9 +92,9 @@ export function createCrossRefTools(
         if (input.sort) params.set("sort", input.sort);
 
         const res = await fetch(`${BASE}/works?${params}`, { headers });
-        if (!res.ok) return { error: `API error: ${res.status} ${res.statusText}` };
+        if (!res.ok) return toolResult({ error: `API error: ${res.status} ${res.statusText}` });
         const data = await res.json();
-        return {
+        return toolResult({
           total_results: data.message?.["total-results"],
           items: data.message?.items?.map((w: Record<string, unknown>) => ({
             doi: w.DOI,
@@ -105,7 +108,7 @@ export function createCrossRefTools(
             type: w.type,
             cited_by: w["is-referenced-by-count"],
           })),
-        };
+        });
       },
     },
   ];

package/src/tools/openalex.ts

@@ -1,5 +1,6 @@
 import { Type } from "@sinclair/typebox";
 import type { OpenClawPluginApi, OpenClawPluginToolContext } from "openclaw/plugin-sdk";
+import { toolResult } from "./util.js";
 
 const BASE = "https://api.openalex.org";
 
@@ -14,9 +15,10 @@ export function createOpenAlexTools(
   return [
     {
       name: "search_openalex",
+      label: "Search Works (OpenAlex)",
       description:
         "Search academic works via OpenAlex (free, no key required). Covers 250M+ works across all disciplines.",
-      inputSchema: Type.Object({
+      parameters: Type.Object({
         query: Type.String({ description: "Search query for works" }),
         limit: Type.Optional(
           Type.Number({ description: "Max results (default 10, max 200)" }),
@@ -36,7 +38,7 @@ export function createOpenAlexTools(
           }),
         ),
       }),
-      handler: async (input: {
+      execute: async (input: {
         query: string;
         limit?: number;
         from_year?: number;
@@ -57,9 +59,9 @@ export function createOpenAlexTools(
         if (input.sort_by) params.set("sort", input.sort_by);
 
         const res = await fetch(`${BASE}/works?${params}`, { headers });
-        if (!res.ok) return { error: `API error: ${res.status} ${res.statusText}` };
+        if (!res.ok) return toolResult({ error: `API error: ${res.status} ${res.statusText}` });
         const data = await res.json();
-        return {
+        return toolResult({
           total_count: data.meta?.count,
           results: data.results?.map((w: Record<string, unknown>) => ({
             id: w.id,
@@ -76,29 +78,30 @@ export function createOpenAlexTools(
                 )
               : [],
           })),
-        };
+        });
       },
     },
     {
       name: "get_work",
+      label: "Get Work Details (OpenAlex)",
       description:
         "Get full details of a work by its OpenAlex ID, DOI, or other identifier.",
-      inputSchema: Type.Object({
+      parameters: Type.Object({
         work_id: Type.String({
           description:
             "Work identifier: OpenAlex ID (e.g. 'W2741809807'), DOI URL, or PMID",
         }),
       }),
-      handler: async (input: { work_id: string }) => {
+      execute: async (input: { work_id: string }) => {
         const id = input.work_id.startsWith("10.")
           ? `https://doi.org/${input.work_id}`
           : input.work_id;
         const res = await fetch(`${BASE}/works/${encodeURIComponent(id)}`, {
           headers,
         });
-        if (!res.ok) return { error: `API error: ${res.status} ${res.statusText}` };
+        if (!res.ok) return toolResult({ error: `API error: ${res.status} ${res.statusText}` });
         const w = await res.json();
-        return {
+        return toolResult({
           id: w.id,
           doi: w.doi,
           title: w.title,
@@ -117,20 +120,21 @@ export function createOpenAlexTools(
             ?.slice(0, 10)
             .map((c: Record<string, unknown>) => c.display_name),
           referenced_works_count: w.referenced_works?.length,
-        };
+        });
       },
     },
     {
       name: "get_author_openalex",
+      label: "Get Author (OpenAlex)",
       description:
         "Get author information from OpenAlex including publications, h-index, and affiliations.",
-      inputSchema: Type.Object({
+      parameters: Type.Object({
         author_id: Type.String({
           description:
             "Author identifier: OpenAlex ID (e.g. 'A5023888391'), ORCID, or name search",
         }),
       }),
-      handler: async (input: { author_id: string }) => {
+      execute: async (input: { author_id: string }) => {
         let url: string;
         if (
           input.author_id.startsWith("A") ||
@@ -145,14 +149,14 @@ export function createOpenAlexTools(
             per_page: "5",
           });
           const res = await fetch(`${BASE}/authors?${params}`, { headers });
-          if (!res.ok) return { error: `API error: ${res.status} ${res.statusText}` };
-          return res.json();
+          if (!res.ok) return toolResult({ error: `API error: ${res.status} ${res.statusText}` });
+          return toolResult(await res.json());
         }
 
         const res = await fetch(url, { headers });
-        if (!res.ok) return { error: `API error: ${res.status} ${res.statusText}` };
+        if (!res.ok) return toolResult({ error: `API error: ${res.status} ${res.statusText}` });
         const a = await res.json();
-        return {
+        return toolResult({
           id: a.id,
           display_name: a.display_name,
           orcid: a.orcid,
@@ -167,7 +171,7 @@ export function createOpenAlexTools(
           top_concepts: a.x_concepts
             ?.slice(0, 5)
             .map((c: Record<string, unknown>) => c.display_name),
-        };
+        });
       },
     },
   ];

package/src/tools/pubmed.ts

@@ -1,5 +1,6 @@
 import { Type } from "@sinclair/typebox";
 import type { OpenClawPluginApi, OpenClawPluginToolContext } from "openclaw/plugin-sdk";
+import { toolResult } from "./util.js";
 
 const EUTILS = "https://eutils.ncbi.nlm.nih.gov/entrez/eutils";
 
@@ -10,9 +11,10 @@ export function createPubMedTools(
   return [
     {
       name: "search_pubmed",
+      label: "Search Articles (PubMed)",
       description:
         "Search PubMed biomedical literature database. Covers 36M+ citations from MEDLINE, life science journals, and online books.",
-      inputSchema: Type.Object({
+      parameters: Type.Object({
         query: Type.String({
           description:
             "PubMed search query. Supports MeSH terms and field tags, e.g. 'CRISPR[Title] AND 2024[PDAT]'",
@@ -32,7 +34,7 @@ export function createPubMedTools(
           Type.String({ description: "Max publication date (YYYY/MM/DD)" }),
         ),
       }),
-      handler: async (input: {
+      execute: async (input: {
         query: string;
         max_results?: number;
         sort?: string;
@@ -53,11 +55,11 @@ export function createPubMedTools(
 
         const searchRes = await fetch(`${EUTILS}/esearch.fcgi?${searchParams}`);
         if (!searchRes.ok)
-          return { error: `Search error: ${searchRes.status} ${searchRes.statusText}` };
+          return toolResult({ error: `Search error: ${searchRes.status} ${searchRes.statusText}` });
         const searchData = await searchRes.json();
         const ids: string[] = searchData.esearchresult?.idlist ?? [];
 
-        if (ids.length === 0) return { total_count: searchData.esearchresult?.count ?? 0, articles: [] };
+        if (ids.length === 0) return toolResult({ total_count: searchData.esearchresult?.count ?? 0, articles: [] });
 
         const summaryParams = new URLSearchParams({
           db: "pubmed",
@@ -66,7 +68,7 @@ export function createPubMedTools(
         });
         const summaryRes = await fetch(`${EUTILS}/esummary.fcgi?${summaryParams}`);
         if (!summaryRes.ok)
-          return { error: `Summary error: ${summaryRes.status} ${summaryRes.statusText}` };
+          return toolResult({ error: `Summary error: ${summaryRes.status} ${summaryRes.statusText}` });
         const summaryData = await summaryRes.json();
 
         const articles = ids.map((id) => {
@@ -87,27 +89,28 @@ export function createPubMedTools(
           };
         });
 
-        return {
+        return toolResult({
           total_count: parseInt(searchData.esearchresult?.count ?? "0", 10),
           articles,
-        };
+        });
       },
     },
     {
       name: "get_article",
+      label: "Get Article Details (PubMed)",
       description:
         "Get detailed article metadata from PubMed by PMID, including abstract.",
-      inputSchema: Type.Object({
+      parameters: Type.Object({
         pmid: Type.String({ description: "PubMed ID (numeric string)" }),
       }),
-      handler: async (input: { pmid: string }) => {
+      execute: async (input: { pmid: string }) => {
         const params = new URLSearchParams({
           db: "pubmed",
           id: input.pmid,
           retmode: "xml",
         });
         const res = await fetch(`${EUTILS}/efetch.fcgi?${params}`);
-        if (!res.ok) return { error: `API error: ${res.status} ${res.statusText}` };
+        if (!res.ok) return toolResult({ error: `API error: ${res.status} ${res.statusText}` });
         const xml = await res.text();
 
         const getText = (tag: string) => {
@@ -148,7 +151,7 @@ export function createPubMedTools(
           xml.match(/<ArticleId IdType="pmc">([\s\S]*?)<\/ArticleId>/)?.[1]?.trim() ??
           "";
 
-        return {
+        return toolResult({
           pmid: input.pmid,
           title: getText("ArticleTitle"),
           abstract: getAbstract(),
@@ -159,7 +162,7 @@ export function createPubMedTools(
           pmc,
           mesh_terms: getMesh(),
           url: `https://pubmed.ncbi.nlm.nih.gov/${input.pmid}/`,
-        };
+        });
       },
     },
   ];

package/src/tools/semantic-scholar.ts

@@ -1,5 +1,6 @@
 import { Type } from "@sinclair/typebox";
 import type { OpenClawPluginApi, OpenClawPluginToolContext } from "openclaw/plugin-sdk";
+import { toolResult } from "./util.js";
 
 const BASE = "https://api.semanticscholar.org/graph/v1";
 
@@ -15,9 +16,10 @@ export function createSemanticScholarTools(
   return [
     {
       name: "search_papers",
+      label: "Search Papers (Semantic Scholar)",
       description:
         "Search academic papers on Semantic Scholar. Returns titles, abstracts, authors, citation counts.",
-      inputSchema: Type.Object({
+      parameters: Type.Object({
         query: Type.String({ description: "Search query keywords" }),
         limit: Type.Optional(
           Type.Number({ description: "Max results to return (default 10, max 100)" }),
@@ -35,7 +37,7 @@ export function createSemanticScholarTools(
           Type.Boolean({ description: "Only return open access papers" }),
         ),
       }),
-      handler: async (input: {
+      execute: async (input: {
         query: string;
         limit?: number;
         year?: string;
@@ -54,36 +56,38 @@ export function createSemanticScholarTools(
         if (input.open_access_only) params.set("openAccessPdf", "");
 
         const res = await fetch(`${BASE}/paper/search?${params}`, { headers });
-        if (!res.ok) return { error: `API error: ${res.status} ${res.statusText}` };
-        return res.json();
+        if (!res.ok) return toolResult({ error: `API error: ${res.status} ${res.statusText}` });
+        return toolResult(await res.json());
       },
     },
     {
       name: "get_paper",
+      label: "Get Paper Details (Semantic Scholar)",
       description:
         "Get detailed information about a specific paper by its Semantic Scholar ID, DOI, or ArXiv ID.",
-      inputSchema: Type.Object({
+      parameters: Type.Object({
         paper_id: Type.String({
           description:
             "Paper identifier: Semantic Scholar ID, DOI (e.g. '10.1234/...'), or ArXiv ID (e.g. 'arXiv:2301.00001')",
         }),
       }),
-      handler: async (input: { paper_id: string }) => {
+      execute: async (input: { paper_id: string }) => {
         const fields =
           "title,abstract,authors,year,citationCount,referenceCount,tldr,url,venue,isOpenAccess,openAccessPdf,fieldsOfStudy,publicationDate";
         const res = await fetch(
           `${BASE}/paper/${encodeURIComponent(input.paper_id)}?fields=${fields}`,
           { headers },
         );
-        if (!res.ok) return { error: `API error: ${res.status} ${res.statusText}` };
-        return res.json();
+        if (!res.ok) return toolResult({ error: `API error: ${res.status} ${res.statusText}` });
+        return toolResult(await res.json());
       },
     },
     {
       name: "get_citations",
+      label: "Get Citations (Semantic Scholar)",
       description:
         "Get papers that cite a given paper. Useful for forward citation tracking.",
-      inputSchema: Type.Object({
+      parameters: Type.Object({
         paper_id: Type.String({ description: "Paper identifier (S2 ID, DOI, or ArXiv ID)" }),
         limit: Type.Optional(
           Type.Number({ description: "Max citations to return (default 20, max 100)" }),
@@ -92,7 +96,7 @@ export function createSemanticScholarTools(
           Type.Number({ description: "Pagination offset" }),
         ),
       }),
-      handler: async (input: { paper_id: string; limit?: number; offset?: number }) => {
+      execute: async (input: { paper_id: string; limit?: number; offset?: number }) => {
         const fields = "title,authors,year,citationCount,url,abstract";
         const limit = Math.min(input.limit ?? 20, 100);
         const offset = input.offset ?? 0;
@@ -100,8 +104,8 @@ export function createSemanticScholarTools(
           `${BASE}/paper/${encodeURIComponent(input.paper_id)}/citations?fields=${fields}&limit=${limit}&offset=${offset}`,
           { headers },
         );
-        if (!res.ok) return { error: `API error: ${res.status} ${res.statusText}` };
-        return res.json();
+        if (!res.ok) return toolResult({ error: `API error: ${res.status} ${res.statusText}` });
+        return toolResult(await res.json());
       },
     },
   ];

package/src/tools/unpaywall.ts

@@ -1,5 +1,6 @@
 import { Type } from "@sinclair/typebox";
 import type { OpenClawPluginApi, OpenClawPluginToolContext } from "openclaw/plugin-sdk";
+import { toolResult } from "./util.js";
 
 const BASE = "https://api.unpaywall.org/v2";
 
@@ -12,21 +13,22 @@ export function createUnpaywallTools(
   return [
     {
       name: "find_oa_version",
+      label: "Find Open Access Version (Unpaywall)",
       description:
         "Find open access versions of a paper by DOI using Unpaywall. Returns free PDF links from repositories, preprint servers, and publisher OA pages.",
-      inputSchema: Type.Object({
+      parameters: Type.Object({
         doi: Type.String({
           description: "DOI of the paper, e.g. '10.1038/nature12373'",
         }),
       }),
-      handler: async (input: { doi: string }) => {
+      execute: async (input: { doi: string }) => {
         const doi = input.doi.replace(/^https?:\/\/doi\.org\//, "");
         const res = await fetch(
           `${BASE}/${encodeURIComponent(doi)}?email=${email}`,
         );
         if (!res.ok) {
-          if (res.status === 404) return { error: "DOI not found in Unpaywall" };
-          return { error: `API error: ${res.status} ${res.statusText}` };
+          if (res.status === 404) return toolResult({ error: "DOI not found in Unpaywall" });
+          return toolResult({ error: `API error: ${res.status} ${res.statusText}` });
         }
         const data = await res.json();
 
@@ -40,7 +42,7 @@ export function createUnpaywallTools(
           version: loc.version,
         }));
 
-        return {
+        return toolResult({
           doi: data.doi,
           title: data.title,
           is_oa: data.is_oa,
@@ -51,7 +53,7 @@ export function createUnpaywallTools(
           publisher: data.publisher,
           published_date: data.published_date,
           oa_locations: oaLocations,
-        };
+        });
       },
     },
   ];

package/src/tools/util.ts

@@ -0,0 +1,11 @@
+/**
+ * Wrap raw data into the OpenClaw AgentTool return format.
+ *
+ * Expected shape: { content: [{ type: "text", text: string }], details: unknown }
+ *   - content  → displayed to the user / consumed by the model as text
+ *   - details  → structured data for programmatic access by downstream tools
+ */
+export function toolResult(data: unknown) {
+  const text = JSON.stringify(data, null, 2);
+  return { content: [{ type: "text" as const, text }], details: data };
+}