publishport-opencli 1.0.0

package/clis/twitter/bookmark-folder.js

@@ -0,0 +1,4 @@
+import{cli as U,Strategy as P}from"@jackwener/opencli/registry";import{ArgumentError as S,AuthRequiredError as f,CommandExecutionError as O}from"@jackwener/opencli/errors";import{TWITTER_BEARER_TOKEN as C,applyTopByEngagement as F}from"./utils.js";import{extractMedia as N,resolveTwitterQueryId as _,describeTwitterApiError as R}from"./shared.js";const j="BookmarkFolderTimeline",x="13H7EUATwethsj_jZ6QQAQ",q=/^[A-Za-z0-9_-]+$/,k=100,p={rweb_video_screen_enabled:!1,profile_label_improvements_pcf_label_in_post_enabled:!0,responsive_web_profile_redirect_enabled:!1,rweb_tipjar_consumption_enabled:!1,verified_phone_label_enabled:!1,creator_subscriptions_tweet_preview_api_enabled:!0,responsive_web_graphql_timeline_navigation_enabled:!0,responsive_web_graphql_skip_user_profile_image_extensions_enabled:!1,premium_content_api_read_enabled:!1,communities_web_enable_tweet_community_results_fetch:!0,c9s_tweet_anatomy_moderator_badge_enabled:!0,articles_preview_enabled:!0,responsive_web_edit_tweet_api_enabled:!0,graphql_is_translatable_rweb_tweet_is_translatable_enabled:!0,view_counts_everywhere_api_enabled:!0,longform_notetweets_consumption_enabled:!0,responsive_web_twitter_article_tweet_consumption_enabled:!0,tweet_awards_web_tipping_enabled:!1,content_disclosure_indicator_enabled:!0,content_disclosure_ai_generated_indicator_enabled:!0,freedom_of_speech_not_reach_fetch_enabled:!0,standardized_nudges_misinfo:!0,tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled:!0,longform_notetweets_rich_text_read_enabled:!0,longform_notetweets_inline_media_enabled:!1,responsive_web_enhance_cards_enabled:!1};function L(J,V,z,H){const $={bookmark_collection_id:String(V),count:z,includePromotedContent:!1};if(H)$.cursor=H;return`/i/api/graphql/${J}/${j}?variables=${encodeURIComponent(JSON.stringify($))}&features=${encodeURIComponent(JSON.stringify(p))}`}export function extractFolderTweet(J,V){if(!J)return null;const z=J.tweet||J,H=z.legacy||{};if(!z.rest_id||V.has(z.rest_id))return null;V.add(z.rest_id);const $=z.core?.user_results?.result,W=$?.legacy?.screen_name||$?.core?.screen_name||"",Y=z.note_tweet?.note_tweet_results?.result?.text;return{id:z.rest_id,author:W,text:Y||H.full_text||"",likes:H.favorite_count||0,retweets:H.retweet_count||0,bookmarks:H.bookmark_count||0,created_at:H.created_at||"",url:W?`https://x.com/${W}/status/${z.rest_id}`:`https://x.com/i/status/${z.rest_id}`,...N(H)}}export function parseBookmarkFolderTimeline(J,V){const z=[];let H=null;const $=J?.data?.bookmark_collection_timeline?.timeline?.instructions||J?.data?.bookmark_timeline_v2?.timeline?.instructions||J?.data?.bookmark_timeline?.timeline?.instructions||[];for(const W of $)for(const Y of W.entries||[]){const Z=Y.content;if(Z?.entryType==="TimelineTimelineCursor"||Z?.__typename==="TimelineTimelineCursor"){if(Z.cursorType==="Bottom"||Z.cursorType==="ShowMore")H=Z.value;continue}if(Y.entryId?.startsWith("cursor-bottom-")||Y.entryId?.startsWith("cursor-showMore-")){H=Z?.value||Z?.itemContent?.value||H;continue}const X=extractFolderTweet(Z?.itemContent?.tweet_results?.result,V);if(X){z.push(X);continue}for(const Q of Z?.items||[]){const G=extractFolderTweet(Q.item?.itemContent?.tweet_results?.result,V);if(G)z.push(G)}}return{tweets:z,nextCursor:H}}U({site:"twitter",name:"bookmark-folder",access:"read",description:"Read the tweets inside a single Twitter/X bookmark folder. Get the folder id from `opencli twitter bookmark-folders`.",domain:"x.com",strategy:P.COOKIE,browser:!0,args:[{name:"folder-id",positional:!0,type:"string",required:!0,help:"Folder id from `opencli twitter bookmark-folders`."},{name:"limit",type:"int",default:20,help:"Maximum number of bookmarks to return (default 20)."},{name:"top-by-engagement",type:"int",default:0,help:"When set to N>0, re-rank the folder by weighted engagement (likes×1 + retweets×3 + replies×2 + bookmarks×5 + log10(views+1)×0.5) and return the top N. Default 0 keeps the API's native (saved-time) ordering."}],columns:["id","author","text","likes","retweets","bookmarks","created_at","url","has_media","media_urls","media_posters"],func:async(J,V)=>{const z=String(V["folder-id"]||"").trim();if(!z||!q.test(z))throw new S(`Invalid folder-id: ${JSON.stringify(V["folder-id"])}. Expected a safe folder ID from \`opencli twitter bookmark-folders\`.`);const H=Number(V.limit??20);if(!Number.isInteger(H)||H<1)throw new S(`Invalid --limit: ${JSON.stringify(V.limit)}. Expected a positive integer.`);const W=(await J.getCookies({url:"https://x.com"})).find((K)=>K.name==="ct0")?.value||null;if(!W)throw new f("x.com","Not logged into x.com (no ct0 cookie)");const Y=await _(J,j,x),Z=JSON.stringify({Authorization:`Bearer ${decodeURIComponent(C)}`,"X-Csrf-Token":W,"X-Twitter-Auth-Type":"OAuth2Session","X-Twitter-Active-User":"yes"}),X=[],Q=new Set;let G=null;for(let K=0;K<k&&X.length<H;K++){const h=Math.min(100,H-X.length+10),B=L(Y,z,h,G),b=await J.evaluate(`async () => {
+                const r = await fetch(${JSON.stringify(B)}, { headers: ${Z}, credentials: 'include' });
+                return r.ok ? await r.json() : { error: r.status };
+            }`);if(b?.error){if(X.length===0)throw new O(R("BookmarkFolderTimeline",b.error,`folder=${z}`));break}const{tweets:D,nextCursor:v}=parseBookmarkFolderTimeline(b,Q);X.push(...D);if(!v||v===G)break;G=v}const M=X.slice(0,H);return F(M,V["top-by-engagement"])}});export const __test__={parseBookmarkFolderTimeline,extractFolderTweet,buildFolderTimelineUrl:L,FOLDER_ID_PATTERN:q};

package/clis/twitter/bookmark-folders.js

@@ -0,0 +1,4 @@
+import{cli as K,Strategy as L}from"@jackwener/opencli/registry";import{AuthRequiredError as M,CommandExecutionError as P}from"@jackwener/opencli/errors";import{TWITTER_BEARER_TOKEN as Q}from"./utils.js";import{resolveTwitterQueryId as S,describeTwitterApiError as C}from"./shared.js";const D="bookmarkFoldersSlice",j="i78YDd0Tza-dWKw5H2Y7WA",B={rweb_tipjar_consumption_enabled:!1,responsive_web_graphql_exclude_directive_enabled:!0,verified_phone_label_enabled:!1,creator_subscriptions_tweet_preview_api_enabled:!0,responsive_web_graphql_timeline_navigation_enabled:!0,responsive_web_graphql_skip_user_profile_image_extensions_enabled:!1};function W(G){const J=JSON.stringify({});return`/i/api/graphql/${G}/${D}?variables=${encodeURIComponent(J)}&features=${encodeURIComponent(JSON.stringify(B))}`}export function parseBookmarkFolders(G,J){const V=[],Z=G?.data?.viewer?.bookmark_collections_slice||G?.data?.viewer_v2?.user_results?.result?.bookmark_collections_slice||G?.data?.bookmark_collections_slice||null,$=Z?.items||Z?.timeline?.timeline?.instructions?.flatMap?.((H)=>H.entries||[])||[];for(const H of $){const z=H?.bookmarkCollection||H?.content?.bookmarkCollection||H?.content?.itemContent?.bookmark_collection||H,X=z?.id_str||z?.id||z?.rest_id||"";if(!X||J.has(X))continue;J.add(X);const x=z?.name||z?.collection_name||"",Y=Number(z?.bookmarks_count??z?.items_count??z?.count??0)||0,v=z?.created_at||z?.timestamp_ms||"";V.push({id:String(X),name:String(x),items:Y,created_at:String(v)})}return V}K({site:"twitter",name:"bookmark-folders",access:"read",description:"List your Twitter/X bookmark folders (the user-created collections under Bookmarks). Returns folder id, name, item count, and created_at.",domain:"x.com",strategy:L.COOKIE,browser:!0,args:[],columns:["id","name","items","created_at"],func:async(G)=>{const V=(await G.getCookies({url:"https://x.com"})).find((x)=>x.name==="ct0")?.value||null;if(!V)throw new M("x.com","Not logged into x.com (no ct0 cookie)");const Z=await S(G,D,j),$=JSON.stringify({Authorization:`Bearer ${decodeURIComponent(Q)}`,"X-Csrf-Token":V,"X-Twitter-Auth-Type":"OAuth2Session","X-Twitter-Active-User":"yes"}),H=W(Z),z=await G.evaluate(`async () => {
+            const r = await fetch(${JSON.stringify(H)}, { headers: ${$}, credentials: 'include' });
+            return r.ok ? await r.json() : { error: r.status };
+        }`);if(z?.error)throw new P(C("bookmarkFoldersSlice",z.error,"account may not have folder access"));return parseBookmarkFolders(z,new Set)}});export const __test__={parseBookmarkFolders,buildUrl:W};

package/clis/twitter/bookmark.js

@@ -0,0 +1,44 @@
+import{CommandExecutionError as a}from"@jackwener/opencli/errors";import{cli as i,Strategy as s}from"@jackwener/opencli/registry";import{parseTweetUrl as l,buildTwitterArticleScopeSource as n}from"./shared.js";i({site:"twitter",name:"bookmark",access:"write",description:"Bookmark a tweet",domain:"x.com",strategy:s.UI,browser:!0,args:[{name:"url",type:"string",positional:!0,required:!0,help:"Tweet URL to bookmark"}],columns:["status","message"],func:async(e,o)=>{if(!e)throw new a("Browser session required for twitter bookmark");const r=l(o.url);await e.goto(r.url);await e.wait({selector:'[data-testid="primaryColumn"]'});const t=await e.evaluate(`(async () => {
+        try {
+            ${n(r.id)}
+            // Article-scoped: on conversation pages multiple bookmark/remove
+            // buttons render and a bare querySelector would silently bookmark
+            // a different tweet (e.g. the parent of the requested reply).
+            let attempts = 0;
+            let bookmarkBtn = null;
+            let removeBtn = null;
+            let targetArticle = null;
+
+            while (attempts < 20) {
+                targetArticle = findTargetArticle();
+                removeBtn = targetArticle?.querySelector('[data-testid="removeBookmark"]') || null;
+                if (removeBtn) {
+                    return { ok: true, message: 'Tweet is already bookmarked.' };
+                }
+
+                bookmarkBtn = targetArticle?.querySelector('[data-testid="bookmark"]') || null;
+                if (bookmarkBtn) break;
+
+                await new Promise(r => setTimeout(r, 500));
+                attempts++;
+            }
+
+            if (!bookmarkBtn) {
+                return { ok: false, message: 'Could not find Bookmark button on the requested tweet. Are you logged in?' };
+            }
+
+            bookmarkBtn.click();
+            await new Promise(r => setTimeout(r, 1000));
+
+            // Verify
+            const verifyArticle = findTargetArticle() || targetArticle;
+            const verify = verifyArticle?.querySelector('[data-testid="removeBookmark"]');
+            if (verify) {
+                return { ok: true, message: 'Tweet successfully bookmarked.' };
+            } else {
+                return { ok: false, message: 'Bookmark action initiated but UI did not update.' };
+            }
+        } catch (e) {
+            return { ok: false, message: e.toString() };
+        }
+    })()`);if(t.ok)await e.wait(2);return[{status:t.ok?"success":"failed",message:t.message}]}});

package/clis/twitter/bookmarks.js

@@ -0,0 +1,27 @@
+import{cli as Y,Strategy as j}from"@jackwener/opencli/registry";import{AuthRequiredError as h,CommandExecutionError as M}from"@jackwener/opencli/errors";import{extractMedia as N,describeTwitterApiError as S}from"./shared.js";import{TWITTER_BEARER_TOKEN as U,applyTopByEngagement as I}from"./utils.js";const G="Fy0QMy4q_aZCpkO0PnyLYw",K=100,O={rweb_video_screen_enabled:!1,profile_label_improvements_pcf_label_in_post_enabled:!0,responsive_web_profile_redirect_enabled:!1,rweb_tipjar_consumption_enabled:!1,verified_phone_label_enabled:!1,creator_subscriptions_tweet_preview_api_enabled:!0,responsive_web_graphql_timeline_navigation_enabled:!0,responsive_web_graphql_skip_user_profile_image_extensions_enabled:!1,premium_content_api_read_enabled:!1,communities_web_enable_tweet_community_results_fetch:!0,c9s_tweet_anatomy_moderator_badge_enabled:!0,articles_preview_enabled:!0,responsive_web_edit_tweet_api_enabled:!0,graphql_is_translatable_rweb_tweet_is_translatable_enabled:!0,view_counts_everywhere_api_enabled:!0,longform_notetweets_consumption_enabled:!0,responsive_web_twitter_article_tweet_consumption_enabled:!0,tweet_awards_web_tipping_enabled:!1,content_disclosure_indicator_enabled:!0,content_disclosure_ai_generated_indicator_enabled:!0,freedom_of_speech_not_reach_fetch_enabled:!0,standardized_nudges_misinfo:!0,tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled:!0,longform_notetweets_rich_text_read_enabled:!0,longform_notetweets_inline_media_enabled:!1,responsive_web_enhance_cards_enabled:!1};function C(J,V){const z={count:J,includePromotedContent:!1};if(V)z.cursor=V;return`/i/api/graphql/${G}/Bookmarks?variables=${encodeURIComponent(JSON.stringify(z))}&features=${encodeURIComponent(JSON.stringify(O))}`}export function extractBookmarkTweet(J,V){if(!J)return null;const z=J.tweet||J,L=z.legacy||{};if(!z.rest_id||V.has(z.rest_id))return null;V.add(z.rest_id);const Z=z.core?.user_results?.result,f=Z?.legacy?.screen_name||Z?.core?.screen_name||"unknown",$=Z?.legacy?.name||Z?.core?.name||"",H=z.note_tweet?.note_tweet_results?.result?.text;return{id:z.rest_id,author:f,name:$,text:H||L.full_text||"",likes:L.favorite_count||0,retweets:L.retweet_count||0,bookmarks:L.bookmark_count||0,created_at:L.created_at||"",url:`https://x.com/${f}/status/${z.rest_id}`,...N(L)}}export function parseBookmarks(J,V){const z=[];let L=null;const Z=J?.data?.bookmark_timeline_v2?.timeline?.instructions||J?.data?.bookmark_timeline?.timeline?.instructions||[];for(const f of Z)for(const $ of f.entries||[]){const H=$.content;if(H?.entryType==="TimelineTimelineCursor"||H?.__typename==="TimelineTimelineCursor"){if(H.cursorType==="Bottom"||H.cursorType==="ShowMore")L=H.value;continue}if($.entryId?.startsWith("cursor-bottom-")||$.entryId?.startsWith("cursor-showMore-")){L=H?.value||H?.itemContent?.value||L;continue}const W=extractBookmarkTweet(H?.itemContent?.tweet_results?.result,V);if(W){z.push(W);continue}for(const F of H?.items||[]){const X=extractBookmarkTweet(F.item?.itemContent?.tweet_results?.result,V);if(X)z.push(X)}}return{tweets:z,nextCursor:L}}Y({site:"twitter",name:"bookmarks",access:"read",description:"Fetch your Twitter/X bookmarks (the logged-in user's saved tweets, newest first)",domain:"x.com",strategy:j.COOKIE,browser:!0,args:[{name:"limit",type:"int",default:20,help:"Maximum number of bookmarks to return (default 20)."},{name:"top-by-engagement",type:"int",default:0,help:"When set to N>0, re-rank the bookmarks by weighted engagement (likes×1 + retweets×3 + replies×2 + bookmarks×5 + log10(views+1)×0.5) and return the top N. Default 0 keeps the API's native (saved-time) ordering."}],columns:["id","author","text","likes","retweets","bookmarks","created_at","url","has_media","media_urls","media_posters"],func:async(J,V)=>{const z=V.limit||20,Z=(await J.getCookies({url:"https://x.com"})).find((b)=>b.name==="ct0")?.value||null;if(!Z)throw new h("x.com","Not logged into x.com (no ct0 cookie)");const f=await J.evaluate(`async () => {
+      try {
+        const ghResp = await fetch('https://raw.githubusercontent.com/fa0311/twitter-openapi/refs/heads/main/src/config/placeholder.json');
+        if (ghResp.ok) {
+          const data = await ghResp.json();
+          const entry = data['Bookmarks'];
+          if (entry && entry.queryId) return entry.queryId;
+        }
+      } catch {}
+      try {
+        const scripts = performance.getEntriesByType('resource')
+          .filter(r => r.name.includes('client-web') && r.name.endsWith('.js'))
+          .map(r => r.name);
+        for (const scriptUrl of scripts.slice(0, 15)) {
+          try {
+            const text = await (await fetch(scriptUrl)).text();
+            const re = /queryId:"([A-Za-z0-9_-]+)"[^}]{0,200}operationName:"Bookmarks"/;
+            const m = text.match(re);
+            if (m) return m[1];
+          } catch {}
+        }
+      } catch {}
+      return null;
+    }`)||G,$=JSON.stringify({Authorization:`Bearer ${decodeURIComponent(U)}`,"X-Csrf-Token":Z,"X-Twitter-Auth-Type":"OAuth2Session","X-Twitter-Active-User":"yes"}),H=[],W=new Set;let F=null;for(let b=0;b<K&&H.length<z;b++){const P=Math.min(100,z-H.length+10),D=C(P,F).replace(G,f),q=await J.evaluate(`async () => {
+        const r = await fetch("${D}", { headers: ${$}, credentials: 'include' });
+        return r.ok ? await r.json() : { error: r.status };
+      }`);if(q?.error){if(H.length===0)throw new M(S("Bookmarks",q.error));break}const{tweets:Q,nextCursor:v}=parseBookmarks(q,W);H.push(...Q);if(!v||v===F)break;F=v}const X=H.slice(0,z);return I(X,V["top-by-engagement"])}});export const __test__={parseBookmarks,extractBookmarkTweet};

package/clis/twitter/delete.js

@@ -0,0 +1,36 @@
+import{cli as Y,Strategy as Z}from"@jackwener/opencli/registry";import{CommandExecutionError as _}from"@jackwener/opencli/errors";import{parseTweetUrl as $,buildTwitterArticleScopeSource as q}from"./shared.js";function O(z){return`(() => {
+        try {
+            const visible = (el) => !!el && (el.offsetParent !== null || el.getClientRects().length > 0);
+            ${q(z)}
+            const targetArticle = findTargetArticle();
+            if (!targetArticle) return { article: false, found: false };
+            let moreMenu = Array.from(targetArticle.querySelectorAll('[data-testid="caret"]')).find(visible);
+            if (!moreMenu) {
+                const buttons = Array.from(targetArticle.querySelectorAll('button,[role="button"]'));
+                moreMenu = buttons.find((el) => visible(el) && (el.getAttribute('aria-label') || '').trim() === 'More');
+            }
+            if (!moreMenu) return { article: true, found: false };
+            moreMenu.click();
+            return { article: true, found: true };
+        } catch (e) { return { article: false, found: false }; }
+    })()`}function P(){return`(() => {
+        try {
+            const items = Array.from(document.querySelectorAll('[role="menuitem"]'));
+            const deleteBtn = items.find((item) => {
+                const text = (item.textContent || '').trim();
+                const isList = text.includes('List') || text.includes('列表');
+                const isDelete = text.includes('Delete') || text.includes('删除');
+                return isDelete && !isList;
+            });
+            if (!deleteBtn) return { found: false };
+            deleteBtn.click();
+            return { found: true };
+        } catch (e) { return { found: false }; }
+    })()`}function Q(){return`(() => {
+        try {
+            const confirmBtn = document.querySelector('[data-testid="confirmationSheetConfirm"]');
+            if (!confirmBtn) return { found: false };
+            confirmBtn.click();
+            return { found: true };
+        } catch (e) { return { found: false }; }
+    })()`}Y({site:"twitter",name:"delete",access:"write",description:"Delete a specific tweet by URL",domain:"x.com",strategy:Z.UI,browser:!0,args:[{name:"url",type:"string",required:!0,positional:!0,help:"The URL of the tweet to delete"}],columns:["status","message"],func:async(z,R)=>{if(!z)throw new _("Browser session required for twitter delete");const J=$(R.url);await z.goto(J.url);await z.wait({selector:'[data-testid="primaryColumn"]'});const H=async(v,V,X=12)=>{let G;for(let N=0;N<X;N++){G=await z.evaluate(v);if(V(G))return G;await z.wait(0.5)}return G},B=await H(O(J.id),(v)=>!!(v&&v.found));if(!B||!B.found){if(B&&B.article===!1)return[{status:"failed",message:"Could not find the tweet card matching the requested URL."}];return[{status:"failed",message:'Could not find the "More" context menu on the matched tweet. Are you sure you are logged in and looking at a valid tweet?'}]}const K=await H(P(),(v)=>!!(v&&v.found));if(!K||!K.found)return[{status:"failed",message:"The matched tweet menu did not contain Delete. This tweet may not belong to you."}];const L=await H(Q(),(v)=>!!(v&&v.found));if(!L||!L.found)return[{status:"failed",message:"Delete confirmation dialog did not appear."}];await z.wait(2);return[{status:"success",message:"Tweet successfully deleted."}]}});export const __test__={buildFindAndClickMoreScript:O,buildClickDeleteScript:P,buildClickConfirmScript:Q};

package/clis/twitter/device-follow.js

@@ -0,0 +1,13 @@
+import{ArgumentError as D,AuthRequiredError as f,CommandExecutionError as P,EmptyResultError as F}from"@jackwener/opencli/errors";import{cli as k,Strategy as C}from"@jackwener/opencli/registry";import{TWITTER_BEARER_TOKEN as M,applyTopByEngagement as x}from"./utils.js";import{describeTwitterApiError as L}from"./shared.js";const _="/i/api/2/notifications/device_follow.json",V=200;function q(z){if(z===void 0||z===null||z==="")return 20;const G=Number(z);if(!Number.isInteger(G)||G<1||G>V)throw new D(`--limit must be an integer between 1 and ${V}`);return G}function B(z){const G=new URLSearchParams({include_profile_interstitial_type:"1",include_blocking:"1",include_blocked_by:"1",include_followed_by:"1",include_want_retweets:"1",include_mute_edge:"1",include_can_dm:"1",include_can_media_tag:"1",include_ext_has_nft_avatar:"1",include_ext_is_blue_verified:"1",include_ext_verified_type:"1",skip_status:"1",cards_platform:"Web-12",include_cards:"1",include_ext_alt_text:"true",include_quote_count:"true",include_reply_count:"1",tweet_mode:"extended",include_ext_views:"true",count:String(z)});return`${_}?${G.toString()}`}function W(z){if(!z||!Array.isArray(z.instructions))return null;const G=[];for(const Y of z.instructions){const J=Y?.addEntries?.entries;if(Array.isArray(J))G.push(...J)}return G}function N(z,G,Y){const J=z?.content?.item?.content?.tweet?.id;if(!J)return null;const Z=G?.[J];if(!Z)return null;const $=Y?.[Z.user_id_str]||null;if(typeof $?.screen_name!=="string"||!$.screen_name)return null;return{tweetId:J,tweet:Z,user:$}}function O({tweetId:z,tweet:G,user:Y}){const J=Y.screen_name;return{id:z,author:J,text:G?.full_text||G?.text||"",likes:G?.favorite_count??0,retweets:G?.retweet_count??0,replies:G?.reply_count??0,views:null,created_at:G?.created_at||"",url:`https://x.com/${J}/status/${z}`}}function U(z,G){if(!z?.globalObjects||typeof z.globalObjects!=="object")return null;const Y=z?.globalObjects?.tweets||{},J=z?.globalObjects?.users||{};if(typeof Y!=="object"||typeof J!=="object")return null;const Z=W(z?.timeline);if(!Z)return null;const $=[];let S=0,Q=0;for(const H of Z){if(!Boolean(H?.content?.item?.content?.tweet?.id)){Q++;continue}const K=N(H,Y,J);if(!K){S++;continue}if(G.has(K.tweetId))continue;G.add(K.tweetId);$.push(O(K))}return{rows:$,entryCount:Z.length,unmatchedTweetEntries:S,malformedEntries:Q}}k({site:"twitter",name:"device-follow",access:"read",description:'Read the /i/timeline device-follow notification stream (tweets aggregated under a bell-icon "new posts from @userA and N others" notification)',domain:"x.com",strategy:C.COOKIE,browser:!0,args:[{name:"limit",type:"int",default:20,help:`Maximum number of tweets to return (1-${V}, default 20)`},{name:"top-by-engagement",type:"int",default:0,help:"When set to N>0, re-rank by weighted engagement and return the top N. Default 0 keeps upstream ordering."}],columns:["id","author","text","likes","retweets","replies","views","created_at","url"],func:async(z,G)=>{const Y=q(G.limit),Z=(await z.getCookies({url:"https://x.com"})).find((b)=>b.name==="ct0")?.value||null;if(!Z)throw new f("x.com","Not logged into x.com (no ct0 cookie)");const $=B(Y),S=JSON.stringify({Authorization:`Bearer ${decodeURIComponent(M)}`,"X-Csrf-Token":Z,"X-Twitter-Auth-Type":"OAuth2Session","X-Twitter-Active-User":"yes"}),Q=await z.evaluate(`async () => {
+        try {
+          const r = await fetch("${$}", { method: "GET", headers: ${S}, credentials: 'include' });
+          if (!r.ok) return { error: r.status };
+          try {
+            return await r.json();
+          } catch (e) {
+            return { errorKind: 'non_json', detail: String(e && e.message || e) };
+          }
+        } catch (e) {
+          return { errorKind: 'exception', detail: String(e && e.message || e) };
+        }
+      }`);if(Q?.errorKind==="non_json")throw new P(`Twitter device-follow returned non-JSON response: ${Q.detail||"unknown parse error"}`);if(Q?.errorKind==="exception")throw new P(`Twitter device-follow fetch failed: ${Q.detail||"unknown error"}`);if(Q?.error){if(Q.error===401||Q.error===403)throw new f("x.com",`Twitter device-follow returned HTTP ${Q.error}`);throw new P(L("device_follow",Q.error))}const H=U(Q,new Set);if(!H)throw new P("Twitter device-follow response was missing the expected timeline/globalObjects shape.");if(H.malformedEntries>0||H.unmatchedTweetEntries>0)throw new P("Twitter device-follow entries could not be joined to tweet/user objects.");if(H.rows.length===0)throw new F("twitter device-follow","No device-follow notification tweets found.");const K=H.rows.slice(0,Y);return x(K,G["top-by-engagement"])}});export const __test__={buildDeviceFollowUrl:B,extractEntries:W,joinEntryToTweet:N,shapeRow:O,parseDeviceFollow:U,parseLimit:q};

package/clis/twitter/dm-list.js

@@ -0,0 +1 @@
+import{cli as S,Strategy as T}from"@jackwener/opencli/registry";import{CommandExecutionError as G}from"@jackwener/opencli/errors";import{DM_REQUEST_QUERY as b,buildQuery as j,getDmAuth as B,dmApiFetch as M,shapeDmMessages as Q}from"./dm-shared.js";S({site:"twitter",name:"dm-list",access:"read",description:"List recent DM conversations (id, participants, last message, unread state)",domain:"x.com",strategy:T.COOKIE,browser:!0,args:[{name:"limit",type:"int",required:!1,default:20,help:"Maximum number of conversations to return (default 20)"}],columns:["conversation_id","type","participants","last_message","last_time","trusted","muted"],func:async(V,P)=>{const Y=Number(P.limit??20),{ownId:W,headers:x}=await B(V),A="https://x.com/i/api/1.1/dm/inbox_initial_state.json?"+j(b),J=await M(V,A,x);if(J?.error)throw new G(`inbox_initial_state failed: HTTP ${J.error} ${J.body||""}`);const H=J?.inbox_initial_state;if(!H||typeof H!=="object")throw new G("inbox_initial_state missing in response");const X=H.users||{},I=H.conversations||{},K=new Map;for(const q of Q(H.entries,X)){if(!q.conversation_id)continue;const f=K.get(q.conversation_id);if(!f||(q.time||"")>(f.time||""))K.set(q.conversation_id,q)}const Z=Object.entries(I).map(([q,f])=>{const $=(f.participants||[]).map((z)=>String(z.user_id)).filter((z)=>z!==W),N=($.length?$:[W]).map((z)=>{const F=X[z];return F?.screen_name?`@${F.screen_name}`:z}),L=K.get(q)||null;return{conversation_id:q,type:f.type||null,participants:N.join(","),last_message:L?L.text.slice(0,120):null,last_time:L?.time||(f.sort_timestamp?new Date(Number(f.sort_timestamp)).toISOString():null),trusted:f.trusted!==!1,muted:Boolean(f.muted)}});Z.sort((q,f)=>(f.last_time||"").localeCompare(q.last_time||""));return Z.slice(0,Y)}});

package/clis/twitter/dm-read.js

@@ -0,0 +1 @@
+import{cli as P,Strategy as X}from"@jackwener/opencli/registry";import{CommandExecutionError as Z}from"@jackwener/opencli/errors";import{DM_REQUEST_QUERY as Y,buildQuery as b,getDmAuth as C,dmApiFetch as R,resolveTwitterUserId as T,shapeDmMessages as j}from"./dm-shared.js";const y=50;P({site:"twitter",name:"dm-read",access:"read",description:"Read message history of one DM conversation (by conversation id from dm-list, or @screen_name / numeric user id for the 1-on-1 conversation)",domain:"x.com",strategy:X.COOKIE,browser:!0,args:[{name:"conversation",type:"string",required:!0,positional:!0,help:"Conversation id like 123-456 (from `dm-list`), or @screen_name / numeric user id of the peer"},{name:"limit",type:"int",required:!1,default:50,help:"Maximum number of messages to return, newest first (default 50)"}],columns:["id","sender","text","time","media_url"],func:async(K,O)=>{const V=Number(O.limit??50),{ownId:$,headers:W}=await C(K),L=String(O.conversation??"").trim();let z;if(/^\d+-\d+$/.test(L))z=L;else z=`${await T(K,L,W)}-${$}`;const B=[];let H=null;for(let f=0;f<y&&B.length<V;f++){const F=`https://x.com/i/api/1.1/dm/conversation/${z}.json?`+b(Y,{context:"FETCH_DM_CONVERSATION_HISTORY",include_conversation_info:"true",...H?{max_id:H}:{}}),J=await R(K,F,W);if(J?.error){if(B.length===0)throw new Z(`dm/conversation failed for ${z}: HTTP ${J.error} ${J.body||""}`);break}const q=J?.conversation_timeline;if(!q)throw new Z("conversation_timeline missing in response");const G=j(q.entries,q.users);for(const N of G){if(!N.conversation_id)N.conversation_id=z;B.push(N)}if(q.status==="AT_END"||!q.min_entry_id||q.min_entry_id===H)break;H=q.min_entry_id}return B.slice(0,V).map((f)=>({id:f.id,sender:f.sender,text:f.text,time:f.time,media_url:f.media_url}))}});

package/clis/twitter/dm-send.js

@@ -0,0 +1,13 @@
+import{cli as $,Strategy as q}from"@jackwener/opencli/registry";import{ArgumentError as L,CommandExecutionError as W}from"@jackwener/opencli/errors";import{DM_SEND_QUERY as N,buildQuery as P,getDmAuth as R,resolveTwitterUserId as T,shapeDmMessages as Y}from"./dm-shared.js";import{assertLiteralContent as A}from"../_shared/content-guard.js";$({site:"twitter",name:"dm-send",access:"write",description:"Send a direct message to one user (by @screen_name, numeric user id, or conversation id from dm-list)",domain:"x.com",strategy:q.COOKIE,browser:!0,args:[{name:"user",type:"string",required:!0,positional:!0,help:"Recipient: @screen_name, numeric user id, or a conversation id like 123-456 from `dm-list`"},{name:"text",type:"string",required:!0,positional:!0,help:"Message text to send"},{name:"reply-to",type:"string",required:!1,help:"Message id to reply to (from `dm-read`)"}],columns:["id","conversation_id","text","time","status"],func:async(G,B)=>{const H=String(B.text??"").trim();A(H,{label:"私信内容"});if(!H)throw new L("Message text must not be empty");const{ownId:X,headers:K}=await R(G),J=String(B.user??"").trim();let F;if(/^\d+-\d+$/.test(J))F=J;else F=`${await T(G,J,K)}-${X}`;const O={cards_platform:"Web-12",conversation_id:F,dm_users:!1,include_cards:1,include_quote_count:!0,recipient_ids:!1,text:H,audio_only_media_attachment:!1};if(B["reply-to"])O.reply_to_dm_id=String(B["reply-to"]).trim();const Z="https://x.com/i/api/1.1/dm/new2.json?"+P(N),f=await G.evaluate(`async () => {
+            const body = ${JSON.stringify(O)};
+            body.request_id = crypto.randomUUID();
+            const r = await fetch(${JSON.stringify(Z)}, {
+                method: 'POST',
+                headers: Object.assign(${JSON.stringify(K)}, { 'Content-Type': 'application/json' }),
+                credentials: 'include',
+                body: JSON.stringify(body),
+            });
+            const text = await r.text();
+            if (!r.ok) return { error: r.status, body: text.slice(0, 300) };
+            try { return JSON.parse(text); } catch { return { error: 'bad-json', body: text.slice(0, 300) }; }
+        }`);if(f?.error)throw new W(`dm/new2.json failed: HTTP ${f.error} ${f.body||""}`);const V=Y(f.entries,f.users);if(!V.length)throw new W(`DM send returned no message entry (response keys: ${Object.keys(f||{}).join(",")})`);return V.map((z)=>({id:z.id,conversation_id:z.conversation_id||F,text:z.text,time:z.time,status:"sent"}))}});

package/clis/twitter/dm-shared.js

@@ -0,0 +1,6 @@
+import{AuthRequiredError as W,CommandExecutionError as b}from"@jackwener/opencli/errors";import{TWITTER_BEARER_TOKEN as f}from"./utils.js";import{resolveTwitterOperationMetadata as q}from"./shared.js";export const DM_REQUEST_QUERY={nsfw_filtering_enabled:"false",filter_low_quality:"true",include_quality:"all",include_profile_interstitial_type:"1",include_blocking:"1",include_blocked_by:"1",include_followed_by:"1",include_want_retweets:"1",include_mute_edge:"1",include_can_dm:"1",include_can_media_tag:"1",include_ext_is_blue_verified:"1",include_ext_verified_type:"1",include_ext_profile_image_shape:"1",skip_status:"1",dm_secret_conversations_enabled:"false",krs_registration_enabled:"false",cards_platform:"Web-12",include_cards:"1",include_ext_alt_text:"true",include_ext_limited_action_results:"true",include_quote_count:"true",include_reply_count:"1",tweet_mode:"extended",include_ext_views:"true",dm_users:"true",include_groups:"true",include_inbox_timelines:"true",include_ext_media_color:"true",supports_reactions:"true",supports_edit:"true",include_ext_edit_control:"true",include_ext_business_affiliations_label:"true",include_ext_parody_commentary_fan_label:"true",ext:"mediaColor,altText,businessAffiliationsLabel,mediaStats,highlightedLabel,parodyCommentaryFanLabel,voiceInfo,birdwatchPivot,superFollowMetadata,unmentionInfo,editControl,article"},DM_SEND_QUERY={ext:"mediaColor,altText,mediaStats,highlightedLabel,voiceInfo,birdwatchPivot,superFollowMetadata,unmentionInfo,editControl,article",include_ext_alt_text:"true",include_ext_limited_action_results:"true",include_reply_count:"1",tweet_mode:"extended",include_ext_views:"true",include_groups:"true",include_inbox_timelines:"true",include_ext_media_color:"true",supports_reactions:"true",supports_edit:"true"};export function buildQuery(J,H={}){const G={...J,...H};return Object.entries(G).filter(([,D])=>D!==null&&D!==void 0).map(([D,z])=>`${encodeURIComponent(D)}=${encodeURIComponent(String(z))}`).join("&")}export async function getDmAuth(J){const H=await J.getCookies({url:"https://x.com"}),G=H.find((P)=>P.name==="ct0")?.value||null;if(!G)throw new W("x.com","Not logged into x.com (no ct0 cookie)");const D=H.find((P)=>P.name==="twid")?.value||"",z=decodeURIComponent(D).replace(/^u=/,"").trim();if(!/^\d+$/.test(z))throw new W("x.com","Cannot resolve own user id from twid cookie");const V={Authorization:`Bearer ${decodeURIComponent(f)}`,"X-Csrf-Token":G,"X-Twitter-Auth-Type":"OAuth2Session","X-Twitter-Active-User":"yes"};return{ct0:G,ownId:z,headers:V}}export async function dmApiFetch(J,H,G,D=null){const z=D?`, { method: ${JSON.stringify(D.method||"GET")}, headers: Object.assign(${JSON.stringify(G)}, ${JSON.stringify(D.extraHeaders||{})}), credentials: 'include', body: ${JSON.stringify(D.body??null)} }`:`, { headers: ${JSON.stringify(G)}, credentials: 'include' }`;return J.evaluate(`async () => {
+        const r = await fetch(${JSON.stringify(H)}${z});
+        const text = await r.text();
+        if (!r.ok) return { error: r.status, body: text.slice(0, 300) };
+        try { return JSON.parse(text); } catch { return { error: 'bad-json', body: text.slice(0, 300) }; }
+    }`)}const Q={queryId:"IGgvgiOx4QZndDHuD3x9TQ",features:{hidden_profile_subscriptions_enabled:!0,profile_label_improvements_pcf_label_in_post_enabled:!0,responsive_web_profile_redirect_enabled:!1,rweb_tipjar_consumption_enabled:!1,verified_phone_label_enabled:!1,subscriptions_verification_info_is_identity_verified_enabled:!0,subscriptions_verification_info_verified_since_enabled:!0,highlights_tweets_tab_ui_enabled:!0,responsive_web_twitter_article_notes_tab_enabled:!0,subscriptions_feature_can_gift_premium:!0,creator_subscriptions_tweet_preview_api_enabled:!0,responsive_web_graphql_skip_user_profile_image_extensions_enabled:!1,responsive_web_graphql_timeline_navigation_enabled:!0},fieldToggles:{withPayments:!1,withAuxiliaryUserLabels:!0}};export async function resolveTwitterUserId(J,H,G){const D=String(H||"").trim().replace(/^@/,"");if(/^\d+$/.test(D))return D;if(!/^[A-Za-z0-9_]{1,15}$/.test(D))throw new b(`Invalid user: ${JSON.stringify(H)}. Expected @screen_name or numeric user id.`);const z=await q(J,"UserByScreenName",Q.queryId),V=Object.keys(z.features||{}).length?z.features:Q.features,P=Object.keys(z.fieldToggles||{}).length?z.fieldToggles:Q.fieldToggles,X=`https://x.com/i/api/graphql/${z.queryId}/UserByScreenName?`+buildQuery({variables:JSON.stringify({screen_name:D}),features:JSON.stringify(V),fieldToggles:JSON.stringify(P)}),Z=await dmApiFetch(J,X,G);if(Z?.error)throw new b(`UserByScreenName failed for @${D}: HTTP ${Z.error} ${Z.body||""}`);const $=Z?.data?.user?.result?.rest_id;if(typeof $!=="string"||!$)throw new b(`User @${D} not found or unavailable`);return $}export function shapeDmMessages(J,H){const G=[];for(const D of J||[]){const z=D?.message?.message_data;if(!z?.id)continue;const V=H?.[z.sender_id],P=z.attachment?.photo?.media_url_https||z.attachment?.video?.video_info?.variants?.find((X)=>X?.content_type==="video/mp4")?.url||z.attachment?.animated_gif?.video_info?.variants?.find((X)=>X?.content_type==="video/mp4")?.url||null;G.push({id:z.id,conversation_id:D.message.conversation_id||null,sender_id:z.sender_id||null,sender:V?.screen_name?`@${V.screen_name}`:z.sender_id||null,text:z.text||"",time:z.time?new Date(Number(z.time)).toISOString():null,media_url:P})}return G}

package/clis/twitter/download.js

@@ -0,0 +1,38 @@
+import{cli as o,Strategy as r}from"@jackwener/opencli/registry";import{ArgumentError as D,AuthRequiredError as h,CliError as t,CommandExecutionError as X,EmptyResultError as T}from"@jackwener/opencli/errors";import{formatCookieHeader as C}from"@jackwener/opencli/download";import{downloadMedia as a}from"@jackwener/opencli/download/media-download";import{resolveTwitterOperationMetadata as R,normalizeTwitterGraphqlPayload as _,unwrapBrowserResult as y,normalizeTwitterScreenName as e,extractMedia as jj,parseTweetUrl as Fj}from"./shared.js";import{TWITTER_BEARER_TOKEN as Gj}from"./utils.js";const I="9EovraBTXJYGSEQXZqlLmQ",k="IGgvgiOx4QZndDHuD3x9TQ",E=100,O={rweb_video_screen_enabled:!0,rweb_cashtags_enabled:!0,profile_label_improvements_pcf_label_in_post_enabled:!0,responsive_web_profile_redirect_enabled:!0,rweb_tipjar_consumption_enabled:!0,verified_phone_label_enabled:!1,creator_subscriptions_tweet_preview_api_enabled:!0,responsive_web_graphql_timeline_navigation_enabled:!0,responsive_web_graphql_skip_user_profile_image_extensions_enabled:!1,premium_content_api_read_enabled:!1,communities_web_enable_tweet_community_results_fetch:!0,c9s_tweet_anatomy_moderator_badge_enabled:!0,responsive_web_grok_analyze_button_fetch_trends_enabled:!1,responsive_web_grok_analyze_post_followups_enabled:!0,rweb_cashtags_composer_attachment_enabled:!0,responsive_web_jetfuel_frame:!0,responsive_web_grok_share_attachment_enabled:!0,responsive_web_grok_annotations_enabled:!0,articles_preview_enabled:!0,responsive_web_edit_tweet_api_enabled:!0,rweb_conversational_replies_downvote_enabled:!0,graphql_is_translatable_rweb_tweet_is_translatable_enabled:!0,view_counts_everywhere_api_enabled:!0,longform_notetweets_consumption_enabled:!0,responsive_web_twitter_article_tweet_consumption_enabled:!0,content_disclosure_indicator_enabled:!0,content_disclosure_ai_generated_indicator_enabled:!0,responsive_web_grok_show_grok_translated_post:!1,responsive_web_grok_analysis_button_from_backend:!0,post_ctas_fetch_enabled:!1,freedom_of_speech_not_reach_fetch_enabled:!0,standardized_nudges_misinfo:!0,tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled:!0,longform_notetweets_rich_text_read_enabled:!0,longform_notetweets_inline_media_enabled:!0,responsive_web_grok_image_annotation_enabled:!0,responsive_web_grok_imagine_annotation_enabled:!0,responsive_web_grok_community_note_auto_translation_is_enabled:!1,responsive_web_enhance_cards_enabled:!1},f={withPayments:!0,withAuxiliaryUserLabels:!0,withArticleRichContentState:!0,withArticlePlainText:!0,withArticleSummaryText:!0,withArticleVoiceOver:!0,withGrokAnalyze:!0,withDisallowedReplyControls:!0},S={hidden_profile_subscriptions_enabled:!0,profile_label_improvements_pcf_label_in_post_enabled:!0,responsive_web_profile_redirect_enabled:!0,rweb_tipjar_consumption_enabled:!0,responsive_web_graphql_exclude_directive_enabled:!0,verified_phone_label_enabled:!1,subscriptions_verification_info_is_identity_verified_enabled:!0,subscriptions_verification_info_verified_since_enabled:!0,highlights_tweets_tab_ui_enabled:!0,responsive_web_twitter_article_notes_tab_enabled:!0,subscriptions_feature_can_gift_premium:!0,creator_subscriptions_tweet_preview_api_enabled:!0,responsive_web_graphql_skip_user_profile_image_extensions_enabled:!1,responsive_web_graphql_timeline_navigation_enabled:!0},N={withPayments:!0,withAuxiliaryUserLabels:!0},Hj={queryId:I,features:O,fieldToggles:f},Jj={queryId:k,features:S,fieldToggles:N};function U(j){const F=Number(j??10);if(!Number.isInteger(F)||F<1||F>1000)throw new D("--limit must be an integer between 1 and 1000");return F}function x(j,F){const G=j-F;if(G<=0)return 0;const H=G+10;if(H>100)return 100;return H}async function w(j,F){return(await a(j,F)).map((H,K)=>{const V=j[K]||{};return{index:H.index,tweet_id:V.tweet_id||"",url:V.url||"",type:H.type,status:H.status,size:H.size}})}function Kj(j){if(typeof j==="string")return{queryId:j,features:O,fieldToggles:f};return{queryId:j?.queryId||I,features:j?.features||O,fieldToggles:j?.fieldToggles||f}}function Vj(j){if(typeof j==="string")return{queryId:j,features:S,fieldToggles:N};return{queryId:j?.queryId||k,features:j?.features||S,fieldToggles:j?.fieldToggles||N}}function c(j,F,G){const H=G.fieldToggles||{},K=[`variables=${encodeURIComponent(JSON.stringify(F))}`,`features=${encodeURIComponent(JSON.stringify(G.features||{}))}`];if(Object.keys(H).length>0)K.push(`fieldToggles=${encodeURIComponent(JSON.stringify(H))}`);return`${j}?${K.join("&")}`}function v(j,F,G,H){const K=Kj(j),V={userId:F,count:G,includePromotedContent:!1,withClientEventToken:!1,withBirdwatchNotes:!1,withVoice:!0};if(H)V.cursor=H;return c(`/i/api/graphql/${K.queryId}/UserMedia`,V,K)}function d(j,F){const G=Vj(j),H={screen_name:F,withSafetyModeUserFields:!0};return c(`/i/api/graphql/${G.queryId}/UserByScreenName`,H,G)}function g(j){if(!j)return"unknown";if(/video\.twimg\.com|\.mp4(\?|$)|\.m3u8(\?|$)/.test(j))return"video";return"image"}function p(j,F){if(!j||typeof j!=="object"||Array.isArray(j))throw new X(`Twitter ${F} returned malformed payload`);return j}function Wj(j,F,G){if(F===401||F===403)throw new h("x.com",`Twitter ${j} requires an authenticated x.com session`);if(F===404)throw new T(`twitter download ${j}`,G||"Twitter returned not found");const H=F?`HTTP ${F}`:"fetch failed";throw new X(`Twitter ${j} fetch failed: ${H}${G?` - ${G}`:""}`)}function m(j,F){const G=p(y(j),F);if(G.ok===!0)return G.payload;if(G.ok===!1)Wj(F,Number(G.status)||0,typeof G.error==="string"?G.error:"");throw new X(`Twitter ${F} returned malformed fetch result`)}function Xj(j){const F=p(j,"UserMedia");if(Array.isArray(F.errors)&&F.errors.length>0)throw new X(`Twitter UserMedia returned GraphQL errors: ${JSON.stringify(F.errors).slice(0,200)}`);const G=F.data?.user?.result;if(!G||typeof G!=="object")throw new X("Twitter UserMedia returned malformed user result");const H=G.timeline_v2?.timeline?.instructions||G.timeline?.timeline?.instructions;if(!Array.isArray(H))throw new X("Twitter UserMedia returned malformed timeline instructions");return F}function n(j,F){const G=[];let H=null;const K=Xj(j).data.user.result,Z=[K.timeline_v2?.timeline?.instructions,K.timeline?.timeline?.instructions].filter(Array.isArray).flat(),Q=(J)=>{if(!J||typeof J!=="object")return;if(J.type==="TimelinePinEntry")return;if(J.tweet_results?.result){const W=J.tweet_results.result,b=W.__typename==="TweetWithVisibilityResults"&&W.tweet?W.tweet:W.tweet||W,$=typeof b.rest_id==="string"||typeof b.rest_id==="number"?String(b.rest_id):"";if(!$)throw new X("Twitter UserMedia returned a tweet without rest_id");if(!F.has($)){F.add($);const{media_urls:B}=jj(b.legacy||{});for(const P of B)G.push({tweet_id:$,url:P,type:g(P)})}}if((J.entryType==="TimelineTimelineCursor"||J.__typename==="TimelineTimelineCursor")&&(J.cursorType==="Bottom"||J.cursorType==="ShowMore")&&J.value)H=J.value;if(Array.isArray(J)){for(const W of J)Q(W);return}for(const W of Object.values(J))if(W&&typeof W==="object")Q(W)};Q(Z);return{items:G,nextCursor:H}}o({site:"twitter",name:"download",access:"read",description:"Download Twitter/X media (images and videos). Provide either <username> to fetch every media item from their profile via the GraphQL UserMedia endpoint with cursor pagination, or --tweet-url to download a single tweet.",domain:"x.com",strategy:r.COOKIE,browser:!0,args:[{name:"username",positional:!0,help:"Twitter username (with or without @) to scan their profile media. Either <username> or --tweet-url is required."},{name:"tweet-url",help:"Single tweet URL to download. Use this OR <username>, not both required at once."},{name:"limit",type:"int",default:10,help:"Maximum number of media items to download when scanning a profile (default 10). Ignored when --tweet-url is used."},{name:"output",default:"./twitter-downloads",help:"Output directory (default ./twitter-downloads). A per-source subdir is created inside."}],columns:["index","tweet_id","url","type","status","size"],func:async(j,F)=>{try{const G=String(F.username??"").trim(),H=String(F["tweet-url"]??"").trim(),K=F.output;if(!G&&!H)throw new D("twitter download requires either <username> or --tweet-url");if(G&&H)throw new D("Use either <username> or --tweet-url, not both");if(H)return $j(j,H,K);const V=U(F.limit),Z=e(G);if(!Z)throw new D("twitter download username must be a valid Twitter/X handle","Example: opencli twitter download @jack --limit 20");return Zj(j,Z,V,K)}catch(G){if(G instanceof t)throw G;throw new X(`twitter download failed: ${G?.message??String(G)}`)}}});async function Zj(j,F,G,H){await j.goto(`https://x.com/${F}`);await j.wait({selector:'[data-testid="primaryColumn"]'});const K=await j.getCookies({url:"https://x.com"}),V=K.find((Y)=>Y.name==="ct0")?.value||null;if(!V)throw new h("x.com","Not logged into x.com (no ct0 cookie)");const Z=await R(j,"UserMedia",Hj),Q=await R(j,"UserByScreenName",Jj),J=JSON.stringify({Authorization:`Bearer ${decodeURIComponent(Gj)}`,"X-Csrf-Token":V,"X-Twitter-Auth-Type":"OAuth2Session","X-Twitter-Active-User":"yes"}),W=d(Q,F),b=m(await j.evaluate(`async () => {
+      try {
+        const resp = await fetch("${W}", { headers: ${J}, credentials: 'include' });
+        if (!resp.ok) return { ok: false, status: resp.status };
+        const payload = await resp.json();
+        return { ok: true, payload };
+      } catch (err) {
+        return { ok: false, error: err?.message ?? String(err) };
+      }
+    }`)),$=_(b);if(Array.isArray($?.errors)&&$.errors.length>0)throw new X(`Twitter UserByScreenName returned GraphQL errors: ${JSON.stringify($.errors).slice(0,200)}`);const B=$?.data?.user?.result?.rest_id;if(!B)throw new T(`twitter download @${F}`,`Could not resolve @${F}`);const P=new Set,q=[];let L=null,z=!1;for(let Y=0;Y<E&&q.length<G;Y++){const M=x(G,q.length);if(M===0)break;const l=v(Z,B,M,L),u=_(m(await j.evaluate(`async () => {
+        try {
+          const r = await fetch("${l}", { headers: ${J}, credentials: 'include' });
+          if (!r.ok) return { ok: false, status: r.status };
+          return { ok: true, payload: await r.json() };
+        } catch (err) {
+          return { ok: false, error: err?.message ?? String(err) };
+        }
+        }`))),{items:s,nextCursor:A}=n(u,P);q.push(...s);z=Boolean(A);if(!A)break;if(A===L)throw new X("Twitter UserMedia pagination returned the same cursor twice");L=A}if(q.length===0)throw new T(`@${F} has no media`,"Account may be private, suspended, or have no media posts");if(q.length<G&&z)throw new X(`Twitter UserMedia pagination reached the ${E}-page safety cap before collecting ${G} media items`);const i=q.slice(0,G);return w(i,{output:H,subdir:F,cookies:C(K),browserCookies:K,filenamePrefix:F,ytdlpExtraArgs:["--merge-output-format","mp4"]})}async function $j(j,F,G){const H=Fj(F);await j.goto(H.url);await j.wait(3);const K=y(await j.evaluate(`
+      (() => {
+        const out = [];
+        document.querySelectorAll('img[src*="pbs.twimg.com/media"]').forEach(img => {
+          let src = img.src || '';
+          src = src.replace(/&name=\\w+$/, '&name=large');
+          if (!src.includes('&name=')) src = src + '&name=large';
+          out.push({ type: 'image', url: src });
+        });
+        document.querySelectorAll('video').forEach(video => {
+          const src = video.src || '';
+          if (src) out.push({ type: 'video', url: src });
+        });
+        document.querySelectorAll('[data-testid="videoPlayer"]').forEach(player => {
+          const tweetLink = player.closest('article')?.querySelector('a[href*="/status/"]');
+          const href = tweetLink?.getAttribute('href') || '';
+          if (href) out.push({ type: 'video-tweet', url: 'https://x.com' + href });
+        });
+        return out;
+      })()
+    `));if(!Array.isArray(K))throw new X("Twitter tweet media extraction returned malformed payload");if(K.length===0)throw new T(`twitter download ${H.id}`,"No media found in the tweet");const V=await j.getCookies({domain:"x.com"}),Z=new Set,Q=K.filter((J)=>{if(Z.has(J.url))return!1;Z.add(J.url);return!0}).map((J)=>{return{...J,tweet_id:H.id}});return w(Q,{output:G,subdir:"tweets",cookies:C(V),browserCookies:V,filenamePrefix:"tweet",ytdlpExtraArgs:["--merge-output-format","mp4"]})}export const __test__={buildUserMediaUrl:v,buildUserByScreenNameUrl:d,parseUserMedia:n,classifyMediaUrl:g,requireLimit:U,nextUserMediaFetchCount:x};

package/clis/twitter/follow-batch.js

@@ -0,0 +1,43 @@
+import{ArgumentError as a,AuthRequiredError as d,CommandExecutionError as y}from"@jackwener/opencli/errors";import{cli as h,Strategy as p}from"@jackwener/opencli/registry";import{unwrapBrowserResult as u}from"./shared.js";const g=/^[A-Za-z0-9_]{1,15}$/,c=3000,f=60000;export function parseBatchUsernames(t){const e=String(t||"").trim();if(!e)throw new a("At least one Twitter/X username is required");const o=[],r=new Set;for(const i of e.split(",")){const s=i.trim().replace(/^@+/,"");if(!s)continue;if(!g.test(s))throw new a(`Invalid Twitter/X username: ${JSON.stringify(i.trim())}`);const n=s.toLowerCase();if(r.has(n))continue;r.add(n);o.push(s)}if(!o.length)throw new a("At least one Twitter/X username is required");return o}async function w(t,e){return u(await t.evaluate(`(async () => {
+        try {
+            let attempts = 0;
+            while (attempts < 20) {
+                const unfollowBtn = document.querySelector('[data-testid$="-unfollow"]');
+                if (unfollowBtn) {
+                    return { ok: true, status: 'noop', message: 'Already following @${e}.' };
+                }
+
+                const followBtn = document.querySelector('[data-testid$="-follow"]');
+                if (followBtn) {
+                    return { ok: false, followButtonVisible: true };
+                }
+
+                await new Promise(r => setTimeout(r, 500));
+                attempts++;
+            }
+
+            return { ok: false, followButtonVisible: false };
+        } catch (e) {
+            return { ok: false, message: e.toString() };
+        }
+    })()`))}async function k(t,e){return u(await t.evaluate(`(async () => {
+        try {
+            const followBtn = document.querySelector('[data-testid$="-follow"]');
+            if (!followBtn) {
+                return { ok: false, retryAfterRefresh: true, message: 'Could not find Follow button after loading profile.' };
+            }
+
+            followBtn.click();
+            for (let attempts = 0; attempts < 20; attempts++) {
+                await new Promise(r => setTimeout(r, 500));
+                const verify = document.querySelector('[data-testid$="-unfollow"]');
+                if (verify) {
+                    return { ok: true, status: 'success', message: 'Successfully followed @${e}.' };
+                }
+            }
+
+            return { ok: false, retryAfterRefresh: true, message: 'Follow action initiated but UI did not update.' };
+        } catch (e) {
+            return { ok: false, message: e.toString() };
+        }
+    })()`))}export async function followOne(t,e){await t.goto(`https://x.com/${e}`);await t.wait({selector:'[data-testid="primaryColumn"]'});let o=await w(t,e);if(!o.ok&&o.followButtonVisible)o=await k(t,e);if(!o.ok&&o.retryAfterRefresh){await t.goto(`https://x.com/${e}`);await t.wait({selector:'[data-testid="primaryColumn"]'});const r=await w(t,e);if(r.ok)o={...r,status:"success",message:`Successfully followed @${e}.`}}if(!o.ok&&!o.message)o={...o,message:"Could not find Follow button. Are you logged in?"};if(o.ok)await t.wait(1);return{username:e,status:o.ok?o.status:"failed",message:o.message}}export function parseDelayMs(t){if(t===void 0||t===null||t==="")return c;const e=Number(t);if(!Number.isInteger(e)||e<0||e>f)throw new a(`delay-ms must be an integer between 0 and ${f}`);return e}h({site:"twitter",name:"follow-batch",access:"write",description:"Follow multiple Twitter/X users from a comma-separated username list",domain:"x.com",strategy:p.UI,browser:!0,args:[{name:"usernames",type:"string",positional:!0,required:!0,help:"Comma-separated Twitter/X screen names, with or without @"},{name:"delay-ms",type:"int",default:c,help:"Delay between follow attempts in milliseconds"}],columns:["username","status","message"],func:async(t,e)=>{if(!t)throw new y("Browser session required for twitter follow-batch");const o=parseBatchUsernames(e.usernames),r=parseDelayMs(e["delay-ms"]);if(!(await t.getCookies({url:"https://x.com"})).find((l)=>l.name==="ct0")?.value)throw new d("x.com","Not logged into x.com (no ct0 cookie)");const n=[];for(const[l,m]of o.entries()){if(l>0&&r>0)await t.wait(r/1000);n.push(await followOne(t,m))}return n}});

package/clis/twitter/follow.js

@@ -0,0 +1,39 @@
+import{CommandExecutionError as l}from"@jackwener/opencli/errors";import{cli as s,Strategy as a}from"@jackwener/opencli/registry";s({site:"twitter",name:"follow",access:"write",description:"Follow a Twitter user",domain:"x.com",strategy:a.UI,browser:!0,args:[{name:"username",type:"string",positional:!0,required:!0,help:"Twitter screen name (without @)"}],columns:["status","message"],func:async(e,r)=>{if(!e)throw new l("Browser session required for twitter follow");const t=r.username.replace(/^@/,"");await e.goto(`https://x.com/${t}`);await e.wait({selector:'[data-testid="primaryColumn"]'});const o=await e.evaluate(`(async () => {
+        try {
+            let attempts = 0;
+            let followBtn = null;
+            let unfollowTestId = null;
+
+            while (attempts < 20) {
+                // Check if already following (button shows screen_name-unfollow)
+                unfollowTestId = document.querySelector('[data-testid$="-unfollow"]');
+                if (unfollowTestId) {
+                    return { ok: true, message: 'Already following @${t}.' };
+                }
+
+                // Look for the Follow button
+                followBtn = document.querySelector('[data-testid$="-follow"]');
+                if (followBtn) break;
+
+                await new Promise(r => setTimeout(r, 500));
+                attempts++;
+            }
+
+            if (!followBtn) {
+                return { ok: false, message: 'Could not find Follow button. Are you logged in?' };
+            }
+
+            followBtn.click();
+            await new Promise(r => setTimeout(r, 1500));
+
+            // Verify
+            const verify = document.querySelector('[data-testid$="-unfollow"]');
+            if (verify) {
+                return { ok: true, message: 'Successfully followed @${t}.' };
+            } else {
+                return { ok: false, message: 'Follow action initiated but UI did not update.' };
+            }
+        } catch (e) {
+            return { ok: false, message: e.toString() };
+        }
+    })()`);if(o.ok)await e.wait(2);return[{status:o.ok?"success":"failed",message:o.message}]}});

package/clis/twitter/followers.js

@@ -0,0 +1,59 @@
+import{ArgumentError as V,AuthRequiredError as $,selectorError as T,EmptyResultError as _,CommandExecutionError as q}from"@jackwener/opencli/errors";import{cli as v,Strategy as j}from"@jackwener/opencli/registry";import{normalizeTwitterScreenName as D,unwrapBrowserResult as M}from"./shared.js";async function b(G){const L=`() => {
+        const cells = document.querySelectorAll('[data-testid="UserCell"]');
+        const out = [];
+        for (const cell of cells) {
+            // Collect i18n-variable UI strings to strip from the cell text.
+            const stripTexts = new Set();
+            const buttons = cell.querySelectorAll(
+                '[data-testid$="-follow"],[data-testid$="-unfollow"],[data-testid="userFollowIndicator"]'
+            );
+            for (const el of buttons) {
+                const t = (el.innerText || '').trim();
+                if (t) stripTexts.add(t);
+            }
+            const lines = (cell.innerText || '')
+                .split('\\n')
+                .map(s => s.trim())
+                .filter(Boolean)
+                .filter(l => !stripTexts.has(l));
+            // Pull the @handle line; fall back to UserAvatar-Container-<handle>.
+            let screen_name = '';
+            const remaining = [];
+            for (const l of lines) {
+                if (!screen_name && l.startsWith('@')) {
+                    screen_name = l.slice(1).split(/\\s/)[0];
+                } else {
+                    remaining.push(l);
+                }
+            }
+            if (!screen_name) {
+                const av = cell.querySelector('[data-testid^="UserAvatar-Container-"]');
+                const tid = av ? av.getAttribute('data-testid') || '' : '';
+                if (tid.startsWith('UserAvatar-Container-')) {
+                    screen_name = tid.slice('UserAvatar-Container-'.length);
+                }
+            }
+            // First non-handle line is display name (may equal handle when the user hasn't set one).
+            const name = remaining[0] || screen_name;
+            // Lines past the display name form the bio.
+            const bio = remaining.slice(1).join(' ').replace(/\\s+/g, ' ').trim();
+            if (screen_name) {
+                out.push({ screen_name, name, bio });
+            }
+        }
+        return out;
+    }`;return G.evaluate(L)}function W(G){return D(G)}v({site:"twitter",name:"followers",access:"read",description:"Get accounts following a Twitter/X user (defaults to the logged-in user when no user is given)",domain:"x.com",strategy:j.UI,browser:!0,args:[{name:"user",positional:!0,type:"string",required:!1,help:"Twitter/X handle (with or without @). Omit to fetch followers of the currently logged-in account."},{name:"limit",type:"int",default:50,help:"Maximum number of follower rows to return (default 50). Must be a positive integer."}],columns:["screen_name","name","bio"],func:async(G,L)=>{const J=L.limit;if(!Number.isInteger(J)||J<=0)throw new V("limit must be a positive integer");const X=String(L.user??"").trim();let H=W(X);if(X&&!H)throw new V("twitter followers user must be a valid Twitter/X handle","Example: opencli twitter followers @elonmusk --limit 100");if(!H){await G.goto("https://x.com/home");await G.wait({selector:'[data-testid="primaryColumn"]'});const I=M(await G.evaluate(`() => {
+                const link = document.querySelector('a[data-testid="AppTabBar_Profile_Link"]');
+                return link ? link.getAttribute('href') : null;
+            }`));if(!I||typeof I!=="string")throw new $("x.com","Could not find logged-in user profile link. Are you logged in?");H=W(I);if(!H)throw new $("x.com","Could not find logged-in user profile link. Are you logged in?")}if(!H)throw new V("twitter followers user cannot be empty","Example: opencli twitter followers @elonmusk --limit 100");await G.goto(`https://x.com/${H}`);await G.wait(3);const B=JSON.stringify(H);if(!await G.evaluate(`() => {
+            const target = ${B};
+            const selectors = [
+                'a[href="/' + target + '/followers"]',
+                'a[href="/' + target + '/verified_followers"]',
+            ];
+            for (const sel of selectors) {
+                const link = document.querySelector(sel);
+                if (link) { link.click(); return true; }
+            }
+            return false;
+        }`))throw T("Twitter followers link","Twitter may have changed the layout.");await G.wait({selector:'[data-testid="UserCell"]',timeout:1e4});const K=[],Y=new Set;let Q=0;while(K.length<J&&Q<3){const I=await b(G);if(!Array.isArray(I))throw new q("Twitter followers extraction returned malformed rows");const Z=I.filter((P)=>!Y.has(P.screen_name));for(const P of Z){Y.add(P.screen_name);K.push(P)}if(Z.length===0)Q++;else Q=0;if(K.length>=J)break;await G.autoScroll({times:1,delayMs:500});await G.wait(2)}if(K.length===0)throw new _("twitter followers",`No followers found for @${H}`);return K.slice(0,J)}});export const __test__={extractFollowersFromDOM:b,normalizeScreenName:W};

package/clis/twitter/following.js

@@ -0,0 +1,4 @@
+import{cli as U,Strategy as w}from"@jackwener/opencli/registry";import{ArgumentError as v,AuthRequiredError as j,CommandExecutionError as b,EmptyResultError as C}from"@jackwener/opencli/errors";import{looksLikePrivateTwitterTimeline as E,normalizeTwitterScreenName as m,resolveTwitterQueryId as x,sanitizeQueryId as p,unwrapBrowserResult as B,describeTwitterApiError as d}from"./shared.js";import{TWITTER_BEARER_TOKEN as g}from"./utils.js";const c="F42cDX8PDFxkbjjq6JrM2w",i="IGgvgiOx4QZndDHuD3x9TQ",l=100,n={rweb_video_screen_enabled:!1,profile_label_improvements_pcf_label_in_post_enabled:!0,responsive_web_profile_redirect_enabled:!1,rweb_tipjar_consumption_enabled:!1,verified_phone_label_enabled:!1,creator_subscriptions_tweet_preview_api_enabled:!0,responsive_web_graphql_timeline_navigation_enabled:!0,responsive_web_graphql_skip_user_profile_image_extensions_enabled:!1,premium_content_api_read_enabled:!1,communities_web_enable_tweet_community_results_fetch:!0,c9s_tweet_anatomy_moderator_badge_enabled:!0,responsive_web_grok_analyze_button_fetch_trends_enabled:!1,responsive_web_grok_analyze_post_followups_enabled:!0,responsive_web_jetfuel_frame:!0,responsive_web_grok_share_attachment_enabled:!0,responsive_web_grok_annotations_enabled:!0,articles_preview_enabled:!0,responsive_web_edit_tweet_api_enabled:!0,graphql_is_translatable_rweb_tweet_is_translatable_enabled:!0,view_counts_everywhere_api_enabled:!0,longform_notetweets_consumption_enabled:!0,responsive_web_twitter_article_tweet_consumption_enabled:!0,tweet_awards_web_tipping_enabled:!1,content_disclosure_indicator_enabled:!0,content_disclosure_ai_generated_indicator_enabled:!0,responsive_web_grok_show_grok_translated_post:!1,responsive_web_grok_analysis_button_from_backend:!0,post_ctas_fetch_enabled:!1,freedom_of_speech_not_reach_fetch_enabled:!0,standardized_nudges_misinfo:!0,tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled:!0,longform_notetweets_rich_text_read_enabled:!0,longform_notetweets_inline_media_enabled:!1,responsive_web_grok_image_annotation_enabled:!0,responsive_web_grok_imagine_annotation_enabled:!0,responsive_web_grok_community_note_auto_translation_is_enabled:!1,responsive_web_enhance_cards_enabled:!1};function A(H,Z,J,$){const V={userId:Z,count:J,includePromotedContent:!1,withClientEventToken:!1,withBirdwatchNotes:!1,withVoice:!0,withV2Timeline:!0};if($)V.cursor=$;return`/i/api/graphql/${H}/Following?variables=${encodeURIComponent(JSON.stringify(V))}&features=${encodeURIComponent(JSON.stringify(n))}`}function h(H,Z){const J=JSON.stringify({screen_name:Z,withSafetyModeUserFields:!0}),$=JSON.stringify({hidden_profile_subscriptions_enabled:!0,rweb_tipjar_consumption_enabled:!0,responsive_web_graphql_exclude_directive_enabled:!0,verified_phone_label_enabled:!1,subscriptions_verification_info_is_identity_verified_enabled:!0,subscriptions_verification_info_verified_since_enabled:!0,highlights_tweets_tab_ui_enabled:!0,responsive_web_twitter_article_notes_tab_enabled:!0,subscriptions_feature_can_gift_premium:!0,creator_subscriptions_tweet_preview_api_enabled:!0,responsive_web_graphql_skip_user_profile_image_extensions_enabled:!1,responsive_web_graphql_timeline_navigation_enabled:!0});return`/i/api/graphql/${H}/UserByScreenName?variables=${encodeURIComponent(J)}&features=${encodeURIComponent($)}`}function N(H){if(!H||H.__typename!=="User")return null;const Z=H.core||{},J=H.legacy||{},$=Z.screen_name||J.screen_name||"";if(!$)throw new b("Malformed Twitter following user: missing screen_name");return{screen_name:$,name:Z.name||J.name||"",bio:J.description||H.profile_bio?.description||"",followers:J.followers_count||J.normal_followers_count||0}}function k(H){const Z=[];let J=null;const $=H?.data?.user?.result?.timeline_v2?.timeline?.instructions||H?.data?.user?.result?.timeline?.timeline?.instructions||[];for(const V of $)for(const W of V.entries||[]){const K=W.content;if(K?.entryType==="TimelineTimelineCursor"||K?.__typename==="TimelineTimelineCursor"){if(K.cursorType==="Bottom"||K.cursorType==="ShowMore")J=K.value;continue}if(W.entryId?.startsWith("cursor-bottom-")||W.entryId?.startsWith("cursor-showMore-")){J=K?.value||K?.itemContent?.value||J;continue}if(W.entryId?.startsWith("user-")){const O=N(K?.itemContent?.user_results?.result);if(O)Z.push(O)}}return{users:Z,nextCursor:J}}function q(H){return m(H)}U({site:"twitter",name:"following",access:"read",description:"Get accounts a Twitter/X user is following (defaults to the logged-in user when no user is given)",domain:"x.com",strategy:w.COOKIE,browser:!0,args:[{name:"user",positional:!0,type:"string",required:!1,help:"Twitter/X handle (with or without @). Omit to fetch the accounts the currently logged-in user follows."},{name:"limit",type:"int",default:50,help:"Maximum number of following rows to return (default 50). Must be a positive integer."}],columns:["screen_name","name","bio","followers"],func:async(H,Z)=>{const J=Z.limit===void 0||Z.limit===null?50:Number(Z.limit);if(!Number.isInteger(J)||J<=0)throw new v("twitter following --limit must be a positive integer","Example: opencli twitter following @elonmusk --limit 200");const $=String(Z.user??"").trim();let V=q($);if($&&!V)throw new v("twitter following user must be a valid Twitter/X handle","Example: opencli twitter following @elonmusk --limit 200");const K=(await H.getCookies({url:"https://x.com"})).find((X)=>X.name==="ct0")?.value||null;if(!K)throw new j("x.com","Not logged into x.com (no ct0 cookie)");if(!V){await H.goto("https://x.com/home");await H.wait({selector:'[data-testid="primaryColumn"]'});const X=B(await H.evaluate(`() => {
+        const link = document.querySelector('a[data-testid="AppTabBar_Profile_Link"]');
+        return link ? link.getAttribute('href') : null;
+      }`));if(!X||typeof X!=="string")throw new j("x.com","Could not detect logged-in user. Are you logged in?");V=q(X);if(!V)throw new j("x.com","Could not detect logged-in user. Are you logged in?")}if(!V)throw new v("twitter following user cannot be empty","Example: opencli twitter following @elonmusk --limit 200");const O=await x(H,"Following",c),I=await x(H,"UserByScreenName",i),L={Authorization:`Bearer ${decodeURIComponent(g)}`,"X-Csrf-Token":K,"X-Twitter-Auth-Type":"OAuth2Session","X-Twitter-Active-User":"yes"},M=B(await H.evaluate(async(X,f)=>{const P=await fetch(X,{headers:f,credentials:"include"});if(!P.ok)return{error:P.status};return{userId:(await P.json()).data?.user?.result?.rest_id||null}},h(I,V),L));if(M?.error===401||M?.error===403)throw new j("x.com",`Twitter user lookup failed (HTTP ${M.error})`);if(M?.error)throw new b(`HTTP ${M.error}: Failed to resolve Twitter user @${V}`);const _=M?.userId||null;if(!_)throw new b(`Could not find user @${V}`);const G=[],S=new Set;let z=null,T=null;for(let X=0;X<l&&G.length<J;X++){const f=Math.min(50,J-G.length+10),P=A(O,_,f,z),D=B(await H.evaluate(async(Y,y)=>{const Q=await fetch(Y,{headers:y,credentials:"include"});return Q.ok?await Q.json():{error:Q.status}},P,L));if(D?.error){if(D.error===401||D.error===403)throw new j("x.com",`Twitter following request failed (HTTP ${D.error})`);throw new b(d("Following",D.error))}T=D;const{users:R,nextCursor:F}=k(D);for(const Y of R)if(!S.has(Y.screen_name)){S.add(Y.screen_name);G.push(Y)}if(!F||F===z)break;z=F}if(G.length===0){if(E(T))throw new C("twitter following",`No following data returned for @${V} (the target account may have set their following list to private)`);throw new C("twitter following",`No following accounts found for @${V}`)}return G.slice(0,J)}});export const __test__={sanitizeQueryId:p,buildFollowingUrl:A,buildUserByScreenNameUrl:h,extractUser:N,normalizeScreenName:q,parseFollowing:k};

package/clis/twitter/hide-reply.js

@@ -0,0 +1,57 @@
+import{CommandExecutionError as o}from"@jackwener/opencli/errors";import{cli as s,Strategy as l}from"@jackwener/opencli/registry";import{parseTweetUrl as n,buildTwitterArticleScopeSource as a}from"./shared.js";s({site:"twitter",name:"hide-reply",access:"write",description:"Hide a reply on your tweet (useful for hiding bot/spam replies)",domain:"x.com",strategy:l.UI,browser:!0,args:[{name:"url",type:"string",required:!0,positional:!0,help:"The URL of the reply tweet to hide"}],columns:["status","message"],func:async(e,i)=>{if(!e)throw new o("Browser session required for twitter hide-reply");const r=n(i.url);await e.goto(r.url);await e.wait({selector:'[data-testid="primaryColumn"]'});const t=await e.evaluate(`(async () => {
+        try {
+            ${a(r.id)}
+            const visible = (el) => !!el && (el.offsetParent !== null || el.getClientRects().length > 0);
+            // Locate the article matching the requested status id, then find
+            // its More menu. Without article scoping we'd grab whatever the
+            // first "More" button on the page is — usually the parent tweet
+            // (silent: hide the wrong reply, or fail silently if the parent
+            // is not a reply you authored).
+            let attempts = 0;
+            let targetArticle = null;
+            let moreMenu = null;
+
+            while (attempts < 20) {
+                targetArticle = findTargetArticle();
+                if (targetArticle) {
+                    const buttons = Array.from(targetArticle.querySelectorAll('button,[role="button"]'));
+                    moreMenu = buttons.find((el) => visible(el) && (el.getAttribute('aria-label') || '').trim() === 'More');
+                    if (moreMenu) break;
+                }
+                await new Promise(r => setTimeout(r, 500));
+                attempts++;
+            }
+
+            if (!targetArticle) {
+                return { ok: false, message: 'Could not find the requested reply article on this page.' };
+            }
+            if (!moreMenu) {
+                return { ok: false, message: 'Could not find the "More" menu on the requested reply. Are you logged in?' };
+            }
+
+            moreMenu.click();
+            await new Promise(r => setTimeout(r, 1000));
+
+            // Look for the "Hide reply" menu item. Menu items render at the
+            // document root, not inside the article — scope is the open menu.
+            const items = document.querySelectorAll('[role="menuitem"]');
+            let hideItem = null;
+            for (const item of items) {
+                if (item.textContent && item.textContent.includes('Hide reply')) {
+                    hideItem = item;
+                    break;
+                }
+            }
+
+            if (!hideItem) {
+                return { ok: false, message: 'Could not find "Hide reply" option. This may not be a reply on your tweet.' };
+            }
+
+            hideItem.click();
+            await new Promise(r => setTimeout(r, 1500));
+
+            return { ok: true, message: 'Reply successfully hidden.' };
+        } catch (e) {
+            return { ok: false, message: e.toString() };
+        }
+    })()`);if(t.ok)await e.wait(2);return[{status:t.ok?"success":"failed",message:t.message}]}});

package/clis/twitter/like.js

@@ -0,0 +1,48 @@
+import{CommandExecutionError as F}from"@jackwener/opencli/errors";import{cli as G,Strategy as H}from"@jackwener/opencli/registry";import{parseTweetUrl as I,buildTwitterArticleScopeSource as J}from"./shared.js";G({site:"twitter",name:"like",access:"write",description:"Like a specific tweet",domain:"x.com",strategy:H.UI,browser:!0,args:[{name:"url",type:"string",required:!0,positional:!0,help:"The URL of the tweet to like"}],columns:["status","message"],func:async(v,D)=>{if(!v)throw new F("Browser session required for twitter like");const B=I(D.url);await v.goto(B.url);await v.wait({selector:'[data-testid="primaryColumn"]'});const z=await v.evaluate(`(async () => {
+        try {
+            ${J(B.id)}
+            // Poll for the tweet to render. We scope state probes to the
+            // article matching the requested status id — on conversation
+            // pages multiple articles render and a bare querySelector would
+            // grab the first one (silent: like the wrong tweet).
+            let attempts = 0;
+            let likeBtn = null;
+            let unlikeBtn = null;
+            let targetArticle = null;
+
+            while (attempts < 20) {
+                targetArticle = findTargetArticle();
+                likeBtn = targetArticle?.querySelector('[data-testid="like"]') || null;
+                unlikeBtn = targetArticle?.querySelector('[data-testid="unlike"]') || null;
+
+                if (likeBtn || unlikeBtn) break;
+
+                await new Promise(r => setTimeout(r, 500));
+                attempts++;
+            }
+
+            // Check if it's already liked
+            if (unlikeBtn) {
+                return { ok: true, message: 'Tweet is already liked.' };
+            }
+
+            if (!likeBtn) {
+                return { ok: false, message: 'Could not find the Like button on this tweet after waiting 10 seconds. Are you logged in?' };
+            }
+
+            // Click Like
+            likeBtn.click();
+            await new Promise(r => setTimeout(r, 1000));
+
+            // Verify success by checking if the 'unlike' button reappeared
+            const verifyArticle = findTargetArticle() || targetArticle;
+            const verifyBtn = verifyArticle?.querySelector('[data-testid="unlike"]');
+            if (verifyBtn) {
+                return { ok: true, message: 'Tweet successfully liked.' };
+            } else {
+                return { ok: false, message: 'Like action was initiated but UI did not update as expected.' };
+            }
+        } catch (e) {
+            return { ok: false, message: e.toString() };
+        }
+    })()`);if(z.ok)await v.wait(2);return[{status:z.ok?"success":"failed",message:z.message}]}});

package/clis/twitter/likes.js

@@ -0,0 +1,14 @@
+import{cli as k,Strategy as I}from"@jackwener/opencli/registry";import{ArgumentError as R,AuthRequiredError as j,CommandExecutionError as v,EmptyResultError as q}from"@jackwener/opencli/errors";import{looksLikePrivateTwitterTimeline as T,normalizeTwitterScreenName as Q,resolveTwitterQueryId as L,sanitizeQueryId as E,extractMedia as y,unwrapBrowserResult as b,describeTwitterApiError as g}from"./shared.js";import{TWITTER_BEARER_TOKEN as p,applyTopByEngagement as m}from"./utils.js";const d="CDWHmpZeSdIJ3HGeRbNm0w",w="IGgvgiOx4QZndDHuD3x9TQ",c=100,l={rweb_video_screen_enabled:!1,profile_label_improvements_pcf_label_in_post_enabled:!0,responsive_web_profile_redirect_enabled:!1,rweb_tipjar_consumption_enabled:!1,verified_phone_label_enabled:!1,creator_subscriptions_tweet_preview_api_enabled:!0,responsive_web_graphql_timeline_navigation_enabled:!0,responsive_web_graphql_skip_user_profile_image_extensions_enabled:!1,premium_content_api_read_enabled:!1,communities_web_enable_tweet_community_results_fetch:!0,c9s_tweet_anatomy_moderator_badge_enabled:!0,responsive_web_grok_analyze_button_fetch_trends_enabled:!1,responsive_web_grok_analyze_post_followups_enabled:!0,responsive_web_jetfuel_frame:!0,responsive_web_grok_share_attachment_enabled:!0,responsive_web_grok_annotations_enabled:!0,articles_preview_enabled:!0,responsive_web_edit_tweet_api_enabled:!0,graphql_is_translatable_rweb_tweet_is_translatable_enabled:!0,view_counts_everywhere_api_enabled:!0,longform_notetweets_consumption_enabled:!0,responsive_web_twitter_article_tweet_consumption_enabled:!0,tweet_awards_web_tipping_enabled:!1,content_disclosure_indicator_enabled:!0,content_disclosure_ai_generated_indicator_enabled:!0,responsive_web_grok_show_grok_translated_post:!1,responsive_web_grok_analysis_button_from_backend:!0,post_ctas_fetch_enabled:!1,freedom_of_speech_not_reach_fetch_enabled:!0,standardized_nudges_misinfo:!0,tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled:!0,longform_notetweets_rich_text_read_enabled:!0,longform_notetweets_inline_media_enabled:!1,responsive_web_grok_image_annotation_enabled:!0,responsive_web_grok_imagine_annotation_enabled:!0,responsive_web_grok_community_note_auto_translation_is_enabled:!1,responsive_web_enhance_cards_enabled:!1};function B(J,$,H,Z){const V={userId:$,count:H,includePromotedContent:!1,withClientEventToken:!1,withBirdwatchNotes:!1,withVoice:!0};if(Z)V.cursor=Z;return`/i/api/graphql/${J}/Likes?variables=${encodeURIComponent(JSON.stringify(V))}&features=${encodeURIComponent(JSON.stringify(l))}`}function h(J,$){const H=JSON.stringify({screen_name:$,withSafetyModeUserFields:!0}),Z=JSON.stringify({hidden_profile_subscriptions_enabled:!0,rweb_tipjar_consumption_enabled:!0,responsive_web_graphql_exclude_directive_enabled:!0,verified_phone_label_enabled:!1,subscriptions_verification_info_is_identity_verified_enabled:!0,subscriptions_verification_info_verified_since_enabled:!0,highlights_tweets_tab_ui_enabled:!0,responsive_web_twitter_article_notes_tab_enabled:!0,subscriptions_feature_can_gift_premium:!0,creator_subscriptions_tweet_preview_api_enabled:!0,responsive_web_graphql_skip_user_profile_image_extensions_enabled:!1,responsive_web_graphql_timeline_navigation_enabled:!0});return`/i/api/graphql/${J}/UserByScreenName?variables=${encodeURIComponent(H)}&features=${encodeURIComponent(Z)}`}function C(J,$){if(!J)return null;const H=J.tweet||J,Z=H.legacy||{};if(!H.rest_id||$.has(H.rest_id))return null;$.add(H.rest_id);const V=H.core?.user_results?.result,G=V?.legacy?.screen_name||V?.core?.screen_name||"unknown",W=V?.legacy?.name||V?.core?.name||"",F=H.note_tweet?.note_tweet_results?.result?.text;return{id:H.rest_id,author:G,name:W,text:F||Z.full_text||"",likes:Z.favorite_count||0,retweets:Z.retweet_count||0,created_at:Z.created_at||"",url:`https://x.com/${G}/status/${H.rest_id}`,...y(Z)}}function S(J,$){const H=[];let Z=null;const V=J?.data?.user?.result?.timeline_v2?.timeline?.instructions||J?.data?.user?.result?.timeline?.timeline?.instructions||[];for(const G of V)for(const W of G.entries||[]){const F=W.content;if(F?.entryType==="TimelineTimelineCursor"||F?.__typename==="TimelineTimelineCursor"){if(F.cursorType==="Bottom"||F.cursorType==="ShowMore")Z=F.value;continue}if(W.entryId?.startsWith("cursor-bottom-")||W.entryId?.startsWith("cursor-showMore-")){Z=F?.value||F?.itemContent?.value||Z;continue}const O=C(F?.itemContent?.tweet_results?.result,$);if(O){H.push(O);continue}for(const z of F?.items||[]){const K=C(z.item?.itemContent?.tweet_results?.result,$);if(K)H.push(K)}}return{tweets:H,nextCursor:Z}}k({site:"twitter",name:"likes",access:"read",description:"Fetch liked tweets of a Twitter user (defaults to the logged-in user when no username is given)",domain:"x.com",strategy:I.COOKIE,browser:!0,args:[{name:"username",type:"string",positional:!0,help:"Twitter screen name (with or without @). Defaults to the logged-in user when omitted."},{name:"limit",type:"int",default:20,help:"Maximum number of liked tweets to return (default 20)."},{name:"top-by-engagement",type:"int",default:0,help:"When set to N>0, re-rank the liked tweets by weighted engagement (likes×1 + retweets×3 + replies×2 + bookmarks×5 + log10(views+1)×0.5) and return the top N. Default 0 keeps the API's native (recency) ordering."}],columns:["id","author","name","text","likes","retweets","created_at","url","has_media","media_urls","media_posters"],func:async(J,$)=>{const H=$.limit||20,Z=String($.username??"").trim();let V=Q(Z);if(Z&&!V)throw new R("twitter likes username must be a valid Twitter/X handle","Example: opencli twitter likes @jack --limit 20");const W=(await J.getCookies({url:"https://x.com"})).find((X)=>X.name==="ct0")?.value||null;if(!W)throw new j("x.com","Not logged into x.com (no ct0 cookie)");if(!V){await J.goto("https://x.com/home");await J.wait({selector:'[data-testid="primaryColumn"]'});const X=b(await J.evaluate(`() => {
+        const link = document.querySelector('a[data-testid="AppTabBar_Profile_Link"]');
+        return link ? link.getAttribute('href') : null;
+      }`));if(!X||typeof X!=="string")throw new j("x.com","Could not detect logged-in user. Are you logged in?");V=Q(X);if(!V)throw new j("x.com","Could not detect logged-in user. Are you logged in?")}const F=await L(J,"Likes",d),O=await L(J,"UserByScreenName",w),z=JSON.stringify({Authorization:`Bearer ${decodeURIComponent(p)}`,"X-Csrf-Token":W,"X-Twitter-Auth-Type":"OAuth2Session","X-Twitter-Active-User":"yes"}),K=b(await J.evaluate(`async () => {
+      const screenName = ${JSON.stringify(V)};
+      const url = ${JSON.stringify(h(O,V))};
+      const resp = await fetch(url, { headers: ${z}, credentials: 'include' });
+      if (!resp.ok) return null;
+      const d = await resp.json();
+      return d.data?.user?.result?.rest_id || null;
+    }`));if(!K)throw new v(`Could not find user @${V}`);const D=[],_=new Set;let P=null,f=null;for(let X=0;X<c&&D.length<H;X++){const U=Math.min(100,H-D.length+10),x=B(F,K,U,P),M=b(await J.evaluate(`async () => {
+        const r = await fetch("${x}", { headers: ${z}, credentials: 'include' });
+        return r.ok ? await r.json() : { error: r.status };
+      }`));if(M?.error){if(D.length===0)throw new v(g("Likes",M.error));break}f=M;const{tweets:N,nextCursor:Y}=S(M,_);D.push(...N);if(!Y||Y===P)break;P=Y}if(D.length===0){if(T(f))throw new q("twitter likes",`No likes returned for @${V} (Likes are private by default on X; only the account owner can view their own likes)`);throw new q("twitter likes",`No likes found for @${V}`)}const A=D.slice(0,H);return m(A,$["top-by-engagement"])}});export const __test__={sanitizeQueryId:E,buildLikesUrl:B,buildUserByScreenNameUrl:h,parseLikes:S};