@zenalexa/unicli 0.225.2 → 0.225.3

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

@@ -1,17 +1,18 @@
 /**
  * @owner       src::adapters::neurips::proceedings
- * @does        Registers NeurIPS proceedings search over the official yearly paper list.
- * @needs       proceedings.neurips.cc static HTML, src/registry.ts
- * @feeds       src/commands/scholar.ts via scholar.search, scholar.pdf, and scholar.venue
- * @breaks      NeurIPS markup drift surfaces as empty parse output; no unrelated source fallback is used.
- * @invariants  Year is explicit; paper URLs are absolutized against proceedings.neurips.cc.
- * @side-effects HTTPS egress to proceedings.neurips.cc only
- * @perf        O(N) over one proceedings HTML page
+ * @does        Registers NeurIPS proceedings search, paper detail retrieval, and PDF text reading over official paper pages.
+ * @needs       proceedings.neurips.cc static HTML/PDFs, 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      NeurIPS markup/PDF drift, denied downloads, or missing pdftotext surface as explicit adapter errors; no unrelated source fallback is used.
+ * @invariants  Year is explicit; paper detail prefers citation_* metadata and official /file/ PDF URLs.
+ * @side-effects HTTPS egress to proceedings.neurips.cc; read writes one PDF artifact and executes pdftotext.
+ * @perf        O(N) over one proceedings HTML page; read is O(PDF bytes + selected pages)
  * @concurrency safe
  * @test        tests/unit/adapters/scholar-sources.test.ts
  * @stability   experimental
  * @since       2026-05-19
  */
 import type { ScholarlyWorkRecord } from "../../types/scholarly.js";
+export declare function parseNeuripsPaperPage(html: string, sourceUrl: string): ScholarlyWorkRecord;
 export declare function parseNeuripsRows(html: string, year?: string): ScholarlyWorkRecord[];
 //# sourceMappingURL=proceedings.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"proceedings.d.ts","sourceRoot":"","sources":["../../../src/adapters/neurips/proceedings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AA4BpE,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,SAAS,GACZ,mBAAmB,EAAE,CA6BvB"}
+{"version":3,"file":"proceedings.d.ts","sourceRoot":"","sources":["../../../src/adapters/neurips/proceedings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AA4FpE,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,mBAAmB,CAwCrB;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,SAAS,GACZ,mBAAmB,EAAE,CA2BvB"}

package/dist/adapters/neurips/proceedings.js

@@ -1,19 +1,21 @@
 /**
  * @owner       src::adapters::neurips::proceedings
- * @does        Registers NeurIPS proceedings search over the official yearly paper list.
- * @needs       proceedings.neurips.cc static HTML, src/registry.ts
- * @feeds       src/commands/scholar.ts via scholar.search, scholar.pdf, and scholar.venue
- * @breaks      NeurIPS markup drift surfaces as empty parse output; no unrelated source fallback is used.
- * @invariants  Year is explicit; paper URLs are absolutized against proceedings.neurips.cc.
- * @side-effects HTTPS egress to proceedings.neurips.cc only
- * @perf        O(N) over one proceedings HTML page
+ * @does        Registers NeurIPS proceedings search, paper detail retrieval, and PDF text reading over official paper pages.
+ * @needs       proceedings.neurips.cc static HTML/PDFs, 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      NeurIPS markup/PDF drift, denied downloads, or missing pdftotext surface as explicit adapter errors; no unrelated source fallback is used.
+ * @invariants  Year is explicit; paper detail prefers citation_* metadata and official /file/ PDF URLs.
+ * @side-effects HTTPS egress to proceedings.neurips.cc; read writes one PDF artifact and executes pdftotext.
+ * @perf        O(N) over one proceedings HTML page; read is O(PDF bytes + selected pages)
  * @concurrency safe
  * @test        tests/unit/adapters/scholar-sources.test.ts
  * @stability   experimental
  * @since       2026-05-19
  */
 import { cli, Strategy } from "../../registry.js";
+import { readScholarPdf } from "../scholar-artifacts/pdf-read.js";
 const ORIGIN = "https://proceedings.neurips.cc";
+const NEURIPS_USER_AGENT = "unicli-neurips/1.0 (https://github.com/olo-dot-io/Uni-CLI)";
 function decode(value) {
     return value
         .replace(/&/g, "&")
@@ -29,12 +31,85 @@ function absolute(path) {
         ? path
         : `${ORIGIN}${path.startsWith("/") ? "" : "/"}${path}`;
 }
+function metaContents(html, name) {
+    const values = [];
+    const re = new RegExp(`<meta\\s+name=["']${name}["']\\s+content=["']([^"']*)["'][^>]*>`, "gi");
+    let match;
+    while ((match = re.exec(html)) !== null)
+        values.push(decode(match[1]));
+    return values;
+}
+function firstMetaContent(html, name) {
+    return metaContents(html, name)[0] ?? "";
+}
 function requireYear(value) {
     const year = String(value ?? "").trim();
     if (!/^\d{4}$/.test(year))
         throw new Error(`neurips year "${year}" is not valid.`);
     return year;
 }
+function requireNeuripsPaperId(value) {
+    const raw = String(value ?? "").trim();
+    const id = raw
+        .match(/\/(?:hash|file)\/([^/?#]+\.html)/)?.[1]
+        ?.replace(/\.html$/, "") ?? raw.replace(/\.html$/, "");
+    if (!/^[A-Za-z0-9_.-]+$/.test(id)) {
+        throw new Error(`NeurIPS paper id "${raw}" is not valid.`);
+    }
+    return id;
+}
+function abstractUrl(id, year) {
+    return `${ORIGIN}/paper_files/paper/${year}/hash/${id}.html`;
+}
+function pdfUrlFromAbstractUrl(sourceUrl) {
+    return sourceUrl
+        .replace("/hash/", "/file/")
+        .replace("-Abstract-", "-Paper-")
+        .replace(/\.html$/, ".pdf");
+}
+function neuripsUpstreamError(label, detail) {
+    const error = new Error(`${label} failed: ${detail}.`);
+    error.code = "upstream_error";
+    error.suggestion =
+        "NeurIPS proceedings did not return the expected public paper page on this network path; retry later or verify the official proceedings.neurips.cc page manually.";
+    error.retryable =
+        /fetch failed|timeout|ECONNRESET|ETIMEDOUT|HTTP (429|5\d\d)/i.test(detail);
+    error.alternatives = [];
+    return error;
+}
+export function parseNeuripsPaperPage(html, sourceUrl) {
+    const title = firstMetaContent(html, "citation_title") ||
+        decode(html
+            .match(/<h1 class="paper-title">([\s\S]*?)<\/h1>/i)?.[1]
+            ?.replace(/<[^>]+>/g, " ") ?? "");
+    if (!title)
+        throw new Error("NeurIPS paper page did not expose a title.");
+    const year = firstMetaContent(html, "citation_publication_date").match(/\d{4}/)?.[0] ??
+        sourceUrl.match(/\/paper\/(\d{4})\//)?.[1];
+    const id = sourceUrl
+        .split("/")
+        .pop()
+        ?.replace(/\.html$/, "") ?? title;
+    const pdfUrl = firstMetaContent(html, "citation_pdf_url") ||
+        html.match(/href=["']([^"']+-Paper-[^"']+\.pdf)["']/i)?.[1] ||
+        "";
+    return {
+        id,
+        title,
+        authors: metaContents(html, "citation_author"),
+        year: year ? Number(year) : undefined,
+        venue: "NeurIPS",
+        type: firstMetaContent(html, "citation_journal_title") || undefined,
+        doi: firstMetaContent(html, "citation_doi") || undefined,
+        abstract: decode(html
+            .match(/<p class="paper-abstract">([\s\S]*?)<\/p>\s*<\/p>/i)?.[1]
+            ?.replace(/<[^>]+>/g, " ") ?? "") || undefined,
+        pdf_url: pdfUrl ? absolute(pdfUrl) : undefined,
+        source_adapter: "neurips",
+        source_url: sourceUrl,
+        retrieved_at: new Date().toISOString(),
+    };
+}
 export function parseNeuripsRows(html, year = "2024") {
     const out = [];
     const re = /<div class="paper-content">[\s\S]*?<a title="paper title" href="([^"]+)">([\s\S]*?)<\/a>[\s\S]*?<span class="paper-authors">([\s\S]*?)<\/span>/g;
@@ -53,9 +128,7 @@ export function parseNeuripsRows(html, year = "2024") {
                 .filter(Boolean),
             year: Number(year),
             venue: "NeurIPS",
-            pdf_url: sourceUrl
-                .replace("-Abstract-", "-Paper-")
-                .replace(/\.html$/, ".pdf"),
+            pdf_url: pdfUrlFromAbstractUrl(sourceUrl),
             source_adapter: "neurips",
             source_url: sourceUrl,
             retrieved_at: new Date().toISOString(),
@@ -63,6 +136,46 @@ export function parseNeuripsRows(html, year = "2024") {
     }
     return out;
 }
+async function fetchNeuripsHtml(url, label) {
+    let response;
+    try {
+        response = await fetch(url, {
+            headers: {
+                Accept: "text/html",
+                "User-Agent": NEURIPS_USER_AGENT,
+            },
+        });
+    }
+    catch (error) {
+        throw neuripsUpstreamError(label, error instanceof Error ? error.message : String(error));
+    }
+    if (response.status === 404)
+        throw new Error(`${label} returned no page.`);
+    if (!response.ok)
+        throw neuripsUpstreamError(label, `HTTP ${response.status}`);
+    return response.text();
+}
+async function readNeuripsPaperPdf(row, kwargs) {
+    if (!row.pdf_url)
+        throw new Error(`NeurIPS paper ${row.id} has no PDF URL.`);
+    return readScholarPdf({
+        id: row.id,
+        title: row.title,
+        source_adapter: "neurips",
+        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: "neurips",
+        command: "read",
+        defaultOutput: "./neurips-downloads",
+        userAgent: NEURIPS_USER_AGENT,
+    });
+}
 cli({
     site: "neurips",
     name: "search",
@@ -88,18 +201,8 @@ cli({
         if (!query)
             throw new Error("neurips search query cannot be empty.");
         const year = requireYear(kwargs.year);
-        const response = await fetch(`${ORIGIN}/paper_files/paper/${year}`, {
-            headers: {
-                Accept: "text/html",
-                "User-Agent": "unicli-neurips/1.0 (https://github.com/olo-dot-io/Uni-CLI)",
-            },
-        });
-        if (response.status === 404)
-            throw new Error(`NeurIPS ${year} returned no proceedings page.`);
-        if (!response.ok)
-            throw new Error(`NeurIPS ${year} returned HTTP ${response.status}.`);
         const limit = Math.min(Math.max(Number(kwargs.limit ?? 20), 1), 200);
-        const rows = parseNeuripsRows(await response.text(), year)
+        const rows = parseNeuripsRows(await fetchNeuripsHtml(`${ORIGIN}/paper_files/paper/${year}`, `NeurIPS ${year}`), year)
             .filter((row) => `${row.title} ${row.authors?.join(" ") ?? ""}`
             .toLowerCase()
             .includes(query))
@@ -109,4 +212,89 @@ cli({
         return rows;
     },
 });
+cli({
+    site: "neurips",
+    name: "paper",
+    description: "Fetch NeurIPS proceedings paper metadata by page id",
+    domain: "proceedings.neurips.cc",
+    strategy: Strategy.PUBLIC,
+    args: [
+        { name: "id", type: "str", required: true, positional: true },
+        { name: "year", type: "str", default: "2024" },
+    ],
+    columns: [
+        "id",
+        "title",
+        "authors",
+        "year",
+        "venue",
+        "doi",
+        "pdf_url",
+        "source_url",
+    ],
+    capabilities: ["http.fetch", "scholar.get", "scholar.pdf"],
+    func: async (_page, kwargs) => {
+        const year = requireYear(kwargs.year);
+        const id = requireNeuripsPaperId(kwargs.id ?? kwargs.ref);
+        const url = abstractUrl(id, year);
+        return [
+            parseNeuripsPaperPage(await fetchNeuripsHtml(url, `NeurIPS paper ${id}`), url),
+        ];
+    },
+});
+cli({
+    site: "neurips",
+    name: "read",
+    description: "Download a NeurIPS proceedings paper PDF by page id and extract text",
+    domain: "proceedings.neurips.cc",
+    strategy: Strategy.PUBLIC,
+    args: [
+        { name: "id", type: "str", required: true, positional: true },
+        { name: "year", type: "str", default: "2024" },
+        {
+            name: "output",
+            type: "str",
+            default: "./neurips-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 year = requireYear(kwargs.year);
+        const id = requireNeuripsPaperId(kwargs.id ?? kwargs.ref);
+        const url = abstractUrl(id, year);
+        const row = parseNeuripsPaperPage(await fetchNeuripsHtml(url, `NeurIPS paper ${id}`), url);
+        return [await readNeuripsPaperPdf(row, kwargs)];
+    },
+});
 //# sourceMappingURL=proceedings.js.map

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

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

package/dist/adapters/openalex/works.d.ts

@@ -1,9 +1,16 @@
 /**
- * @owner   src/adapters/openalex/works.ts
- * @does    Register agent-facing OpenAlex work search and detail commands.
- * @needs   Public OpenAlex API, TypeScript adapter loader, work id/DOI normalization.
- * @feeds   surface coverage ledger, scholarly work command surface, agent-readable OpenAlex rows.
- * @breaks  OpenAlex API envelope drift, weak DOI/id parsing, or abstract reconstruction errors degrade research lookup.
+ * @owner       src::adapters::openalex::works
+ * @does        Registers agent-facing OpenAlex work search, detail, and source PDF read commands.
+ * @needs       Public OpenAlex API, src/adapters/scholar-artifacts/pdf-read.ts, pdftotext
+ * @feeds       src/commands/scholar.ts via scholar.* capability tags, surface coverage ledger, scholarly work rows
+ * @breaks      OpenAlex API envelope drift, weak DOI/id parsing, missing OA PDF URLs, or abstract reconstruction errors surface as explicit adapter errors.
+ * @invariants  Work references normalize to OpenAlex W ids or doi: refs; read requires a source-provided PDF URL before text is claimed.
+ * @side-effects HTTPS egress to api.openalex.org and source PDF hosts; read writes one PDF and executes pdftotext.
+ * @perf        O(limit) JSON mapping for search; O(PDF bytes + extracted page range) for read
+ * @concurrency safe
+ * @test        src/adapters/openalex/works.test.ts, tests/unit/adapters/scholar-sources.test.ts
+ * @stability   experimental
+ * @since       2026-05-19
  */
 interface OpenAlexWork {
     id?: unknown;
@@ -18,6 +25,15 @@ interface OpenAlexWork {
         };
     }>;
     primary_location?: {
+        landing_page_url?: unknown;
+        pdf_url?: unknown;
+        source?: {
+            display_name?: unknown;
+        };
+    };
+    best_oa_location?: {
+        landing_page_url?: unknown;
+        pdf_url?: unknown;
         source?: {
             display_name?: unknown;
         };

package/dist/adapters/openalex/works.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"works.d.ts","sourceRoot":"","sources":["../../../src/adapters/openalex/works.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkCH,UAAU,YAAY;IACpB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,MAAM,CAAC,EAAE;YACP,YAAY,CAAC,EAAE,OAAO,CAAC;SACxB,CAAC;KACH,CAAC,CAAC;IACH,gBAAgB,CAAC,EAAE;QACjB,MAAM,CAAC,EAAE;YACP,YAAY,CAAC,EAAE,OAAO,CAAC;SACxB,CAAC;KACH,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gBAAgB,CAAC,EAAE,OAAO,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uBAAuB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACpD;AAUD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI3E;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAK,GAAG,MAAM,CAS1E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKrD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI9C;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAsB7D;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAclE;AAmCD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,YAAY,EAAE,EACrB,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAwBhC;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,YAAY,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiCzB"}
+{"version":3,"file":"works.d.ts","sourceRoot":"","sources":["../../../src/adapters/openalex/works.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAqCH,UAAU,YAAY;IACpB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,MAAM,CAAC,EAAE;YACP,YAAY,CAAC,EAAE,OAAO,CAAC;SACxB,CAAC;KACH,CAAC,CAAC;IACH,gBAAgB,CAAC,EAAE;QACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,MAAM,CAAC,EAAE;YACP,YAAY,CAAC,EAAE,OAAO,CAAC;SACxB,CAAC;KACH,CAAC;IACF,gBAAgB,CAAC,EAAE;QACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,MAAM,CAAC,EAAE;YACP,YAAY,CAAC,EAAE,OAAO,CAAC;SACxB,CAAC;KACH,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gBAAgB,CAAC,EAAE,OAAO,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uBAAuB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACpD;AAUD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI3E;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAK,GAAG,MAAM,CAS1E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKrD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI9C;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAsB7D;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAclE;AAqDD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,YAAY,EAAE,EACrB,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAyBhC;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,YAAY,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkCzB"}

package/dist/adapters/openalex/works.js

@@ -1,11 +1,19 @@
 /**
- * @owner   src/adapters/openalex/works.ts
- * @does    Register agent-facing OpenAlex work search and detail commands.
- * @needs   Public OpenAlex API, TypeScript adapter loader, work id/DOI normalization.
- * @feeds   surface coverage ledger, scholarly work command surface, agent-readable OpenAlex rows.
- * @breaks  OpenAlex API envelope drift, weak DOI/id parsing, or abstract reconstruction errors degrade research lookup.
+ * @owner       src::adapters::openalex::works
+ * @does        Registers agent-facing OpenAlex work search, detail, and source PDF read commands.
+ * @needs       Public OpenAlex API, src/adapters/scholar-artifacts/pdf-read.ts, pdftotext
+ * @feeds       src/commands/scholar.ts via scholar.* capability tags, surface coverage ledger, scholarly work rows
+ * @breaks      OpenAlex API envelope drift, weak DOI/id parsing, missing OA PDF URLs, or abstract reconstruction errors surface as explicit adapter errors.
+ * @invariants  Work references normalize to OpenAlex W ids or doi: refs; read requires a source-provided PDF URL before text is claimed.
+ * @side-effects HTTPS egress to api.openalex.org and source PDF hosts; read writes one PDF and executes pdftotext.
+ * @perf        O(limit) JSON mapping for search; O(PDF bytes + extracted page range) for read
+ * @concurrency safe
+ * @test        src/adapters/openalex/works.test.ts, tests/unit/adapters/scholar-sources.test.ts
+ * @stability   experimental
+ * @since       2026-05-19
  */
 import { cli, Strategy } from "../../registry.js";
+import { readScholarPdf } from "../scholar-artifacts/pdf-read.js";
 const OPENALEX_BASE = "https://api.openalex.org";
 const WORK_ID_RE = /^W\d{4,}$/;
 const DOI_RE = /^10\.\S+$/;
@@ -17,6 +25,7 @@ const SEARCH_SELECT = [
     "cited_by_count",
     "authorships",
     "primary_location",
+    "best_oa_location",
     "open_access",
     "type",
 ].join(",");
@@ -29,6 +38,7 @@ const WORK_SELECT = [
     "cited_by_count",
     "authorships",
     "primary_location",
+    "best_oa_location",
     "open_access",
     "type",
     "referenced_works",
@@ -135,7 +145,17 @@ function authorList(work) {
         : [];
 }
 function venue(work) {
-    return stringField(work.primary_location?.source?.display_name).trim();
+    return (stringField(work.primary_location?.source?.display_name).trim() ||
+        stringField(work.best_oa_location?.source?.display_name).trim());
+}
+function publisherLandingUrl(work) {
+    return (stringField(work.primary_location?.landing_page_url).trim() ||
+        stringField(work.best_oa_location?.landing_page_url).trim() ||
+        stringField(work.open_access?.oa_url).trim());
+}
+function openAlexPdfUrl(work) {
+    return (stringField(work.primary_location?.pdf_url).trim() ||
+        stringField(work.best_oa_location?.pdf_url).trim());
 }
 export function mapOpenAlexSearchRows(works, limit) {
     return works.slice(0, limit).map((work, index) => {
@@ -153,7 +173,8 @@ export function mapOpenAlexSearchRows(works, limit) {
             is_open_access: Boolean(work.open_access?.is_oa),
             type: stringField(work.type).trim(),
             doi: bareDoi(work.doi),
-            pdf_url: stringField(work.open_access?.oa_url).trim(),
+            pdf_url: openAlexPdfUrl(work),
+            landing_url: publisherLandingUrl(work) || undefined,
             openalex_id: id,
             source_adapter: "openalex",
             source_url: id ? `https://openalex.org/${id}` : "",
@@ -181,7 +202,8 @@ export function mapOpenAlexWorkRow(work) {
         openAccess: Boolean(work.open_access?.is_oa),
         is_open_access: Boolean(work.open_access?.is_oa),
         openAccessUrl: stringField(work.open_access?.oa_url).trim(),
-        pdf_url: stringField(work.open_access?.oa_url).trim(),
+        pdf_url: openAlexPdfUrl(work),
+        landing_url: publisherLandingUrl(work) || undefined,
         referencedCount: Array.isArray(work.referenced_works)
             ? work.referenced_works.length
             : null,
@@ -197,6 +219,26 @@ export function mapOpenAlexWorkRow(work) {
         url: `https://openalex.org/${id}`,
     };
 }
+async function readOpenAlexWorkPdf(row, kwargs) {
+    const pdfUrl = stringField(row.pdf_url);
+    if (!pdfUrl) {
+        const id = stringField(row.id) || stringField(row.openalex_id) || "record";
+        throw new Error(`OpenAlex work ${id} has no source PDF URL.`);
+    }
+    return readScholarPdf({
+        ...kwargs,
+        id: stringField(row.id) || stringField(row.openalex_id) || pdfUrl,
+        title: stringField(row.title) || pdfUrl,
+        source_adapter: "openalex",
+        source_url: stringField(row.source_url) || stringField(row.url),
+        pdf_url: pdfUrl,
+    }, {
+        site: "openalex",
+        command: "read",
+        defaultOutput: "./openalex-downloads",
+        userAgent: "unicli-openalex/1.0 (https://github.com/olo-dot-io/Uni-CLI)",
+    });
+}
 async function fetchOpenAlex(url, label) {
     const response = await fetch(appendMailto(url), {
         headers: {
@@ -296,4 +338,62 @@ cli({
         return [mapOpenAlexWorkRow(work)];
     },
 });
+cli({
+    site: "openalex",
+    name: "read",
+    description: "Download an OpenAlex open-access Work PDF and extract text",
+    domain: "api.openalex.org",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "id",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "OpenAlex Work id or DOI",
+        },
+        {
+            name: "output",
+            type: "str",
+            default: "./openalex-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 ref = requireOpenAlexWorkRef(kwargs.id);
+        const work = (await fetchOpenAlex(`${OPENALEX_BASE}/works/${encodeURIComponent(ref)}?select=${WORK_SELECT}`, "openalex work"));
+        return [await readOpenAlexWorkPdf(mapOpenAlexWorkRow(work), kwargs)];
+    },
+});
 //# sourceMappingURL=works.js.map

package/dist/adapters/openalex/works.js.map

@@ -1 +1 @@
-{"version":3,"file":"works.js","sourceRoot":"","sources":["../../../src/adapters/openalex/works.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,aAAa,GAAG,0BAA0B,CAAC;AACjD,MAAM,UAAU,GAAG,WAAW,CAAC;AAC/B,MAAM,MAAM,GAAG,WAAW,CAAC;AAC3B,MAAM,aAAa,GAAG;IACpB,IAAI;IACJ,KAAK;IACL,OAAO;IACP,kBAAkB;IAClB,gBAAgB;IAChB,aAAa;IACb,kBAAkB;IAClB,aAAa;IACb,MAAM;CACP,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACZ,MAAM,WAAW,GAAG;IAClB,IAAI;IACJ,KAAK;IACL,OAAO;IACP,kBAAkB;IAClB,kBAAkB;IAClB,gBAAgB;IAChB,aAAa;IACb,kBAAkB;IAClB,aAAa;IACb,MAAM;IACN,kBAAkB;IAClB,UAAU;IACV,yBAAyB;CAC1B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AA6BZ,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAChD,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAc,EAAE,KAAa;IACjE,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,YAAY,KAAK,mBAAmB,CAAC,CAAC;IACjE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc,EAAE,QAAQ,GAAG,EAAE;IAChE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IAC3E,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CACb,uDAAuD,MAAM,CAAC,KAAK,CAAC,EAAE,CACvE,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,WAAW,CAAC,KAAK,CAAC;SACtB,IAAI,EAAE;SACN,OAAO,CAAC,wCAAwC,EAAE,EAAE,CAAC;SACrD,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,WAAW,CAAC,KAAK,CAAC;SACtB,IAAI,EAAE;SACN,OAAO,CAAC,kCAAkC,EAAE,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC3D,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,CAC3B,iEAAiE,CAClE,CAAC;IACF,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACxC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,sCAAsC,EAAE,GAAG,CAAC,CAAC;QAC/D,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAChC,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACzC,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7C,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,OAAO,GAAG,EAAE,CAAC;IAC5C,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAClE,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,OAAO,GAAG,EAAE,CAAC;IAC1C,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,sBAAsB,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,KAAc;IACxD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACnD,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAC1C,KAAgC,CACjC,EAAE,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,SAAS;QACrC,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACzB,IAAI,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,GAAG,OAAO,EAAE,CAAC;gBACvD,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACzE,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC;IACnD,IAAI,CAAC,MAAM;QAAE,OAAO,GAAG,CAAC;IACxB,OAAO,GAAG,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,UAAU,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;AACtF,CAAC;AAED,SAAS,WAAW,CAAC,IAAkB;IACrC,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;QACnE,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,IAAI,EAAE;QAC/D,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,SAAS,OAAO,CAAC,IAAkB;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC;QACpC,CAAC,CAAC,IAAI,CAAC,WAAW;aACb,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;aAC5D,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,IAAI,CAAC;QACf,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,SAAS,UAAU,CAAC,IAAkB;IACpC,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC;QACpC,CAAC,CAAC,IAAI,CAAC,WAAW;aACb,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;aAC5D,MAAM,CAAC,OAAO,CAAC;QACpB,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,SAAS,KAAK,CAAC,IAAkB;IAC/B,OAAO,WAAW,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,KAAqB,EACrB,KAAa;IAEb,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC/C,MAAM,EAAE,GAAG,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnC,OAAO;YACL,IAAI,EAAE,KAAK,GAAG,CAAC;YACf,EAAE;YACF,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE;YACrC,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,gBAAgB,CAAC;YACxC,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,cAAc,CAAC;YAC3C,WAAW,EAAE,WAAW,CAAC,IAAI,CAAC;YAC9B,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC;YACzB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC;YAClB,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC;YAC5C,cAAc,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC;YAChD,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;YACnC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;YACtB,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE;YACrD,WAAW,EAAE,EAAE;YACf,cAAc,EAAE,UAAU;YAC1B,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE;YAClD,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACtC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE;SAC5C,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,IAAkB;IAElB,MAAM,EAAE,GAAG,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAC9D,OAAO;QACL,EAAE;QACF,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE;QACrC,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;QACnC,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,gBAAgB,CAAC;QACxC,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,IAAI,EAAE;QAC/C,QAAQ,EAAE,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE;QAC3C,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC;QACtB,WAAW,EAAE,UAAU,CAAC,IAAI,CAAC;QAC7B,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC;QAClB,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,cAAc,CAAC;QAC3C,cAAc,EAAE,WAAW,CAAC,IAAI,CAAC,cAAc,CAAC;QAChD,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC;QAC5C,cAAc,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC;QAChD,aAAa,EAAE,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE;QAC3D,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE;QACrD,eAAe,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC;YACnD,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM;YAC9B,CAAC,CAAC,IAAI;QACR,gBAAgB,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC;YACpD,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM;YAC9B,CAAC,CAAC,IAAI;QACR,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;QACtB,QAAQ,EAAE,2BAA2B,CAAC,IAAI,CAAC,uBAAuB,CAAC;QACnE,WAAW,EAAE,EAAE;QACf,cAAc,EAAE,UAAU;QAC1B,UAAU,EAAE,wBAAwB,EAAE,EAAE;QACxC,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACtC,GAAG,EAAE,wBAAwB,EAAE,EAAE;KAClC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,GAAW,EAAE,KAAa;IACrD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE;QAC9C,OAAO,EAAE;YACP,YAAY,EAAE,gDAAgD;YAC9D,MAAM,EAAE,kBAAkB;SAC3B;KACF,CAAC,CAAC;IACH,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,sBAAsB,CAAC,CAAC;IAC7E,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,qBAAqB,CAAC,CAAC;IAC5E,IAAI,CAAC,QAAQ,CAAC,EAAE;QACd,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,kBAAkB,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAChE,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,GAAG,CAAC;IACF,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,kCAAkC;IAC/C,MAAM,EAAE,kBAAkB;IAC1B,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,aAAa;SAC3B;QACD,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE;KACtE;IACD,OAAO,EAAE;QACP,MAAM;QACN,IAAI;QACJ,OAAO;QACP,MAAM;QACN,WAAW;QACX,aAAa;QACb,OAAO;QACP,YAAY;QACZ,MAAM;QACN,KAAK;QACL,KAAK;KACN;IACD,YAAY,EAAE,CAAC,YAAY,EAAE,gBAAgB,CAAC;IAC9C,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC5B,MAAM,KAAK,GAAG,qBAAqB,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3D,MAAM,KAAK,GAAG,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,CAAC,MAAM,aAAa,CAC/B,GAAG,aAAa,iBAAiB,kBAAkB,CAAC,KAAK,CAAC,aAAa,KAAK,WAAW,aAAa,EAAE,EACtG,iBAAiB,CAClB,CAAiC,CAAC;QACnC,MAAM,IAAI,GAAG,qBAAqB,CAChC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAC/C,KAAK,CACN,CAAC;QACF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,8BAA8B,KAAK,IAAI,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC,CAAC;AAEH,GAAG,CAAC;IACF,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,8BAA8B;IAC3C,MAAM,EAAE,kBAAkB;IAC1B,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,yBAAyB;SACvC;KACF;IACD,OAAO,EAAE;QACP,IAAI;QACJ,OAAO;QACP,MAAM;QACN,MAAM;QACN,MAAM;QACN,UAAU;QACV,SAAS;QACT,OAAO;QACP,WAAW;QACX,YAAY;QACZ,eAAe;QACf,iBAAiB;QACjB,KAAK;QACL,UAAU;QACV,KAAK;KACN;IACD,YAAY,EAAE;QACZ,YAAY;QACZ,aAAa;QACb,aAAa;QACb,oBAAoB;KACrB;IACD,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC5B,MAAM,GAAG,GAAG,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,CAAC,MAAM,aAAa,CAC/B,GAAG,aAAa,UAAU,kBAAkB,CAAC,GAAG,CAAC,WAAW,WAAW,EAAE,EACzE,eAAe,CAChB,CAAiB,CAAC;QACnB,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"works.js","sourceRoot":"","sources":["../../../src/adapters/openalex/works.ts"],"names":[],"mappings":"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"}

package/dist/adapters/openreview/papers.d.ts

@@ -1,9 +1,9 @@
 /**
  * @owner   src/adapters/openreview/papers.ts
- * @does    Register agent-facing OpenReview search, paper, author, venue, and reviews commands.
- * @needs   Public api2.openreview.net notes API, forum/profile id validation, note content normalization.
- * @feeds   surface coverage ledger, scholarly review workflow, agent-readable paper/review rows.
- * @breaks  OpenReview API envelope drift, content.value parsing, or silent empty threads hide paper review state.
+ * @does    Register agent-facing OpenReview search, paper, author, venue, reviews, PDF download, and PDF text extraction commands.
+ * @needs   Public api2.openreview.net notes API, openreview.net PDF URLs, pdftotext for read, forum/profile id validation, note content normalization.
+ * @feeds   surface coverage ledger, scholarly review workflow, agent-readable paper/review rows, local PDF/fulltext workflow.
+ * @breaks  OpenReview API envelope drift, content.value parsing, PDF download failure, pdftotext absence, or silent empty threads hide paper review state.
  */
 interface OpenReviewContentValue {
     value?: unknown;
@@ -22,6 +22,12 @@ export declare function coerceOpenReviewInt(value: unknown): number;
 export declare function requireOpenReviewLimit(value: unknown, fallback: number, max: number): number;
 export declare function requireOpenReviewOffset(value: unknown, fallback?: number): number;
 export declare function requireForumId(value: unknown, label?: string): string;
+export declare function requireOpenReviewPageRange(firstPage: unknown, lastPage: unknown): {
+    firstPage: number;
+    lastPage: number;
+};
+export declare function requireOpenReviewMaxChars(value: unknown, fallback?: number): number;
+export declare function openReviewPdfFilename(id: string, title: unknown): string;
 export declare function requireProfileId(value: unknown): string;
 export declare function readContent(content: OpenReviewContent | undefined, key: string): unknown;
 export declare function formatOpenReviewDate(value: unknown): string;