publishport-opencli 1.0.0

package/clis/twitter/scheduled-delete.js

@@ -0,0 +1,60 @@
+import{ArgumentError as J,CommandExecutionError as H}from"@jackwener/opencli/errors";import{cli as K,Strategy as L}from"@jackwener/opencli/registry";import{openScheduledQueue as N}from"./scheduled-utils.js";function I(q){const v=String(q??"").trim();if(!v)throw new J("Text fragment is required to delete a scheduled post");return v}export function buildScheduledDeleteScript(q){return`(async () => {
+        try {
+            const needle = ${JSON.stringify(q)}.toLowerCase();
+            const visible = (el) => !!el && (el.offsetParent !== null || el.getClientRects().length > 0);
+            const normalize = (s) => String(s || '').replace(/\\s+/g, ' ').trim();
+            const findItems = () => Array.from(document.querySelectorAll('[data-testid="unsentTweet"]'));
+            let items = findItems();
+            const target = items.find((item) => normalize(item.querySelector('[data-testid="tweetText"]')?.textContent || item.textContent).toLowerCase().includes(needle));
+            if (!target) {
+                return { ok: false, message: 'Could not find a scheduled post matching the text fragment.' };
+            }
+
+            const edit = Array.from(document.querySelectorAll('button,[role="button"]'))
+                .find((el) => visible(el) && normalize(el.textContent) === 'Edit');
+            if (edit) {
+                edit.click();
+                await new Promise(r => setTimeout(r, 800));
+            }
+
+            items = findItems();
+            const editableTarget = items.find((item) => normalize(item.querySelector('[data-testid="tweetText"]')?.textContent || item.textContent).toLowerCase().includes(needle));
+            if (!editableTarget) {
+                return { ok: false, message: 'Scheduled post disappeared before deletion.' };
+            }
+
+            const row = editableTarget.closest('button,[role="button"], [data-testid="cellInnerDiv"]') || editableTarget.parentElement;
+            const checkbox = row?.querySelector('[role="checkbox"], input[type="checkbox"]')
+                || editableTarget.parentElement?.querySelector('[role="checkbox"], input[type="checkbox"]');
+            if (checkbox) {
+                checkbox.click();
+            } else {
+                editableTarget.click();
+            }
+            await new Promise(r => setTimeout(r, 800));
+
+            const deleteButton = Array.from(document.querySelectorAll('button,[role="button"]'))
+                .find((el) => visible(el) && /^delete$/i.test(normalize(el.textContent)) && el.getAttribute('aria-disabled') !== 'true' && !el.disabled);
+            if (!deleteButton) {
+                return { ok: false, message: 'Could not find enabled Delete button after selecting scheduled post.' };
+            }
+            deleteButton.click();
+            await new Promise(r => setTimeout(r, 800));
+
+            const confirm = document.querySelector('[data-testid="confirmationSheetConfirm"]')
+                || Array.from(document.querySelectorAll('button,[role="button"]')).find((el) => visible(el) && /^delete$/i.test(normalize(el.textContent)));
+            if (!confirm) {
+                return { ok: false, message: 'Delete confirmation dialog did not appear.' };
+            }
+            confirm.click();
+            await new Promise(r => setTimeout(r, 1200));
+
+            const stillExists = findItems().some((item) => normalize(item.querySelector('[data-testid="tweetText"]')?.textContent || item.textContent).toLowerCase().includes(needle));
+            if (stillExists) {
+                return { ok: false, message: 'Scheduled post still appears after delete confirmation.' };
+            }
+            return { ok: true, message: 'Scheduled post deleted.' };
+        } catch (e) {
+            return { ok: false, message: String(e) };
+        }
+    })()`}K({site:"twitter",name:"scheduled-delete",access:"write",description:"Delete a scheduled X post by matching a text fragment",domain:"x.com",strategy:L.UI,browser:!0,args:[{name:"match",type:"string",required:!0,positional:!0,help:"Text fragment that uniquely identifies the scheduled post"}],columns:["status","message","match"],func:async(q,v)=>{if(!q)throw new H("Browser session required for twitter scheduled-delete");const B=I(v.match),F=await N(q);if(F?.empty)return[{status:"failed",message:"No scheduled posts found to delete.",match:B}];if(!F?.ok)throw new H(F?.message??"Could not open scheduled posts queue");const G=await q.evaluate(buildScheduledDeleteScript(B));return[{status:G?.ok?"success":"failed",message:G?.message??"Scheduled post delete failed.",match:B}]}});export const __test__={buildScheduledDeleteScript,normalizeMatch:I};

package/clis/twitter/scheduled-list.js

@@ -0,0 +1,15 @@
+import{CommandExecutionError as v}from"@jackwener/opencli/errors";import{cli as z,Strategy as A}from"@jackwener/opencli/registry";import{openScheduledQueue as B}from"./scheduled-utils.js";export function buildScheduledListScript(){return`(() => {
+        const items = Array.from(document.querySelectorAll('[data-testid="unsentTweet"]'));
+        return items.map((item, index) => {
+            const text = (item.querySelector('[data-testid="tweetText"]')?.textContent || '').replace(/\\s+/g, ' ').trim();
+            const fullText = (item.textContent || '').replace(/\\s+/g, ' ').trim();
+            let scheduledFor = fullText;
+            if (text && scheduledFor.endsWith(text)) scheduledFor = scheduledFor.slice(0, -text.length);
+            scheduledFor = scheduledFor.replace(/^\\s*Will send on\\s*/i, '').trim();
+            return {
+                index: index + 1,
+                scheduledFor,
+                text,
+            };
+        });
+    })()`}z({site:"twitter",name:"scheduled-list",access:"read",description:"List X posts currently scheduled in the web composer",domain:"x.com",strategy:A.UI,browser:!0,args:[],columns:["index","scheduledFor","text"],func:async(f)=>{if(!f)throw new v("Browser session required for twitter scheduled-list");const q=await B(f);if(q?.empty)return[];if(!q?.ok)throw new v(q?.message??"Could not open scheduled posts queue");return f.evaluate(buildScheduledListScript())}});export const __test__={buildScheduledListScript};

package/clis/twitter/scheduled-utils.js

@@ -0,0 +1,18 @@
+export const COMPOSE_URL="https://x.com/compose/post";export async function openScheduledQueue(b){await b.goto(COMPOSE_URL,{waitUntil:"load",settleMs:2500});try{await b.wait({selector:'[data-testid="unsentButton"]',timeout:15})}catch{}const f=await b.evaluate(`(async () => {
+        const visible = (el) => !!el && (el.offsetParent !== null || el.getClientRects().length > 0);
+        // 优先用 locale 无关的 testid 判存在，其次回退到文案（个别皮肤无 testid）。
+        const drafts = document.querySelector('[data-testid="unsentButton"]')
+            || Array.from(document.querySelectorAll('button,[role="button"]'))
+                .find((el) => visible(el) && /drafts/i.test(el.textContent || ''));
+        if (!drafts) return { ok: true, empty: true };
+        drafts.click();
+        return { ok: true };
+    })()`);if(f?.empty)return{ok:!0,empty:!0};if(!f?.ok)return f;await b.wait(1);const h=await b.evaluate(`(async () => {
+        const visible = (el) => !!el && (el.offsetParent !== null || el.getClientRects().length > 0);
+        const scheduledTab = Array.from(document.querySelectorAll('a, [role="tab"]'))
+            .find((el) => visible(el) && /^scheduled$/i.test((el.textContent || '').trim()));
+        // 有草稿但没有 Scheduled 标签 = 有草稿、无排程，同样是合法空态。
+        if (!scheduledTab) return { ok: true, empty: true };
+        scheduledTab.click();
+        return { ok: true };
+    })()`);if(h?.empty)return{ok:!0,empty:!0};if(!h?.ok)return h;await b.wait(2);return{ok:!0}}

package/clis/twitter/search.js

@@ -0,0 +1,12 @@
+import{ArgumentError as f,AuthRequiredError as C,CommandExecutionError as d}from"@jackwener/opencli/errors";import{cli as O,Strategy as _}from"@jackwener/opencli/registry";import{extractMedia as R,extractCard as k,extractQuotedTweet as c,normalizeTwitterGraphqlPayload as T,resolveTwitterOperationMetadata as p,describeTwitterApiError as E}from"./shared.js";import{TWITTER_BEARER_TOKEN as g,applyTopByEngagement as n}from"./utils.js";const q=Object.freeze(["media","images","videos","links","replies"]),x=Object.freeze(["replies","retweets","media","links"]),D=Object.freeze(["top","live","photos","videos"]),Q=Object.freeze({top:"top",live:"live",photos:"image",videos:"video"}),i=Object.freeze({top:"Top",live:"Latest",photos:"Photos",videos:"Videos"}),w=100,j={queryId:"Yw6L66Pw54NHKuq4Dp7b4Q",features:{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,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},fieldToggles:{withPayments:!0,withAuxiliaryUserLabels:!0,withArticleRichContentState:!0,withArticlePlainText:!0,withArticleSummaryText:!0,withArticleVoiceOver:!0,withGrokAnalyze:!0,withDisallowedReplyControls:!0}},L=/^[A-Za-z0-9_]{1,15}$/,M=Object.freeze({replies:"-filter:replies",retweets:"-filter:nativeretweets",media:"-filter:media",links:"-filter:links"});function H(J,V){const Y=[String(J??"").trim()];if(V.from){const $=String(V.from).trim().replace(/^@+/,"");if($&&!L.test($))throw new f(`Invalid --from username: ${JSON.stringify(V.from)}`,"Use a Twitter/X handle with 1-15 letters, numbers, or underscores; omit @ or pass @handle.");if($)Y.push(`from:${$}`)}if(V.has)Y.push(`filter:${V.has}`);if(V.exclude){const $=M[V.exclude];if($)Y.push($)}return Y.filter(Boolean).join(" ")}function l(J){if(J.product){const V=Q[J.product];if(V)return V}return J.filter==="live"?"live":"top"}function y(J){const V=J.product||(J.filter==="live"?"live":"top");return i[V]||"Top"}function o(J){if(typeof J==="string")return{queryId:J,features:j.features,fieldToggles:j.fieldToggles};return{queryId:J?.queryId||j.queryId,features:J?.features||j.features,fieldToggles:J?.fieldToggles||j.fieldToggles}}function N(J,V,Y,$,W){const B=o(J),Z={rawQuery:V,count:$,querySource:"typed_query",product:Y};if(W)Z.cursor=W;return[`/i/api/graphql/${B.queryId}/SearchTimeline`,{variables:Z,features:B.features,fieldToggles:B.fieldToggles}]}function u(J){if(!J)return null;if(J.__typename==="TweetWithVisibilityResults"&&J.tweet)return J.tweet;if(J.tweet)return J.tweet;return J}function s(J,V){const Y=u(J);if(!Y?.rest_id||V.has(Y.rest_id))return null;V.add(Y.rest_id);const $=Y.core?.user_results?.result,W=$?.legacy?.description||"";return{id:Y.rest_id,author:$?.core?.screen_name||$?.legacy?.screen_name||"",bio:W,text:Y.note_tweet?.note_tweet_results?.result?.text||Y.legacy?.full_text||"",created_at:Y.legacy?.created_at||"",likes:Y.legacy?.favorite_count||0,views:Y.views?.count||"0",url:`https://x.com/i/status/${Y.rest_id}`,...R(Y.legacy),card:k(Y),quoted_tweet:c(Y)}}function h(J,V){const Y=[];let $=null;const W=J?.data?.search_by_raw_query?.search_timeline?.timeline?.instructions||[],B=(Z)=>{if(!Z||typeof Z!=="object")return;if(Z.tweet_results?.result){const K=s(Z.tweet_results.result,V);if(K)Y.push(K)}if((Z.entryType==="TimelineTimelineCursor"||Z.__typename==="TimelineTimelineCursor")&&(Z.cursorType==="Bottom"||Z.cursorType==="ShowMore")&&Z.value)$=Z.value;if(Array.isArray(Z)){for(const K of Z)B(K);return}for(const K of Object.values(Z))if(K&&typeof K==="object")B(K)};B(W);return{rows:Y,nextCursor:$}}O({site:"twitter",name:"search",access:"read",description:"Search Twitter/X for tweets, with optional --from / --has / --exclude / --product filters mapped to X's search operators",domain:"x.com",strategy:_.COOKIE,browser:!0,args:[{name:"query",type:"string",required:!0,positional:!0,help:'Search query. Raw X operators (e.g. "exact phrase", #tag, OR, lang:en, since:YYYY-MM-DD, from:, since:) are passed through unchanged.'},{name:"filter",type:"string",default:"top",choices:["top","live"],help:"Legacy alias for --product. Kept for backwards compatibility; if --product is set it wins."},{name:"product",type:"string",choices:D,help:"Which X search tab to read: top (default), live (Latest), photos, videos. Maps to the f= URL param."},{name:"from",type:"string",help:"Restrict to tweets authored by <user>. Leading @ is stripped. Equivalent to appending `from:<user>` to the query."},{name:"has",type:"string",choices:q,help:"Restrict to tweets that have media|images|videos|links|replies. Maps to X's `filter:<has>` operator."},{name:"exclude",type:"string",choices:x,help:"Exclude tweets matching <type>: replies|retweets|media|links. Maps to X's `-filter:<x>` operator (retweets → -filter:nativeretweets)."},{name:"limit",type:"int",default:15,help:"Maximum number of tweets to return (default 15). Result count after server-side filtering."},{name:"top-by-engagement",type:"int",default:0,help:"When set to N>0, re-rank the results by weighted engagement (likes×1 + retweets×3 + replies×2 + bookmarks×5 + log10(views+1)×0.5) and return the top N. Default 0 keeps X's native ordering."}],columns:["id","author","bio","text","created_at","likes","views","url","has_media","media_urls","media_posters","card","quoted_tweet"],func:async(J,V)=>{const Y=H(V.query,V);if(!Y)throw new f("twitter search query is empty","Provide a non-empty <query>, or use at least one of --from / --has / --exclude.");if(!Number.isInteger(Number(V.limit))||Number(V.limit)<=0)throw new f("twitter search --limit must be a positive integer","Example: opencli twitter search opencli --limit 15");const W=(await J.getCookies({url:"https://x.com"})).find((z)=>z.name==="ct0")?.value||null;if(!W)throw new C("x.com","Not logged into x.com (no ct0 cookie)");await J.goto("https://x.com/home",{waitUntil:"load",settleMs:1000});const B=await p(J,"SearchTimeline",j),Z=JSON.stringify({Authorization:`Bearer ${decodeURIComponent(g)}`,"X-Csrf-Token":W,"X-Twitter-Auth-Type":"OAuth2Session","X-Twitter-Active-User":"yes","Content-Type":"application/json"}),K=y(V),G=[],U=new Set;let F=null;for(let z=0;z<w&&G.length<V.limit;z++){const m=Number(V.limit)-G.length+10,[I,S]=N(B,Y,K,m,F),A=JSON.stringify(S),X=T(await J.evaluate(`async () => {
+        const options = {
+          method: 'POST',
+          headers: ${Z},
+          credentials: 'include',
+        };
+        options['body'] = ${JSON.stringify(A)};
+        const r = await fetch(${JSON.stringify(I)}, {
+          ...options,
+        });
+        return r.ok ? await r.json() : { error: r.status };
+      }`));if(X?.error){if(G.length===0)throw new d(E("SearchTimeline",X.error));break}const{rows:v,nextCursor:b}=h(X,U);G.push(...v);if(!b||b===F)break;F=b}const P=G.slice(0,V.limit);return n(P,V["top-by-engagement"])}});export const __test__={buildSearchQuery:H,resolveSearchFParam:l,resolveSearchProduct:y,buildSearchTimelineRequest:N,parseSearchTimeline:h,HAS_CHOICES:q,EXCLUDE_CHOICES:x,PRODUCT_CHOICES:D,EXCLUDE_TO_OPERATOR:M,PRODUCT_TO_F_PARAM:Q,FROM_USER_PATTERN:L};

package/clis/twitter/shared.js

@@ -0,0 +1,76 @@
+import{ArgumentError as A}from"@jackwener/opencli/errors";const S=/^[A-Za-z0-9_-]+$/,E=/^[A-Za-z0-9_]{1,15}$/,z=/^\/(?:[^/]+|i)\/status\/(\d+)\/?$/,L=new Set(["x.com","twitter.com"]),U=new Set(["x.com","twitter.com","mobile.twitter.com"]),h=new Set(["compose","explore","help","home","i","intent","jobs","login","logout","messages","notifications","privacy","search","settings","signup","tos"]);function I(j){return L.has(j)||j.endsWith(".x.com")||j.endsWith(".twitter.com")}export function parseTweetUrl(j){const G=String(j??"").trim();if(!G)throw new A("twitter tweet URL cannot be empty","Example: opencli twitter retweet https://x.com/jack/status/20");let V;try{V=new URL(G)}catch{throw new A(`Invalid tweet URL: ${G}`,"Use a full https://x.com/<user>/status/<id> URL")}const J=V.hostname.toLowerCase();if(V.protocol!=="https:"||!I(J))throw new A(`Invalid tweet URL host: ${G}`,"Use a full https://x.com/<user>/status/<id> URL");const X=V.pathname.match(z);if(!X?.[1])throw new A(`Could not extract tweet ID from URL: ${G}`,"Use a full https://x.com/<user>/status/<id> URL");return{id:X[1],url:V.toString()}}export function buildTwitterArticleScopeSource(j){return`
+        const tweetId = ${JSON.stringify(j)};
+        const __twTweetPathRe = /^\\/(?:[^/]+|i)\\/status\\/(\\d+)\\/?$/;
+        const __twIsTwitterHost = (hostname) => hostname === 'x.com'
+            || hostname === 'twitter.com'
+            || hostname.endsWith('.x.com')
+            || hostname.endsWith('.twitter.com');
+        const __twGetStatusIdFromHref = (href) => {
+            try {
+                const parsed = new URL(href, window.location.origin);
+                if (parsed.protocol !== 'https:' || !__twIsTwitterHost(parsed.hostname.toLowerCase())) {
+                    return null;
+                }
+                return parsed.pathname.match(__twTweetPathRe)?.[1] || null;
+            } catch {
+                return null;
+            }
+        };
+        const __twHasLinkToTarget = (root) => Array.from(root.querySelectorAll('a[href*="/status/"]'))
+            .some((link) => __twGetStatusIdFromHref(link.href) === tweetId);
+        const findTargetArticle = () => Array.from(document.querySelectorAll('article'))
+            .find(__twHasLinkToTarget);
+    `}export function sanitizeQueryId(j,G){return typeof j==="string"&&S.test(j)?j:G}export function normalizeTwitterScreenName(j){const G=String(j??"").trim();if(!G)return"";let V="";try{const J=G.startsWith("/")?new URL(G,"https://x.com"):new URL(G);if(J.protocol!=="https:"||J.username||J.password||J.port||!U.has(J.hostname))return"";const X=J.pathname.split("/").filter(Boolean);if(X.length!==1)return"";V=X[0]}catch{if(G.includes("/")||G.includes("?")||G.includes("#"))return"";V=G.replace(/^@+/,"")}if(!E.test(V))return"";if(h.has(V.toLowerCase()))return"";return V}function N(j){if(!Array.isArray(j))return{};return Object.fromEntries(j.filter((G)=>typeof G==="string"&&G).map((G)=>[G,!0]))}export function normalizeTwitterOperationFlags(j){if(Array.isArray(j))return N(j);if(!j||typeof j!=="object")return{};return Object.fromEntries(Object.entries(j).filter(([G,V])=>typeof G==="string"&&G&&typeof V==="boolean"))}function b(j){if(typeof j==="string")return{queryId:j,features:{},fieldToggles:{}};return{queryId:j?.queryId||null,features:normalizeTwitterOperationFlags(j?.features),fieldToggles:normalizeTwitterOperationFlags(j?.fieldToggles)}}export function unwrapBrowserResult(j){if(j&&typeof j==="object"&&typeof j.session==="string"&&Object.prototype.hasOwnProperty.call(j,"data"))return j.data;return j}function F(j){return j&&typeof j==="object"&&!Array.isArray(j)&&Object.keys(j).length===0}export function looksLikePrivateTwitterTimeline(j){const G=j?.data?.user?.result;if(!G||typeof G!=="object")return!1;return Boolean(F(G.timeline)||F(G.timeline_v2?.timeline))}export function normalizeTwitterGraphqlPayload(j){const G=unwrapBrowserResult(j);if(G?.data&&typeof G.data==="object")return G;if(G&&typeof G==="object"&&(Object.prototype.hasOwnProperty.call(G,"user")||Object.prototype.hasOwnProperty.call(G,"search_by_raw_query")))return{data:G};return G}export function sanitizeTwitterOperationMetadata(j,G){const V=unwrapBrowserResult(j),J=b(G);return{queryId:sanitizeQueryId(V?.queryId,J.queryId),features:Object.keys(normalizeTwitterOperationFlags(V?.features)).length>0?normalizeTwitterOperationFlags(V.features):J.features,fieldToggles:Object.keys(normalizeTwitterOperationFlags(V?.fieldToggles)).length>0?normalizeTwitterOperationFlags(V.fieldToggles):J.fieldToggles}}export function parseOperationFromBundleText(j,G){if(!j||!G)return null;const V=G.replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),J=new RegExp(`queryId:"([A-Za-z0-9_-]+)"[^}]{0,400}operationName:"${V}"`),X=new RegExp(`operationName:"${V}"[^}]{0,400}queryId:"([A-Za-z0-9_-]+)"`);let Y=null,W=-1;const $=j.match(J);if($&&typeof $.index==="number"){Y=$[1];W=$.index}else{const R=j.match(X);if(R&&typeof R.index==="number"){Y=R[1];W=R.index}}if(!Y)return null;const Q=Math.max(0,W-500),_=Math.min(j.length,W+1500),H=j.slice(Q,_),C=(R)=>R?Array.from(R.matchAll(/"([^"]+)"/g)).map((Z)=>Z[1]):[],M=(R)=>Object.fromEntries((R||[]).filter((Z)=>typeof Z==="string"&&Z).map((Z)=>[Z,!0]));return{queryId:Y,features:M(C(H.match(/featureSwitches:\[([^\]]*)\]/)?.[1])),fieldToggles:M(C(H.match(/fieldToggles:\[([^\]]*)\]/)?.[1]))}}export async function resolveTwitterOperationMetadata(j,G,V){const J=parseOperationFromBundleText.toString(),X=await j.evaluate(`async () => {
+    const operationName = ${JSON.stringify(G)};
+    const keysToFlags = (keys) => Object.fromEntries((keys || []).filter((k) => typeof k === 'string' && k).map((key) => [key, true]));
+    const normalizeFlags = (value) => {
+      if (Array.isArray(value)) return keysToFlags(value);
+      if (!value || typeof value !== 'object') return {};
+      return Object.fromEntries(Object.entries(value).filter(([key, flag]) => typeof key === 'string' && key && typeof flag === 'boolean'));
+    };
+    const parseOperationFromBundleText = ${J};
+
+    try {
+      const controller = new AbortController();
+      const timeout = setTimeout(() => controller.abort(), 5000);
+      try {
+        const ghResp = await fetch('https://raw.githubusercontent.com/fa0311/twitter-openapi/refs/heads/main/src/config/placeholder.json', { signal: controller.signal });
+        clearTimeout(timeout);
+        if (ghResp.ok) {
+          const data = await ghResp.json();
+          const entry = data && data[operationName];
+          if (entry && entry.queryId) {
+            return {
+              queryId: entry.queryId,
+              features: normalizeFlags(entry.features ?? entry.featureSwitches),
+              fieldToggles: normalizeFlags(entry.fieldToggles),
+            };
+          }
+        }
+      } catch {
+        clearTimeout(timeout);
+      }
+    } catch {}
+
+    try {
+      const scripts = Array.from(document.scripts)
+        .map(s => s.src)
+        .filter(Boolean)
+        .concat(performance.getEntriesByType('resource')
+          .map(r => r.name)
+          .filter(r => r.includes('client-web') && r.endsWith('.js')));
+      const uniqueScripts = Array.from(new Set(scripts));
+      const head = uniqueScripts.slice(0, 15);
+      const tail = uniqueScripts.slice(-15);
+      const candidates = Array.from(new Set([...head, ...tail]));
+      for (const scriptUrl of candidates) {
+        try {
+          const text = await (await fetch(scriptUrl)).text();
+          const operation = parseOperationFromBundleText(text, operationName);
+          if (operation) return operation;
+        } catch {}
+      }
+    } catch {}
+
+    return null;
+  }`);return sanitizeTwitterOperationMetadata(X,V)}export async function resolveTwitterQueryId(j,G,V){return(await resolveTwitterOperationMetadata(j,G,V)).queryId}export function extractMedia(j){const G=j?.extended_entities?.media||j?.entities?.media;if(!Array.isArray(G)||G.length===0)return{has_media:!1,media_urls:[],media_posters:[]};const V=[],J=[];for(const X of G){if(!X)continue;if(X.type==="video"||X.type==="animated_gif"){const $=(X.video_info?.variants||[]).find((Q)=>Q?.content_type==="video/mp4")?.url||X.media_url_https;if($){V.push($);J.push(X.media_url_https||$)}}else if(X.media_url_https){V.push(X.media_url_https);J.push(X.media_url_https)}}return{has_media:V.length>0,media_urls:V,media_posters:J}}export function extractCard(j){const G=j?.card?.legacy;if(!G)return null;const V=Array.isArray(G.binding_values)?G.binding_values:[],J=new Map;for(const P of V)if(P&&typeof P.key==="string")J.set(P.key,P.value);const X=(P)=>{const O=J.get(P);return typeof O?.string_value==="string"&&O.string_value.length>0?O.string_value:void 0},Y=(P)=>{const B=J.get(P)?.image_value?.url;return typeof B==="string"&&B.length>0?B:void 0},W=X("title"),$=X("description"),Q=X("domain"),_=X("card_url"),H=Y("thumbnail_image_large")||Y("photo_image_full_size_large")||Y("summary_photo_image_large"),C=Array.isArray(j?.legacy?.entities?.urls)?j.legacy.entities.urls:[],R=(_?C.find((P)=>P?.url===_||P?.expanded_url===_):void 0)?.expanded_url,Z=typeof R==="string"&&R.length>0?R:_;let K=Q;if(!K&&Z)try{K=new URL(Z).hostname}catch{}if(!Z&&!W&&!$)return null;const D={name:G.name};if(W)D.title=W;if($)D.description=$;if(H)D.image_url=H;if(Z)D.url=Z;if(K)D.domain=K;return D}export function extractQuotedTweet(j){if(!j?.legacy?.is_quote_status)return null;const V=j?.quoted_status_result?.result??j?.legacy?.quoted_status_result?.result;if(!V)return null;const J=V.tweet||V;if(!J||typeof J!=="object")return null;const X=J.legacy&&typeof J.legacy==="object"?J.legacy:{};if(typeof J.rest_id!=="string"||!J.rest_id.trim())return null;const Y=J.core?.user_results?.result,W=Y?.legacy?.screen_name,$=Y?.core?.screen_name,Q=typeof W==="string"&&W.trim()?W.trim():typeof $==="string"&&$.trim()?$.trim():"";if(!E.test(Q))return null;const _=Y?.legacy?.name,H=Y?.core?.name,C=typeof _==="string"?_:typeof H==="string"?H:"",M=J.note_tweet?.note_tweet_results?.result?.text,R=typeof M==="string"&&M.length>0?M:typeof X.full_text==="string"?X.full_text:"",Z=extractMedia(X),K=extractCard(J);if(!R&&!Z.has_media&&!K)return null;const D={id:J.rest_id,author:Q,name:C,text:R,created_at:typeof X.created_at==="string"?X.created_at:"",url:`https://x.com/${Q}/status/${J.rest_id}`,has_media:Z.has_media,media_urls:Z.media_urls,media_posters:Z.media_posters};if(K)D.card=K;return D}export function describeTwitterApiError(j,G,V){const J=Number(G),X=`HTTP ${G}: ${j} fetch failed`;let Y;if(J===429)Y="rate-limited by Twitter (session quota); retry after cooldown (typically 15-30 min)";else if(J===401)Y="auth failed (cookie expired or invalidated); re-login required";else if(J===403)Y="forbidden (cookie lacks scope, or resource is private)";else if(J===404)Y="resource not found (deleted, suspended, or private)";else if(J>=500&&J<600)Y="Twitter server error; retry later";else Y="possibly queryId expired, schema change, or transient";if(V)Y=`${Y} (${V})`;return`${X} — ${Y}`}export const __test__={sanitizeQueryId,normalizeTwitterOperationFlags,sanitizeTwitterOperationMetadata,unwrapBrowserResult,normalizeTwitterGraphqlPayload,normalizeTwitterScreenName,extractMedia,extractCard,extractQuotedTweet,parseTweetUrl,buildTwitterArticleScopeSource,looksLikePrivateTwitterTimeline,parseOperationFromBundleText,describeTwitterApiError};

package/clis/twitter/thread.js

@@ -0,0 +1,4 @@
+import{cli as L,Strategy as O}from"@jackwener/opencli/registry";import{AuthRequiredError as W,CommandExecutionError as j}from"@jackwener/opencli/errors";import{BROWSER_JSON_SNIFF_FN as A,throwIfLoginWall as F}from"@jackwener/opencli/utils";import{extractMedia as U,extractCard as h,extractQuotedTweet as D,describeTwitterApiError as N}from"./shared.js";import{TWITTER_BEARER_TOKEN as S,applyTopByEngagement as m}from"./utils.js";const R="nBS-WpgA6ZG0CyNHD517JQ",k={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,longform_notetweets_consumption_enabled:!0,longform_notetweets_rich_text_read_enabled:!0,longform_notetweets_inline_media_enabled:!0,freedom_of_speech_not_reach_fetch_enabled:!0},y={withArticleRichContentState:!0,withArticlePlainText:!1};function C(X,V){const z={focalTweetId:X,referrer:"tweet",with_rux_injections:!1,includePromotedContent:!1,rankingMode:"Recency",withCommunity:!0,withQuickPromoteEligibilityTweetFields:!0,withBirdwatchNotes:!0,withVoice:!0};if(V)z.cursor=V;return`/i/api/graphql/${R}/TweetDetail?variables=${encodeURIComponent(JSON.stringify(z))}&features=${encodeURIComponent(JSON.stringify(k))}&fieldToggles=${encodeURIComponent(JSON.stringify(y))}`}function b(X,V){if(!X)return null;const z=X.tweet||X,P=z.legacy||{};if(!z.rest_id||V.has(z.rest_id))return null;V.add(z.rest_id);const $=z.core?.user_results?.result,q=z.note_tweet?.note_tweet_results?.result?.text,Z=$?.legacy?.screen_name||$?.core?.screen_name||"unknown",H=$?.legacy?.description||"";return{id:z.rest_id,author:Z,bio:H,text:q||P.full_text||"",likes:P.favorite_count||0,retweets:P.retweet_count||0,in_reply_to:P.in_reply_to_status_id_str||void 0,created_at:P.created_at,url:`https://x.com/${Z}/status/${z.rest_id}`,...U(P),card:h(z),quoted_tweet:D(z)}}function B(X,V){const z=[];let P=null;const $=X?.data?.threaded_conversation_with_injections_v2?.instructions||X?.data?.tweetResult?.result?.timeline?.instructions||[];for(const q of $)for(const Z of q.entries||[]){const H=Z.content;if(H?.entryType==="TimelineTimelineCursor"||H?.__typename==="TimelineTimelineCursor"){if(H.cursorType==="Bottom"||H.cursorType==="ShowMore")P=H.value;continue}if(Z.entryId?.startsWith("cursor-bottom-")||Z.entryId?.startsWith("cursor-showMore-")){P=H?.itemContent?.value||H?.value||P;continue}const K=b(H?.itemContent?.tweet_results?.result,V);if(K)z.push(K);for(const J of H?.items||[]){const Y=b(J.item?.itemContent?.tweet_results?.result,V);if(Y)z.push(Y)}}return{tweets:z,nextCursor:P}}export const __test__={parseTweetDetail:B};L({site:"twitter",name:"thread",access:"read",description:"Get a tweet thread (original + all replies)",domain:"x.com",strategy:O.COOKIE,browser:!0,args:[{name:"tweet-id",positional:!0,type:"string",required:!0,help:"Tweet numeric ID (e.g. 1234567890) or full status URL"},{name:"limit",type:"int",default:50},{name:"top-by-engagement",type:"int",default:0,help:"When set to N>0, re-rank the thread 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 conversation's structural ordering."}],columns:["id","author","bio","text","likes","retweets","url","has_media","media_urls","media_posters","card","quoted_tweet"],func:async(X,V)=>{let z=V["tweet-id"];const P=z.match(/\/status\/(\d+)/);if(P)z=P[1];const q=(await X.getCookies({url:"https://x.com"})).find((f)=>f.name==="ct0")?.value||null;if(!q)throw new W("x.com","Not logged into x.com (no ct0 cookie)");const Z=JSON.stringify({Authorization:`Bearer ${decodeURIComponent(S)}`,"X-Csrf-Token":q,"X-Twitter-Auth-Type":"OAuth2Session","X-Twitter-Active-User":"yes"}),H=[],K=new Set;let J=null;for(let f=0;f<5;f++){const Q=C(z,J),v=F(await X.evaluate(`async () => {
+        ${A}
+        return await fetchJsonOrLoginWall("${Q}", { headers: ${Z}, credentials: 'include' });
+      }`),{url:Q});if(v?.error){if(H.length===0)throw new j(N("TweetDetail",v.error));break}const{tweets:M,nextCursor:G}=B(v,K);H.push(...M);if(!G||G===J)break;J=G}const Y=H.slice(0,V.limit);return m(Y,V["top-by-engagement"])}});

package/clis/twitter/timeline.js

@@ -0,0 +1,4 @@
+import{AuthRequiredError as A,CommandExecutionError as R}from"@jackwener/opencli/errors";import{cli as b,Strategy as v}from"@jackwener/opencli/registry";import{resolveTwitterQueryId as C,extractMedia as N,extractCard as _,extractQuotedTweet as x,describeTwitterApiError as I}from"./shared.js";import{TWITTER_BEARER_TOKEN as g,applyTopByEngagement as y}from"./utils.js";const E="c-CzHF1LboFilMpsx4ZCrQ",m="BKB7oi212Fi7kQtCBGE4zA",p=100,d={"for-you":{endpoint:"HomeTimeline",method:"GET",fallbackQueryId:E},following:{endpoint:"HomeLatestTimeline",method:"POST",fallbackQueryId:m}},T={rweb_video_screen_enabled:!1,profile_label_improvements_pcf_label_in_post_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,responsive_web_jetfuel_frame:!1,responsive_web_grok_share_attachment_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,responsive_web_grok_show_grok_translated_post:!1,responsive_web_grok_analysis_button_from_backend:!1,creator_subscriptions_quote_tweet_preview_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_enhance_cards_enabled:!1};function L(Z,$,z){const J={count:$,includePromotedContent:!1,latestControlAvailable:!0,requestContext:"launch"};if(Z==="for-you")J.withCommunity=!0;if(Z==="following")J.seenTweetIds=[];if(z)J.cursor=z;return J}function f(Z,$,z){return`/i/api/graphql/${Z}/${$}?variables=${encodeURIComponent(JSON.stringify(z))}&features=${encodeURIComponent(JSON.stringify(T))}`}function O(Z,$){if(!Z)return null;const z=Z.tweet||Z,J=z.legacy||{};if(!z.rest_id||$.has(z.rest_id))return null;$.add(z.rest_id);const K=z.core?.user_results?.result,G=K?.legacy?.screen_name||K?.core?.screen_name||"unknown",V=K?.legacy?.description||"",F=z.note_tweet?.note_tweet_results?.result?.text,X=z.views?.count?parseInt(z.views.count,10):0;return{id:z.rest_id,author:G,bio:V,text:F||J.full_text||"",likes:J.favorite_count||0,retweets:J.retweet_count||0,replies:J.reply_count||0,views:X,created_at:J.created_at||"",url:`https://x.com/${G}/status/${z.rest_id}`,...N(J),card:_(z),quoted_tweet:x(z)}}function Q(Z,$){const z=[];let J=null;const K=Z?.data?.home?.home_timeline_urt?.instructions||[];for(const G of K)for(const V of G.entries||[]){const F=V.content;if(F?.entryType==="TimelineTimelineCursor"||F?.__typename==="TimelineTimelineCursor"){if(F.cursorType==="Bottom")J=F.value;continue}if(V.entryId?.startsWith("cursor-bottom-")){J=F?.value||J;continue}const X=F?.itemContent?.tweet_results?.result;if(X){if(F?.itemContent?.promotedMetadata)continue;const B=O(X,$);if(B)z.push(B);continue}for(const B of F?.items||[]){const Y=B.item?.itemContent?.tweet_results?.result;if(Y){if(B.item?.itemContent?.promotedMetadata)continue;const W=O(Y,$);if(W)z.push(W)}}}return{tweets:z,nextCursor:J}}b({site:"twitter",name:"timeline",access:"read",description:"Fetch the logged-in user's home timeline (for-you algorithmic feed by default; pass --type following for the chronological feed of accounts you follow)",domain:"x.com",strategy:v.COOKIE,browser:!0,args:[{name:"type",default:"for-you",choices:["for-you","following"],help:"Which home-timeline feed to read. Default for-you (algorithmic). Use following for the chronological feed of accounts you follow."},{name:"limit",type:"int",default:20,help:"Maximum number of tweets to return (default 20)."},{name:"top-by-engagement",type:"int",default:0,help:"When set to N>0, re-rank the timeline by weighted engagement (likes×1 + retweets×3 + replies×2 + bookmarks×5 + log10(views+1)×0.5) and return the top N. Default 0 keeps X's native ordering."}],columns:["id","author","bio","text","likes","retweets","replies","views","created_at","url","has_media","media_urls","media_posters","card","quoted_tweet"],func:async(Z,$)=>{const z=$.limit||20,J=$.type==="following"?"following":"for-you",{endpoint:K,method:G,fallbackQueryId:V}=d[J],X=(await Z.getCookies({url:"https://x.com"})).find((D)=>D.name==="ct0")?.value||null;if(!X)throw new A("x.com","Not logged into x.com (no ct0 cookie)");const B=await C(Z,K,V),Y=JSON.stringify({Authorization:`Bearer ${decodeURIComponent(g)}`,"X-Csrf-Token":X,"X-Twitter-Auth-Type":"OAuth2Session","X-Twitter-Active-User":"yes"}),W=[],S=new Set;let P=null;for(let D=0;D<p&&W.length<z;D++){const U=Math.min(40,z-W.length+5),h=L(J,U,P),M=f(B,K,h),j=await Z.evaluate(`async () => {
+        const r = await fetch("${M}", { method: "${G}", headers: ${Y}, credentials: 'include' });
+        return r.ok ? await r.json() : { error: r.status };
+      }`);if(j?.error){if(W.length===0)throw new R(I(K,j.error));break}const{tweets:k,nextCursor:q}=Q(j,S);W.push(...k);if(!q||q===P)break;P=q}const H=W.slice(0,z);return y(H,$["top-by-engagement"])}});export const __test__={buildTimelineVariables:L,buildHomeTimelineUrl:f,parseHomeTimeline:Q};

package/clis/twitter/trending.js

@@ -0,0 +1,18 @@
+import{cli as H,Strategy as I}from"@jackwener/opencli/registry";import{AuthRequiredError as J,EmptyResultError as K}from"@jackwener/opencli/errors";H({site:"twitter",name:"trending",access:"read",description:"Twitter/X trending topics",domain:"x.com",strategy:I.COOKIE,browser:!0,args:[{name:"limit",type:"int",default:20,help:"Number of trends to show"}],columns:["rank","topic","category"],func:async(b,z)=>{const B=z.limit||20;await b.goto("https://x.com/explore/tabs/trending");await b.wait(3);if(!(await b.getCookies({url:"https://x.com"})).find((G)=>G.name==="ct0")?.value)throw new J("x.com","Not logged into x.com (no ct0 cookie)");await b.wait(2);const x=await b.evaluate(`(() => {
+      const items = [];
+      const cells = document.querySelectorAll('[data-testid="trend"]');
+      cells.forEach((cell) => {
+        const text = cell.textContent || '';
+        if (text.includes('Promoted')) return;
+        const container = cell.querySelector(':scope > div');
+        if (!container) return;
+        const divs = container.children;
+        if (divs.length < 2) return;
+        const topic = divs[1].textContent.trim();
+        if (!topic) return;
+        const catText = divs[0].textContent.trim();
+        const category = catText.replace(/^\\d+\\s*/, '').replace(/^\\xB7\\s*/, '').trim();
+        items.push({ rank: items.length + 1, topic, category });
+      });
+      return items;
+    })()`);if(!Array.isArray(x)||x.length===0)throw new K("twitter trending","No trends found. The page structure may have changed.");return x.slice(0,B)}});

package/clis/twitter/tweets.js

@@ -0,0 +1,12 @@
+import{cli as u,Strategy as o}from"@jackwener/opencli/registry";import{ArgumentError as A,AuthRequiredError as L,CommandExecutionError as O,EmptyResultError as s}from"@jackwener/opencli/errors";import{resolveTwitterOperationMetadata as R,sanitizeQueryId as l,extractMedia as t,extractQuotedTweet as r,normalizeTwitterGraphqlPayload as a,unwrapBrowserResult as T,normalizeTwitterScreenName as U,describeTwitterApiError as e}from"./shared.js";import{TWITTER_BEARER_TOKEN as jj,applyTopByEngagement as qj}from"./utils.js";const f="lrMzG9qPQHpqJdP3AbM-bQ",x="IGgvgiOx4QZndDHuD3x9TQ",S=100,C=100,$=S*C,E=2,b={rweb_video_screen_enabled:!0,rweb_cashtags_enabled:!0,payments_enabled:!1,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,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:!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},B={withPayments:!0,withAuxiliaryUserLabels:!0,withArticleRichContentState:!0,withArticlePlainText:!0,withArticleSummaryText:!0,withArticleVoiceOver:!0,withGrokAnalyze:!0,withDisallowedReplyControls:!0},D={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},_={withPayments:!0,withAuxiliaryUserLabels:!0},Fj={queryId:f,features:b,fieldToggles:B},Gj={queryId:x,features:D,fieldToggles:_};function Hj(j){if(typeof j==="string")return{queryId:j,features:b,fieldToggles:B};return{queryId:j?.queryId||f,features:j?.features||b,fieldToggles:j?.fieldToggles||B}}function Jj(j){if(typeof j==="string")return{queryId:j,features:D,fieldToggles:_};return{queryId:j?.queryId||x,features:j?.features||D,fieldToggles:j?.fieldToggles||_}}function k(j,q,F){const G=F.fieldToggles||{},J=[`variables=${encodeURIComponent(JSON.stringify(q))}`,`features=${encodeURIComponent(JSON.stringify(F.features||{}))}`];if(Object.keys(G).length>0)J.push(`fieldToggles=${encodeURIComponent(JSON.stringify(G))}`);return`${j}?${J.join("&")}`}function N(j,q,F,G){const J=Hj(j),K={userId:q,count:F,includePromotedContent:!1,withQuickPromoteEligibilityTweetFields:!0,withVoice:!0};if(G)K.cursor=G;return k(`/i/api/graphql/${J.queryId}/UserTweets`,K,J)}function h(j,q){const F=Jj(j),G={screen_name:q,withSafetyModeUserFields:!0};return k(`/i/api/graphql/${F.queryId}/UserByScreenName`,G,F)}function y(j,q){if(!j)return null;const F=j.__typename==="TweetWithVisibilityResults"&&j.tweet?j.tweet:j.tweet||j,G=F.legacy||{};if(!F.rest_id||q.has(F.rest_id))return null;q.add(F.rest_id);const J=F.core?.user_results?.result,K=J?.legacy?.screen_name||J?.core?.screen_name||"unknown",Z=J?.legacy?.name||J?.core?.name||"",W=F.note_tweet?.note_tweet_results?.result?.text,H=Boolean(G.retweeted_status_result||G.full_text?.startsWith("RT @"));return{id:F.rest_id,author:K,name:Z,text:W||G.full_text||"",likes:G.favorite_count||0,retweets:G.retweet_count||0,replies:G.reply_count||0,views:Number(F.views?.count)||0,is_retweet:H,created_at:G.created_at||"",url:`https://x.com/${K}/status/${F.rest_id}`,...t(G),quoted_tweet:r(F)}}function d(j,q){const F=[];let G=null;const J=j?.data?.user?.result||{},Z=[J.timeline_v2?.timeline?.instructions,J.timeline?.timeline?.instructions].filter(Array.isArray).flat(),W=(H)=>{if(!H||typeof H!=="object")return;if(H.type==="TimelinePinEntry")return;if(H.tweet_results?.result){const Q=y(H.tweet_results.result,q);if(Q)F.push(Q)}if((H.entryType==="TimelineTimelineCursor"||H.__typename==="TimelineTimelineCursor")&&(H.cursorType==="Bottom"||H.cursorType==="ShowMore")&&H.value)G=H.value;if(Array.isArray(H)){for(const Q of H)W(Q);return}for(const Q of Object.values(H))if(Q&&typeof Q==="object")W(Q)};W(Z);return{tweets:F,nextCursor:G}}function w(j){const q=j??20;if(!Number.isInteger(q)||q<1||q>$)throw new A(`twitter tweets --limit must be an integer between 1 and ${$}`,"Example: opencli twitter tweets @jack --limit 250");return q}function c(j){const q=j??E;if(!Number.isInteger(q)||q<0||q>60)throw new A("twitter tweets --page-delay must be an integer between 0 and 60 seconds","Example: opencli twitter tweets @jack --limit 250 --page-delay 2");return q}u({site:"twitter",name:"tweets",access:"read",description:"Fetch a Twitter user's most recent tweets (chronological, excludes pinned; defaults to the logged-in user when no username is given)",domain:"x.com",strategy:o.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:`Max tweets to return (1-${$}; fetched across cursor pages)`},{name:"page-delay",type:"int",default:E,help:"Seconds to wait between paginated timeline requests to reduce rate-limit risk. Use 0 to disable."},{name:"top-by-engagement",type:"int",default:0,help:"When set to N>0, re-rank the 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 chronological ordering."}],columns:["id","author","created_at","is_retweet","text","likes","retweets","replies","views","url","has_media","media_urls","media_posters","quoted_tweet"],func:async(j,q)=>{const F=w(q.limit),G=c(q["page-delay"]),J=String(q.username??"").trim();let K=U(J);if(J&&!K)throw new A("twitter tweets username must be a valid Twitter/X handle","Example: opencli twitter tweets @jack --limit 20");if(!K){await j.goto("https://x.com/home");await j.wait({selector:'[data-testid="primaryColumn"]'});const V=T(await j.evaluate(`() => {
+        const link = document.querySelector('a[data-testid="AppTabBar_Profile_Link"]');
+        return link ? link.getAttribute('href') : null;
+      }`));if(!V||typeof V!=="string")throw new L("x.com","Could not detect logged-in user. Are you logged in?");K=U(V);if(!K)throw new L("x.com","Could not detect logged-in user. Are you logged in?")}const W=(await j.getCookies({url:"https://x.com"})).find((V)=>V.name==="ct0")?.value||null;if(!W)throw new L("x.com","Not logged into x.com (no ct0 cookie)");const H=await R(j,"UserTweets",Fj),Q=await R(j,"UserByScreenName",Gj),z=JSON.stringify({Authorization:`Bearer ${decodeURIComponent(jj)}`,"X-Csrf-Token":W,"X-Twitter-Auth-Type":"OAuth2Session","X-Twitter-Active-User":"yes"}),m=h(Q,K),I=T(await j.evaluate(`async () => {
+      const resp = await fetch("${m}", { headers: ${z}, credentials: 'include' });
+      if (!resp.ok) return null;
+      const d = await resp.json();
+      return d?.data?.user?.result?.rest_id || null;
+    }`));if(!I)throw new O(`Could not resolve @${K}`);const v=new Set,X=[];let M=null;for(let V=0;V<S&&X.length<F;V++){if(V>0&&G>0)await j.wait(G);const p=Math.min(C,F-X.length+10),n=N(H,I,p,M),P=a(await j.evaluate(`async () => {
+        const r = await fetch("${n}", { headers: ${z}, credentials: 'include' });
+        return r.ok ? await r.json() : { error: r.status };
+      }`));if(P?.error){if(X.length===0)throw new O(e("UserTweets",P.error));break}const{tweets:i,nextCursor:Y}=d(P,v);X.push(...i);if(!Y||Y===M)break;M=Y}if(X.length===0)throw new s(`@${K} has no recent tweets`,"Account may be private or suspended");const g=X.slice(0,F);return qj(g,q["top-by-engagement"])}});export const __test__={MAX_TWEETS_LIMIT:$,sanitizeQueryId:l,buildUserTweetsUrl:N,buildUserByScreenNameUrl:h,extractTweet:y,parseUserTweets:d,normalizeLimit:w,normalizePageDelaySeconds:c};

package/clis/twitter/unblock.js

@@ -0,0 +1,45 @@
+import{CommandExecutionError as r}from"@jackwener/opencli/errors";import{cli as i,Strategy as s}from"@jackwener/opencli/registry";i({site:"twitter",name:"unblock",access:"write",description:"Unblock a Twitter user",domain:"x.com",strategy:s.UI,browser:!0,args:[{name:"username",type:"string",positional:!0,required:!0,help:"Twitter screen name (without @)"}],columns:["status","message"],func:async(t,n)=>{if(!t)throw new r("Browser session required for twitter unblock");const e=n.username.replace(/^@/,"");await t.goto(`https://x.com/${e}`);await t.wait({selector:'[data-testid="primaryColumn"]'});const o=await t.evaluate(`(async () => {
+        try {
+            let attempts = 0;
+            let unblockBtn = null;
+
+            while (attempts < 20) {
+                // Check if not blocked (follow button visible means not blocked)
+                const followBtn = document.querySelector('[data-testid$="-follow"]');
+                if (followBtn) {
+                    return { ok: true, message: 'Not blocking @${e} (already unblocked).' };
+                }
+
+                unblockBtn = document.querySelector('[data-testid$="-unblock"]');
+                if (unblockBtn) break;
+
+                await new Promise(r => setTimeout(r, 500));
+                attempts++;
+            }
+
+            if (!unblockBtn) {
+                return { ok: false, message: 'Could not find Unblock button. Are you logged in?' };
+            }
+
+            // Click the unblock button — this opens a confirmation dialog
+            unblockBtn.click();
+            await new Promise(r => setTimeout(r, 1000));
+
+            // Confirm the unblock in the dialog
+            const confirmBtn = document.querySelector('[data-testid="confirmationSheetConfirm"]');
+            if (confirmBtn) {
+                confirmBtn.click();
+                await new Promise(r => setTimeout(r, 1000));
+            }
+
+            // Verify
+            const verify = document.querySelector('[data-testid$="-follow"]');
+            if (verify) {
+                return { ok: true, message: 'Successfully unblocked @${e}.' };
+            } else {
+                return { ok: false, message: 'Unblock action initiated but UI did not update.' };
+            }
+        } catch (e) {
+            return { ok: false, message: e.toString() };
+        }
+    })()`);if(o.ok)await t.wait(2);return[{status:o.ok?"success":"failed",message:o.message}]}});

package/clis/twitter/unbookmark.js

@@ -0,0 +1,41 @@
+import{CommandExecutionError as a}from"@jackwener/opencli/errors";import{cli as i,Strategy as s}from"@jackwener/opencli/registry";import{parseTweetUrl as m,buildTwitterArticleScopeSource as n}from"./shared.js";i({site:"twitter",name:"unbookmark",access:"write",description:"Remove a tweet from bookmarks",domain:"x.com",strategy:s.UI,browser:!0,args:[{name:"url",type:"string",positional:!0,required:!0,help:"Tweet URL to unbookmark"}],columns:["status","message"],func:async(e,o)=>{if(!e)throw new a("Browser session required for twitter unbookmark");const r=m(o.url);await e.goto(r.url);await e.wait({selector:'[data-testid="primaryColumn"]'});const t=await e.evaluate(`(async () => {
+        try {
+            ${n(r.id)}
+            let attempts = 0;
+            let removeBtn = null;
+            let targetArticle = null;
+
+            while (attempts < 20) {
+                targetArticle = findTargetArticle();
+                // Check if not bookmarked (already removed)
+                const bookmarkBtn = targetArticle?.querySelector('[data-testid="bookmark"]');
+                if (bookmarkBtn) {
+                    return { ok: true, message: 'Tweet is not bookmarked (already removed).' };
+                }
+
+                removeBtn = targetArticle?.querySelector('[data-testid="removeBookmark"]') || null;
+                if (removeBtn) break;
+
+                await new Promise(r => setTimeout(r, 500));
+                attempts++;
+            }
+
+            if (!removeBtn) {
+                return { ok: false, message: 'Could not find Remove Bookmark button on the requested tweet. Are you logged in?' };
+            }
+
+            removeBtn.click();
+            await new Promise(r => setTimeout(r, 1000));
+
+            // Verify
+            const verifyArticle = findTargetArticle() || targetArticle;
+            const verify = verifyArticle?.querySelector('[data-testid="bookmark"]');
+            if (verify) {
+                return { ok: true, message: 'Tweet successfully removed from bookmarks.' };
+            } else {
+                return { ok: false, message: 'Unbookmark 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/unfollow.js

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

package/clis/twitter/unlike.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:"unlike",access:"write",description:"Remove a like from 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 unlike"}],columns:["status","message"],func:async(v,D)=>{if(!v)throw new F("Browser session required for twitter unlike");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. State probes scoped to the article
+            // matching the requested status id — bare querySelector on a
+            // conversation page would silently grab the first article (e.g.
+            // the parent tweet) and unlike the wrong one.
+            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 not liked
+            if (likeBtn) {
+                return { ok: true, message: 'Tweet is not liked (already unliked).' };
+            }
+
+            if (!unlikeBtn) {
+                return { ok: false, message: 'Could not find the Unlike button on this tweet after waiting 10 seconds. Are you logged in?' };
+            }
+
+            // Click Unlike
+            unlikeBtn.click();
+            await new Promise(r => setTimeout(r, 1000));
+
+            // Verify success by checking if the 'like' button reappeared
+            const verifyArticle = findTargetArticle() || targetArticle;
+            const verifyBtn = verifyArticle?.querySelector('[data-testid="like"]');
+            if (verifyBtn) {
+                return { ok: true, message: 'Tweet successfully unliked.' };
+            } else {
+                return { ok: false, message: 'Unlike 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/unretweet.js

@@ -0,0 +1,62 @@
+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:"unretweet",access:"write",description:"Undo a retweet on 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 unretweet"}],columns:["status","message"],func:async(v,D)=>{if(!v)throw new F("Browser session required for twitter unretweet");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. State probes scoped to the article
+            // matching the requested status id — bare querySelector on a
+            // conversation page would silently grab the first article (e.g.
+            // the parent tweet) and unretweet the wrong one.
+            let attempts = 0;
+            let retweetBtn = null;
+            let unretweetBtn = null;
+            let targetArticle = null;
+
+            while (attempts < 20) {
+                targetArticle = findTargetArticle();
+                retweetBtn = targetArticle?.querySelector('[data-testid="retweet"]') || null;
+                unretweetBtn = targetArticle?.querySelector('[data-testid="unretweet"]') || null;
+
+                if (retweetBtn || unretweetBtn) break;
+
+                await new Promise(r => setTimeout(r, 500));
+                attempts++;
+            }
+
+            // Already not retweeted: idempotent success
+            if (retweetBtn) {
+                return { ok: true, message: 'Tweet is not retweeted (already removed).' };
+            }
+
+            if (!unretweetBtn) {
+                return { ok: false, message: 'Could not find the Unretweet button on this tweet after waiting 10 seconds. Are you logged in?' };
+            }
+
+            // Step 1: click Unretweet button → opens menu
+            unretweetBtn.click();
+
+            // Step 2: wait for and click the confirm menu item. The confirm
+            // popover renders at the document root, not inside the article,
+            // so this lookup is intentionally document-scoped.
+            let confirmBtn = null;
+            for (let i = 0; i < 20; i++) {
+                await new Promise(r => setTimeout(r, 250));
+                confirmBtn = document.querySelector('[data-testid="unretweetConfirm"]');
+                if (confirmBtn) break;
+            }
+            if (!confirmBtn) {
+                return { ok: false, message: 'Unretweet menu opened but the confirm option did not appear.' };
+            }
+            confirmBtn.click();
+            await new Promise(r => setTimeout(r, 1000));
+
+            // Verify success by checking if the 'retweet' button reappeared
+            const verifyArticle = findTargetArticle() || targetArticle;
+            const verifyBtn = verifyArticle?.querySelector('[data-testid="retweet"]');
+            if (verifyBtn) {
+                return { ok: true, message: 'Tweet successfully unretweeted.' };
+            } else {
+                return { ok: false, message: 'Unretweet 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}]}});