@zenalexa/unicli 0.220.1 → 0.221.0

package/dist/adapters/instagram/subtitles.js

@@ -0,0 +1,42 @@
+/**
+ * @owner   Instagram subtitle adapter.
+ * @does    Extracts LLM-readable subtitle text from public Instagram reel and video URLs.
+ * @needs   `yt-dlp` on PATH and an accessible video subtitle track.
+ * @feeds   Cross-platform social video analysis workflows.
+ * @breaks  Instagram or yt-dlp extractor changes can alter subtitle availability.
+ */
+import { cli, Strategy } from "../../registry.js";
+import { runVideoSubtitleExtraction } from "../../social/video-text.js";
+cli({
+    site: "instagram",
+    name: "subtitles",
+    description: "Extract LLM-readable subtitles from an Instagram reel or video URL with optional browser-cookie reuse",
+    domain: "www.instagram.com",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "url",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Instagram reel or video URL",
+            format: "uri",
+        },
+        {
+            name: "languages",
+            type: "str",
+            default: "zh-Hans,zh,en",
+            description: "Comma-separated subtitle languages",
+        },
+        {
+            name: "cookies-from-browser",
+            type: "str",
+            description: "Browser name for yt-dlp --cookies-from-browser",
+        },
+    ],
+    columns: ["language", "text", "path"],
+    socialCapabilities: ["read", "media", "subtitles"],
+    defaultFormat: "json",
+    func: async (_page, kwargs) => runVideoSubtitleExtraction(kwargs),
+});
+//# sourceMappingURL=subtitles.js.map

package/dist/adapters/instagram/subtitles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtitles.js","sourceRoot":"","sources":["../../../src/adapters/instagram/subtitles.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAExE,GAAG,CAAC;IACF,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,WAAW;IACjB,WAAW,EACT,uGAAuG;IACzG,MAAM,EAAE,mBAAmB;IAC3B,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,6BAA6B;YAC1C,MAAM,EAAE,KAAK;SACd;QACD;YACE,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,eAAe;YACxB,WAAW,EAAE,oCAAoC;SAClD;QACD;YACE,IAAI,EAAE,sBAAsB;YAC5B,IAAI,EAAE,KAAK;YACX,WAAW,EAAE,gDAAgD;SAC9D;KACF;IACD,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC;IACrC,kBAAkB,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC;IAClD,aAAa,EAAE,MAAM;IACrB,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,0BAA0B,CAAC,MAAM,CAAC;CAClE,CAAC,CAAC"}

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":"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"}

package/dist/adapters/reddit/comments.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @owner   Reddit comments adapter.
+ * @does    Fetches a Reddit post comment listing and emits normalized nested comment rows.
+ * @needs   Public reddit JSON listing endpoint and a normal web User-Agent.
+ * @feeds   Social comment tree analysis and Reddit read workflows.
+ * @breaks  Reddit JSON schema or public endpoint access changes can block unauthenticated reads.
+ */
+export declare function extractRedditCommentRows(response: unknown, contentId: string): Array<Record<string, unknown>>;
+//# sourceMappingURL=comments.d.ts.map

package/dist/adapters/reddit/comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../../src/adapters/reddit/comments.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA4EH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,OAAO,EACjB,SAAS,EAAE,MAAM,GAChB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAKhC"}

package/dist/adapters/reddit/comments.js

@@ -0,0 +1,124 @@
+/**
+ * @owner   Reddit comments adapter.
+ * @does    Fetches a Reddit post comment listing and emits normalized nested comment rows.
+ * @needs   Public reddit JSON listing endpoint and a normal web User-Agent.
+ * @feeds   Social comment tree analysis and Reddit read workflows.
+ * @breaks  Reddit JSON schema or public endpoint access changes can block unauthenticated reads.
+ */
+import { USER_AGENT } from "../../constants.js";
+import { cli, Strategy } from "../../registry.js";
+import { normalizeCommentRows } from "../../social/comments.js";
+function normalizePostPath(input) {
+    const raw = input.trim();
+    if (!raw)
+        throw new Error("Reddit post URL or ID is required");
+    if (/^https?:\/\//i.test(raw)) {
+        const url = new URL(raw);
+        return url.pathname.replace(/^\/+/, "").replace(/\.json$/, "");
+    }
+    return raw.replace(/^\/+/, "").replace(/\.json$/, "");
+}
+function collectCommentRows(listing, contentId, parentId = "") {
+    const rows = [];
+    for (const thing of listing.data?.children ?? []) {
+        if (thing.kind !== "t1")
+            continue;
+        const data = thing.data;
+        if (!data?.id)
+            continue;
+        const commentId = data.name ?? `t1_${data.id}`;
+        rows.push({
+            id: commentId,
+            parent_id: data.parent_id && data.parent_id.startsWith("t1_")
+                ? data.parent_id
+                : parentId,
+            author: data.author ?? "",
+            body: data.body ?? "",
+            text: data.body ?? "",
+            score: data.score ?? 0,
+            replies: data.replies && typeof data.replies === "object"
+                ? (data.replies.data?.children?.filter((child) => child.kind === "t1")
+                    .length ?? 0)
+                : 0,
+            created: data.created_utc
+                ? new Date(data.created_utc * 1000).toISOString()
+                : "",
+            content_id: contentId,
+        });
+        if (data.replies && typeof data.replies === "object") {
+            rows.push(...collectCommentRows(data.replies, contentId, commentId));
+        }
+    }
+    return rows;
+}
+export function extractRedditCommentRows(response, contentId) {
+    if (!Array.isArray(response) || response.length < 2) {
+        throw new Error("Unexpected Reddit comments response");
+    }
+    return collectCommentRows(response[1], contentId);
+}
+cli({
+    site: "reddit",
+    name: "comments",
+    description: "Reddit post comments with nested reply hierarchy",
+    domain: "www.reddit.com",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "url",
+            required: true,
+            positional: true,
+            description: "Reddit post URL, path, or comments ID",
+            "x-unicli-accepts": ["url", "id"],
+        },
+        {
+            name: "sort",
+            default: "top",
+            choices: ["best", "top", "new", "controversial", "old", "qa"],
+            description: "Comment sort order",
+        },
+        {
+            name: "limit",
+            type: "int",
+            default: 20,
+            description: "Number of top-level comments",
+        },
+    ],
+    columns: [
+        "platform",
+        "content_id",
+        "comment_id",
+        "parent_id",
+        "depth",
+        "path",
+        "author",
+        "text",
+        "likes",
+        "replies",
+        "created",
+        "body",
+        "score",
+    ],
+    socialCapabilities: ["read", "comments", "comment_replies"],
+    func: async (_page, kwargs) => {
+        const postPath = normalizePostPath(String(kwargs.url ?? ""));
+        const sort = String(kwargs.sort ?? "top");
+        const limit = Number(kwargs.limit ?? 20);
+        const response = await fetch(`https://www.reddit.com/${postPath}.json?sort=${encodeURIComponent(sort)}&limit=${encodeURIComponent(String(limit))}&raw_json=1`, {
+            headers: {
+                "User-Agent": USER_AGENT,
+                Accept: "application/json",
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`Reddit comments request failed: ${response.status}`);
+        }
+        const json = await response.json();
+        const rows = extractRedditCommentRows(json, postPath);
+        return normalizeCommentRows(rows, {
+            platform: "reddit",
+            contentId: postPath,
+        });
+    },
+});
+//# sourceMappingURL=comments.js.map

package/dist/adapters/reddit/comments.js.map

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

package/dist/adapters/threads/post.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @owner   Threads public page metadata adapter.
+ * @does    Register public profile, post, and media readers backed by Threads OG metadata.
+ * @needs   Threads public HTML pages exposing Open Graph metadata.
+ * @feeds   Social research workflows and Threads capability coverage.
+ * @breaks  Threads hiding public metadata or changing canonical post/profile markup.
+ */
+export interface ThreadsPostRow {
+    author: string;
+    handle: string;
+    text: string;
+    url: string;
+    image_url: string;
+    image_width: number;
+    image_height: number;
+    shortcode: string;
+    activity_json_url: string;
+}
+export interface ThreadsProfileRow {
+    name: string;
+    handle: string;
+    followers: string;
+    threads: string;
+    bio: string;
+    url: string;
+    avatar_url: string;
+}
+export declare function normalizeThreadsProfileUrl(input: string): string;
+export declare function normalizeThreadsPostUrl(input: string): string;
+export declare function parseThreadsPostHtml(html: string, fallbackUrl: string): ThreadsPostRow;
+export declare function parseThreadsProfileHtml(html: string, handleInput: string): ThreadsProfileRow;
+//# sourceMappingURL=post.d.ts.map

package/dist/adapters/threads/post.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post.d.ts","sourceRoot":"","sources":["../../../src/adapters/threads/post.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;CACpB;AAuGD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAe7D;AASD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,cAAc,CAwBhB;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,iBAAiB,CAqCnB"}