@zenalexa/unicli 0.219.0 → 0.220.1

package/dist/adapters/weibo/favorites-publish.js

@@ -0,0 +1,356 @@
+/**
+ * @owner   src/adapters/weibo/favorites-publish.ts
+ * @does    Register agent-facing Weibo favorites reader and publish command.
+ * @needs   Logged-in weibo.com browser session and stable Weibo compose/favorites DOM.
+ * @feeds   surface coverage ledger, Weibo collection reading, and Weibo publishing workflows.
+ * @breaks  Weibo Vue config changes, favorites virtual-scroller DOM drift, compose selector drift, or upload UI changes.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { cli, Strategy } from "../../registry.js";
+const FAVORITES_DEFAULT_LIMIT = 20;
+const FAVORITES_MAX_LIMIT = 50;
+const MAX_IMAGES = 9;
+const IMAGE_EXTENSIONS = new Set([".jpg", ".jpeg", ".png", ".gif", ".webp"]);
+const TEXTAREA_SELECTOR = "textarea._input_13iqr_8";
+const FILE_INPUT_SELECTOR = 'input[type="file"][class*="_file_"]';
+export function requireWeiboFavoritesLimit(value) {
+    const limit = Number(value ?? FAVORITES_DEFAULT_LIMIT);
+    if (!Number.isInteger(limit) || limit <= 0) {
+        throw new Error("weibo favorites limit must be a positive integer.");
+    }
+    if (limit > FAVORITES_MAX_LIMIT) {
+        throw new Error(`weibo favorites limit must be <= ${FAVORITES_MAX_LIMIT}.`);
+    }
+    return limit;
+}
+export function validateWeiboPublishText(value) {
+    const text = String(value ?? "").trim();
+    if (!text)
+        throw new Error("weibo publish text cannot be empty.");
+    if (text.length > 2000) {
+        throw new Error("weibo publish text exceeds 2000 characters.");
+    }
+    return text;
+}
+export function validateWeiboImagePaths(value) {
+    if (!value)
+        return [];
+    const parts = String(value)
+        .split(",")
+        .map((item) => item.trim())
+        .filter(Boolean);
+    if (parts.length > MAX_IMAGES) {
+        throw new Error(`Too many images: ${parts.length} (max ${MAX_IMAGES}).`);
+    }
+    return parts.map((item) => {
+        const absolutePath = path.resolve(item);
+        const extension = path.extname(absolutePath).toLowerCase();
+        if (!IMAGE_EXTENSIONS.has(extension)) {
+            throw new Error(`Unsupported image format "${extension}". Supported: jpg, png, gif, webp.`);
+        }
+        const stat = fs.statSync(absolutePath, { throwIfNoEntry: false });
+        if (!stat?.isFile()) {
+            throw new Error(`Not a valid file: ${absolutePath}.`);
+        }
+        return absolutePath;
+    });
+}
+async function getWeiboSelfUid(page) {
+    const uid = await page.evaluate(`(() => {
+    const app = document.querySelector('#app')?.__vue_app__;
+    const store = app?.config?.globalProperties?.$store;
+    const uid = store?.state?.config?.config?.uid;
+    return uid ? String(uid) : null;
+  })()`);
+    if (uid)
+        return String(uid);
+    const configUid = await page.evaluate(`(async () => {
+    const response = await fetch('/ajax/config/get_config', { credentials: 'include' });
+    if (!response.ok) return null;
+    const data = await response.json();
+    return data.ok && data.data?.uid ? String(data.data.uid) : null;
+  })()`);
+    if (configUid)
+        return String(configUid);
+    throw new Error("Weibo login is required.");
+}
+export function parseWeiboFavoriteCard(card, fallbackUrl) {
+    const raw = String(card?.text ?? "");
+    const lines = raw.split("\n");
+    let author = "";
+    let time = "";
+    let source = "";
+    let content = "";
+    let likes = "0";
+    let comments = "0";
+    let reposts = "0";
+    for (const line of lines) {
+        const text = line.trim();
+        if (!text || text === "添加")
+            continue;
+        if (!time &&
+            /\d+小时前|\d+分钟前|\d+秒前|昨天|前天|\d{1,2}:\d{2}/.test(text)) {
+            time = text;
+            continue;
+        }
+        if (text.startsWith("来自")) {
+            source = text;
+            continue;
+        }
+        if (content) {
+            const n = Number.parseInt(text, 10);
+            if (!Number.isNaN(n) && n > 0 && n < 1_000_000 && text === String(n)) {
+                if (likes === "0")
+                    likes = text;
+                else if (comments === "0")
+                    comments = text;
+                else if (reposts === "0")
+                    reposts = text;
+                continue;
+            }
+        }
+        if (!author && text.length < 40) {
+            author = text;
+            continue;
+        }
+        if (!content && author) {
+            content = text;
+            continue;
+        }
+        if (content)
+            content += ` ${text}`;
+    }
+    if (!content || !author)
+        return null;
+    return {
+        author,
+        text: content.substring(0, 300),
+        time,
+        source,
+        likes,
+        comments,
+        reposts,
+        url: String(card?.url || fallbackUrl),
+    };
+}
+export function dedupeWeiboFavorites(items, fallbackUrl) {
+    const seen = new Set();
+    const result = [];
+    for (const item of items) {
+        const key = item.url && item.url !== fallbackUrl
+            ? item.url
+            : `${item.author}\n${item.text}\n${item.time}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        result.push(item);
+    }
+    return result;
+}
+function buildFavoritesExtractScript(limit) {
+    return `(() => {
+    const scrollers = document.querySelectorAll('.wbpro-scroller-item, .vue-recycle-scroller__item-view');
+    const rows = [];
+    for (const scroller of scrollers) {
+      const body = scroller.querySelector('[class*="_body_"]') || scroller.querySelector('.wbpro-item-body') || scroller;
+      const rawText = body.innerText || scroller.innerText || '';
+      let postUrl = '';
+      const anchors = scroller.querySelectorAll('a[href]');
+      for (const anchor of anchors) {
+        const match = String(anchor.href).match(/weibo\\.com\\/(\\d+)\\/([a-zA-Z0-9]+)/);
+        if (match) {
+          postUrl = 'https://weibo.com/' + match[1] + '/' + match[2];
+          break;
+        }
+      }
+      if (rawText.length > 20) rows.push({ text: rawText, url: postUrl });
+      if (rows.length >= ${JSON.stringify(limit)}) break;
+    }
+    return rows;
+  })()`;
+}
+async function waitForTruthy(page, script, attempts, intervalSeconds) {
+    for (let index = 0; index < attempts; index += 1) {
+        const result = (await page.evaluate(script));
+        if (result?.ok || result?.found || result?.message)
+            return result;
+        await page.wait(intervalSeconds);
+    }
+    return null;
+}
+cli({
+    site: "weibo",
+    name: "favorites",
+    description: "Read your Weibo favorites",
+    domain: "weibo.com",
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [{ name: "limit", type: "int", default: FAVORITES_DEFAULT_LIMIT }],
+    columns: [
+        "author",
+        "text",
+        "time",
+        "source",
+        "likes",
+        "comments",
+        "reposts",
+        "url",
+    ],
+    func: async (page, kwargs) => {
+        const limit = requireWeiboFavoritesLimit(kwargs.limit);
+        const p = page;
+        await p.goto("https://weibo.com");
+        await p.wait(2);
+        const uid = await getWeiboSelfUid(p);
+        const favoritesUrl = `https://www.weibo.com/u/page/fav/${uid}`;
+        await p.goto(favoritesUrl);
+        await p.wait(4);
+        for (let index = 0; index < 3; index += 1) {
+            await p.evaluate("() => window.scrollBy(0, 800)");
+            await p.wait(1);
+        }
+        const rawData = await p.evaluate(buildFavoritesExtractScript(limit));
+        if (!Array.isArray(rawData) || rawData.length === 0) {
+            throw new Error("No Weibo favorites were visible on the favorites page.");
+        }
+        const rows = rawData
+            .map((card) => parseWeiboFavoriteCard(card, favoritesUrl))
+            .filter((item) => Boolean(item));
+        const uniqueRows = dedupeWeiboFavorites(rows, favoritesUrl);
+        if (!uniqueRows.length) {
+            throw new Error("Failed to parse visible Weibo favorites.");
+        }
+        return uniqueRows.slice(0, limit);
+    },
+});
+cli({
+    site: "weibo",
+    name: "publish",
+    description: "Publish a new Weibo post immediately",
+    domain: "weibo.com",
+    strategy: Strategy.UI,
+    browser: true,
+    args: [
+        { name: "text", type: "str", required: true, positional: true },
+        { name: "images", type: "str", required: false },
+    ],
+    columns: ["status", "message", "text"],
+    func: async (page, kwargs) => {
+        const p = page;
+        const text = validateWeiboPublishText(kwargs.text);
+        const imagePaths = validateWeiboImagePaths(kwargs.images);
+        await p.goto("https://weibo.com", { waitUntil: "load", settleMs: 2000 });
+        await p.wait(2);
+        await getWeiboSelfUid(p);
+        const openResult = (await p.evaluate(`(() => {
+      const visible = (element) => Boolean(element && element.offsetParent !== null && !element.disabled);
+      const buttons = document.querySelectorAll('button[title="发微博"], button[title="写微博"]');
+      for (const button of buttons) {
+        if (visible(button)) {
+          button.click();
+          return { ok: true };
+        }
+      }
+      return { ok: false, message: 'Could not find 发微博 button' };
+    })()`));
+        if (!openResult?.ok) {
+            throw new Error(String(openResult?.message || "Could not open compose editor."));
+        }
+        const editorResult = await waitForTruthy(p, `(() => {
+        const textarea = document.querySelector(${JSON.stringify(TEXTAREA_SELECTOR)});
+        if (!textarea) return { found: false };
+        const visible = textarea.offsetParent !== null;
+        return { found: true, visible, rectTop: visible ? textarea.getBoundingClientRect().top : -1 };
+      })()`, 34, 0.3);
+        if (!editorResult?.found ||
+            !editorResult.visible ||
+            Number(editorResult.rectTop) < 0) {
+            throw new Error("Weibo compose editor did not appear.");
+        }
+        if (imagePaths.length > 0) {
+            const fileInputFound = await p.evaluate(`(() => {
+        return Boolean(document.querySelector(${JSON.stringify(FILE_INPUT_SELECTOR)}));
+      })()`);
+            if (!fileInputFound) {
+                throw new Error("Could not find image file input on Weibo compose page.");
+            }
+            await p.setFileInput(FILE_INPUT_SELECTOR, imagePaths);
+            const uploadResult = await waitForTruthy(p, `(() => {
+          const expectedCount = ${JSON.stringify(imagePaths.length)};
+          const uploading = document.querySelector('[class*="upload"], [class*="progress"]');
+          if (uploading && uploading.offsetParent !== null) return null;
+          const images = document.querySelectorAll('img[class*="pic"], [class*="imgItem"], [class*="picture"] img');
+          if (images.length >= expectedCount) return { ok: true, count: images.length };
+          return null;
+        })()`, 20, 1.5);
+            if (!uploadResult?.ok) {
+                throw new Error("Image upload did not complete before timeout.");
+            }
+        }
+        const insertResult = (await p.evaluate(`(() => {
+      const textarea = document.querySelector(${JSON.stringify(TEXTAREA_SELECTOR)});
+      if (!textarea || textarea.offsetParent === null) return { ok: false, message: 'textarea not visible' };
+      textarea.focus();
+      const nativeSetter = Object.getOwnPropertyDescriptor(HTMLTextAreaElement.prototype, 'value')?.set;
+      if (nativeSetter) nativeSetter.call(textarea, ${JSON.stringify(text)});
+      else textarea.value = ${JSON.stringify(text)};
+      textarea.dispatchEvent(new Event('input', { bubbles: true }));
+      textarea.dispatchEvent(new Event('change', { bubbles: true }));
+      return { ok: true, valueLength: textarea.value.length };
+    })()`));
+        if (!insertResult?.ok) {
+            throw new Error(String(insertResult?.message || "Could not insert text."));
+        }
+        await p.wait(0.5);
+        const publishClick = (await p.evaluate(`(() => {
+      const visible = (element) => Boolean(element && element.offsetParent !== null && !element.disabled);
+      for (const label of ['发送', '发布']) {
+        const buttons = document.querySelectorAll('button, [role="button"]');
+        for (const button of buttons) {
+          const value = (button.innerText || button.textContent || '').trim();
+          if (value === label && visible(button)) {
+            button.click();
+            return { ok: true, label };
+          }
+        }
+      }
+      return { ok: false, message: 'Could not find send button' };
+    })()`));
+        if (!publishClick?.ok) {
+            throw new Error(String(publishClick?.message || "Could not click publish."));
+        }
+        const finalResult = await waitForTruthy(p, `(() => {
+        const successMarkers = ['发布成功', '已发布', '发送成功'];
+        const errorMarkers = ['发布失败', '发送失败', '内容违规', '请稍后再试', '频繁'];
+        for (const element of document.querySelectorAll('*')) {
+          if (element.children.length > 3) continue;
+          const value = (element.innerText || '').trim();
+          if (!value || value.length > 100) continue;
+          for (const marker of successMarkers) {
+            if (value.includes(marker) && (value.includes('成功') || value.includes('微博'))) {
+              return { ok: true, message: value };
+            }
+          }
+          for (const marker of errorMarkers) {
+            if (value.includes(marker)) return { ok: false, message: value };
+          }
+        }
+        return null;
+      })()`, 40, 0.5);
+        if (!finalResult) {
+            throw new Error("Publish button clicked but result was unclear. Check Weibo manually.");
+        }
+        if (!finalResult.ok) {
+            throw new Error(String(finalResult.message || "Weibo publish failed."));
+        }
+        return [
+            {
+                status: "success",
+                message: String(finalResult.message || "Published successfully"),
+                text,
+            },
+        ];
+    },
+});
+//# sourceMappingURL=favorites-publish.js.map

package/dist/adapters/weibo/favorites-publish.js.map

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

package/dist/adapters/wikidata/entities.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @owner   src/adapters/wikidata/entities.ts
+ * @does    Register agent-facing Wikidata entity search and detail commands.
+ * @needs   Wikidata public APIs, language validation, Q/P/L entity id validation.
+ * @feeds   surface coverage ledger, Wikidata search rows, entity summary rows.
+ * @breaks  Wikidata API drift, weak id validation, or silent empty rows hide entity lookup failures.
+ */
+export declare function requireWikidataLimit(value: unknown): number;
+export declare function requireWikidataLanguage(value: unknown): string;
+export declare function requireWikidataEntityId(value: unknown): string;
+export declare function pickLocalizedValue(map: unknown, language: string): string | null;
+export declare function joinLocalizedAliases(value: unknown, language: string, max?: number): string;
+export declare function mapWikidataSearchRows(rows: Array<Record<string, unknown>>, limit: number): Array<Record<string, unknown>>;
+export declare function mapWikidataEntityRow(id: string, entity: Record<string, unknown>, language: string): Record<string, unknown>;
+//# sourceMappingURL=entities.d.ts.map

package/dist/adapters/wikidata/entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../../src/adapters/wikidata/entities.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQ3D;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQ9D;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAU9D;AAYD,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAMf;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,GAAG,SAAI,GACN,MAAM,CAWR;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACpC,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAchC;AAED,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgBzB"}

package/dist/adapters/wikidata/entities.js

@@ -0,0 +1,219 @@
+/**
+ * @owner   src/adapters/wikidata/entities.ts
+ * @does    Register agent-facing Wikidata entity search and detail commands.
+ * @needs   Wikidata public APIs, language validation, Q/P/L entity id validation.
+ * @feeds   surface coverage ledger, Wikidata search rows, entity summary rows.
+ * @breaks  Wikidata API drift, weak id validation, or silent empty rows hide entity lookup failures.
+ */
+import { cli, Strategy } from "../../registry.js";
+const API_BASE = "https://www.wikidata.org";
+const ENTITY_ID_RE = /^[QPL]\d+$/;
+function requireNonEmpty(value, label) {
+    const text = String(value ?? "").trim();
+    if (!text)
+        throw new Error(`wikidata ${label} cannot be empty.`);
+    return text;
+}
+export function requireWikidataLimit(value) {
+    const raw = value === undefined || value === null || value === "" ? 20 : value;
+    const limit = Number(raw);
+    if (!Number.isInteger(limit) || limit < 1 || limit > 50) {
+        throw new Error("wikidata limit must be an integer in [1, 50].");
+    }
+    return limit;
+}
+export function requireWikidataLanguage(value) {
+    const language = String(value ?? "en")
+        .trim()
+        .toLowerCase();
+    if (!/^[a-z]{2,3}(-[a-z]{2,8})?$/.test(language)) {
+        throw new Error(`wikidata language "${String(value)}" is not valid.`);
+    }
+    return language;
+}
+export function requireWikidataEntityId(value) {
+    const raw = String(value ?? "")
+        .trim()
+        .toUpperCase();
+    if (!raw)
+        throw new Error("wikidata entity id cannot be empty.");
+    const id = raw.replace(/^HTTPS?:\/\/[^/]+\/WIKI\//i, "");
+    if (!ENTITY_ID_RE.test(id)) {
+        throw new Error(`wikidata entity id "${String(value)}" is not valid.`);
+    }
+    return id;
+}
+function objectField(value) {
+    return value && typeof value === "object"
+        ? value
+        : {};
+}
+function stringField(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+export function pickLocalizedValue(map, language) {
+    const values = objectField(map);
+    const direct = objectField(values[language]);
+    if (stringField(direct.value))
+        return stringField(direct.value);
+    const english = objectField(values.en);
+    return stringField(english.value) || null;
+}
+export function joinLocalizedAliases(value, language, max = 5) {
+    const aliases = objectField(value);
+    const direct = Array.isArray(aliases[language]) ? aliases[language] : [];
+    const fallback = Array.isArray(aliases.en) ? aliases.en : [];
+    const list = direct.length > 0 ? direct : fallback;
+    const names = list
+        .map((item) => stringField(objectField(item).value))
+        .filter(Boolean);
+    return names.length > max
+        ? [...names.slice(0, max), `(+${names.length - max})`].join(", ")
+        : names.join(", ");
+}
+export function mapWikidataSearchRows(rows, limit) {
+    return rows.slice(0, limit).map((row, index) => {
+        const qid = stringField(row.id);
+        const match = objectField(row.match);
+        return {
+            rank: index + 1,
+            qid,
+            label: stringField(row.label),
+            description: stringField(row.description),
+            matchType: stringField(match.type),
+            matchText: stringField(match.text),
+            url: qid ? `${API_BASE}/wiki/${qid}` : "",
+        };
+    });
+}
+export function mapWikidataEntityRow(id, entity, language) {
+    const claims = objectField(entity.claims);
+    const sitelinks = objectField(entity.sitelinks);
+    const enwiki = objectField(sitelinks.enwiki);
+    return {
+        qid: id,
+        type: stringField(entity.type),
+        label: pickLocalizedValue(entity.labels, language),
+        description: pickLocalizedValue(entity.descriptions, language),
+        aliases: joinLocalizedAliases(entity.aliases, language),
+        claimPropertyCount: Object.keys(claims).length,
+        sitelinkCount: Object.keys(sitelinks).length,
+        enwikiTitle: stringField(enwiki.title) || null,
+        modified: stringField(entity.modified) || null,
+        url: `${API_BASE}/wiki/${id}`,
+    };
+}
+async function fetchJson(url, label) {
+    const response = await fetch(url, {
+        headers: {
+            accept: "application/json",
+            "user-agent": "unicli-wikidata (https://github.com/olo-dot-io/Uni-CLI)",
+        },
+    });
+    if (response.status === 404)
+        throw new Error(`${label} returned no result.`);
+    if (response.status === 429)
+        throw new Error(`${label} returned HTTP 429.`);
+    if (!response.ok)
+        throw new Error(`${label} returned HTTP ${response.status}.`);
+    return response.json();
+}
+cli({
+    site: "wikidata",
+    name: "search",
+    description: "Search Wikidata items by keyword",
+    domain: "www.wikidata.org",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "query",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Search keyword",
+        },
+        {
+            name: "language",
+            type: "str",
+            default: "en",
+            description: "Language code",
+        },
+        { name: "limit", type: "int", default: 20, description: "Max rows" },
+    ],
+    columns: [
+        "rank",
+        "qid",
+        "label",
+        "description",
+        "matchType",
+        "matchText",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const query = requireNonEmpty(kwargs.query, "query");
+        const language = requireWikidataLanguage(kwargs.language);
+        const limit = requireWikidataLimit(kwargs.limit);
+        const url = new URL(`${API_BASE}/w/api.php`);
+        url.searchParams.set("action", "wbsearchentities");
+        url.searchParams.set("search", query);
+        url.searchParams.set("language", language);
+        url.searchParams.set("uselang", language);
+        url.searchParams.set("type", "item");
+        url.searchParams.set("format", "json");
+        url.searchParams.set("limit", String(limit));
+        url.searchParams.set("origin", "*");
+        const body = (await fetchJson(url, "wikidata search"));
+        const rows = mapWikidataSearchRows(Array.isArray(body.search)
+            ? body.search
+            : [], limit);
+        if (rows.length === 0) {
+            throw new Error(`wikidata search returned no rows for "${query}".`);
+        }
+        return rows;
+    },
+});
+cli({
+    site: "wikidata",
+    name: "entity",
+    description: "Fetch a Wikidata entity by Q/P/L id",
+    domain: "www.wikidata.org",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "id",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Entity id",
+        },
+        {
+            name: "language",
+            type: "str",
+            default: "en",
+            description: "Language code",
+        },
+    ],
+    columns: [
+        "qid",
+        "type",
+        "label",
+        "description",
+        "aliases",
+        "claimPropertyCount",
+        "sitelinkCount",
+        "enwikiTitle",
+        "modified",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const id = requireWikidataEntityId(kwargs.id);
+        const language = requireWikidataLanguage(kwargs.language);
+        const body = objectField(await fetchJson(`${API_BASE}/wiki/Special:EntityData/${encodeURIComponent(id)}.json`, "wikidata entity"));
+        const entity = objectField(objectField(body.entities)[id]);
+        if (!entity.id && !entity.type) {
+            throw new Error(`wikidata entity returned no row for "${id}".`);
+        }
+        return [mapWikidataEntityRow(id, entity, language)];
+    },
+});
+//# sourceMappingURL=entities.js.map

package/dist/adapters/wikidata/entities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.js","sourceRoot":"","sources":["../../../src/adapters/wikidata/entities.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,QAAQ,GAAG,0BAA0B,CAAC;AAC5C,MAAM,YAAY,GAAG,YAAY,CAAC;AAElC,SAAS,eAAe,CAAC,KAAc,EAAE,KAAa;IACpD,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;IACjD,MAAM,GAAG,GACP,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IACrE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC;SACnC,IAAI,EAAE;SACN,WAAW,EAAE,CAAC;IACjB,IAAI,CAAC,4BAA4B,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,sBAAsB,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;SAC5B,IAAI,EAAE;SACN,WAAW,EAAE,CAAC;IACjB,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACjE,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,4BAA4B,EAAE,EAAE,CAAC,CAAC;IACzD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,uBAAuB,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QACvC,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,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,MAAM,UAAU,kBAAkB,CAChC,GAAY,EACZ,QAAgB;IAEhB,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7C,IAAI,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvC,OAAO,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,KAAc,EACd,QAAgB,EAChB,GAAG,GAAG,CAAC;IAEP,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;IACnD,MAAM,KAAK,GAAG,IAAI;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC;SACnD,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,OAAO,KAAK,CAAC,MAAM,GAAG,GAAG;QACvB,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,KAAK,CAAC,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACjE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,IAAoC,EACpC,KAAa;IAEb,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAC7C,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrC,OAAO;YACL,IAAI,EAAE,KAAK,GAAG,CAAC;YACf,GAAG;YACH,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC;YAC7B,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC;YACzC,SAAS,EAAE,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC;YAClC,SAAS,EAAE,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC;YAClC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE;SAC1C,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,EAAU,EACV,MAA+B,EAC/B,QAAgB;IAEhB,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC7C,OAAO;QACL,GAAG,EAAE,EAAE;QACP,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC;QAC9B,KAAK,EAAE,kBAAkB,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC;QAClD,WAAW,EAAE,kBAAkB,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC;QAC9D,OAAO,EAAE,oBAAoB,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC;QACvD,kBAAkB,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM;QAC9C,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM;QAC5C,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI;QAC9C,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,IAAI;QAC9C,GAAG,EAAE,GAAG,QAAQ,SAAS,EAAE,EAAE;KAC9B,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,GAAiB,EAAE,KAAa;IACvD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,OAAO,EAAE;YACP,MAAM,EAAE,kBAAkB;YAC1B,YAAY,EAAE,yDAAyD;SACxE;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,gBAAgB;SAC9B;QACD;YACE,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,eAAe;SAC7B;QACD,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE;KACrE;IACD,OAAO,EAAE;QACP,MAAM;QACN,KAAK;QACL,OAAO;QACP,aAAa;QACb,WAAW;QACX,WAAW;QACX,KAAK;KACN;IACD,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC5B,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAG,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,QAAQ,YAAY,CAAC,CAAC;QAC7C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;QACnD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACtC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC3C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC1C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACrC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACvC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,CAAC,MAAM,SAAS,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAEpD,CAAC;QACF,MAAM,IAAI,GAAG,qBAAqB,CAChC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;YACxB,CAAC,CAAE,IAAI,CAAC,MAAyC;YACjD,CAAC,CAAC,EAAE,EACN,KAAK,CACN,CAAC;QACF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,yCAAyC,KAAK,IAAI,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC,CAAC;AAEH,GAAG,CAAC;IACF,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,qCAAqC;IAClD,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,WAAW;SACzB;QACD;YACE,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,eAAe;SAC7B;KACF;IACD,OAAO,EAAE;QACP,KAAK;QACL,MAAM;QACN,OAAO;QACP,aAAa;QACb,SAAS;QACT,oBAAoB;QACpB,eAAe;QACf,aAAa;QACb,UAAU;QACV,KAAK;KACN;IACD,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC5B,MAAM,EAAE,GAAG,uBAAuB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,uBAAuB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,WAAW,CACtB,MAAM,SAAS,CACb,GAAG,QAAQ,4BAA4B,kBAAkB,CAAC,EAAE,CAAC,OAAO,EACpE,iBAAiB,CAClB,CACF,CAAC;QACF,MAAM,MAAM,GAAG,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3D,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,wCAAwC,EAAE,IAAI,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,CAAC,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IACtD,CAAC;CACF,CAAC,CAAC"}

package/dist/adapters/wikipedia/page.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @owner   src/adapters/wikipedia/page.ts
+ * @does    Register agent-facing full Wikipedia page extract command.
+ * @needs   MediaWiki Action API, language validation, explicit paragraph caps.
+ * @feeds   surface coverage ledger, encyclopedia article reading workflow.
+ * @breaks  MediaWiki envelope drift or silent extract truncation hides article content.
+ */
+interface WikiPage {
+    title?: unknown;
+    description?: unknown;
+    pageid?: unknown;
+    extract?: unknown;
+    fullurl?: unknown;
+    missing?: unknown;
+}
+export declare function requireWikiTitle(value: unknown): string;
+export declare function requireWikiLang(value: unknown): string;
+export declare function requireParagraphCap(value: unknown): number;
+export declare function mapWikipediaPageRow(page: WikiPage | undefined, lang: string, requestedTitle: string, paragraphCap: number): Record<string, unknown>;
+export {};
+//# sourceMappingURL=page.d.ts.map

package/dist/adapters/wikipedia/page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../../src/adapters/wikipedia/page.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,UAAU,QAAQ;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAMD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIvD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUtD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAO1D;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,GAAG,SAAS,EAC1B,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6BzB"}