@agentrhq/webcmd 0.1.2 → 0.2.0

package/clis/baidu-scholar/search.test.js

@@ -1,23 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import { getRegistry } from '@agentrhq/webcmd/registry';
-import './search.js';
-
-describe('baidu-scholar search command', () => {
-    const command = getRegistry().get('baidu-scholar/search');
-
-    it('registers as a public browser command', () => {
-        expect(command).toBeDefined();
-        expect(command.site).toBe('baidu-scholar');
-        expect(command.strategy).toBe('public');
-        expect(command.browser).toBe(true);
-    });
-
-    it('rejects empty queries before browser navigation', async () => {
-        const page = { goto: vi.fn() };
-        await expect(command.func(page, { query: '   ' })).rejects.toMatchObject({
-            name: 'ArgumentError',
-            code: 'ARGUMENT',
-        });
-        expect(page.goto).not.toHaveBeenCalled();
-    });
-});

package/clis/bilibili/auth.js

@@ -1,36 +0,0 @@
-import { AuthRequiredError } from '@agentrhq/webcmd/errors';
-import { registerSiteAuthCommands } from '../_shared/site-auth.js';
-import { apiGet, getSelfUid } from './utils.js';
-
-async function hasBilibiliSessionCookies(page) {
-  const cookies = await page.getCookies({ url: 'https://www.bilibili.com' });
-  const names = new Set(cookies.map(cookie => cookie.name));
-  return names.has('SESSDATA') && names.has('DedeUserID');
-}
-
-async function verifyBilibiliIdentity(page) {
-  await page.goto('https://www.bilibili.com');
-  const uid = await getSelfUid(page);
-  const payload = await apiGet(page, '/x/space/wbi/acc/info', { params: { mid: uid }, signed: true });
-  const data = payload?.data ?? {};
-  return {
-    id: String(data.mid ?? uid),
-    username: data.name ?? '',
-    level: data.level ?? 0,
-  };
-}
-
-registerSiteAuthCommands({
-  site: 'bilibili',
-  domain: 'www.bilibili.com',
-  loginUrl: 'https://passport.bilibili.com/login',
-  columns: ['id', 'username', 'level'],
-  quickCheck: hasBilibiliSessionCookies,
-  verify: verifyBilibiliIdentity,
-  poll: async (page) => {
-    if (!await hasBilibiliSessionCookies(page)) {
-      throw new AuthRequiredError('bilibili.com', 'Waiting for Bilibili session cookies');
-    }
-    return verifyBilibiliIdentity(page);
-  },
-});

package/clis/bilibili/comment.js

@@ -1,107 +0,0 @@
-/**
- * Bilibili comment — posts a top-level comment or a reply on a video via the official API.
- * Uses /x/v2/reply/add, authenticated by the logged-in cookie + bili_jct CSRF token.
- * @username mentions in the message are resolved to real mentions (at_name_to_mid).
- */
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { ArgumentError, CommandExecutionError, EmptyResultError } from '@agentrhq/webcmd/errors';
-import { apiGet, apiPost, requireOkPayload, resolveBvid, resolveUid } from './utils.js';
-
-function readPositiveInteger(value, label) {
-    const n = Number(value);
-    if (!Number.isInteger(n) || n <= 0) {
-        throw new ArgumentError(`bilibili comment ${label} must be a positive integer`);
-    }
-    return n;
-}
-
-cli({
-    site: 'bilibili',
-    name: 'comment',
-    access: 'write',
-    description: '在 B站视频下发表评论或回复（官方 API，需登录；消息里的 @用户 会被解析为真实提及）',
-    domain: 'www.bilibili.com',
-    strategy: Strategy.COOKIE,
-    args: [
-        { name: 'bvid', required: true, positional: true, help: 'Video BV ID / URL / b23.tv short link' },
-        { name: 'message', required: true, positional: true, help: 'Comment text. Any @username in it is resolved to a real mention' },
-        { name: 'parent', type: 'int', help: 'top-level/root rpid to reply under (omit for a top-level comment)' },
-        { name: 'execute', type: 'boolean', help: 'Actually post the comment. Without it the command refuses to write.' },
-    ],
-    columns: ['rpid', 'bvid', 'oid', 'message', 'url'],
-    func: async (page, kwargs) => {
-        if (!page) {
-            throw new CommandExecutionError('Browser session required for bilibili comment');
-        }
-        const message = String(kwargs.message ?? '').trim();
-        if (!message)
-            throw new ArgumentError('bilibili comment message cannot be empty');
-        // Write guard: posting is public and irreversible-ish, so require an explicit opt-in.
-        if (!kwargs.execute)
-            throw new ArgumentError('Refusing to post: pass --execute to actually publish this comment');
-        const parent = kwargs.parent != null ? readPositiveInteger(kwargs.parent, 'parent') : null;
-        let bvid;
-        try {
-            bvid = await resolveBvid(kwargs.bvid);
-        }
-        catch (error) {
-            throw new ArgumentError(`Cannot resolve Bilibili BV ID from input: ${String(kwargs.bvid ?? '')}`, error instanceof Error ? error.message : String(error));
-        }
-        // Resolve bvid → aid (the reply API addresses videos by aid, as `oid`)
-        const view = await apiGet(page, '/x/web-interface/view', { params: { bvid } });
-        const viewData = requireOkPayload(view, 'view');
-        const oid = viewData?.aid;
-        if (!oid)
-            throw new CommandExecutionError(`Cannot resolve aid for bvid: ${bvid}`);
-        // Resolve @username mentions to uids. Bilibili only turns "@name" into a real
-        // mention — one that notifies the mentioned user — when the request carries
-        // at_name_to_mid; a plain-text "@name" is otherwise inert and notifies nobody.
-        /** @type {Record<string, number>} */
-        const atNameToMid = {};
-        for (const match of message.matchAll(/@([^\s@]+)/g)) {
-            const name = match[1];
-            if (name in atNameToMid)
-                continue;
-            try {
-                const mid = Number(await resolveUid(page, name));
-                if (!Number.isInteger(mid) || mid <= 0) {
-                    throw new CommandExecutionError(`Bilibili user search returned malformed mid for @${name}`);
-                }
-                atNameToMid[name] = mid;
-            }
-            catch (error) {
-                if (!(error instanceof EmptyResultError)) {
-                    throw error;
-                }
-                // Unresolvable @name (typo, or not a user) — leave it as plain text.
-            }
-        }
-        // For a reply, Bilibili needs both `root` (top-level comment) and `parent`.
-        // Replying to a top-level comment means root === parent.
-        const params = {
-            oid,
-            type: 1,
-            message,
-            plat: 1,
-            ...(parent != null
-                ? { root: parent, parent }
-                : {}),
-            ...(Object.keys(atNameToMid).length > 0
-                ? { at_name_to_mid: JSON.stringify(atNameToMid) }
-                : {}),
-        };
-        const payload = await apiPost(page, '/x/v2/reply/add', { params });
-        const postData = requireOkPayload(payload, 'reply add');
-        const rpid = postData?.rpid;
-        if (!rpid) {
-            throw new CommandExecutionError('Bilibili reply add API did not return rpid for the posted comment');
-        }
-        return [{
-            rpid: String(rpid),
-            bvid,
-            oid: String(oid),
-            message,
-            url: `https://www.bilibili.com/video/${bvid}#reply${rpid}`,
-        }];
-    },
-});

package/clis/bilibili/comment.test.js

@@ -1,153 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest';
-import { ArgumentError, AuthRequiredError, CommandExecutionError, EmptyResultError } from '@agentrhq/webcmd/errors';
-
-const { mockApiGet, mockApiPost, mockResolveUid } = vi.hoisted(() => ({
-    mockApiGet: vi.fn(),
-    mockApiPost: vi.fn(),
-    mockResolveUid: vi.fn(),
-}));
-
-vi.mock('./utils.js', async (importOriginal) => ({
-    ...(await importOriginal()),
-    apiGet: mockApiGet,
-    apiPost: mockApiPost,
-    resolveUid: mockResolveUid,
-}));
-
-import { getRegistry } from '@agentrhq/webcmd/registry';
-import './comment.js';
-
-describe('bilibili comment', () => {
-    const command = getRegistry().get('bilibili/comment');
-
-    beforeEach(() => {
-        mockApiGet.mockReset();
-        mockApiPost.mockReset();
-        mockResolveUid.mockReset();
-    });
-
-    it('refuses to post without --execute', async () => {
-        await expect(
-            command.func({}, { bvid: 'BV1WtAGzYEBm', message: 'hi' }),
-        ).rejects.toThrow(/--execute/);
-        expect(mockApiPost).not.toHaveBeenCalled();
-    });
-
-    it('rejects an empty message before calling the API', async () => {
-        await expect(
-            command.func({}, { bvid: 'BV1xxx', message: '   ', execute: true }),
-        ).rejects.toThrow(/empty/i);
-        expect(mockApiGet).not.toHaveBeenCalled();
-    });
-
-    it('posts a top-level comment, resolving @mentions to at_name_to_mid', async () => {
-        mockApiGet.mockResolvedValueOnce({ code: 0, data: { aid: 12345 } });
-        mockResolveUid.mockResolvedValueOnce('1141159409'); // @AI视频小助理 → mid
-        mockApiPost.mockResolvedValueOnce({ code: 0, data: { rpid: 99887766 } });
-
-        const result = await command.func({}, {
-            bvid: 'BV1WtAGzYEBm', message: '@AI视频小助理 总结一下', execute: true,
-        });
-
-        expect(mockApiGet).toHaveBeenNthCalledWith(1, {}, '/x/web-interface/view', { params: { bvid: 'BV1WtAGzYEBm' } });
-        expect(mockResolveUid).toHaveBeenCalledWith({}, 'AI视频小助理');
-        expect(mockApiPost).toHaveBeenCalledWith({}, '/x/v2/reply/add', {
-            params: {
-                oid: 12345,
-                type: 1,
-                message: '@AI视频小助理 总结一下',
-                plat: 1,
-                at_name_to_mid: '{"AI视频小助理":1141159409}',
-            },
-        });
-        expect(result).toEqual([{
-            rpid: '99887766',
-            bvid: 'BV1WtAGzYEBm',
-            oid: '12345',
-            message: '@AI视频小助理 总结一下',
-            url: 'https://www.bilibili.com/video/BV1WtAGzYEBm#reply99887766',
-        }]);
-    });
-
-    it('still posts when an @mention cannot be resolved, leaving it as plain text', async () => {
-        mockApiGet.mockResolvedValueOnce({ code: 0, data: { aid: 7 } });
-        mockResolveUid.mockRejectedValueOnce(new EmptyResultError('bilibili user search'));
-        mockApiPost.mockResolvedValueOnce({ code: 0, data: { rpid: 5 } });
-
-        await command.func({}, { bvid: 'BV1xxx', message: '@幽灵用户zzz hi', execute: true });
-
-        expect(mockApiPost).toHaveBeenCalledWith({}, '/x/v2/reply/add', {
-            params: { oid: 7, type: 1, message: '@幽灵用户zzz hi', plat: 1 },
-        });
-    });
-
-    it('fails closed when mention resolution has parser or transport errors', async () => {
-        mockApiGet.mockResolvedValueOnce({ code: 0, data: { aid: 7 } });
-        mockResolveUid.mockRejectedValueOnce(new CommandExecutionError('search API drift'));
-
-        await expect(
-            command.func({}, { bvid: 'BV1xxx', message: '@用户 hi', execute: true }),
-        ).rejects.toBeInstanceOf(CommandExecutionError);
-        expect(mockApiPost).not.toHaveBeenCalled();
-    });
-
-    it('fails closed when mention resolution returns a malformed mid', async () => {
-        mockApiGet.mockResolvedValueOnce({ code: 0, data: { aid: 7 } });
-        mockResolveUid.mockResolvedValueOnce('not-a-mid');
-
-        await expect(
-            command.func({}, { bvid: 'BV1xxx', message: '@用户 hi', execute: true }),
-        ).rejects.toBeInstanceOf(CommandExecutionError);
-        expect(mockApiPost).not.toHaveBeenCalled();
-    });
-
-    it('posts a reply under an existing comment when --parent is given', async () => {
-        mockApiGet.mockResolvedValueOnce({ code: 0, data: { aid: 1 } });
-        mockApiPost.mockResolvedValueOnce({ code: 0, data: { rpid: 2 } });
-
-        await command.func({}, { bvid: 'BV1xxx', message: 'thanks', parent: 555, execute: true });
-
-        expect(mockApiPost).toHaveBeenCalledWith({}, '/x/v2/reply/add', {
-            params: { oid: 1, type: 1, message: 'thanks', plat: 1, root: 555, parent: 555 },
-        });
-    });
-
-    it('throws when the bvid cannot be resolved to an aid', async () => {
-        mockApiGet.mockResolvedValueOnce({ code: 0, data: {} });
-        await expect(
-            command.func({}, { bvid: 'BVbroken', message: 'hi', execute: true }),
-        ).rejects.toBeInstanceOf(CommandExecutionError);
-    });
-
-    it('throws with the API code and message when Bilibili rejects the comment', async () => {
-        mockApiGet.mockResolvedValueOnce({ code: 0, data: { aid: 9 } });
-        mockApiPost.mockResolvedValueOnce({ code: 12025, message: '评论字数过多' });
-        await expect(
-            command.func({}, { bvid: 'BV1xxx', message: 'x', execute: true }),
-        ).rejects.toBeInstanceOf(CommandExecutionError);
-    });
-
-    it('maps login/csrf failures from the write API to AuthRequiredError', async () => {
-        mockApiGet.mockResolvedValueOnce({ code: 0, data: { aid: 9 } });
-        mockApiPost.mockResolvedValueOnce({ code: -111, message: 'csrf 校验失败' });
-        await expect(
-            command.func({}, { bvid: 'BV1xxx', message: 'x', execute: true }),
-        ).rejects.toBeInstanceOf(AuthRequiredError);
-    });
-
-    it('rejects invalid parent ids before posting', async () => {
-        await expect(
-            command.func({}, { bvid: 'BV1xxx', message: 'x', parent: 0, execute: true }),
-        ).rejects.toBeInstanceOf(ArgumentError);
-        expect(mockApiGet).not.toHaveBeenCalled();
-        expect(mockApiPost).not.toHaveBeenCalled();
-    });
-
-    it('fails closed when the write API omits rpid', async () => {
-        mockApiGet.mockResolvedValueOnce({ code: 0, data: { aid: 9 } });
-        mockApiPost.mockResolvedValueOnce({ code: 0, data: {} });
-        await expect(
-            command.func({}, { bvid: 'BV1xxx', message: 'x', execute: true }),
-        ).rejects.toBeInstanceOf(CommandExecutionError);
-    });
-});

package/clis/bilibili/comments.js

@@ -1,136 +0,0 @@
-/**
- * Bilibili comments — fetches comments via the official API.
- * Top-level comments come from /x/v2/reply/main (WBI-signed); with --parent,
- * the replies nested under a given comment come from /x/v2/reply/reply.
- */
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { ArgumentError, AuthRequiredError, CommandExecutionError, EmptyResultError } from '@agentrhq/webcmd/errors';
-import { apiGet, resolveBvid } from './utils.js';
-
-const MAX_LIMIT = 50;
-
-function isAuthLikeBilibiliError(code, message) {
-    return code === -101 || code === -403 || /登录|账号|权限|forbidden|permission|login/i.test(String(message ?? ''));
-}
-
-function parseLimit(value) {
-    const raw = value == null ? 20 : value;
-    const limit = Number(raw);
-    if (!Number.isInteger(limit) || limit <= 0 || limit > MAX_LIMIT) {
-        throw new ArgumentError(`bilibili comments limit must be an integer between 1 and ${MAX_LIMIT}`);
-    }
-    return limit;
-}
-
-function parseParent(value) {
-    if (value == null) {
-        return null;
-    }
-    const parent = Number(value);
-    if (!Number.isInteger(parent) || parent <= 0) {
-        throw new ArgumentError('bilibili comments parent must be a positive integer rpid');
-    }
-    return parent;
-}
-
-function requireOkPayload(payload, label) {
-    if (!payload || typeof payload !== 'object' || Array.isArray(payload) || !Object.hasOwn(payload, 'code')) {
-        throw new CommandExecutionError(`Bilibili ${label} API returned a malformed payload`);
-    }
-    if (payload.code !== 0) {
-        const message = payload.message ?? 'unknown error';
-        if (isAuthLikeBilibiliError(payload.code, message)) {
-            throw new AuthRequiredError('bilibili.com', `Bilibili ${label} API requires login or permission: ${message} (${payload.code})`);
-        }
-        throw new CommandExecutionError(`Bilibili ${label} API failed: ${message} (${payload.code})`);
-    }
-    return payload.data;
-}
-
-function requireReplies(data, label) {
-    if (!data || typeof data !== 'object' || Array.isArray(data)) {
-        throw new CommandExecutionError(`Bilibili ${label} API returned malformed data`);
-    }
-    if (!Object.hasOwn(data, 'replies')) {
-        throw new CommandExecutionError(`Bilibili ${label} API did not return replies`);
-    }
-    if (data.replies === null) {
-        return [];
-    }
-    if (!Array.isArray(data.replies)) {
-        throw new CommandExecutionError(`Bilibili ${label} API returned malformed replies`);
-    }
-    return data.replies;
-}
-
-function formatReplyRow(reply, index) {
-    if (!reply || typeof reply !== 'object' || Array.isArray(reply)) {
-        throw new CommandExecutionError(`Bilibili comments reply ${index + 1} was malformed`);
-    }
-    const rpid = String(reply.rpid ?? '').trim();
-    if (!rpid) {
-        throw new CommandExecutionError(`Bilibili comments reply ${index + 1} was missing rpid`);
-    }
-    const ctime = Number(reply.ctime);
-    if (!Number.isFinite(ctime)) {
-        throw new CommandExecutionError(`Bilibili comments reply ${index + 1} was missing ctime`);
-    }
-    return {
-        rank: index + 1,
-        rpid,
-        author: String(reply.member?.uname ?? ''),
-        text: String(reply.content?.message ?? '').replace(/\n/g, ' ').trim(),
-        likes: reply.like ?? 0,
-        replies: reply.rcount ?? 0,
-        time: new Date(ctime * 1000).toISOString().slice(0, 16).replace('T', ' '),
-    };
-}
-
-cli({
-    site: 'bilibili',
-    name: 'comments',
-    access: 'read',
-    description: '获取 B站视频评论（官方 API；用 --parent <rpid> 读取某条评论下的「楼中楼」回复）',
-    domain: 'www.bilibili.com',
-    strategy: Strategy.COOKIE,
-    args: [
-        { name: 'bvid', required: true, positional: true, help: 'Video BV ID (e.g. BV1WtAGzYEBm)' },
-        { name: 'parent', type: 'int', help: 'rpid of a comment — fetch the replies under it instead of top-level comments' },
-        { name: 'limit', type: 'int', default: 20, help: 'Number of comments (max 50)' },
-    ],
-    columns: ['rank', 'rpid', 'author', 'text', 'likes', 'replies', 'time'],
-    func: async (page, kwargs) => {
-        if (!page) {
-            throw new CommandExecutionError('Browser session required for bilibili comments');
-        }
-        let bvid;
-        try {
-            bvid = await resolveBvid(kwargs.bvid);
-        }
-        catch (error) {
-            throw new ArgumentError(`Cannot resolve Bilibili BV ID from input: ${String(kwargs.bvid ?? '')}`, error instanceof Error ? error.message : String(error));
-        }
-        const limit = parseLimit(kwargs.limit);
-        const parent = parseParent(kwargs.parent);
-        // Resolve bvid → aid (required by reply API)
-        const view = await apiGet(page, '/x/web-interface/view', { params: { bvid } });
-        const viewData = requireOkPayload(view, 'view');
-        const aid = viewData?.aid;
-        if (!aid)
-            throw new CommandExecutionError(`Cannot resolve aid for bvid: ${bvid}`);
-        const payload = parent != null
-            ? await apiGet(page, '/x/v2/reply/reply', {
-                params: { oid: aid, type: 1, root: parent, pn: 1, ps: limit },
-            })
-            : await apiGet(page, '/x/v2/reply/main', {
-                params: { oid: aid, type: 1, mode: 3, ps: limit },
-                signed: true,
-            });
-        const label = parent != null ? 'reply thread' : 'reply main';
-        const replies = requireReplies(requireOkPayload(payload, label), label);
-        if (replies.length === 0) {
-            throw new EmptyResultError(parent != null ? `bilibili comment replies: ${parent}` : `bilibili comments: ${bvid}`);
-        }
-        return replies.slice(0, limit).map(formatReplyRow);
-    },
-});

package/clis/bilibili/comments.test.js

@@ -1,142 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest';
-import { ArgumentError, AuthRequiredError, CommandExecutionError, EmptyResultError } from '@agentrhq/webcmd/errors';
-const { mockApiGet } = vi.hoisted(() => ({
-    mockApiGet: vi.fn(),
-}));
-vi.mock('./utils.js', async (importOriginal) => ({
-    ...(await importOriginal()),
-    apiGet: mockApiGet,
-}));
-import { getRegistry } from '@agentrhq/webcmd/registry';
-import './comments.js';
-describe('bilibili comments', () => {
-    const command = getRegistry().get('bilibili/comments');
-    beforeEach(() => {
-        mockApiGet.mockReset();
-    });
-    it('resolves bvid to aid and fetches replies', async () => {
-        mockApiGet
-            .mockResolvedValueOnce({ code: 0, data: { aid: 12345 } }) // view endpoint
-            .mockResolvedValueOnce({
-            code: 0,
-            data: {
-                replies: [
-                    {
-                        rpid: 777,
-                        member: { uname: 'Alice' },
-                        content: { message: 'Great video!' },
-                        like: 42,
-                        rcount: 3,
-                        ctime: 1700000000,
-                    },
-                ],
-            },
-        });
-        const result = await command.func({}, { bvid: 'BV1WtAGzYEBm', limit: 5 });
-        expect(mockApiGet).toHaveBeenNthCalledWith(1, {}, '/x/web-interface/view', { params: { bvid: 'BV1WtAGzYEBm' } });
-        expect(mockApiGet).toHaveBeenNthCalledWith(2, {}, '/x/v2/reply/main', {
-            params: { oid: 12345, type: 1, mode: 3, ps: 5 },
-            signed: true,
-        });
-        expect(result).toEqual([
-            {
-                rank: 1,
-                rpid: '777',
-                author: 'Alice',
-                text: 'Great video!',
-                likes: 42,
-                replies: 3,
-                time: new Date(1700000000 * 1000).toISOString().slice(0, 16).replace('T', ' '),
-            },
-        ]);
-    });
-    it('fetches replies under a comment via /x/v2/reply/reply when --parent is given', async () => {
-        mockApiGet
-            .mockResolvedValueOnce({ code: 0, data: { aid: 12345 } }) // view endpoint
-            .mockResolvedValueOnce({
-            code: 0,
-            data: {
-                replies: [
-                    {
-                        rpid: 888,
-                        member: { uname: 'AI视频小助理' },
-                        content: { message: '视频总结：作者开了一家咖啡馆' },
-                        like: 8,
-                        rcount: 0,
-                        ctime: 1700000000,
-                    },
-                ],
-            },
-        });
-        const result = await command.func({}, { bvid: 'BV1WtAGzYEBm', parent: 777, limit: 5 });
-        expect(mockApiGet).toHaveBeenNthCalledWith(1, {}, '/x/web-interface/view', { params: { bvid: 'BV1WtAGzYEBm' } });
-        expect(mockApiGet).toHaveBeenNthCalledWith(2, {}, '/x/v2/reply/reply', {
-            params: { oid: 12345, type: 1, root: 777, pn: 1, ps: 5 },
-        });
-        expect(result[0].author).toBe('AI视频小助理');
-        expect(result[0].rpid).toBe('888');
-        expect(result[0].text).toBe('视频总结：作者开了一家咖啡馆');
-    });
-    it('throws when aid cannot be resolved', async () => {
-        mockApiGet.mockResolvedValueOnce({ code: 0, data: {} }); // no aid
-        await expect(command.func({}, { bvid: 'BVinvalid123', limit: 5 })).rejects.toBeInstanceOf(CommandExecutionError);
-    });
-    it('throws CommandExecutionError when replies is missing', async () => {
-        mockApiGet
-            .mockResolvedValueOnce({ code: 0, data: { aid: 99 } })
-            .mockResolvedValueOnce({ code: 0, data: {} }); // no replies key
-        await expect(command.func({}, { bvid: 'BV1xxx', limit: 5 }))
-            .rejects.toBeInstanceOf(CommandExecutionError);
-    });
-    it('rejects out-of-range limits instead of silently clamping', async () => {
-        await expect(command.func({}, { bvid: 'BV1xxx', limit: 999 }))
-            .rejects.toBeInstanceOf(ArgumentError);
-        expect(mockApiGet).not.toHaveBeenCalled();
-    });
-    it('rejects invalid parent ids before fetching comments', async () => {
-        await expect(command.func({}, { bvid: 'BV1xxx', parent: 0, limit: 5 }))
-            .rejects.toBeInstanceOf(ArgumentError);
-        expect(mockApiGet).not.toHaveBeenCalled();
-    });
-    it('maps auth-like API errors to AuthRequiredError', async () => {
-        mockApiGet
-            .mockResolvedValueOnce({ code: -101, message: '账号未登录', data: null });
-        await expect(command.func({}, { bvid: 'BV1xxx', limit: 5 }))
-            .rejects.toBeInstanceOf(AuthRequiredError);
-    });
-    it('throws EmptyResultError for explicit empty comments', async () => {
-        mockApiGet
-            .mockResolvedValueOnce({ code: 0, data: { aid: 1 } })
-            .mockResolvedValueOnce({ code: 0, data: { replies: [] } });
-        await expect(command.func({}, { bvid: 'BV1xxx', limit: 5 }))
-            .rejects.toBeInstanceOf(EmptyResultError);
-    });
-    it('collapses newlines in comment text', async () => {
-        mockApiGet
-            .mockResolvedValueOnce({ code: 0, data: { aid: 1 } })
-            .mockResolvedValueOnce({
-            code: 0,
-            data: {
-                replies: [
-                    { rpid: 123, member: { uname: 'Bob' }, content: { message: 'line1\nline2\nline3' }, like: 0, rcount: 0, ctime: 0 },
-                ],
-            },
-        });
-        const result = (await command.func({}, { bvid: 'BV1xxx', limit: 5 }));
-        expect(result[0].text).toBe('line1 line2 line3');
-    });
-    it('throws CommandExecutionError when a comment row lacks rpid', async () => {
-        mockApiGet
-            .mockResolvedValueOnce({ code: 0, data: { aid: 1 } })
-            .mockResolvedValueOnce({
-            code: 0,
-            data: {
-                replies: [
-                    { member: { uname: 'Bob' }, content: { message: 'hi' }, like: 0, rcount: 0, ctime: 0 },
-                ],
-            },
-        });
-        await expect(command.func({}, { bvid: 'BV1xxx', limit: 5 }))
-            .rejects.toBeInstanceOf(CommandExecutionError);
-    });
-});