@zenalexa/unicli 0.218.1 → 0.220.0

package/src/adapters/36kr/hot.yaml

@@ -4,6 +4,7 @@ description: 36Kr hot/trending articles
 domain: 36kr.com
 type: web-api
 strategy: public
+lint_listing_detail: skip
 
 args:
   limit:

package/src/adapters/36kr/search.yaml

@@ -4,6 +4,7 @@ description: Search 36Kr articles
 domain: 36kr.com
 type: web-api
 strategy: public
+lint_listing_detail: skip
 
 args:
   query:

package/src/adapters/_archived/README.md

@@ -0,0 +1,12 @@
+# Archived Adapters
+
+These adapters are preserved for provenance but are outside active discovery.
+The loader, manifest builder, conformance report, and quarantine repair list
+skip underscore-prefixed adapter directories.
+
+| Site        | Commands    | Archived on | Replacement                                                             |
+| ----------- | ----------- | ----------- | ----------------------------------------------------------------------- |
+| apple-music | rate-album  | 2026-05-06  | `unicli macos music-now`; `unicli macos music-control <action>`         |
+| az          | account     | 2026-05-06  | `az account list --output json` through external CLI passthrough        |
+| ctrip       | hot, search | 2026-05-06  | `unicli web read` or browser/CUA against an authenticated Ctrip session |
+| gcloud      | projects    | 2026-05-06  | `gcloud projects list --format=json` through external CLI passthrough   |

package/src/adapters/{apple-music → _archived/apple-music}/rate-album.yaml

@@ -1,14 +1,8 @@
-# AX-first demo with CUA fallback — rate the current Apple Music album.
-#
-# Strategy:
-#   1. desktop-ax   → launch and focus Music
-#   2. desktop-ax   → open the "Album" AppleScript menu (cheap & exact)
-#   3. cua          → take a screenshot so the VLM can verify the stars
-#                     UI is visible before we click it
-#   4. cua          → click the star coordinate (caller-provided)
-#
-# Real UI coordinates vary by screen size — callers either pass x/y or
-# let the pipeline use the VLM snapshot to locate the stars themselves.
+# @owner   src/adapters/_archived/apple-music/rate-album.yaml
+# @does    Preserve the archived Apple Music CUA rating demo outside active discovery.
+# @needs   macOS Music app, desktop AX transport, CUA backend, caller-provided star coordinates
+# @feeds   src/adapters/_archived/archive.json provenance, historical adapter review
+# @breaks  Moving back under an active site would reintroduce an archive-only discovered site.
 site: apple-music
 name: rate-album
 description: Rate the currently-playing Apple Music album via AX menu + CUA click
@@ -56,7 +50,6 @@ pipeline:
 
 columns: [backend, stars]
 
-# schema-v2 metadata — injected by `unicli migrate schema-v2`
 capabilities:
   [
     "cua.ask",

package/src/adapters/_archived/archive.json

@@ -0,0 +1,44 @@
+{
+  "archived_on": "2026-05-06",
+  "reason": "Feature 3.2 dead-site archive: each listed site had zero active commands and only quarantined adapters.",
+  "sites": [
+    {
+      "site": "apple-music",
+      "commands": ["rate-album"],
+      "original_paths": ["src/adapters/apple-music/rate-album.yaml"],
+      "archived_paths": ["src/adapters/_archived/apple-music/rate-album.yaml"],
+      "reason": "Host-app CUA demo requires the macOS Music app and a CUA backend; active Apple Music controls remain under the macos adapter.",
+      "replacement": "unicli macos music-now; unicli macos music-control <action>"
+    },
+    {
+      "site": "az",
+      "commands": ["account"],
+      "original_paths": ["src/adapters/az/account.yaml"],
+      "archived_paths": ["src/adapters/_archived/az/account.yaml"],
+      "reason": "Dedicated Azure account adapter cannot run in CI without interactive az login; az remains available through external CLI passthrough when installed.",
+      "replacement": "az account list --output json"
+    },
+    {
+      "site": "ctrip",
+      "commands": ["hot", "search"],
+      "original_paths": [
+        "src/adapters/ctrip/hot.yaml",
+        "src/adapters/ctrip/search.yaml"
+      ],
+      "archived_paths": [
+        "src/adapters/_archived/ctrip/hot.yaml",
+        "src/adapters/_archived/ctrip/search.yaml"
+      ],
+      "reason": "Public Ctrip endpoints were verified broken or CAPTCHA-gated on 2026-05-05, with no stable public replacement captured.",
+      "replacement": "Use the web adapter or browser/CUA flow against an authenticated Ctrip session."
+    },
+    {
+      "site": "gcloud",
+      "commands": ["projects"],
+      "original_paths": ["src/adapters/gcloud/projects.yaml"],
+      "archived_paths": ["src/adapters/_archived/gcloud/projects.yaml"],
+      "reason": "Dedicated Google Cloud projects adapter cannot run in CI without interactive gcloud auth; gcloud remains available through external CLI passthrough when installed.",
+      "replacement": "gcloud projects list --format=json"
+    }
+  ]
+}

package/src/adapters/{az → _archived/az}/account.yaml

@@ -1,3 +1,8 @@
+# @owner   src/adapters/_archived/az/account.yaml
+# @does    Preserve the archived Azure account-list adapter outside active discovery.
+# @needs   Azure CLI installed and authenticated with az login
+# @feeds   src/adapters/_archived/archive.json provenance, historical adapter review
+# @breaks  Moving back under an active site would reintroduce an archive-only discovered site.
 site: az
 name: account
 description: List Azure subscriptions
@@ -20,7 +25,6 @@ pipeline:
 
 columns: [name, id, state, isDefault]
 
-# schema-v2 metadata — injected by `unicli migrate schema-v2`
 capabilities: ["subprocess.exec"]
 minimum_capability: subprocess.exec
 trust: user

package/src/adapters/{ctrip → _archived/ctrip}/hot.yaml

@@ -1,3 +1,8 @@
+# @owner   src/adapters/_archived/ctrip/hot.yaml
+# @does    Preserve the archived Ctrip hot-destination adapter outside active discovery.
+# @needs   Historical m.ctrip.com hotcity endpoint
+# @feeds   src/adapters/_archived/archive.json provenance, historical adapter review
+# @breaks  Moving back under an active site would reintroduce an archive-only discovered site.
 site: ctrip
 name: hot
 description: Ctrip popular travel destinations
@@ -27,7 +32,6 @@ pipeline:
 
 columns: [rank, name, type]
 
-# schema-v2 metadata — injected by `unicli migrate schema-v2`
 capabilities: ["http.fetch"]
 minimum_capability: http.fetch
 trust: public

package/src/adapters/{ctrip → _archived/ctrip}/search.yaml

@@ -1,3 +1,8 @@
+# @owner   src/adapters/_archived/ctrip/search.yaml
+# @does    Preserve the archived Ctrip flight-search adapter outside active discovery.
+# @needs   Historical flights.ctrip.com batchSearch endpoint without CAPTCHA
+# @feeds   src/adapters/_archived/archive.json provenance, historical adapter review
+# @breaks  Moving back under an active site would reintroduce an archive-only discovered site.
 site: ctrip
 name: search
 description: Search flights on Ctrip
@@ -52,11 +57,10 @@ args:
 
 columns: [airline, flight, depart, arrive, price]
 
-# schema-v2 metadata — injected by `unicli migrate schema-v2`
 capabilities: ["http.fetch"]
 minimum_capability: http.fetch
 trust: public
 confidentiality: public
 quarantine: true
-quarantineReason: "flights.ctrip.com search endpoint now requires CAPTCHA (showAuthCode=true on every public hit, verified 2026-05-05) — needs cookie/UI strategy with anti-bot solve"
+quarantineReason: "flights.ctrip.com search endpoint now requires CAPTCHA (showAuthCode=true on every public hit, verified 2026-05-05) - needs cookie/UI strategy with anti-bot solve"
 schema_version: v2

package/src/adapters/{gcloud → _archived/gcloud}/projects.yaml

@@ -1,3 +1,8 @@
+# @owner   src/adapters/_archived/gcloud/projects.yaml
+# @does    Preserve the archived Google Cloud projects adapter outside active discovery.
+# @needs   Google Cloud CLI installed and authenticated with gcloud auth login
+# @feeds   src/adapters/_archived/archive.json provenance, historical adapter review
+# @breaks  Moving back under an active site would reintroduce an archive-only discovered site.
 site: gcloud
 name: projects
 description: List Google Cloud projects
@@ -18,7 +23,6 @@ pipeline:
 
 columns: [projectId, name, projectNumber, lifecycleState]
 
-# schema-v2 metadata — injected by `unicli migrate schema-v2`
 capabilities: ["subprocess.exec"]
 minimum_capability: subprocess.exec
 trust: user

package/src/adapters/aibase/news.test.ts

@@ -0,0 +1,42 @@
+import { describe, expect, it } from "vitest";
+import {
+  buildExtractAibaseNewsJs,
+  mapAibaseNewsPayload,
+  requireNewsLimit,
+} from "./news.js";
+
+describe("aibase agent-facing news command", () => {
+  it("validates limits and exposes selector extraction code", () => {
+    expect(requireNewsLimit(undefined)).toBe(20);
+    expect(requireNewsLimit("50")).toBe(50);
+    expect(() => requireNewsLimit("0")).toThrow("limit must be");
+    expect(buildExtractAibaseNewsJs()).toContain("/zh/daily/");
+  });
+
+  it("maps extracted rows and rejects selector drift", () => {
+    expect(
+      mapAibaseNewsPayload(
+        {
+          ok: true,
+          rows: [
+            { title: " AI  news ", url: " https://www.aibase.com/zh/daily/1 " },
+            { title: "", url: "https://example.test/empty" },
+          ],
+        },
+        10,
+      ),
+    ).toEqual([
+      {
+        rank: 1,
+        title: "AI news",
+        url: "https://www.aibase.com/zh/daily/1",
+      },
+    ]);
+    expect(() =>
+      mapAibaseNewsPayload({ ok: false, reason: "selector-missing" }, 10),
+    ).toThrow("selector drift");
+    expect(() => mapAibaseNewsPayload({ ok: true, rows: [] }, 10)).toThrow(
+      "no article rows",
+    );
+  });
+});

package/src/adapters/aibase/news.ts

@@ -0,0 +1,118 @@
+/**
+ * @owner   src/adapters/aibase/news.ts
+ * @does    Register agent-facing AIbase daily-news browser extraction command.
+ * @needs   Public AIbase daily page, browser runtime, selector-drift error reporting.
+ * @feeds   surface coverage ledger, AI news discovery, Chinese AI daily brief surface.
+ * @breaks  AIbase DOM drift or silent empty extraction hides news coverage failures.
+ */
+
+import { cli, Strategy } from "../../registry.js";
+import type { IPage } from "../../types.js";
+
+const AIBASE_DAILY_URL = "https://www.aibase.com/zh/daily";
+
+function normalizeText(value: unknown): string {
+  return String(value ?? "")
+    .replace(/\s+/g, " ")
+    .trim();
+}
+
+export function requireNewsLimit(value: unknown, fallback = 20): number {
+  if (value === undefined || value === null || value === "") return fallback;
+  const n = Number(value);
+  if (!Number.isInteger(n) || n < 1 || n > 50) {
+    throw new Error("limit must be an integer in [1, 50].");
+  }
+  return n;
+}
+
+export function buildExtractAibaseNewsJs(): string {
+  return `
+    (() => {
+      const anchors = Array.from(document.querySelectorAll('.bg-white .grid a[href], a[href*="/zh/daily/"]'))
+        .filter((anchor) => {
+          const href = anchor.getAttribute('href') || '';
+          const text = (anchor.innerText || anchor.textContent || '').trim();
+          return text && href && !href.endsWith('/zh/daily') && !href.endsWith('/zh/daily/');
+        });
+      if (anchors.length === 0) {
+        return {
+          ok: false,
+          reason: 'selector-missing',
+          title: document.title || '',
+          bodyText: (document.body?.innerText || document.body?.textContent || '').slice(0, 500),
+        };
+      }
+      const seen = new Set();
+      const rows = [];
+      for (const anchor of anchors) {
+        const url = new URL(anchor.getAttribute('href'), location.href).href;
+        if (seen.has(url)) continue;
+        seen.add(url);
+        rows.push({
+          title: anchor.innerText || anchor.textContent || '',
+          url,
+        });
+      }
+      return { ok: true, rows };
+    })()
+  `;
+}
+
+interface BrowserExtractPayload {
+  ok?: unknown;
+  reason?: unknown;
+  title?: unknown;
+  rows?: Array<{ title?: unknown; url?: unknown }>;
+}
+
+export function mapAibaseNewsPayload(
+  payload: BrowserExtractPayload,
+  limit: number,
+): Array<Record<string, unknown>> {
+  if (!payload || typeof payload !== "object") {
+    throw new Error("AIbase daily page returned an unreadable payload.");
+  }
+  if (payload.ok !== true) {
+    const reason = normalizeText(payload.reason) || "selector-drift";
+    const title = normalizeText(payload.title);
+    throw new Error(
+      `AIbase daily selector drift: ${reason}${title ? ` (${title})` : ""}`,
+    );
+  }
+  const rows = (Array.isArray(payload.rows) ? payload.rows : [])
+    .map((row, index) => ({
+      rank: index + 1,
+      title: normalizeText(row.title),
+      url: normalizeText(row.url),
+    }))
+    .filter((row) => row.title && row.url);
+  if (rows.length === 0) {
+    throw new Error(
+      "AIbase daily page loaded, but no article rows were extracted.",
+    );
+  }
+  return rows
+    .slice(0, limit)
+    .map((row, index) => ({ ...row, rank: index + 1 }));
+}
+
+cli({
+  site: "aibase",
+  name: "news",
+  description: "AIbase daily AI industry news",
+  domain: "www.aibase.com",
+  strategy: Strategy.PUBLIC,
+  browser: true,
+  args: [{ name: "limit", type: "int", default: 20, description: "Max rows" }],
+  columns: ["rank", "title", "url"],
+  func: async (page, kwargs) => {
+    const p = page as IPage;
+    const limit = requireNewsLimit(kwargs.limit);
+    await p.goto(AIBASE_DAILY_URL, { waitUntil: "load", settleMs: 3000 });
+    const payload = (await p.evaluate(
+      buildExtractAibaseNewsJs(),
+    )) as BrowserExtractPayload;
+    return mapAibaseNewsPayload(payload, limit);
+  },
+});

package/src/adapters/amazon/new-releases.yaml

@@ -3,6 +3,7 @@ name: new-releases
 description: Amazon New Releases ranking
 domain: www.amazon.com
 strategy: intercept
+lint_listing_detail: skip
 browser: true
 
 args:

package/src/adapters/amazon/search.yaml

@@ -3,6 +3,7 @@ name: search
 description: Search Amazon products
 domain: www.amazon.com
 strategy: intercept
+lint_listing_detail: skip
 browser: true
 
 args:

package/src/adapters/apple-podcasts/search.yaml

@@ -4,6 +4,7 @@ description: Search Apple Podcasts
 domain: itunes.apple.com
 type: web-api
 strategy: public
+lint_listing_detail: skip
 
 args:
   query:

package/src/adapters/apple-podcasts/top.yaml

@@ -4,6 +4,7 @@ description: Top podcasts chart on Apple Podcasts
 domain: rss.marketingtools.apple.com
 type: web-api
 strategy: public
+lint_listing_detail: skip
 
 args:
   limit:

package/src/adapters/arxiv/papers.test.ts

@@ -0,0 +1,59 @@
+import { describe, expect, it } from "vitest";
+import {
+  decodeArxivEntities,
+  parseArxivEntries,
+  requireArxivAuthor,
+  requireArxivCategory,
+  requireArxivLimit,
+} from "./papers.js";
+
+describe("arxiv agent-facing author and recent commands", () => {
+  it("validates author, category, and limit inputs", () => {
+    expect(requireArxivAuthor(" Yoshua Bengio ")).toBe("Yoshua Bengio");
+    expect(() => requireArxivAuthor("")).toThrow("cannot be empty");
+    expect(requireArxivCategory("cs.CL")).toBe("cs.CL");
+    expect(requireArxivCategory("q-bio.NC")).toBe("q-bio.NC");
+    expect(() => requireArxivCategory("../cs.CL")).toThrow("Invalid arXiv");
+    expect(requireArxivLimit(undefined, 20)).toBe(20);
+    expect(requireArxivLimit("50", 20)).toBe(50);
+    expect(() => requireArxivLimit("51", 20)).toThrow("arxiv limit");
+  });
+
+  it("decodes entities and parses Atom entries", () => {
+    expect(decodeArxivEntities("A &amp; B &lt; C")).toBe("A & B < C");
+    expect(
+      parseArxivEntries(`
+        <feed>
+          <entry>
+            <id>http://arxiv.org/abs/1706.03762v7</id>
+            <title> Attention   Is All You Need </title>
+            <summary> We present   transformers. </summary>
+            <published>2017-06-12T17:57:34Z</published>
+            <updated>2023-08-02T00:00:00Z</updated>
+            <author><name>Alice &amp; Bob</name></author>
+            <author><name>Carol</name></author>
+            <arxiv:primary_category term="cs.CL" />
+            <category term="cs.CL" />
+            <category term="cs.LG" />
+            <arxiv:comment>15 pages</arxiv:comment>
+            <link title="pdf" href="https://arxiv.org/pdf/1706.03762" rel="related" />
+          </entry>
+        </feed>
+      `),
+    ).toEqual([
+      {
+        id: "1706.03762",
+        title: "Attention Is All You Need",
+        authors: "Alice & Bob, Carol",
+        abstract: "We present transformers.",
+        published: "2017-06-12",
+        updated: "2023-08-02",
+        primary_category: "cs.CL",
+        categories: "cs.CL, cs.LG",
+        comment: "15 pages",
+        pdf: "https://arxiv.org/pdf/1706.03762",
+        url: "https://arxiv.org/abs/1706.03762",
+      },
+    ]);
+  });
+});

package/src/adapters/arxiv/papers.ts

@@ -0,0 +1,226 @@
+/**
+ * @owner   src/adapters/arxiv/papers.ts
+ * @does    Register agent-facing arXiv author and recent category commands.
+ * @needs   export.arxiv.org Atom API, category validation, conservative XML parsing.
+ * @feeds   surface coverage ledger, scholarly search workflow, arXiv category monitoring.
+ * @breaks  arXiv Atom shape drift, weak category parsing, or silent empty feeds hide paper discovery failures.
+ */
+
+import { cli, Strategy } from "../../registry.js";
+
+const ARXIV_BASE = "https://export.arxiv.org/api/query";
+const CATEGORY_RE = /^[a-z]+(?:-[a-z]+)*(?:\.[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*)?$/;
+
+interface ArxivEntry {
+  id: string;
+  title: string;
+  authors: string;
+  abstract: string;
+  published: string;
+  updated: string;
+  primary_category: string;
+  categories: string;
+  comment: string;
+  pdf: string;
+  url: string;
+}
+
+export function requireArxivLimit(
+  value: unknown,
+  fallback: number,
+  max = 50,
+): number {
+  if (value === undefined || value === null || value === "") return fallback;
+  const n = Number(value);
+  if (!Number.isInteger(n) || n < 1 || n > max) {
+    throw new Error(`arxiv limit must be an integer in [1, ${max}].`);
+  }
+  return n;
+}
+
+export function requireArxivAuthor(value: unknown): string {
+  const author = String(value ?? "").trim();
+  if (!author) throw new Error("arxiv author cannot be empty.");
+  return author;
+}
+
+export function requireArxivCategory(value: unknown): string {
+  const category = String(value ?? "").trim();
+  if (!CATEGORY_RE.test(category)) {
+    throw new Error(`Invalid arXiv category "${String(value)}".`);
+  }
+  return category;
+}
+
+export function decodeArxivEntities(value: string): string {
+  return value
+    .replace(/&amp;/g, "&")
+    .replace(/&lt;/g, "<")
+    .replace(/&gt;/g, ">")
+    .replace(/&quot;/g, '"')
+    .replace(/&apos;/g, "'")
+    .replace(/&#39;/g, "'");
+}
+
+function extractFirst(xml: string, tag: string): string {
+  const match = xml.match(new RegExp(`<${tag}[^>]*>([\\s\\S]*?)<\\/${tag}>`));
+  return match ? match[1].trim() : "";
+}
+
+function extractAll(xml: string, tag: string): string[] {
+  const out: string[] = [];
+  const re = new RegExp(`<${tag}[^>]*>([\\s\\S]*?)<\\/${tag}>`, "g");
+  let match: RegExpExecArray | null;
+  while ((match = re.exec(xml)) !== null) out.push(match[1].trim());
+  return out;
+}
+
+function extractAttr(xml: string, tag: string, attr: string): string {
+  const match = xml.match(new RegExp(`<${tag}\\b[^>]*?\\b${attr}="([^"]*)"`));
+  return match ? match[1] : "";
+}
+
+function extractAllAttr(xml: string, tag: string, attr: string): string[] {
+  const out: string[] = [];
+  const re = new RegExp(`<${tag}\\b[^>]*?\\b${attr}="([^"]*)"`, "g");
+  let match: RegExpExecArray | null;
+  while ((match = re.exec(xml)) !== null) out.push(match[1]);
+  return out;
+}
+
+function findLinkHref(xml: string, rel: string): string {
+  const re = /<link\b([^>]*)\/?>/g;
+  let match: RegExpExecArray | null;
+  while ((match = re.exec(xml)) !== null) {
+    const attrs = match[1];
+    if (!new RegExp(`\\brel="${rel}"`).test(attrs)) continue;
+    const href = attrs.match(/\bhref="([^"]*)"/);
+    if (href) return href[1];
+  }
+  return "";
+}
+
+export function parseArxivEntries(xml: string): ArxivEntry[] {
+  const out: ArxivEntry[] = [];
+  const re = /<entry>([\s\S]*?)<\/entry>/g;
+  let match: RegExpExecArray | null;
+  while ((match = re.exec(xml)) !== null) {
+    const entry = match[1];
+    const rawId = extractFirst(entry, "id");
+    const id = rawId
+      .replace(/^https?:\/\/arxiv\.org\/abs\//, "")
+      .replace(/v\d+$/, "");
+    const title = decodeArxivEntities(
+      extractFirst(entry, "title").replace(/\s+/g, " "),
+    ).trim();
+    out.push({
+      id,
+      title,
+      authors: decodeArxivEntities(extractAll(entry, "name").join(", ")),
+      abstract: decodeArxivEntities(
+        extractFirst(entry, "summary").replace(/\s+/g, " "),
+      ).trim(),
+      published: extractFirst(entry, "published").slice(0, 10),
+      updated: extractFirst(entry, "updated").slice(0, 10),
+      primary_category: extractAttr(entry, "arxiv:primary_category", "term"),
+      categories: extractAllAttr(entry, "category", "term").join(", "),
+      comment: decodeArxivEntities(
+        extractFirst(entry, "arxiv:comment").replace(/\s+/g, " "),
+      ).trim(),
+      pdf: findLinkHref(entry, "related") || `https://arxiv.org/pdf/${id}`,
+      url: `https://arxiv.org/abs/${id}`,
+    });
+  }
+  return out;
+}
+
+async function fetchArxiv(params: URLSearchParams): Promise<string> {
+  const response = await fetch(`${ARXIV_BASE}?${params.toString()}`, {
+    headers: {
+      "User-Agent": "unicli-arxiv/1.0 (https://github.com/olo-dot-io/Uni-CLI)",
+      Accept: "application/atom+xml, application/xml, text/xml",
+    },
+  });
+  if (!response.ok)
+    throw new Error(`arXiv API returned HTTP ${response.status}.`);
+  return response.text();
+}
+
+function compactRows(entries: ArxivEntry[]): Array<Record<string, unknown>> {
+  return entries.map((entry) => ({
+    id: entry.id,
+    title: entry.title,
+    authors: entry.authors,
+    published: entry.published,
+    primary_category: entry.primary_category,
+    url: entry.url,
+  }));
+}
+
+cli({
+  site: "arxiv",
+  name: "author",
+  description: "List arXiv papers by a given author",
+  domain: "export.arxiv.org",
+  strategy: Strategy.PUBLIC,
+  args: [
+    {
+      name: "author",
+      type: "str",
+      required: true,
+      positional: true,
+      description: "Author name",
+    },
+    { name: "limit", type: "int", default: 20, description: "Max papers" },
+  ],
+  columns: ["id", "title", "authors", "published", "primary_category", "url"],
+  func: async (_page, kwargs) => {
+    const author = requireArxivAuthor(kwargs.author);
+    const limit = requireArxivLimit(kwargs.limit, 20);
+    const params = new URLSearchParams({
+      search_query: `au:"${author}"`,
+      max_results: String(limit),
+      sortBy: "submittedDate",
+      sortOrder: "descending",
+    });
+    const rows = compactRows(parseArxivEntries(await fetchArxiv(params)));
+    if (rows.length === 0) {
+      throw new Error(`No arXiv papers found for author "${author}".`);
+    }
+    return rows;
+  },
+});
+
+cli({
+  site: "arxiv",
+  name: "recent",
+  description: "List recent arXiv submissions in a category",
+  domain: "export.arxiv.org",
+  strategy: Strategy.PUBLIC,
+  args: [
+    {
+      name: "category",
+      type: "str",
+      required: true,
+      positional: true,
+      description: "arXiv category",
+    },
+    { name: "limit", type: "int", default: 10, description: "Max papers" },
+  ],
+  columns: ["id", "title", "authors", "published", "primary_category", "url"],
+  func: async (_page, kwargs) => {
+    const category = requireArxivCategory(kwargs.category);
+    const limit = requireArxivLimit(kwargs.limit, 10);
+    const params = new URLSearchParams({
+      search_query: `cat:${category}`,
+      max_results: String(limit),
+      sortBy: "submittedDate",
+      sortOrder: "descending",
+    });
+    const rows = compactRows(parseArxivEntries(await fetchArxiv(params)));
+    if (rows.length === 0) {
+      throw new Error(`No recent arXiv papers found in ${category}.`);
+    }
+    return rows;
+  },
+});

package/src/adapters/arxiv/search.yaml

@@ -4,6 +4,7 @@ description: Search arXiv papers
 domain: export.arxiv.org
 type: web-api
 strategy: public
+lint_listing_detail: skip
 
 args:
   query: