@zenalexa/unicli 0.220.0 → 0.221.0

package/dist/adapters/zhihu/answer-detail.js

@@ -0,0 +1,204 @@
+/**
+ * @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.
+ */
+import { cli, Strategy } from "../../registry.js";
+const ANSWER_ID_RE = /^\d+$/;
+const ANSWER_TYPED_RE = /^answer:(\d+):(\d+)$/;
+const ANSWER_PATH_RE = /^\/question\/(\d+)\/answer\/(\d+)\/?$/;
+const BARE_ANSWER_PATH_RE = /^\/answer\/(\d+)\/?$/;
+const QUESTION_PATH_RE = /^\/question\/(\d+)\/?$/;
+const QUESTION_API_PATH_RE = /^\/api\/v4\/questions\/(\d+)\/?$/;
+function stringField(value) {
+    return value === undefined || value === null ? "" : String(value);
+}
+function countField(value) {
+    const n = Number(value);
+    return Number.isInteger(n) && n >= 0 ? n : 0;
+}
+function isoFromUnixSeconds(value) {
+    const n = Number(value);
+    return Number.isFinite(n) && n > 0 ? new Date(n * 1000).toISOString() : "";
+}
+function pageOf(page) {
+    if (!page)
+        throw new Error("Zhihu answer-detail requires a browser page.");
+    return page;
+}
+export function stripZhihuAnswerHtml(value) {
+    return stringField(value)
+        .replace(/<br\s*\/?\s*>/gi, "\n")
+        .replace(/<\/(?:p|div|h[1-6]|li|blockquote)>/gi, "\n\n")
+        .replace(/<[^>]+>/g, "")
+        .replace(/&nbsp;/g, " ")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&amp;/g, "&")
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+}
+export function parseZhihuAnswerTarget(input) {
+    const value = stringField(input).trim();
+    if (!value) {
+        throw new Error("Zhihu answer target must be a numeric id, answer URL, or answer:<questionId>:<answerId>.");
+    }
+    if (ANSWER_ID_RE.test(value))
+        return { answerId: value, questionId: "" };
+    const typed = value.match(ANSWER_TYPED_RE);
+    if (typed)
+        return { questionId: typed[1], answerId: typed[2] };
+    try {
+        const url = new URL(value);
+        if (url.protocol !== "https:" ||
+            url.username ||
+            url.password ||
+            url.port ||
+            (url.hostname !== "www.zhihu.com" && url.hostname !== "zhihu.com")) {
+            throw new Error("invalid host");
+        }
+        let match = url.pathname.match(ANSWER_PATH_RE);
+        if (match)
+            return { questionId: match[1], answerId: match[2] };
+        match = url.pathname.match(BARE_ANSWER_PATH_RE);
+        if (match)
+            return { questionId: "", answerId: match[1] };
+    }
+    catch {
+        throw new Error("Zhihu answer target must be a numeric id, answer URL, or answer:<questionId>:<answerId>.");
+    }
+    throw new Error("Zhihu answer target must be a numeric id, answer URL, or answer:<questionId>:<answerId>.");
+}
+export function extractQuestionIdFromZhihuUrl(input) {
+    const value = stringField(input).trim();
+    if (!value)
+        return "";
+    if (!URL.canParse(value))
+        return "";
+    const url = new URL(value);
+    if (url.protocol !== "https:" ||
+        (url.hostname !== "www.zhihu.com" && url.hostname !== "zhihu.com")) {
+        return "";
+    }
+    return (url.pathname.match(ANSWER_PATH_RE)?.[1] ??
+        url.pathname.match(QUESTION_PATH_RE)?.[1] ??
+        url.pathname.match(QUESTION_API_PATH_RE)?.[1] ??
+        "");
+}
+export function parseMaxContent(value) {
+    const n = value === undefined || value === null ? 0 : Number(value);
+    if (!Number.isInteger(n) || n < 0) {
+        throw new Error("--max-content must be a non-negative integer.");
+    }
+    return n;
+}
+async function browserFetchJson(page, url) {
+    const raw = await page.evaluate(`(async () => {
+    const response = await fetch(${JSON.stringify(url)}, {
+      credentials: "include",
+      headers: { Accept: "application/json" }
+    });
+    const text = await response.text();
+    return JSON.stringify({ ok: response.ok, status: response.status, text });
+  })()`);
+    const result = JSON.parse(stringField(raw));
+    if (!result.ok) {
+        if (result.status === 401 || result.status === 403) {
+            throw new Error(`Zhihu answer-detail requires Zhihu cookies (HTTP ${result.status}).`);
+        }
+        if (result.status === 404) {
+            throw new Error("No Zhihu answer was found for the requested id.");
+        }
+        throw new Error(`Zhihu answer-detail request failed (HTTP ${result.status}).`);
+    }
+    try {
+        return JSON.parse(result.text);
+    }
+    catch (err) {
+        throw new Error(`Zhihu answer-detail returned malformed JSON: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+export function mapZhihuAnswerDetail(payload, target, currentQuestionId, maxContent) {
+    if (payload.error || payload.error_msg || payload.message) {
+        throw new Error(`Zhihu answer-detail returned an error payload: ${stringField(payload.error?.message ?? payload.error_msg ?? payload.message)}`);
+    }
+    if (!Object.prototype.hasOwnProperty.call(payload, "content")) {
+        throw new Error("Zhihu answer-detail payload did not include content.");
+    }
+    const question = payload.question ?? {};
+    const questionId = target.questionId ||
+        currentQuestionId ||
+        extractQuestionIdFromZhihuUrl(question.url) ||
+        stringField(question.id);
+    const stripped = stripZhihuAnswerHtml(payload.content);
+    const content = maxContent > 0 && stripped.length > maxContent
+        ? stripped.slice(0, maxContent)
+        : stripped;
+    return {
+        id: target.answerId || stringField(payload.id),
+        author: stringField(payload.author?.name) || "anonymous",
+        votes: countField(payload.voteup_count),
+        comments: countField(payload.comment_count),
+        question_id: questionId,
+        question_title: stringField(question.title),
+        url: questionId
+            ? `https://www.zhihu.com/question/${questionId}/answer/${target.answerId}`
+            : `https://www.zhihu.com/answer/${target.answerId}`,
+        created_at: isoFromUnixSeconds(payload.created_time),
+        updated_at: isoFromUnixSeconds(payload.updated_time),
+        content,
+    };
+}
+cli({
+    site: "zhihu",
+    name: "answer-detail",
+    description: "知乎单个回答完整内容（按 answer ID 获取）",
+    domain: "www.zhihu.com",
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [
+        {
+            name: "id",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Answer ID, full Zhihu answer URL, or typed target",
+        },
+        {
+            name: "max-content",
+            type: "int",
+            default: 0,
+            description: "Optional cap on stripped content length; 0 returns full content",
+        },
+    ],
+    columns: [
+        "id",
+        "author",
+        "votes",
+        "comments",
+        "question_id",
+        "question_title",
+        "url",
+        "created_at",
+        "updated_at",
+        "content",
+    ],
+    func: async (page, kwargs) => {
+        const browser = pageOf(page);
+        const target = parseZhihuAnswerTarget(kwargs.id);
+        const maxContent = parseMaxContent(kwargs["max-content"]);
+        await browser.goto(`https://www.zhihu.com/answer/${target.answerId}`);
+        const currentQuestionId = extractQuestionIdFromZhihuUrl(await browser.url());
+        const apiUrl = new URL(`https://www.zhihu.com/api/v4/answers/${target.answerId}`);
+        apiUrl.searchParams.set("include", "content,voteup_count,comment_count,author,created_time,updated_time,question");
+        const payload = (await browserFetchJson(browser, apiUrl.toString()));
+        return [
+            mapZhihuAnswerDetail(payload, target, currentQuestionId, maxContent),
+        ];
+    },
+});
+//# sourceMappingURL=answer-detail.js.map

package/dist/adapters/zhihu/answer-detail.js.map

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

package/dist/adapters/zhihu/comment.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @owner   Zhihu comment adapter.
+ * @does    Reads Zhihu answer/article comments and normalizes nested child comments.
+ * @needs   Zhihu comment_v5 API and z_c0 cookie for authenticated access.
+ * @feeds   Social comment tree analysis for Zhihu answers and articles.
+ * @breaks  Zhihu API shape, auth cookie requirements, or anti-bot policy changes.
+ */
+export declare function extractZhihuCommentRows(response: unknown): Array<Record<string, unknown>>;
+//# sourceMappingURL=comment.d.ts.map

package/dist/adapters/zhihu/comment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment.d.ts","sourceRoot":"","sources":["../../../src/adapters/zhihu/comment.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0DH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,OAAO,GAChB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAehC"}

package/dist/adapters/zhihu/comment.js

@@ -0,0 +1,149 @@
+/**
+ * @owner   Zhihu comment adapter.
+ * @does    Reads Zhihu answer/article comments and normalizes nested child comments.
+ * @needs   Zhihu comment_v5 API and z_c0 cookie for authenticated access.
+ * @feeds   Social comment tree analysis for Zhihu answers and articles.
+ * @breaks  Zhihu API shape, auth cookie requirements, or anti-bot policy changes.
+ */
+import { USER_AGENT } from "../../constants.js";
+import { loadCookiesWithCDP, formatCookieHeader, } from "../../engine/cookies.js";
+import { cli, Strategy } from "../../registry.js";
+import { normalizeCommentRows } from "../../social/comments.js";
+function stripHtml(value) {
+    return value
+        .replace(/<[^>]+>/g, "")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+function zhihuCreated(value) {
+    return value ? new Date(value * 1000).toISOString() : "";
+}
+function zhihuCommentToRow(item, parentId = "") {
+    const id = item.id === undefined ? "" : String(item.id);
+    return {
+        id,
+        parent_id: parentId,
+        author: item.author?.name ?? "",
+        content: stripHtml(item.content ?? ""),
+        text: stripHtml(item.content ?? ""),
+        likes: item.like_count ?? 0,
+        replies: item.child_comment_count ?? item.child_comments?.length ?? 0,
+        created: zhihuCreated(item.created_time),
+        reply_to: item.reply_to_author?.name ?? "",
+    };
+}
+export function extractZhihuCommentRows(response) {
+    const data = response.data;
+    if (!Array.isArray(data)) {
+        throw new Error("Unexpected Zhihu comments response");
+    }
+    const rows = [];
+    for (const root of data) {
+        const rootRow = zhihuCommentToRow(root);
+        rows.push(rootRow);
+        const rootId = String(rootRow.id ?? "");
+        for (const child of root.child_comments ?? []) {
+            rows.push(zhihuCommentToRow(child, rootId));
+        }
+    }
+    return rows;
+}
+async function zhihuHeaders() {
+    const headers = {
+        "User-Agent": USER_AGENT,
+        Accept: "application/json",
+        Referer: "https://www.zhihu.com/",
+    };
+    const cookies = await loadCookiesWithCDP("zhihu", "www.zhihu.com");
+    if (cookies)
+        headers.Cookie = formatCookieHeader(cookies);
+    return headers;
+}
+async function fetchZhihuJson(url, headers) {
+    const response = await fetch(url, { headers });
+    if (!response.ok) {
+        throw new Error(`Zhihu comments request failed: ${response.status}`);
+    }
+    return response.json();
+}
+cli({
+    site: "zhihu",
+    name: "comment",
+    description: "Get Zhihu comments with normalized nested reply hierarchy",
+    domain: "www.zhihu.com",
+    strategy: Strategy.COOKIE,
+    args: [
+        {
+            name: "type",
+            required: true,
+            positional: true,
+            description: "Content type: answer or article",
+            choices: ["answer", "article"],
+        },
+        {
+            name: "id",
+            required: true,
+            positional: true,
+            description: "Answer or article ID",
+            "x-unicli-kind": "id",
+        },
+        {
+            name: "limit",
+            type: "int",
+            default: 20,
+            description: "Number of root comments",
+        },
+        {
+            name: "with-replies",
+            type: "bool",
+            default: false,
+            description: "Fetch child replies for root comments that omit child_comments",
+        },
+    ],
+    columns: [
+        "platform",
+        "content_id",
+        "comment_id",
+        "parent_id",
+        "depth",
+        "path",
+        "author",
+        "text",
+        "likes",
+        "replies",
+        "created",
+        "content",
+        "reply_to",
+    ],
+    socialCapabilities: ["read", "comments", "comment_replies"],
+    func: async (_page, kwargs) => {
+        const type = String(kwargs.type);
+        const id = String(kwargs.id);
+        const limit = Number(kwargs.limit ?? 20);
+        const withReplies = Boolean(kwargs["with-replies"]);
+        const headers = await zhihuHeaders();
+        const rootUrl = `https://www.zhihu.com/api/v4/comment_v5/${encodeURIComponent(type)}s/${encodeURIComponent(id)}/root_comment?limit=${encodeURIComponent(String(limit))}&offset=0&order_by=score`;
+        const rootJson = await fetchZhihuJson(rootUrl, headers);
+        const rows = extractZhihuCommentRows(rootJson);
+        if (withReplies) {
+            const roots = rootJson.data ?? [];
+            for (const root of roots) {
+                const rootId = root.id === undefined ? "" : String(root.id);
+                if (!rootId || (root.child_comments?.length ?? 0) > 0)
+                    continue;
+                if ((root.child_comment_count ?? 0) <= 0)
+                    continue;
+                const childUrl = `https://www.zhihu.com/api/v4/comment_v5/comment/${encodeURIComponent(rootId)}/child_comment?limit=20&offset=0&order_by=score`;
+                const childJson = await fetchZhihuJson(childUrl, headers);
+                for (const child of childJson.data ?? []) {
+                    rows.push(zhihuCommentToRow(child, rootId));
+                }
+            }
+        }
+        return normalizeCommentRows(rows, {
+            platform: "zhihu",
+            contentId: `${type}:${id}`,
+        });
+    },
+});
+//# sourceMappingURL=comment.js.map

package/dist/adapters/zhihu/comment.js.map

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

package/dist/adapters/zhihu/recommend.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @owner   src/adapters/zhihu/recommend.ts
+ * @does    Register paginated Zhihu home recommendation reader.
+ * @needs   Logged-in Zhihu browser session, topstory recommendation API, bounded page traversal.
+ * @feeds   surface coverage ledger, Zhihu discovery workflows, reference parity checks.
+ * @breaks  Zhihu recommendation API paging or target shape drift can block feed extraction.
+ */
+interface ZhihuRecommendItem {
+    id?: unknown;
+    type?: unknown;
+    target?: {
+        id?: unknown;
+        type?: unknown;
+        title?: unknown;
+        question?: {
+            id?: unknown;
+            title?: unknown;
+        };
+        author?: {
+            name?: unknown;
+        };
+        voteup_count?: unknown;
+        reaction?: {
+            statistics?: {
+                like_count?: unknown;
+            };
+        };
+    };
+}
+export declare function parseZhihuRecommendLimit(value: unknown): number;
+export declare function zhihuRecommendItemKey(item: ZhihuRecommendItem): string;
+export declare function normalizeZhihuRecommendTitle(item: ZhihuRecommendItem): string;
+export declare function normalizeZhihuRecommendUrl(item: ZhihuRecommendItem): string;
+export declare function mapZhihuRecommendItem(item: ZhihuRecommendItem, rank: number): Record<string, unknown>;
+export {};
+//# sourceMappingURL=recommend.d.ts.map

package/dist/adapters/zhihu/recommend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommend.d.ts","sourceRoot":"","sources":["../../../src/adapters/zhihu/recommend.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,UAAU,kBAAkB;IAC1B,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE;QACP,EAAE,CAAC,EAAE,OAAO,CAAC;QACb,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,QAAQ,CAAC,EAAE;YAAE,EAAE,CAAC,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;QAC7C,MAAM,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;QAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,QAAQ,CAAC,EAAE;YAAE,UAAU,CAAC,EAAE;gBAAE,UAAU,CAAC,EAAE,OAAO,CAAA;aAAE,CAAA;SAAE,CAAC;KACtD,CAAC;CACH;AA8BD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQ/D;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAStE;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAI7E;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAgB3E;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,kBAAkB,EACxB,IAAI,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzB"}

package/dist/adapters/zhihu/recommend.js

@@ -0,0 +1,151 @@
+/**
+ * @owner   src/adapters/zhihu/recommend.ts
+ * @does    Register paginated Zhihu home recommendation reader.
+ * @needs   Logged-in Zhihu browser session, topstory recommendation API, bounded page traversal.
+ * @feeds   surface coverage ledger, Zhihu discovery workflows, reference parity checks.
+ * @breaks  Zhihu recommendation API paging or target shape drift can block feed extraction.
+ */
+import { cli, Strategy } from "../../registry.js";
+const MAX_RECOMMEND_LIMIT = 1000;
+function stringField(value) {
+    return value === undefined || value === null ? "" : String(value);
+}
+function countField(value) {
+    const n = Number(value);
+    return Number.isInteger(n) && n >= 0 ? n : 0;
+}
+function pageOf(page) {
+    if (!page)
+        throw new Error("Zhihu recommend requires a browser page.");
+    return page;
+}
+export function parseZhihuRecommendLimit(value) {
+    const n = value === undefined || value === null ? 20 : Number(value);
+    if (!Number.isInteger(n) || n <= 0 || n > MAX_RECOMMEND_LIMIT) {
+        throw new Error(`Zhihu recommend limit must be a positive integer no greater than ${MAX_RECOMMEND_LIMIT}.`);
+    }
+    return n;
+}
+export function zhihuRecommendItemKey(item) {
+    const target = item.target ?? {};
+    if (target.id !== undefined && target.id !== null) {
+        return `${stringField(target.type)}:${stringField(target.id)}`;
+    }
+    if (item.id !== undefined && item.id !== null) {
+        return `feed:${stringField(item.id)}`;
+    }
+    return "";
+}
+export function normalizeZhihuRecommendTitle(item) {
+    const target = item.target ?? {};
+    if (target.type === "answer")
+        return stringField(target.question?.title);
+    return stringField(target.title || target.question?.title);
+}
+export function normalizeZhihuRecommendUrl(item) {
+    const target = item.target ?? {};
+    const id = stringField(target.id);
+    if (target.type === "answer") {
+        const questionId = stringField(target.question?.id);
+        return questionId && id
+            ? `https://www.zhihu.com/question/${questionId}/answer/${id}`
+            : "";
+    }
+    if (target.type === "article") {
+        return id ? `https://zhuanlan.zhihu.com/p/${id}` : "";
+    }
+    if (target.type === "question") {
+        return id ? `https://www.zhihu.com/question/${id}` : "";
+    }
+    return "";
+}
+export function mapZhihuRecommendItem(item, rank) {
+    const target = item.target ?? {};
+    return {
+        rank,
+        type: stringField(target.type || item.type),
+        title: normalizeZhihuRecommendTitle(item),
+        author: stringField(target.author?.name),
+        votes: countField(target.voteup_count ?? target.reaction?.statistics?.like_count),
+        url: normalizeZhihuRecommendUrl(item),
+    };
+}
+async function browserFetchRecommend(page, url) {
+    const raw = await page.evaluate(`(async () => {
+    const response = await fetch(${JSON.stringify(url)}, {
+      credentials: "include",
+      headers: { Accept: "application/json" }
+    });
+    const text = await response.text();
+    return JSON.stringify({ ok: response.ok, status: response.status, text });
+  })()`);
+    const result = JSON.parse(stringField(raw));
+    if (!result.ok) {
+        if (result.status === 401 || result.status === 403) {
+            throw new Error(`Zhihu recommend requires Zhihu cookies (HTTP ${result.status}).`);
+        }
+        throw new Error(`Zhihu recommend request failed (HTTP ${result.status}).`);
+    }
+    try {
+        return JSON.parse(result.text);
+    }
+    catch (err) {
+        throw new Error(`Zhihu recommend returned malformed JSON: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+async function collectZhihuRecommendations(page, limit) {
+    const items = [];
+    const seen = new Set();
+    const visited = new Set();
+    let url = "https://www.zhihu.com/api/v3/feed/topstory/recommend?limit=10&desktop=true";
+    while (url && items.length < limit && !visited.has(url)) {
+        visited.add(url);
+        const data = await browserFetchRecommend(page, url);
+        const rows = Array.isArray(data.data) ? data.data : [];
+        for (const item of rows) {
+            const key = zhihuRecommendItemKey(item);
+            if (key) {
+                if (seen.has(key))
+                    continue;
+                seen.add(key);
+            }
+            items.push(item);
+            if (items.length >= limit)
+                break;
+        }
+        if (data.paging?.is_end)
+            break;
+        url = typeof data.paging?.next === "string" ? data.paging.next : "";
+    }
+    if (items.length === 0) {
+        throw new Error("No Zhihu recommendations returned.");
+    }
+    return items;
+}
+cli({
+    site: "zhihu",
+    name: "recommend",
+    description: "知乎首页推荐",
+    domain: "www.zhihu.com",
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [
+        {
+            name: "limit",
+            type: "int",
+            default: 20,
+            description: "Number of items to return (max 1000; use normal-sized requests)",
+        },
+    ],
+    columns: ["rank", "type", "title", "author", "votes", "url"],
+    func: async (page, kwargs) => {
+        const browser = pageOf(page);
+        const limit = parseZhihuRecommendLimit(kwargs.limit);
+        await browser.goto("https://www.zhihu.com");
+        const items = await collectZhihuRecommendations(browser, limit);
+        return items
+            .slice(0, limit)
+            .map((item, index) => mapZhihuRecommendItem(item, index + 1));
+    },
+});
+//# sourceMappingURL=recommend.js.map

package/dist/adapters/zhihu/recommend.js.map

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

package/dist/agents/codex-pack.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @owner Uni-CLI Agents
+ * @does Builds the compact Codex install pack from CommandContract metadata.
+ * @needs Adapter registry snapshots and command-contract projection.
+ * @feeds `unicli agents generate --for codex`, docs, and F4 release gates.
+ * @breaks Codex onboarding when it enumerates the catalog or exposes expanded MCP by default.
+ */
+import type { AdapterManifest } from "../types.js";
+export interface CodexPackInput {
+    version: string;
+    date: string;
+    adapters: AdapterManifest[];
+}
+export interface CodexSmokeTask {
+    name: string;
+    command: string;
+    proves: string;
+}
+export interface CodexPack {
+    schema_version: "codex-pack.v1";
+    package: string;
+    version: string;
+    date: string;
+    default_surface: "native_cli_plus_deferred_mcp";
+    counts: {
+        sites: number;
+        commands: number;
+    };
+    mcp_config: {
+        command: "npx";
+        args: string[];
+    };
+    tool_exposure: {
+        default_tools: number;
+        deferred_stubs: number;
+        expanded_tools: number;
+        expanded_opt_in: true;
+    };
+    contract_summary: {
+        schema_version: "command-contract.v1";
+        read_only: number;
+        write_or_destructive: number;
+        auth_required: number;
+        browser_backed: number;
+        artifact_producers: number;
+    };
+    deferred_toolsearch: {
+        source: "CommandContract";
+        tool_name_pattern: "unicli_<site>_<command>";
+        loaded_fields: string[];
+        full_schema_resolution: "tools/call via expandedRegistry";
+    };
+    smoke_tasks: CodexSmokeTask[];
+    token_budget: {
+        method: "heuristic-o200k";
+        estimated_tokens: number;
+        chars: number;
+    };
+}
+export declare function formatCodexPack(pack: CodexPack): string;
+export declare function buildCodexPack(input: CodexPackInput): CodexPack;
+//# sourceMappingURL=codex-pack.d.ts.map

package/dist/agents/codex-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-pack.d.ts","sourceRoot":"","sources":["../../src/agents/codex-pack.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,cAAc,EAAE,eAAe,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,8BAA8B,CAAC;IAChD,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,UAAU,EAAE;QACV,OAAO,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;IACF,aAAa,EAAE;QACb,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,IAAI,CAAC;KACvB,CAAC;IACF,gBAAgB,EAAE;QAChB,cAAc,EAAE,qBAAqB,CAAC;QACtC,SAAS,EAAE,MAAM,CAAC;QAClB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,mBAAmB,EAAE;QACnB,MAAM,EAAE,iBAAiB,CAAC;QAC1B,iBAAiB,EAAE,yBAAyB,CAAC;QAC7C,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,sBAAsB,EAAE,iCAAiC,CAAC;KAC3D,CAAC;IACF,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,YAAY,EAAE;QACZ,MAAM,EAAE,iBAAiB,CAAC;QAC1B,gBAAgB,EAAE,MAAM,CAAC;QACzB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AA8GD,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CA6CvD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAO/D"}