@agentrhq/webcmd 0.1.1 → 0.2.0

package/clis/rednote/comments.js

@@ -1,85 +0,0 @@
-/**
- * Rednote comments — international mirror of xiaohongshu/comments.
- * Reuses the DOM-extraction IIFE from `../xiaohongshu/comments.js`.
- */
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { ArgumentError, AuthRequiredError, CommandExecutionError, EmptyResultError } from '@agentrhq/webcmd/errors';
-import { buildCommentsExtractJs } from '../xiaohongshu/comments.js';
-import { buildNoteUrl, parseNoteId } from '../xiaohongshu/note-helpers.js';
-
-const REDNOTE_SIGNED_URL_HINT = 'Pass a full rednote.com note URL with xsec_token from search results or user/profile context.';
-
-function parseCommentLimit(raw) {
-    const parsed = Number(raw ?? 20);
-    if (!Number.isFinite(parsed) || !Number.isInteger(parsed)) {
-        throw new ArgumentError(`--limit must be an integer between 1 and 50, got ${JSON.stringify(raw)}`);
-    }
-    if (parsed < 1 || parsed > 50) {
-        throw new ArgumentError(`--limit must be between 1 and 50, got ${parsed}`);
-    }
-    return parsed;
-}
-
-cli({
-    site: 'rednote',
-    name: 'comments',
-    access: 'read',
-    description: 'Read comments from a rednote note (supports nested replies)',
-    domain: 'www.rednote.com',
-    strategy: Strategy.COOKIE,
-    navigateBefore: false,
-    args: [
-        { name: 'note-id', required: true, positional: true, help: 'Full rednote note URL with xsec_token' },
-        { name: 'limit', type: 'int', default: 20, help: 'Number of top-level comments (max 50)' },
-        { name: 'with-replies', type: 'boolean', default: false, help: 'Include nested replies (楼中楼)' },
-    ],
-    columns: ['rank', 'author', 'text', 'likes', 'time', 'is_reply', 'reply_to'],
-    func: async (page, kwargs) => {
-        const limit = parseCommentLimit(kwargs.limit);
-        const withReplies = Boolean(kwargs['with-replies']);
-        const raw = String(kwargs['note-id']);
-        const noteId = parseNoteId(raw);
-        await page.goto(buildNoteUrl(raw, {
-            commandName: 'rednote comments',
-            cookieRoot: 'rednote.com',
-            signedUrlHint: REDNOTE_SIGNED_URL_HINT,
-        }));
-        await page.wait({ time: 2 + Math.random() * 3 });
-        const data = await page.evaluate(buildCommentsExtractJs(withReplies));
-        if (!data || typeof data !== 'object') {
-            throw new EmptyResultError('rednote/comments', 'Unexpected evaluate response');
-        }
-        if (data.securityBlock) {
-            throw new CommandExecutionError('Rednote security block: the note detail page was blocked by risk control.', /^https?:\/\//.test(raw)
-                ? 'The page may be temporarily restricted. Try again later or from a different session.'
-                : 'Try using a full URL from search results (with xsec_token) instead of a bare note ID.');
-        }
-        if (data.loginWall) {
-            throw new AuthRequiredError('www.rednote.com', 'Note comments require login');
-        }
-        void noteId;
-        const all = data.results ?? [];
-        const toRow = (c, i) => ({
-            rank: i + 1,
-            author: c.author,
-            text: c.text,
-            likes: c.likes,
-            time: c.time,
-            is_reply: c.is_reply,
-            reply_to: c.reply_to,
-        });
-        if (withReplies) {
-            const limited = [];
-            let topCount = 0;
-            for (const c of all) {
-                if (!c.is_reply)
-                    topCount++;
-                if (topCount > limit)
-                    break;
-                limited.push(c);
-            }
-            return limited.map(toRow);
-        }
-        return all.slice(0, limit).map(toRow);
-    },
-});

package/clis/rednote/download.js

@@ -1,59 +0,0 @@
-/**
- * Rednote download — international mirror of xiaohongshu/download.
- * Reuses the DOM-extraction IIFE from `../xiaohongshu/download.js`; that
- * IIFE's CDN allowlist already accepts rednote-hosted media URLs.
- */
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { formatCookieHeader } from '@agentrhq/webcmd/download';
-import { downloadMedia } from '@agentrhq/webcmd/download/media-download';
-import { CommandExecutionError, EmptyResultError } from '@agentrhq/webcmd/errors';
-import { buildDownloadExtractJs } from '../xiaohongshu/download.js';
-import { buildNoteUrl, parseNoteId } from '../xiaohongshu/note-helpers.js';
-
-const REDNOTE_SIGNED_URL_HINT = 'Pass a full rednote.com note URL with xsec_token from search results or user/profile context.';
-
-cli({
-    site: 'rednote',
-    name: 'download',
-    access: 'read',
-    description: 'Download images and videos from a rednote note',
-    domain: 'www.rednote.com',
-    strategy: Strategy.COOKIE,
-    navigateBefore: false,
-    args: [
-        { name: 'note-id', positional: true, required: true, help: 'Full rednote note URL with xsec_token' },
-        { name: 'output', default: './rednote-downloads', help: 'Output directory' },
-    ],
-    columns: ['index', 'type', 'status', 'size'],
-    func: async (page, kwargs) => {
-        const rawInput = String(kwargs['note-id']);
-        const output = kwargs.output;
-        const noteId = parseNoteId(rawInput);
-        await page.goto(buildNoteUrl(rawInput, {
-            commandName: 'rednote download',
-            cookieRoot: 'rednote.com',
-            signedUrlHint: REDNOTE_SIGNED_URL_HINT,
-        }));
-        await page.wait({ time: 1 + Math.random() * 2 });
-        const data = await page.evaluate(buildDownloadExtractJs(noteId));
-        if (data?.securityBlock) {
-            throw new CommandExecutionError('Rednote security block: the note detail page was blocked by risk control.', /^https?:\/\//.test(rawInput)
-                ? 'The page may be temporarily restricted. Try again later or from a different session.'
-                : 'Try using a full URL from search results (with xsec_token) instead of a bare note ID.');
-        }
-        if (!data || !data.media || data.media.length === 0) {
-            throw new EmptyResultError('rednote/download', 'No downloadable media found on this rednote note.');
-        }
-        const cookies = formatCookieHeader(await page.getCookies({ url: 'https://www.rednote.com' }));
-        const resolvedNoteId = typeof data.noteId === 'string' && data.noteId.trim()
-            ? data.noteId.trim()
-            : noteId;
-        return downloadMedia(data.media, {
-            output,
-            subdir: resolvedNoteId,
-            cookies,
-            filenamePrefix: resolvedNoteId,
-            timeout: 60000,
-        });
-    },
-});

package/clis/rednote/feed.js

@@ -1,27 +0,0 @@
-/**
- * Rednote home feed — delegates to the shared func-mode store read in
- * xiaohongshu/feed.js, run against www.rednote.com.
- *
- * The store read and URL-signing logic are identical to xiaohongshu (both
- * hydrate a Pinia `feed` store whose entries carry `xsecToken`), so this
- * adapter only pins the web host. Mirrors how rednote's note/comments/search/
- * download/user adapters reuse the xiaohongshu implementations.
- */
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { runFeed } from '../xiaohongshu/feed.js';
-
-export const command = cli({
-    site: 'rednote',
-    name: 'feed',
-    access: 'read',
-    description: 'Rednote home feed (reads hydrated Pinia store)',
-    domain: 'www.rednote.com',
-    strategy: Strategy.COOKIE,
-    browser: true,
-    navigateBefore: false,
-    args: [
-        { name: 'limit', type: 'int', default: 20, help: 'Number of items to return' },
-    ],
-    columns: ['id', 'title', 'author', 'likes', 'type', 'url'],
-    func: async (page, kwargs) => runFeed(page, kwargs, 'www.rednote.com'),
-});

package/clis/rednote/navigation.test.js

@@ -1,26 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { getRegistry } from '@agentrhq/webcmd/registry';
-import './note.js';
-import './comments.js';
-import './download.js';
-import './feed.js';
-import './notifications.js';
-import './search.js';
-import './user.js';
-
-describe('rednote navigateBefore hardening', () => {
-    const expectedFalse = [
-        'rednote/note',
-        'rednote/comments',
-        'rednote/download',
-        'rednote/feed',
-        'rednote/notifications',
-        'rednote/search',
-        'rednote/user',
-    ];
-    it.each(expectedFalse)('%s sets navigateBefore=false', (name) => {
-        const cmd = getRegistry().get(name);
-        expect(cmd).toBeDefined();
-        expect(cmd.navigateBefore).toBe(false);
-    });
-});

package/clis/rednote/note.js

@@ -1,68 +0,0 @@
-/**
- * Rednote note — international mirror of xiaohongshu/note.
- * Reuses the DOM-extraction IIFE from `../xiaohongshu/note.js`; only the
- * web host and cookie root differ.
- */
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { AuthRequiredError, CommandExecutionError, EmptyResultError } from '@agentrhq/webcmd/errors';
-import { NOTE_EXTRACT_JS } from '../xiaohongshu/note.js';
-import { buildNoteUrl, parseNoteId } from '../xiaohongshu/note-helpers.js';
-
-const REDNOTE_SIGNED_URL_HINT = 'Pass a full rednote.com note URL with xsec_token from search results or user/profile context.';
-
-cli({
-    site: 'rednote',
-    name: 'note',
-    access: 'read',
-    description: 'Read note body and engagement counts from a rednote note',
-    domain: 'www.rednote.com',
-    strategy: Strategy.COOKIE,
-    navigateBefore: false,
-    args: [
-        { name: 'note-id', required: true, positional: true, help: 'Full rednote note URL with xsec_token' },
-    ],
-    columns: ['field', 'value'],
-    func: async (page, kwargs) => {
-        const raw = String(kwargs['note-id']);
-        const noteId = parseNoteId(raw);
-        const url = buildNoteUrl(raw, {
-            commandName: 'rednote note',
-            cookieRoot: 'rednote.com',
-            signedUrlHint: REDNOTE_SIGNED_URL_HINT,
-        });
-        await page.goto(url);
-        await page.wait({ time: 2 + Math.random() * 3 });
-        const data = await page.evaluate(NOTE_EXTRACT_JS);
-        if (!data || typeof data !== 'object') {
-            throw new EmptyResultError('rednote/note', 'Unexpected evaluate response');
-        }
-        if (data.securityBlock) {
-            throw new CommandExecutionError('Rednote security block: the note detail page was blocked by risk control.', /^https?:\/\//.test(raw)
-                ? 'The page may be temporarily restricted. Try again later or from a different session.'
-                : 'Try using a full URL from search results (with xsec_token) instead of a bare note ID.');
-        }
-        if (data.loginWall) {
-            throw new AuthRequiredError('www.rednote.com', 'Note content requires login');
-        }
-        if (data.notFound) {
-            throw new EmptyResultError('rednote/note', `Note ${noteId} not found or unavailable — it may have been deleted or restricted`);
-        }
-        const d = data;
-        const numOrZero = (v) => /^\d+/.test(v) ? v : '0';
-        if (!d.title && !d.author) {
-            throw new EmptyResultError('rednote/note', 'The note page loaded without visible content. The note may be deleted or restricted.');
-        }
-        const rows = [
-            { field: 'title', value: d.title || '' },
-            { field: 'author', value: d.author || '' },
-            { field: 'content', value: d.desc || '' },
-            { field: 'likes', value: numOrZero(d.likes || '') },
-            { field: 'collects', value: numOrZero(d.collects || '') },
-            { field: 'comments', value: numOrZero(d.comments || '') },
-        ];
-        if (d.tags?.length) {
-            rows.push({ field: 'tags', value: d.tags.join(', ') });
-        }
-        return rows;
-    },
-});

package/clis/rednote/notifications.js

@@ -1,139 +0,0 @@
-/**
- * Rednote notifications — calls `notification.getNotification(type)` and reads
- * `notification.activeTabMessageList` from the Pinia store.
- *
- * Differs from xiaohongshu/notifications because the rednote intercept tap
- * does not see a fresh `/you/` request after `getNotification`. The store is
- * populated directly, so a `func`-mode read is more reliable. Field names
- * accept both snake_case (`user_info.nickname`) and camelCase
- * (`userInfo.nickName`) to absorb the same SSR client-transform diff that
- * `feed` hits on rednote.
- */
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { ArgumentError, CommandExecutionError } from '@agentrhq/webcmd/errors';
-
-const NOTIFICATION_TYPES = new Set(['mentions', 'likes', 'connections']);
-
-function parseNotificationType(raw) {
-    const type = String(raw ?? 'mentions');
-    if (!NOTIFICATION_TYPES.has(type)) {
-        throw new ArgumentError(`--type must be one of mentions, likes, or connections, got ${JSON.stringify(raw)}`);
-    }
-    return type;
-}
-
-function parseLimit(raw) {
-    const parsed = Number(raw ?? 20);
-    if (!Number.isFinite(parsed) || !Number.isInteger(parsed)) {
-        throw new ArgumentError(`--limit must be a positive integer, got ${JSON.stringify(raw)}`);
-    }
-    if (parsed < 1) {
-        throw new ArgumentError(`--limit must be a positive integer, got ${parsed}`);
-    }
-    return parsed;
-}
-
-const READ_NOTIFICATIONS_JS = `
-  (async (type) => {
-    let pinia = null;
-    const probe = (el) => el?.__vue_app__?.config?.globalProperties?.$pinia ?? null;
-    pinia = probe(document.querySelector('#app'));
-    if (!pinia) {
-      for (const el of document.querySelectorAll('*')) {
-        pinia = probe(el);
-        if (pinia) break;
-      }
-    }
-    if (!pinia || !pinia._s) return { error: 'no_pinia' };
-    const store = pinia._s.get('notification');
-    if (!store) return { error: 'no_notification_store' };
-    if (typeof store.getNotification !== 'function') return { error: 'no_getNotification_action' };
-    try { await store.getNotification(type); } catch (e) { return { error: 'action_failed', detail: e?.message }; }
-    // Read messages from whichever store path is populated. rednote keeps the
-    // current tab in activeTabMessageList but may instead drop the list into
-    // notificationMap[type] (or notificationMap[type].messages) depending on
-    // the build, so check both before timing out.
-    const readMessages = () => {
-      if (Array.isArray(store.activeTabMessageList) && store.activeTabMessageList.length > 0) return store.activeTabMessageList;
-      const tab = store.notificationMap?.[type];
-      if (Array.isArray(tab) && tab.length > 0) return tab;
-      if (Array.isArray(tab?.messages) && tab.messages.length > 0) return tab.messages;
-      if (Array.isArray(tab?.messageList) && tab.messageList.length > 0) return tab.messageList;
-      return null;
-    };
-    let messages = null;
-    for (let i = 0; i < 16; i++) {
-      messages = readMessages();
-      if (messages) break;
-      await new Promise(r => setTimeout(r, 500));
-    }
-    const arr = messages ?? (Array.isArray(store.activeTabMessageList) ? store.activeTabMessageList : []);
-    const pick = (item, snake, camel) => item?.[snake] ?? item?.[camel];
-    // Try the leaf as written, plus its snake→camel and camel→snake variants.
-    // Needed because rednote ships e.g. \`userInfo.nickName\` while xhs returns
-    // \`user_info.nickname\` (or \`user_info.nick_name\`); the field name varies
-    // independently of the wrapping object name.
-    const leafVariants = (leaf) => {
-      const camel = leaf.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
-      const snake = leaf.replace(/([A-Z])/g, (_, c) => '_' + c.toLowerCase());
-      const capCamel = leaf.charAt(0) + leaf.slice(1).replace(/([a-z])([A-Z])/g, '$1$2').replace(/(^|_)([a-z])/g, (_, sep, c) => (sep ? c.toUpperCase() : c));
-      return [...new Set([leaf, camel, snake, capCamel])];
-    };
-    const nested = (item, snake, camel, ...leafCandidates) => {
-      const a = pick(item, snake, camel);
-      if (!a || typeof a !== 'object') return '';
-      for (const candidate of leafCandidates) {
-        for (const variant of leafVariants(candidate)) {
-          if (a[variant] != null && a[variant] !== '') return a[variant];
-        }
-      }
-      return '';
-    };
-    return {
-      items: arr.map(item => ({
-        user: nested(item, 'user_info', 'userInfo', 'nickname', 'nickName'),
-        action: item?.title ?? item?.actionTitle ?? '',
-        content: nested(item, 'comment_info', 'commentInfo', 'content'),
-        note: nested(item, 'item_info', 'itemInfo', 'content'),
-        time: item?.time ?? item?.timestamp ?? '',
-      })),
-    };
-  })(${JSON.stringify('PLACEHOLDER_TYPE')})
-`;
-
-export const command = cli({
-    site: 'rednote',
-    name: 'notifications',
-    access: 'read',
-    description: 'Rednote notifications (mentions/likes/connections)',
-    domain: 'www.rednote.com',
-    strategy: Strategy.COOKIE,
-    browser: true,
-    navigateBefore: false,
-    args: [
-        {
-            name: 'type',
-            default: 'mentions',
-            help: 'Notification type: mentions, likes, or connections',
-        },
-        { name: 'limit', type: 'int', default: 20, help: 'Number of notifications to return' },
-    ],
-    columns: ['rank', 'user', 'action', 'content', 'note', 'time'],
-    func: async (page, kwargs) => {
-        const type = parseNotificationType(kwargs.type);
-        const limit = parseLimit(kwargs.limit);
-        await page.goto('https://www.rednote.com/notification');
-        await page.wait({ time: 2 });
-        const script = READ_NOTIFICATIONS_JS.replace(JSON.stringify('PLACEHOLDER_TYPE'), JSON.stringify(type));
-        const data = await page.evaluate(script);
-        if (!data || typeof data !== 'object') {
-            throw new CommandExecutionError('rednote notifications: unexpected evaluate response');
-        }
-        if (data.error) {
-            throw new CommandExecutionError(`rednote notifications: ${data.error}${data.detail ? ' (' + data.detail + ')' : ''}`, 'The rednote SPA may still be hydrating; reload www.rednote.com/notification and retry.');
-        }
-        return (data.items || [])
-            .slice(0, limit)
-            .map((row, i) => ({ rank: i + 1, ...row }));
-    },
-});

package/clis/rednote/rednote.test.js

@@ -1,240 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest';
-
-const { mockDownloadMedia, mockFormatCookieHeader } = vi.hoisted(() => ({
-    mockDownloadMedia: vi.fn(),
-    mockFormatCookieHeader: vi.fn(() => 'sid=secret'),
-}));
-
-vi.mock('@agentrhq/webcmd/download/media-download', () => ({
-    downloadMedia: mockDownloadMedia,
-}));
-
-vi.mock('@agentrhq/webcmd/download', () => ({
-    formatCookieHeader: mockFormatCookieHeader,
-}));
-
-import { getRegistry } from '@agentrhq/webcmd/registry';
-import './comments.js';
-import './download.js';
-import './feed.js';
-import './notifications.js';
-import './note.js';
-import './search.js';
-import './user.js';
-
-function createPageMock(evaluateResult) {
-    return {
-        goto: vi.fn().mockResolvedValue(undefined),
-        evaluate: vi.fn().mockResolvedValue(evaluateResult),
-        wait: vi.fn().mockResolvedValue(undefined),
-        autoScroll: vi.fn().mockResolvedValue(undefined),
-        getCookies: vi.fn().mockResolvedValue([{ name: 'sid', value: 'secret', domain: 'www.rednote.com' }]),
-    };
-}
-function createSearchPageMock(evaluateResults) {
-    const page = createPageMock(undefined);
-    page.evaluate = vi.fn();
-    for (const result of evaluateResults) {
-        page.evaluate.mockResolvedValueOnce(result);
-    }
-    return page;
-}
-
-describe('rednote note URL identity', () => {
-    const download = getRegistry().get('rednote/download');
-    const comments = getRegistry().get('rednote/comments');
-
-    beforeEach(() => {
-        mockDownloadMedia.mockReset();
-        mockDownloadMedia.mockResolvedValue([{ index: 1, type: 'image', status: 'success', size: '1 KB' }]);
-        mockFormatCookieHeader.mockClear();
-    });
-
-    it('rejects xhslink short links before browser navigation', async () => {
-        const page = createPageMock({ media: [] });
-        await expect(download.func(page, {
-            'note-id': 'https://xhslink.com/o/4MKEjsZnhCz',
-            output: './out',
-        })).rejects.toMatchObject({
-            code: 'ARGUMENT',
-            message: expect.stringContaining('signed URL'),
-            hint: expect.stringContaining('rednote.com'),
-        });
-        expect(page.goto).not.toHaveBeenCalled();
-        expect(mockDownloadMedia).not.toHaveBeenCalled();
-    });
-
-    it('rejects signed xiaohongshu URLs before browser navigation', async () => {
-        const page = createPageMock({ media: [] });
-        await expect(comments.func(page, {
-            'note-id': 'https://www.xiaohongshu.com/search_result/69aadbcb000000002202f131?xsec_token=abc',
-            limit: 20,
-        })).rejects.toMatchObject({
-            code: 'ARGUMENT',
-            message: expect.stringContaining('signed URL'),
-            hint: expect.stringContaining('rednote.com'),
-        });
-        expect(page.goto).not.toHaveBeenCalled();
-    });
-
-    it('does not leak the shared xiaohongshu authorHrefRaw transport field from comments rows', async () => {
-        const page = createPageMock({
-            loginWall: false,
-            results: [
-                { author: 'Alice', authorHrefRaw: '/user/profile/alice1', text: 'Nice', likes: 1, time: 'today', is_reply: false, reply_to: '' },
-            ],
-        });
-        const rows = await comments.func(page, {
-            'note-id': 'https://www.rednote.com/search_result/69aadbcb000000002202f131?xsec_token=abc',
-            limit: 20,
-        });
-
-        expect(rows).toEqual([
-            { rank: 1, author: 'Alice', text: 'Nice', likes: 1, time: 'today', is_reply: false, reply_to: '' },
-        ]);
-        expect(rows[0]).not.toHaveProperty('authorHrefRaw');
-    });
-
-    it('uses URL-scoped rednote cookies when downloading media', async () => {
-        const page = createPageMock({
-            noteId: '69bc166f000000001a02069a',
-            media: [{ type: 'image', url: 'https://ci.rednote.com/example.jpg' }],
-        });
-        await download.func(page, {
-            'note-id': 'https://www.rednote.com/search_result/69bc166f000000001a02069a?xsec_token=abc',
-            output: './out',
-        });
-        expect(page.getCookies).toHaveBeenCalledWith({ url: 'https://www.rednote.com' });
-        expect(mockDownloadMedia).toHaveBeenCalledWith([{ type: 'image', url: 'https://ci.rednote.com/example.jpg' }], expect.objectContaining({
-            cookies: 'sid=secret',
-            subdir: '69bc166f000000001a02069a',
-        }));
-    });
-
-    it('throws empty-result instead of returning a failed success row when no media exists', async () => {
-        const page = createPageMock({ noteId: '69bc166f000000001a02069a', media: [] });
-        let caught;
-        try {
-            await download.func(page, {
-                'note-id': 'https://www.rednote.com/search_result/69bc166f000000001a02069a?xsec_token=abc',
-                output: './out',
-            });
-        }
-        catch (error) {
-            caught = error;
-        }
-        expect(caught).toMatchObject({ code: 'EMPTY_RESULT' });
-        expect(caught?.hint).toContain('No downloadable media');
-        expect(mockDownloadMedia).not.toHaveBeenCalled();
-    });
-});
-
-describe('rednote argument validation', () => {
-    const comments = getRegistry().get('rednote/comments');
-    const feed = getRegistry().get('rednote/feed');
-    const notifications = getRegistry().get('rednote/notifications');
-    const user = getRegistry().get('rednote/user');
-
-    it.each([
-        ['rednote/comments', comments, { 'note-id': 'https://www.rednote.com/search_result/69aadbcb000000002202f131?xsec_token=abc', limit: 0 }],
-        ['rednote/feed', feed, { limit: 0 }],
-        ['rednote/notifications', notifications, { limit: 0 }],
-        ['rednote/user', user, { id: 'user123', limit: 0 }],
-    ])('%s rejects invalid --limit before browser navigation', async (_name, command, kwargs) => {
-        const page = createPageMock({});
-        await expect(command.func(page, kwargs)).rejects.toMatchObject({ code: 'ARGUMENT' });
-        expect(page.goto).not.toHaveBeenCalled();
-    });
-
-    it('rejects unknown notification types before browser navigation', async () => {
-        const page = createPageMock({});
-        await expect(notifications.func(page, { type: 'all', limit: 20 })).rejects.toMatchObject({
-            code: 'ARGUMENT',
-            message: expect.stringContaining('--type'),
-        });
-        expect(page.goto).not.toHaveBeenCalled();
-    });
-});
-
-describe('rednote search browser-bridge envelopes', () => {
-    const search = getRegistry().get('rednote/search');
-
-    it('unwraps login-wall wait result envelopes before auth handling', async () => {
-        const page = createSearchPageMock([
-            { session: 'site:rednote', data: 'login_wall' },
-        ]);
-
-        await expect(search.func(page, { query: 'tesla', limit: 5 })).rejects.toMatchObject({
-            code: 'AUTH_REQUIRED',
-            message: expect.stringContaining('blocked behind a login wall'),
-        });
-        expect(page.evaluate).toHaveBeenCalledTimes(1);
-    });
-
-    it('unwraps search extraction envelopes and preserves rednote row shape', async () => {
-        const url = 'https://www.rednote.com/search_result/68e90be80000000004022e66?xsec_token=test-token';
-        const page = createSearchPageMock([
-            'content',
-            1,
-            {
-                session: 'site:rednote',
-                data: [{
-                    title: 'rednote result',
-                    author: 'author',
-                    likes: '12',
-                    url,
-                    author_url: 'https://www.rednote.com/user/profile/u1',
-                }],
-            },
-        ]);
-
-        await expect(search.func(page, { query: 'tesla', limit: 1 })).resolves.toEqual([{
-            rank: 1,
-            title: 'rednote result',
-            author: 'author',
-            likes: '12',
-            published_at: '2025-10-10',
-            url,
-            author_url: 'https://www.rednote.com/user/profile/u1',
-        }]);
-    });
-
-    it('fails typed instead of silently returning [] for malformed extraction payloads', async () => {
-        const page = createSearchPageMock([
-            'content',
-            1,
-            { session: 'site:rednote', data: { rows: [] } },
-        ]);
-
-        await expect(search.func(page, { query: 'tesla', limit: 1 })).rejects.toMatchObject({
-            code: 'COMMAND_EXEC',
-            message: expect.stringContaining('payload shape'),
-        });
-    });
-});
-
-describe('rednote Pinia store failures', () => {
-    it('maps feed store read failure to CommandExecutionError', async () => {
-        const command = getRegistry().get('rednote/feed');
-        const page = createPageMock({ error: 'no_pinia' });
-        await expect(command.func(page, { limit: 20 })).rejects.toMatchObject({
-            code: 'COMMAND_EXEC',
-            message: expect.stringContaining('no_pinia'),
-        });
-    });
-
-    it('maps notification action failure to CommandExecutionError', async () => {
-        const command = getRegistry().get('rednote/notifications');
-        const page = createPageMock({ error: 'action_failed', detail: 'blocked' });
-        await expect(command.func(page, { type: 'mentions', limit: 20 })).rejects.toMatchObject({
-            code: 'COMMAND_EXEC',
-            message: expect.stringContaining('action_failed'),
-        });
-    });
-
-    it('allows an empty notification list after a successful store read', async () => {
-        const command = getRegistry().get('rednote/notifications');
-        const page = createPageMock({ items: [] });
-        await expect(command.func(page, { type: 'mentions', limit: 20 })).resolves.toEqual([]);
-    });
-});