@jackwener/opencli 1.7.8 → 1.7.10

package/clis/lesswrong/user.js

@@ -18,7 +18,7 @@ cli({
         },
     ],
     columns: ['field', 'value'],
-    func: async (_page, kwargs) => {
+    func: async (kwargs) => {
         const slug = gqlEscape(String(kwargs.username).toLowerCase());
         const query = `query UserProfile {
       user(input: {selector: {slug: "${slug}"}}) {

package/clis/paperreview/commands.test.js

@@ -38,7 +38,7 @@ describe('paperreview submit command', () => {
             resolvedPath: '/tmp/paper.pdf',
             sizeBytes: 4096,
         });
-        const result = await cmd.func(null, {
+        const result = await cmd.func({
             pdf: './paper.pdf',
             email: 'wang2629651228@gmail.com',
             venue: 'RAL',
@@ -80,7 +80,7 @@ describe('paperreview submit command', () => {
                 message: 'Submission accepted',
             },
         });
-        const result = await cmd.func(null, {
+        const result = await cmd.func({
             pdf: './paper.pdf',
             email: 'wang2629651228@gmail.com',
             venue: 'RAL',
@@ -112,7 +112,7 @@ describe('paperreview submit command', () => {
                 s3_key: 'uploads/paper.pdf',
             },
         });
-        const result = await cmd.func(null, {
+        const result = await cmd.func({
             pdf: './paper.pdf',
             email: 'wang2629651228@gmail.com',
             venue: 'RAL',
@@ -153,7 +153,7 @@ describe('paperreview submit command', () => {
                 message: 'Submission accepted',
             },
         });
-        const result = await cmd.func(null, {
+        const result = await cmd.func({
             pdf: './paper.pdf',
             email: 'wang2629651228@gmail.com',
             venue: 'RAL',
@@ -190,7 +190,7 @@ describe('paperreview review command', () => {
             response: { status: 202 },
             payload: { detail: 'Review is still processing.' },
         });
-        const result = await cmd.func(null, { token: 'tok_123' });
+        const result = await cmd.func({ token: 'tok_123' });
         expect(result).toMatchObject({
             status: 'processing',
             token: 'tok_123',
@@ -214,7 +214,7 @@ describe('paperreview feedback command', () => {
             response: { ok: true, status: 200 },
             payload: { message: 'Thanks for the feedback.' },
         });
-        const result = await cmd.func(null, {
+        const result = await cmd.func({
             token: 'tok_123',
             helpfulness: 4,
             'critical-error': 'yes',

package/clis/paperreview/feedback.js

@@ -17,7 +17,7 @@ cli({
         { name: 'additional-comments', help: 'Optional free-text feedback' },
     ],
     columns: ['status', 'token', 'helpfulness', 'critical_error', 'actionable_suggestions', 'message'],
-    func: async (_page, kwargs) => {
+    func: async (kwargs) => {
         const token = String(kwargs.token ?? '').trim();
         if (!token) {
             throw new CliError('ARGUMENT', 'A review token is required.');

package/clis/paperreview/review.js

@@ -13,7 +13,7 @@ cli({
         { name: 'token', positional: true, required: true, help: 'Review token returned by paperreview.ai' },
     ],
     columns: ['status', 'title', 'venue', 'numerical_score', 'has_feedback', 'review_url'],
-    func: async (_page, kwargs) => {
+    func: async (kwargs) => {
         const token = String(kwargs.token ?? '').trim();
         if (!token) {
             throw new CliError('ARGUMENT', 'A review token is required.');

package/clis/paperreview/submit.js

@@ -24,7 +24,7 @@ cli({
             return 'prepared only';
         return undefined;
     },
-    func: async (_page, kwargs) => {
+    func: async (kwargs) => {
         const pdfFile = await readPdfFile(kwargs.pdf);
         const email = String(kwargs.email ?? '').trim();
         const venue = normalizeVenue(kwargs.venue);

package/clis/producthunt/posts.js

@@ -19,7 +19,7 @@ cli({
         },
     ],
     columns: ['rank', 'name', 'tagline', 'author', 'date', 'url'],
-    func: async (_page, args) => {
+    func: async (args) => {
         const count = Math.min(Number(args.limit) || 20, 50);
         const category = String(args.category ?? '').trim() || undefined;
         const posts = await fetchFeed(category);

package/clis/producthunt/today.js

@@ -16,7 +16,7 @@ cli({
         { name: 'limit', type: 'int', default: 20, help: 'Max results' },
     ],
     columns: ['rank', 'name', 'tagline', 'author', 'url'],
-    func: async (_page, args) => {
+    func: async (args) => {
         const count = Math.min(Number(args.limit) || 20, 50);
         const posts = await fetchFeed();
         if (posts.length === 0)

package/clis/sinablog/search.js

@@ -47,5 +47,5 @@ cli({
         { name: 'limit', type: 'int', default: 20, help: '返回的文章数量' },
     ],
     columns: ['rank', 'title', 'author', 'date', 'description', 'url'],
-    func: async (_page, args) => searchSinaBlog(args.keyword, Math.max(1, Math.min(Number(args.limit) || 20, 50))),
+    func: async (args) => searchSinaBlog(args.keyword, Math.max(1, Math.min(Number(args.limit) || 20, 50))),
 });

package/clis/sinafinance/news.js

@@ -34,7 +34,7 @@ cli({
         { name: 'type', type: 'int', default: 0, help: 'News type: 0=全部 1=A股 2=宏观 3=公司 4=数据 5=市场 6=国际 7=观点 8=央行 9=其它' },
     ],
     columns: ['id', 'time', 'content', 'views'],
-    func: async (_page, args) => {
+    func: async (args) => {
         const limit = Math.max(1, Math.min(Number(args.limit), 50));
         const apiTag = TYPE_MAP[args.type] ?? 0;
         const params = new URLSearchParams({

package/clis/sinafinance/stock.js

@@ -62,7 +62,7 @@ cli({
         { name: 'market', type: 'string', default: 'auto', help: 'Market: cn, hk, us, auto (default: auto searches cn → hk → us)' },
     ],
     columns: ['Symbol', 'Name', 'Price', 'Change', 'ChangePercent', 'Open', 'High', 'Low', 'Volume', 'MarketCap'],
-    func: async (_page, args) => {
+    func: async (args) => {
         const key = String(args.key);
         const market = String(args.market);
         const marketMap = {

package/clis/sinafinance/stock.test.js

@@ -28,7 +28,7 @@ describe('sinafinance stock command', () => {
             .mockResolvedValueOnce(textResponse('var hq_str_gb_AAPL="Apple Inc,189.98,1.23,0,1.56,0,188.50,180.00,195.00,175.00,1200000,0,3000000000000";'));
         vi.stubGlobal('fetch', fetchMock);
 
-        const result = await cmd.func(null, { key: 'AAPL', market: 'auto' });
+        const result = await cmd.func({ key: 'AAPL', market: 'auto' });
 
         expect(fetchMock).toHaveBeenNthCalledWith(1, 'https://suggest3.sinajs.cn/suggest/type=11,31,41&key=AAPL', expect.any(Object));
         expect(fetchMock).toHaveBeenNthCalledWith(2, 'https://hq.sinajs.cn/list=gb_AAPL', expect.any(Object));
@@ -48,7 +48,7 @@ describe('sinafinance stock command', () => {
             .mockResolvedValueOnce(textResponse('var hq_str_gb_AAPL="苹果公司,189.98,1.23,0,1.56,0,188.50,180.00,195.00,175.00,1200000,0,3000000000000";'));
         vi.stubGlobal('fetch', fetchMock);
 
-        const result = await cmd.func(null, { key: '苹果', market: 'auto' });
+        const result = await cmd.func({ key: '苹果', market: 'auto' });
 
         expect(fetchMock).toHaveBeenNthCalledWith(2, 'https://hq.sinajs.cn/list=gb_AAPL', expect.any(Object));
         expect(result[0]).toMatchObject({

package/clis/spotify/spotify.js

@@ -198,7 +198,7 @@ cli({
     browser: false,
     args: [{ name: 'query', type: 'str', default: '', positional: true, help: 'Track or artist to play (optional)' }],
     columns: ['track', 'artist', 'status'],
-    func: async (_page, kwargs) => {
+    func: async (kwargs) => {
         if (kwargs.query) {
             const { uri, name, artist } = await findTrackUri(kwargs.query);
             await api('PUT', '/me/player/play', { uris: [uri] });
@@ -246,7 +246,7 @@ cli({
     browser: false,
     args: [{ name: 'level', type: 'int', default: 50, positional: true, required: true, help: 'Volume 0–100' }],
     columns: ['volume'],
-    func: async (_page, kwargs) => {
+    func: async (kwargs) => {
         const level = Math.round(kwargs.level);
         if (level < 0 || level > 100)
             throw new CliError('INVALID_ARGS', 'Volume must be between 0 and 100');
@@ -265,7 +265,7 @@ cli({
         { name: 'limit', type: 'int', default: 10, help: 'Number of results (default: 10)' },
     ],
     columns: ['track', 'artist', 'album', 'uri'],
-    func: async (_page, kwargs) => {
+    func: async (kwargs) => {
         const limit = Math.min(50, Math.max(1, Math.round(kwargs.limit)));
         const data = await api('GET', `/search?q=${encodeURIComponent(kwargs.query)}&type=track&limit=${limit}`);
         const results = mapSpotifyTrackResults(data);
@@ -282,7 +282,7 @@ cli({
     browser: false,
     args: [{ name: 'query', type: 'str', required: true, positional: true, help: 'Track to add to queue' }],
     columns: ['track', 'artist', 'status'],
-    func: async (_page, kwargs) => {
+    func: async (kwargs) => {
         const { uri, name, artist } = await findTrackUri(kwargs.query);
         await api('POST', `/me/player/queue?uri=${encodeURIComponent(uri)}`);
         return [{ track: name, artist, status: 'added to queue' }];
@@ -296,7 +296,7 @@ cli({
     browser: false,
     args: [{ name: 'state', type: 'str', default: 'on', positional: true, choices: ['on', 'off'], help: 'on or off' }],
     columns: ['shuffle'],
-    func: async (_page, kwargs) => {
+    func: async (kwargs) => {
         await api('PUT', `/me/player/shuffle?state=${kwargs.state === 'on'}`);
         return [{ shuffle: kwargs.state }];
     },
@@ -309,7 +309,7 @@ cli({
     browser: false,
     args: [{ name: 'mode', type: 'str', default: 'context', positional: true, choices: ['off', 'track', 'context'], help: 'off / track / context' }],
     columns: ['repeat'],
-    func: async (_page, kwargs) => {
+    func: async (kwargs) => {
         await api('PUT', `/me/player/repeat?state=${kwargs.mode}`);
         return [{ repeat: kwargs.mode }];
     },

package/clis/substack/search.js

@@ -69,7 +69,7 @@ cli({
         { name: 'limit', type: 'int', default: 20, help: '返回结果数量' },
     ],
     columns: ['rank', 'title', 'author', 'date', 'description', 'url'],
-    func: async (_page, args) => {
+    func: async (args) => {
         const limit = Math.max(1, Math.min(Number(args.limit) || 20, 50));
         return args.type === 'publications'
             ? searchPublications(args.keyword, limit)

package/clis/toutiao/articles.js

@@ -1,12 +1,11 @@
 import { cli } from '@jackwener/opencli/registry';
 
-const NON_TITLE_LINES = new Set([
-    '展现', '阅读', '点赞', '评论',
-    '查看数据', '查看评论', '修改', '更多', '首发',
-    '已发布', '定时发布', '定时发布中', '由文章生成', '审核中',
-]);
-
 export function parseToutiaoArticlesText(text) {
+    const NON_TITLE_LINES = new Set([
+        '展现', '阅读', '点赞', '评论',
+        '查看数据', '查看评论', '修改', '更多', '首发',
+        '已发布', '定时发布', '定时发布中', '由文章生成', '审核中',
+    ]);
     const lines = String(text || '').split('\n').map((line) => line.trim()).filter(Boolean);
     const results = [];
 

package/clis/toutiao/articles.test.js

@@ -2,22 +2,29 @@ import { describe, expect, it } from 'vitest';
 import { __test__ } from './articles.js';
 
 describe('toutiao articles parser', () => {
+    const articleText = [
+        '短标题',
+        '04-20 20:30',
+        '已发布',
+        '展现 8 阅读 0 点赞 0 评论 0',
+    ].join('\n');
+    const parsedArticle = {
+        title: '短标题',
+        date: '04-20 20:30',
+        status: '已发布',
+        '展现': '8',
+        '阅读': '0',
+        '点赞': '0',
+        '评论': '0',
+    };
+
     it('keeps short chinese titles instead of silently dropping the row', () => {
-        const text = [
-            '短标题',
-            '04-20 20:30',
-            '已发布',
-            '展现 8 阅读 0 点赞 0 评论 0',
-        ].join('\n');
+        expect(__test__.parseToutiaoArticlesText(articleText)).toEqual([parsedArticle]);
+    });
+
+    it('keeps parsing when serialized into the browser evaluate context', () => {
+        const parse = Function(`return (${__test__.parseToutiaoArticlesText.toString()})`)();
 
-        expect(__test__.parseToutiaoArticlesText(text)).toEqual([{
-            title: '短标题',
-            date: '04-20 20:30',
-            status: '已发布',
-            '展现': '8',
-            '阅读': '0',
-            '点赞': '0',
-            '评论': '0',
-        }]);
+        expect(parse(articleText)).toEqual([parsedArticle]);
     });
 });

package/clis/twitter/followers.js

@@ -1,4 +1,4 @@
-import { AuthRequiredError, SelectorError } from '@jackwener/opencli/errors';
+import { AuthRequiredError, selectorError } from '@jackwener/opencli/errors';
 import { cli, Strategy } from '@jackwener/opencli/registry';
 cli({
     site: 'twitter',
@@ -49,7 +49,7 @@ cli({
         return false;
     }`);
         if (!clicked) {
-            throw new SelectorError('Twitter followers link', 'Twitter may have changed the layout.');
+            throw selectorError('Twitter followers link', 'Twitter may have changed the layout.');
         }
         await page.waitForCapture(5);
         // 4. Scroll to trigger pagination API calls

package/clis/twitter/following.js

@@ -1,11 +1,142 @@
-import { AuthRequiredError, SelectorError } from '@jackwener/opencli/errors';
 import { cli, Strategy } from '@jackwener/opencli/registry';
+import { ArgumentError, AuthRequiredError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
+import { resolveTwitterQueryId, sanitizeQueryId } from './shared.js';
+
+const BEARER_TOKEN = 'AAAAAAAAAAAAAAAAAAAAANRILgAAAAAAnNwIzUejRCOuH5E6I8xnZz4puTs%3D1Zv7ttfk8LF81IUq16cHjhLTvJu4FA33AGWWjCpTnA';
+const FOLLOWING_QUERY_ID = 'zx6e-TLzRkeDO_a7p4b3JQ';  // Following fallback
+const USER_BY_SCREEN_NAME_QUERY_ID = 'qRednkZG-rn1P6b48NINmQ';
+
+const FEATURES = {
+    rweb_video_screen_enabled: false,
+    profile_label_improvements_pcf_label_in_post_enabled: true,
+    responsive_web_profile_redirect_enabled: false,
+    rweb_tipjar_consumption_enabled: false,
+    verified_phone_label_enabled: false,
+    creator_subscriptions_tweet_preview_api_enabled: true,
+    responsive_web_graphql_timeline_navigation_enabled: true,
+    responsive_web_graphql_skip_user_profile_image_extensions_enabled: false,
+    premium_content_api_read_enabled: false,
+    communities_web_enable_tweet_community_results_fetch: true,
+    c9s_tweet_anatomy_moderator_badge_enabled: true,
+    responsive_web_grok_analyze_button_fetch_trends_enabled: false,
+    responsive_web_grok_analyze_post_followups_enabled: true,
+    responsive_web_jetfuel_frame: true,
+    responsive_web_grok_share_attachment_enabled: true,
+    responsive_web_grok_annotations_enabled: true,
+    articles_preview_enabled: true,
+    responsive_web_edit_tweet_api_enabled: true,
+    graphql_is_translatable_rweb_tweet_is_translatable_enabled: true,
+    view_counts_everywhere_api_enabled: true,
+    longform_notetweets_consumption_enabled: true,
+    responsive_web_twitter_article_tweet_consumption_enabled: true,
+    tweet_awards_web_tipping_enabled: false,
+    content_disclosure_indicator_enabled: true,
+    content_disclosure_ai_generated_indicator_enabled: true,
+    responsive_web_grok_show_grok_translated_post: false,
+    responsive_web_grok_analysis_button_from_backend: true,
+    post_ctas_fetch_enabled: false,
+    freedom_of_speech_not_reach_fetch_enabled: true,
+    standardized_nudges_misinfo: true,
+    tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled: true,
+    longform_notetweets_rich_text_read_enabled: true,
+    longform_notetweets_inline_media_enabled: false,
+    responsive_web_grok_image_annotation_enabled: true,
+    responsive_web_grok_imagine_annotation_enabled: true,
+    responsive_web_grok_community_note_auto_translation_is_enabled: false,
+    responsive_web_enhance_cards_enabled: false,
+};
+
+function buildFollowingUrl(queryId, userId, count, cursor) {
+    const vars = {
+        userId,
+        count,
+        includePromotedContent: false,
+        withClientEventToken: false,
+        withBirdwatchNotes: false,
+        withVoice: true,
+        withV2Timeline: true,
+    };
+    if (cursor)
+        vars.cursor = cursor;
+    return `/i/api/graphql/${queryId}/Following`
+        + `?variables=${encodeURIComponent(JSON.stringify(vars))}`
+        + `&features=${encodeURIComponent(JSON.stringify(FEATURES))}`;
+}
+
+function buildUserByScreenNameUrl(queryId, screenName) {
+    const vars = JSON.stringify({ screen_name: screenName, withSafetyModeUserFields: true });
+    const feats = JSON.stringify({
+        hidden_profile_subscriptions_enabled: true,
+        rweb_tipjar_consumption_enabled: true,
+        responsive_web_graphql_exclude_directive_enabled: true,
+        verified_phone_label_enabled: false,
+        subscriptions_verification_info_is_identity_verified_enabled: true,
+        subscriptions_verification_info_verified_since_enabled: true,
+        highlights_tweets_tab_ui_enabled: true,
+        responsive_web_twitter_article_notes_tab_enabled: true,
+        subscriptions_feature_can_gift_premium: true,
+        creator_subscriptions_tweet_preview_api_enabled: true,
+        responsive_web_graphql_skip_user_profile_image_extensions_enabled: false,
+        responsive_web_graphql_timeline_navigation_enabled: true,
+    });
+    return `/i/api/graphql/${queryId}/UserByScreenName`
+        + `?variables=${encodeURIComponent(vars)}`
+        + `&features=${encodeURIComponent(feats)}`;
+}
+
+function extractUser(result) {
+    if (!result || result.__typename !== 'User')
+        return null;
+    const core = result.core || {};
+    const legacy = result.legacy || {};
+    return {
+        screen_name: core.screen_name || legacy.screen_name || 'unknown',
+        name: core.name || legacy.name || 'unknown',
+        bio: legacy.description || result.profile_bio?.description || '',
+        followers: legacy.followers_count || legacy.normal_followers_count || 0,
+    };
+}
+
+function parseFollowing(data) {
+    const users = [];
+    let nextCursor = null;
+    const instructions = data?.data?.user?.result?.timeline_v2?.timeline?.instructions
+        || data?.data?.user?.result?.timeline?.timeline?.instructions
+        || [];
+    for (const inst of instructions) {
+        for (const entry of inst.entries || []) {
+            const content = entry.content;
+            // Extract cursor
+            if (content?.entryType === 'TimelineTimelineCursor' || content?.__typename === 'TimelineTimelineCursor') {
+                if (content.cursorType === 'Bottom' || content.cursorType === 'ShowMore')
+                    nextCursor = content.value;
+                continue;
+            }
+            if (entry.entryId?.startsWith('cursor-bottom-') || entry.entryId?.startsWith('cursor-showMore-')) {
+                nextCursor = content?.value || content?.itemContent?.value || nextCursor;
+                continue;
+            }
+            // Extract user
+            if (entry.entryId?.startsWith('user-')) {
+                const user = extractUser(content?.itemContent?.user_results?.result);
+                if (user)
+                    users.push(user);
+            }
+        }
+    }
+    return { users, nextCursor };
+}
+
+function normalizeScreenName(value) {
+    return String(value || '').trim().replace(/^\/+/, '').replace(/^@+/, '');
+}
+
 cli({
     site: 'twitter',
     name: 'following',
     description: 'Get accounts a Twitter/X user is following',
     domain: 'x.com',
-    strategy: Strategy.INTERCEPT,
+    strategy: Strategy.COOKIE,
     browser: true,
     args: [
         { name: 'user', positional: true, type: 'string', required: false },
@@ -13,83 +144,103 @@ cli({
     ],
     columns: ['screen_name', 'name', 'bio', 'followers'],
     func: async (page, kwargs) => {
-        let targetUser = kwargs.user;
-        // If no user is specified, figure out the logged-in user's handle
+        const limit = kwargs.limit === undefined || kwargs.limit === null ? 50 : Number(kwargs.limit);
+        if (!Number.isInteger(limit) || limit <= 0) {
+            throw new ArgumentError('twitter following --limit must be a positive integer', 'Example: opencli twitter following @elonmusk --limit 200');
+        }
+        let targetUser = normalizeScreenName(kwargs.user);
+
+        await page.goto('https://x.com');
+        await page.wait(3);
+
+        const ct0 = await page.evaluate(`() => {
+            return document.cookie.split(';').map(c => c.trim()).find(c => c.startsWith('ct0='))?.split('=')[1] || null;
+        }`);
+        if (!ct0)
+            throw new AuthRequiredError('x.com', 'Not logged into x.com (no ct0 cookie)');
+
         if (!targetUser) {
-            await page.goto('https://x.com/home');
-            await page.wait({ selector: '[data-testid="primaryColumn"]' });
             const href = await page.evaluate(`() => {
-            const link = document.querySelector('a[data-testid="AppTabBar_Profile_Link"]');
-            return link ? link.getAttribute('href') : null;
-        }`);
-            if (!href) {
-                throw new AuthRequiredError('x.com', 'Could not find logged-in user profile link. Are you logged in?');
-            }
-            targetUser = href.replace('/', '');
+                const link = document.querySelector('a[data-testid="AppTabBar_Profile_Link"]');
+                return link ? link.getAttribute('href') : null;
+            }`);
+            if (!href)
+                throw new AuthRequiredError('x.com', 'Could not detect logged-in user. Are you logged in?');
+            targetUser = normalizeScreenName(href.replace('/', ''));
         }
-        // 1. Navigate to profile page
-        await page.goto(`https://x.com/${targetUser}`);
-        await page.wait(3);
-        // 2. Install interceptor BEFORE SPA navigation.
-        //    goto() resets JS context, but SPA click preserves it.
-        await page.installInterceptor('Following');
-        // 3. Click the following link via SPA navigation (preserves interceptor)
-        const safeUser = JSON.stringify(targetUser);
-        const clicked = await page.evaluate(`() => {
-        const target = ${safeUser};
-        const link = document.querySelector('a[href="/' + target + '/following"]');
-        if (link) { link.click(); return true; }
-        return false;
-    }`);
-        if (!clicked) {
-            throw new SelectorError('Twitter following link', 'Twitter may have changed the layout.');
+        if (!targetUser) {
+            throw new ArgumentError('twitter following user cannot be empty', 'Example: opencli twitter following @elonmusk --limit 200');
         }
-        await page.waitForCapture(5);
-        // 4. Scroll to trigger pagination API calls
-        await page.autoScroll({ times: Math.ceil(kwargs.limit / 20), delayMs: 2000 });
-        // 5. Retrieve intercepted data
-        const requests = await page.getInterceptedRequests();
-        const requestList = Array.isArray(requests) ? requests : [];
-        if (requestList.length === 0) {
-            return [];
+
+        const followingQueryId = await resolveTwitterQueryId(page, 'Following', FOLLOWING_QUERY_ID);
+        const userByScreenNameQueryId = await resolveTwitterQueryId(page, 'UserByScreenName', USER_BY_SCREEN_NAME_QUERY_ID);
+        const headers = JSON.stringify({
+            'Authorization': `Bearer ${decodeURIComponent(BEARER_TOKEN)}`,
+            'X-Csrf-Token': ct0,
+            'X-Twitter-Auth-Type': 'OAuth2Session',
+            'X-Twitter-Active-User': 'yes',
+        });
+
+        // Get userId from screen_name
+        const userLookup = await page.evaluate(`async () => {
+            const url = ${JSON.stringify(buildUserByScreenNameUrl(userByScreenNameQueryId, targetUser))};
+            const resp = await fetch(url, { headers: ${headers}, credentials: 'include' });
+            if (!resp.ok) return { error: resp.status };
+            const d = await resp.json();
+            return { userId: d.data?.user?.result?.rest_id || null };
+        }`);
+        if (userLookup?.error === 401 || userLookup?.error === 403) {
+            throw new AuthRequiredError('x.com', `Twitter user lookup failed (HTTP ${userLookup.error})`);
         }
-        let results = [];
-        for (const req of requestList) {
-            try {
-                // GraphQL response: { data: { user: { result: { timeline: ... } } } }
-                let instructions = req.data?.user?.result?.timeline?.timeline?.instructions;
-                if (!instructions)
-                    continue;
-                let addEntries = instructions.find((i) => i.type === 'TimelineAddEntries');
-                if (!addEntries) {
-                    addEntries = instructions.find((i) => i.entries && Array.isArray(i.entries));
-                }
-                if (!addEntries)
-                    continue;
-                for (const entry of addEntries.entries) {
-                    if (!entry.entryId.startsWith('user-'))
-                        continue;
-                    const item = entry.content?.itemContent?.user_results?.result;
-                    if (!item || item.__typename !== 'User')
-                        continue;
-                    const core = item.core || {};
-                    const legacy = item.legacy || {};
-                    results.push({
-                        screen_name: core.screen_name || legacy.screen_name || 'unknown',
-                        name: core.name || legacy.name || 'unknown',
-                        bio: legacy.description || item.profile_bio?.description || '',
-                        followers: legacy.followers_count || legacy.normal_followers_count || 0
-                    });
-                }
+        if (userLookup?.error) {
+            throw new CommandExecutionError(`HTTP ${userLookup.error}: Failed to resolve Twitter user @${targetUser}`);
+        }
+        const userId = userLookup?.userId || null;
+        if (!userId)
+            throw new CommandExecutionError(`Could not find user @${targetUser}`);
+
+        const allUsers = [];
+        const seen = new Set();
+        let cursor = null;
+
+        const maxPages = Math.ceil(limit / 50) + 2;
+        for (let i = 0; i < maxPages && allUsers.length < limit; i++) {
+            const fetchCount = Math.min(50, limit - allUsers.length + 10);
+            const apiUrl = buildFollowingUrl(followingQueryId, userId, fetchCount, cursor);
+            const data = await page.evaluate(`async () => {
+                const r = await fetch("${apiUrl}", { headers: ${headers}, credentials: 'include' });
+                return r.ok ? await r.json() : { error: r.status };
+            }`);
+            if (data?.error) {
+                if (data.error === 401 || data.error === 403)
+                    throw new AuthRequiredError('x.com', `Twitter following request failed (HTTP ${data.error})`);
+                throw new CommandExecutionError(`HTTP ${data.error}: Failed to fetch following list. queryId may have expired.`);
             }
-            catch (e) {
-                // ignore parsing errors for individual payloads
+            const { users, nextCursor } = parseFollowing(data);
+            for (const u of users) {
+                if (!seen.has(u.screen_name)) {
+                    seen.add(u.screen_name);
+                    allUsers.push(u);
+                }
             }
+            if (!nextCursor || nextCursor === cursor)
+                break;
+            cursor = nextCursor;
         }
-        // Deduplicate by screen_name
-        const unique = new Map();
-        results.forEach(r => unique.set(r.screen_name, r));
-        const deduplicatedResults = Array.from(unique.values());
-        return deduplicatedResults.slice(0, kwargs.limit);
-    }
+
+        if (allUsers.length === 0) {
+            throw new EmptyResultError('twitter following', `No following accounts found for @${targetUser}`);
+        }
+
+        return allUsers.slice(0, limit);
+    },
 });
+
+export const __test__ = {
+    sanitizeQueryId,
+    buildFollowingUrl,
+    buildUserByScreenNameUrl,
+    extractUser,
+    normalizeScreenName,
+    parseFollowing,
+};