@zenalexa/unicli 0.220.1 → 0.221.1

package/src/adapters/kipris/get.yaml

@@ -0,0 +1,69 @@
+# @owner       src::adapters::kipris::get
+# @does        Fetch a single Korean patent bibliographic record from KIPRIS Plus REST by application number.
+# @needs       src/engine/steps/fetch.ts, src/engine/steps/select-xml.ts, src/engine/steps/map.ts
+# @feeds       src/commands/patent.ts
+# @breaks      throws PipelineError on missing key, 4xx, 5xx
+# @invariants  output row conforms to PatentRecord
+# @side-effects reads env KIPRIS_ACCESS_KEY; HTTPS egress to plus.kipris.or.kr
+# @perf        single request
+# @concurrency safe
+# @test        none yet
+# @stability   stable
+# @since       2026-05-18
+# @verification blocked-by-key
+site: kipris
+name: get
+description: Fetch a KIPRIS biblio record by application number
+domain: plus.kipris.or.kr
+type: web-api
+strategy: public
+lint_listing_detail: skip
+
+args:
+  application_number:
+    type: str
+    required: true
+    positional: true
+    description: Korean application number (e.g. 1020230012345)
+
+pipeline:
+  - fetch:
+      url: "https://plus.kipris.or.kr/openapi/rest/patUtiModInfoSearchSevice/getBibliographyDetailInfoSearch"
+      method: GET
+      headers:
+        Accept: application/xml
+      params:
+        applicationNumber: "${{ args.application_number }}"
+        accessKey: "${{ env.KIPRIS_ACCESS_KEY || '' }}"
+
+  - select-xml:
+      xpath: "//biblioSummaryInfo"
+      unwrap_single: true
+
+  - map:
+      publication_number: "${{ 'KR-' + (item.openNumber || args.application_number || '') + '-' + (item.openType || '') }}"
+      application_number: "${{ item.applicationNumber || args.application_number || '' }}"
+      title: "${{ item.inventionTitle || '' }}"
+      abstract: "${{ item.astrtCont || '' }}"
+      kind_code: "${{ item.openType || '' }}"
+      filing_date: "${{ item.applicationDate || '' }}"
+      publication_date: "${{ item.openDate || '' }}"
+      grant_date: "${{ item.registerDate || '' }}"
+      priority_date: "${{ item.priorityDate || '' }}"
+      legal_status: "${{ item.registerStatus || '' }}"
+      inventors: "${{ JSON.stringify(item.inventor ? [{ name: item.inventor, country: 'KR' }] : []) }}"
+      assignees: "${{ JSON.stringify(item.applicant ? [{ name: item.applicant, country: 'KR' }] : []) }}"
+      classifications: "${{ JSON.stringify((function(){ var c=item.ipcNumber; if(!c) return []; var arr = String(c).split('|').map(s => s.trim()).filter(s => s); return arr.map(code => ({ scheme: 'ipc', code: code })); })()) }}"
+      source_adapter: kipris
+      source_url: "${{ 'https://kpat.kipris.or.kr/kpat/biblioa.do?method=biblioFrame&applno=' + (args.application_number || '') }}"
+      retrieved_at: ""
+
+columns: [publication_number, title, filing_date, publication_date]
+
+# schema-v2 metadata
+capabilities: ["http.fetch", "patent.get"]
+minimum_capability: http.fetch
+trust: public
+confidentiality: public
+quarantine: false
+schema_version: v2

package/src/adapters/kipris/legal-status.yaml

@@ -0,0 +1,58 @@
+# @owner       src::adapters::kipris::legal-status
+# @does        Fetch Korean patent legal-status (right-trans/registration events) from KIPRIS Plus REST.
+# @needs       src/engine/steps/fetch.ts, src/engine/steps/select-xml.ts, src/engine/steps/map.ts
+# @feeds       src/commands/patent.ts
+# @breaks      throws PipelineError on missing key, 4xx, 5xx
+# @invariants  output rows carry legal_status from rightTransRegInfo
+# @side-effects reads env KIPRIS_ACCESS_KEY; HTTPS egress
+# @perf        single request
+# @concurrency safe
+# @test        none yet
+# @stability   stable
+# @since       2026-05-18
+# @verification blocked-by-key
+site: kipris
+name: legal-status
+description: KIPRIS right-trans / registration events for a Korean application
+domain: plus.kipris.or.kr
+type: web-api
+strategy: public
+lint_listing_detail: skip
+
+args:
+  application_number:
+    type: str
+    required: true
+    positional: true
+    description: Korean application number
+
+pipeline:
+  - fetch:
+      url: "https://plus.kipris.or.kr/openapi/rest/patUtiModInfoSearchSevice/getRightTransRegInfoSearchInfo"
+      method: GET
+      headers:
+        Accept: application/xml
+      params:
+        applicationNumber: "${{ args.application_number }}"
+        accessKey: "${{ env.KIPRIS_ACCESS_KEY || '' }}"
+
+  - select-xml:
+      xpath: "//item"
+
+  - map:
+      publication_number: "${{ 'KR-' + (args.application_number || '') }}"
+      application_number: "${{ args.application_number }}"
+      legal_status: "${{ (item.rightCode || '') + ' ' + (item.contents || '') }}"
+      source_adapter: kipris
+      source_url: "${{ 'https://kpat.kipris.or.kr/kpat/biblioa.do?method=biblioFrame&applno=' + (args.application_number || '') }}"
+      retrieved_at: ""
+
+columns: [publication_number, legal_status]
+
+# schema-v2 metadata
+capabilities: ["http.fetch", "patent.legal-status"]
+minimum_capability: http.fetch
+trust: public
+confidentiality: public
+quarantine: false
+schema_version: v2

package/src/adapters/kipris/search.yaml

@@ -0,0 +1,79 @@
+# @owner       src::adapters::kipris::search
+# @does        Search KIPRIS Plus REST patent search endpoint for Korean patents/utility models.
+# @needs       src/engine/steps/fetch.ts, src/engine/steps/select-xml.ts, src/engine/steps/map.ts, src/engine/steps/limit.ts
+# @feeds       src/commands/patent.ts
+# @breaks      throws PipelineError on missing/invalid accessKey, 4xx, 5xx
+# @invariants  output rows conform to PatentRecord; publication_number is `KR-<doc>-<kind>`
+# @side-effects reads env KIPRIS_ACCESS_KEY; HTTPS egress to plus.kipris.or.kr
+# @perf        single request
+# @concurrency safe
+# @test        none yet
+# @stability   stable
+# @since       2026-05-18
+# @verification blocked-by-key — needs KIPRIS_ACCESS_KEY (registration at plus.kipris.or.kr)
+site: kipris
+name: search
+description: Search KIPRIS Plus REST for Korean patents/utility models
+domain: plus.kipris.or.kr
+type: web-api
+strategy: public
+lint_listing_detail: skip
+
+args:
+  query:
+    type: str
+    required: true
+    positional: true
+    description: Free-text query (KIPRIS `word` param)
+  limit:
+    type: int
+    default: 25
+    description: Maximum results (numOfRows)
+
+pipeline:
+  - fetch:
+      url: "https://plus.kipris.or.kr/openapi/rest/patUtiModInfoSearchSevice/getWordSearch"
+      method: GET
+      headers:
+        Accept: application/xml
+      params:
+        word: "${{ args.query }}"
+        numOfRows: "${{ args.limit }}"
+        pageNo: "1"
+        accessKey: "${{ env.KIPRIS_ACCESS_KEY || '' }}"
+
+  - select-xml:
+      xpath: "//item"
+
+  # KIPRIS Plus XML preserves the native Korean script for title / abstract.
+  - map:
+      publication_number: "${{ 'KR-' + (item.openNumber || item.applicationNumber || '') + '-' + (item.openType || '') }}"
+      application_number: "${{ item.applicationNumber || '' }}"
+      title: "${{ item.inventionTitle || '' }}"
+      abstract: "${{ item.astrtCont || '' }}"
+      kind_code: "${{ item.openType || '' }}"
+      filing_date: "${{ item.applicationDate || '' }}"
+      publication_date: "${{ item.openDate || '' }}"
+      grant_date: "${{ item.registerDate || '' }}"
+      priority_date: "${{ item.priorityNumber ? (item.priorityDate || '') : '' }}"
+      legal_status: "${{ item.registerStatus || '' }}"
+      # KIPRIS exposes inventor / applicant as a single concatenated string;
+      # preserve the format the office returns and treat it as one party.
+      inventors: "${{ JSON.stringify(item.inventor ? [{ name: item.inventor, country: 'KR' }] : []) }}"
+      assignees: "${{ JSON.stringify(item.applicant ? [{ name: item.applicant, country: 'KR' }] : []) }}"
+      classifications: "${{ JSON.stringify((function(){ var c=item.ipcNumber; if(!c) return []; var arr = String(c).split('|').map(s => s.trim()).filter(s => s); return arr.map(code => ({ scheme: 'ipc', code: code })); })()) }}"
+      source_adapter: kipris
+      source_url: "${{ 'https://kpat.kipris.or.kr/kpat/biblioa.do?method=biblioFrame&applno=' + (item.applicationNumber || '') }}"
+      retrieved_at: ""
+
+  - limit: "${{ args.limit }}"
+
+columns: [publication_number, title, filing_date, publication_date]
+
+# schema-v2 metadata
+capabilities: ["http.fetch", "patent.search"]
+minimum_capability: http.fetch
+trust: public
+confidentiality: public
+quarantine: false
+schema_version: v2

package/src/adapters/lens/get.yaml

@@ -0,0 +1,64 @@
+# Lens.org single-record fetch.
+#
+# verification_status: blocked-by-subscription
+#
+# Lens "patent/search" is the only retrieval endpoint they expose publicly;
+# get is implemented as a one-record query by `doc_key` (publication_number).
+site: lens
+name: get
+description: Retrieve a single Lens.org patent record by publication number
+domain: api.lens.org
+type: web-api
+strategy: header
+
+args:
+  publication_number:
+    type: str
+    required: true
+    positional: true
+
+pipeline:
+  - fetch:
+      url: https://api.lens.org/patent/search
+      method: POST
+      headers:
+        Authorization: "Bearer ${{ env.LENS_API_TOKEN || '' }}"
+        Content-Type: application/json
+      body:
+        query:
+          term:
+            doc_key: "${{ args.publication_number }}"
+        size: 1
+
+  - select: data
+
+  - map:
+      publication_number: "${{ item.doc_key || item.lens_id }}"
+      title: "${{ item.biblio ? (item.biblio.invention_title ? item.biblio.invention_title[0].text : '') : '' }}"
+      abstract: "${{ item.abstract ? (Array.isArray(item.abstract) ? (item.abstract[0] && item.abstract[0].text) : item.abstract) : '' }}"
+      kind_code: "${{ item.biblio && item.biblio.publication_reference ? (item.biblio.publication_reference.kind || '') : '' }}"
+      filing_date: "${{ item.biblio ? (item.biblio.application_reference ? item.biblio.application_reference.date : '') : '' }}"
+      publication_date: "${{ item.date_published || '' }}"
+      priority_date: "${{ item.biblio && item.biblio.priority_claims && item.biblio.priority_claims.claims ? item.biblio.priority_claims.claims[0].date : '' }}"
+      family_id: "${{ item.families ? item.families.simple_family.family_id : '' }}"
+      inventors: "${{ JSON.stringify((function(){ var p=item.biblio && item.biblio.parties; if(!p || !p.inventors) return []; return p.inventors.map(i => ({ name: i.extracted_name ? (i.extracted_name.value || '') : (i.name || ''), country: i.residence || undefined })).filter(x => x.name); })()) }}"
+      assignees: "${{ JSON.stringify((function(){ var p=item.biblio && item.biblio.parties; if(!p || !p.applicants) return []; return p.applicants.map(a => ({ name: a.extracted_name ? (a.extracted_name.value || '') : (a.name || ''), country: a.residence || undefined })).filter(x => x.name); })()) }}"
+      classifications: "${{ JSON.stringify((function(){ var c = item.biblio && item.biblio.classifications_cpc && item.biblio.classifications_cpc.classifications; var out = []; if(c){ for (var i=0;i<c.length;i++) out.push({ scheme: 'cpc', code: c[i].symbol || '' }); } var ipc = item.biblio && item.biblio.classifications_ipcr && item.biblio.classifications_ipcr.classifications; if(ipc){ for (var j=0;j<ipc.length;j++) out.push({ scheme: 'ipc', code: ipc[j].symbol || '' }); } return out.filter(x => x.code); })()) }}"
+      cited_by_count: "${{ item.biblio && item.biblio.cited_by ? (item.biblio.cited_by.patent_count || 0) : '' }}"
+      cites_count: "${{ item.biblio && item.biblio.references_cited && item.biblio.references_cited.patent_count !== undefined ? item.biblio.references_cited.patent_count : '' }}"
+      claims_count: "${{ item.claims_count !== undefined ? item.claims_count : '' }}"
+      legal_status: "${{ item.legal_status ? (item.legal_status.patent_status || '') : '' }}"
+      source_url: "https://www.lens.org/lens/patent/${{ item.lens_id }}"
+      source_adapter: lens
+      retrieved_at: "${{ now }}"
+
+  - limit: 1
+
+columns: [publication_number, title, publication_date]
+
+capabilities: ["http.fetch", "patent.get"]
+minimum_capability: http.fetch
+trust: public
+confidentiality: public
+quarantine: false
+schema_version: v2

package/src/adapters/lens/search.yaml

@@ -0,0 +1,82 @@
+# Lens.org Patent API — POST JSON DSL search.
+#
+# verification_status: blocked-by-subscription
+#
+# Lens.org Patents is a free-to-search, paid-to-API service from Cambia.
+# Institutional / commercial users get tokens via the Lens Toolkit subscription
+# (https://www.lens.org/lens/user/subscriptions). The token is static once
+# issued; no refresh dance, no rotation — set $LENS_API_TOKEN and the adapter
+# works. Until the env var is present, every command emits a structured
+# blocked-by-key envelope so agents can repair by guiding the user through
+# subscription setup rather than retrying the API.
+site: lens
+name: search
+description: Search Lens.org's combined patent corpus via the Scholarly Works DSL
+domain: api.lens.org
+type: web-api
+strategy: header
+
+args:
+  query:
+    type: str
+    required: true
+    positional: true
+    description: Free-text query — mapped to the Lens DSL `query_string`
+  limit:
+    type: int
+    default: 20
+    description: Maximum records returned (Lens caps at 1000)
+  date_from:
+    type: str
+    default: ""
+    description: ISO date — minimum publication date
+
+pipeline:
+  - fetch:
+      url: https://api.lens.org/patent/search
+      method: POST
+      headers:
+        Authorization: "Bearer ${{ env.LENS_API_TOKEN || '' }}"
+        Content-Type: application/json
+      body:
+        query:
+          query_string:
+            query: "${{ args.query }}"
+        size: "${{ args.limit }}"
+        from: 0
+
+  - select: data
+
+  # Lens.org JSON `biblio` is the rich envelope. `_score` is Lens's
+  # relevance score, naturally a float; pass through as relevance_score.
+  - map:
+      publication_number: "${{ item.doc_key || item.lens_id }}"
+      title: "${{ item.biblio ? (item.biblio.invention_title ? item.biblio.invention_title[0].text : '') : '' }}"
+      abstract: "${{ item.abstract ? (Array.isArray(item.abstract) ? (item.abstract[0] && item.abstract[0].text) : item.abstract) : '' }}"
+      publication_date: "${{ item.date_published || '' }}"
+      filing_date: "${{ item.biblio ? (item.biblio.application_reference ? item.biblio.application_reference.date : '') : '' }}"
+      priority_date: "${{ item.biblio && item.biblio.priority_claims && item.biblio.priority_claims.claims ? item.biblio.priority_claims.claims[0].date : '' }}"
+      kind_code: "${{ item.biblio && item.biblio.publication_reference ? (item.biblio.publication_reference.kind || '') : '' }}"
+      family_id: "${{ item.families ? item.families.simple_family.family_id : '' }}"
+      inventors: "${{ JSON.stringify((function(){ var p=item.biblio && item.biblio.parties; if(!p || !p.inventors) return []; return p.inventors.map(i => ({ name: i.extracted_name ? (i.extracted_name.value || '') : (i.name || ''), country: i.residence || undefined })).filter(x => x.name); })()) }}"
+      assignees: "${{ JSON.stringify((function(){ var p=item.biblio && item.biblio.parties; if(!p || !p.applicants) return []; return p.applicants.map(a => ({ name: a.extracted_name ? (a.extracted_name.value || '') : (a.name || ''), country: a.residence || undefined })).filter(x => x.name); })()) }}"
+      classifications: "${{ JSON.stringify((function(){ var c = item.biblio && item.biblio.classifications_cpc && item.biblio.classifications_cpc.classifications; var out = []; if(c){ for (var i=0;i<c.length;i++) out.push({ scheme: 'cpc', code: c[i].symbol || '' }); } var ipc = item.biblio && item.biblio.classifications_ipcr && item.biblio.classifications_ipcr.classifications; if(ipc){ for (var j=0;j<ipc.length;j++) out.push({ scheme: 'ipc', code: ipc[j].symbol || '' }); } return out.filter(x => x.code); })()) }}"
+      cited_by_count: "${{ item.biblio && item.biblio.cited_by ? (item.biblio.cited_by.patent_count || 0) : '' }}"
+      cites_count: "${{ item.biblio && item.biblio.references_cited && item.biblio.references_cited.patent_count !== undefined ? item.biblio.references_cited.patent_count : '' }}"
+      claims_count: "${{ item.claims_count !== undefined ? item.claims_count : '' }}"
+      relevance_score: "${{ item._score !== undefined ? item._score : '' }}"
+      source_url: "https://www.lens.org/lens/patent/${{ item.lens_id }}"
+      source_adapter: lens
+      retrieved_at: "${{ now }}"
+
+  - limit: ${{ args.limit }}
+
+columns: [publication_number, title, publication_date, source_adapter]
+
+# schema-v2 metadata
+capabilities: ["http.fetch", "patent.search"]
+minimum_capability: http.fetch
+trust: public
+confidentiality: public
+quarantine: false
+schema_version: v2

package/src/adapters/mastodon/statuses.test.ts

@@ -0,0 +1,82 @@
+import { describe, expect, it } from "vitest";
+
+import { mapMastodonStatusRows, normalizeMastodonAccount } from "./statuses.js";
+
+describe("mastodon statuses adapter helpers", () => {
+  it("normalizes account handles and instance overrides", () => {
+    expect(normalizeMastodonAccount("gargron@mastodon.social")).toEqual({
+      acct: "gargron",
+      instance: "mastodon.social",
+    });
+
+    expect(normalizeMastodonAccount("@gargron", "mastodon.social")).toEqual({
+      acct: "gargron",
+      instance: "mastodon.social",
+    });
+  });
+
+  it("maps API statuses into stable social rows", () => {
+    expect(
+      mapMastodonStatusRows(
+        [
+          {
+            created_at: "2026-05-14T10:00:00.000Z",
+            content: "<p>Hello <strong>fediverse</strong></p>",
+            url: "https://mastodon.social/@gargron/1",
+            reblogs_count: 2,
+            favourites_count: 3,
+            replies_count: 4,
+            account: { acct: "gargron", display_name: "Gargron" },
+          },
+        ],
+        10,
+      ),
+    ).toEqual([
+      {
+        rank: 1,
+        author: "Gargron",
+        handle: "@gargron",
+        content: "Hello fediverse",
+        reblogs: 2,
+        favorites: 3,
+        replies: 4,
+        url: "https://mastodon.social/@gargron/1",
+        date: "2026-05-14T10:00:00.000Z",
+      },
+    ]);
+  });
+
+  it("drops empty activity rows and decodes common HTML entities", () => {
+    expect(
+      mapMastodonStatusRows(
+        [
+          {
+            created_at: "2026-05-14T10:00:00.000Z",
+            content: "",
+            url: "https://mastodon.social/users/Gargron/statuses/1/activity",
+            account: { acct: "Gargron", display_name: "Eugen Rochko" },
+          },
+          {
+            created_at: "2026-05-14T11:00:00.000Z",
+            content: "<p>Don&#39;t escape &amp; ship</p>",
+            url: "https://mastodon.social/@Gargron/2",
+            account: { acct: "Gargron", display_name: "Eugen Rochko" },
+          },
+        ],
+        10,
+      ),
+    ).toEqual([
+      {
+        rank: 1,
+        author: "Eugen Rochko",
+        handle: "@Gargron",
+        content: "Don't escape & ship",
+        reblogs: 0,
+        favorites: 0,
+        replies: 0,
+        url: "https://mastodon.social/@Gargron/2",
+        date: "2026-05-14T11:00:00.000Z",
+      },
+    ]);
+  });
+});

package/src/adapters/mastodon/statuses.ts

@@ -0,0 +1,208 @@
+/**
+ * @owner   Mastodon user status adapter.
+ * @does    Register a public read command for recent statuses by account handle.
+ * @needs   Mastodon-compatible public API endpoints for account lookup and statuses.
+ * @feeds   Social research workflows and social capability coverage.
+ * @breaks  Instance API drift, blocked public egress, or accounts hidden from public lookup.
+ */
+
+import { USER_AGENT } from "../../constants.js";
+import { cli, Strategy } from "../../registry.js";
+
+interface MastodonAccount {
+  id?: unknown;
+  acct?: unknown;
+  display_name?: unknown;
+}
+
+interface MastodonStatus {
+  created_at?: unknown;
+  content?: unknown;
+  url?: unknown;
+  reblogs_count?: unknown;
+  favourites_count?: unknown;
+  replies_count?: unknown;
+  account?: MastodonAccount;
+}
+
+export interface MastodonAccountRef {
+  acct: string;
+  instance: string;
+}
+
+export interface MastodonStatusRow {
+  rank: number;
+  author: string;
+  handle: string;
+  content: string;
+  reblogs: number;
+  favorites: number;
+  replies: number;
+  url: string;
+  date: string;
+}
+
+function cleanString(value: unknown): string {
+  return typeof value === "string" ? value.trim() : "";
+}
+
+function numberValue(value: unknown): number {
+  return typeof value === "number" && Number.isFinite(value) ? value : 0;
+}
+
+function stripHtml(value: unknown): string {
+  return cleanString(value)
+    .replace(/<[^>]*>/g, "")
+    .replace(/&nbsp;/g, " ")
+    .replace(/&amp;/g, "&")
+    .replace(/&lt;/g, "<")
+    .replace(/&gt;/g, ">")
+    .replace(/&quot;/g, '"')
+    .replace(/&#39;/g, "'")
+    .replace(/\s+/g, " ")
+    .trim();
+}
+
+export function normalizeMastodonAccount(
+  input: string,
+  instanceOverride = "mastodon.social",
+): MastodonAccountRef {
+  const trimmed = input.trim().replace(/^@/, "");
+  if (!trimmed) throw new Error("Mastodon account cannot be empty");
+  const parts = trimmed.split("@").filter(Boolean);
+  if (parts.length > 2) {
+    throw new Error(`Invalid Mastodon account: ${input}`);
+  }
+  const acct = parts[0];
+  const instance = parts[1] ?? instanceOverride.trim();
+  if (!acct || !instance) {
+    throw new Error(`Invalid Mastodon account: ${input}`);
+  }
+  return { acct, instance };
+}
+
+export function mapMastodonStatusRows(
+  statuses: MastodonStatus[],
+  limit: number,
+): MastodonStatusRow[] {
+  const rows: Omit<MastodonStatusRow, "rank">[] = [];
+  for (const status of statuses) {
+    const content = stripHtml(status.content).slice(0, 500);
+    if (!content) continue;
+    const account = status.account ?? {};
+    const handle = cleanString(account.acct);
+    rows.push({
+      author: cleanString(account.display_name) || handle,
+      handle: handle ? `@${handle}` : "",
+      content,
+      reblogs: numberValue(status.reblogs_count),
+      favorites: numberValue(status.favourites_count),
+      replies: numberValue(status.replies_count),
+      url: cleanString(status.url),
+      date: cleanString(status.created_at),
+    });
+  }
+  return rows.slice(0, limit).map((row, index) => ({
+    rank: index + 1,
+    ...row,
+  }));
+}
+
+function parseLimit(value: unknown): number {
+  const limit = Number(value ?? 20);
+  if (!Number.isInteger(limit) || limit < 1 || limit > 40) {
+    throw new Error(
+      `--limit must be an integer between 1 and 40, got ${value}`,
+    );
+  }
+  return limit;
+}
+
+async function fetchMastodonJson(url: string): Promise<unknown> {
+  const response = await fetch(url, {
+    headers: {
+      Accept: "application/json",
+      "User-Agent": USER_AGENT,
+    },
+  });
+  if (!response.ok) {
+    const preview = (await response.text()).slice(0, 200);
+    throw new Error(`Mastodon HTTP ${response.status} from ${url}: ${preview}`);
+  }
+  return response.json() as Promise<unknown>;
+}
+
+function requireAccountId(account: unknown): string {
+  if (!account || typeof account !== "object") {
+    throw new Error("Mastodon account lookup returned a non-object response");
+  }
+  const id = cleanString((account as MastodonAccount).id);
+  if (!id) throw new Error("Mastodon account lookup did not return an id");
+  return id;
+}
+
+cli({
+  site: "mastodon",
+  name: "statuses",
+  description: "Get recent public statuses from a Mastodon account",
+  domain: "mastodon.social",
+  strategy: Strategy.PUBLIC,
+  args: [
+    {
+      name: "account",
+      required: true,
+      positional: true,
+      description: "Account handle, e.g. gargron@mastodon.social",
+    },
+    {
+      name: "instance",
+      type: "str",
+      default: "mastodon.social",
+      description: "Mastodon instance domain used when account omits one",
+    },
+    {
+      name: "limit",
+      type: "int",
+      default: 20,
+      description: "Number of statuses, 1-40",
+    },
+  ],
+  columns: [
+    "rank",
+    "author",
+    "handle",
+    "content",
+    "reblogs",
+    "favorites",
+    "replies",
+    "url",
+    "date",
+  ],
+  socialCapabilities: ["read", "user_content", "reactions"],
+  func: async (_page, kwargs) => {
+    const limit = parseLimit(kwargs.limit);
+    const account = normalizeMastodonAccount(
+      String(kwargs.account ?? ""),
+      String(kwargs.instance ?? "mastodon.social"),
+    );
+    const origin = `https://${account.instance}`;
+    const lookupUrl = new URL("/api/v1/accounts/lookup", origin);
+    lookupUrl.searchParams.set("acct", account.acct);
+    const lookup = await fetchMastodonJson(lookupUrl.toString());
+    const accountId = requireAccountId(lookup);
+    const statusesUrl = new URL(
+      `/api/v1/accounts/${encodeURIComponent(accountId)}/statuses`,
+      origin,
+    );
+    statusesUrl.searchParams.set("limit", String(limit));
+    statusesUrl.searchParams.set("exclude_reblogs", "false");
+    statusesUrl.searchParams.set("exclude_replies", "false");
+    const statuses = await fetchMastodonJson(statusesUrl.toString());
+    if (!Array.isArray(statuses)) {
+      throw new Error(
+        "Mastodon statuses endpoint returned a non-array response",
+      );
+    }
+    return mapMastodonStatusRows(statuses as MastodonStatus[], limit);
+  },
+});