@alisio/plugin-literature-research 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gustavo Gutiérrez Mercado
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,23 @@
+# @alisio/plugin-literature-research
+
+Zero-key scholarly metadata tools for Alisio: `literature_search`, `paper_discover`, and `literature_read`.
+
+All tools have the `external` effect. Queries and identifiers are sent only to fixed official HTTPS APIs: OpenAlex, Crossref, and arXiv. The plugin does not persist queries, identifiers, metadata, abstracts, headers, or caches.
+
+It reads **metadata and a source-provided bounded abstract only**. It does not fetch arbitrary URLs, landing pages, HTML, PDFs, or full text, and it rejects redirects.
+
+## Install
+
+```bash
+alisio install npm:@alisio/plugin-literature-research
+```
+
+`literature_search` searches OpenAlex. `paper_discover` supports `openalex`, `crossref`, and `arxiv`. `literature_read` accepts exactly one DOI, arXiv identifier, or OpenAlex work ID and discloses the fixed source used.
+
+Inputs are bounded: query 1–512 characters, result limit 1–10, and years 1600 through next year. Results are normalized, escaped, capped, and retain source provenance. No generated relevance score is added.
+
+Requires Node.js **>= 22.16** and an Alisio host with `@alisio/sdk` `>=0.1.0-alpha.10`.
+
+## License
+
+MIT.

package/cover.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1600" height="900" viewBox="0 0 1600 900" role="img" aria-labelledby="title desc"><title id="title">Literature Research</title><desc id="desc">Connected scholarly papers around a central reading lens.</desc><rect width="1600" height="900" fill="#102033"/><path d="M420 250h450v370H420zM730 300h450v370H730z" fill="none" stroke="#75d5c8" stroke-width="20"/><path d="M490 370h300M490 440h300M800 420h300M800 490h300" stroke="#dbeafe" stroke-width="18" stroke-linecap="round"/><circle cx="800" cy="280" r="85" fill="#f6c85f"/><path d="M850 330l125 125" stroke="#f6c85f" stroke-width="30" stroke-linecap="round"/><text x="800" y="790" fill="#f8fafc" font-family="sans-serif" font-size="68" font-weight="700" text-anchor="middle">LITERATURE RESEARCH</text></svg>

package/dist/client.d.ts

@@ -0,0 +1,9 @@
+import type { Source } from "./validation.js";
+export type Clock = {
+    now: () => number;
+    sleep: (ms: number, signal: AbortSignal) => Promise<void>;
+};
+export declare const clock: Clock;
+export declare function request(source: Source, path: string, fetcher: typeof fetch, outer: AbortSignal, c?: Clock): Promise<string>;
+export declare function resetRateLimits(): void;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,MAAM,MAAM,KAAK,GAAG;IAClB,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D,CAAC;AACF,eAAO,MAAM,KAAK,EAAE,KAcnB,CAAC;AAQF,wBAAsB,OAAO,CAC3B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,KAAK,EACrB,KAAK,EAAE,WAAW,EAClB,CAAC,GAAE,KAAa,GACf,OAAO,CAAC,MAAM,CAAC,CA+BjB;AAuBD,wBAAgB,eAAe,SAG9B"}

package/dist/client.js

@@ -0,0 +1,86 @@
+export const clock = {
+    now: () => Date.now(),
+    sleep: (ms, signal) => new Promise((resolve, reject) => {
+        const t = setTimeout(resolve, ms);
+        signal.addEventListener("abort", () => {
+            clearTimeout(t);
+            reject(new Error("source unavailable"));
+        }, { once: true });
+    }),
+};
+let crossrefBusy = false, arxivNext = 0;
+const origins = {
+    openalex: "https://api.openalex.org",
+    crossref: "https://api.crossref.org",
+    arxiv: "https://export.arxiv.org",
+};
+export async function request(source, path, fetcher, outer, c = clock) {
+    const release = source === "crossref" ? await lock(outer) : undefined;
+    try {
+        if (source === "arxiv") {
+            const wait = Math.max(0, arxivNext - c.now());
+            if (wait)
+                await c.sleep(wait, outer);
+            arxivNext = c.now() + 3000;
+        }
+        const signal = AbortSignal.any([outer, AbortSignal.timeout(8000)]);
+        let r;
+        try {
+            r = await fetcher(origins[source] + path, {
+                method: "GET",
+                redirect: "manual",
+                headers: {
+                    accept: source === "arxiv" ? "application/atom+xml" : "application/json",
+                    "user-agent": "alisio-literature-research/0.1",
+                },
+                signal,
+            });
+        }
+        catch {
+            throw new Error("source unavailable");
+        }
+        if (r.status >= 300 && r.status < 400)
+            throw new Error("source returned redirect");
+        if (r.status === 429)
+            throw new Error("source rate limited");
+        if (!r.ok)
+            throw new Error("source unavailable");
+        if (r.redirected)
+            throw new Error("source returned redirect");
+        return bounded(r);
+    }
+    finally {
+        release?.();
+    }
+}
+async function lock(signal) {
+    if (crossrefBusy)
+        throw new Error("source rate limited");
+    crossrefBusy = true;
+    signal.throwIfAborted();
+    return () => {
+        crossrefBusy = false;
+    };
+}
+async function bounded(r) {
+    const reader = r.body?.getReader();
+    if (!reader)
+        return "";
+    let bytes = 0;
+    const chunks = [];
+    for (;;) {
+        const n = await reader.read();
+        if (n.done)
+            break;
+        bytes += n.value.byteLength;
+        if (bytes > 512 * 1024)
+            throw new Error("response exceeded limit");
+        chunks.push(n.value);
+    }
+    return new TextDecoder().decode(Buffer.concat(chunks));
+}
+export function resetRateLimits() {
+    crossrefBusy = false;
+    arxivNext = 0;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,KAAK,GAAU;IAC1B,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;IACrB,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CACpB,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC9B,MAAM,CAAC,GAAG,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAClC,MAAM,CAAC,gBAAgB,CACrB,OAAO,EACP,GAAG,EAAE;YACH,YAAY,CAAC,CAAC,CAAC,CAAC;YAChB,MAAM,CAAC,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;QAC1C,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAC;IACJ,CAAC,CAAC;CACL,CAAC;AACF,IAAI,YAAY,GAAG,KAAK,EACtB,SAAS,GAAG,CAAC,CAAC;AAChB,MAAM,OAAO,GAAG;IACd,QAAQ,EAAE,0BAA0B;IACpC,QAAQ,EAAE,0BAA0B;IACpC,KAAK,EAAE,0BAA0B;CACzB,CAAC;AACX,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAc,EACd,IAAY,EACZ,OAAqB,EACrB,KAAkB,EAClB,CAAC,GAAU,KAAK;IAEhB,MAAM,OAAO,GAAG,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,IAAI,CAAC;QACH,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YAC9C,IAAI,IAAI;gBAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACrC,SAAS,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;QAC7B,CAAC;QACD,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACnE,IAAI,CAAW,CAAC;QAChB,IAAI,CAAC;YACH,CAAC,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE;gBACxC,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,QAAQ;gBAClB,OAAO,EAAE;oBACP,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,kBAAkB;oBACxE,YAAY,EAAE,gCAAgC;iBAC/C;gBACD,MAAM;aACP,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,MAAM,GAAG,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACnF,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAC7D,IAAI,CAAC,CAAC,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACjD,IAAI,CAAC,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9D,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AACD,KAAK,UAAU,IAAI,CAAC,MAAmB;IACrC,IAAI,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACzD,YAAY,GAAG,IAAI,CAAC;IACpB,MAAM,CAAC,cAAc,EAAE,CAAC;IACxB,OAAO,GAAG,EAAE;QACV,YAAY,GAAG,KAAK,CAAC;IACvB,CAAC,CAAC;AACJ,CAAC;AACD,KAAK,UAAU,OAAO,CAAC,CAAW;IAChC,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;IACnC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,SAAS,CAAC;QACR,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,CAAC,IAAI;YAAE,MAAM;QAClB,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;QAC5B,IAAI,KAAK,GAAG,GAAG,GAAG,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACnE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;AACzD,CAAC;AACD,MAAM,UAAU,eAAe;IAC7B,YAAY,GAAG,KAAK,CAAC;IACrB,SAAS,GAAG,CAAC,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import { type Plugin, type ToolDefinition } from "@alisio/sdk";
+import { type Clock } from "./client.js";
+export declare const VERSION = "0.1.0";
+export declare function createTools(fetcher?: typeof fetch, clock?: Clock): ToolDefinition[];
+export declare function createLiteratureResearchPlugin(): Plugin;
+export { identifier, readInput, searchInput } from "./validation.js";
+declare const _default: Plugin;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,MAAM,EAAE,KAAK,cAAc,EAAmB,MAAM,aAAa,CAAC;AAC9F,OAAO,EAAE,KAAK,KAAK,EAAW,MAAM,aAAa,CAAC;AAElD,eAAO,MAAM,OAAO,UAAU,CAAC;AA6K/B,wBAAgB,WAAW,CAAC,OAAO,GAAE,OAAO,KAAa,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,cAAc,EAAE,CAqF1F;AACD,wBAAgB,8BAA8B,IAAI,MAAM,CAYvD;AACD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,229 @@
+import { definePlugin } from "@alisio/sdk";
+import { request } from "./client.js";
+import { readInput, searchInput } from "./validation.js";
+export const VERSION = "0.1.0";
+const clean = (v, max = 2000) => typeof v === "string"
+    ? v
+        .replace(/[\s\S]/g, (character) => {
+        const point = character.codePointAt(0) ?? 0;
+        return point < 32 || point === 127 ? " " : character;
+    })
+        .replace(/[\\`*_{}[\]()<>#+.!|-]/g, "\\$&")
+        .replace(/\s+/g, " ")
+        .trim()
+        .slice(0, max)
+    : undefined;
+const arr = (v) => Array.isArray(v)
+    ? v
+        .slice(0, 20)
+        .map((x) => clean(typeof x === "string" ? x : x?.name, 200))
+        .filter((x) => Boolean(x))
+    : [];
+function openalex(v) {
+    const inv = v.abstract_inverted_index;
+    const abstract = inv
+        ? Object.entries(inv)
+            .flatMap(([word, positions]) => positions.map((position) => [position, word]))
+            .sort((a, b) => a[0] - b[0])
+            .map((x) => x[1])
+            .join(" ")
+        : undefined;
+    const loc = v.primary_location;
+    return {
+        id: String(v.id ?? "").replace("https://openalex.org/", ""),
+        title: clean(v.title),
+        authors: arr((v.authorships ?? []).map((x) => x.author?.display_name)),
+        date: clean(v.publication_date, 32),
+        venue: clean(loc?.source?.display_name, 300),
+        abstract: clean(abstract, 20000),
+        url: clean(v.doi, 2048),
+        oa: v.open_access && typeof v.open_access === "object"
+            ? v.open_access.is_oa === true
+                ? "open access"
+                : undefined
+            : undefined,
+        source: "openalex",
+    };
+}
+function crossref(v) {
+    const date = v.published?.["date-parts"]?.[0]?.join("-");
+    return {
+        id: clean(v.DOI, 2048) ?? "",
+        title: clean(v.title?.[0]),
+        authors: arr((v.author ?? []).map((author) => {
+            const item = author;
+            return (item.name ??
+                [item.given, item.family].filter((part) => typeof part === "string").join(" "));
+        })),
+        date,
+        venue: clean(v["container-title"]?.[0], 300),
+        abstract: clean(v.abstract, 20000),
+        url: clean(v.URL, 2048),
+        license: clean(v.license?.[0]?.URL, 2048),
+        source: "crossref",
+    };
+}
+function arxiv(xml) {
+    const entries = [...xml.matchAll(/<entry>([\s\S]*?)<\/entry>/g)].map((m) => m[1] ?? "");
+    return entries.map((e) => ({
+        id: e.match(/<id>[^<]*\/abs\/([^<]+)<\/id>/)?.[1] ?? "",
+        title: clean(e.match(/<title>([\s\S]*?)<\/title>/)?.[1]),
+        authors: [...e.matchAll(/<name>([^<]+)<\/name>/g)]
+            .map((m) => clean(m[1], 200))
+            .filter((x) => Boolean(x))
+            .slice(0, 20),
+        date: clean(e.match(/<published>(\d{4}-\d{2}-\d{2})/)?.[1], 32),
+        abstract: clean(e.match(/<summary>([\s\S]*?)<\/summary>/)?.[1], 20000),
+        url: undefined,
+        source: "arxiv",
+    }));
+}
+function paths(source, q, limit, from, to) {
+    const f = encodeURIComponent(q);
+    if (source === "openalex")
+        return `/works?search=${f}&per-page=${limit}${from ? `&filter=from_publication_date:${from}-01-01${to ? `,to_publication_date:${to}-12-31` : ""}` : ""}`;
+    if (source === "crossref")
+        return `/works?query=${f}&rows=${limit}${from ? `&filter=from-pub-date:${from}-01-01${to ? `,until-pub-date:${to}-12-31` : ""}` : ""}`;
+    return `/api/query?search_query=all:${f}&start=0&max_results=${limit}`;
+}
+function markdown(papers, label) {
+    return [
+        `${label}. Outbound request: ${[...new Set(papers.map((p) => p.source))].join(", ") || "none"}.`,
+        ...papers.map((p, i) => `${i + 1}. **${p.title ?? "Untitled"}** — ${p.authors.join(", ") || "Unknown authors"}${p.date ? ` (${p.date})` : ""}\n   ID: ${p.id}; source: ${p.source}${p.abstract ? `\n   Abstract: ${p.abstract.slice(0, 20000)}` : ""}`),
+    ]
+        .join("\n")
+        .slice(0, 20000);
+}
+async function find(source, q, limit, signal, fetcher, clock, from, to) {
+    const body = await request(source, paths(source, q, limit, from, to), fetcher, signal, clock);
+    try {
+        if (source === "arxiv")
+            return arxiv(body).slice(0, limit);
+        const data = JSON.parse(body);
+        return source === "openalex"
+            ? (data.results ?? []).map(openalex).slice(0, limit)
+            : (data.message?.items ?? []).map(crossref).slice(0, limit);
+    }
+    catch {
+        throw new Error("invalid source response");
+    }
+}
+async function get(id, signal, fetcher, clock) {
+    if (id.kind === "openalex")
+        return findOne("openalex", `/works/${id.value}`, signal, fetcher, clock);
+    if (id.kind === "doi")
+        return findOne("crossref", `/works/${encodeURIComponent(id.value)}`, signal, fetcher, clock);
+    const data = await request("arxiv", `/api/query?id_list=${encodeURIComponent(id.value + (id.version ? `v${id.version}` : ""))}`, fetcher, signal, clock);
+    const p = arxiv(data)[0];
+    if (!p)
+        throw new Error("invalid source response");
+    return p;
+}
+async function findOne(source, path, signal, fetcher, clock) {
+    const body = await request(source, path, fetcher, signal, clock);
+    try {
+        const d = JSON.parse(body);
+        return source === "openalex" ? openalex(d) : crossref(d.message);
+    }
+    catch {
+        throw new Error("invalid source response");
+    }
+}
+export function createTools(fetcher = fetch, clock) {
+    const execute = (fn) => async (i, c) => {
+        try {
+            return await fn(i, c.signal);
+        }
+        catch (e) {
+            const message = e instanceof Error &&
+                [
+                    "invalid input",
+                    "source unavailable",
+                    "source rate limited",
+                    "invalid source response",
+                    "response exceeded limit",
+                    "source returned redirect",
+                ].includes(e.message)
+                ? e.message
+                : "source unavailable";
+            return { isError: true, content: [{ type: "text", text: message }] };
+        }
+    };
+    return [
+        {
+            name: "literature_search",
+            description: "Search OpenAlex scholarly metadata. Sends the topic only to OpenAlex; no URLs, PDFs, full text, or page reading.",
+            effect: "external",
+            inputSchema: {
+                type: "object",
+                additionalProperties: false,
+                required: ["query"],
+                properties: {
+                    query: { type: "string", minLength: 1, maxLength: 512 },
+                    limit: { type: "integer", minimum: 1, maximum: 10 },
+                    fromYear: { type: "integer" },
+                    toYear: { type: "integer" },
+                },
+            },
+            execute: execute(async (i, s) => {
+                const x = searchInput(i);
+                const p = await find("openalex", x.query, x.limit, s, fetcher, clock, x.fromYear, x.toYear);
+                return { content: [{ type: "text", text: markdown(p, "OpenAlex search") }] };
+            }),
+        },
+        {
+            name: "paper_discover",
+            description: "Discover scholarly metadata from a fixed official source. Sends the topic to OpenAlex, Crossref, or arXiv only; no URLs, PDFs, full text, or page reading.",
+            effect: "external",
+            inputSchema: {
+                type: "object",
+                additionalProperties: false,
+                required: ["query", "source"],
+                properties: {
+                    query: { type: "string", minLength: 1, maxLength: 512 },
+                    source: { type: "string", enum: ["openalex", "crossref", "arxiv"] },
+                    limit: { type: "integer", minimum: 1, maximum: 10 },
+                    fromYear: { type: "integer" },
+                    toYear: { type: "integer" },
+                },
+            },
+            execute: execute(async (i, s) => {
+                const x = searchInput(i, true);
+                const p = await find(x.source, x.query, x.limit, s, fetcher, clock, x.fromYear, x.toYear);
+                return { content: [{ type: "text", text: markdown(p, `${x.source} discovery`) }] };
+            }),
+        },
+        {
+            name: "literature_read",
+            description: "Read normalized metadata and a bounded source-provided abstract for exactly one DOI, arXiv ID, or OpenAlex work ID. It sends the identifier to its fixed official source; never reads URLs, PDFs, landing pages, HTML, or full text.",
+            effect: "external",
+            inputSchema: {
+                type: "object",
+                additionalProperties: false,
+                required: ["identifier"],
+                properties: { identifier: { type: "string", minLength: 1, maxLength: 2048 } },
+            },
+            execute: execute(async (i, s) => {
+                const p = await get(readInput(i), s, fetcher, clock);
+                return { content: [{ type: "text", text: markdown([p], `${p.source} metadata read`) }] };
+            }),
+        },
+    ];
+}
+export function createLiteratureResearchPlugin() {
+    return definePlugin({
+        id: "literature-research",
+        name: "Literature Research",
+        description: "Safe scholarly metadata and abstract research",
+        categories: ["search", "tools"],
+        version: VERSION,
+        apiVersion: 1,
+        setup(api) {
+            for (const tool of createTools())
+                api.tools.register(tool);
+        },
+    });
+}
+export { identifier, readInput, searchInput } from "./validation.js";
+export default createLiteratureResearchPlugin();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/validation.d.ts

@@ -0,0 +1,22 @@
+export type Source = "openalex" | "crossref" | "arxiv";
+export type Identifier = {
+    kind: "doi";
+    value: string;
+} | {
+    kind: "arxiv";
+    value: string;
+    version?: string;
+} | {
+    kind: "openalex";
+    value: string;
+};
+export declare function searchInput(input: unknown, sourceRequired?: boolean): {
+    query: string;
+    limit: number;
+    source: Source;
+    fromYear: number | undefined;
+    toYear: number | undefined;
+};
+export declare function identifier(raw: unknown): Identifier;
+export declare function readInput(input: unknown): Identifier;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;AACvD,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AA6BxC,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,UAAQ;;;;;;EAmBjE;AACD,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAgBnD;AACD,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,cAIvC"}

package/dist/validation.js

@@ -0,0 +1,73 @@
+const currentYear = () => new Date().getUTCFullYear() + 1;
+const object = (v) => {
+    if (!v || typeof v !== "object" || Array.isArray(v))
+        throw new Error("invalid input");
+    return v;
+};
+const keys = (v, allowed) => {
+    if (Object.keys(v).some((k) => !allowed.includes(k)))
+        throw new Error("invalid input");
+};
+const text = (v, min, max) => {
+    if (typeof v !== "string")
+        throw new Error("invalid input");
+    const s = v.trim();
+    if (s.length < min || s.length > max)
+        throw new Error("invalid input");
+    return s;
+};
+const limit = (v) => v === undefined
+    ? 5
+    : Number.isInteger(v) && v >= 1 && v <= 10
+        ? v
+        : (() => {
+            throw new Error("invalid input");
+        })();
+const year = (v) => {
+    if (v === undefined)
+        return undefined;
+    if (!Number.isInteger(v) || v < 1600 || v > currentYear())
+        throw new Error("invalid input");
+    return v;
+};
+export function searchInput(input, sourceRequired = false) {
+    const v = object(input);
+    keys(v, sourceRequired
+        ? ["query", "limit", "source", "fromYear", "toYear"]
+        : ["query", "limit", "fromYear", "toYear"]);
+    const fromYear = year(v.fromYear), toYear = year(v.toYear);
+    if (fromYear && toYear && fromYear > toYear)
+        throw new Error("invalid input");
+    const source = sourceRequired
+        ? v.source === "openalex" || v.source === "crossref" || v.source === "arxiv"
+            ? v.source
+            : (() => {
+                throw new Error("invalid input");
+            })()
+        : "openalex";
+    return { query: text(v.query, 1, 512), limit: limit(v.limit), source, fromYear, toYear };
+}
+export function identifier(raw) {
+    const s = text(raw, 1, 2048);
+    let value = decodeURIComponent(s).trim();
+    value = value.replace(/^doi:\s*/i, "").replace(/^https?:\/\/(?:dx\.)?doi\.org\//i, "");
+    if (/^10\.\d{4,9}\/[\w.()/:;+-]+$/i.test(value))
+        return { kind: "doi", value: value.toLowerCase() };
+    const ar = value.match(/^(?:arxiv:)?(\d{4}\.\d{4,5}|[a-z-]+(?:\.[a-z-]+)?\/\d{7})(v\d+)?$/i);
+    if (ar)
+        return {
+            kind: "arxiv",
+            value: (ar[1] ?? "").toLowerCase(),
+            ...(ar[2] ? { version: ar[2].slice(1) } : {}),
+        };
+    const oa = value.match(/^(?:https?:\/\/openalex\.org\/)?(W\d+)$/i);
+    if (oa)
+        return { kind: "openalex", value: (oa[1] ?? "").toUpperCase() };
+    throw new Error("invalid input");
+}
+export function readInput(input) {
+    const v = object(input);
+    keys(v, ["identifier"]);
+    return identifier(v.identifier);
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,3 @@
+// Updated by scripts/sync-versions.mjs.
+export const VERSION = "0.1.0";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@alisio/plugin-literature-research",
+  "version": "0.1.0",
+  "description": "Safe zero-key scholarly metadata research tools for Alisio.",
+  "keywords": [
+    "alisio-plugin",
+    "literature",
+    "research",
+    "scholarly"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GustavoGutierrez/alisio-plugins.git",
+    "directory": "packages/plugin-literature-research"
+  },
+  "homepage": "https://github.com/GustavoGutierrez/alisio-plugins/tree/main/packages/plugin-literature-research#readme",
+  "bugs": {
+    "url": "https://github.com/GustavoGutierrez/alisio-plugins/issues"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=22.16"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "cover.svg"
+  ],
+  "peerDependencies": {
+    "@alisio/sdk": ">=0.1.0-alpha.10 <0.2.0"
+  },
+  "devDependencies": {
+    "@alisio/sdk": "0.1.0-alpha.11",
+    "typescript": "7.0.2",
+    "vitest": "5.0.1"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}