@zenalexa/unicli 0.225.2 → 0.225.3

package/dist/adapters/pmlr/proceedings.d.ts

@@ -1,12 +1,12 @@
 /**
  * @owner       src::adapters::pmlr::proceedings
- * @does        Registers Proceedings of Machine Learning Research volume search using official citeproc.yaml metadata.
- * @needs       proceedings.mlr.press citeproc.yaml files, js-yaml, src/registry.ts
- * @feeds       src/commands/scholar.ts via scholar.search, scholar.get, scholar.pdf, and scholar.venue
- * @breaks      Missing volume metadata or citeproc drift surfaces as explicit adapter errors.
+ * @does        Registers Proceedings of Machine Learning Research volume search, paper lookup, and PDF text reading using official citeproc.yaml metadata.
+ * @needs       proceedings.mlr.press citeproc.yaml/PDF assets, js-yaml, src/adapters/scholar-artifacts/pdf-read.ts, src/registry.ts
+ * @feeds       src/commands/scholar.ts via scholar.search, scholar.get, scholar.pdf, scholar.fulltext, and scholar.venue
+ * @breaks      Missing volume metadata, citeproc/PDF drift, denied downloads, or missing pdftotext surfaces as explicit adapter errors.
  * @invariants  Volume is explicit; rows are filtered locally from official YAML metadata, not scraped from rendered cards.
- * @side-effects HTTPS egress to proceedings.mlr.press only
- * @perf        O(N) over one proceedings volume
+ * @side-effects HTTPS egress to proceedings.mlr.press/raw.githubusercontent.com; read writes one PDF artifact and executes pdftotext.
+ * @perf        O(N) over one proceedings volume; read is O(PDF bytes + selected pages)
  * @concurrency safe
  * @test        tests/unit/adapters/scholar-sources.test.ts
  * @stability   experimental

package/dist/adapters/pmlr/proceedings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proceedings.d.ts","sourceRoot":"","sources":["../../../src/adapters/pmlr/proceedings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,UAAU,SAAS;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACtD,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,MAAM,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IACtC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAuBD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CAG3D;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,GACb,mBAAmB,CAgBrB"}
+{"version":3,"file":"proceedings.d.ts","sourceRoot":"","sources":["../../../src/adapters/pmlr/proceedings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGpE,UAAU,SAAS;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACtD,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,MAAM,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IACtC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAuBD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CAG3D;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,GACb,mBAAmB,CAgBrB"}

package/dist/adapters/pmlr/proceedings.js

@@ -1,12 +1,12 @@
 /**
  * @owner       src::adapters::pmlr::proceedings
- * @does        Registers Proceedings of Machine Learning Research volume search using official citeproc.yaml metadata.
- * @needs       proceedings.mlr.press citeproc.yaml files, js-yaml, src/registry.ts
- * @feeds       src/commands/scholar.ts via scholar.search, scholar.get, scholar.pdf, and scholar.venue
- * @breaks      Missing volume metadata or citeproc drift surfaces as explicit adapter errors.
+ * @does        Registers Proceedings of Machine Learning Research volume search, paper lookup, and PDF text reading using official citeproc.yaml metadata.
+ * @needs       proceedings.mlr.press citeproc.yaml/PDF assets, js-yaml, src/adapters/scholar-artifacts/pdf-read.ts, src/registry.ts
+ * @feeds       src/commands/scholar.ts via scholar.search, scholar.get, scholar.pdf, scholar.fulltext, and scholar.venue
+ * @breaks      Missing volume metadata, citeproc/PDF drift, denied downloads, or missing pdftotext surfaces as explicit adapter errors.
  * @invariants  Volume is explicit; rows are filtered locally from official YAML metadata, not scraped from rendered cards.
- * @side-effects HTTPS egress to proceedings.mlr.press only
- * @perf        O(N) over one proceedings volume
+ * @side-effects HTTPS egress to proceedings.mlr.press/raw.githubusercontent.com; read writes one PDF artifact and executes pdftotext.
+ * @perf        O(N) over one proceedings volume; read is O(PDF bytes + selected pages)
  * @concurrency safe
  * @test        tests/unit/adapters/scholar-sources.test.ts
  * @stability   experimental
@@ -14,6 +14,7 @@
  */
 import yaml from "js-yaml";
 import { cli, Strategy } from "../../registry.js";
+import { readScholarPdf } from "../scholar-artifacts/pdf-read.js";
 function str(value) {
     return typeof value === "string" ? value.trim() : "";
 }
@@ -74,6 +75,35 @@ async function fetchVolume(volume) {
         throw new Error(`PMLR volume v${volume} returned HTTP ${response.status}.`);
     return parsePmlrCiteproc(await response.text());
 }
+async function findPmlrPaper(volume, id) {
+    const row = (await fetchVolume(volume))
+        .map((entry) => mapPmlrEntry(entry, "pmlr"))
+        .find((entry) => entry.id === id);
+    if (!row)
+        throw new Error(`No PMLR v${volume} paper found with id "${id}".`);
+    return row;
+}
+async function readPmlrPaperPdf(row, kwargs) {
+    if (!row.pdf_url)
+        throw new Error(`PMLR paper ${row.id} has no PDF URL.`);
+    return readScholarPdf({
+        id: row.id,
+        title: row.title,
+        source_adapter: "pmlr",
+        source_url: row.source_url,
+        pdf_url: row.pdf_url,
+        output: kwargs.output,
+        filename: kwargs.filename,
+        "first-page": kwargs["first-page"] ?? kwargs.firstPage,
+        "last-page": kwargs["last-page"] ?? kwargs.lastPage,
+        "max-chars": kwargs["max-chars"] ?? kwargs.maxChars,
+    }, {
+        site: "pmlr",
+        command: "read",
+        defaultOutput: "./pmlr-downloads",
+        userAgent: "unicli-pmlr/1.0 (https://github.com/olo-dot-io/Uni-CLI)",
+    });
+}
 cli({
     site: "pmlr",
     name: "search",
@@ -128,12 +158,62 @@ cli({
         if (!id)
             throw new Error("pmlr paper id is required.");
         const volume = requireVolume(kwargs.volume);
-        const row = (await fetchVolume(volume))
-            .map((entry) => mapPmlrEntry(entry, "pmlr"))
-            .find((entry) => entry.id === id);
-        if (!row)
-            throw new Error(`No PMLR v${volume} paper found with id "${id}".`);
-        return [row];
+        return [await findPmlrPaper(volume, id)];
+    },
+});
+cli({
+    site: "pmlr",
+    name: "read",
+    description: "Download a PMLR paper PDF by id inside a proceedings volume and extract text",
+    domain: "proceedings.mlr.press",
+    strategy: Strategy.PUBLIC,
+    args: [
+        { name: "id", type: "str", required: true, positional: true },
+        { name: "volume", type: "str", default: "235" },
+        {
+            name: "output",
+            type: "str",
+            default: "./pmlr-downloads",
+            description: "Output directory for the downloaded PDF",
+            "x-unicli-kind": "path",
+        },
+        { name: "filename", type: "str", description: "Output PDF filename" },
+        { name: "first-page", type: "int", default: 1, description: "First page" },
+        { name: "last-page", type: "int", default: 20, description: "Last page" },
+        {
+            name: "max-chars",
+            type: "int",
+            default: 40000,
+            description: "Maximum extracted text characters",
+        },
+    ],
+    columns: [
+        "id",
+        "title",
+        "source_adapter",
+        "source_url",
+        "pdf_url",
+        "path",
+        "text_source",
+        "text",
+        "text_chars",
+        "text_truncated",
+    ],
+    capabilities: [
+        "http.fetch",
+        "http.download",
+        "subprocess.exec",
+        "scholar.fulltext",
+        "scholar.pdf",
+    ],
+    executables: ["pdftotext"],
+    minimum_capability: "subprocess.exec",
+    func: async (_page, kwargs) => {
+        const id = String(kwargs.id ?? kwargs.ref ?? "").trim();
+        if (!id)
+            throw new Error("pmlr paper id is required.");
+        const volume = requireVolume(kwargs.volume);
+        return [await readPmlrPaperPdf(await findPmlrPaper(volume, id), kwargs)];
     },
 });
 //# sourceMappingURL=proceedings.js.map

package/dist/adapters/pmlr/proceedings.js.map

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

package/dist/adapters/pubmed/articles.d.ts

@@ -1,9 +1,9 @@
 /**
  * @owner   src/adapters/pubmed/articles.ts
- * @does    Register agent-facing PubMed search, article, author, citation, and related-article commands.
- * @needs   NCBI E-utilities API, TypeScript adapter loader, PMID/query validation.
- * @feeds   surface coverage ledger, biomedical literature command surface, agent-readable PubMed rows.
- * @breaks  NCBI E-utilities envelope drift, weak PMID validation, or silent empty rows hide literature lookup failures.
+ * @does    Register agent-facing PubMed search, normalized paper metadata, field/value article detail, PMC full-text read, author, citation, and related-article commands.
+ * @needs   NCBI E-utilities PubMed/PMC APIs, TypeScript adapter loader, PMID/PMCID/query validation.
+ * @feeds   surface coverage ledger, biomedical literature command surface, agent-readable PubMed rows, scholar full-text workflow.
+ * @breaks  NCBI E-utilities envelope drift, weak PMID/PMCID validation, missing PMC full text, or silent empty rows hide literature lookup failures.
  */
 interface PubMedSummary {
     uid?: unknown;
@@ -24,8 +24,12 @@ interface PubMedSummary {
 }
 export declare function requirePubMedText(value: unknown, label: string): string;
 export declare function requirePmid(value: unknown, label?: string): string;
+export declare function normalizePmcId(value: unknown): string;
 export declare function requirePubMedLimit(value: unknown, fallback?: number, max?: number): number;
+export declare function requirePubMedMaxChars(value: unknown, fallback?: number): number;
 export declare function mapPubMedSummaryRows(summaries: PubMedSummary[], pmids: string[]): Array<Record<string, unknown>>;
+export declare function mapPubMedArticleRecord(xml: string, pmid: string): Record<string, unknown>;
 export declare function mapPubMedArticleRows(xml: string, pmid: string, fullAbstract?: boolean): Array<Record<string, unknown>>;
+export declare function mapPmcFullTextRow(xml: string, ref: string, maxChars?: number): Record<string, unknown>;
 export {};
 //# sourceMappingURL=articles.d.ts.map

package/dist/adapters/pubmed/articles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"articles.d.ts","sourceRoot":"","sources":["../../../src/adapters/pubmed/articles.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmBH,UAAU,aAAa;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC,CAAC;CACJ;AAkBD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIvE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAS,GAAG,MAAM,CAKlE;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,QAAQ,SAAK,EACb,GAAG,SAAM,GACR,MAAM,CASR;AAwFD,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,aAAa,EAAE,EAC1B,KAAK,EAAE,MAAM,EAAE,GACd,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAkBhC;AAoBD,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,YAAY,UAAQ,GACnB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAmDhC"}
+{"version":3,"file":"articles.d.ts","sourceRoot":"","sources":["../../../src/adapters/pubmed/articles.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkCH,UAAU,aAAa;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC,CAAC;CACJ;AAkBD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIvE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAS,GAAG,MAAM,CAKlE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMrD;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,QAAQ,SAAK,EACb,GAAG,SAAM,GACR,MAAM,CASR;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,QAAQ,SAAS,GAChB,MAAM,CASR;AAsGD,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,aAAa,EAAE,EAC1B,KAAK,EAAE,MAAM,EAAE,GACd,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA4BhC;AA2CD,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4CzB;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,YAAY,UAAQ,GACnB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAsBhC;AA4CD,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,QAAQ,SAAS,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyCzB"}

package/dist/adapters/pubmed/articles.js

@@ -1,15 +1,16 @@
 /**
  * @owner   src/adapters/pubmed/articles.ts
- * @does    Register agent-facing PubMed search, article, author, citation, and related-article commands.
- * @needs   NCBI E-utilities API, TypeScript adapter loader, PMID/query validation.
- * @feeds   surface coverage ledger, biomedical literature command surface, agent-readable PubMed rows.
- * @breaks  NCBI E-utilities envelope drift, weak PMID validation, or silent empty rows hide literature lookup failures.
+ * @does    Register agent-facing PubMed search, normalized paper metadata, field/value article detail, PMC full-text read, author, citation, and related-article commands.
+ * @needs   NCBI E-utilities PubMed/PMC APIs, TypeScript adapter loader, PMID/PMCID/query validation.
+ * @feeds   surface coverage ledger, biomedical literature command surface, agent-readable PubMed rows, scholar full-text workflow.
+ * @breaks  NCBI E-utilities envelope drift, weak PMID/PMCID validation, missing PMC full text, or silent empty rows hide literature lookup failures.
  */
 import { DOMParser } from "@xmldom/xmldom";
 import { cli, Strategy } from "../../registry.js";
 const EUTILS_BASE = "https://eutils.ncbi.nlm.nih.gov/entrez/eutils";
 const SUMMARY_COLUMNS = [
     "rank",
+    "id",
     "pmid",
     "title",
     "authors",
@@ -17,9 +18,23 @@ const SUMMARY_COLUMNS = [
     "year",
     "article_type",
     "doi",
+    "pmc_id",
     "url",
 ];
-const RELATED_COLUMNS = [...SUMMARY_COLUMNS.slice(0, 7), "score", "doi", "url"];
+const RELATED_COLUMNS = [
+    "rank",
+    "id",
+    "pmid",
+    "title",
+    "authors",
+    "journal",
+    "year",
+    "score",
+    "doi",
+    "pmc_id",
+    "url",
+];
+const PMC_BASE = "https://pmc.ncbi.nlm.nih.gov/articles";
 function stringField(value) {
     return typeof value === "string" ? value : "";
 }
@@ -46,6 +61,15 @@ export function requirePmid(value, label = "pmid") {
         throw new Error(`pubmed ${label} must be a numeric PMID.`);
     return pmid;
 }
+export function normalizePmcId(value) {
+    const raw = String(value ?? "").trim();
+    if (!raw)
+        return "";
+    const match = raw.match(/^(?:PMC)?(\d+)$/i);
+    if (!match)
+        throw new Error(`pubmed pmc id "${raw}" is not valid.`);
+    return `PMC${match[1]}`;
+}
 export function requirePubMedLimit(value, fallback = 20, max = 100) {
     if (value === undefined || value === null || value === "")
         return fallback;
@@ -55,6 +79,15 @@ export function requirePubMedLimit(value, fallback = 20, max = 100) {
     }
     return n;
 }
+export function requirePubMedMaxChars(value, fallback = 40_000) {
+    if (value === undefined || value === null || value === "")
+        return fallback;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 1_000 || n > 1_000_000) {
+        throw new Error(`pubmed max-chars must be an integer in [1000, 1000000]. Got: ${String(value)}`);
+    }
+    return n;
+}
 function requireChoice(value, choices, label, fallback) {
     const text = String(value ?? fallback).trim();
     if (!choices.includes(text))
@@ -64,9 +97,9 @@ function requireChoice(value, choices, label, fallback) {
 function year(value) {
     return stringField(value).match(/\d{4}/)?.[0] ?? "";
 }
-function buildUrl(tool, params, retmode = "json") {
+function buildUrl(tool, params, retmode = "json", db = "pubmed") {
     const search = new URLSearchParams();
-    search.set("db", "pubmed");
+    search.set("db", db);
     search.set("retmode", retmode);
     if (process.env.NCBI_API_KEY)
         search.set("api_key", process.env.NCBI_API_KEY);
@@ -78,8 +111,8 @@ function buildUrl(tool, params, retmode = "json") {
     }
     return `${EUTILS_BASE}/${tool}.fcgi?${search.toString()}`;
 }
-async function eutilsFetch(tool, params, retmode = "json") {
-    const response = await fetch(buildUrl(tool, params, retmode), {
+async function eutilsFetch(tool, params, retmode = "json", db = "pubmed") {
+    const response = await fetch(buildUrl(tool, params, retmode, db), {
         headers: { "User-Agent": "unicli (https://github.com/olo-dot-io/Uni-CLI)" },
     });
     if (!response.ok)
@@ -108,11 +141,16 @@ function authorNames(authors, max = 3) {
     return shown.join(", ");
 }
 function doi(articleIds) {
+    return articleId(articleIds, "doi");
+}
+function articleId(articleIds, type) {
     return stringField(Array.isArray(articleIds)
-        ? articleIds.find((id) => stringField(id.idtype).toLowerCase() === "doi")
-            ?.value
+        ? articleIds.find((id) => stringField(id.idtype).toLowerCase() === type.toLowerCase())?.value
         : "");
 }
+function pmcUrl(pmcId) {
+    return pmcId ? `${PMC_BASE}/${pmcId}/` : "";
+}
 function articleType(types) {
     const values = Array.isArray(types)
         ? types.map(stringField).filter(Boolean)
@@ -124,17 +162,27 @@ export function mapPubMedSummaryRows(summaries, pmids) {
         const summary = summaries.find((item) => stringField(item.uid) === pmid);
         if (!summary)
             return [];
+        const pmcId = articleId(summary.articleids, "pmc");
+        const url = `https://pubmed.ncbi.nlm.nih.gov/${pmid}/`;
         return [
             {
                 rank: index + 1,
+                id: pmid,
                 pmid,
                 title: cleanText(summary.title),
                 authors: authorNames(summary.authors),
                 journal: stringField(summary.source),
+                venue: stringField(summary.source),
                 year: year(summary.pubdate),
                 article_type: articleType(summary.pubtype ?? []),
+                type: articleType(summary.pubtype ?? []),
                 doi: doi(summary.articleids),
-                url: `https://pubmed.ncbi.nlm.nih.gov/${pmid}/`,
+                pmc_id: pmcId || undefined,
+                pmc_url: pmcUrl(pmcId),
+                source_adapter: "pubmed",
+                source_url: url,
+                retrieved_at: new Date().toISOString(),
+                url,
             },
         ];
     });
@@ -151,49 +199,162 @@ function elementTexts(root, tagName) {
 function firstElement(root, tagName) {
     return root.getElementsByTagName(tagName)[0] ?? null;
 }
-export function mapPubMedArticleRows(xml, pmid, fullAbstract = false) {
+function elements(root, tagName) {
+    const nodes = root.getElementsByTagName(tagName);
+    return Array.from({ length: nodes.length }, (_, index) => nodes.item(index)).filter((node) => node !== null);
+}
+function articleIdText(root, attrName, attrValue) {
+    return (elements(root, attrName === "IdType" ? "ArticleId" : "article-id")
+        .find((node) => node.getAttribute(attrName)?.toLowerCase() ===
+        attrValue.toLowerCase())
+        ?.textContent?.trim() ?? "");
+}
+export function mapPubMedArticleRecord(xml, pmid) {
     const document = new DOMParser().parseFromString(xml, "text/xml");
     const title = childText(document, "ArticleTitle");
     if (!title)
         throw new Error(`pubmed article ${pmid} did not include a title.`);
+    const doiValue = articleIdText(document, "IdType", "doi");
+    const pmcId = articleIdText(document, "IdType", "pmc");
     const abstract = elementTexts(document, "AbstractText").join(" ");
-    const shownAbstract = fullAbstract || abstract.length <= 500
-        ? abstract
-        : `${abstract.slice(0, 497)}...`;
-    const doiValue = Array.from({ length: document.getElementsByTagName("ArticleId").length }, (_, index) => document.getElementsByTagName("ArticleId").item(index))
-        .filter((node) => node !== null)
-        .find((node) => node.getAttribute("IdType")?.toLowerCase() === "doi")
-        ?.textContent?.trim() ?? "";
     const authorNodes = document.getElementsByTagName("Author");
-    const authors = Array.from({ length: authorNodes.length }, (_, index) => authorNodes.item(index))
+    const authorList = Array.from({ length: authorNodes.length }, (_, index) => authorNodes.item(index))
         .filter((author) => author !== null)
         .map((author) => [childText(author, "LastName"), childText(author, "Initials")]
         .filter(Boolean)
         .join(" "))
-        .filter(Boolean)
-        .join(", ");
+        .filter(Boolean);
     const journal = firstElement(document, "Journal");
     const pubDate = firstElement(document, "PubDate");
+    const yearValue = pubDate ? childText(pubDate, "Year") : "";
+    const sourceUrl = `https://pubmed.ncbi.nlm.nih.gov/${pmid}/`;
+    return {
+        id: pmid,
+        pmid,
+        title,
+        authors: authorList,
+        journal: journal ? childText(journal, "Title") : "",
+        venue: journal ? childText(journal, "Title") : "",
+        year: yearValue ? Number(yearValue) : undefined,
+        date: pubDate ? cleanText(pubDate.textContent ?? "") : "",
+        article_type: elementTexts(document, "PublicationType")[0] ?? "",
+        type: elementTexts(document, "PublicationType")[0] ?? "",
+        language: childText(document, "Language"),
+        doi: doiValue || undefined,
+        pmc_id: pmcId || undefined,
+        pmc_url: pmcUrl(pmcId),
+        abstract: abstract || undefined,
+        source_adapter: "pubmed",
+        source_url: sourceUrl,
+        retrieved_at: new Date().toISOString(),
+        url: sourceUrl,
+    };
+}
+export function mapPubMedArticleRows(xml, pmid, fullAbstract = false) {
+    const record = mapPubMedArticleRecord(xml, pmid);
+    const abstract = stringField(record.abstract);
+    const shownAbstract = fullAbstract || abstract.length <= 500
+        ? abstract
+        : `${abstract.slice(0, 497)}...`;
     return [
         { field: "PMID", value: pmid },
-        { field: "Title", value: title },
-        { field: "Authors", value: authors },
-        { field: "Journal", value: journal ? childText(journal, "Title") : "" },
-        { field: "Year", value: pubDate ? childText(pubDate, "Year") : "" },
-        {
-            field: "Date",
-            value: pubDate ? cleanText(pubDate.textContent ?? "") : "",
-        },
-        {
-            field: "Article Type",
-            value: elementTexts(document, "PublicationType")[0] ?? null,
-        },
-        { field: "Language", value: childText(document, "Language") },
-        { field: "DOI", value: doiValue || null },
+        { field: "PMCID", value: record.pmc_id || null },
+        { field: "Title", value: record.title },
+        { field: "Authors", value: record.authors.join(", ") },
+        { field: "Journal", value: record.journal },
+        { field: "Year", value: record.year ? String(record.year) : "" },
+        { field: "Date", value: record.date },
+        { field: "Article Type", value: record.article_type || null },
+        { field: "Language", value: record.language },
+        { field: "DOI", value: record.doi || null },
         { field: "Abstract", value: shownAbstract || null },
-        { field: "URL", value: `https://pubmed.ncbi.nlm.nih.gov/${pmid}/` },
+        { field: "URL", value: record.source_url },
+        { field: "PMC URL", value: record.pmc_url || null },
     ];
 }
+function directChildElements(root, tagName) {
+    const out = [];
+    for (let index = 0; index < root.childNodes.length; index += 1) {
+        const node = root.childNodes.item(index);
+        if (node?.nodeType === 1 && node.nodeName === tagName) {
+            out.push(node);
+        }
+    }
+    return out;
+}
+function directChildText(root, tagName) {
+    return cleanText(directChildElements(root, tagName)[0]?.textContent ?? "");
+}
+function sectionText(section) {
+    const title = directChildText(section, "title");
+    const paragraphs = directChildElements(section, "p")
+        .map((paragraph) => cleanText(paragraph.textContent ?? ""))
+        .filter(Boolean);
+    const nested = directChildElements(section, "sec")
+        .map(sectionText)
+        .filter(Boolean);
+    return [title ? `## ${title}` : "", ...paragraphs, ...nested]
+        .filter(Boolean)
+        .join("\n\n");
+}
+function truncateText(text, maxChars) {
+    if (text.length <= maxChars)
+        return { text, truncated: false };
+    return {
+        text: `${text.slice(0, maxChars).trimEnd()}\n\n[truncated at ${maxChars} characters]`,
+        truncated: true,
+    };
+}
+export function mapPmcFullTextRow(xml, ref, maxChars = 40_000) {
+    const document = new DOMParser().parseFromString(xml, "text/xml");
+    const title = childText(document, "article-title");
+    if (!title) {
+        throw new Error(`PMC full text ${ref} did not include an article title.`);
+    }
+    const pmcId = normalizePmcId(articleIdText(document, "pub-id-type", "pmcid") || ref);
+    const pmid = articleIdText(document, "pub-id-type", "pmid");
+    const doiValue = articleIdText(document, "pub-id-type", "doi");
+    const abstract = cleanText(firstElement(document, "abstract")?.textContent ?? "");
+    const body = firstElement(document, "body");
+    const bodyText = body
+        ? directChildElements(body, "sec")
+            .map(sectionText)
+            .filter(Boolean)
+            .join("\n\n")
+        : "";
+    const text = [abstract ? `## Abstract\n\n${abstract}` : "", bodyText]
+        .filter(Boolean)
+        .join("\n\n");
+    if (!text) {
+        throw new Error(`PMC full text ${pmcId} did not include readable text.`);
+    }
+    const truncated = truncateText(text, maxChars);
+    return {
+        id: pmid || pmcId,
+        title,
+        pmid: pmid || undefined,
+        pmc_id: pmcId,
+        doi: doiValue || undefined,
+        source_adapter: "pubmed",
+        source_url: pmcUrl(pmcId),
+        text: truncated.text,
+        text_truncated: truncated.truncated,
+        text_source: "pmc_xml",
+        retrieved_at: new Date().toISOString(),
+    };
+}
+async function pmcIdFromPubMedRef(ref) {
+    if (/^(?:PMC)?\d+$/i.test(ref) && /^PMC/i.test(ref)) {
+        return normalizePmcId(ref);
+    }
+    const pmid = requirePmid(ref, "pmid");
+    const json = (await eutilsFetch("esearch", { term: `${pmid}[PMID]`, retmax: 1 }, "json", "pmc"));
+    const numericPmc = json.esearchresult?.idlist?.[0];
+    if (!numericPmc) {
+        throw new Error(`PubMed PMID ${pmid} has no PubMed Central full text record.`);
+    }
+    return normalizePmcId(numericPmc);
+}
 async function fetchSummaryRows(pmids, label) {
     const json = (await eutilsFetch("esummary", { id: pmids.join(",") }));
     const result = json.result ?? {};
@@ -261,13 +422,85 @@ cli({
         },
     ],
     columns: ["field", "value"],
-    capabilities: ["http.fetch", "scholar.get"],
+    capabilities: ["http.fetch"],
     func: async (_page, kwargs) => {
         const pmid = requirePmid(kwargs.pmid);
         const xml = String(await eutilsFetch("efetch", { id: pmid, rettype: "abstract" }, "xml"));
         return mapPubMedArticleRows(xml, pmid, kwargs["full-abstract"] === true);
     },
 });
+cli({
+    site: "pubmed",
+    name: "paper",
+    description: "Fetch normalized PubMed article metadata by PMID",
+    domain: "pubmed.ncbi.nlm.nih.gov",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "pmid",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "PubMed ID",
+        },
+    ],
+    columns: [
+        "id",
+        "title",
+        "authors",
+        "year",
+        "journal",
+        "doi",
+        "pmc_id",
+        "source_url",
+    ],
+    capabilities: ["http.fetch", "scholar.get"],
+    func: async (_page, kwargs) => {
+        const pmid = requirePmid(kwargs.pmid ?? kwargs.id ?? kwargs.ref);
+        const xml = String(await eutilsFetch("efetch", { id: pmid, rettype: "abstract" }, "xml"));
+        return [mapPubMedArticleRecord(xml, pmid)];
+    },
+});
+cli({
+    site: "pubmed",
+    name: "read",
+    description: "Read PubMed Central full text for a PMID or PMCID",
+    domain: "eutils.ncbi.nlm.nih.gov",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "ref",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "PubMed PMID or PubMed Central PMCID",
+        },
+        {
+            name: "max-chars",
+            type: "int",
+            default: 40000,
+            description: "Maximum extracted text characters",
+        },
+    ],
+    columns: [
+        "id",
+        "title",
+        "pmid",
+        "pmc_id",
+        "doi",
+        "source_url",
+        "text",
+        "text_truncated",
+    ],
+    capabilities: ["http.fetch", "scholar.fulltext"],
+    func: async (_page, kwargs) => {
+        const ref = requirePubMedText(kwargs.ref ?? kwargs.id ?? kwargs.pmid, "ref");
+        const maxChars = requirePubMedMaxChars(kwargs["max-chars"]);
+        const pmcId = await pmcIdFromPubMedRef(ref);
+        const xml = String(await eutilsFetch("efetch", { id: pmcId.replace(/^PMC/i, "") }, "xml", "pmc"));
+        return [mapPmcFullTextRow(xml, pmcId, maxChars)];
+    },
+});
 cli({
     site: "pubmed",
     name: "author",