@zenalexa/unicli 0.220.0 → 0.221.0

package/dist/adapters/xiaohongshu/search.js

@@ -5,6 +5,8 @@
  * DOM elements.  Uses MutationObserver to wait for content or login wall.
  */
 import { cli, Strategy } from "../../registry.js";
+import { socialAuthError, socialEmptyError, } from "../../social/browser-errors.js";
+import { assertXhsReadable } from "./browser-state.js";
 /**
  * Wait for search results or login wall using MutationObserver (max 5 s).
  */
@@ -47,6 +49,7 @@ cli({
     domain: "www.xiaohongshu.com",
     strategy: Strategy.COOKIE,
     browser: true,
+    browserSession: "user",
     args: [
         {
             name: "query",
@@ -65,12 +68,13 @@ cli({
     func: async (page, kwargs) => {
         const p = page;
         const keyword = encodeURIComponent(String(kwargs.query));
-        await p.goto(`https://www.xiaohongshu.com/search_result?keyword=${keyword}&source=web_search_result_notes`);
+        const limit = Number(kwargs.limit) || 20;
+        await p.goto(`https://www.xiaohongshu.com/search_result?keyword=${keyword}&source=web_search_result_notes`, { settleMs: 2500 });
         const waitResult = await p.evaluate(WAIT_FOR_CONTENT_JS);
+        await assertXhsReadable(p, "search");
         if (waitResult === "login_wall") {
-            throw new Error("Xiaohongshu search results are blocked behind a login wall");
+            throw socialAuthError("xiaohongshu", "search");
         }
-        // Scroll a couple of times to load more results
         await p.autoScroll({ maxScrolls: 2, delay: 1500 });
         const payload = await p.evaluate(`
       (() => {
@@ -107,11 +111,10 @@ cli({
         return results;
       })()
     `);
-        const limit = Number(kwargs.limit) || 20;
         const data = Array.isArray(payload)
             ? payload
             : [];
-        return data
+        const rows = data
             .filter((item) => item.title)
             .slice(0, limit)
             .map((item, i) => ({
@@ -119,6 +122,9 @@ cli({
             ...item,
             published_at: noteIdToDate(String(item.url ?? "")),
         }));
+        if (rows.length > 0)
+            return rows;
+        throw socialEmptyError("xiaohongshu", "search", `Xiaohongshu search loaded no parseable notes for "${String(kwargs.query)}".`);
     },
 });
 //# sourceMappingURL=search.js.map

package/dist/adapters/xiaohongshu/search.js.map

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

package/dist/adapters/xiaohongshu/trending.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @owner   Xiaohongshu trend extraction.
+ * @does    Reads trending searches, falling back to visible hot notes in Chrome.
+ * @needs   A logged-in Xiaohongshu browser session or valid local cookies.
+ * @feeds   Agents needing current XHS trend context without brittle API-only failure.
+ * @breaks  XHS endpoint and DOM drift can reduce rows; command returns only observed public UI data.
+ */
+export {};
+//# sourceMappingURL=trending.d.ts.map

package/dist/adapters/xiaohongshu/trending.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trending.d.ts","sourceRoot":"","sources":["../../../src/adapters/xiaohongshu/trending.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/adapters/xiaohongshu/trending.js

@@ -0,0 +1,94 @@
+/**
+ * @owner   Xiaohongshu trend extraction.
+ * @does    Reads trending searches, falling back to visible hot notes in Chrome.
+ * @needs   A logged-in Xiaohongshu browser session or valid local cookies.
+ * @feeds   Agents needing current XHS trend context without brittle API-only failure.
+ * @breaks  XHS endpoint and DOM drift can reduce rows; command returns only observed public UI data.
+ */
+import { cli, Strategy } from "../../registry.js";
+import { socialEmptyError } from "../../social/browser-errors.js";
+import { assertXhsReadable, fetchXhsFeedItems } from "./browser-state.js";
+async function fetchHotList(page, limit) {
+    const raw = await page.evaluate(`
+    (async () => {
+      const limit = ${limit};
+      const resp = await fetch('/api/sns/v1/search/hot_list', {
+        credentials: 'include',
+        headers: { 'Content-Type': 'application/json' }
+      });
+      if (!resp.ok) return { ok: false, status: resp.status };
+      const data = await resp.json();
+      const items = data?.data?.items || data?.data || [];
+      return {
+        ok: true,
+        rows: items.slice(0, limit).map((item, i) => {
+          const keyword = item.title || item.name || item.word || '';
+          return {
+            rank: i + 1,
+            keyword,
+            score: String(item.score || item.hot_value || ''),
+            url: 'https://www.xiaohongshu.com/search_result?keyword=' + encodeURIComponent(keyword),
+          };
+        }).filter((item) => item.keyword)
+      };
+    })()
+  `);
+    const result = raw;
+    return result.ok && Array.isArray(result.rows) ? result.rows : [];
+}
+async function fetchHotFeed(page, limit) {
+    const items = await fetchXhsFeedItems(page);
+    const rows = items
+        .map((item) => item)
+        .map((item) => {
+        const note = item.note_card;
+        const interact = note?.interact_info;
+        return {
+            title: String(note?.display_title ?? ""),
+            likes: String(interact?.liked_count ?? ""),
+            id: String(item.id ?? ""),
+        };
+    })
+        .filter((item) => item.title && item.id)
+        .sort((a, b) => Number(b.likes || 0) - Number(a.likes || 0))
+        .slice(0, limit);
+    return rows.map((item, i) => ({
+        rank: i + 1,
+        keyword: item.title,
+        score: item.likes,
+        url: `https://www.xiaohongshu.com/explore/${item.id}`,
+    }));
+}
+cli({
+    site: "xiaohongshu",
+    name: "trending",
+    description: "Xiaohongshu trending searches and visible hot notes",
+    domain: "www.xiaohongshu.com",
+    strategy: Strategy.COOKIE,
+    browser: true,
+    browserSession: "user",
+    args: [
+        {
+            name: "limit",
+            type: "int",
+            default: 20,
+            description: "Number of trending topics",
+        },
+    ],
+    columns: ["rank", "keyword", "score", "url"],
+    func: async (page, kwargs) => {
+        const p = page;
+        const limit = Number(kwargs.limit) || 20;
+        await p.goto("https://www.xiaohongshu.com/explore", { settleMs: 2500 });
+        await p.wait(2);
+        await assertXhsReadable(p, "trending");
+        const hotList = await fetchHotList(p, limit);
+        if (hotList.length > 0)
+            return hotList;
+        const hotFeed = await fetchHotFeed(p, limit);
+        if (hotFeed.length > 0)
+            return hotFeed;
+        throw socialEmptyError("xiaohongshu", "trending", "Xiaohongshu explore loaded no parseable hot-search or hot-note rows.");
+    },
+});
+//# sourceMappingURL=trending.js.map

package/dist/adapters/xiaohongshu/trending.js.map

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

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

@@ -4,5 +4,85 @@
  * Uses InnerTube "next" endpoint which returns engagement panels
  * including the comment section.
  */
+interface CommentRenderer {
+    commentRenderer?: {
+        commentId?: string;
+        authorText?: {
+            simpleText?: string;
+        };
+        contentText?: {
+            runs?: Array<{
+                text: string;
+            }>;
+        };
+        voteCount?: {
+            simpleText?: string;
+        };
+        replyCount?: number;
+        publishedTimeText?: {
+            runs?: Array<{
+                text: string;
+            }>;
+            simpleText?: string;
+        };
+    };
+}
+interface ReplyContinuationItem {
+    commentRenderer?: CommentRenderer["commentRenderer"];
+    continuationItemRenderer?: {
+        continuationEndpoint?: {
+            continuationCommand?: {
+                token?: string;
+            };
+        };
+    };
+}
+interface CommentSection {
+    itemSectionRenderer?: {
+        contents?: Array<{
+            commentThreadRenderer?: {
+                comment?: CommentRenderer;
+                replies?: {
+                    commentRepliesRenderer?: {
+                        contents?: ReplyContinuationItem[];
+                    };
+                };
+            };
+        }>;
+    };
+}
+interface NextEndpoint {
+    reloadContinuationItemsCommand?: {
+        continuationItems?: CommentSection[];
+    };
+    appendContinuationItemsAction?: {
+        continuationItems?: CommentSection[];
+    };
+}
+interface NextResponse {
+    onResponseReceivedEndpoints?: NextEndpoint[];
+    microformat?: {
+        microformatDataRenderer?: {
+            videoDetails?: {
+                comments?: Array<{
+                    text?: string;
+                    dateCreated?: string;
+                    upvoteCount?: string | number;
+                    author?: {
+                        name?: string;
+                        alternateName?: string;
+                    };
+                }>;
+            };
+        };
+    };
+}
+export declare function extractYouTubeCommentRows(data: NextResponse): {
+    rows: Array<Record<string, unknown>>;
+    replyContinuationTokens: Array<{
+        parentId: string;
+        token: string;
+    }>;
+};
 export {};
 //# sourceMappingURL=comments.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../../src/adapters/youtube/comments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../../src/adapters/youtube/comments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,UAAU,eAAe;IACvB,eAAe,CAAC,EAAE;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE;YAAE,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACrC,WAAW,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,CAAC;QACjD,SAAS,CAAC,EAAE;YAAE,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACpC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,iBAAiB,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC7E,CAAC;CACH;AAED,UAAU,qBAAqB;IAC7B,eAAe,CAAC,EAAE,eAAe,CAAC,iBAAiB,CAAC,CAAC;IACrD,wBAAwB,CAAC,EAAE;QACzB,oBAAoB,CAAC,EAAE;YACrB,mBAAmB,CAAC,EAAE;gBACpB,KAAK,CAAC,EAAE,MAAM,CAAC;aAChB,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED,UAAU,cAAc;IACtB,mBAAmB,CAAC,EAAE;QACpB,QAAQ,CAAC,EAAE,KAAK,CAAC;YACf,qBAAqB,CAAC,EAAE;gBACtB,OAAO,CAAC,EAAE,eAAe,CAAC;gBAC1B,OAAO,CAAC,EAAE;oBACR,sBAAsB,CAAC,EAAE;wBACvB,QAAQ,CAAC,EAAE,qBAAqB,EAAE,CAAC;qBACpC,CAAC;iBACH,CAAC;aACH,CAAC;SACH,CAAC,CAAC;KACJ,CAAC;CACH;AAED,UAAU,YAAY;IACpB,8BAA8B,CAAC,EAAE;QAC/B,iBAAiB,CAAC,EAAE,cAAc,EAAE,CAAC;KACtC,CAAC;IACF,6BAA6B,CAAC,EAAE;QAC9B,iBAAiB,CAAC,EAAE,cAAc,EAAE,CAAC;KACtC,CAAC;CACH;AAED,UAAU,YAAY;IACpB,2BAA2B,CAAC,EAAE,YAAY,EAAE,CAAC;IAC7C,WAAW,CAAC,EAAE;QACZ,uBAAuB,CAAC,EAAE;YACxB,YAAY,CAAC,EAAE;gBACb,QAAQ,CAAC,EAAE,KAAK,CAAC;oBACf,IAAI,CAAC,EAAE,MAAM,CAAC;oBACd,WAAW,CAAC,EAAE,MAAM,CAAC;oBACrB,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;oBAC9B,MAAM,CAAC,EAAE;wBACP,IAAI,CAAC,EAAE,MAAM,CAAC;wBACd,aAAa,CAAC,EAAE,MAAM,CAAC;qBACxB,CAAC;iBACH,CAAC,CAAC;aACJ,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAyCD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,YAAY,GAAG;IAC7D,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrC,uBAAuB,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrE,CAmDA"}

package/dist/adapters/youtube/comments.js

@@ -5,10 +5,39 @@
  * including the comment section.
  */
 import { cli, Strategy } from "../../registry.js";
+import { normalizeCommentRows } from "../../social/comments.js";
 import { innertubeFetch } from "./innertube.js";
-function extractComments(data) {
+function rowFromComment(c, parentId = "") {
+    return {
+        id: c.commentId ?? "",
+        parent_id: parentId,
+        author: c.authorText?.simpleText ?? "",
+        text: c.contentText?.runs?.map((r) => r.text).join("") ?? "",
+        likes: c.voteCount?.simpleText ?? "0",
+        replies: c.replyCount ?? 0,
+        created: c.publishedTimeText?.simpleText ??
+            c.publishedTimeText?.runs?.map((r) => r.text).join("") ??
+            "",
+    };
+}
+function extractReplyRows(items, parentId) {
+    const rows = [];
+    const continuationTokens = [];
+    for (const item of items) {
+        if (item.commentRenderer) {
+            rows.push(rowFromComment(item.commentRenderer, parentId));
+        }
+        const token = item.continuationItemRenderer?.continuationEndpoint?.continuationCommand
+            ?.token;
+        if (token)
+            continuationTokens.push(token);
+    }
+    return { rows, continuationTokens };
+}
+export function extractYouTubeCommentRows(data) {
     const endpoints = data.onResponseReceivedEndpoints ?? [];
-    const results = [];
+    const rows = [];
+    const replyContinuationTokens = [];
     for (const ep of endpoints) {
         const items = ep.reloadContinuationItemsCommand?.continuationItems ??
             ep.appendContinuationItemsAction?.continuationItems ??
@@ -16,19 +45,54 @@ function extractComments(data) {
         for (const section of items) {
             const contents = section.itemSectionRenderer?.contents ?? [];
             for (const thread of contents) {
-                const c = thread.commentThreadRenderer?.comment?.commentRenderer;
+                const renderer = thread.commentThreadRenderer;
+                const c = renderer?.comment?.commentRenderer;
                 if (!c)
                     continue;
-                results.push({
-                    author: c.authorText?.simpleText ?? "",
-                    text: c.contentText?.runs?.map((r) => r.text).join("") ?? "",
-                    likes: c.voteCount?.simpleText ?? "0",
-                    replies: c.replyCount ?? 0,
-                });
+                const rootRow = rowFromComment(c);
+                const parentId = String(rootRow.id ?? "");
+                rows.push(rootRow);
+                const replies = renderer?.replies?.commentRepliesRenderer?.contents;
+                if (!replies || !parentId)
+                    continue;
+                const extracted = extractReplyRows(replies, parentId);
+                rows.push(...extracted.rows);
+                for (const token of extracted.continuationTokens) {
+                    replyContinuationTokens.push({ parentId, token });
+                }
             }
         }
     }
-    return results;
+    if (rows.length === 0) {
+        const comments = data.microformat?.microformatDataRenderer?.videoDetails?.comments ?? [];
+        for (const [index, comment] of comments.entries()) {
+            rows.push({
+                id: `microformat:${index + 1}`,
+                author: comment.author?.alternateName ?? comment.author?.name ?? "",
+                text: comment.text ?? "",
+                likes: typeof comment.upvoteCount === "number"
+                    ? comment.upvoteCount
+                    : Number(comment.upvoteCount ?? 0),
+                replies: 0,
+                created: comment.dateCreated ?? "",
+            });
+        }
+    }
+    return { rows, replyContinuationTokens };
+}
+function extractContinuationReplyRows(data, parentId) {
+    const rows = [];
+    for (const ep of data.onResponseReceivedEndpoints ?? []) {
+        const items = ep.reloadContinuationItemsCommand?.continuationItems ??
+            ep.appendContinuationItemsAction?.continuationItems ??
+            [];
+        for (const item of items) {
+            const renderer = item.commentRenderer;
+            if (renderer)
+                rows.push(rowFromComment(renderer, parentId));
+        }
+    }
+    return rows;
 }
 cli({
     site: "youtube",
@@ -50,13 +114,45 @@ cli({
             default: 20,
             description: "Max comments to return",
         },
+        {
+            name: "with-replies",
+            type: "bool",
+            default: false,
+            description: "Fetch available nested replies",
+        },
+    ],
+    columns: [
+        "platform",
+        "content_id",
+        "comment_id",
+        "parent_id",
+        "depth",
+        "path",
+        "author",
+        "text",
+        "likes",
+        "replies",
+        "created",
     ],
-    columns: ["author", "text", "likes", "replies"],
     async func(_page, kwargs) {
         const videoId = kwargs.videoId;
         const limit = kwargs.limit ?? 20;
+        const withReplies = Boolean(kwargs["with-replies"]);
         const data = (await innertubeFetch("next", { videoId }));
-        return extractComments(data).slice(0, limit);
+        const extracted = extractYouTubeCommentRows(data);
+        const rows = extracted.rows.slice(0, limit);
+        if (withReplies) {
+            for (const continuation of extracted.replyContinuationTokens) {
+                const replyData = (await innertubeFetch("next", {
+                    continuation: continuation.token,
+                }));
+                rows.push(...extractContinuationReplyRows(replyData, continuation.parentId));
+            }
+        }
+        return normalizeCommentRows(rows, {
+            platform: "youtube",
+            contentId: videoId,
+        });
     },
 });
 //# sourceMappingURL=comments.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"comments.js","sourceRoot":"","sources":["../../../src/adapters/youtube/comments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAkChD,SAAS,eAAe,CAAC,IAAkB;IACzC,MAAM,SAAS,GAAG,IAAI,CAAC,2BAA2B,IAAI,EAAE,CAAC;IACzD,MAAM,OAAO,GAAmC,EAAE,CAAC;IAEnD,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;QAC3B,MAAM,KAAK,GACT,EAAE,CAAC,8BAA8B,EAAE,iBAAiB;YACpD,EAAE,CAAC,6BAA6B,EAAE,iBAAiB;YACnD,EAAE,CAAC;QAEL,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,mBAAmB,EAAE,QAAQ,IAAI,EAAE,CAAC;YAC7D,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;gBAC9B,MAAM,CAAC,GAAG,MAAM,CAAC,qBAAqB,EAAE,OAAO,EAAE,eAAe,CAAC;gBACjE,IAAI,CAAC,CAAC;oBAAE,SAAS;gBACjB,OAAO,CAAC,IAAI,CAAC;oBACX,MAAM,EAAE,CAAC,CAAC,UAAU,EAAE,UAAU,IAAI,EAAE;oBACtC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE;oBAC5D,KAAK,EAAE,CAAC,CAAC,SAAS,EAAE,UAAU,IAAI,GAAG;oBACrC,OAAO,EAAE,CAAC,CAAC,UAAU,IAAI,CAAC;iBAC3B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,GAAG,CAAC;IACF,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,4BAA4B;IACzC,MAAM,EAAE,iBAAiB;IACzB,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,kBAAkB;SAChC;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,wBAAwB;SACtC;KACF;IACD,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM;QACtB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAiB,CAAC;QACzC,MAAM,KAAK,GAAI,MAAM,CAAC,KAAgB,IAAI,EAAE,CAAC;QAE7C,MAAM,IAAI,GAAG,CAAC,MAAM,cAAc,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAiB,CAAC;QAEzE,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"comments.js","sourceRoot":"","sources":["../../../src/adapters/youtube/comments.ts"],"names":[],"mappings":"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"}

package/dist/adapters/youtube/subtitles.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @owner   YouTube subtitle adapter.
+ * @does    Extracts LLM-readable subtitle text from public YouTube video URLs.
+ * @needs   `yt-dlp` on PATH and an accessible video subtitle track.
+ * @feeds   Search-to-transcript social video analysis workflows.
+ * @breaks  Upstream yt-dlp extractor changes can alter subtitle availability.
+ */
+export {};
+//# sourceMappingURL=subtitles.d.ts.map

package/dist/adapters/youtube/subtitles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtitles.d.ts","sourceRoot":"","sources":["../../../src/adapters/youtube/subtitles.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/adapters/youtube/subtitles.js

@@ -0,0 +1,42 @@
+/**
+ * @owner   YouTube subtitle adapter.
+ * @does    Extracts LLM-readable subtitle text from public YouTube video URLs.
+ * @needs   `yt-dlp` on PATH and an accessible video subtitle track.
+ * @feeds   Search-to-transcript social video analysis workflows.
+ * @breaks  Upstream yt-dlp extractor changes can alter subtitle availability.
+ */
+import { cli, Strategy } from "../../registry.js";
+import { runVideoSubtitleExtraction } from "../../social/video-text.js";
+cli({
+    site: "youtube",
+    name: "subtitles",
+    description: "Extract LLM-readable subtitles from a YouTube video URL with optional browser-cookie reuse",
+    domain: "www.youtube.com",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "url",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "YouTube 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/youtube/subtitles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtitles.js","sourceRoot":"","sources":["../../../src/adapters/youtube/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,SAAS;IACf,IAAI,EAAE,WAAW;IACjB,WAAW,EACT,4FAA4F;IAC9F,MAAM,EAAE,iBAAiB;IACzB,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,mBAAmB;YAChC,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/yt-dlp/subtitles.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @owner   yt-dlp subtitle adapter.
+ * @does    Extracts subtitle files from any yt-dlp-supported video URL.
+ * @needs   Local yt-dlp binary and optional browser cookies for private or rate-limited videos.
+ * @feeds   Unified social video-text workflows across YouTube, Bilibili, TikTok, Douyin, X, Instagram, and other sites.
+ * @breaks  Returns an error when yt-dlp cannot produce subtitle files for the requested URL and languages.
+ */
+export {};
+//# sourceMappingURL=subtitles.d.ts.map

package/dist/adapters/yt-dlp/subtitles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtitles.d.ts","sourceRoot":"","sources":["../../../src/adapters/yt-dlp/subtitles.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/adapters/yt-dlp/subtitles.js

@@ -0,0 +1,41 @@
+/**
+ * @owner   yt-dlp subtitle adapter.
+ * @does    Extracts subtitle files from any yt-dlp-supported video URL.
+ * @needs   Local yt-dlp binary and optional browser cookies for private or rate-limited videos.
+ * @feeds   Unified social video-text workflows across YouTube, Bilibili, TikTok, Douyin, X, Instagram, and other sites.
+ * @breaks  Returns an error when yt-dlp cannot produce subtitle files for the requested URL and languages.
+ */
+import { cli, Strategy } from "../../registry.js";
+import { runVideoSubtitleExtraction } from "../../social/video-text.js";
+cli({
+    site: "yt-dlp",
+    name: "subtitles",
+    description: "Extract subtitles from any yt-dlp-supported video URL with optional browser-cookie reuse",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "url",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "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/yt-dlp/subtitles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtitles.js","sourceRoot":"","sources":["../../../src/adapters/yt-dlp/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,QAAQ;IACd,IAAI,EAAE,WAAW;IACjB,WAAW,EACT,0FAA0F;IAC5F,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,WAAW;YACxB,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/zhihu/answer-detail.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @owner   src/adapters/zhihu/answer-detail.ts
+ * @does    Register full-content Zhihu answer detail reader.
+ * @needs   Logged-in Zhihu browser session, answer API payload, exact answer target parsing.
+ * @feeds   surface coverage ledger, long-form answer extraction workflows, reference parity checks.
+ * @breaks  Zhihu answer URL shape or API content field drift can block answer detail extraction.
+ */
+interface ZhihuAnswerTarget {
+    answerId: string;
+    questionId: string;
+}
+interface ZhihuAnswerPayload {
+    id?: unknown;
+    content?: unknown;
+    voteup_count?: unknown;
+    comment_count?: unknown;
+    created_time?: unknown;
+    updated_time?: unknown;
+    author?: {
+        name?: unknown;
+    };
+    question?: {
+        id?: unknown;
+        title?: unknown;
+        url?: unknown;
+    };
+    error?: {
+        message?: unknown;
+    };
+    error_msg?: unknown;
+    message?: unknown;
+}
+export declare function stripZhihuAnswerHtml(value: unknown): string;
+export declare function parseZhihuAnswerTarget(input: unknown): ZhihuAnswerTarget;
+export declare function extractQuestionIdFromZhihuUrl(input: unknown): string;
+export declare function parseMaxContent(value: unknown): number;
+export declare function mapZhihuAnswerDetail(payload: ZhihuAnswerPayload, target: ZhihuAnswerTarget, currentQuestionId: string, maxContent: number): Record<string, unknown>;
+export {};
+//# sourceMappingURL=answer-detail.d.ts.map

package/dist/adapters/zhihu/answer-detail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer-detail.d.ts","sourceRoot":"","sources":["../../../src/adapters/zhihu/answer-detail.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,UAAU,iBAAiB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,kBAAkB;IAC1B,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5D,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA2BD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAa3D;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAiCxE;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAiBpE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMtD;AAoCD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,iBAAiB,EACzB,iBAAiB,EAAE,MAAM,EACzB,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoCzB"}