publishport-opencli 1.0.0

package/clis/_shared/article/publish.js

@@ -0,0 +1,34 @@
+import{CommandExecutionError as O}from"@jackwener/opencli/errors";import{normalizeContent as H}from"./format.js";import{assertLiteralContent as C}from"../content-guard.js";import{inlineLocalImages as U,isLocalImagePath as I,localImageToDataUri as E}from"./images.js";import{PAGE_RUNTIME as S}from"./page-runtime.js";export function selectContent(K,Q,X="auto"){const Z=H(K,{format:X});return Q.outputFormat==="markdown"?Z.markdown:Z.html}export function originReFromHome(K){let Q="";try{Q=new URL(K).host}catch(Z){Q=""}return"^https?://([^/]*\\.)?"+Q.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")+"(/|$)"}export async function gotoWritePage(K,Q,X){const Z=X||originReFromHome(Q);for(let G=0;G<8;G++){await K.goto(Q);await K.wait({time:1});const D=await K.evaluate(`(() => {
+            var href = ''; try { href = location.href; } catch (e) {}
+            var onSite = new RegExp(${JSON.stringify(Z)}).test(href);
+            var cookieOk = true; try { void document.cookie; } catch (e) { cookieOk = false; }
+            return { href: href, onSite: onSite, cookieOk: cookieOk };
+        })()`);if(D&&D.onSite&&D.cookieOk)return;await K.wait({time:1})}throw new O(`无法在浏览器中打开已登录的写作页（页面停留在空白页，未落到 ${Q}）。`+"请确认登录该平台的 Chrome 已连接 opencli 浏览器桥。")}export function buildPublishJs(K,Q,X){return`(async () => {
+`+S+`
+const I = `+JSON.stringify(K)+`;
+const __publish = (`+Q+`);
+`+(X?"const __upload = ("+X+`);
+`:"")+`const __content0 = I.content;
+let content = I.content;
+if (I.outputFormat === "html" && I.preprocessConfig) content = PP.preprocess(content, I.preprocessConfig);
+`+(X?`const __t = await PP.processImagesWith(content, (src) => __upload(src, PP), { skip: I.imageSkip, allowRelative: I.imageAllowRelative });
+`:`const __t = await PP.transferImages(content, I.imageSpec, I.imageSkip);
+`)+`content = __t.content;
+if (I.publishParams && typeof I.publishParams.cover === "string" && I.publishParams.cover) {
+  var __cvWrap = '<img src="' + I.publishParams.cover + '">';
+`+(X?`  var __cv = await PP.processImagesWith(__cvWrap, (src) => __upload(src, PP), { skip: I.imageSkip, allowRelative: I.imageAllowRelative });
+`:`  var __cv = await PP.transferImages(__cvWrap, I.imageSpec, I.imageSkip);
+`)+`  if (__cv.failed.length) {
+`+`    return { ok: false, stage: "cover", message: "封面图转存失败：" + __cv.failed[0].error, uploaded: __t.uploaded, failed: __t.failed.concat(__cv.failed) };
+`+`  }
+  if (__cv.uploaded.length) I.publishParams.cover = __cv.uploaded[0].url;
+  __t.uploaded = __t.uploaded.concat(__cv.uploaded);
+}
+const __pub = await __publish({ title: I.title, content: content, markdown: I.markdown != null ? I.markdown : (I.outputFormat === "markdown" ? __content0 : null), html: I.html != null ? I.html : (I.outputFormat === "html" ? __content0 : null), draftOnly: I.draftOnly, params: I.publishParams }, PP);
+var __upN = (__t.uploaded || []).concat((__pub && __pub.uploaded) || []);
+var __failN = (__t.failed || []).concat((__pub && __pub.failed) || []);
+if (!__pub || __pub.ok === false) {
+  return { ok: false, stage: (__pub && __pub.stage) || "publish", status: __pub && __pub.status, message: (__pub && __pub.message) || "publish failed", detail: __pub && __pub.detail, uploaded: __upN, failed: __failN };
+}
+return { ok: true, id: String(__pub.id == null ? "" : __pub.id), url: __pub.url || "", draft: !!__pub.draft, uploaded: __upN, failed: __failN };
+})()`}export async function publishArticle(K,Q){const{title:X,body:Z,format:G="auto",draftOnly:D=!1,profile:q,publishParams:k=null}=Q;if(!q)throw Error("publishArticle: profile is required");if(!q.home)throw Error("publishArticle: profile.home is required");if(typeof q.publish!=="function")throw Error("publishArticle: profile.publish must be a function");C(Z,{fileFlag:"--file"});const W=H(Z,{format:G}),w=q.outputFormat==="markdown"||q.needsMarkdown===!0,L=q.outputFormat==="html"||q.needsHtml===!0,_=w?await U(W.markdown):{content:null,missing:[]},z=L?await U(W.html):{content:null,missing:[]},A=_.content,J=z.content,y=q.outputFormat==="markdown"?A:J,N=[],T=new Set;for(const V of[..._.missing,...z.missing]){if(T.has(V.src))continue;T.add(V.src);N.push(V)}let Y=k;if(Y&&typeof Y.cover==="string"&&Y.cover){const V=Y.cover.trim();if(/["<>\s]/.test(V))throw new O("封面图路径/URL 含非法字符（引号/尖括号/空白）："+V.slice(0,120));if(I(V))try{const{dataUri:$}=await E(V);Y={...Y,cover:$}}catch($){throw new O("封面图读取失败："+V+"（"+String($&&$.message||$)+"）")}else Y={...Y,cover:V}}await gotoWritePage(K,q.home,q.originRe);const R={title:X,content:y,markdown:q.needsMarkdown===!0&&q.outputFormat!=="markdown"?A:null,html:q.needsHtml===!0&&q.outputFormat!=="html"?J:null,draftOnly:!!D,outputFormat:q.outputFormat,preprocessConfig:q.preprocessConfig||null,imageSpec:q.image?.spec||null,imageSkip:q.image?.skip||[],imageAllowRelative:q.image?.allowRelative===!0,publishParams:Y},j=typeof q.image?.uploadFn==="function"?q.image.uploadFn.toString():null,x=buildPublishJs(R,q.publish.toString(),j),B=await K.evaluate(x);if(!B||B.ok===!1){const V=B?.stage||"publish",$=B?.status!=null?` (HTTP ${B.status})`:"",M=B?.detail!=null?`；接口原始响应：${typeof B.detail==="string"?B.detail:JSON.stringify(B.detail)}`:"";throw new O(`[${V}] ${B?.message||"发布失败"}${$}${M}`)}return{id:B.id,url:B.url,draft:B.draft,images:{uploaded:B.uploaded||[],failed:(B.failed||[]).concat(N)}}}export const __test__={selectContent,originReFromHome,buildPublishJs,publishArticle};

package/clis/_shared/common.js

@@ -0,0 +1 @@
+import{ArgumentError as G}from"@jackwener/opencli/errors";export function clamp(B,q,y){return Math.max(q,Math.min(B,y))}export function clampInt(B,q,y,D){const F=Number(B);if(!Number.isFinite(F))return q;return clamp(Math.floor(F),y,D)}export function normalizeNumericId(B,q,y){const D=String(B??"").trim();if(!/^\d+$/.test(D))throw new G(`${q} must be a numeric ID`,`Pass a numeric ${q}, for example: ${y}`);return D}export function requireNonEmptyQuery(B,q="query"){const y=String(B??"").trim();if(!y)throw new G(`${q} cannot be empty`);return y}

package/clis/_shared/content-guard.js

@@ -0,0 +1 @@
+import*as J from"node:fs";import*as K from"node:os";import{ArgumentError as G}from"@jackwener/opencli/errors";const M=/^@(?:\/|~\/|\.{1,2}\/)\S+$/,N=/^(?:\/|~\/)\S+$/;function O(y){return y.startsWith("~/")?`${K.homedir()}/${y.slice(2)}`:y}export function assertLiteralContent(y,{fileFlag:C=null,label:q="正文"}={}){const h=String(y??"").trim();if(!h)return h;const D=C?(z)=>`请改用 ${C} ${z}，或把文件内容读出来作为${q}传入`:()=>`本命令没有文件参数，请把文件内容读出来作为${q}传入`;if(M.test(h))throw new G(`${q} "${h}" 看起来是文件引用——命令不会展开 @路径，照发会把这串字面量当${q}。${D(h.slice(1))}`);if(N.test(h)){let z=!1;try{z=J.statSync(O(h)).isFile()}catch{}if(z)throw new G(`${q} "${h}" 是一个本机已存在的文件路径——照发会把这串路径当${q}发出去。${D(h)}`)}return h}

package/clis/_shared/desktop-commands.js

@@ -0,0 +1 @@
+import*as G from"node:fs";import{cli as H,Strategy as I}from"@jackwener/opencli/registry";export function makeScreenshotCommand(b,q,A={}){return H({...A,site:b,name:"screenshot",access:"read",description:`Capture a snapshot of the current ${q??b} window (DOM + Accessibility tree)`,domain:"localhost",strategy:I.UI,browser:!0,args:[{name:"output",required:!1,help:`Output file path (default: /tmp/${b}-snapshot.txt)`}],columns:["Status","File"],func:async(z,B)=>{const E=B.output||`/tmp/${b}-snapshot.txt`,J=await z.snapshot({compact:!0}),Q=await z.evaluate("document.documentElement.outerHTML"),K=E.replace(/\.\w+$/,"")+"-dom.html",L=E.replace(/\.\w+$/,"")+"-a11y.txt";G.writeFileSync(K,Q);G.writeFileSync(L,typeof J==="string"?J:JSON.stringify(J,null,2));return[{Status:"Success",File:K},{Status:"Success",File:L}]}})}export function makeStatusCommand(b,q,A={}){return H({...A,site:b,name:"status",access:"read",description:`Check active CDP connection to ${q??b}`,domain:"localhost",strategy:I.UI,browser:!0,columns:["Status","Url","Title"],func:async(z)=>{const B=await z.evaluate("window.location.href"),E=await z.evaluate("document.title");return[{Status:"Connected",Url:B,Title:E}]}})}export function makeNewCommand(b,q,A={}){return H({...A,site:b,name:"new",access:"write",description:`Start a new ${q??b} session`,domain:"localhost",strategy:I.UI,browser:!0,columns:["Status"],func:async(z)=>{const B=process.platform==="darwin";await z.pressKey(B?"Meta+N":"Control+N");await z.wait(1);return[{Status:"Success"}]}})}export function makeDumpCommand(b){return H({site:b,name:"dump",access:"read",description:`Dump the DOM and Accessibility tree of ${b} for reverse-engineering`,domain:"localhost",strategy:I.UI,browser:!0,columns:["action","files"],func:async(q)=>{const A=await q.evaluate("document.body.innerHTML");G.writeFileSync(`/tmp/${b}-dom.html`,A);const C=await q.snapshot({interactive:!1});G.writeFileSync(`/tmp/${b}-snapshot.json`,JSON.stringify(C,null,2));return[{action:"Dom extraction finished",files:`/tmp/${b}-dom.html, /tmp/${b}-snapshot.json`}]}})}

package/clis/_shared/search-adapter.js

@@ -0,0 +1 @@
+import{ArgumentError as u,CommandExecutionError as c,EmptyResultError as a}from"@jackwener/opencli/errors";export function requireSearchQuery(r,t="keyword"){const e=String(r??"").trim();if(!e)throw new u(`${t} cannot be empty`);return e}export function requireBoundedInteger(r,t,e,n,o){const s=r??t,i=typeof s==="number"?s:Number(s);if(!Number.isInteger(i))throw new u(`${o} must be an integer between ${e} and ${n}, got ${JSON.stringify(r)}`);if(i<e||i>n)throw new u(`${o} must be between ${e} and ${n}, got ${i}`);return i}export function requireNonNegativeInteger(r,t,e){const n=r??t,o=typeof n==="number"?n:Number(n);if(!Number.isInteger(o)||o<0)throw new u(`${e} must be a non-negative integer, got ${JSON.stringify(r)}`);return o}export function unwrapBrowserResult(r){if(r&&typeof r==="object"&&!Array.isArray(r)&&"session"in r&&"data"in r)return r.data;return r}export function requireRows(r,t){const e=unwrapBrowserResult(r);if(!Array.isArray(e))throw new c(`${t} returned an unexpected payload shape; expected an array of result rows.`);return e}export function toHttpsUrl(r,t){const e=String(r??"").trim();if(!e)return"";try{const n=new URL(e,t);if(n.protocol!=="http:"&&n.protocol!=="https:")return"";return n.href}catch{return""}}export function emptySearchResults(r,t){return new a(`${r} search`,`No ${r} results matched "${t}".`)}export async function runBrowserStep(r,t){try{return await t()}catch(e){if(e?.code||e?.name==="ArgumentError")throw e;throw new c(`${r} failed: ${e?.message??e}`)}}

package/clis/_shared/site-auth.js

@@ -0,0 +1 @@
+import{AuthRequiredError as q,TimeoutError as z,getErrorMessage as N}from"@jackwener/opencli/errors";import{cli as $,Strategy as Q}from"@jackwener/opencli/registry";const V=300,b=2000;function D(v,x){const G=x&&typeof x==="object"&&!Array.isArray(x)?x:{};return{logged_in:!0,site:v,...G}}function j(v){return v instanceof q}async function Y(v,x,G){const K=G==="poll"&&v.poll?v.poll:v.verify;return D(v.site,await K(x,{phase:G}))}async function J(v){if(typeof v?.closeWindow==="function")try{await v.closeWindow()}catch{}}function F(v){return`Run \`opencli ${v.site} login\` to open the login page, then retry.`}function H(v){return["logged_in","site",...v.columns??["id","username","name"]]}function I(v){if(typeof v==="boolean")return{logged_in:v};if(v&&typeof v==="object"&&!Array.isArray(v))return{logged_in:!!v.logged_in,...v};return{logged_in:!1}}function P(v){if(v&&typeof v==="object"&&!Array.isArray(v))return v;return{touched:!0}}export function registerSiteAuthCommands(v){if(!v?.site||!v?.domain||!v?.loginUrl||typeof v.verify!=="function")throw Error("registerSiteAuthCommands requires site, domain, loginUrl, and verify(page)");$({site:v.site,name:"whoami",access:"read",description:v.whoamiDescription??`Show the current logged-in ${v.site} account`,domain:v.domain,strategy:Q.COOKIE,browser:!0,navigateBefore:!1,siteSession:"persistent",args:[],columns:H(v),authStatus:{...typeof v.quickCheck==="function"?{quickCheck:async(x)=>I(await v.quickCheck(x))}:{},...v.quickCheckRequiresNavigation===!0?{quickCheckRequiresNavigation:!0}:{},...typeof v.refresh==="function"?{refresh:async(x,G)=>P(await v.refresh(x,G))}:{}},func:async(x)=>Y(v,x,"identity")});$({site:v.site,name:"login",access:"write",description:v.loginDescription??`Open ${v.site} login and wait until the browser session is authenticated`,domain:v.domain,strategy:Q.COOKIE,browser:!0,navigateBefore:!1,defaultWindowMode:"foreground",siteSession:"persistent",args:[{name:"timeout",type:"int",default:V,help:"Maximum seconds to wait for the user to finish login"}],columns:["status",...H(v)],func:async(x,G)=>{try{const B={status:"already_logged_in",...await Y(v,x,"identity")};await J(x);return B}catch(B){if(!j(B)){await J(x);throw B}}await x.goto(v.loginUrl);const K=Number(G.timeout??V),Z=Date.now()+K*1000;let X="";while(Date.now()<Z){await x.wait(Math.min(b/1000,Math.max(0.2,(Z-Date.now())/1000)));try{const B=await Y(v,x,"poll");await J(x);return{status:"login_complete",...B}}catch(B){if(!j(B)){await J(x);throw B}X=N(B)}}await J(x);throw new z(`${v.site} login`,K,X?`${F(v)} Last auth check: ${X}`:F(v))}})}

package/clis/_shared/token-auth.js

@@ -0,0 +1,2 @@
+import*as D from"node:fs";import*as O from"node:os";import*as K from"node:path";import{cli as L,Strategy as M}from"@jackwener/opencli/registry";import{ArgumentError as Q,AuthRequiredError as T}from"@jackwener/opencli/errors";function I(b){return K.join(O.homedir(),".opencli","sites",b,"credentials.json")}export function loadCredentials(b){try{return JSON.parse(D.readFileSync(I(b),"utf8"))}catch(x){if(x&&x.code==="ENOENT")return null;throw x}}export function saveCredentials(b,x){const z=I(b);D.mkdirSync(K.dirname(z),{recursive:!0});D.writeFileSync(z,`${JSON.stringify(x,null,2)}
+`,{mode:384});try{D.chmodSync(z,384)}catch{}}export function clearCredentials(b){try{D.rmSync(I(b));return!0}catch(x){if(x&&x.code==="ENOENT")return!1;throw x}}export function requireCredentials(b){const x=loadCredentials(b);if(!x)throw new T(b,`${b} not configured. Run \`opencli ${b} login\` with your credentials first.`);return x}export function registerTokenAuth(b){if(!b?.site||!b?.domain||!Array.isArray(b.fields)||typeof b.validate!=="function")throw Error("registerTokenAuth requires site, domain, fields[], and validate(creds)");const x=b.identityColumns??["id","username","name"];L({site:b.site,name:"whoami",access:"read",description:b.whoamiDescription??`Show the configured ${b.site} account`,domain:b.domain,strategy:M.LOCAL,browser:!1,args:[],columns:["logged_in","site",...x],func:async()=>{const z=requireCredentials(b.site),F=await b.validate(z);return{logged_in:!0,site:b.site,...F}}});L({site:b.site,name:"login",access:"write",description:b.loginDescription??`Configure ${b.site} credentials (token/key based, no browser). Pass each field as a flag.`,domain:b.domain,strategy:M.LOCAL,browser:!1,args:b.fields.map((z)=>({name:z.name,type:"string",required:!1,help:z.help??`${b.site} ${z.name}`,...z.default!==void 0?{default:z.default}:{}})),columns:["status","logged_in","site",...x],func:async(z)=>{const F=loadCredentials(b.site)??{},G={};for(const B of b.fields){const H=z[B.name]??F[B.name]??B.default;if(H!==void 0&&H!==null&&H!=="")G[B.name]=H}const J=b.fields.filter((B)=>B.required!==!1&&G[B.name]===void 0);if(J.length)throw new Q(`Missing required credential(s): ${J.map((B)=>`--${B.name}`).join(", ")}`,`Run \`opencli ${b.site} login -h\` to see all fields.`);const N=await b.validate(G);saveCredentials(b.site,G);return{status:Object.keys(F).length?"updated":"login_complete",logged_in:!0,site:b.site,...N}}})}

package/clis/_shared/video-publish.js

@@ -0,0 +1,62 @@
+import*as Z from"node:fs";import*as L from"node:path";import{ArgumentError as J,CommandExecutionError as Y}from"@jackwener/opencli/errors";export const SUPPORTED_VIDEO_EXTENSIONS=new Set([".mp4",".mov",".avi",".mkv",".m4v",".webm",".flv",".wmv"]),SUPPORTED_IMAGE_EXTENSIONS=new Set([".jpg",".jpeg",".png",".webp",".bmp"]);export function parseScheduleDate(q){if(q==null||q==="")return null;const y=String(q),z=/^\d+$/.test(y)?new Date(Number(y)<1000000000000?Number(y)*1000:Number(y)):new Date(y);if(Number.isNaN(z.getTime()))throw new J(`无法解析定时时间: ${q}`);if(z.getTime()<=Date.now())throw new J("定时发布时间必须晚于当前时间");return z}export function unwrap(q){if(q&&typeof q==="object"&&"data"in q&&"session"in q)return q.data;return q}export async function evalPage(q,y){return unwrap(await q.evaluate(y))}export function sleep(q){return new Promise((y)=>setTimeout(y,q*1000))}export function resolveVideoFile(q){const y=L.resolve(String(q));let z;try{z=Z.statSync(y)}catch{throw new J(`视频文件不存在: ${y}`)}if(!z.isFile())throw new J(`视频路径不是文件: ${y}`);const B=L.extname(y).toLowerCase();if(!SUPPORTED_VIDEO_EXTENSIONS.has(B))throw new J(`不支持的视频格式: ${B}（支持 ${[...SUPPORTED_VIDEO_EXTENSIONS].join("/")}）`);return y}export function resolveImageFile(q){const y=L.resolve(String(q));let z;try{z=Z.statSync(y)}catch{throw new J(`图片文件不存在: ${y}`)}if(!z.isFile())throw new J(`图片路径不是文件: ${y}`);const B=L.extname(y).toLowerCase();if(!SUPPORTED_IMAGE_EXTENSIONS.has(B))throw new J(`不支持的图片格式: ${B}（支持 ${[...SUPPORTED_IMAGE_EXTENSIONS].join("/")}）`);return y}export function throwIfFileAccessDenied(q){if(!(q instanceof Error?q.message:String(q)).includes("Not allowed"))return;throw new Y("Chrome 拦截了扩展读取本地文件（DOM.setFileInputFiles → Not allowed）：商店安装的扩展默认没有本地文件访问权限","请让用户在 Chrome 打开 chrome://extensions，找到「OpenCLI Browser Bridge」→「详情」→ 打开「允许访问文件网址」（Allow access to file URLs），开关即时生效，然后重试本命令")}export async function setVideoInput(q,y,z){if(!q.setFileInput)throw new Y("浏览器扩展不支持 CDP 文件上传（set-file-input），无法上传视频；请升级 PublishPort 客户端/扩展");let B;for(const H of y)try{await q.setFileInput(z,H);return H}catch(K){throwIfFileAccessDenied(K);B=K}throw new Y(`未找到可用的文件上传输入框（尝试过: ${y.join(" , ")}）：${B instanceof Error?B.message:String(B)}`)}export async function currentUrl(q){try{if(q.getCurrentUrl){const y=await q.getCurrentUrl();if(y)return String(y)}}catch{}try{return String(await evalPage(q,"() => location.href")||"")}catch{return""}}export async function waitForUrlIncludes(q,y,z=60000,B=500){const H=Array.isArray(y)?y:[y],K=Date.now()+z;while(Date.now()<K){const Q=await currentUrl(q);if(Q&&H.some(($)=>Q.includes($)))return!0;await q.wait({time:B/1000})}return!1}export async function countByText(q,y){return Number(unwrap(await q.evaluate(`
+    ((want) => {
+      let n = 0;
+      const nodes = document.querySelectorAll('body *');
+      for (const el of nodes) {
+        if (el.children.length) continue;
+        const t = (el.innerText || el.textContent || '').trim();
+        if (t && t.includes(want)) {
+          const r = el.getBoundingClientRect();
+          if (r.width > 0 && r.height > 0) n += 1;
+        }
+      }
+      return n;
+    })(${JSON.stringify(y)})
+  `)))||0}export async function clickByText(q,y,{exact:z=!1,timeoutMs:B=0,pollMs:H=500}={}){const K=Date.now()+Math.max(0,B);for(;;){if(Boolean(unwrap(await q.evaluate(`
+      ((want, exact) => {
+        const norm = (v) => (v || '').replace(/\\s+/g, ' ').trim();
+        const isVisible = (el) => {
+          if (!el || el.offsetParent === null) return false;
+          const r = el.getBoundingClientRect();
+          return r.width > 0 && r.height > 0;
+        };
+        const nodes = Array.from(document.querySelectorAll('button, [role="button"], a, label, li, span, div, p'));
+        const matches = nodes.filter((n) => {
+          if (!isVisible(n)) return false;
+          const t = norm(n.innerText || n.textContent);
+          return exact ? t === want : (t && t.includes(want));
+        });
+        // Prefer the innermost match (deepest node) so the real handler fires.
+        const innermost = matches.filter((n) => !matches.some((o) => o !== n && n.contains(o)));
+        const ordered = innermost.length ? innermost : matches;
+        for (const node of ordered) {
+          const clickable = node.closest('button, [role="button"], a, label') || node;
+          if (clickable.disabled) continue;
+          clickable.click();
+          return true;
+        }
+        return false;
+      })(${JSON.stringify(y)}, ${z?"true":"false"})
+    `))))return!0;if(Date.now()>=K)return!1;await q.wait({time:H/1000})}}export async function existsByText(q,y,{exact:z=!1}={}){return Boolean(unwrap(await q.evaluate(`
+    ((want, exact) => {
+      const norm = (v) => (v || '').replace(/\\s+/g, ' ').trim();
+      const isVisible = (el) => {
+        if (!el || el.offsetParent === null) return false;
+        const r = el.getBoundingClientRect();
+        return r.width > 0 && r.height > 0;
+      };
+      for (const n of document.querySelectorAll('body *')) {
+        if (!isVisible(n)) continue;
+        const t = norm(n.innerText || n.textContent);
+        if (exact ? t === want : (t && t.includes(want))) return true;
+      }
+      return false;
+    })(${JSON.stringify(y)}, ${z?"true":"false"})
+  `)))}export async function waitForSelector(q,y,z=30000,B=500){const H=Date.now()+z;while(Date.now()<H){if(Boolean(unwrap(await q.evaluate(`
+      ((sel) => {
+        const el = document.querySelector(sel);
+        if (!el) return false;
+        const r = el.getBoundingClientRect();
+        return r.width > 0 && r.height > 0;
+      })(${JSON.stringify(y)})
+    `))))return!0;await q.wait({time:B/1000})}return!1}

package/clis/aibase/news.js

@@ -0,0 +1,31 @@
+import{cli as h,Strategy as f}from"@jackwener/opencli/registry";import{ArgumentError as c,CommandExecutionError as s,EmptyResultError as d,getErrorMessage as b}from"@jackwener/opencli/errors";const g="https://www.aibase.com/zh/daily",a=20,o=50;function l(e){const r=Number(e??a);if(!Number.isInteger(r)||r<=0)throw new c("limit must be a positive integer",`Example: opencli aibase news --limit ${a}`);if(r>o)throw new c(`limit must be <= ${o}`,`Example: opencli aibase news --limit ${o}`);return r}function u(e){return String(e??"").replace(/\s+/g," ").trim()}function m(){return`
+      (() => {
+        const anchors = Array.from(document.querySelectorAll('.bg-white .grid a[href], a[href*="/zh/daily/"]'))
+          .filter((anchor) => {
+            const href = anchor.getAttribute('href') || '';
+            const text = (anchor.innerText || anchor.textContent || '').trim();
+            return text && href && !href.endsWith('/zh/daily') && !href.endsWith('/zh/daily/');
+          });
+        if (anchors.length === 0) {
+          return {
+            ok: false,
+            reason: 'selector-missing',
+            title: document.title || '',
+            bodyText: (document.body?.innerText || document.body?.textContent || '').slice(0, 500),
+          };
+        }
+        const seen = new Set();
+        const rows = [];
+        for (const anchor of anchors) {
+          const url = new URL(anchor.getAttribute('href'), location.href).href;
+          if (seen.has(url)) continue;
+          seen.add(url);
+          rows.push({
+            rank: rows.length + 1,
+            title: anchor.innerText || anchor.textContent || '',
+            url,
+          });
+        }
+        return { ok: true, rows };
+      })()
+    `}function w(e,i){if(!e||typeof e!=="object")throw new s("AIbase daily page returned an unreadable payload");if(!e.ok){const t=typeof e.reason==="string"&&e.reason.trim()?e.reason.trim():"selector-drift";throw new s(`AIbase daily selector drift: ${t}`,e.title?`Page title: ${e.title}`:void 0)}const r=(Array.isArray(e.rows)?e.rows:[]).map((t,n)=>({rank:n+1,title:u(t.title),url:u(t.url)})).filter((t)=>t.title&&t.url);if(r.length===0)throw new d("aibase news","AIbase daily page loaded, but no article rows with title and URL were extracted.");return r.slice(0,i).map((t,n)=>({...t,rank:n+1}))}async function A(e,i){const r=l(i.limit);await e.goto(g,{waitUntil:"load",settleMs:3000});const t=await e.evaluate(m()).catch((n)=>{throw new s(`Failed to extract AIbase daily news: ${b(n)}`)});return w(t,r)}export const aibaseNewsCommand=h({site:"aibase",name:"news",access:"read",description:"AIbase 日报 - 每天三分钟关注AI行业趋势",domain:"www.aibase.com",strategy:f.PUBLIC,browser:!0,args:[{name:"limit",type:"int",default:a,help:`Number of news items to return (max ${o})`}],columns:["rank","title","url"],func:A}),__test__={buildExtractAibaseNewsJs:m,normalizeLimit:l,toRows:w};

package/clis/amazon/auth.js

@@ -0,0 +1,19 @@
+import{AuthRequiredError as i,CommandExecutionError as r}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as s}from"../_shared/site-auth.js";async function a(n){const e=await n.getCookies({url:"https://www.amazon.com"}),o=new Set(e.filter((t)=>t.value).map((t)=>t.name));return o.has("at-main")||o.has("x-main")}async function m(n){if(!await a(n))throw new i("amazon.com","Amazon auth cookies (at-main / x-main) are missing");await n.goto("https://www.amazon.com/",{waitUntil:"load"});await n.wait(3);const e=await n.evaluate(`
+    (() => {
+      const navLink = document.querySelector('#nav-link-accountList');
+      if (!navLink) {
+        return { kind: 'auth', detail: 'Amazon header missing nav-link-accountList — layout changed or robot challenge' };
+      }
+      const greeting = (navLink.querySelector('.nav-line-1, #nav-link-accountList-nav-line-1') || {}).textContent || '';
+      const trimmed = greeting.trim();
+      if (/sign\\s*in/i.test(trimmed)) {
+        return { kind: 'auth', detail: 'Amazon header shows "Hello, sign in" — anonymous' };
+      }
+      const m = trimmed.match(/^Hello,?\\s+(.+)$/i);
+      const name = m ? m[1].trim() : '';
+      if (!name) {
+        return { kind: 'auth', detail: 'Amazon greeting unparseable: ' + trimmed };
+      }
+      return { ok: true, user_name: name };
+    })()
+  `);if(e?.kind==="auth")throw new i("amazon.com",e.detail);if(!e?.ok)throw new r(`Unexpected Amazon probe: ${JSON.stringify(e)}`);return{user_name:e.user_name}}s({site:"amazon",domain:"amazon.com",loginUrl:"https://www.amazon.com/ap/signin?openid.return_to=https%3A%2F%2Fwww.amazon.com%2F&openid.identity=http%3A%2F%2Fspecs.openid.net%2Fauth%2F2.0%2Fidentifier_select&openid.assoc_handle=usflex&openid.mode=checkid_setup&openid.claimed_id=http%3A%2F%2Fspecs.openid.net%2Fauth%2F2.0%2Fidentifier_select&openid.ns=http%3A%2F%2Fspecs.openid.net%2Fauth%2F2.0",columns:["user_name"],quickCheck:a,verify:m,poll:async(n)=>{if(!await a(n))throw new i("amazon.com","Waiting for Amazon at-main / x-main cookie");return m(n)}});

package/clis/amazon/bestsellers.js

@@ -0,0 +1 @@
+import{cli as e}from"@jackwener/opencli/registry";import{createRankingCliOptions as s}from"./rankings.js";e(s({commandName:"bestsellers",access:"read",listType:"bestsellers",description:"Amazon Best Sellers pages for category candidate discovery"}));

package/clis/amazon/discussion.js

@@ -0,0 +1,20 @@
+import{AuthRequiredError as x,CommandExecutionError as m}from"@jackwener/opencli/errors";import{cli as p,Strategy as y}from"@jackwener/opencli/registry";import{buildProductUrl as S,buildDiscussionUrl as v,buildProvenance as q,cleanText as r,extractAsin as C,normalizeProductUrl as b,parseRatingValue as _,parseReviewCount as k,trimRatingPrefix as z,uniqueNonEmpty as A,assertUsableState as w,gotoAndReadState as h}from"./shared.js";function g(e){const t=r(e.href)||v(e.href??""),a=C(e.href??"")??null,s=r(e.average_rating_text)||null,i=r(e.total_review_count_text)||null,n=q(t);return{asin:a,product_url:a?b(a):null,discussion_url:t,...n,average_rating_text:s,average_rating_value:_(s),total_review_count_text:i,total_review_count:k(i),qa_urls:A(e.qa_links??[]),review_samples:(e.review_samples??[]).map((o)=>({title:z(o.title)||null,rating_text:r(o.rating_text)||null,rating_value:_(o.rating_text),author:r(o.author)||null,date_text:r(o.date_text)||null,body:r(o.body)||null,verified_purchase:o.verified===!0}))}}function c(e){return Boolean(r(e.average_rating_text)||r(e.total_review_count_text))}function u(e){const t=r(e.href).toLowerCase(),a=r(e.title).toLowerCase();return t.includes("/ap/signin")||a.includes("amazon sign-in")}async function f(e,t){return await e.evaluate(`
+    (() => ({
+      href: window.location.href,
+      title: document.title || '',
+      average_rating_text: document.querySelector('[data-hook="rating-out-of-text"]')?.textContent || '',
+      total_review_count_text: document.querySelector('[data-hook="total-review-count"]')?.textContent || '',
+      qa_links: Array.from(document.querySelectorAll('a[href*="ask/questions"]')).map((anchor) => anchor.href || ''),
+      review_samples: Array.from(document.querySelectorAll('[data-hook="review"]')).slice(0, ${t}).map((card) => ({
+        title: card.querySelector('[data-hook="review-title"]')?.textContent || '',
+        rating_text:
+          card.querySelector('[data-hook="review-star-rating"]')?.textContent
+          || card.querySelector('[data-hook="cmps-review-star-rating"]')?.textContent
+          || '',
+        author: card.querySelector('.a-profile-name')?.textContent || '',
+        date_text: card.querySelector('[data-hook="review-date"]')?.textContent || '',
+        body: card.querySelector('[data-hook="review-body"]')?.textContent || '',
+        verified: !!card.querySelector('[data-hook="avp-badge"]'),
+      })),
+    }))()
+  `)}async function P(e,t,a){const s=v(t),i=await h(e,s,2500,"discussion");w(i,"discussion");const n=await f(e,a);if(c(n))return n;const o=S(t),l=await h(e,o,2500,"discussion");w(l,"discussion");if(u(i)&&u(l))throw new x("amazon.com","Amazon review discussion requires an active signed-in Amazon session in the shared Chrome profile.");const d=await f(e,a);if(c(d))return d;if(u(i))throw new m("amazon review page redirected to sign-in and product page fallback did not expose review summary","Open the product page in Chrome, verify reviews are visible, and retry.");return n}p({site:"amazon",name:"discussion",access:"read",description:"Amazon review summary and sample customer discussion from product review pages",domain:"amazon.com",strategy:y.COOKIE,navigateBefore:!1,args:[{name:"input",required:!0,positional:!0,help:"ASIN or product URL, for example B0FJS72893"},{name:"limit",type:"int",default:10,help:"Maximum number of review samples to return (default 10)"}],columns:["asin","average_rating_value","total_review_count"],func:async(e,t)=>{const a=String(t.input??""),s=Math.max(1,Number(t.limit)||10),i=await P(e,a,s),n=g(i);if(!n.average_rating_text&&!n.total_review_count_text)throw new m("amazon discussion page did not expose review summary","The review page may have changed or hit a robot check. Open the review page in Chrome and retry.");return[n]}});export const __test__={normalizeDiscussionPayload:g,hasDiscussionSummary:c,isSignInState:u};

package/clis/amazon/movers-shakers.js

@@ -0,0 +1 @@
+import{cli as r}from"@jackwener/opencli/registry";import{createRankingCliOptions as s}from"./rankings.js";r(s({commandName:"movers-shakers",access:"read",listType:"movers_shakers",description:"Amazon Movers & Shakers pages for short-term growth signals"}));

package/clis/amazon/new-releases.js

@@ -0,0 +1 @@
+import{cli as e}from"@jackwener/opencli/registry";import{createRankingCliOptions as s}from"./rankings.js";e(s({commandName:"new-releases",access:"read",listType:"new_releases",description:"Amazon New Releases pages for early momentum discovery"}));

package/clis/amazon/offer.js

@@ -0,0 +1,29 @@
+import{CommandExecutionError as $}from"@jackwener/opencli/errors";import{cli as L,Strategy as _}from"@jackwener/opencli/registry";import{buildProductUrl as Y,buildProvenance as j,cleanText as K,extractAsin as U,isAmazonEntity as M,normalizeProductUrl as C,PRIMARY_PRICE_SELECTORS as I,parsePriceText as k,assertUsableState as B,gotoAndReadState as O}from"./shared.js";const R=["#sellerProfileTriggerId","#shipsFromSoldByInsideBuyBox_feature_div","#fulfillerInfoFeature_feature_div","#merchantInfoFeature_feature_div","#tabular-buybox-container","#merchant-info"].join(", ");function W(q){const H=K(q).split(" ").filter(Boolean),G=[];for(const J of H){if(G[G.length-1]===J)continue;G.push(J)}return G.join(" ")}function Q(q){const G=K(q).match(/Ships from\s+(.+?)(?=Sold by|and Fulfilled by|$)/i);return G?W(G[1].replace(/Ships from/ig,"")):null}function V(q){const G=K(q).match(/Sold by\s+(.+?)(?=and Fulfilled by|Ships from|$)/i);return G?W(G[1]):null}function D(q){const H=K(q).toLowerCase();return H.includes("cannot be shipped to your selected delivery location")||H.includes("similar items shipping to")||H.includes("deliver to hong kong")}function v(q){const H=U(q.href??"")??null,G=K(q.href)||Y(q.href??""),J=k(q.price_text),N=K(q.merchant_info)||null,X=K(q.sold_by)||V(q.ships_from_text??"")||V(N??"")||null,Z=Q(q.ships_from_text??"")||Q(N??"")||K(q.ships_from_text)||null,w=j(G);return{asin:H,product_url:C(q.href),...w,price_text:J.price_text,price_value:J.price_value,currency:J.currency,merchant_info_text:N,sold_by:X,ships_from:Z,offer_listing_url:K(q.offer_link)||null,review_url:K(q.review_url)||null,qa_url:K(q.qa_url)||null,is_amazon_sold:M(X),is_amazon_fulfilled:M(Z)||/fulfilled by amazon/i.test(N??"")}}async function b(q,H){const G=Y(H),J=await O(q,G,2500,"offer");B(J,"offer");await q.wait({selector:R,timeout:6}).catch(()=>{});return await q.evaluate(`
+    (() => ({
+      href: window.location.href,
+      title: document.title || '',
+      price_text: (() => {
+        const selectors = ${JSON.stringify(I)};
+        for (const selector of selectors) {
+          const text = document.querySelector(selector)?.textContent || '';
+          if (text.trim()) return text;
+        }
+        return '';
+      })(),
+      merchant_info: document.querySelector('#merchant-info')?.textContent || '',
+      sold_by: document.querySelector('#sellerProfileTriggerId')?.textContent || '',
+      ships_from_text:
+        document.querySelector('#shipsFromSoldByInsideBuyBox_feature_div')?.textContent
+        || document.querySelector('#fulfillerInfoFeature_feature_div')?.textContent
+        || document.querySelector('#merchantInfoFeature_feature_div')?.textContent
+        || document.querySelector('#tabular-buybox-container')?.textContent
+        || '',
+      offer_link: document.querySelector('a[href*="/gp/offer-listing/"]')?.href || '',
+      review_url: document.querySelector('a[href*="#customerReviews"]')?.href || '',
+      qa_url: document.querySelector('a[href*="ask/questions"]')?.href || '',
+      buybox_text:
+        document.querySelector('#desktop_qualifiedBuyBox')?.textContent
+        || document.querySelector('#buybox')?.textContent
+        || '',
+    }))()
+  `)}L({site:"amazon",name:"offer",access:"read",description:"Amazon seller, buy box, and fulfillment facts from the product page",domain:"amazon.com",strategy:_.COOKIE,navigateBefore:!1,args:[{name:"input",required:!0,positional:!0,help:"ASIN or product URL, for example B0FJS72893"}],columns:["asin","price_text","sold_by","ships_from","is_amazon_sold","is_amazon_fulfilled"],func:async(q,H)=>{const G=String(H.input??""),J=await b(q,G),N=v(J);if(!N.sold_by&&!N.ships_from&&!N.merchant_info_text){if(D(J.buybox_text))throw new $("amazon offer buy box is blocked by the current delivery location","The shared Chrome profile is not set to the target US delivery address. Switch Amazon delivery location to the requested US destination, reopen the product page, and retry.");throw new $("amazon offer surface did not expose seller or fulfillment facts","The product page may have changed. Open the product page in Chrome, make sure the buy box is visible, and retry.")}return[N]}});export const __test__={extractShipsFrom:Q,extractSoldBy:V,isDeliveryLocationBlocked:D,normalizeOfferPayload:v};

package/clis/amazon/product.js

@@ -0,0 +1,25 @@
+import{CommandExecutionError as M}from"@jackwener/opencli/errors";import{cli as V,Strategy as q}from"@jackwener/opencli/registry";import{buildProductUrl as W,buildProvenance as Y,cleanText as F,extractAsin as h,PRIMARY_PRICE_SELECTORS as j,parsePriceText as z,parseRatingValue as A,parseReviewCount as D,normalizeProductUrl as N,uniqueNonEmpty as X,assertUsableState as b,gotoAndReadState as k}from"./shared.js";const Z='#productTitle, #title span, [data-feature-name="title"] h1 span',v='#bylineInfo, [data-feature-name="bylineInfo"] #bylineInfo';function $(f){const H=F(f.href)||W(F(f.product_title)||F(f.href)),J=h(f.href??"")??null,G=z(f.price_text),K=F(f.rating_text)||null,Q=F(f.review_count_text)||null,B=Y(H);return{asin:J,title:F(f.product_title)||F(f.title)||null,product_url:N(f.href),...B,brand_text:F(f.byline)||null,price_text:G.price_text,price_value:G.price_value,currency:G.currency,rating_text:K,rating_value:A(K),review_count_text:Q,review_count:D(Q),review_url:F(f.review_url)||null,qa_url:F(f.qa_url)||null,breadcrumbs:X(f.breadcrumbs??[]),bullet_points:X(f.bullets??[])}}async function I(f,H){const J=W(H),G=await k(f,J,2500,"product");b(G,"product");await f.wait({selector:Z,timeout:6}).catch(()=>{});return await f.evaluate(`
+    (() => ({
+      href: window.location.href,
+      title: document.title || '',
+      product_title: document.querySelector(${JSON.stringify(Z)})?.textContent || '',
+      byline: document.querySelector(${JSON.stringify(v)})?.textContent || '',
+      price_text: (() => {
+        const selectors = ${JSON.stringify(j)};
+        for (const selector of selectors) {
+          const text = document.querySelector(selector)?.textContent || '';
+          if (text.trim()) return text;
+        }
+        return '';
+      })(),
+      rating_text:
+        document.querySelector('#acrPopover')?.getAttribute('title')
+        || document.querySelector('#acrPopover')?.textContent
+        || '',
+      review_count_text: document.querySelector('#acrCustomerReviewText')?.textContent || '',
+      review_url: document.querySelector('a[href*="#customerReviews"]')?.href || '',
+      qa_url: document.querySelector('a[href*="ask/questions"]')?.href || '',
+      bullets: Array.from(document.querySelectorAll('#feature-bullets li .a-list-item')).map((node) => node.textContent || ''),
+      breadcrumbs: Array.from(document.querySelectorAll('#wayfinding-breadcrumbs_feature_div a')).map((node) => node.textContent || ''),
+    }))()
+  `)}V({site:"amazon",name:"product",access:"read",description:"Amazon product page facts for candidate validation",domain:"amazon.com",strategy:q.COOKIE,navigateBefore:!1,args:[{name:"input",required:!0,positional:!0,help:"ASIN or product URL, for example B0FJS72893"}],columns:["asin","title","price_text","rating_value","review_count"],func:async(f,H)=>{const J=String(H.input??""),G=await I(f,J);if(!F(G.product_title))throw new M("amazon product page did not expose product content","The product page may have changed or hit a robot check. Open the product page in Chrome and retry.");return[$(G)]}});export const __test__={normalizeProductPayload:$};

package/clis/amazon/rankings.js

@@ -0,0 +1,68 @@
+import{CommandExecutionError as A}from"@jackwener/opencli/errors";import{Strategy as R}from"@jackwener/opencli/registry";import{assertUsableState as T,buildProvenance as U,cleanText as n,extractAsin as h,extractCategoryNodeId as b,extractReviewCountFromCardText as N,firstMeaningfulLine as P,gotoAndReadState as E,isRankingPaginationUrl as L,normalizeProductUrl as B,parsePriceText as O,parseRatingValue as F,parseReviewCount as I,resolveRankingUrl as K,toAbsoluteAmazonUrl as x,uniqueNonEmpty as v}from"./shared.js";function w(e,t){const a=n(e).match(/(\d{1,4})/);if(!a)return t;const r=Number.parseInt(a[1],10);return Number.isFinite(r)&&r>0?r:t}function C(e){const t=(e??[]).map((r)=>({title:n(r?.title),url:x(r?.url)??"",node_id:n(r?.node_id)||b(r?.url)||null})).filter((r)=>Boolean(r.title)&&Boolean(r.url)),o=new Set,a=[];for(const r of t){if(o.has(r.url))continue;o.add(r.url);a.push(r)}return a}export function normalizeRankingCandidate(e,t){const o=B(e.href),a=h(e.asin??"")??h(o??"")??null,r=n(e.title)||P(e.card_text),l=O(n(e.price_text)||e.card_text),u=n(e.rating_text)||null,m=n(e.review_count_text)||N(e.card_text)||null,c=U(t.sourceUrl),d=t.categoryUrl||t.sourceUrl;return{list_type:t.listType,rank:w(e.rank_text,t.rankFallback),asin:a,title:r||null,product_url:o,price_text:l.price_text,price_value:l.price_value,currency:l.currency,rating_text:u,rating_value:F(u),review_count_text:m,review_count:I(m),list_title:t.listTitle,category_title:t.categoryTitle,category_url:d,category_node_id:b(d),category_path:t.categoryPath,visible_category_links:t.visibleCategoryLinks,...c}}async function M(e,t,o){const a=await E(e,o,2500,t);T(a,t);return await e.evaluate(`
+    (() => ({
+      href: window.location.href,
+      title: document.title || '',
+      list_title:
+        document.querySelector('#zg_banner_text')?.textContent
+        || document.querySelector('h1')?.textContent
+        || '',
+      category_title:
+        document.querySelector('#zg_browseRoot .zg_selected')?.textContent
+        || document.querySelector('#wayfinding-breadcrumbs_feature_div ul li:last-child')?.textContent
+        || document.querySelector('#wayfinding-breadcrumbs_container ul li:last-child')?.textContent
+        || '',
+      category_path: Array.from(document.querySelectorAll(
+        '#zg_browseRoot ul li a, #zg_browseRoot ul li span, ' +
+        '#wayfinding-breadcrumbs_feature_div ul li a, #wayfinding-breadcrumbs_feature_div ul li span.a-list-item, ' +
+        '#wayfinding-breadcrumbs_container ul li a, #wayfinding-breadcrumbs_container ul li span.a-list-item'
+      ))
+        .map((entry) => (entry.textContent || '').trim())
+        .filter(Boolean),
+      cards: Array.from(document.querySelectorAll(
+        '.p13n-sc-uncoverable-faceout, .zg-grid-general-faceout, [data-asin][class*="p13n"]'
+      )).map((card) => ({
+        rank_text:
+          card.querySelector('.zg-bdg-text')?.textContent
+          || card.querySelector('[class*="rank"]')?.textContent
+          || '',
+        asin:
+          card.getAttribute('data-asin')
+          || card.getAttribute('id')
+          || '',
+        title:
+          card.querySelector('[class*="line-clamp"]')?.textContent
+          || card.querySelector('img')?.getAttribute('alt')
+          || card.querySelector('a[href*="/dp/"]')?.textContent
+          || '',
+        href:
+          card.querySelector('a[href*="/dp/"], a[href*="/gp/product/"]')?.href
+          || '',
+        price_text:
+          card.querySelector('.a-price .a-offscreen')?.textContent
+          || card.querySelector('.a-color-price')?.textContent
+          || '',
+        rating_text:
+          card.querySelector('[aria-label*="out of 5 stars"]')?.getAttribute('aria-label')
+          || '',
+        review_count_text:
+          card.querySelector('a[href*="#customerReviews"]')?.textContent
+          || card.querySelector('.a-size-small')?.textContent
+          || '',
+        card_text: card.innerText || '',
+      })),
+      page_links: Array.from(document.querySelectorAll('.a-pagination a[href], li.a-normal a[href], li.a-selected a[href]'))
+        .map((anchor) => anchor.href || '')
+        .filter(Boolean),
+      visible_category_links: Array.from(document.querySelectorAll(
+        '#zg_browseRoot a[href], #zg-left-col a[href], [class*="zg-browse"] a[href]'
+      )).map((anchor) => ({
+        title: (anchor.textContent || '').trim(),
+        url: anchor.href || '',
+        node_id:
+          anchor.getAttribute('data-node-id')
+          || anchor.dataset?.nodeid
+          || '',
+      }))
+        .filter((entry) => entry.title && entry.url),
+    }))()
+  `)}function V(e){return[`Open the same Amazon ${e} page in shared Chrome and verify ranked items are visible.`,"If the page shows a robot check, clear it manually and retry."].join(" ")}export function createRankingCliOptions(e){return{site:"amazon",name:e.commandName,access:e.access??"read",description:e.description,domain:"amazon.com",strategy:R.COOKIE,navigateBefore:!1,args:[{name:"input",positional:!0,help:"Ranking URL or supported Amazon path. Omit to use the list root."},{name:"limit",type:"int",default:100,help:"Maximum number of ranked items to return (default 100)"}],columns:["list_type","rank","asin","title","price_text","rating_value","review_count"],func:async(t,o)=>{const a=Math.max(1,Number(o.limit)||100),l=[K(e.listType,typeof o.input==="string"?o.input:void 0)],u=new Set,m=new Set,c=[];let d=null;while(l.length>0&&c.length<a){const g=l.shift();if(u.has(g))continue;u.add(g);const s=await M(t,e.listType,g),f=n(s.href)||g;d=n(s.list_title)||n(s.title)||d;const p=v(s.category_path??[]),S=n(s.category_title)||(p.length>0?p[p.length-1]:""),k=C(s.visible_category_links),z=s.cards??[];for(const _ of z){const i=normalizeRankingCandidate(_,{listType:e.listType,rankFallback:c.length+1,listTitle:d,sourceUrl:f,categoryTitle:S||null,categoryUrl:f,categoryPath:p,visibleCategoryLinks:k}),y=n(String(i.asin??""))||n(String(i.product_url??""));if(y&&m.has(y))continue;if(y)m.add(y);c.push(i);if(c.length>=a)break}const q=v(s.page_links??[]);for(const _ of q){const i=x(_);if(!i||!L(e.listType,i))continue;if(!u.has(i)&&!l.includes(i))l.push(i)}}if(c.length===0)throw new A(`amazon ${e.commandName} did not expose any ranked items`,V(e.commandName));return c.slice(0,a)}}}export const __test__={parseRank:w,normalizeVisibleCategoryLinks:C,normalizeRankingCandidate};

package/clis/amazon/search.js

@@ -0,0 +1,16 @@
+import{CommandExecutionError as h}from"@jackwener/opencli/errors";import{cli as f,Strategy as x}from"@jackwener/opencli/registry";import{buildProvenance as y,buildSearchUrl as u,cleanText as r,extractAsin as m,normalizeProductUrl as _,parsePriceText as g,parseRatingValue as v,parseReviewCount as b,assertUsableState as S,gotoAndReadState as w}from"./shared.js";function p(e,a,n){const o=_(e.href),s=m(e.asin??"")??m(o??"")??null,c=g(e.price_text),i=r(e.rating_text)||null,t=r(e.review_count_text)||null,l=y(n);return{rank:a,asin:s,title:r(e.title)||null,product_url:o,...l,price_text:c.price_text,price_value:c.price_value,currency:c.currency,rating_text:i,rating_value:v(i),review_count_text:t,review_count:b(t),is_sponsored:e.sponsored===!0,badges:(e.badge_texts??[]).map((d)=>r(d)).filter(Boolean)}}async function q(e,a){const n=u(a),o=await w(e,n,2500,"search");S(o,"search");return await e.evaluate(`
+    (() => ({
+      href: window.location.href,
+      cards: Array.from(document.querySelectorAll('[data-component-type="s-search-result"]'))
+        .map((card) => ({
+          asin: card.getAttribute('data-asin') || '',
+          title: card.querySelector('h2')?.textContent || '',
+          href: card.querySelector('a.a-link-normal[href*="/dp/"]')?.href || '',
+          price_text: card.querySelector('.a-price .a-offscreen')?.textContent || '',
+          rating_text: card.querySelector('[aria-label*="out of 5 stars"]')?.getAttribute('aria-label') || '',
+          review_count_text: card.querySelector('a[href*="#customerReviews"]')?.textContent || '',
+          sponsored: /sponsored/i.test(card.innerText || ''),
+          badge_texts: Array.from(card.querySelectorAll('.a-badge-text')).map((node) => node.textContent || ''),
+        })),
+    }))()
+  `)}f({site:"amazon",name:"search",access:"read",description:"Amazon search results for product discovery and coarse filtering",domain:"amazon.com",strategy:x.COOKIE,navigateBefore:!1,args:[{name:"query",required:!0,positional:!0,help:'Search query, for example "desk shelf organizer"'},{name:"limit",type:"int",default:20,help:"Maximum number of results to return (default 20)"}],columns:["rank","asin","title","price_text","rating_value","review_count"],func:async(e,a)=>{const n=String(a.query??""),o=Math.max(1,Number(a.limit)||20),s=await q(e,n),c=r(s.href)||u(n),i=(s.cards??[]).filter((t)=>r(t.asin)&&r(t.title)).slice(0,o);if(i.length===0)throw new h("amazon search did not expose any product cards","The search page may have changed or hit a robot check. Open the same query in Chrome, verify the page is visible, and retry.");return i.map((t,l)=>p(t,l+1,c))}});export const __test__={normalizeSearchCandidate:p};

package/clis/amazon/shared.js

@@ -0,0 +1,11 @@
+import{ArgumentError as q,CommandExecutionError as K}from"@jackwener/opencli/errors";export const SITE="amazon",DOMAIN="amazon.com",HOME_URL="https://www.amazon.com/",BESTSELLERS_URL="https://www.amazon.com/Best-Sellers/zgbs",NEW_RELEASES_URL="https://www.amazon.com/gp/new-releases",MOVERS_SHAKERS_URL="https://www.amazon.com/gp/movers-and-shakers",SEARCH_URL_PREFIX="https://www.amazon.com/s?k=",PRODUCT_URL_PREFIX="https://www.amazon.com/dp/",DISCUSSION_URL_PREFIX="https://www.amazon.com/product-reviews/",STRATEGY="cookie",PRIMARY_PRICE_SELECTORS=["#corePrice_feature_div .a-offscreen","#corePriceDisplay_desktop_feature_div .a-offscreen","#corePrice_desktop .a-offscreen","#apex_desktop .a-offscreen","#newAccordionRow_0 .a-offscreen","#price_inside_buybox","#priceblock_ourprice","#priceblock_dealprice","#tp_price_block_total_price_ww"];const V=["Sorry, we just need to make sure you're not a robot","Enter the characters you see below","Type the characters you see in this image","To discuss automated access to Amazon data please contact"],f={bestsellers:{commandName:"bestsellers",rootUrl:BESTSELLERS_URL,pathPattern:/(?:^|\/)zgbs(?:\/|$)/i,invalidInputMessage:"amazon bestsellers expects a best sellers URL or /zgbs path",invalidInputHint:"Example: opencli amazon bestsellers https://www.amazon.com/Best-Sellers/zgbs"},new_releases:{commandName:"new-releases",rootUrl:NEW_RELEASES_URL,pathPattern:/\/gp\/new-releases(?:\/|$)/i,invalidInputMessage:"amazon new-releases expects a new releases URL or /gp/new-releases path",invalidInputHint:"Example: opencli amazon new-releases https://www.amazon.com/gp/new-releases"},movers_shakers:{commandName:"movers-shakers",rootUrl:MOVERS_SHAKERS_URL,pathPattern:/\/gp\/movers-and-shakers(?:\/|$)/i,invalidInputMessage:"amazon movers-shakers expects a movers-and-shakers URL or /gp/movers-and-shakers path",invalidInputHint:"Example: opencli amazon movers-shakers https://www.amazon.com/gp/movers-and-shakers"}};export function cleanText(Q){return typeof Q==="string"?Q.replace(/\u00a0/g," ").replace(/\s+/g," ").trim():""}export function cleanMultilineText(Q){return typeof Q==="string"?Q.replace(/\u00a0/g," ").split(`
+`).map((J)=>J.replace(/\s+/g," ").trim()).filter(Boolean).join(`
+`):""}export function uniqueNonEmpty(Q){return[...new Set(Q.map((J)=>cleanText(J)).filter(Boolean))]}export function buildProvenance(Q){return{source_url:Q,fetched_at:new Date().toISOString(),strategy:STRATEGY}}export function buildSearchUrl(Q){const J=cleanText(Q);if(!J)throw new q("amazon search query cannot be empty");return`${SEARCH_URL_PREFIX}${encodeURIComponent(J)}`}export function extractAsin(Q){const J=cleanText(Q);if(!J)return null;if(/^[A-Z0-9]{10}$/i.test(J))return J.toUpperCase();const $=J.match(/\/(?:dp|gp\/product|product-reviews)\/([A-Z0-9]{10})/i);return $?$[1].toUpperCase():null}export function buildProductUrl(Q){const J=extractAsin(Q);if(!J)throw new q("amazon product expects an ASIN or product URL","Example: opencli amazon product B0FJS72893");return`${PRODUCT_URL_PREFIX}${J}`}export function buildDiscussionUrl(Q){const J=extractAsin(Q);if(!J)throw new q("amazon discussion expects an ASIN or product URL","Example: opencli amazon discussion B0FJS72893");return`${DISCUSSION_URL_PREFIX}${J}`}function Y(Q){return f[Q]}export function isSupportedRankingPath(Q,J){try{const $=new URL(J);return Y(Q).pathPattern.test($.pathname)}catch{return!1}}export function resolveRankingUrl(Q,J){const $=Y(Q),j=cleanText(J);if(!j||j==="root")return $.rootUrl;let W;if(j.startsWith("/"))W=new URL(j,HOME_URL).toString();else if(/^https?:\/\//i.test(j))W=canonicalizeAmazonUrl(j);else if(j.includes("amazon.")&&j.includes("/"))W=canonicalizeAmazonUrl(`https://${j.replace(/^\/+/,"")}`);else throw new q($.invalidInputMessage,$.invalidInputHint);if(!isSupportedRankingPath(Q,W))throw new q($.invalidInputMessage,$.invalidInputHint);return w(W)}function w(Q){try{const J=new URL(Q),$=J.pathname.split("/").filter(Boolean).filter((j)=>!/^ref=/i.test(j));J.pathname=`/${$.join("/")}`;J.hash="";J.searchParams.delete("ref");return J.toString()}catch{return Q}}export function isRankingPaginationUrl(Q,J){const $=toAbsoluteAmazonUrl(J);if(!$||!isSupportedRankingPath(Q,$))return!1;try{const j=new URL($),W=cleanText(j.searchParams.get("ref")).toLowerCase();return j.searchParams.has("pg")||/(?:^|_)pg(?:_|$)/.test(W)||/zg_bs(?:nr|ms)?_pg_/.test(W)}catch{return!1}}export function extractCategoryNodeId(Q){const J=toAbsoluteAmazonUrl(Q);if(!J)return null;try{const $=new URL(J);for(const B of["node","nodeid","nodeId","browseNode"]){const G=cleanText($.searchParams.get(B));if(/^\d{4,}$/.test(G))return G}const j=cleanText($.searchParams.get("rh")),W=decodeURIComponent(j).match(/(?:^|,)\s*n:(\d{4,})(?:,|$)/i);if(W)return W[1];const Z=[...$.pathname.matchAll(/\/(\d{4,})(?=\/|$)/g)];if(Z.length>0)return Z[Z.length-1][1]}catch{return null}return null}export function resolveBestsellersUrl(Q){return resolveRankingUrl("bestsellers",Q)}export function canonicalizeAmazonUrl(Q){try{const J=new URL(Q);if(!J.hostname.endsWith(DOMAIN))throw Error("not-amazon");return J.toString()}catch{throw new q("Invalid Amazon URL")}}export function toAbsoluteAmazonUrl(Q){const J=cleanText(Q);if(!J)return null;try{return new URL(J,HOME_URL).toString()}catch{return null}}export function normalizeProductUrl(Q){const J=cleanText(Q),$=extractAsin(J);if($)return buildProductUrl($);return toAbsoluteAmazonUrl(J)}export function parsePriceText(Q){const J=cleanText(Q),$=J.match(/([$€£])\s*(\d+(?:,\d{3})*(?:\.\d+)?)/);if(!$)return{price_text:J||null,price_value:null,currency:null};const j={$:"USD","€":"EUR","£":"GBP"};return{price_text:`${$[1]}${$[2]}`,price_value:Number.parseFloat($[2].replace(/,/g,"")),currency:j[$[1]]??null}}export function parseRatingValue(Q){const $=cleanText(Q).match(/(\d+(?:\.\d+)?)\s*out of 5/i);return $?Number.parseFloat($[1]):null}export function parseReviewCount(Q){const J=cleanText(Q),$=J.match(/(\d+(?:\.\d+)?)\s*([kKmM])/);if($){const W=Number.parseFloat($[1]),Z=/m/i.test($[2])?1e6:1000;return Number.isFinite(W)?Math.round(W*Z):null}const j=J.match(/([\d,]+)/);return j?Number.parseInt(j[1].replace(/,/g,""),10):null}export function extractReviewCountFromCardText(Q){const J=cleanMultilineText(Q),$=J.match(/out of 5 stars(?:, rating details)?\s*([\d,]+)/i);if($)return $[1];return J.split(`
+`).map((W)=>cleanText(W)).find((W)=>/^[\d,]+$/.test(W))??null}export function isAmazonEntity(Q){return cleanText(Q).toLowerCase().includes("amazon")}export function firstMeaningfulLine(Q){return cleanMultilineText(Q).split(`
+`).map((J)=>cleanText(J)).find(Boolean)??""}export function trimRatingPrefix(Q){const J=cleanText(Q);if(!J)return null;return J.replace(/^\d+(?:\.\d+)?\s*out of 5 stars\s*/i,"").trim()||J}export function isRobotState(Q){const J=cleanText(Q.title),$=cleanMultilineText(Q.body_text);return V.some((j)=>J.includes(j)||$.includes(j))}export function buildChallengeHint(Q){return[`Open a clean Amazon ${Q} page in the shared Chrome profile and clear any robot check first.`,"If you are using CDP, set OPENCLI_CDP_TARGET=amazon.com and avoid parallel Amazon commands against the same browser target."].join(" ")}export async function readPageState(Q){const J=await Q.evaluate(`
+    (() => ({
+      href: window.location.href,
+      title: document.title || '',
+      body_text: document.body ? document.body.innerText || '' : '',
+    }))()
+  `);return{href:cleanText(J.href),title:cleanText(J.title),body_text:cleanMultilineText(J.body_text)}}export async function gotoAndReadState(Q,J,$=2500,j="page"){try{await Q.goto(J,{settleMs:$});await Q.wait(1.5);return await readPageState(Q)}catch(W){const Z=W instanceof Error?W.message:String(W);if(Z.includes("Inspected target navigated or closed")||Z.includes("Cannot find context with specified id")||Z.includes("Target closed"))throw new K(`amazon ${j} navigation lost the current browser target`,`${buildChallengeHint(j)} If CDP is attached to a stale tab, open a fresh Amazon tab and retry.`);throw W}}export function assertUsableState(Q,J){if(!isRobotState(Q))return;throw new K(`amazon ${J} hit a robot check`,buildChallengeHint(J))}export const __test__={buildSearchUrl,extractAsin,buildProductUrl,buildDiscussionUrl,resolveBestsellersUrl,resolveRankingUrl,isSupportedRankingPath,isRankingPaginationUrl,extractCategoryNodeId,parsePriceText,parseRatingValue,parseReviewCount,extractReviewCountFromCardText,isAmazonEntity,trimRatingPrefix,isRobotState,PRIMARY_PRICE_SELECTORS};

package/clis/antigravity/SKILL.md

@@ -0,0 +1,38 @@
+---
+description: How to automate Antigravity using OpenCLI
+---
+
+# Antigravity Automation Skill
+
+This skill allows AI agents to control the [Antigravity](https://github.com/chengazhen/Antigravity) desktop app (and any Electron app with CDP enabled) programmatically via OpenCLI. 
+
+## Requirements
+opencli automatically detects, launches (with `--remote-debugging-port=9234`), and connects to Antigravity.
+If Antigravity is already running without CDP, opencli will prompt to restart it.
+
+If the endpoint exposes multiple inspectable targets, set:
+\`\`\`bash
+export OPENCLI_CDP_TARGET="antigravity"
+\`\`\`
+
+## High-Level Capabilities
+1. **Send Messages (`opencli antigravity send <message>`)**: Type and send a message directly into the chat UI.
+2. **Read History (`opencli antigravity read`)**: Scrape the raw chat transcript from the main UI container.
+3. **Extract Code (`opencli antigravity extract-code`)**: Automatically isolate and extract source code text blocks from the AI's recent answers.
+4. **Switch Models (`opencli antigravity model <name>`)**: Instantly toggle the active LLM (e.g., \`gemini\`, \`claude\`).
+5. **Clear Context (`opencli antigravity new`)**: Start a fresh conversation.
+
+## Examples for Automated Workflows
+
+### Generating and Saving Code
+\`\`\`bash
+opencli antigravity send "Write a python script to fetch HN top stories"
+# wait ~10-15 seconds for output to render
+opencli antigravity extract-code > hn_fetcher.py
+\`\`\`
+
+### Reading Real-time Logs
+Agents can run long-running streaming watch instances:
+\`\`\`bash
+opencli antigravity watch
+\`\`\`