publishport-opencli 1.0.0

package/clis/twitter/profile.js

@@ -0,0 +1,66 @@
+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: opencli 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(`() => {
+        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(`
+      async () => {
+        const screenName = "${Z}";
+        const ct0 = ${JSON.stringify($)};
+
+        const bearer = ${JSON.stringify(x)};
+        const headers = {
+          'Authorization': 'Bearer ' + decodeURIComponent(bearer),
+          'X-Csrf-Token': ct0,
+          'X-Twitter-Auth-Type': 'OAuth2Session',
+          'X-Twitter-Active-User': 'yes'
+        };
+
+        const variables = JSON.stringify({
+          screen_name: screenName,
+          withSafetyModeUserFields: true,
+        });
+        const features = JSON.stringify({
+          hidden_profile_subscriptions_enabled: true,
+          rweb_tipjar_consumption_enabled: true,
+          responsive_web_graphql_exclude_directive_enabled: true,
+          verified_phone_label_enabled: false,
+          subscriptions_verification_info_is_identity_verified_enabled: true,
+          subscriptions_verification_info_verified_since_enabled: true,
+          highlights_tweets_tab_ui_enabled: true,
+          responsive_web_twitter_article_notes_tab_enabled: true,
+          subscriptions_feature_can_gift_premium: true,
+          creator_subscriptions_tweet_preview_api_enabled: true,
+          responsive_web_graphql_skip_user_profile_image_extensions_enabled: false,
+          responsive_web_graphql_timeline_navigation_enabled: true,
+        });
+
+        const url = '/i/api/graphql/' + ${JSON.stringify(L)} + '/UserByScreenName?variables='
+          + encodeURIComponent(variables)
+          + '&features=' + encodeURIComponent(features);
+
+        let resp;
+        try {
+          resp = await fetch(url, {headers, credentials: 'include'});
+        } catch (error) {
+          return {ok: false, error: 'Twitter profile request failed: ' + String(error && error.message || error)};
+        }
+        if (!resp.ok) {
+          return {
+            ok: false,
+            auth: resp.status === 401 || resp.status === 403,
+            httpStatus: resp.status,
+            error: 'HTTP ' + resp.status,
+            hint: 'User may not exist, auth may be required, or queryId expired'
+          };
+        }
+        let d;
+        try {
+          d = await resp.json();
+        } catch (error) {
+          return {ok: false, error: 'Twitter profile response was not JSON: ' + String(error && error.message || error)};
+        }
+
+        const result = d.data?.user?.result;
+        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};

package/clis/twitter/quote.js

@@ -0,0 +1,123 @@
+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 () => {
+        try {
+            ${V(j.id)}
+            const visible = (el) => !!el && (el.offsetParent !== null || el.getClientRects().length > 0);
+            let retweetBtn = null;
+            let targetArticle = null;
+            for (let i = 0; i < 20; i++) {
+                targetArticle = findTargetArticle();
+                retweetBtn = targetArticle?.querySelector('[data-testid="retweet"], [data-testid="unretweet"]') || null;
+                if (retweetBtn && visible(retweetBtn)) break;
+                await new Promise(r => setTimeout(r, 500));
+            }
+            if (!retweetBtn || !targetArticle) {
+                return { ok: false, message: 'Could not find the repost menu button on the target tweet.' };
+            }
+            retweetBtn.click();
+
+            let quoteItem = null;
+            for (let i = 0; i < 20; i++) {
+                await new Promise(r => setTimeout(r, 250));
+                const items = Array.from(document.querySelectorAll('[role="menuitem"]'));
+                quoteItem = items.find((el) => visible(el) && /^Quote$/i.test((el.innerText || el.textContent || '').trim()));
+                if (quoteItem) break;
+            }
+            if (!quoteItem) {
+                return { ok: false, message: 'Repost menu opened but the Quote option did not appear.' };
+            }
+            quoteItem.click();
+            return { ok: true };
+        } 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 () => {
+        try {
+            ${V(v.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) => {
+                box.focus();
+                if (!document.execCommand('insertText', false, value)) {
+                    const dataTransfer = new DataTransfer();
+                    dataTransfer.setData('text/plain', value);
+                    box.dispatchEvent(new ClipboardEvent('paste', {
+                        clipboardData: dataTransfer,
+                        bubbles: true,
+                        cancelable: true,
+                    }));
+                }
+                await new Promise(r => setTimeout(r, 1000));
+                const actual = box.innerText || box.textContent || '';
+                return normalize(actual).includes(normalize(value));
+            };
+
+            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 quote composer text area. Are you logged in?' };
+            }
+
+            const textToInsert = ${JSON.stringify(j)};
+            if (!(await insertTextIntoBox(box, textToInsert))) {
+                return { ok: false, message: 'Could not verify quote text in the composer after typing.' };
+            }
+
+            // Confirm the quoted card is rendered before submitting. The
+            // compose page does not wrap the card in an <article>, so we probe
+            // the document for any link whose path exactly matches the
+            // requested status id (uses __twHasLinkToTarget from
+            // buildTwitterArticleScopeSource). If the dedicated compose URL
+            // misses the card, the caller retries through the target post's
+            // repost menu and Quote item.
+            let cardAttempts = 0;
+            let hasQuoteCard = false;
+            while (cardAttempts < 20) {
+                hasQuoteCard = __twHasLinkToTarget(document);
+                if (hasQuoteCard) break;
+                await new Promise(r => setTimeout(r, 250));
+                cardAttempts++;
+            }
+            if (!hasQuoteCard) {
+                const allowMenuFallback = ${JSON.stringify(z)};
+                if (allowMenuFallback) {
+                    return { ok: false, retryWithMenuFallback: true, message: 'Quote target did not render in the dedicated composer; retrying through the repost menu.' };
+                }
+                return { ok: false, message: 'Quote target did not render after opening the quote composer from the repost menu.' };
+            }
+
+            let btn = null;
+            for (let i = 0; i < 30; i++) {
+                const buttons = Array.from(
+                    document.querySelectorAll('[data-testid="tweetButton"], [data-testid="tweetButtonInline"]')
+                );
+                btn = buttons.find((el) => visible(el) && !el.disabled && el.getAttribute('aria-disabled') !== 'true');
+                if (btn) break;
+                await new Promise(r => setTimeout(r, 500));
+            }
+            if (!btn) {
+                return { ok: false, message: 'Tweet button is disabled or not found.' };
+            }
+
+            btn.click();
+
+            const expectedText = normalize(textToInsert);
+            for (let i = 0; i < 30; i++) {
+                await new Promise(r => setTimeout(r, 500));
+                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 || ''));
+                if (successToast) return { ok: true, message: 'Quote tweet posted successfully.' };
+                const alert = toasts.find((el) => /failed|error|try again|not sent|could not/i.test(el.textContent || ''));
+                if (alert) return { ok: false, message: (alert.textContent || 'Quote tweet failed to post.').trim() };
+
+                const visibleBoxes = Array.from(document.querySelectorAll('[data-testid="tweetTextarea_0"]')).filter(visible);
+                const composerStillHasText = visibleBoxes.some((box) =>
+                    normalize(box.innerText || box.textContent || '').includes(expectedText)
+                );
+                if (!composerStillHasText) return { ok: true, message: 'Quote tweet posted successfully.' };
+            }
+            return { ok: false, message: 'Quote tweet submission did not complete before timeout.' };
+        } 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",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};

package/clis/twitter/reply-dm.js

@@ -0,0 +1,112 @@
+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",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 () => {
+      try {
+        // Wait for initial items
+        let attempts = 0;
+        while (attempts < 10) {
+          const items = document.querySelectorAll('[data-testid^="dm-conversation-item-"], [data-testid="conversation"]');
+          if (items.length > 0) break;
+          await new Promise(r => setTimeout(r, 1000));
+          attempts++;
+        }
+
+        // Scroll to load more conversations
+        const needed = ${K};
+        const seenIds = new Set();
+        let noNewCount = 0;
+
+        for (let scroll = 0; scroll < 30; scroll++) {
+          const items = Array.from(document.querySelectorAll('[data-testid^="dm-conversation-item-"], [data-testid="conversation"]'));
+          items.forEach(el => seenIds.add(el.getAttribute('data-testid')));
+
+          if (seenIds.size >= needed) break;
+
+          // Find the scrollable container and scroll it
+          const scrollContainer = document.querySelector('[data-testid="dm-inbox-panel"]') ||
+                                  items[items.length - 1]?.closest('[class*="scroll"]') ||
+                                  items[items.length - 1]?.parentElement;
+          if (scrollContainer) {
+            scrollContainer.scrollTop = scrollContainer.scrollHeight;
+          }
+          // Also try scrolling the last item into view
+          if (items.length > 0) {
+            items[items.length - 1].scrollIntoView({ behavior: 'instant', block: 'end' });
+          }
+
+          await new Promise(r => setTimeout(r, 1500));
+
+          // Check if new items appeared
+          const newItems = Array.from(document.querySelectorAll('[data-testid^="dm-conversation-item-"], [data-testid="conversation"]'));
+          const newIds = new Set(newItems.map(el => el.getAttribute('data-testid')));
+          if (newIds.size <= seenIds.size) {
+            noNewCount++;
+            if (noNewCount >= 3) break; // No more loading after 3 tries
+          } else {
+            noNewCount = 0;
+          }
+        }
+
+        // Collect all visible conversations
+        const finalItems = Array.from(document.querySelectorAll('[data-testid^="dm-conversation-item-"], [data-testid="conversation"]'));
+        const conversations = finalItems.map((item, idx) => {
+          const testId = item.getAttribute('data-testid') || '';
+          const text = item.innerText || '';
+          const lines = text.split('\\n').filter(l => l.trim());
+          const user = lines[0] || 'Unknown';
+          const match = testId.match(/dm-conversation-item-(.+)/);
+          const convId = match ? match[1].replace(':', '-') : '';
+          const link = item.querySelector('a[href*="/messages/"]');
+          const href = link ? link.href : '';
+          return { idx, user, convId, href, preview: text.substring(0, 100) };
+        });
+
+        return { ok: true, conversations, total: conversations.length };
+      } 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 () => {
+        try {
+          const messageText = ${JSON.stringify(F)};
+          const skipReplied = ${J};
+
+          // 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}';
+
+          // Check if we already sent this message
+          if (skipReplied) {
+            const chatArea = document.querySelector('[data-testid="DmScrollerContainer"]') ||
+                             document.querySelector('main');
+            const chatText = chatArea ? chatArea.innerText : '';
+            if (chatText.includes(messageText)) {
+              return { status: 'skipped', user: username, message: 'Already sent this message' };
+            }
+          }
+
+          // Find the text input
+          const input = document.querySelector('[data-testid="dmComposerTextInput"]');
+          if (!input) {
+            return { status: 'error', user: username, message: 'No message input found' };
+          }
+
+          // Focus and type into the DraftEditor
+          input.focus();
+          await new Promise(r => setTimeout(r, 300));
+          document.execCommand('insertText', false, messageText);
+          await new Promise(r => setTimeout(r, 500));
+
+          // Click send button
+          const sendBtn = document.querySelector('[data-testid="dmComposerSendButton"]');
+          if (!sendBtn) {
+            return { status: 'error', user: username, message: 'No send button found' };
+          }
+
+          sendBtn.click();
+          await new Promise(r => setTimeout(r, 1500));
+
+          return { status: 'sent', user: username, message: 'Message sent: ' + messageText };
+        } 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}});

package/clis/twitter/reply.js

@@ -0,0 +1,97 @@
+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(`(() => {
+            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 () => {
+      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 reply text area. Are you logged in?' };
+          }
+
+          box.focus();
+          const textToInsert = ${JSON.stringify(q)};
+          // execCommand('insertText') is more reliable with Twitter's Draft.js editor
+          if (!document.execCommand('insertText', false, textToInsert)) {
+              // Fallback to paste event if execCommand fails
+              const dataTransfer = new DataTransfer();
+              dataTransfer.setData('text/plain', textToInsert);
+              box.dispatchEvent(new ClipboardEvent('paste', {
+                  clipboardData: dataTransfer,
+                  bubbles: true,
+                  cancelable: true
+              }));
+          }
+
+          await new Promise(r => setTimeout(r, 1000));
+          const normalize = s => String(s || '').replace(/\\u00a0/g, ' ').replace(/\\s+/g, ' ').trim();
+          const actual = box.innerText || box.textContent || '';
+          if (!normalize(actual).includes(normalize(textToInsert))) {
+              return { ok: false, message: 'Could not verify reply text in the composer after typing.', actualText: actual };
+          }
+          return { ok: true };
+      } catch (e) {
+          return { ok: false, message: e.toString() };
+      }
+  })()`)}async function R(z){const q=Math.ceil($/V);return z.evaluate(`(async () => {
+      try {
+          const visible = (el) => !!el && (el.offsetParent !== null || el.getClientRects().length > 0);
+          for (let i = 0; i < ${JSON.stringify(q)}; i++) {
+              const buttons = Array.from(
+                  document.querySelectorAll('[data-testid="tweetButton"], [data-testid="tweetButtonInline"]')
+              );
+              const btn = buttons.find((el) => visible(el) && !el.disabled && el.getAttribute('aria-disabled') !== 'true');
+              if (btn) {
+                  btn.click();
+                  return { ok: true };
+              }
+              await new Promise(r => setTimeout(r, ${JSON.stringify(V)}));
+          }
+          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(`(() => {
+        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));
+        const successToast = toasts.find((el) => /sent|posted|your post was sent|your tweet was sent/i.test(el.textContent || ''));
+        if (!successToast) return { ok: false };
+        const link = successToast.querySelector('a[href*="/status/"]');
+        return {
+            ok: true,
+            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)};
+            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)}));
+                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 || ''));
+                if (successToast) {
+                    const link = successToast.querySelector('a[href*="/status/"]');
+                    return {
+                        ok: true,
+                        message: 'Reply posted successfully.',
+                        url: link?.href || link?.getAttribute('href') || undefined
+                    };
+                }
+                const alert = toasts.find((el) => /failed|error|try again|not sent|could not/i.test(el.textContent || ''));
+                if (alert) return { ok: false, message: (alert.textContent || 'Reply failed to post.').trim() };
+
+                const boxes = Array.from(document.querySelectorAll('[data-testid="tweetTextarea_0"]')).filter(visible);
+                const composerStillHasText = boxes.some((box) => normalize(box.innerText || box.textContent || '').includes(expectedText));
+                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};

package/clis/twitter/retweet.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:"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 () => {
+        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 retweet the wrong one.
+            let attempts = 0;
+            let retweetBtn = null;
+            let unretweetBtn = null;
+            let targetArticle = null;
+
+            while (attempts < 20) {
+                targetArticle = findTargetArticle();
+                unretweetBtn = targetArticle?.querySelector('[data-testid="unretweet"]') || null;
+                retweetBtn = targetArticle?.querySelector('[data-testid="retweet"]') || null;
+
+                if (unretweetBtn || retweetBtn) break;
+
+                await new Promise(r => setTimeout(r, 500));
+                attempts++;
+            }
+
+            // Already retweeted: idempotent success
+            if (unretweetBtn) {
+                return { ok: true, message: 'Tweet is already retweeted.' };
+            }
+
+            if (!retweetBtn) {
+                return { ok: false, message: 'Could not find the Retweet button on this tweet after waiting 10 seconds. Are you logged in?' };
+            }
+
+            // Step 1: click Retweet button → opens menu
+            retweetBtn.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="retweetConfirm"]');
+                if (confirmBtn) break;
+            }
+            if (!confirmBtn) {
+                return { ok: false, message: 'Retweet menu opened but the confirm option did not appear.' };
+            }
+            confirmBtn.click();
+            await new Promise(r => setTimeout(r, 1000));
+
+            // Verify success by checking if the 'unretweet' button appeared
+            const verifyArticle = findTargetArticle() || targetArticle;
+            const verifyBtn = verifyArticle?.querySelector('[data-testid="unretweet"]');
+            if (verifyBtn) {
+                return { ok: true, message: 'Tweet successfully retweeted.' };
+            } else {
+                return { ok: false, message: 'Retweet 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/schedule.js

@@ -0,0 +1,96 @@
+import{ArgumentError as i,CommandExecutionError as d}from"@jackwener/opencli/errors";import{cli as m,Strategy as f}from"@jackwener/opencli/registry";const b="https://x.com/compose/post",a=10,u=2;function h(e,s){const t=Number(e);if(!Number.isInteger(t)||t<0)throw new i(`${s} must be a non-negative integer`);return t}export function parseScheduleTarget(e,s=new Date){const t=String(e.at??"").trim(),r=e["delay-minutes"]!==void 0&&e["delay-minutes"]!==null&&e["delay-minutes"]!==""&&Number(e["delay-minutes"])!==a;if(t&&r)throw new i("Use either --at or --delay-minutes, not both");let n;if(t){const o=t.includes("T")?t:t.replace(" ","T");n=new Date(o);if(Number.isNaN(n.getTime()))throw new i('Invalid --at value. Use a local time like "2026-05-24 21:30"')}else{const o=e["delay-minutes"]===void 0||e["delay-minutes"]===null||e["delay-minutes"]===""?a:h(e["delay-minutes"],"delay-minutes");if(o<u)throw new i(`delay-minutes must be at least ${u}`);n=new Date(s.getTime()+o*60000)}if(n.getTime()<=s.getTime()+60000)throw new i("Scheduled time must be at least one minute in the future");return{year:n.getFullYear(),month:n.getMonth()+1,day:n.getDate(),hour:n.getHours(),minute:n.getMinutes(),iso:n.toISOString()}}async function x(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 post composer text area. Are you logged in?' };
+        box.focus();
+        return { ok: true };
+    })()`)}async function g(e,s){return e.evaluate(`(async () => {
+        const expected = ${JSON.stringify(s)};
+        const normalize = s => String(s || '').replace(/\\u00a0/g, ' ').replace(/\\s+/g, ' ').trim();
+        const normalizedExpected = normalize(expected);
+        for (let i = 0; i < 40; 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, 250));
+        }
+        const box = document.querySelector('[data-testid="tweetTextarea_0"]');
+        return {
+            ok: false,
+            message: 'Could not verify post text in the composer after typing.',
+            actualText: box ? (box.innerText || box.textContent || '') : ''
+        };
+    })()`)}function y(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 w(e,s){const t=await x(e);if(!t?.ok)return t;const r=[e.nativeType?.bind(e),e.insertText?.bind(e)].filter(Boolean);for(const n of r)try{await n(s);const o=await g(e,s);if(o?.ok)return o}catch(o){if(!y(o))throw o}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 post composer text area. Are you logged in?' };
+            const textToInsert = ${JSON.stringify(s)};
+            const normalize = s => String(s || '').replace(/\\u00a0/g, ' ').replace(/\\s+/g, ' ').trim();
+            box.focus();
+            if (!document.execCommand('insertText', false, textToInsert)) {
+                const dt = new DataTransfer();
+                dt.setData('text/plain', textToInsert);
+                box.dispatchEvent(new ClipboardEvent('paste', { clipboardData: dt, bubbles: true, cancelable: true }));
+            }
+            await new Promise(r => setTimeout(r, 500));
+            const actual = box.innerText || box.textContent || '';
+            if (normalize(actual).includes(normalize(textToInsert))) return { ok: true };
+            return { ok: false, message: 'Could not verify post text in the composer after typing.', actualText: actual };
+        } catch (e) { return { ok: false, message: String(e) }; }
+    })()`)}async function c(e,s){const t=await e.evaluate(`(async () => {
+        const visible = (el) => !!el && (el.offsetParent !== null || el.getClientRects().length > 0);
+        const button = Array.from(document.querySelectorAll('[data-testid="scheduleOption"], button,[role="button"]'))
+            .find((el) => visible(el) && /schedule post/i.test((el.getAttribute('aria-label') || '') + ' ' + (el.textContent || '')));
+        if (!button) return { ok: false, message: 'Could not find the Schedule post button.' };
+        button.click();
+        return { ok: true };
+    })()`);if(!t?.ok)return t;await e.wait({selector:'[data-testid="scheduledConfirmationPrimaryAction"]',timeout:15});return e.evaluate(`(async () => {
+        try {
+            const target = ${JSON.stringify(s)};
+            const selects = Array.from(document.querySelectorAll('select'));
+            if (selects.length < 5) {
+                return { ok: false, message: 'Could not find schedule date/time controls.' };
+            }
+
+            const values = [target.month, target.day, target.year, target.hour, target.minute];
+            for (let i = 0; i < values.length; i++) {
+                const select = selects[i];
+                select.value = String(values[i]);
+                select.dispatchEvent(new Event('input', { bubbles: true }));
+                select.dispatchEvent(new Event('change', { bubbles: true }));
+            }
+
+            await new Promise(r => setTimeout(r, 500));
+            const confirm = document.querySelector('[data-testid="scheduledConfirmationPrimaryAction"]');
+            if (!confirm || confirm.disabled || confirm.getAttribute('aria-disabled') === 'true') {
+                return { ok: false, message: 'Schedule confirmation button is disabled or missing.' };
+            }
+            confirm.click();
+            return { ok: true };
+        } catch (e) {
+            return { ok: false, message: String(e) };
+        }
+    })()`)}async function p(e){const s=await e.evaluate(`(async () => {
+        try {
+            const visible = (el) => !!el && (el.offsetParent !== null || el.getClientRects().length > 0);
+            const buttons = Array.from(document.querySelectorAll('[data-testid="tweetButton"], [data-testid="tweetButtonInline"]'));
+            const btn = buttons.find((el) => visible(el) && /schedule/i.test(el.textContent || '') && !el.disabled && el.getAttribute('aria-disabled') !== 'true');
+            if (!btn) return { ok: false, message: 'Schedule submit button is disabled or not found.' };
+            btn.click();
+            return { ok: true };
+        } catch (e) { return { ok: false, message: String(e) }; }
+    })()`);if(!s?.ok)return s;return e.evaluate(`(async () => {
+        const visible = (el) => !!el && (el.offsetParent !== null || el.getClientRects().length > 0);
+        for (let i = 0; i < 40; i++) {
+            await new Promise(r => setTimeout(r, 500));
+            const toasts = Array.from(document.querySelectorAll('[role="alert"], [data-testid="toast"]')).filter(visible);
+            const successToast = toasts.find((el) => /will be sent|scheduled/i.test(el.textContent || ''));
+            if (successToast) return { ok: true, message: (successToast.textContent || 'Post scheduled successfully.').trim() };
+            const alert = toasts.find((el) => /failed|error|try again|not sent|could not/i.test(el.textContent || ''));
+            if (alert) return { ok: false, message: (alert.textContent || 'Scheduled post failed.').trim() };
+        }
+        return { ok: false, message: 'Schedule submission did not complete before timeout.' };
+    })()`)}m({site:"twitter",name:"schedule",access:"write",description:"Schedule a new X post through the web composer",domain:"x.com",strategy:f.UI,browser:!0,args:[{name:"text",type:"string",required:!0,positional:!0,help:"The text content of the scheduled post"},{name:"at",type:"string",required:!1,help:'Local scheduled time, e.g. "2026-05-24 21:30"'},{name:"delay-minutes",type:"int",default:a,help:"Schedule this many minutes from now"}],columns:["status","message","text","scheduledFor"],func:async(e,s)=>{if(!e)throw new d("Browser session required for twitter schedule");const t=String(s.text??"").trim();if(!t)throw new i("Scheduled post text is required");const r=parseScheduleTarget(s);await e.goto(b,{waitUntil:"load",settleMs:2500});await e.wait({selector:'[data-testid="tweetTextarea_0"]',timeout:15});const n=await c(e,r);if(!n?.ok)return[{status:"failed",message:n?.message??"Could not configure schedule.",text:t,scheduledFor:r.iso}];await e.wait({selector:'[data-testid="tweetTextarea_0"]',timeout:15});const o=await w(e,t);if(!o?.ok)return[{status:"failed",message:o?.message??"Could not type scheduled post text.",text:t,scheduledFor:r.iso}];await e.wait(1);const l=await p(e);return[{status:l?.ok?"success":"failed",message:l?.message??"Scheduled post failed.",text:t,scheduledFor:r.iso}]}});export const __test__={parseScheduleTarget,setSchedule:c};