@zenalexa/unicli 0.220.0 → 0.221.0

package/dist/adapters/kitsu/web.js

@@ -0,0 +1,97 @@
+/**
+ * @owner   src/adapters/kitsu/web.ts
+ * @does    Register Kitsu public anime and manga search commands.
+ * @needs   Kitsu JSON:API text filters and public media pages.
+ * @feeds   ACG title discovery with community rating and subtype metadata.
+ * @breaks  Kitsu JSON:API field changes or service availability can block lookup.
+ */
+import { USER_AGENT } from "../../constants.js";
+import { cli, Strategy } from "../../registry.js";
+const API = "https://kitsu.io/api/edge";
+function str(value) {
+    return value === undefined || value === null ? "" : String(value);
+}
+function required(value) {
+    const text = str(value).trim();
+    if (!text)
+        throw new Error("kitsu query cannot be empty.");
+    return text;
+}
+function requireLimit(value) {
+    if (value === undefined || value === null || value === "")
+        return 10;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 1 || n > 20) {
+        throw new Error("kitsu limit must be an integer in [1, 20].");
+    }
+    return n;
+}
+export function mapKitsuMedia(rows) {
+    return rows.map((row, index) => {
+        const item = row;
+        const attrs = item.attributes ?? {};
+        const titles = attrs.titles ?? {};
+        return {
+            rank: index + 1,
+            id: item.id,
+            type: item.type,
+            title: str(attrs.canonicalTitle || titles.en || titles.en_jp || titles.ja_jp),
+            subtype: str(attrs.subtype),
+            status: str(attrs.status),
+            start_date: str(attrs.startDate),
+            average_rating: str(attrs.averageRating),
+            popularity_rank: attrs.popularityRank ?? null,
+            synopsis: str(attrs.synopsis).slice(0, 500),
+            url: `https://kitsu.io/${item.type}/${attrs.slug || item.id}`,
+        };
+    });
+}
+async function search(kind, kwargs) {
+    const query = required(kwargs.query);
+    const cap = requireLimit(kwargs.limit);
+    const url = new URL(`${API}/${kind}`);
+    url.searchParams.set("filter[text]", query);
+    url.searchParams.set("page[limit]", String(cap));
+    const response = await fetch(url, {
+        headers: {
+            Accept: "application/vnd.api+json",
+            "User-Agent": USER_AGENT,
+        },
+    });
+    if (!response.ok)
+        throw new Error(`kitsu request failed with HTTP ${response.status}.`);
+    const data = (await response.json());
+    const rows = mapKitsuMedia(data.data ?? []);
+    if (rows.length === 0)
+        throw new Error(`No Kitsu ${kind} found for "${query}".`);
+    return rows;
+}
+const ARGS = [
+    { name: "query", type: "str", required: true, positional: true },
+    { name: "limit", type: "int", default: 10 },
+];
+const COLUMNS = [
+    "rank",
+    "id",
+    "type",
+    "title",
+    "subtype",
+    "status",
+    "start_date",
+    "average_rating",
+    "url",
+];
+for (const name of ["anime", "manga"]) {
+    cli({
+        site: "kitsu",
+        name,
+        description: `Search Kitsu ${name} by Japanese title, romaji, alias, or keyword`,
+        domain: "kitsu.io",
+        strategy: Strategy.PUBLIC,
+        browser: false,
+        args: ARGS,
+        columns: COLUMNS,
+        func: async (_page, kwargs) => search(name, kwargs),
+    });
+}
+//# sourceMappingURL=web.js.map

package/dist/adapters/kitsu/web.js.map

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

package/dist/adapters/mangadex/web.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @owner   src/adapters/mangadex/web.ts
+ * @does    Register MangaDex public manga and author search commands.
+ * @needs   MangaDex public API and relationship include semantics.
+ * @feeds   Manga/doujin-adjacent title and creator discovery.
+ * @breaks  MangaDex API schema or public rate limits can block lookup.
+ */
+export declare function mapMangaDexManga(rows: unknown[]): Record<string, unknown>[];
+export declare function mapMangaDexAuthors(rows: unknown[]): Record<string, unknown>[];
+//# sourceMappingURL=web.d.ts.map

package/dist/adapters/mangadex/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../../src/adapters/mangadex/web.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA8FH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAiB3E;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAe7E"}

package/dist/adapters/mangadex/web.js

@@ -0,0 +1,188 @@
+/**
+ * @owner   src/adapters/mangadex/web.ts
+ * @does    Register MangaDex public manga and author search commands.
+ * @needs   MangaDex public API and relationship include semantics.
+ * @feeds   Manga/doujin-adjacent title and creator discovery.
+ * @breaks  MangaDex API schema or public rate limits can block lookup.
+ */
+import { USER_AGENT } from "../../constants.js";
+import { cli, Strategy } from "../../registry.js";
+const API = "https://api.mangadex.org";
+function str(value) {
+    return value === undefined || value === null ? "" : String(value);
+}
+function required(value, label) {
+    const text = str(value).trim();
+    if (!text)
+        throw new Error(`mangadex ${label} cannot be empty.`);
+    return text;
+}
+function requireLimit(value) {
+    if (value === undefined || value === null || value === "")
+        return 10;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 1 || n > 50) {
+        throw new Error("mangadex limit must be an integer in [1, 50].");
+    }
+    return n;
+}
+function optionalYear(value) {
+    if (value === undefined || value === null || value === "")
+        return undefined;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 1900 || n > 2100) {
+        throw new Error("mangadex year must be an integer in [1900, 2100].");
+    }
+    return n;
+}
+const SORT_PARAMS = {
+    relevance: undefined,
+    latest: ["order[latestUploadedChapter]", "desc"],
+    followed: ["order[followedCount]", "desc"],
+    year: ["order[year]", "desc"],
+};
+function applySort(url, value) {
+    const key = String(value ?? "relevance").trim();
+    const spec = SORT_PARAMS[key];
+    if (!(key in SORT_PARAMS)) {
+        throw new Error(`mangadex sort must be one of: ${Object.keys(SORT_PARAMS).join(", ")}.`);
+    }
+    if (spec)
+        url.searchParams.set(spec[0], spec[1]);
+}
+const CONTENT_RATINGS = new Set([
+    "safe",
+    "suggestive",
+    "erotica",
+    "pornographic",
+    "all",
+]);
+function applyContentRating(url, value) {
+    if (value === undefined || value === null || value === "")
+        return;
+    const rating = String(value).trim();
+    if (!CONTENT_RATINGS.has(rating)) {
+        throw new Error(`mangadex content_rating must be one of: ${Array.from(CONTENT_RATINGS).join(", ")}.`);
+    }
+    if (rating !== "all")
+        url.searchParams.append("contentRating[]", rating);
+}
+async function getJson(url) {
+    const response = await fetch(url, {
+        headers: { Accept: "application/json", "User-Agent": USER_AGENT },
+    });
+    if (!response.ok)
+        throw new Error(`mangadex request failed with HTTP ${response.status}.`);
+    const data = (await response.json());
+    if (data.result && data.result !== "ok")
+        throw new Error(`mangadex API returned ${data.result}.`);
+    return data.data ?? [];
+}
+function localized(values) {
+    const obj = values && typeof values === "object"
+        ? values
+        : {};
+    return str(obj.en || obj.ja || obj["ja-ro"] || obj.zh || Object.values(obj)[0]);
+}
+export function mapMangaDexManga(rows) {
+    return rows.map((row, index) => {
+        const item = row;
+        const attrs = item.attributes ?? {};
+        return {
+            rank: index + 1,
+            id: item.id,
+            title: localized(attrs.title),
+            status: str(attrs.status),
+            year: attrs.year ?? null,
+            content_rating: str(attrs.contentRating),
+            latest_uploaded_chapter: str(attrs.latestUploadedChapter),
+            description: localized(attrs.description).slice(0, 700),
+            url: `https://mangadex.org/title/${item.id}`,
+        };
+    });
+}
+export function mapMangaDexAuthors(rows) {
+    return rows.map((row, index) => {
+        const item = row;
+        const attrs = item.attributes ?? {};
+        return {
+            rank: index + 1,
+            id: item.id,
+            name: str(attrs.name),
+            twitter: str(attrs.twitter),
+            pixiv: str(attrs.pixiv),
+            website: str(attrs.website),
+            url: `https://mangadex.org/author/${item.id}`,
+        };
+    });
+}
+async function searchManga(kwargs) {
+    const query = required(kwargs.query, "query");
+    const url = new URL(`${API}/manga`);
+    url.searchParams.set("title", query);
+    url.searchParams.set("limit", String(requireLimit(kwargs.limit)));
+    const year = optionalYear(kwargs.year);
+    if (year)
+        url.searchParams.set("year", String(year));
+    applySort(url, kwargs.sort);
+    applyContentRating(url, kwargs["content-rating"]);
+    url.searchParams.append("includes[]", "author");
+    url.searchParams.append("includes[]", "artist");
+    const rows = mapMangaDexManga(await getJson(url));
+    if (rows.length === 0)
+        throw new Error(`No MangaDex manga found for "${query}".`);
+    return rows;
+}
+async function searchAuthors(kwargs) {
+    const query = required(kwargs.query, "query");
+    const url = new URL(`${API}/author`);
+    url.searchParams.set("name", query);
+    url.searchParams.set("limit", String(requireLimit(kwargs.limit)));
+    const rows = mapMangaDexAuthors(await getJson(url));
+    if (rows.length === 0)
+        throw new Error(`No MangaDex authors found for "${query}".`);
+    return rows;
+}
+const SEARCH_ARGS = [
+    { name: "query", type: "str", required: true, positional: true },
+    { name: "limit", type: "int", default: 10 },
+];
+const MANGA_ARGS = [
+    { name: "query", type: "str", required: true, positional: true },
+    { name: "limit", type: "int", default: 10 },
+    { name: "year", type: "int" },
+    {
+        name: "sort",
+        type: "str",
+        default: "relevance",
+        choices: ["relevance", "latest", "followed", "year"],
+    },
+    {
+        name: "content-rating",
+        type: "str",
+        choices: ["safe", "suggestive", "erotica", "pornographic", "all"],
+    },
+];
+cli({
+    site: "mangadex",
+    name: "manga",
+    description: "Search MangaDex manga by Japanese title, romaji, alias, or keyword",
+    domain: "mangadex.org",
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: MANGA_ARGS,
+    columns: ["rank", "id", "title", "status", "year", "content_rating", "url"],
+    func: async (_page, kwargs) => searchManga(kwargs),
+});
+cli({
+    site: "mangadex",
+    name: "authors",
+    description: "Search MangaDex authors and artists by public name or romaji",
+    domain: "mangadex.org",
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: SEARCH_ARGS,
+    columns: ["rank", "id", "name", "twitter", "pixiv", "website", "url"],
+    func: async (_page, kwargs) => searchAuthors(kwargs),
+});
+//# sourceMappingURL=web.js.map

package/dist/adapters/mangadex/web.js.map

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

package/dist/adapters/mastodon/statuses.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @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.
+ */
+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;
+}
+export declare function normalizeMastodonAccount(input: string, instanceOverride?: string): MastodonAccountRef;
+export declare function mapMastodonStatusRows(statuses: MastodonStatus[], limit: number): MastodonStatusRow[];
+export {};
+//# sourceMappingURL=statuses.d.ts.map

package/dist/adapters/mastodon/statuses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statuses.d.ts","sourceRoot":"","sources":["../../../src/adapters/mastodon/statuses.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,UAAU,eAAe;IACvB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,UAAU,cAAc;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAuBD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,gBAAgB,SAAoB,GACnC,kBAAkB,CAapB;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,cAAc,EAAE,EAC1B,KAAK,EAAE,MAAM,GACZ,iBAAiB,EAAE,CAsBrB"}

package/dist/adapters/mastodon/statuses.js

@@ -0,0 +1,153 @@
+/**
+ * @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";
+function cleanString(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+function numberValue(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : 0;
+}
+function stripHtml(value) {
+    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, instanceOverride = "mastodon.social") {
+    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, limit) {
+    const rows = [];
+    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) {
+    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) {
+    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();
+}
+function requireAccountId(account) {
+    if (!account || typeof account !== "object") {
+        throw new Error("Mastodon account lookup returned a non-object response");
+    }
+    const id = cleanString(account.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, limit);
+    },
+});
+//# sourceMappingURL=statuses.js.map

package/dist/adapters/mastodon/statuses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statuses.js","sourceRoot":"","sources":["../../../src/adapters/mastodon/statuses.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAmClD,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACvD,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,CAAC,CAAC;AACzE,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,WAAW,CAAC,KAAK,CAAC;SACtB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,KAAa,EACb,gBAAgB,GAAG,iBAAiB;IAEpC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC/C,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,6BAA6B,KAAK,EAAE,CAAC,CAAC;IACxD,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,gBAAgB,CAAC,IAAI,EAAE,CAAC;IACrD,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,6BAA6B,KAAK,EAAE,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,QAA0B,EAC1B,KAAa;IAEb,MAAM,IAAI,GAAsC,EAAE,CAAC;IACnD,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC;YACR,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,MAAM;YACnD,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE;YAClC,OAAO;YACP,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,aAAa,CAAC;YAC1C,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,gBAAgB,CAAC;YAC/C,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,aAAa,CAAC;YAC1C,GAAG,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC;YAC5B,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC;SACrC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAC/C,IAAI,EAAE,KAAK,GAAG,CAAC;QACf,GAAG,GAAG;KACP,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CACb,oDAAoD,KAAK,EAAE,CAC5D,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,GAAW;IAC1C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,OAAO,EAAE;YACP,MAAM,EAAE,kBAAkB;YAC1B,YAAY,EAAE,UAAU;SACzB;KACF,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,iBAAiB,QAAQ,CAAC,MAAM,SAAS,GAAG,KAAK,OAAO,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,EAAsB,CAAC;AAC7C,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAgB;IACxC,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,MAAM,EAAE,GAAG,WAAW,CAAE,OAA2B,CAAC,EAAE,CAAC,CAAC;IACxD,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IACzE,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,GAAG,CAAC;IACF,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,oDAAoD;IACjE,MAAM,EAAE,iBAAiB;IACzB,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,8CAA8C;SAC5D;QACD;YACE,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,iBAAiB;YAC1B,WAAW,EAAE,sDAAsD;SACpE;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,0BAA0B;SACxC;KACF;IACD,OAAO,EAAE;QACP,MAAM;QACN,QAAQ;QACR,QAAQ;QACR,SAAS;QACT,SAAS;QACT,WAAW;QACX,SAAS;QACT,KAAK;QACL,MAAM;KACP;IACD,kBAAkB,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,WAAW,CAAC;IACzD,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC5B,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,wBAAwB,CACtC,MAAM,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,EAC5B,MAAM,CAAC,MAAM,CAAC,QAAQ,IAAI,iBAAiB,CAAC,CAC7C,CAAC;QACF,MAAM,MAAM,GAAG,WAAW,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC7C,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC;QAC7D,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC7D,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,WAAW,GAAG,IAAI,GAAG,CACzB,oBAAoB,kBAAkB,CAAC,SAAS,CAAC,WAAW,EAC5D,MAAM,CACP,CAAC;QACF,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACrD,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;QACzD,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,0DAA0D,CAC3D,CAAC;QACJ,CAAC;QACD,OAAO,qBAAqB,CAAC,QAA4B,EAAE,KAAK,CAAC,CAAC;IACpE,CAAC;CACF,CAAC,CAAC"}

package/dist/adapters/moegirl/web.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @owner   src/adapters/moegirl/web.ts
+ * @does    Register Moegirl public search, page reading, and article link extraction commands.
+ * @needs   Moegirl public OpenSearch endpoint and rendered MediaWiki HTML.
+ * @feeds   ACG entity discovery, character disambiguation, and wiki-backed content research.
+ * @breaks  Moegirl skin/template markup drift can reduce page and link extraction quality.
+ */
+interface SearchRow {
+    rank: number;
+    title: string;
+    description: string;
+    url: string;
+}
+interface LinkRow {
+    rank: number;
+    title: string;
+    url: string;
+}
+export declare function mapMoegirlOpenSearch(data: unknown, limit: number): SearchRow[];
+export declare function parseMoegirlPageHtml(html: string, requestedTitle: string, paragraphCap: number): Record<string, unknown>;
+export declare function parseMoegirlLinksHtml(html: string, limit: number, contains: string): LinkRow[];
+export {};
+//# sourceMappingURL=web.d.ts.map

package/dist/adapters/moegirl/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../../src/adapters/moegirl/web.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,UAAU,OAAO;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAyFD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,MAAM,GACZ,SAAS,EAAE,CAiBb;AAwCD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuCzB;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,OAAO,EAAE,CAuBX"}