publishport-opencli 1.0.20 → 1.0.21

package/clis/twitter/post.js

@@ -1,19 +1,19 @@
-import*as R from"node:fs";import*as J from"node:path";import{cli as h,Strategy as C}from"@jackwener/opencli/registry";import{AuthRequiredError as j,CommandExecutionError as q}from"@jackwener/opencli/errors";import{describeTwitterApiError as U,resolveTwitterOperationMetadata as w,unwrapBrowserResult as I}from"./shared.js";import{TWITTER_BEARER_TOKEN as L}from"./utils.js";import{assertLiteralContent as P}from"../_shared/content-guard.js";import{setInputFiles as b}from"../_shared/file-inject.js";const B=4,N=500,D=30000,f=250,m=1e4,v=500,y=15000,S="https://x.com/compose/post",M="https://x.com/home",A='input[type="file"][data-testid="fileInput"]',O=new Set([".jpg",".jpeg",".png",".gif",".webp"]),x={queryId:"5CdvsV_zjv4L64XFifAglw",features:{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,responsive_web_edit_tweet_api_enabled:!0,rweb_conversational_replies_downvote_enabled:!1,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:!0,responsive_web_grok_analysis_button_from_backend:!0,post_ctas_fetch_enabled:!0,longform_notetweets_rich_text_read_enabled:!0,longform_notetweets_inline_media_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,articles_preview_enabled:!0,rweb_cashtags_enabled:!0,responsive_web_grok_community_note_auto_translation_is_enabled:!0,responsive_web_graphql_skip_user_profile_image_extensions_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,responsive_web_grok_image_annotation_enabled:!0,responsive_web_grok_imagine_annotation_enabled:!0,responsive_web_graphql_timeline_navigation_enabled:!0},fieldToggles:{}};function c(z){const Q=z.split(",").map((H)=>H.trim()).filter(Boolean);if(Q.length>B)throw new q(`Too many images: ${Q.length} (max ${B})`);return Q.map((H)=>{const Y=J.resolve(H),$=J.extname(Y).toLowerCase();if(!O.has($))throw new q(`Unsupported image format "${$}". Supported: jpg, png, gif, webp`);const Z=R.statSync(Y,{throwIfNoEntry:!1});if(!Z||!Z.isFile())throw new q(`Not a valid file: ${Y}`);return Y})}function T(z){const H=(z instanceof Error?z.message:String(z)).toLowerCase();return H.includes("unknown action")||H.includes("not supported")||H.includes("inserttext returned no inserted flag")}async function _(z){return z.evaluate(`(() => {
+import*as S from"node:fs";import*as b from"node:path";import{cli as v,Strategy as k}from"@jackwener/opencli/registry";import{AuthRequiredError as w,CommandExecutionError as c}from"@jackwener/opencli/errors";import{describeTwitterApiError as C,resolveTwitterOperationMetadata as A,unwrapBrowserResult as O}from"./shared.js";import{TWITTER_BEARER_TOKEN as E}from"./utils.js";import{assertLiteralContent as I}from"../_shared/content-guard.js";import{setInputFiles as P}from"../_shared/file-inject.js";const p=4,g=500,_=30000,h=250,q=1e4,f=500,y=15000,N="https://x.com/compose/post",M="https://x.com/home",x='input[type="file"][data-testid="fileInput"]',R=new Set([".jpg",".jpeg",".png",".gif",".webp"]),U={queryId:"5CdvsV_zjv4L64XFifAglw",features:{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,responsive_web_edit_tweet_api_enabled:!0,rweb_conversational_replies_downvote_enabled:!1,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:!0,responsive_web_grok_analysis_button_from_backend:!0,post_ctas_fetch_enabled:!0,longform_notetweets_rich_text_read_enabled:!0,longform_notetweets_inline_media_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,articles_preview_enabled:!0,rweb_cashtags_enabled:!0,responsive_web_grok_community_note_auto_translation_is_enabled:!0,responsive_web_graphql_skip_user_profile_image_extensions_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,responsive_web_grok_image_annotation_enabled:!0,responsive_web_grok_imagine_annotation_enabled:!0,responsive_web_graphql_timeline_navigation_enabled:!0},fieldToggles:{}};function J(e){const o=e.split(",").map((t)=>t.trim()).filter(Boolean);if(o.length>p)throw new c(`Too many images: ${o.length} (max ${p})`);return o.map((t)=>{const s=b.resolve(t),n=b.extname(s).toLowerCase();if(!R.has(n))throw new c(`Unsupported image format "${n}". Supported: jpg, png, gif, webp`);const r=S.statSync(s,{throwIfNoEntry:!1});if(!r||!r.isFile())throw new c(`Not a valid file: ${s}`);return s})}function L(e){const t=(e instanceof Error?e.message:String(e)).toLowerCase();return t.includes("unknown action")||t.includes("not supported")||t.includes("inserttext returned no inserted flag")}async function z(e){return e.evaluate(`(() => {
         const visible = (el) => !!el && (el.offsetParent !== null || el.getClientRects().length > 0);
         const boxes = Array.from(document.querySelectorAll('[data-testid="tweetTextarea_0"]'));
         const box = boxes.find(visible) || boxes[0];
         if (!box) return { ok: false, message: 'Could not find the tweet composer text area. Are you logged in?' };
         box.focus();
         return { ok: true };
-    })()`)}async function d(z,Q){const H=Math.ceil(m/f);return z.evaluate(`(async () => {
-        const expected = ${JSON.stringify(Q)};
+    })()`)}async function B(e,o){const t=Math.ceil(q/h);return e.evaluate(`(async () => {
+        const expected = ${JSON.stringify(o)};
         const normalize = s => String(s || '').replace(/ /g, ' ').replace(/s+/g, ' ').trim();
         const normalizedExpected = normalize(expected);
-        for (let i = 0; i < ${JSON.stringify(H)}; i++) {
+        for (let i = 0; i < ${JSON.stringify(t)}; i++) {
             const box = document.querySelector('[data-testid="tweetTextarea_0"]');
             const actual = box ? (box.innerText || box.textContent || '') : '';
             if (box && normalize(actual).includes(normalizedExpected)) return { ok: true };
-            await new Promise(r => setTimeout(r, ${JSON.stringify(f)}));
+            await new Promise(r => setTimeout(r, ${JSON.stringify(h)}));
         }
         const box = document.querySelector('[data-testid="tweetTextarea_0"]');
         return {
@@ -21,13 +21,13 @@ import*as R from"node:fs";import*as J from"node:path";import{cli as h,Strategy a
             message: 'Could not verify tweet text in the composer after typing.',
             actualText: box ? (box.innerText || box.textContent || '') : ''
         };
-    })()`)}async function l(z,Q){const H=await _(z);if(!H?.ok)return H;const Y=[z.nativeType?.bind(z),z.insertText?.bind(z)].filter(Boolean);for(const $ of Y)try{await $(Q);const Z=await d(z,Q);if(Z?.ok)return Z}catch(Z){if(!T(Z))throw Z}return z.evaluate(`(async () => {
+    })()`)}async function j(e,o){const t=await z(e);if(!t?.ok)return t;const s=[e.nativeType?.bind(e),e.insertText?.bind(e)].filter(Boolean);for(const n of s)try{await n(o);const r=await B(e,o);if(r?.ok)return r}catch(r){if(!L(r))throw r}return e.evaluate(`(async () => {
         try {
             const visible = (el) => !!el && (el.offsetParent !== null || el.getClientRects().length > 0);
             const boxes = Array.from(document.querySelectorAll('[data-testid="tweetTextarea_0"]'));
             const box = boxes.find(visible) || boxes[0];
             if (!box) return { ok: false, message: 'Could not find the tweet composer text area. Are you logged in?' };
-            const textToInsert = ${JSON.stringify(Q)};
+            const textToInsert = ${JSON.stringify(o)};
             const normalize = s => String(s || '').replace(/ /g, ' ').replace(/s+/g, ' ').trim();
             box.focus();
             if (!document.execCommand('insertText', false, textToInsert)) {
@@ -40,11 +40,11 @@ import*as R from"node:fs";import*as J from"node:path";import{cli as h,Strategy a
             if (normalize(actual).includes(normalize(textToInsert))) return { ok: true };
             return { ok: false, message: 'Could not verify tweet text in the composer after typing.', actualText: actual };
         } catch (e) { return { ok: false, message: String(e) }; }
-    })()`)}async function n(z,Q){const H=Math.ceil(D/N);return z.evaluate(`(async () => {
-        const expected = ${JSON.stringify(Q)};
+    })()`)}async function D(e,o){const t=Math.ceil(_/g);return e.evaluate(`(async () => {
+        const expected = ${JSON.stringify(o)};
         const visible = (el) => !!el && (el.offsetParent !== null || el.getClientRects().length > 0);
-        for (let i = 0; i < ${JSON.stringify(H)}; i++) {
-            await new Promise(r => setTimeout(r, ${JSON.stringify(N)}));
+        for (let i = 0; i < ${JSON.stringify(t)}; i++) {
+            await new Promise(r => setTimeout(r, ${JSON.stringify(g)}));
             const attachments = document.querySelector('[data-testid="attachments"]');
             const previewCount = Math.max(
                 attachments ? attachments.querySelectorAll('[role="group"], img, video').length : 0,
@@ -58,8 +58,8 @@ import*as R from"node:fs";import*as J from"node:path";import{cli as h,Strategy a
             const buttonReady = !!button && !button.disabled && button.getAttribute('aria-disabled') !== 'true';
             if (previewCount >= expected && buttonReady) return { ok: true, previewCount };
         }
-        return { ok: false, message: 'Image upload timed out (${D/1000}s).' };
-    })()`)}async function E(z,Q){const H=Math.ceil(y/v),Y=await z.evaluate(`(async () => {
+        return { ok: false, message: 'Image upload timed out (${_/1000}s).' };
+    })()`)}async function F(e,o){const t=Math.ceil(y/f),s=await e.evaluate(`(async () => {
         try {
             const visible = (el) => !!el && (el.offsetParent !== null || el.getClientRects().length > 0);
             // For text-only posts the Tweet button only becomes enabled once
@@ -68,18 +68,18 @@ import*as R from"node:fs";import*as J from"node:path";import{cli as h,Strategy a
             // slow renders with "Tweet button is disabled or not found." Poll for
             // a visible, enabled button before clicking.
             let btn;
-            for (let i = 0; i < ${JSON.stringify(H)}; i++) {
+            for (let i = 0; i < ${JSON.stringify(t)}; i++) {
                 const buttons = Array.from(document.querySelectorAll('[data-testid="tweetButtonInline"], [data-testid="tweetButton"]'));
                 btn = buttons.find((el) => visible(el) && !el.disabled && el.getAttribute('aria-disabled') !== 'true');
                 if (btn) break;
-                await new Promise(r => setTimeout(r, ${JSON.stringify(v)}));
+                await new Promise(r => setTimeout(r, ${JSON.stringify(f)}));
             }
             if (!btn) return { ok: false, message: 'Tweet button is disabled or not found.' };
             btn.click();
             return { ok: true };
         } catch (e) { return { ok: false, message: String(e) }; }
-    })()`);if(!Y?.ok)return Y;const $=Math.ceil(y/v);return z.evaluate(`(async () => {
-        const expected = ${JSON.stringify(Q)};
+    })()`);if(!s?.ok)return s;const n=Math.ceil(y/f);return e.evaluate(`(async () => {
+        const expected = ${JSON.stringify(o)};
         const normalize = s => String(s || '').replace(/ /g, ' ').replace(/s+/g, ' ').trim();
         const expectedText = normalize(expected);
         const visible = (el) => !!el && (el.offsetParent !== null || el.getClientRects().length > 0);
@@ -96,8 +96,8 @@ import*as R from"node:fs";import*as J from"node:path";import{cli as h,Strategy a
             }
             return {};
         };
-        for (let i = 0; i < ${JSON.stringify($)}; i++) {
-            await new Promise(r => setTimeout(r, ${JSON.stringify(v)}));
+        for (let i = 0; i < ${JSON.stringify(n)}; i++) {
+            await new Promise(r => setTimeout(r, ${JSON.stringify(f)}));
             const toasts = Array.from(document.querySelectorAll('[role="alert"], [data-testid="toast"]'))
                 .filter((el) => visible(el));
             const successToast = toasts.find((el) => /sent|posted|your post was sent|your tweet was sent/i.test(el.textContent || ''));
@@ -117,15 +117,15 @@ import*as R from"node:fs";import*as J from"node:path";import{cli as h,Strategy a
             }
         }
         return { ok: false, message: 'Tweet submission did not complete before timeout.' };
-    })()`)}function k(z){const Q=Array.isArray(z?.errors)?z.errors:[];if(Q.length===0)return"";return Q.map((H)=>H?.message||JSON.stringify(H)).filter(Boolean).join("; ").slice(0,300)}function g(z){const Q=z?.data?.create_tweet?.tweet_results?.result,H=Q?.tweet||Q;if(!H||typeof H!=="object")return null;const Y=String(H.rest_id||H.legacy?.id_str||"").trim();if(!/^\d+$/.test(Y))return null;const $=H.core?.user_results?.result,Z=String($?.core?.screen_name||$?.legacy?.screen_name||"").trim();return{id:Y,url:Z?`https://x.com/${Z}/status/${Y}`:`https://x.com/i/status/${Y}`}}async function u(z,Q){await z.goto(M,{waitUntil:"load",settleMs:1000});const Y=(await z.getCookies({url:"https://x.com"})).find((G)=>G.name==="ct0")?.value||null;if(!Y)throw new j("x.com","Not logged into x.com (no ct0 cookie)");const $=await w(z,"CreateTweet",x),Z={variables:{tweet_text:Q,dark_request:!1,media:{media_entities:[],possibly_sensitive:!1},semantic_annotation_ids:[]},features:$.features,queryId:$.queryId};if($.fieldToggles&&Object.keys($.fieldToggles).length>0)Z.fieldToggles=$.fieldToggles;const F=JSON.stringify({Authorization:`Bearer ${decodeURIComponent(L)}`,"X-Csrf-Token":Y,"X-Twitter-Auth-Type":"OAuth2Session","X-Twitter-Active-User":"yes","Content-Type":"application/json"}),V=`/i/api/graphql/${$.queryId}/CreateTweet`,K=JSON.stringify(Z),W=I(await z.evaluate(`async () => {
-        const r = await fetch(${JSON.stringify(V)}, {
+    })()`)}function T(e){const o=Array.isArray(e?.errors)?e.errors:[];if(o.length===0)return"";return o.map((t)=>t?.message||JSON.stringify(t)).filter(Boolean).join("; ").slice(0,300)}function X(e){const o=e?.data?.create_tweet?.tweet_results?.result,t=o?.tweet||o;if(!t||typeof t!=="object")return null;const s=String(t.rest_id||t.legacy?.id_str||"").trim();if(!/^\d+$/.test(s))return null;const n=t.core?.user_results?.result,r=String(n?.core?.screen_name||n?.legacy?.screen_name||"").trim();return{id:s,url:r?`https://x.com/${r}/status/${s}`:`https://x.com/i/status/${s}`}}async function H(e,o){await e.goto(M,{waitUntil:"load",settleMs:1000});const s=(await e.getCookies({url:"https://x.com"})).find((d)=>d.name==="ct0")?.value||null;if(!s)throw new w("x.com","Not logged into x.com (no ct0 cookie)");const n=await A(e,"CreateTweet",U),r={variables:{tweet_text:o,dark_request:!1,media:{media_entities:[],possibly_sensitive:!1},semantic_annotation_ids:[]},features:n.features,queryId:n.queryId};if(n.fieldToggles&&Object.keys(n.fieldToggles).length>0)r.fieldToggles=n.fieldToggles;const u=JSON.stringify({Authorization:`Bearer ${decodeURIComponent(E)}`,"X-Csrf-Token":s,"X-Twitter-Auth-Type":"OAuth2Session","X-Twitter-Active-User":"yes","Content-Type":"application/json"}),i=`/i/api/graphql/${n.queryId}/CreateTweet`,a=JSON.stringify(r),l=O(await e.evaluate(`async () => {
+        const r = await fetch(${JSON.stringify(i)}, {
             method: 'POST',
-            headers: ${F},
+            headers: ${u},
             credentials: 'include',
-            body: ${JSON.stringify(K)},
+            body: ${JSON.stringify(a)},
         });
         const bodyText = await r.text();
         let bodyJson = null;
         try { bodyJson = JSON.parse(bodyText); } catch {}
         return { ok: r.ok, httpStatus: r.status, bodyJson, bodyText };
-    }`));if(W?.httpStatus===401||W?.httpStatus===403)throw new j("x.com",`Twitter CreateTweet returned HTTP ${W.httpStatus}`);if(!W?.ok){const G=k(W?.bodyJson);return{ok:!1,message:U("CreateTweet",W?.httpStatus??0,G||void 0)}}const X=g(W.bodyJson);if(!X){const G=k(W.bodyJson);return{ok:!1,message:G?`CreateTweet failed: ${G}`:"CreateTweet returned no created tweet id."}}return{ok:!0,message:"Tweet posted successfully.",...X}}h({site:"twitter",name:"post",access:"write",description:"Post a new tweet/thread",domain:"x.com",strategy:C.UI,browser:!0,args:[{name:"text",fromFile:!0,type:"string",required:!0,positional:!0,help:"The text content of the tweet"},{name:"images",type:"string",required:!1,help:"Image paths, comma-separated, max 4 (jpg/png/gif/webp)"}],columns:["status","message","text","id","url"],func:async(z,Q)=>{if(!z)throw new q("Browser session required for twitter post");const H=Q.images?c(String(Q.images)):[],Y=String(Q.text??"");P(Y,{label:"推文内容"});try{await z.goto(S,{waitUntil:"load",settleMs:2500});await z.wait({selector:'[data-testid="tweetTextarea_0"]',timeout:15})}catch(V){if(H.length>0)throw V;const K=await u(z,Y);if(!K?.ok)throw new q(K?.message??"Tweet failed to post.");return[{status:"success",message:K?.message??"Tweet posted.",text:Y,...K?.id?{id:K.id}:{},...K?.url?{url:K.url}:{}}]}if(H.length>0){await z.wait({selector:A,timeout:20});await b(z,A,H);const V=await n(z,H.length);if(!V?.ok)throw new q(V?.message??`Image upload timed out (${D/1000}s).`)}const $=await l(z,Y);if(!$?.ok)throw new q($?.message??"Could not type tweet text.");await z.wait(1);let Z=null,F=null;try{Z=await E(z,Y)}catch(V){F=V}if(!Z?.ok){const{confirmTweetByReadback:V}=await import("./tweets.js"),K=await V(z,Y);if(K.found)return[{status:"success",message:"提交回执未确认（可能超时），但发后回查已在时间线确认发布成功，请勿重发。",text:Y,...K.id?{id:K.id}:{},...K.url?{url:K.url}:{},confirmed_by:"readback"}];const W=F?String(F&&F.message||F):Z?.message??"Tweet was not confirmed sent.",X=K.error?`发后回查失败（${K.error}）——无法确认，重试前请先人工核对时间线`:`发后回查已检查最近 ${K.checked} 条推文，未发现该内容，可安全重试`;throw new q(`${W}；${X}`)}return[{status:"success",message:Z?.message??"Tweet posted.",text:Y,...Z?.id?{id:Z.id}:{},...Z?.url?{url:Z.url}:{}}]}});
+    }`));if(l?.httpStatus===401||l?.httpStatus===403)throw new w("x.com",`Twitter CreateTweet returned HTTP ${l.httpStatus}`);if(!l?.ok){const d=T(l?.bodyJson);return{ok:!1,message:C("CreateTweet",l?.httpStatus??0,d||void 0)}}const m=X(l.bodyJson);if(!m){const d=T(l.bodyJson);return{ok:!1,message:d?`CreateTweet failed: ${d}`:"CreateTweet returned no created tweet id."}}return{ok:!0,message:"Tweet posted successfully.",...m}}v({site:"twitter",name:"post",access:"write",description:"Post a new tweet/thread",domain:"x.com",strategy:k.UI,browser:!0,args:[{name:"text",fromFile:!0,type:"string",required:!0,positional:!0,help:"The text content of the tweet"},{name:"images",type:"string",required:!1,help:"Image paths, comma-separated, max 4 (jpg/png/gif/webp)"}],columns:["status","message","text","id","url"],func:async(e,o)=>{if(!e)throw new c("Browser session required for twitter post");const t=o.images?J(String(o.images)):[],s=String(o.text??"");I(s,{label:"推文内容"});try{await e.goto(N,{waitUntil:"load",settleMs:2500});await e.wait({selector:'[data-testid="tweetTextarea_0"]',timeout:15})}catch(i){if(t.length>0)throw i;const a=await H(e,s);if(!a?.ok)throw new c(a?.message??"Tweet failed to post.");return[{status:"success",message:a?.message??"Tweet posted.",text:s,...a?.id?{id:a.id}:{},...a?.url?{url:a.url}:{}}]}if(t.length>0){await e.wait({selector:x,timeout:20});await P(e,x,t);const i=await D(e,t.length);if(!i?.ok)throw new c(i?.message??`Image upload timed out (${_/1000}s).`)}const n=await j(e,s);if(!n?.ok)throw new c(n?.message??"Could not type tweet text.");await e.wait(1);let r=null,u=null;try{r=await F(e,s)}catch(i){u=i}if(!r?.ok){const{confirmTweetByReadback:i}=await import("./tweets.js"),a=await i(e,s);if(a.found)return[{status:"success",message:"提交回执未确认（可能超时），但发后回查已在时间线确认发布成功，请勿重发。",text:s,...a.id?{id:a.id}:{},...a.url?{url:a.url}:{},confirmed_by:"readback"}];const l=u?String(u&&u.message||u):r?.message??"Tweet was not confirmed sent.",m=a.error?`发后回查失败（${a.error}）——无法确认，重试前请先人工核对时间线`:`发后回查已检查最近 ${a.checked} 条推文，未发现该内容，可安全重试`;throw new c(`${l}；${m}`)}return[{status:"success",message:r?.message??"Tweet posted.",text:s,...r?.id?{id:r.id}:{},...r?.url?{url:r.url}:{}}]}});

package/clis/twitter/profile.js

@@ -1,12 +1,12 @@
-import{ArgumentError as k,AuthRequiredError as z,CommandExecutionError as M,EmptyResultError as B}from"@jackwener/opencli/errors";import{cli as I,Strategy as q}from"@jackwener/opencli/registry";import{describeTwitterApiError as U,normalizeTwitterScreenName as Q,resolveTwitterQueryId as b,unwrapBrowserResult as Y}from"./shared.js";import{TWITTER_BEARER_TOKEN as x}from"./utils.js";const S="IGgvgiOx4QZndDHuD3x9TQ";function W(G){return G!=null&&typeof G==="object"&&!Array.isArray(G)}function H(G){return typeof G==="string"?G:""}export function mapTwitterProfileResult(G,J){if(!W(G))throw new M(`Twitter profile response for @${J} is malformed`);const K=W(G.legacy),Z=W(G.core);if(!K&&!Z)throw new M(`Twitter profile response for @${J} is missing profile fields`);const V=K?G.legacy:{},$=Z?G.core:{};if(!H($.screen_name)&&!H(V.screen_name)&&!H($.name)&&!H(V.name)&&!H($.created_at)&&!H(V.created_at))throw new M(`Twitter profile response for @${J} is missing profile identity fields`);const L=W(G.location)?G.location:{},X=V.entities?.url?.urls?.[0]?.expanded_url||"";return[{screen_name:H($.screen_name)||H(V.screen_name)||J,name:H($.name)||H(V.name),bio:H(V.description),location:H(L.location)||H(V.location),url:H(X),followers:V.followers_count||0,following:V.friends_count||0,tweets:V.statuses_count||0,likes:V.favourites_count||0,verified:Boolean(G.is_blue_verified||V.verified),created_at:H($.created_at)||H(V.created_at)}]}I({site:"twitter",name:"profile",access:"read",description:"Fetch a Twitter user profile — bio, stats, etc. (defaults to the logged-in user when no username is given)",domain:"x.com",strategy:q.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."}],columns:["screen_name","name","bio","location","url","followers","following","tweets","likes","verified","created_at"],func:async(G,J)=>{const K=String(J.username??"").trim();let Z=Q(K);if(K&&!Z)throw new k("twitter profile username must be a valid Twitter/X handle","Example: ppcli twitter profile @jack");if(!Z){await G.goto("https://x.com/home");await G.wait({selector:'[data-testid="primaryColumn"]'});const D=Y(await G.evaluate(`() => {
+import{ArgumentError as m,AuthRequiredError as f,CommandExecutionError as c,EmptyResultError as w}from"@jackwener/opencli/errors";import{cli as h,Strategy as g}from"@jackwener/opencli/registry";import{describeTwitterApiError as b,normalizeTwitterScreenName as _,resolveTwitterQueryId as y,unwrapBrowserResult as p}from"./shared.js";import{TWITTER_BEARER_TOKEN as v}from"./utils.js";const T="IGgvgiOx4QZndDHuD3x9TQ";function u(e){return e!=null&&typeof e==="object"&&!Array.isArray(e)}function t(e){return typeof e==="string"?e:""}export function mapTwitterProfileResult(e,a){if(!u(e))throw new c(`Twitter profile response for @${a} is malformed`);const l=u(e.legacy),o=u(e.core);if(!l&&!o)throw new c(`Twitter profile response for @${a} is missing profile fields`);const r=l?e.legacy:{},n=o?e.core:{};if(!t(n.screen_name)&&!t(r.screen_name)&&!t(n.name)&&!t(r.name)&&!t(n.created_at)&&!t(r.created_at))throw new c(`Twitter profile response for @${a} is missing profile identity fields`);const d=u(e.location)?e.location:{},i=r.entities?.url?.urls?.[0]?.expanded_url||"";return[{screen_name:t(n.screen_name)||t(r.screen_name)||a,name:t(n.name)||t(r.name),bio:t(r.description),location:t(d.location)||t(r.location),url:t(i),followers:r.followers_count||0,following:r.friends_count||0,tweets:r.statuses_count||0,likes:r.favourites_count||0,verified:Boolean(e.is_blue_verified||r.verified),created_at:t(n.created_at)||t(r.created_at)}]}h({site:"twitter",name:"profile",access:"read",description:"Fetch a Twitter user profile — bio, stats, etc. (defaults to the logged-in user when no username is given)",domain:"x.com",strategy:g.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."}],columns:["screen_name","name","bio","location","url","followers","following","tweets","likes","verified","created_at"],func:async(e,a)=>{const l=String(a.username??"").trim();let o=_(l);if(l&&!o)throw new m("twitter profile username must be a valid Twitter/X handle","Example: ppcli twitter profile @jack");if(!o){await e.goto("https://x.com/home");await e.wait({selector:'[data-testid="primaryColumn"]'});const s=p(await e.evaluate(`() => {
         const link = document.querySelector('a[data-testid="AppTabBar_Profile_Link"]');
         return link ? link.getAttribute('href') : null;
-      }`));if(!D||typeof D!=="string")throw new z("x.com","Could not detect logged-in user. Are you logged in?");Z=Q(D);if(!Z)throw new z("x.com","Could not detect logged-in user. Are you logged in?")}await G.goto(`https://x.com/${Z}`);await G.wait(3);const $=(await G.getCookies({url:"https://x.com"})).find((D)=>D.name==="ct0")?.value||null;if(!$)throw new z("x.com","Not logged into x.com (no ct0 cookie)");const L=await b(G,"UserByScreenName",S),X=Y(await G.evaluate(`
+      }`));if(!s||typeof s!=="string")throw new f("x.com","Could not detect logged-in user. Are you logged in?");o=_(s);if(!o)throw new f("x.com","Could not detect logged-in user. Are you logged in?")}await e.goto(`https://x.com/${o}`);await e.wait(3);const n=(await e.getCookies({url:"https://x.com"})).find((s)=>s.name==="ct0")?.value||null;if(!n)throw new f("x.com","Not logged into x.com (no ct0 cookie)");const d=await y(e,"UserByScreenName",T),i=p(await e.evaluate(`
       async () => {
-        const screenName = ${JSON.stringify(Z)};
-        const ct0 = ${JSON.stringify($)};
+        const screenName = ${JSON.stringify(o)};
+        const ct0 = ${JSON.stringify(n)};
 
-        const bearer = ${JSON.stringify(x)};
+        const bearer = ${JSON.stringify(v)};
         const headers = {
           'Authorization': 'Bearer ' + decodeURIComponent(bearer),
           'X-Csrf-Token': ct0,
@@ -33,7 +33,7 @@ import{ArgumentError as k,AuthRequiredError as z,CommandExecutionError as M,Empt
           responsive_web_graphql_timeline_navigation_enabled: true,
         });
 
-        const url = '/i/api/graphql/' + ${JSON.stringify(L)} + '/UserByScreenName?variables='
+        const url = '/i/api/graphql/' + ${JSON.stringify(d)} + '/UserByScreenName?variables='
           + encodeURIComponent(variables)
           + '&features=' + encodeURIComponent(features);
 
@@ -63,4 +63,4 @@ import{ArgumentError as k,AuthRequiredError as z,CommandExecutionError as M,Empt
         if (!result) return {ok: false, notFound: true, error: 'User @' + screenName + ' not found'};
         return {ok: true, result};
       }
-    `));if(!W(X))throw new M("Twitter profile response payload is malformed");if(!X.ok){const D=typeof X.httpStatus==="number"?U("UserByScreenName",X.httpStatus,X.hint):X.error+(X.hint?` (${X.hint})`:"");if(X.auth)throw new z("x.com",D);if(X.notFound)throw new B("twitter profile",D);throw new M(D)}return mapTwitterProfileResult(X.result,Z)}});export const __test__={mapTwitterProfileResult};
+    `));if(!u(i))throw new c("Twitter profile response payload is malformed");if(!i.ok){const s=typeof i.httpStatus==="number"?b("UserByScreenName",i.httpStatus,i.hint):i.error+(i.hint?` (${i.hint})`:"");if(i.auth)throw new f("x.com",s);if(i.notFound)throw new w("twitter profile",s);throw new c(s)}return mapTwitterProfileResult(i.result,o)}});export const __test__={mapTwitterProfileResult};

package/clis/twitter/quote.js

@@ -1,6 +1,6 @@
-import*as Z from"node:fs";import{CommandExecutionError as J}from"@jackwener/opencli/errors";import{cli as $,Strategy as f}from"@jackwener/opencli/registry";import{parseTweetUrl as K,buildTwitterArticleScopeSource as V}from"./shared.js";import{COMPOSER_FILE_INPUT_SELECTOR as W,attachComposerImage as X,downloadRemoteImage as y,resolveImagePath as A}from"./utils.js";function N(q){const j=K(q);return`https://x.com/compose/post?url=${encodeURIComponent(j.url)}`}async function D(q,j){await q.goto(j.url,{waitUntil:"load",settleMs:2500});await q.wait({selector:'[data-testid="primaryColumn"]',timeout:15});const v=await q.evaluate(`(async () => {
+import*as f from"node:fs";import{CommandExecutionError as n}from"@jackwener/opencli/errors";import{cli as w,Strategy as p}from"@jackwener/opencli/registry";import{parseTweetUrl as l,buildTwitterArticleScopeSource as u}from"./shared.js";import{COMPOSER_FILE_INPUT_SELECTOR as m,attachComposerImage as c,downloadRemoteImage as b,resolveImagePath as x}from"./utils.js";function h(t){const e=l(t);return`https://x.com/compose/post?url=${encodeURIComponent(e.url)}`}async function g(t,e){await t.goto(e.url,{waitUntil:"load",settleMs:2500});await t.wait({selector:'[data-testid="primaryColumn"]',timeout:15});const o=await t.evaluate(`(async () => {
         try {
-            ${V(j.id)}
+            ${u(e.id)}
             const visible = (el) => !!el && (el.offsetParent !== null || el.getClientRects().length > 0);
             let retweetBtn = null;
             let targetArticle = null;
@@ -30,9 +30,9 @@ import*as Z from"node:fs";import{CommandExecutionError as J}from"@jackwener/open
         } catch (e) {
             return { ok: false, message: e.toString() };
         }
-    })()`);if(!v?.ok)return v;await q.wait({selector:'[data-testid="tweetTextarea_0"]',timeout:15});return{ok:!0}}async function Y(q,j,v,{allowMenuFallback:z=!0}={}){return q.evaluate(`(async () => {
+    })()`);if(!o?.ok)return o;await t.wait({selector:'[data-testid="tweetTextarea_0"]',timeout:15});return{ok:!0}}async function d(t,e,o,{allowMenuFallback:r=!0}={}){return t.evaluate(`(async () => {
         try {
-            ${V(v.id)}
+            ${u(o.id)}
             const visible = (el) => !!el && (el.offsetParent !== null || el.getClientRects().length > 0);
             const normalize = s => String(s || '').replace(/\\u00a0/g, ' ').replace(/\\s+/g, ' ').trim();
             const insertTextIntoBox = async (box, value) => {
@@ -57,7 +57,7 @@ import*as Z from"node:fs";import{CommandExecutionError as J}from"@jackwener/open
                 return { ok: false, message: 'Could not find the quote composer text area. Are you logged in?' };
             }
 
-            const textToInsert = ${JSON.stringify(j)};
+            const textToInsert = ${JSON.stringify(e)};
             if (!(await insertTextIntoBox(box, textToInsert))) {
                 return { ok: false, message: 'Could not verify quote text in the composer after typing.' };
             }
@@ -78,7 +78,7 @@ import*as Z from"node:fs";import{CommandExecutionError as J}from"@jackwener/open
                 cardAttempts++;
             }
             if (!hasQuoteCard) {
-                const allowMenuFallback = ${JSON.stringify(z)};
+                const allowMenuFallback = ${JSON.stringify(r)};
                 if (allowMenuFallback) {
                     return { ok: false, retryWithMenuFallback: true, message: 'Quote target did not render in the dedicated composer; retrying through the repost menu.' };
                 }
@@ -120,4 +120,4 @@ import*as Z from"node:fs";import{CommandExecutionError as J}from"@jackwener/open
         } catch (e) {
             return { ok: false, message: e.toString() };
         }
-    })()`)}$({site:"twitter",name:"quote",access:"write",description:"Quote-tweet a specific tweet with your own text, optionally with a local or remote image",domain:"x.com",strategy:f.UI,browser:!0,args:[{name:"url",type:"string",required:!0,positional:!0,help:"The URL of the tweet to quote"},{name:"text",fromFile:!0,type:"string",required:!0,positional:!0,help:"The text content of your quote"},{name:"image",help:"Optional local image path to attach to the quote tweet"},{name:"image-url",help:"Optional remote image URL to download and attach to the quote tweet"}],columns:["status","message","text"],func:async(q,j)=>{if(!q)throw new J("Browser session required for twitter quote");if(j.image&&j["image-url"])throw new J("Use either --image or --image-url, not both.");const v=K(j.url);let z,H;try{if(j.image)z=A(j.image);else if(j["image-url"]){const G=await y(j["image-url"]);z=G.absPath;H=G.cleanupDir}await q.goto(`https://x.com/compose/post?url=${encodeURIComponent(v.url)}`,{waitUntil:"load",settleMs:2500});await q.wait({selector:'[data-testid="tweetTextarea_0"]',timeout:15});if(z){await q.wait({selector:W,timeout:20});await X(q,z)}let B=await Y(q,j.text,v);if(B.retryWithMenuFallback){const G=await D(q,v);if(!G?.ok)return[{status:"failed",message:G?.message??"Could not open quote composer from repost menu.",text:j.text}];if(z){await q.wait({selector:W,timeout:20});await X(q,z)}B=await Y(q,j.text,v,{allowMenuFallback:!1})}if(B.ok)await q.wait(3);return[{status:B.ok?"success":"failed",message:B.message,text:j.text,...j.image?{image:j.image}:{},...j["image-url"]?{"image-url":j["image-url"]}:{}}]}finally{if(H)Z.rmSync(H,{recursive:!0,force:!0})}}});export const __test__={buildQuoteComposerUrl:N};
+    })()`)}w({site:"twitter",name:"quote",access:"write",description:"Quote-tweet a specific tweet with your own text, optionally with a local or remote image",domain:"x.com",strategy:p.UI,browser:!0,args:[{name:"url",type:"string",required:!0,positional:!0,help:"The URL of the tweet to quote"},{name:"text",fromFile:!0,type:"string",required:!0,positional:!0,help:"The text content of your quote"},{name:"image",help:"Optional local image path to attach to the quote tweet"},{name:"image-url",help:"Optional remote image URL to download and attach to the quote tweet"}],columns:["status","message","text"],func:async(t,e)=>{if(!t)throw new n("Browser session required for twitter quote");if(e.image&&e["image-url"])throw new n("Use either --image or --image-url, not both.");const o=l(e.url);let r,s;try{if(e.image)r=x(e.image);else if(e["image-url"]){const i=await b(e["image-url"]);r=i.absPath;s=i.cleanupDir}await t.goto(`https://x.com/compose/post?url=${encodeURIComponent(o.url)}`,{waitUntil:"load",settleMs:2500});await t.wait({selector:'[data-testid="tweetTextarea_0"]',timeout:15});if(r){await t.wait({selector:m,timeout:20});await c(t,r)}let a=await d(t,e.text,o);if(a.retryWithMenuFallback){const i=await g(t,o);if(!i?.ok)return[{status:"failed",message:i?.message??"Could not open quote composer from repost menu.",text:e.text}];if(r){await t.wait({selector:m,timeout:20});await c(t,r)}a=await d(t,e.text,o,{allowMenuFallback:!1})}if(a.ok)await t.wait(3);return[{status:a.ok?"success":"failed",message:a.message,text:e.text,...e.image?{image:e.image}:{},...e["image-url"]?{"image-url":e["image-url"]}:{}}]}finally{if(s)f.rmSync(s,{recursive:!0,force:!0})}}});export const __test__={buildQuoteComposerUrl:h};

package/clis/twitter/reply-dm.js

@@ -1,4 +1,4 @@
-import{CommandExecutionError as N}from"@jackwener/opencli/errors";import{cli as O,Strategy as P}from"@jackwener/opencli/registry";import{assertLiteralContent as Q}from"../_shared/content-guard.js";O({site:"twitter",name:"reply-dm",access:"write",description:"Send a message to recent DM conversations",domain:"x.com",strategy:P.UI,browser:!0,args:[{name:"text",fromFile:!0,type:"string",required:!0,positional:!0,help:'Message text to send (e.g. "我的微信 wxkabi")'},{name:"max",type:"int",required:!1,default:20,help:"Maximum number of conversations to reply to (default: 20)"},{name:"skip-replied",type:"boolean",required:!1,default:!0,help:"Skip conversations where you already sent the same text (default: true)"},{name:"timeout",type:"int",required:!1,default:600,help:"Max seconds for the overall command (default: 600 — batch op)"}],columns:["index","status","user","message"],func:async(b,A)=>{if(!b)throw new N("Browser session required for twitter reply-dm");const F=A.text;Q(F,{label:"私信内容"});const G=A.max??20,J=A["skip-replied"]!==!1,f=[];let B=0;await b.goto("https://x.com/messages");await b.wait({selector:'[data-testid="primaryColumn"]'});const K=G+10,D=await b.evaluate(`(async () => {
+import{CommandExecutionError as f}from"@jackwener/opencli/errors";import{cli as p,Strategy as h}from"@jackwener/opencli/registry";import{assertLiteralContent as w}from"../_shared/content-guard.js";p({site:"twitter",name:"reply-dm",access:"write",description:"Send a message to recent DM conversations",domain:"x.com",strategy:h.UI,browser:!0,args:[{name:"text",fromFile:!0,type:"string",required:!0,positional:!0,help:'Message text to send (e.g. "我的微信 wxkabi")'},{name:"max",type:"int",required:!1,default:20,help:"Maximum number of conversations to reply to (default: 20)"},{name:"skip-replied",type:"boolean",required:!1,default:!0,help:"Skip conversations where you already sent the same text (default: true)"},{name:"timeout",type:"int",required:!1,default:600,help:"Max seconds for the overall command (default: 600 — batch op)"}],columns:["index","status","user","message"],func:async(e,r)=>{if(!e)throw new f("Browser session required for twitter reply-dm");const i=r.text;w(i,{label:"私信内容"});const c=r.max??20,l=r["skip-replied"]!==!1,t=[];let o=0;await e.goto("https://x.com/messages");await e.wait({selector:'[data-testid="primaryColumn"]'});const d=c+10,a=await e.evaluate(`(async () => {
       try {
         // Wait for initial items
         let attempts = 0;
@@ -10,7 +10,7 @@ import{CommandExecutionError as N}from"@jackwener/opencli/errors";import{cli as
         }
 
         // Scroll to load more conversations
-        const needed = ${K};
+        const needed = ${d};
         const seenIds = new Set();
         let noNewCount = 0;
 
@@ -63,16 +63,16 @@ import{CommandExecutionError as N}from"@jackwener/opencli/errors";import{cli as
       } catch(e) {
         return { ok: false, error: String(e), conversations: [], total: 0 };
       }
-    })()`);if(!D?.ok||!D.conversations?.length)return[{index:1,status:"info",user:"System",message:"No conversations found"}];const M=D.conversations;for(const q of M){if(B>=G)break;const H=q.convId?`https://x.com/messages/${q.convId}`:q.href;if(!H)continue;await b.goto(H);await b.wait(3);const z=await b.evaluate(`(async () => {
+    })()`);if(!a?.ok||!a.conversations?.length)return[{index:1,status:"info",user:"System",message:"No conversations found"}];const u=a.conversations;for(const s of u){if(o>=c)break;const m=s.convId?`https://x.com/messages/${s.convId}`:s.href;if(!m)continue;await e.goto(m);await e.wait(3);const n=await e.evaluate(`(async () => {
         try {
-          const messageText = ${JSON.stringify(F)};
-          const skipReplied = ${J};
+          const messageText = ${JSON.stringify(i)};
+          const skipReplied = ${l};
 
           // Get username from conversation
           const dmHeader = document.querySelector('[data-testid="DmActivityContainer"] [dir="ltr"] span') ||
                            document.querySelector('[data-testid="conversation-header"]') ||
                            document.querySelector('[data-testid="DmActivityContainer"] h2');
-          const username = dmHeader ? dmHeader.innerText.trim().split('\\\\n')[0] : '${q.user}';
+          const username = dmHeader ? dmHeader.innerText.trim().split('\\\\n')[0] : '${s.user}';
 
           // Check if we already sent this message
           if (skipReplied) {
@@ -109,4 +109,4 @@ import{CommandExecutionError as N}from"@jackwener/opencli/errors";import{cli as
         } catch(e) {
           return { status: 'error', user: 'system', message: String(e) };
         }
-      })()`);if(z?.status==="sent"){B++;f.push({index:B,status:"sent",user:z.user||q.user,message:z.message})}else if(z?.status==="skipped")f.push({index:f.length+1,status:"skipped",user:z.user||q.user,message:z.message});await b.wait(1)}if(f.length===0)f.push({index:0,status:"info",user:"System",message:"No conversations processed"});return f}});
+      })()`);if(n?.status==="sent"){o++;t.push({index:o,status:"sent",user:n.user||s.user,message:n.message})}else if(n?.status==="skipped")t.push({index:t.length+1,status:"skipped",user:n.user||s.user,message:n.message});await e.wait(1)}if(t.length===0)t.push({index:0,status:"info",user:"System",message:"No conversations processed"});return t}});

package/clis/twitter/reply.js

@@ -1,11 +1,11 @@
-import*as W from"node:fs";import*as D from"node:path";import{CommandExecutionError as J}from"@jackwener/opencli/errors";import{cli as f,Strategy as F}from"@jackwener/opencli/registry";import{parseTweetUrl as j}from"./shared.js";import{assertLiteralContent as b}from"../_shared/content-guard.js";import{COMPOSER_FILE_INPUT_SELECTOR as B,attachComposerImage as L,downloadRemoteImage as h,resolveImagePath as O}from"./utils.js";const Z='[data-testid="tweetTextarea_0"]',V=500,$=15000;function N(z){return`https://x.com/compose/post?in_reply_to=${j(z).id}`}function X(z){return(z instanceof Error?z.message:String(z)).includes("Promise was collected")}async function y(z,q){await z.goto(N(q),{waitUntil:"load",settleMs:2500});try{await z.wait({selector:Z,timeout:15});return{ok:!0}}catch{await z.goto(q,{waitUntil:"load",settleMs:2500});const A=await z.evaluate(`(() => {
+import*as c from"node:fs";import*as b from"node:path";import{CommandExecutionError as i}from"@jackwener/opencli/errors";import{cli as x,Strategy as w}from"@jackwener/opencli/registry";import{parseTweetUrl as h}from"./shared.js";import{assertLiteralContent as g}from"../_shared/content-guard.js";import{COMPOSER_FILE_INPUT_SELECTOR as T,attachComposerImage as S,downloadRemoteImage as C,resolveImagePath as v}from"./utils.js";const m='[data-testid="tweetTextarea_0"]',a=500,d=15000;function y(t){return`https://x.com/compose/post?in_reply_to=${h(t).id}`}function u(t){return(t instanceof Error?t.message:String(t)).includes("Promise was collected")}async function R(t,e){await t.goto(y(e),{waitUntil:"load",settleMs:2500});try{await t.wait({selector:m,timeout:15});return{ok:!0}}catch{await t.goto(e,{waitUntil:"load",settleMs:2500});const o=await t.evaluate(`(() => {
             const visible = (el) => !!el && (el.offsetParent !== null || el.getClientRects().length > 0);
             const buttons = Array.from(document.querySelectorAll('[data-testid="reply"]'));
             const btn = buttons.find((el) => visible(el) && !el.disabled && el.getAttribute('aria-disabled') !== 'true');
             if (!btn) return { ok: false, message: 'Could not find the reply button on the target tweet.' };
             btn.click();
             return { ok: true };
-        })()`);if(!A?.ok)return A;await z.wait({selector:Z,timeout:15});return{ok:!0}}}async function v(z,q){return z.evaluate(`(async () => {
+        })()`);if(!o?.ok)return o;await t.wait({selector:m,timeout:15});return{ok:!0}}}async function p(t,e){return t.evaluate(`(async () => {
       try {
           const visible = (el) => !!el && (el.offsetParent !== null || el.getClientRects().length > 0);
           const boxes = Array.from(document.querySelectorAll('[data-testid="tweetTextarea_0"]'));
@@ -15,7 +15,7 @@ import*as W from"node:fs";import*as D from"node:path";import{CommandExecutionErr
           }
 
           box.focus();
-          const textToInsert = ${JSON.stringify(q)};
+          const textToInsert = ${JSON.stringify(e)};
           // execCommand('insertText') is more reliable with Twitter's Draft.js editor
           if (!document.execCommand('insertText', false, textToInsert)) {
               // Fallback to paste event if execCommand fails
@@ -38,10 +38,10 @@ import*as W from"node:fs";import*as D from"node:path";import{CommandExecutionErr
       } catch (e) {
           return { ok: false, message: e.toString() };
       }
-  })()`)}async function R(z){const q=Math.ceil($/V);return z.evaluate(`(async () => {
+  })()`)}async function k(t){const e=Math.ceil(d/a);return t.evaluate(`(async () => {
       try {
           const visible = (el) => !!el && (el.offsetParent !== null || el.getClientRects().length > 0);
-          for (let i = 0; i < ${JSON.stringify(q)}; i++) {
+          for (let i = 0; i < ${JSON.stringify(e)}; i++) {
               const buttons = Array.from(
                   document.querySelectorAll('[data-testid="tweetButton"], [data-testid="tweetButtonInline"]')
               );
@@ -50,13 +50,13 @@ import*as W from"node:fs";import*as D from"node:path";import{CommandExecutionErr
                   btn.click();
                   return { ok: true };
               }
-              await new Promise(r => setTimeout(r, ${JSON.stringify(V)}));
+              await new Promise(r => setTimeout(r, ${JSON.stringify(a)}));
           }
           return { ok: false, message: 'Reply button is disabled or not found.' };
       } catch (e) {
           return { ok: false, message: e.toString() };
       }
-  })()`)}async function I(z){return z.evaluate(`(() => {
+  })()`)}async function P(t){return t.evaluate(`(() => {
         const visible = (el) => !!el && (el.offsetParent !== null || el.getClientRects().length > 0);
         const toasts = Array.from(document.querySelectorAll('[role="alert"], [data-testid="toast"]'))
             .filter((el) => visible(el));
@@ -68,13 +68,13 @@ import*as W from"node:fs";import*as D from"node:path";import{CommandExecutionErr
             message: 'Reply posted successfully.',
             url: link?.href || link?.getAttribute('href') || undefined
         };
-    })()`)}async function M(z,q){const A=Math.ceil($/V);try{return await z.evaluate(`(async () => {
-            const expected = ${JSON.stringify(q)};
+    })()`)}async function _(t,e){const o=Math.ceil(d/a);try{return await t.evaluate(`(async () => {
+            const expected = ${JSON.stringify(e)};
             const normalize = s => String(s || '').replace(/\\u00a0/g, ' ').replace(/\\s+/g, ' ').trim();
             const expectedText = normalize(expected);
             const visible = (el) => !!el && (el.offsetParent !== null || el.getClientRects().length > 0);
-            for (let i = 0; i < ${JSON.stringify(A)}; i++) {
-                await new Promise(r => setTimeout(r, ${JSON.stringify(V)}));
+            for (let i = 0; i < ${JSON.stringify(o)}; i++) {
+                await new Promise(r => setTimeout(r, ${JSON.stringify(a)}));
                 const toasts = Array.from(document.querySelectorAll('[role="alert"], [data-testid="toast"]'))
                     .filter((el) => visible(el));
                 const successToast = toasts.find((el) => /sent|posted|your post was sent|your tweet was sent/i.test(el.textContent || ''));
@@ -94,4 +94,4 @@ import*as W from"node:fs";import*as D from"node:path";import{CommandExecutionErr
                 if (!composerStillHasText) return { ok: true, message: 'Reply posted successfully.' };
             }
             return { ok: false, message: 'Reply submission did not complete before timeout.' };
-        })()`)}catch(G){if(!X(G))throw G;await z.wait(2);const H=await I(z);if(H?.ok)return H;throw G}}async function U(z,q){let A=await v(z,q);if(!A?.ok&&/Could not verify/i.test(A?.message||"")){await z.wait(2);A=await v(z,q)}if(!A?.ok)return A;let G;try{G=await R(z)}catch(H){if(!X(H))throw H}if(G&&!G.ok)return G;return M(z,q)}f({site:"twitter",name:"reply",access:"write",description:"Reply to a specific tweet, optionally with a local or remote image",domain:"x.com",strategy:F.UI,browser:!0,args:[{name:"url",type:"string",required:!0,positional:!0,help:"The URL of the tweet to reply to"},{name:"text",type:"string",required:!1,positional:!0,help:"The text content of your reply (or use --file)"},{name:"file",help:"从本机文件读取回复正文（UTF-8），与位置参数 <text> 二选一"},{name:"image",help:"Optional local image path to attach to the reply"},{name:"image-url",help:"Optional remote image URL to download and attach to the reply"}],columns:["status","message","text","url"],func:async(z,q)=>{if(!z)throw new J("Browser session required for twitter reply");const A=q.file?String(q.file).trim():"";if(A){if(q.text)throw new J("回复正文位置参数和 --file 只能二选一，不能同时给");const K=D.resolve(A);if(!W.existsSync(K))throw new J(`--file 指向的文件不存在: ${K}`);q.text=W.readFileSync(K,"utf-8").trim();if(!q.text)throw new J(`--file 指向的文件内容为空: ${K}`)}else{if(!q.text)throw new J("缺少回复正文：给位置参数 <text> 或 --file 其一");b(q.text,{label:"回复内容"})}if(q.image&&q["image-url"])throw new J("Use either --image or --image-url, not both.");let G,H;try{if(q.image)G=O(q.image);else if(q["image-url"]){const Y=await h(q["image-url"]);G=Y.absPath;H=Y.cleanupDir}const K=await y(z,q.url);if(!K?.ok)throw new J(K?.message??"Could not open the reply composer.");if(G){await z.wait({selector:B,timeout:20});await L(z,G)}const Q=await U(z,q.text);if(!Q?.ok)throw new J(Q?.message??"Reply was not confirmed sent; verify via readback before retrying.");return[{status:"success",message:Q.message,text:q.text,...Q.url?{url:Q.url}:{},...q.image?{image:q.image}:{},...q["image-url"]?{"image-url":q["image-url"]}:{}}]}finally{if(H)W.rmSync(H,{recursive:!0,force:!0})}}});export const __test__={buildReplyComposerUrl:N,isPromiseCollectedError:X};
+        })()`)}catch(r){if(!u(r))throw r;await t.wait(2);const s=await P(t);if(s?.ok)return s;throw r}}async function A(t,e){let o=await p(t,e);if(!o?.ok&&/Could not verify/i.test(o?.message||"")){await t.wait(2);o=await p(t,e)}if(!o?.ok)return o;let r;try{r=await k(t)}catch(s){if(!u(s))throw s}if(r&&!r.ok)return r;return _(t,e)}x({site:"twitter",name:"reply",access:"write",description:"Reply to a specific tweet, optionally with a local or remote image",domain:"x.com",strategy:w.UI,browser:!0,args:[{name:"url",type:"string",required:!0,positional:!0,help:"The URL of the tweet to reply to"},{name:"text",type:"string",required:!1,positional:!0,help:"The text content of your reply (or use --file)"},{name:"file",help:"从本机文件读取回复正文（UTF-8），与位置参数 <text> 二选一"},{name:"image",help:"Optional local image path to attach to the reply"},{name:"image-url",help:"Optional remote image URL to download and attach to the reply"}],columns:["status","message","text","url"],func:async(t,e)=>{if(!t)throw new i("Browser session required for twitter reply");const o=e.file?String(e.file).trim():"";if(o){if(e.text)throw new i("回复正文位置参数和 --file 只能二选一，不能同时给");const n=b.resolve(o);if(!c.existsSync(n))throw new i(`--file 指向的文件不存在: ${n}`);e.text=c.readFileSync(n,"utf-8").trim();if(!e.text)throw new i(`--file 指向的文件内容为空: ${n}`)}else{if(!e.text)throw new i("缺少回复正文：给位置参数 <text> 或 --file 其一");g(e.text,{label:"回复内容"})}if(e.image&&e["image-url"])throw new i("Use either --image or --image-url, not both.");let r,s;try{if(e.image)r=v(e.image);else if(e["image-url"]){const f=await C(e["image-url"]);r=f.absPath;s=f.cleanupDir}const n=await R(t,e.url);if(!n?.ok)throw new i(n?.message??"Could not open the reply composer.");if(r){await t.wait({selector:T,timeout:20});await S(t,r)}const l=await A(t,e.text);if(!l?.ok)throw new i(l?.message??"Reply was not confirmed sent; verify via readback before retrying.");return[{status:"success",message:l.message,text:e.text,...l.url?{url:l.url}:{},...e.image?{image:e.image}:{},...e["image-url"]?{"image-url":e["image-url"]}:{}}]}finally{if(s)c.rmSync(s,{recursive:!0,force:!0})}}});export const __test__={buildReplyComposerUrl:y,isPromiseCollectedError:u};

package/clis/twitter/retweet.js

@@ -1,6 +1,6 @@
-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:"retweet",access:"write",description:"Retweet 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 retweet"}],columns:["status","message"],func:async(v,D)=>{if(!v)throw new F("Browser session required for twitter retweet");const B=I(D.url);await v.goto(B.url);await v.wait({selector:'[data-testid="primaryColumn"]'});const z=await v.evaluate(`(async () => {
+import{CommandExecutionError as n}from"@jackwener/opencli/errors";import{cli as o,Strategy as a}from"@jackwener/opencli/registry";import{parseTweetUrl as s,buildTwitterArticleScopeSource as c}from"./shared.js";o({site:"twitter",name:"retweet",access:"write",description:"Retweet a specific tweet",domain:"x.com",strategy:a.UI,browser:!0,args:[{name:"url",type:"string",required:!0,positional:!0,help:"The URL of the tweet to retweet"}],columns:["status","message"],func:async(e,i)=>{if(!e)throw new n("Browser session required for twitter retweet");const r=s(i.url);await e.goto(r.url);await e.wait({selector:'[data-testid="primaryColumn"]'});const t=await e.evaluate(`(async () => {
         try {
-            ${J(B.id)}
+            ${c(r.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.
@@ -59,4 +59,4 @@ import{CommandExecutionError as F}from"@jackwener/opencli/errors";import{cli as
         } catch (e) {
             return { ok: false, message: e.toString() };
         }
-    })()`);if(z.ok)await v.wait(2);return[{status:z.ok?"success":"failed",message:z.message}]}});
+    })()`);if(t.ok)await e.wait(2);return[{status:t.ok?"success":"failed",message:t.message}]}});

package/clis/twitter/scheduled-delete.js

@@ -1,6 +1,6 @@
-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 () => {
+import{ArgumentError as l,CommandExecutionError as i}from"@jackwener/opencli/errors";import{cli as a,Strategy as d}from"@jackwener/opencli/registry";import{openScheduledQueue as c}from"./scheduled-utils.js";function s(e){const t=String(e??"").trim();if(!t)throw new l("Text fragment is required to delete a scheduled post");return t}export function buildScheduledDeleteScript(e){return`(async () => {
         try {
-            const needle = ${JSON.stringify(q)}.toLowerCase();
+            const needle = ${JSON.stringify(e)}.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"]'));
@@ -57,4 +57,4 @@ import{ArgumentError as J,CommandExecutionError as H}from"@jackwener/opencli/err
         } 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};
+    })()`}a({site:"twitter",name:"scheduled-delete",access:"write",description:"Delete a scheduled X post by matching a text fragment",domain:"x.com",strategy:d.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(e,t)=>{if(!e)throw new i("Browser session required for twitter scheduled-delete");const o=s(t.match),r=await c(e);if(r?.empty)return[{status:"failed",message:"No scheduled posts found to delete.",match:o}];if(!r?.ok)throw new i(r?.message??"Could not open scheduled posts queue");const n=await e.evaluate(buildScheduledDeleteScript(o));return[{status:n?.ok?"success":"failed",message:n?.message??"Scheduled post delete failed.",match:o}]}});export const __test__={buildScheduledDeleteScript,normalizeMatch:s};

package/clis/twitter/scheduled-list.js

@@ -1,4 +1,4 @@
-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`(() => {
+import{CommandExecutionError as r}from"@jackwener/opencli/errors";import{cli as s,Strategy as o}from"@jackwener/opencli/registry";import{openScheduledQueue as d}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();
@@ -12,4 +12,4 @@ import{CommandExecutionError as v}from"@jackwener/opencli/errors";import{cli as
                 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};
+    })()`}s({site:"twitter",name:"scheduled-list",access:"read",description:"List X posts currently scheduled in the web composer",domain:"x.com",strategy:o.UI,browser:!0,args:[],columns:["index","scheduledFor","text"],func:async(e)=>{if(!e)throw new r("Browser session required for twitter scheduled-list");const t=await d(e);if(t?.empty)return[];if(!t?.ok)throw new r(t?.message??"Could not open scheduled posts queue");return e.evaluate(buildScheduledListScript())}});export const __test__={buildScheduledListScript};

package/clis/twitter/scheduled-utils.js

@@ -1,4 +1,4 @@
-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 () => {
+export const COMPOSE_URL="https://x.com/compose/post";export async function openScheduledQueue(t){await t.goto(COMPOSE_URL,{waitUntil:"load",settleMs:2500});try{await t.wait({selector:'[data-testid="unsentButton"]',timeout:15})}catch{}const e=await t.evaluate(`(async () => {
         const visible = (el) => !!el && (el.offsetParent !== null || el.getClientRects().length > 0);
         // 优先用 locale 无关的 testid 判存在，其次回退到文案（个别皮肤无 testid）。
         const drafts = document.querySelector('[data-testid="unsentButton"]')
@@ -7,7 +7,7 @@ export const COMPOSE_URL="https://x.com/compose/post";export async function open
         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 () => {
+    })()`);if(e?.empty)return{ok:!0,empty:!0};if(!e?.ok)return e;await t.wait(1);const r=await t.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()));
@@ -15,4 +15,4 @@ export const COMPOSE_URL="https://x.com/compose/post";export async function open
         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}}
+    })()`);if(r?.empty)return{ok:!0,empty:!0};if(!r?.ok)return r;await t.wait(2);return{ok:!0}}

package/clis/twitter/search.js

@@ -1,12 +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: ppcli twitter search ppcli --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 () => {
+import{ArgumentError as f,AuthRequiredError as I,CommandExecutionError as N}from"@jackwener/opencli/errors";import{cli as k,Strategy as U}from"@jackwener/opencli/registry";import{extractMedia as z,extractCard as j,extractQuotedTweet as M,normalizeTwitterGraphqlPayload as X,resolveTwitterOperationMetadata as D,describeTwitterApiError as L}from"./shared.js";import{TWITTER_BEARER_TOKEN as H,applyTopByEngagement as B}from"./utils.js";const m=Object.freeze(["media","images","videos","links","replies"]),h=Object.freeze(["replies","retweets","media","links"]),w=Object.freeze(["top","live","photos","videos"]),b=Object.freeze({top:"top",live:"live",photos:"image",videos:"video"}),G=Object.freeze({top:"Top",live:"Latest",photos:"Photos",videos:"Videos"}),J=100,l={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}},y=/^[A-Za-z0-9_]{1,15}$/,g=Object.freeze({replies:"-filter:replies",retweets:"-filter:nativeretweets",media:"-filter:media",links:"-filter:links"});function v(e,t){const r=[String(e??"").trim()];if(t.from){const o=String(t.from).trim().replace(/^@+/,"");if(o&&!y.test(o))throw new f(`Invalid --from username: ${JSON.stringify(t.from)}`,"Use a Twitter/X handle with 1-15 letters, numbers, or underscores; omit @ or pass @handle.");if(o)r.push(`from:${o}`)}if(t.has)r.push(`filter:${t.has}`);if(t.exclude){const o=g[t.exclude];if(o)r.push(o)}return r.filter(Boolean).join(" ")}function Q(e){if(e.product){const t=b[e.product];if(t)return t}return e.filter==="live"?"live":"top"}function T(e){const t=e.product||(e.filter==="live"?"live":"top");return G[t]||"Top"}function Y(e){if(typeof e==="string")return{queryId:e,features:l.features,fieldToggles:l.fieldToggles};return{queryId:e?.queryId||l.queryId,features:e?.features||l.features,fieldToggles:e?.fieldToggles||l.fieldToggles}}function O(e,t,r,o,n){const a=Y(e),i={rawQuery:t,count:o,querySource:"typed_query",product:r};if(n)i.cursor=n;return[`/i/api/graphql/${a.queryId}/SearchTimeline`,{variables:i,features:a.features,fieldToggles:a.fieldToggles}]}function K(e){if(!e)return null;if(e.__typename==="TweetWithVisibilityResults"&&e.tweet)return e.tweet;if(e.tweet)return e.tweet;return e}function W(e,t){const r=K(e);if(!r?.rest_id||t.has(r.rest_id))return null;t.add(r.rest_id);const o=r.core?.user_results?.result,n=o?.legacy?.description||"";return{id:r.rest_id,author:o?.core?.screen_name||o?.legacy?.screen_name||"",bio:n,text:r.note_tweet?.note_tweet_results?.result?.text||r.legacy?.full_text||"",created_at:r.legacy?.created_at||"",likes:r.legacy?.favorite_count||0,views:r.views?.count||"0",url:`https://x.com/i/status/${r.rest_id}`,...z(r.legacy),card:j(r),quoted_tweet:M(r)}}function x(e,t){const r=[];let o=null;const n=e?.data?.search_by_raw_query?.search_timeline?.timeline?.instructions||[],a=(i)=>{if(!i||typeof i!=="object")return;if(i.tweet_results?.result){const s=W(i.tweet_results.result,t);if(s)r.push(s)}if((i.entryType==="TimelineTimelineCursor"||i.__typename==="TimelineTimelineCursor")&&(i.cursorType==="Bottom"||i.cursorType==="ShowMore")&&i.value)o=i.value;if(Array.isArray(i)){for(const s of i)a(s);return}for(const s of Object.values(i))if(s&&typeof s==="object")a(s)};a(n);return{rows:r,nextCursor:o}}k({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:U.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:w,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:m,help:"Restrict to tweets that have media|images|videos|links|replies. Maps to X's `filter:<has>` operator."},{name:"exclude",type:"string",choices:h,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(e,t)=>{const r=v(t.query,t);if(!r)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(t.limit))||Number(t.limit)<=0)throw new f("twitter search --limit must be a positive integer","Example: ppcli twitter search ppcli --limit 15");const n=(await e.getCookies({url:"https://x.com"})).find((c)=>c.name==="ct0")?.value||null;if(!n)throw new I("x.com","Not logged into x.com (no ct0 cookie)");await e.goto("https://x.com/home",{waitUntil:"load",settleMs:1000});const a=await D(e,"SearchTimeline",l),i=JSON.stringify({Authorization:`Bearer ${decodeURIComponent(H)}`,"X-Csrf-Token":n,"X-Twitter-Auth-Type":"OAuth2Session","X-Twitter-Active-User":"yes","Content-Type":"application/json"}),s=T(t),_=[],S=new Set;let u=null;for(let c=0;c<J&&_.length<t.limit;c++){const R=Number(t.limit)-_.length+10,[A,E]=O(a,r,s,R,u),C=JSON.stringify(E),d=X(await e.evaluate(`async () => {
         const options = {
           method: 'POST',
-          headers: ${Z},
+          headers: ${i},
           credentials: 'include',
         };
-        options['body'] = ${JSON.stringify(A)};
-        const r = await fetch(${JSON.stringify(I)}, {
+        options['body'] = ${JSON.stringify(C)};
+        const r = await fetch(${JSON.stringify(A)}, {
           ...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};
+      }`));if(d?.error){if(_.length===0)throw new N(L("SearchTimeline",d.error));break}const{rows:P,nextCursor:p}=x(d,S);_.push(...P);if(!p||p===u)break;u=p}const q=_.slice(0,t.limit);return B(q,t["top-by-engagement"])}});export const __test__={buildSearchQuery:v,resolveSearchFParam:Q,resolveSearchProduct:T,buildSearchTimelineRequest:O,parseSearchTimeline:x,HAS_CHOICES:m,EXCLUDE_CHOICES:h,PRODUCT_CHOICES:w,EXCLUDE_TO_OPERATOR:g,PRODUCT_TO_F_PARAM:b,FROM_USER_PATTERN:y};