@zenalexa/unicli 0.219.0 → 0.220.1

package/dist/adapters/yuanbao/web.js

@@ -0,0 +1,365 @@
+/**
+ * @owner   src/adapters/yuanbao/web.ts
+ * @does    Register agent-facing Yuanbao web conversation commands implemented with site-specific safety checks.
+ * @needs   Logged-in yuanbao.tencent.com browser session, Yuanbao chat DOM, complete agent/session identifiers.
+ * @feeds   surface coverage ledger, Yuanbao read/send/history/detail/status workflows.
+ * @breaks  Yuanbao DOM selector drift or accepting bare UUIDs can read/send the wrong session.
+ */
+import { cli, Strategy } from "../../registry.js";
+import { intArg, js, str } from "../_shared/browser-tools.js";
+const YUANBAO_HOME = "https://yuanbao.tencent.com/";
+const AGENT_ID_RE = /^[A-Za-z0-9_-]{4,40}$/;
+const CONV_ID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const VISIBLE_JS = `const isVisible = (node) => {
+  if (!(node instanceof HTMLElement)) return false;
+  const rect = node.getBoundingClientRect();
+  const style = window.getComputedStyle(node);
+  return rect.width > 0 && rect.height > 0 && style.display !== 'none' && style.visibility !== 'hidden';
+};`;
+export function parseYuanbaoSessionId(value) {
+    const raw = str(value).trim();
+    if (!raw) {
+        throw new Error('Yuanbao id must be a non-empty chat URL or "<agentId>/<convId>" pair.');
+    }
+    const urlMatch = raw.match(/yuanbao\.tencent\.com\/chat\/([A-Za-z0-9_-]+)\/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})(?:[/?#]|$)/i);
+    if (urlMatch?.[1] && urlMatch[2]) {
+        return validateYuanbaoSession(urlMatch[1], urlMatch[2], raw);
+    }
+    const pairMatch = raw.match(/^([A-Za-z0-9_-]+)\/([0-9a-f-]{36})$/i);
+    if (pairMatch?.[1] && pairMatch[2]) {
+        return validateYuanbaoSession(pairMatch[1], pairMatch[2], raw);
+    }
+    throw new Error(`Invalid Yuanbao session reference: ${raw}. Pass https://yuanbao.tencent.com/chat/<agentId>/<convId> or "<agentId>/<convId>"; a UUID alone is not enough.`);
+}
+function validateYuanbaoSession(agentId, convId, source) {
+    if (!AGENT_ID_RE.test(agentId) || !CONV_ID_RE.test(convId)) {
+        throw new Error(`Invalid Yuanbao session reference: ${source}.`);
+    }
+    return { agentId, convId: convId.toLowerCase() };
+}
+function yuanbaoSessionUrl(session) {
+    return `${YUANBAO_HOME}chat/${session.agentId}/${session.convId}`;
+}
+export function yuanbaoHtmlToMarkdown(value) {
+    return str(value)
+        .replace(/<br\s*\/?>/gi, "\n")
+        .replace(/<\/(p|div|li|h[1-6]|pre)>/gi, "\n")
+        .replace(/<[^>]+>/g, " ")
+        .replace(/&nbsp;/g, " ")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&amp;/g, "&")
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/[ \t]+\n/g, "\n")
+        .replace(/\n{3,}/g, "\n\n")
+        .replace(/[ \t]{2,}/g, " ")
+        .trim();
+}
+export function mapYuanbaoBubbles(bubbles) {
+    return bubbles
+        .map((bubble) => {
+        const role = str(bubble.role) === "Assistant" ? "Assistant" : "User";
+        const text = role === "Assistant" && str(bubble.html).trim()
+            ? yuanbaoHtmlToMarkdown(bubble.html) || str(bubble.text)
+            : str(bubble.text);
+        return {
+            Role: role,
+            Text: text.trim(),
+        };
+    })
+        .filter((row) => row.Text);
+}
+export function mapYuanbaoSessions(sessions) {
+    return sessions
+        .map((session, index) => {
+        const cid = str(session.cid).toLowerCase();
+        const agentId = str(session.agentId);
+        return {
+            Index: index + 1,
+            Title: str(session.title, "(untitled)").trim() || "(untitled)",
+            AgentId: agentId,
+            SessionId: cid,
+            Url: `${YUANBAO_HOME}chat/${agentId}/${cid}`,
+        };
+    })
+        .filter((row) => AGENT_ID_RE.test(str(row.AgentId)) &&
+        CONV_ID_RE.test(str(row.SessionId)));
+}
+async function currentUrl(page) {
+    const value = await page.evaluate("window.location.href").catch(() => "");
+    return typeof value === "string" ? value : "";
+}
+async function ensureYuanbaoPage(page) {
+    const url = await currentUrl(page);
+    let onYuanbao = false;
+    try {
+        const hostname = new URL(url).hostname;
+        onYuanbao =
+            hostname === "yuanbao.tencent.com" ||
+                hostname.endsWith(".yuanbao.tencent.com");
+    }
+    catch {
+        onYuanbao = false;
+    }
+    if (!onYuanbao) {
+        await page.goto(YUANBAO_HOME, { waitUntil: "load", settleMs: 2500 });
+        await page.wait(1);
+    }
+}
+async function hasLoginGate(page) {
+    const result = await page.evaluate(`(() => {
+    const bodyText = document.body?.innerText || '';
+    const hasWechatLoginText = bodyText.includes('微信扫码登录');
+    const hasWechatIframe = Array.from(document.querySelectorAll('iframe'))
+      .some((frame) => (frame.getAttribute('src') || '').includes('open.weixin.qq.com/connect/qrconnect'));
+    return hasWechatLoginText || hasWechatIframe;
+  })()`);
+    return Boolean(result);
+}
+async function readBubbles(page) {
+    const result = await page.evaluate(`(() => {
+    ${VISIBLE_JS}
+    const items = Array.from(document.querySelectorAll('.agent-chat__list__item--human, .agent-chat__list__item--ai'))
+      .filter((node) => isVisible(node));
+    return items.map((node) => {
+      const isAi = node.classList.contains('agent-chat__list__item--ai');
+      const contentNode = isAi
+        ? (node.querySelector('.hyc-content-md-done')
+          || node.querySelector('.hyc-content-md')
+          || node.querySelector('.agent-chat__speech-text')
+          || node.querySelector('.agent-chat__bubble__content'))
+        : (node.querySelector('.hyc-component-text .hyc-content-text')
+          || node.querySelector('.hyc-content-text')
+          || node.querySelector('.agent-chat__bubble__content'));
+      const html = contentNode instanceof HTMLElement ? (contentNode.innerHTML || '') : '';
+      const text = contentNode instanceof HTMLElement
+        ? (contentNode.innerText || contentNode.textContent || '')
+        : ((node.innerText || node.textContent) || '');
+      return {
+        role: isAi ? 'Assistant' : 'User',
+        text: String(text || '').replace(/\\u00a0/g, ' ').trim(),
+        html,
+      };
+    });
+  })()`);
+    return Array.isArray(result) ? result : [];
+}
+async function readCurrentConversation(page) {
+    await ensureYuanbaoPage(page);
+    await page.wait(1.5);
+    if (await hasLoginGate(page)) {
+        throw new Error("Yuanbao login is required before reading messages.");
+    }
+    const rows = mapYuanbaoBubbles(await readBubbles(page));
+    if (!rows.length)
+        throw new Error("No visible Yuanbao messages found.");
+    return rows;
+}
+async function listSessions(page, limit) {
+    await ensureYuanbaoPage(page);
+    if (await hasLoginGate(page)) {
+        throw new Error("Yuanbao login is required before reading history.");
+    }
+    await page.wait(1.5);
+    const raw = await page.evaluate(`(() => {
+    ${VISIBLE_JS}
+    const nodes = Array.from(document.querySelectorAll('.yb-recent-conv-list__item'))
+      .filter((node) => isVisible(node));
+    return nodes.map((node) => {
+      const cid = node.getAttribute('dt-cid') || '';
+      const agentId = node.getAttribute('dt-agent-id') || '';
+      const titleEl = node.querySelector('[data-item-name]');
+      const title = (titleEl?.getAttribute('data-item-name') || titleEl?.textContent || '').trim();
+      return { cid, agentId, title };
+    });
+  })()`);
+    const rows = Array.isArray(raw)
+        ? mapYuanbaoSessions(raw)
+        : [];
+    if (!rows.length)
+        throw new Error("No Yuanbao conversations found in the sidebar.");
+    return rows.slice(0, limit);
+}
+async function sendYuanbaoPrompt(page, prompt) {
+    const result = (await page.evaluate(`(async () => {
+    const waitFor = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+    ${VISIBLE_JS}
+    const composer = Array.from(document.querySelectorAll('.ql-editor[contenteditable="true"], .ql-editor, [contenteditable="true"]'))
+      .find(isVisible);
+    if (!(composer instanceof HTMLElement)) return { ok: false, reason: 'Yuanbao composer was not found.' };
+    composer.focus();
+    const selection = window.getSelection();
+    const range = document.createRange();
+    range.selectNodeContents(composer);
+    range.collapse(false);
+    selection?.removeAllRanges();
+    selection?.addRange(range);
+    composer.textContent = '';
+    document.execCommand('insertText', false, ${js(prompt)});
+    composer.dispatchEvent(new InputEvent('input', { bubbles: true, data: ${js(prompt)}, inputType: 'insertText' }));
+    const findEnabledSubmit = () => Array.from(document.querySelectorAll('a[class*="send-btn"], button[class*="send-btn"], button[class*="submit"]'))
+      .find((node) => {
+        if (!(node instanceof HTMLElement) || !isVisible(node)) return false;
+        const className = typeof node.className === 'string' ? node.className : '';
+        return !className.includes('send-btn--disabled') && !className.includes('disabled');
+      });
+    let submit = null;
+    const deadline = Date.now() + 3000;
+    while (Date.now() < deadline) {
+      submit = findEnabledSubmit();
+      if (submit) break;
+      await waitFor(150);
+    }
+    if (submit instanceof HTMLElement) {
+      submit.click();
+      return { ok: true, action: 'click' };
+    }
+    composer.dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', code: 'Enter', keyCode: 13, bubbles: true }));
+    composer.dispatchEvent(new KeyboardEvent('keyup', { key: 'Enter', code: 'Enter', keyCode: 13, bubbles: true }));
+    return { ok: true, action: 'enter' };
+  })()`));
+    if (!result?.ok) {
+        throw new Error(str(result?.reason, "Failed to send Yuanbao prompt."));
+    }
+    return result;
+}
+cli({
+    site: "yuanbao",
+    name: "read",
+    description: "Read messages in the current Yuanbao conversation",
+    domain: "yuanbao.tencent.com",
+    strategy: Strategy.COOKIE,
+    browser: true,
+    columns: ["Role", "Text"],
+    func: async (page) => readCurrentConversation(page),
+});
+cli({
+    site: "yuanbao",
+    name: "send",
+    description: "Send a prompt to Yuanbao without waiting for the reply",
+    domain: "yuanbao.tencent.com",
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [
+        { name: "prompt", type: "str", required: true, positional: true },
+        { name: "new", type: "bool", default: false },
+    ],
+    columns: ["Status", "Prompt"],
+    func: async (page, kwargs) => {
+        const prompt = str(kwargs.prompt).trim();
+        if (!prompt)
+            throw new Error("Yuanbao prompt cannot be empty.");
+        const p = page;
+        await ensureYuanbaoPage(p);
+        if (await hasLoginGate(p)) {
+            throw new Error("Yuanbao login is required before sending prompts.");
+        }
+        if (kwargs.new === true || kwargs.new === "true" || kwargs.new === "1") {
+            await p.goto(YUANBAO_HOME, { waitUntil: "load", settleMs: 2500 });
+            await p.wait(1);
+        }
+        await sendYuanbaoPrompt(p, prompt);
+        return [{ Status: "sent", Prompt: prompt }];
+    },
+});
+cli({
+    site: "yuanbao",
+    name: "history",
+    description: "List recent Yuanbao conversations from the sidebar",
+    domain: "yuanbao.tencent.com",
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [{ name: "limit", type: "int", default: 20 }],
+    columns: ["Index", "Title", "AgentId", "SessionId", "Url"],
+    func: async (page, kwargs) => {
+        const limit = intArg(kwargs.limit, 20, 100);
+        return listSessions(page, limit);
+    },
+});
+cli({
+    site: "yuanbao",
+    name: "detail",
+    description: "Open a Yuanbao conversation by ID and read its messages",
+    domain: "yuanbao.tencent.com",
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [{ name: "id", type: "str", required: true, positional: true }],
+    columns: ["Role", "Text"],
+    func: async (page, kwargs) => {
+        const p = page;
+        const session = parseYuanbaoSessionId(kwargs.id);
+        await p.goto(yuanbaoSessionUrl(session), {
+            waitUntil: "load",
+            settleMs: 2500,
+        });
+        await p.wait(2);
+        if (await hasLoginGate(p)) {
+            throw new Error("Yuanbao login is required before reading detail.");
+        }
+        const startedAt = Date.now();
+        while (Date.now() - startedAt < 20_000) {
+            const rows = mapYuanbaoBubbles(await readBubbles(p));
+            if (rows.length)
+                return rows;
+            await p.wait(1);
+        }
+        throw new Error(`No visible Yuanbao messages found for conversation ${session.agentId}/${session.convId}.`);
+    },
+});
+cli({
+    site: "yuanbao",
+    name: "status",
+    description: "Check Yuanbao page availability, login state, current session and model",
+    domain: "yuanbao.tencent.com",
+    strategy: Strategy.COOKIE,
+    browser: true,
+    columns: [
+        "Status",
+        "Login",
+        "Model",
+        "ModelId",
+        "AgentId",
+        "SessionId",
+        "Url",
+    ],
+    func: async (page) => {
+        const p = page;
+        await ensureYuanbaoPage(p);
+        await p.wait(1.5);
+        const [loginGate, session, model, url] = await Promise.all([
+            hasLoginGate(p),
+            p.evaluate(`(() => {
+        const match = window.location.href.match(/yuanbao\\.tencent\\.com\\/chat\\/([A-Za-z0-9_-]+)\\/([0-9a-f-]{36})(?:[/?#]|$)/i);
+        if (!match) return null;
+        return { agentId: match[1], convId: match[2].toLowerCase() };
+      })()`),
+            p.evaluate(`(() => {
+        const button = document.querySelector('[dt-button-id="model_switch"]');
+        if (!(button instanceof HTMLElement)) return { label: null, modelId: null };
+        const label = (button.querySelector('.t-button__text')?.textContent || button.textContent || '').trim() || null;
+        const modelId = button.getAttribute('dt-model-id') || null;
+        return { label, modelId };
+      })()`),
+            currentUrl(p),
+        ]);
+        const typedSession = session && typeof session === "object"
+            ? session
+            : null;
+        const typedModel = model && typeof model === "object"
+            ? model
+            : null;
+        return [
+            {
+                Status: "Connected",
+                Login: loginGate ? "No (login gate)" : "Yes",
+                Model: typedModel?.label ?? null,
+                ModelId: typedModel?.modelId ?? null,
+                AgentId: typedSession?.agentId ?? null,
+                SessionId: typedSession?.convId ?? null,
+                Url: url,
+            },
+        ];
+    },
+});
+//# sourceMappingURL=web.js.map

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

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

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

@@ -0,0 +1,33 @@
+/**
+ * @owner   src/adapters/zhihu/collection.ts
+ * @does    Register agent-facing Zhihu collection item reader.
+ * @needs   Logged-in Zhihu browser session, collection item API, bounded pagination.
+ * @feeds   surface coverage ledger, Zhihu collection content workflows, answer/article/pin rows.
+ * @breaks  Zhihu collection API shape drift or weak content mapping can hide saved items.
+ */
+interface ZhihuCollectionItem {
+    content?: {
+        type?: unknown;
+        id?: unknown;
+        url?: unknown;
+        content?: unknown;
+        question?: {
+            id?: unknown;
+            title?: unknown;
+        };
+        title?: unknown;
+        author?: {
+            name?: unknown;
+        };
+        voteup_count?: unknown;
+        reaction_count?: unknown;
+    };
+}
+export declare function stripZhihuHtml(value: unknown): string;
+export declare function requireZhihuCollectionId(value: unknown): string;
+export declare function requireZhihuPositiveInt(value: unknown, label: string): number;
+export declare function requireZhihuNonNegativeInt(value: unknown, label: string): number;
+export declare function zhihuCollectionItemKey(item: ZhihuCollectionItem): string;
+export declare function mapZhihuCollectionItem(item: ZhihuCollectionItem, rank: number): Record<string, unknown>;
+export {};
+//# sourceMappingURL=collection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../../src/adapters/zhihu/collection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,UAAU,mBAAmB;IAC3B,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,EAAE,CAAC,EAAE,OAAO,CAAC;QACb,GAAG,CAAC,EAAE,OAAO,CAAC;QACd,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,QAAQ,CAAC,EAAE;YAAE,EAAE,CAAC,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;QAC7C,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;QAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,CAAC;CACH;AAqBD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CASrD;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAK/D;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAM7E;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ,MAAM,CAQR;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAKxE;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,mBAAmB,EACzB,IAAI,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoDzB"}

package/dist/adapters/zhihu/collection.js

@@ -0,0 +1,185 @@
+/**
+ * @owner   src/adapters/zhihu/collection.ts
+ * @does    Register agent-facing Zhihu collection item reader.
+ * @needs   Logged-in Zhihu browser session, collection item API, bounded pagination.
+ * @feeds   surface coverage ledger, Zhihu collection content workflows, answer/article/pin rows.
+ * @breaks  Zhihu collection API shape drift or weak content mapping can hide saved items.
+ */
+import { cli, Strategy } from "../../registry.js";
+function stringField(value) {
+    return value === undefined || value === null ? "" : String(value);
+}
+function numberField(value) {
+    const n = Number(value);
+    return Number.isFinite(n) ? n : 0;
+}
+export function stripZhihuHtml(value) {
+    return stringField(value)
+        .replace(/<[^>]+>/g, "")
+        .replace(/&nbsp;/g, " ")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&amp;/g, "&")
+        .replace(/&quot;/g, '"')
+        .trim();
+}
+export function requireZhihuCollectionId(value) {
+    const id = String(value ?? "").trim();
+    if (!/^\d+$/.test(id))
+        throw new Error("Zhihu collection ID must be numeric.");
+    return id;
+}
+export function requireZhihuPositiveInt(value, label) {
+    const n = Number(value);
+    if (!Number.isInteger(n) || n <= 0) {
+        throw new Error(`zhihu collection ${label} must be a positive integer.`);
+    }
+    return n;
+}
+export function requireZhihuNonNegativeInt(value, label) {
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 0) {
+        throw new Error(`zhihu collection ${label} must be a non-negative integer.`);
+    }
+    return n;
+}
+export function zhihuCollectionItemKey(item) {
+    const content = item.content ?? {};
+    return `${stringField(content.type) || "unknown"}:${stringField(content.id || content.url || JSON.stringify(content).slice(0, 80))}`;
+}
+export function mapZhihuCollectionItem(item, rank) {
+    const content = item.content ?? {};
+    const type = stringField(content.type) || "unknown";
+    let title = "";
+    let excerpt = "";
+    let url = "";
+    let author = "";
+    let votes = 0;
+    if (type === "answer") {
+        const question = content.question ?? {};
+        title = stringField(question.title);
+        excerpt = stripZhihuHtml(content.content).slice(0, 150);
+        url =
+            stringField(content.url) ||
+                `https://www.zhihu.com/question/${stringField(question.id)}/answer/${stringField(content.id)}`;
+        author = stringField(content.author?.name) || "匿名用户";
+        votes = numberField(content.voteup_count);
+    }
+    else if (type === "article") {
+        title = stringField(content.title);
+        excerpt = stripZhihuHtml(content.content).slice(0, 150);
+        url =
+            stringField(content.url) ||
+                `https://zhuanlan.zhihu.com/p/${stringField(content.id)}`;
+        author = stringField(content.author?.name) || "匿名用户";
+        votes = numberField(content.voteup_count);
+    }
+    else if (type === "pin") {
+        title = "想法";
+        const blocks = Array.isArray(content.content) ? content.content : [];
+        excerpt = stripZhihuHtml(blocks
+            .map((block) => typeof block === "object" && block !== null && "content" in block
+            ? stringField(block.content)
+            : "")
+            .join(" ")).slice(0, 150);
+        url =
+            stringField(content.url) ||
+                `https://www.zhihu.com/pin/${stringField(content.id)}`;
+        author = stringField(content.author?.name) || "匿名用户";
+        votes = numberField(content.reaction_count);
+    }
+    return {
+        rank,
+        type,
+        title: title.slice(0, 100),
+        author,
+        votes,
+        excerpt,
+        url,
+    };
+}
+function nextOffsetFromPaging(page, fallback) {
+    const next = stringField(page.paging?.next);
+    if (next) {
+        try {
+            const url = new URL(next);
+            const parsed = Number(url.searchParams.get("offset"));
+            if (Number.isInteger(parsed) && parsed > fallback)
+                return parsed;
+        }
+        catch {
+            return fallback;
+        }
+    }
+    return fallback;
+}
+cli({
+    site: "zhihu",
+    name: "collection",
+    description: "List items in a Zhihu collection",
+    domain: "www.zhihu.com",
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [
+        {
+            name: "id",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Collection ID",
+        },
+        { name: "offset", type: "int", default: 0, description: "Starting offset" },
+        { name: "limit", type: "int", default: 20, description: "Number of items" },
+    ],
+    columns: ["rank", "type", "title", "author", "votes", "excerpt", "url"],
+    func: async (page, kwargs) => {
+        const browserPage = page;
+        const id = requireZhihuCollectionId(kwargs.id);
+        const offset = requireZhihuNonNegativeInt(kwargs.offset ?? 0, "offset");
+        const requestedLimit = requireZhihuPositiveInt(kwargs.limit ?? 20, "limit");
+        const pageLimit = Math.min(requestedLimit, 20);
+        await browserPage.goto("https://www.zhihu.com");
+        const collected = [];
+        const seen = new Set();
+        let nextOffset = offset;
+        const maxPages = Math.ceil(requestedLimit / pageLimit) + 2;
+        for (let pageIndex = 0; pageIndex < maxPages && collected.length < requestedLimit; pageIndex += 1) {
+            const fetchLimit = Math.min(pageLimit, requestedLimit - collected.length);
+            const url = `https://www.zhihu.com/api/v4/collections/${id}/items?offset=${nextOffset}&limit=${fetchLimit}`;
+            const data = await browserPage.evaluate(`(async () => {
+        const response = await fetch(${JSON.stringify(url)}, { credentials: 'include' });
+        if (!response.ok) return { __httpError: response.status };
+        return await response.json();
+      })()`);
+            if (!data || data.__httpError) {
+                throw new Error(`Zhihu collection request failed${data?.__httpError ? ` (HTTP ${String(data.__httpError)})` : ""}.`);
+            }
+            const items = Array.isArray(data.data) ? data.data : [];
+            for (const item of items) {
+                const key = zhihuCollectionItemKey(item);
+                if (!seen.has(key)) {
+                    seen.add(key);
+                    collected.push(item);
+                }
+                if (collected.length >= requestedLimit)
+                    break;
+            }
+            if (items.length === 0 ||
+                data.paging?.is_end ||
+                collected.length >= requestedLimit)
+                break;
+            const parsedNextOffset = nextOffsetFromPaging(data, nextOffset);
+            nextOffset =
+                parsedNextOffset > nextOffset
+                    ? parsedNextOffset
+                    : nextOffset + items.length;
+        }
+        if (collected.length === 0) {
+            throw new Error(`No items found for Zhihu collection ${id}.`);
+        }
+        return collected
+            .slice(0, requestedLimit)
+            .map((item, index) => mapZhihuCollectionItem(item, offset + index + 1));
+    },
+});
+//# sourceMappingURL=collection.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collection.js","sourceRoot":"","sources":["../../../src/adapters/zhihu/collection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AA0BlD,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,WAAW,CAAC,KAAK,CAAC;SACtB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACtC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAc,EAAE,KAAa;IACnE,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,oBAAoB,KAAK,8BAA8B,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,KAAc,EACd,KAAa;IAEb,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACb,oBAAoB,KAAK,kCAAkC,CAC5D,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAyB;IAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IACnC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,SAAS,IAAI,WAAW,CAC7D,OAAO,CAAC,EAAE,IAAI,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAClE,EAAE,CAAC;AACN,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,IAAyB,EACzB,IAAY;IAEZ,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;IACpD,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;QACxC,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACpC,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACxD,GAAG;YACD,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC;gBACxB,kCAAkC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,WAAW,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;QACjG,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC;QACrD,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC5C,CAAC;SAAM,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACnC,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACxD,GAAG;YACD,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC;gBACxB,gCAAgC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5D,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC;QACrD,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC5C,CAAC;SAAM,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QAC1B,KAAK,GAAG,IAAI,CAAC;QACb,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,OAAO,GAAG,cAAc,CACtB,MAAM;aACH,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACb,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,SAAS,IAAI,KAAK;YAC/D,CAAC,CAAC,WAAW,CAAE,KAA+B,CAAC,OAAO,CAAC;YACvD,CAAC,CAAC,EAAE,CACP;aACA,IAAI,CAAC,GAAG,CAAC,CACb,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAChB,GAAG;YACD,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC;gBACxB,6BAA6B,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;QACzD,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC;QACrD,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO;QACL,IAAI;QACJ,IAAI;QACJ,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;QAC1B,MAAM;QACN,KAAK;QACL,OAAO;QACP,GAAG;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAe,EAAE,QAAgB;IAC7D,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5C,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;YAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;YACtD,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,QAAQ;gBAAE,OAAO,MAAM,CAAC;QACnE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,GAAG,CAAC;IACF,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,kCAAkC;IAC/C,MAAM,EAAE,eAAe;IACvB,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,OAAO,EAAE,IAAI;IACb,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,eAAe;SAC7B;QACD,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,iBAAiB,EAAE;QAC3E,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,iBAAiB,EAAE;KAC5E;IACD,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC;IACvE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;QAC3B,MAAM,WAAW,GAAG,IAGnB,CAAC;QACF,MAAM,EAAE,GAAG,wBAAwB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,0BAA0B,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC;QACxE,MAAM,cAAc,GAAG,uBAAuB,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;QAC5E,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QAC/C,MAAM,WAAW,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QAChD,MAAM,SAAS,GAA0B,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,IAAI,UAAU,GAAG,MAAM,CAAC;QACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC3D,KACE,IAAI,SAAS,GAAG,CAAC,EACjB,SAAS,GAAG,QAAQ,IAAI,SAAS,CAAC,MAAM,GAAG,cAAc,EACzD,SAAS,IAAI,CAAC,EACd,CAAC;YACD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,cAAc,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;YAC1E,MAAM,GAAG,GAAG,4CAA4C,EAAE,iBAAiB,UAAU,UAAU,UAAU,EAAE,CAAC;YAC5G,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC;uCACP,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;;;WAG/C,CAAC,CAAC;YACP,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,CACb,kCAAkC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,UAAU,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CACpG,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,GAAG,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;gBACzC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBACnB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBACd,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACvB,CAAC;gBACD,IAAI,SAAS,CAAC,MAAM,IAAI,cAAc;oBAAE,MAAM;YAChD,CAAC;YACD,IACE,KAAK,CAAC,MAAM,KAAK,CAAC;gBAClB,IAAI,CAAC,MAAM,EAAE,MAAM;gBACnB,SAAS,CAAC,MAAM,IAAI,cAAc;gBAElC,MAAM;YACR,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAChE,UAAU;gBACR,gBAAgB,GAAG,UAAU;oBAC3B,CAAC,CAAC,gBAAgB;oBAClB,CAAC,CAAC,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;QAClC,CAAC;QACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,uCAAuC,EAAE,GAAG,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,SAAS;aACb,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC;aACxB,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IAC5E,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * @owner   src/adapters/zlibrary/web.ts
+ * @does    Register agent-facing Z-Library search and info commands implemented with site-specific safety checks.
+ * @needs   Logged-in z-library.im browser session and Z-Library search/book page DOM.
+ * @feeds   surface coverage ledger, book search rows, and book detail/download-format discovery.
+ * @breaks  Z-Library host changes, login redirects, or z-bookcard shadow DOM drift can hide results.
+ */
+interface ZlibrarySearchRow {
+    rank?: unknown;
+    title?: unknown;
+    author?: unknown;
+    url?: unknown;
+}
+export declare function normalizeZlibraryBookUrl(value: unknown): string;
+export declare function buildZlibrarySearchUrl(value: unknown): string;
+export declare function requireZlibraryLimit(value: unknown, fallback?: number): number;
+export declare function mapZlibrarySearchRows(rows: ZlibrarySearchRow[]): Record<string, unknown>[];
+export {};
+//# sourceMappingURL=web.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../../src/adapters/zlibrary/web.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAeH,UAAU,iBAAiB;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAmB/D;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI7D;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAK,GAAG,MAAM,CAQ1E;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,iBAAiB,EAAE,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAS3B"}