publishport-opencli 1.0.0

package/clis/google/search.js

@@ -0,0 +1,90 @@
+import{cli as D,Strategy as F}from"@jackwener/opencli/registry";import{CliError as G}from"@jackwener/opencli/errors";D({site:"google",name:"search",access:"read",description:"Search Google",domain:"google.com",strategy:F.PUBLIC,browser:!0,args:[{name:"keyword",positional:!0,required:!0,help:"Search query"},{name:"limit",type:"int",default:10,help:"Number of results (1-100)"},{name:"lang",default:"en",help:"Language short code (e.g. en, zh)"}],columns:["type","title","url","snippet"],func:async(b,f)=>{const v=Math.max(1,Math.min(Number(f.limit),100)),z=encodeURIComponent(f.keyword),A=encodeURIComponent(f.lang),B=`https://www.google.com/search?q=${z}&hl=${A}&num=${v}`;await b.goto(B);try{await b.wait({selector:"#rso a h3",timeout:5})}catch{await b.wait(2)}const h=await b.evaluate(`
+      (function() {
+        var results = [];
+        var seenUrls = {};
+        var rso = document.querySelector('#rso');
+        if (!rso) return {items: results};
+
+        // -- Featured snippet (scoped to #rso to avoid matching unrelated elements) --
+        var featuredEl = rso.querySelector('.xpdopen .hgKElc')
+                      || rso.querySelector('.IZ6rdc');
+        if (featuredEl) {
+          var parentBlock = featuredEl.closest('[data-hveid]') || featuredEl.parentElement;
+          var fLink = parentBlock ? parentBlock.querySelector('a[href]') : null;
+          var fUrl = fLink ? fLink.href : '';
+          if (fUrl) seenUrls[fUrl] = true;
+          results.push({
+            type: 'snippet',
+            title: featuredEl.textContent.trim().slice(0, 200),
+            url: fUrl,
+            snippet: '',
+          });
+        }
+
+        // -- Standard search results --
+        // Strategy: find all links containing h3 within #rso
+        var allLinks = rso.querySelectorAll('a');
+        for (var i = 0; i < allLinks.length; i++) {
+          var link = allLinks[i];
+          var h3 = link.querySelector('h3');
+          if (!h3) continue;
+
+          var href = link.href || '';
+          // Skip non-http, Google internal links, and duplicates
+          if (!(href.startsWith('http://') || href.startsWith('https://'))) continue;
+          if (href.indexOf('google.com/search') !== -1) continue;
+          if (seenUrls[href]) continue;
+          seenUrls[href] = true;
+
+          // Walk up to find result container for snippet extraction
+          var container = link;
+          for (var j = 0; j < 6; j++) {
+            if (container.parentElement && container.parentElement !== rso) {
+              container = container.parentElement;
+            }
+            // Stop at a known result boundary
+            if (container.getAttribute && container.getAttribute('data-hveid')) break;
+          }
+
+          // Find snippet: look for descriptive text, skip breadcrumbs and metadata
+          var snippetText = '';
+          var titleText = h3.textContent.trim();
+          var candidates = container.querySelectorAll('span, div');
+          for (var k = 0; k < candidates.length; k++) {
+            var el = candidates[k];
+            if (el.querySelector('h3') || el.querySelector('a[href]')) continue;
+            var text = el.textContent.trim();
+            if (text.length < 40 || text.length > 500) continue;
+            if (text === titleText) continue;
+            // Skip URL breadcrumbs (e.g. "https://example.com › path..." or "Site Namehttps://...")
+            if (text.indexOf('›') !== -1) continue;
+            if (new RegExp('https?://').test(text.slice(0, 60))) continue;
+            snippetText = text;
+            break;
+          }
+
+          results.push({
+            type: 'result',
+            title: h3.textContent.trim(),
+            url: href,
+            snippet: snippetText.slice(0, 300),
+          });
+        }
+
+        // -- People Also Ask --
+        var paaContainers = document.querySelectorAll('[data-sgrd="true"]');
+        for (var i = 0; i < paaContainers.length; i++) {
+          var questionEl = paaContainers[i].querySelector('span.CSkcDe');
+          if (questionEl) {
+            results.push({
+              type: 'paa',
+              title: questionEl.textContent.trim(),
+              url: '',
+              snippet: '',
+            });
+          }
+        }
+
+        return {items: results};
+      })()
+    `),q=h&&h.items||[];if(q.length===0)throw new G("NOT_FOUND","No search results found","Try a different keyword or check for CAPTCHA");return q}});

package/clis/google/suggest.js

@@ -0,0 +1 @@
+import{cli as G,Strategy as H}from"@jackwener/opencli/registry";import{CliError as z}from"@jackwener/opencli/errors";G({site:"google",name:"suggest",access:"read",description:"Get Google search suggestions",strategy:H.PUBLIC,browser:!1,args:[{name:"keyword",positional:!0,required:!0,help:"Search query"},{name:"lang",default:"zh-CN",help:"Language code"}],columns:["suggestion"],func:async(v)=>{const A=encodeURIComponent(v.keyword),B=encodeURIComponent(v.lang),D=`https://suggestqueries.google.com/complete/search?client=firefox&q=${A}&hl=${B}`,b=await fetch(D);if(!b.ok)throw new z("FETCH_ERROR",`HTTP ${b.status}`,"Check your network connection");const h=await b.json(),x=Array.isArray(h)&&Array.isArray(h[1])?h[1]:[];if(!x.length)throw new z("NOT_FOUND","No suggestions found","Try a different keyword");return x.map((F)=>({suggestion:F}))}});

package/clis/google/trends.js

@@ -0,0 +1 @@
+import{cli as D,Strategy as F}from"@jackwener/opencli/registry";import{CliError as q}from"@jackwener/opencli/errors";import{parseRssItems as G}from"./utils.js";D({site:"google",name:"trends",access:"read",description:"Get Google Trends daily trending searches",strategy:F.PUBLIC,browser:!1,args:[{name:"region",default:"US",help:"Region code (e.g. US, CN, JP)"},{name:"limit",type:"int",default:20,help:"Number of results"}],columns:["title","traffic","date"],func:async(f)=>{const z=Math.max(1,Math.min(Number(f.limit),100)),A=`https://trends.google.com/trending/rss?geo=${encodeURIComponent(f.region)}`,b=await fetch(A);if(!b.ok)throw new q("FETCH_ERROR",`HTTP ${b.status}`,"Check your network connection or region code");const B=await b.text(),h=G(B,["title","pubDate","ht:approx_traffic"]);if(!h.length)throw new q("NOT_FOUND","No trending data found","Try a different region code");return h.slice(0,z).map((d)=>({title:d.title,traffic:d["ht:approx_traffic"],date:d.pubDate}))}});

package/clis/google/utils.js

@@ -0,0 +1 @@
+export function parseRssItems(z,A){return(z.match(/<item>([\s\S]*?)<\/item>/g)||[]).map((B)=>{const j={};for(const q of A){const v=q.replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),y=B.match(new RegExp(`<${v}(?:\\s[^>]*)?>(?:<!\\[CDATA\\[)?([\\s\\S]*?)(?:\\]\\]>)?</${v}>`));j[q]=y?y[1].trim():""}return j})}

package/clis/google-scholar/cite.js

@@ -0,0 +1,20 @@
+import{cli as u,Strategy as m}from"@jackwener/opencli/registry";import{CommandExecutionError as n}from"@jackwener/opencli/errors";import{requireNonEmptyQuery as f}from"../_shared/common.js";u({site:"google-scholar",name:"cite",access:"read",description:"Get citation for a Google Scholar paper",domain:"scholar.google.com",strategy:m.PUBLIC,browser:!0,args:[{name:"query",positional:!0,required:!0,help:"Paper title to search for"},{name:"style",default:"bibtex",choices:["bibtex","endnote","refman","refworks"],help:"Citation format"},{name:"index",type:"int",default:1,help:"Which search result to cite (1-based)"}],columns:["title","format","citation"],func:async(t,r)=>{const s=f(r.query),a=r.style||"bibtex",e=Math.max(1,r.index||1)-1;await t.goto(`https://scholar.google.com/scholar?q=${encodeURIComponent(s)}&hl=en`);await t.wait(3);const o=await t.evaluate(`(() => {
+            var cites = document.querySelectorAll('a.gs_or_cit');
+            if (cites.length <= ${e}) return { ok: false, reason: 'result not found at index ${e+1}' };
+            var titleEl = document.querySelectorAll('.gs_r.gs_or.gs_scl')[${e}];
+            var title = '';
+            if (titleEl) {
+                var t = titleEl.querySelector('.gs_rt a, h3 a');
+                title = t ? t.textContent.trim() : '';
+            }
+            cites[${e}].click();
+            return { ok: true, title: title };
+        })()`);if(!o?.ok)throw new n(o?.reason||`Could not find search result at index ${e+1}`);await t.wait(2);const i={bibtex:"BibTeX",endnote:"EndNote",refman:"RefMan",refworks:"RefWorks"}[a]||"BibTeX",l=await t.evaluate(`(() => {
+            var links = document.querySelectorAll('#gs_cit a.gs_citi');
+            for (var i = 0; i < links.length; i++) {
+                if (links[i].textContent.trim() === '${i}') return links[i].href;
+            }
+            return null;
+        })()`);if(!l)throw new n(`Could not find ${i} citation link for result ${e+1}`);await t.goto(l);await t.wait(2);const c=await t.evaluate(`(() => {
+            return (document.body.innerText || '').trim();
+        })()`);if(!c)throw new n(`${i} citation page returned an empty response`);return[{title:o.title,format:a,citation:c}]}});

package/clis/google-scholar/profile.js

@@ -0,0 +1,36 @@
+import{cli as n,Strategy as s}from"@jackwener/opencli/registry";import{CommandExecutionError as o}from"@jackwener/opencli/errors";import{clampInt as l,requireNonEmptyQuery as c}from"../_shared/common.js";n({site:"google-scholar",name:"profile",access:"read",description:"View a Google Scholar author profile",domain:"scholar.google.com",strategy:s.PUBLIC,browser:!0,args:[{name:"author",positional:!0,required:!0,help:"Author name or Scholar user ID (e.g. JicYPdAAAAAJ)"},{name:"limit",type:"int",default:10,help:"Max papers to show (max 20)"}],columns:["rank","title","cited","year"],func:async(e,a)=>{const r=c(a.author,"author"),i=l(a.limit,10,1,20);if(/^[A-Za-z0-9_-]{12}$/.test(r))await e.goto(`https://scholar.google.com/citations?user=${r}&hl=en&sortby=citedby`);else{await e.goto(`https://scholar.google.com/citations?view_op=search_authors&mauthors=${encodeURIComponent(r)}&hl=en`);await e.wait(3);if(!await e.evaluate(`(() => {
+                var link = document.querySelector('.gs_ai_pho, .gsc_oai_photo, a[href*="citations?user="]');
+                if (link) { link.click(); return true; }
+                return false;
+            })()`))throw new o(`No profile found for: ${r}`)}await e.wait(3);const t=await e.evaluate(`(() => {
+            var name = (document.querySelector('#gsc_prf_in') || {}).textContent || '';
+            var affiliation = (document.querySelector('.gsc_prf_il') || {}).textContent || '';
+
+            var stats = document.querySelectorAll('#gsc_rsb_st td.gsc_rsb_std');
+            var citations = stats[0] ? stats[0].textContent.trim() : '';
+            var hIndex = stats[2] ? stats[2].textContent.trim() : '';
+            var i10Index = stats[4] ? stats[4].textContent.trim() : '';
+
+            var papers = [];
+            var rows = document.querySelectorAll('#gsc_a_b .gsc_a_tr');
+            for (var i = 0; i < rows.length && i < ${i}; i++) {
+                var titleEl = rows[i].querySelector('.gsc_a_at');
+                var citedEl = rows[i].querySelector('.gsc_a_ac');
+                var yearEl = rows[i].querySelector('.gsc_a_y span');
+                if (titleEl) papers.push({
+                    rank: i + 1,
+                    title: titleEl.textContent.trim(),
+                    cited: citedEl ? citedEl.textContent.trim() : '0',
+                    year: yearEl ? yearEl.textContent.trim() : '',
+                });
+            }
+
+            return {
+                name: name.trim(),
+                affiliation: affiliation.trim(),
+                citations: citations,
+                hIndex: hIndex,
+                i10Index: i10Index,
+                papers: papers,
+            };
+        })()`);if(!t?.name)throw new o(`Could not load Google Scholar profile for: ${r}`);if(!t.papers||t.papers.length===0)throw new o(`No papers found for: ${t.name||r}`);return[{rank:0,title:t.name+(t.affiliation?" ("+t.affiliation+")":""),cited:"h="+t.hIndex+" i10="+t.i10Index+" total="+t.citations,year:"-"},...t.papers]}});

package/clis/google-scholar/search.js

@@ -0,0 +1,35 @@
+import{cli as l,Strategy as n}from"@jackwener/opencli/registry";import{CommandExecutionError as o,EmptyResultError as a}from"@jackwener/opencli/errors";import{clampInt as i,requireNonEmptyQuery as u}from"../_shared/common.js";l({site:"google-scholar",name:"search",access:"read",description:"Google Scholar 学术搜索",domain:"scholar.google.com",strategy:n.PUBLIC,browser:!0,args:[{name:"query",positional:!0,required:!0,help:"搜索关键词"},{name:"limit",type:"int",default:10,help:"返回结果数量 (max 20)"}],columns:["rank","title","authors","source","year","cited","url"],func:async(t,r)=>{const s=i(r.limit,10,1,20),c=u(r.query);await t.goto(`https://scholar.google.com/scholar?q=${encodeURIComponent(c)}&hl=zh-CN`);try{await t.wait({selector:".gs_r.gs_or.gs_scl",timeout:5})}catch{await t.wait(3)}const e=await t.evaluate(`
+      (() => {
+        const normalize = v => (v || '').replace(/\\s+/g, ' ').trim();
+        const results = [];
+        const resultCards = Array.from(document.querySelectorAll('.gs_r.gs_or.gs_scl'));
+        for (const el of resultCards) {
+          const container = el.querySelector('.gs_ri') || el;
+          const titleEl = container.querySelector('.gs_rt a, h3 a');
+          const title = normalize(titleEl?.textContent);
+          if (!title) continue;
+
+          const url = titleEl?.getAttribute('href') || '';
+          const infoLine = normalize(container.querySelector('.gs_a')?.textContent);
+          const parts = infoLine.split(' - ');
+          const authors = (parts[0] || '').trim();
+          const sourceParts = (parts[1] || '').split(',');
+          const source = sourceParts.slice(0, -1).join(',').trim() || sourceParts[0]?.trim() || '';
+          const year = infoLine.match(/(19|20)\\d{2}/)?.[0] || '';
+          const citedText = normalize(container.querySelector('.gs_fl a[href*="cites"]')?.textContent);
+          const cited = citedText.match(/(\\d+)/)?.[1] || '0';
+
+          results.push({
+            rank: results.length + 1,
+            title,
+            authors: authors.slice(0, 80),
+            source: source.slice(0, 60),
+            year,
+            cited,
+            url,
+          });
+          if (results.length >= ${s}) break;
+        }
+        return { items: results, resultCount: resultCards.length };
+      })()
+    `);if(!e||typeof e!=="object"||!Array.isArray(e.items))throw new o("Google Scholar search returned an unexpected payload shape");if(e.items.length===0){if(Number(e.resultCount)>0)throw new o("Google Scholar result cards were present but no rows could be extracted");throw new a("google-scholar/search","Try a different query or check whether Google Scholar returned a CAPTCHA.")}return e.items}});

package/clis/goproxy/module.js

@@ -0,0 +1 @@
+import{cli as K,Strategy as L}from"@jackwener/opencli/registry";import{EmptyResultError as N}from"@jackwener/opencli/errors";import{GOPROXY_BASE as H,goproxyJson as Q,requireModulePath as T,trimDate as U}from"./utils.js";K({site:"goproxy",name:"module",access:"read",description:"Latest version + VCS origin metadata for a Go module on proxy.golang.org",domain:"proxy.golang.org",strategy:L.PUBLIC,browser:!1,args:[{name:"module",positional:!0,type:"string",required:!0,help:'Go module path (e.g. "github.com/gin-gonic/gin", "golang.org/x/net")'}],columns:["module","version","publishedAt","vcs","repository","commit","ref","pkgGoDevUrl","url"],func:async(I)=>{const z=T(I.module),F=z.split("/").map(encodeURIComponent).join("/"),f=await Q(`${H}/${F}/@latest`,`goproxy module ${z}`);if(!f||!f.Version)throw new N("goproxy module",`proxy.golang.org returned no @latest entry for "${z}".`);const C=f.Origin&&typeof f.Origin==="object"?f.Origin:{};return[{module:z,version:String(f.Version),publishedAt:U(f.Time),vcs:String(C.VCS??"").trim(),repository:String(C.URL??"").trim(),commit:String(C.Hash??"").trim(),ref:String(C.Ref??"").trim(),pkgGoDevUrl:`https://pkg.go.dev/${z}`,url:`${H}/${F}/@latest`}]}});

package/clis/goproxy/utils.js

@@ -0,0 +1 @@
+import{ArgumentError as D,CommandExecutionError as H,EmptyResultError as Z}from"@jackwener/opencli/errors";export const GOPROXY_BASE="https://proxy.golang.org";const U="opencli-goproxy-adapter (+https://github.com/jackwener/opencli)",G=/^[A-Za-z0-9][A-Za-z0-9._\/-]{0,199}$/,X=/^v[0-9]+(\.[0-9]+)*([-+][A-Za-z0-9._-]+)?$/;export function requireModulePath(z){const q=String(z??"").trim();if(!q)throw new D('goproxy module path is required (e.g. "github.com/gin-gonic/gin", "golang.org/x/net")',"Use the canonical module path that appears in `go.mod`.");if(!G.test(q)||!q.includes("/"))throw new D(`goproxy module path "${z}" is not a recognised Go module path`,'Module paths look like "github.com/<org>/<repo>" or "golang.org/x/<name>".');return q}export function requireVersionTag(z){const q=String(z??"").trim();if(!q)throw new D("goproxy --version cannot be empty");if(!X.test(q))throw new D(`goproxy --version "${z}" is not a valid Go semver tag`,'Use the GOPROXY canonical form like "v1.2.3" or "v0.0.0-20240101010101-abcdef012345".');return q}export function requireBoundedInt(z,q,J,K="limit"){const Q=z??q,W=typeof Q==="number"?Q:Number(Q);if(!Number.isInteger(W)||W<=0)throw new D(`goproxy ${K} must be a positive integer`);if(W>J)throw new D(`goproxy ${K} must be <= ${J}`);return W}async function Y(z,q){let J;try{J=await fetch(z,{headers:{"user-agent":U}})}catch(K){throw new H(`${q} request failed: ${K?.message??K}`,"Check that proxy.golang.org is reachable from this network.")}if(J.status===404||J.status===410)throw new Z(q,`proxy.golang.org returned ${J.status} for ${z}.`);if(J.status===429)throw new H(`${q} returned HTTP 429 (rate limited)`);if(!J.ok)throw new H(`${q} returned HTTP ${J.status}`);return J}export async function goproxyJson(z,q){const J=await Y(z,q);let K;try{K=await J.json()}catch(Q){throw new H(`${q} returned malformed JSON: ${Q?.message??Q}`)}return K}export async function goproxyText(z,q){return(await Y(z,q)).text()}export function sortVersionsDescending(z){return z.filter((q)=>typeof q==="string"&&X.test(q)).map((q)=>({v:q,parts:T(q)})).sort((q,J)=>_(J.parts,q.parts)).map((q)=>q.v)}function T(z){const q=z.replace(/^v/,""),J=q.indexOf("+"),K=J>=0?q.slice(0,J):q,Q=K.indexOf("-"),W=Q>=0?K.slice(0,Q):K,j=Q>=0?K.slice(Q+1):"";return{numbers:W.split(".").map(($)=>Number.parseInt($,10)).map(($)=>Number.isFinite($)?$:0),pre:j}}function _(z,q){const J=Math.max(z.numbers.length,q.numbers.length);for(let K=0;K<J;K+=1){const Q=z.numbers[K]??0,W=q.numbers[K]??0;if(Q!==W)return Q-W}if(z.pre===""&&q.pre!=="")return 1;if(z.pre!==""&&q.pre==="")return-1;if(z.pre===q.pre)return 0;return B(z.pre,q.pre)}function B(z,q){const J=z.split("."),K=q.split("."),Q=Math.max(J.length,K.length);for(let W=0;W<Q;W+=1){const j=J[W],k=K[W];if(j==null)return-1;if(k==null)return 1;const $=/^\d+$/.test(j),L=/^\d+$/.test(k);if($&&L){const M=Number(j)-Number(k);if(M!==0)return M;continue}if($!==L)return $?-1:1;if(j!==k)return j<k?-1:1}return 0}export function trimDate(z){const q=String(z??"").trim();if(!q)return null;const J=q.replace(/\.\d+/,"");return J.endsWith("Z")?J:q.length>=10?q.slice(0,10):null}

package/clis/goproxy/versions.js

@@ -0,0 +1 @@
+import{cli as $,Strategy as f}from"@jackwener/opencli/registry";import{EmptyResultError as U}from"@jackwener/opencli/errors";import{GOPROXY_BASE as K,goproxyJson as I,goproxyText as J,requireBoundedInt as M,requireModulePath as V,sortVersionsDescending as D,trimDate as T}from"./utils.js";$({site:"goproxy",name:"versions",access:"read",description:"Published version tags for a Go module (newest first), optionally with publish times",domain:"proxy.golang.org",strategy:f.PUBLIC,browser:!1,args:[{name:"module",positional:!0,type:"string",required:!0,help:'Go module path (e.g. "github.com/gin-gonic/gin")'},{name:"limit",type:"int",default:30,help:"Max rows to return (1-200)"},{name:"with-time",type:"boolean",default:!1,help:"Fetch each version's publish time (one extra request per row)"}],columns:["rank","module","version","publishedAt","url"],func:async(C)=>{const z=V(C.module),W=M(C.limit,30,200,"limit"),Z=C["with-time"]===!0,F=z.split("/").map(encodeURIComponent).join("/"),L=(await J(`${K}/${F}/@v/list`,`goproxy versions ${z}`)).split(/\r?\n/).map((b)=>b.trim()).filter(Boolean);if(L.length===0)throw new U("goproxy versions",`proxy.golang.org returned no published versions for "${z}".`);const N=D(L).slice(0,W);if(N.length===0)throw new U("goproxy versions",`"${z}" has no semver-shaped tags on proxy.golang.org.`);const Q=N.map((b,H)=>({rank:H+1,module:z,version:b,publishedAt:null,url:`${K}/${F}/@v/${encodeURIComponent(b)}.info`}));if(Z)for(const b of Q){const H=await I(`${K}/${F}/@v/${encodeURIComponent(b.version)}.info`,`goproxy versions ${z} ${b.version}`);b.publishedAt=T(H?.Time)}return Q}});

package/clis/gov-law/recent.js

@@ -0,0 +1 @@
+import{cli as r,Strategy as i}from"@jackwener/opencli/registry";import{clampInt as n}from"../_shared/common.js";import{extractLawResults as m,navigateViaVueRouter as s}from"./shared.js";r({site:"gov-law",name:"recent",access:"read",description:"最新法律法规",domain:"flk.npc.gov.cn",strategy:i.PUBLIC,browser:!0,args:[{name:"limit",type:"int",default:10,help:"返回结果数量 (max 20)"}],columns:["rank","title","status","publish_date","type","department"],func:async(t,e)=>{const a=n(e.limit,10,1,20);await s(t,{});return m(t,a)}});

package/clis/gov-law/search.js

@@ -0,0 +1,14 @@
+import{cli as u,Strategy as a}from"@jackwener/opencli/registry";import{clampInt as o,requireNonEmptyQuery as s}from"../_shared/common.js";import{extractLawResults as p,navigateViaVueRouter as c}from"./shared.js";u({site:"gov-law",name:"search",access:"read",description:"国家法律法规数据库搜索",domain:"flk.npc.gov.cn",strategy:a.PUBLIC,browser:!0,args:[{name:"query",positional:!0,required:!0,help:"搜索关键词"},{name:"limit",type:"int",default:10,help:"返回结果数量 (max 20)"}],columns:["rank","title","status","publish_date","type","department"],func:async(e,t)=>{const r=o(t.limit,10,1,20),n=s(t.query);await c(e,{searchWord:n});const i=JSON.stringify(n);await e.evaluate(`
+      (async () => {
+        const input = document.querySelector('.el-input__inner');
+        if (input && !input.value) {
+          const setter = Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype, 'value').set;
+          setter.call(input, ${i});
+          input.dispatchEvent(new Event('input', { bubbles: true }));
+          input.dispatchEvent(new Event('change', { bubbles: true }));
+          await new Promise(r => setTimeout(r, 300));
+          input.dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', keyCode: 13, bubbles: true }));
+          input.dispatchEvent(new KeyboardEvent('keyup', { key: 'Enter', keyCode: 13, bubbles: true }));
+        }
+      })()
+    `);await e.wait(3);return p(e,r)}});

package/clis/gov-law/shared.js

@@ -0,0 +1,29 @@
+import{CliError as a}from"@jackwener/opencli/errors";export async function navigateViaVueRouter(t,e){await t.goto("https://flk.npc.gov.cn/index.html");await t.wait(4);if(!await t.evaluate(`
+      (async () => {
+        const app = document.querySelector('#app');
+        const router = app?.__vue_app__?.config?.globalProperties?.$router;
+        if (!router) return false;
+        await router.push({ path: '/search', query: ${JSON.stringify(e)} });
+        return true;
+      })()
+    `))throw new a("FRAMEWORK_CHANGED","Could not access Vue Router on flk.npc.gov.cn — the site may have been restructured.","Please report this issue so the adapter can be updated.");await t.wait(5)}export async function extractLawResults(t,e){const r=await t.evaluate(`
+      (async () => {
+        const normalize = v => (v || '').replace(/\\s+/g, ' ').trim();
+        for (let i = 0; i < 40; i++) {
+          if (document.querySelectorAll('.result-item').length > 0) break;
+          await new Promise(r => setTimeout(r, 500));
+        }
+        const results = [];
+        for (const el of document.querySelectorAll('.result-item')) {
+          const title = normalize(el.querySelector('.title-content')?.textContent);
+          if (!title) continue;
+          const status = normalize(el.querySelector('[class*="status"]')?.textContent);
+          const publish_date = normalize(el.querySelector('.publish-time')?.textContent).replace(/^公布日期[：:]\\s*/, '');
+          const type = normalize(el.querySelector('.type')?.textContent);
+          const department = normalize(el.querySelector('.department')?.textContent);
+          results.push({ rank: results.length + 1, title, status, publish_date, type, department });
+          if (results.length >= ${e}) break;
+        }
+        return results;
+      })()
+    `);return Array.isArray(r)?r:[]}

package/clis/gov-policy/__fixtures__/recent.html

@@ -0,0 +1,16 @@
+<!DOCTYPE html>
+<html lang="zh">
+<head>
+<meta charset="UTF-8">
+<title>国务院最新政策文件</title>
+</head>
+<body>
+<div class="news_box">
+<div class="list list_1 list_2">
+<ul id="list-1-ajax-id">
+<li><h4><a href="https://www.gov.cn/zhengce/202604/content_7066998.htm" target="_blank">中共中央办公厅 国务院办公厅关于加强新就业群体服务管理的意见</a><span class="date">2026-04-26</span></h4></li><li><h4><a href="https://www.gov.cn/zhengce/202604/content_7066695.htm" target="_blank">中共中央办公厅 国务院办公厅印发《碳达峰碳中和综合评价考核办法》</a><span class="date">2026-04-23</span></h4></li><li><h4><a href="https://www.gov.cn/zhengce/202604/content_7066623.htm" target="_blank">中办国办关于更高水平更高质量做好节能降碳工作的意见</a><span class="date">2026-04-22</span></h4></li><li><h4><a href="https://www.gov.cn/zhengce/content/202604/content_7066483.htm" target="_blank">国务院关于推进服务业扩能提质的意见</a><span class="date">2026-04-21</span></h4></li><li><h4 class="line"><a href="https://www.gov.cn/zhengce/content/202604/content_7066113.htm" target="_blank">国务院办公厅转发海关总署《关于促进综合保税区扩能提质的若干措施》的通知</a><span class="date">2026-04-17</span></h4></li>
+</ul>
+</div>
+</div>
+</body>
+</html>

package/clis/gov-policy/__fixtures__/search.html

@@ -0,0 +1,41 @@
+<!DOCTYPE html>
+<html lang="zh">
+<head>
+<meta charset="UTF-8">
+<title>中国政府网站内搜索 - 数字经济</title>
+</head>
+<body>
+<div class="basic_result_content js_basic_result_content clearfix">
+<div class="item hasImg is-news" data-documentid="thirdparty_code_107_t_17e00f1efbb_25992758">
+            <div class="partitions"></div>
+            <a class="title log-anchor" title="经济数据速览：10组数字看一季度中国经济" href="https://www.gov.cn/zhengce/jiedu/tujie/202604/content_7065945.htm" target="_blank">
+                <span class="type_title">要闻</span><em>经济</em>数据速览：10组<em>数字</em>看一季度中国<em>经济</em>
+            </a>
+            <div class="description">
+                <img src="placeholder.png" aria-label="经济数据速览：10组数字看一季度中国经济">
+                <span class="sourceTime">发布时间：2026-4-16</span>
+            </div>
+        </div><div class="item hasImg is-news" data-documentid="thirdparty_code_107_t_17e00f1efbb_25839485">
+            <div class="partitions"></div>
+            <a class="title log-anchor" title="何立峰会见法国经济、财政和工业、能源与数字主权部部长莱斯屈尔" href="https://www.gov.cn/yaowen/liebiao/202603/content_7062985.htm" target="_blank">
+                <span class="type_title">要闻</span>何立峰会见法国<em>经济</em>、财政和工业、能源与<em>数字</em>主权部部长莱斯屈尔
+            </a>
+            <div class="description">
+                <div class="detail js_limit_text">
+                    <p class="js_text line_clamp_two">新华社巴黎3月16日电 当地时间3月16日，中法高级别经济财金对话中方牵头人、国务院副总理何立峰在中美经贸巴黎磋商之后应约会见对话法方牵头人，法国经济、财政和工业、能源与数字主权部部长莱斯屈尔，就近期中法经济财金合作和双方共同关心的问题深入交换意见。 何立峰表示，中方愿与法方一道，落实好习近平主席与马克龙总统重要共识，进一步深化中法经济财金各领域交流与合作，推动中法经济关系行稳致远。何立峰还应询介</p>
+                </div>
+                <span class="sourceTime">发布时间：2026-3-17</span>
+            </div>
+        </div><div class="item hasImg is-news" data-documentid="thirdparty_code_107_t_17e00f1efbb_25836739">
+            <div class="partitions"></div>
+            <a class="title log-anchor" title="经济数据速览：7组数字看1—2月份中国经济" href="https://www.gov.cn/zhengce/jiedu/tujie/202603/content_7062831.htm" target="_blank">
+                <span class="type_title">要闻</span><em>经济</em>数据速览：7组<em>数字</em>看1—2月份中国<em>经济</em>
+            </a>
+            <div class="description">
+                <img src="placeholder.png" aria-label="经济数据速览：7组数字看1—2月份中国经济">
+                <span class="sourceTime">发布时间：2026-3-16</span>
+            </div>
+        </div>
+</div>
+</body>
+</html>

package/clis/gov-policy/recent.js

@@ -0,0 +1,8 @@
+import{cli as O,Strategy as Q}from"@jackwener/opencli/registry";import{classifyExtractorFailure as T,parseGovPolicyLimit as U,requireRows as V,wrapBrowserError as W}from"./utils.js";export function extractRecentRows(){const C=(A)=>(A||"").replace(/\s+/g," ").trim(),I=document.querySelectorAll(".news_box li, .list li, .list_item, .news-list li");if(I.length===0){const A=document.body;return{ok:!1,sample:(A&&(A.innerText||A.textContent)||"").slice(0,800),url:location.href}}const D=[];for(const A of I){const J=A.querySelector("a"),K=C(J?.textContent);if(!K||K.length<4)continue;let H=J?.getAttribute("href")||"";if(H&&!H.startsWith("http"))H="https://www.gov.cn"+H;const M=(A.textContent||"").match(/(\d{4}[-./]\d{1,2}[-./]\d{1,2})/)?.[1]||"",N=C(A.querySelector(".source, .from")?.textContent);D.push({rank:D.length+1,title:K,date:M,source:N,url:H})}return{ok:!0,rows:D}}O({site:"gov-policy",name:"recent",access:"read",description:"国务院最新政策文件",domain:"www.gov.cn",strategy:Q.PUBLIC,browser:!0,args:[{name:"limit",type:"int",default:10,help:"返回结果数量 (max 20)"}],columns:["rank","title","date","source","url"],func:async(C,I)=>{const D=U(I.limit,"recent");try{await C.goto("https://www.gov.cn/zhengce/zuixin/index.htm");await C.wait(4);await C.evaluate(`
+      (async () => {
+        for (let i = 0; i < 20; i++) {
+          if (document.querySelector('.news_box li, .list li, .list_item, .news-list li')) break;
+          await new Promise(r => setTimeout(r, 500));
+        }
+      })()
+    `);const A=await C.evaluate(`(${extractRecentRows.toString()})()`);if(!A||!A.ok)T("recent",A);return V("recent",A.rows).slice(0,D)}catch(A){W("recent",A)}}});

package/clis/gov-policy/search.js

@@ -0,0 +1,8 @@
+import{cli as T,Strategy as U}from"@jackwener/opencli/registry";import{requireNonEmptyQuery as V}from"../_shared/common.js";import{classifyExtractorFailure as W,parseGovPolicyLimit as X,requireRows as Y,wrapBrowserError as Z}from"./utils.js";export function extractSearchRows(){const D=(A)=>(A||"").replace(/\s+/g," ").trim(),H=document.querySelectorAll(".basic_result_content .item, .js_basic_result_content .item");if(H.length===0){const A=document.body;return{ok:!1,sample:(A&&(A.innerText||A.textContent)||"").slice(0,800),url:location.href}}const I=[];for(const A of H){const C=A.querySelector("a.title, .title a, a.log-anchor"),K=D(C?.textContent).replace(/<[^>]+>/g,"");if(!K||K.length<4)continue;let J=C?.getAttribute("href")||"";if(J&&!J.startsWith("http"))J="https://www.gov.cn"+J;const M=D(A.querySelector(".description")?.textContent).slice(0,120),O=(A.textContent||"").match(/(\d{4}[-./]\d{1,2}[-./]\d{1,2})/)?.[1]||"";I.push({rank:I.length+1,title:K,description:M,date:O,url:J})}return{ok:!0,rows:I}}T({site:"gov-policy",name:"search",access:"read",description:"中国政府网政策文件搜索",domain:"sousuo.www.gov.cn",strategy:U.PUBLIC,browser:!0,args:[{name:"query",positional:!0,required:!0,help:"搜索关键词"},{name:"limit",type:"int",default:10,help:"返回结果数量 (max 20)"}],columns:["rank","title","description","date","url"],func:async(D,H)=>{const I=X(H.limit,"search"),A=V(H.query);try{await D.goto(`https://sousuo.www.gov.cn/sousuo/search.shtml?code=17da70961a7&dataTypeId=107&searchWord=${encodeURIComponent(A)}`);await D.wait(5);await D.evaluate(`
+      (async () => {
+        for (let i = 0; i < 30; i++) {
+          if (document.querySelectorAll('.basic_result_content .item, .js_basic_result_content .item').length > 0) break;
+          await new Promise(r => setTimeout(r, 500));
+        }
+      })()
+    `);const C=await D.evaluate(`(${extractSearchRows.toString()})()`);if(!C||!C.ok)W("search",C);return Y("search",C.rows).slice(0,I)}catch(C){Z("search",C)}}});

package/clis/gov-policy/utils.js

@@ -0,0 +1 @@
+import{ArgumentError as n,CommandExecutionError as o,EmptyResultError as s}from"@jackwener/opencli/errors";const c=[/没有找到/,/暂无/,/无相关/,/未找到/,/搜索结果为\s*0/,/很抱歉/];export function parseGovPolicyLimit(t,e){const r=Number(t??10);if(!Number.isInteger(r)||r<1)throw new n(`gov-policy ${e} --limit must be a positive integer`);if(r>20)throw new n(`gov-policy ${e} --limit must be <= 20`);return r}export function classifyExtractorFailure(t,e){const i=String(e?.sample||"").replace(/\s+/g," ").trim(),r=String(e?.url||"").trim();if(t==="search"&&c.some((l)=>l.test(i)))throw new s("gov-policy search",i?i.slice(0,160):void 0);const a=[r&&`url=${r}`,i&&`sample=${i.slice(0,160)}`].filter(Boolean).join("; ");throw new o(`gov-policy ${t} page did not expose readable result rows`,a||"The page structure may have changed or the page did not finish rendering.")}export function requireRows(t,e){if(!Array.isArray(e)||e.length===0)throw new o(`gov-policy ${t} extractor returned no result rows`,"The page structure may have changed or all result cards were missing required title fields.");return e}export function wrapBrowserError(t,e){if(e instanceof n||e instanceof s||e instanceof o)throw e;throw new o(`gov-policy ${t} browser extraction failed: ${e?.message??e}`)}

package/clis/grok/ask.js

@@ -0,0 +1 @@
+import{cli as X,Strategy as Y}from"@jackwener/opencli/registry";import{CommandExecutionError as Z,TimeoutError as $}from"@jackwener/opencli/errors";import{authRequired as q,ensureOnGrok as z,getMessageBubbles as G,isLoggedIn as H,normalizeBooleanFlag as _,sendMessage as x,startNewChat as y,waitForAnswer as C}from"./utils.js";const F="Likely login/auth/challenge/session issue in the existing grok.com browser session.";async function Q(f){const v=await G(f);for(let D=v.length-1;D>=0;D-=1)if(v[D].role==="Assistant")return v[D].id;return""}export const askCommand=X({site:"grok",name:"ask",access:"write",description:"Send a message to Grok and get response",domain:"grok.com",strategy:Y.COOKIE,browser:!0,siteSession:"persistent",args:[{name:"prompt",positional:!0,type:"string",required:!0,help:"Prompt to send to Grok"},{name:"timeout",type:"int",default:120,help:"Max seconds to wait for response (default: 120)"},{name:"new",type:"boolean",default:!1,help:"Start a new chat before sending (default: false)"}],columns:["response"],func:async(f,v)=>{const D=v.prompt,P=v.timeout||120;if(_(v.new))await y(f);else await z(f);if(!await H(f))throw q();const U=await Q(f),J=await x(f,D);if(!J||!J.ok){const V=J?.reason||"Unable to send the prompt to Grok.",W=J?.detail?` ${J.detail}`:"";throw new Z(`${V}${W}`,F)}const K=await C(f,D,P,U);if(K.status==="ok")return[{response:K.assistant.text}];if(K.status==="partial"&&K.assistant)return[{response:K.assistant.text}];throw new $("grok ask response",P)}}),__test__={getBaselineLastAssistantId:Q};

package/clis/grok/auth.js

@@ -0,0 +1,17 @@
+import{AuthRequiredError as o,CommandExecutionError as i}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as a}from"../_shared/site-auth.js";async function r(e){return(await e.getCookies({url:"https://grok.com"})).some((s)=>s.name==="__Secure-next-auth.session-token"&&s.value)}async function n(e){if(!await r(e))throw new o("grok.com","Grok __Secure-next-auth.session-token cookie missing");await e.goto("https://grok.com/");await e.wait(2);const t=await e.evaluate(`(async () => {
+    try {
+      const res = await fetch('/api/auth/session', { credentials: 'include', headers: { 'Accept': 'application/json' } });
+      if (res.status === 401 || res.status === 403) {
+        return { kind: 'auth', detail: 'Grok /api/auth/session HTTP ' + res.status };
+      }
+      if (!res.ok) return { kind: 'http', httpStatus: res.status };
+      const d = await res.json();
+      const user = d && d.user;
+      if (!user || !user.id) {
+        return { kind: 'auth', detail: 'Grok /api/auth/session has no user — anonymous' };
+      }
+      return { ok: true, user_id: String(user.id), name: String(user.name || '') };
+    } catch (e) {
+      return { kind: 'exception', detail: String(e && e.message || e) };
+    }
+  })()`);if(t?.kind==="auth")throw new o("grok.com",t.detail);if(t?.kind==="http")throw new i(`HTTP ${t.httpStatus} from /api/auth/session`);if(t?.kind==="exception")throw new i(`Grok whoami failed: ${t.detail}`);if(!t?.ok)throw new i(`Unexpected Grok probe: ${JSON.stringify(t)}`);return{user_id:t.user_id,name:t.name}}a({site:"grok",domain:"grok.com",loginUrl:"https://grok.com/auth/sign-in",columns:["user_id","name"],quickCheck:r,verify:n,poll:async(e)=>{if(!await r(e))throw new o("grok.com","Waiting for Grok session cookie");return n(e)}});

package/clis/grok/delete.js

@@ -0,0 +1 @@
+import{cli as l,Strategy as d}from"@jackwener/opencli/registry";import{CommandExecutionError as s}from"@jackwener/opencli/errors";import{GROK_DOMAIN as u,ensureOnGrok as c,authRequired as m,isLoggedIn as y,parseGrokSessionId as w,clickConversationMenuItem as f,normalizeBooleanFlag as h,waitForConversationToDisappear as k}from"./utils.js";const r="Likely login/auth/challenge/session issue in the existing grok.com browser session.";l({site:"grok",name:"delete",access:"write",description:"Delete a Grok conversation by ID. Grok takes effect immediately with no confirmation dialog — require --yes to actually delete.",domain:u,strategy:d.COOKIE,browser:!0,siteSession:"persistent",args:[{name:"id",positional:!0,type:"string",required:!0,help:"Conversation UUID or grok.com/c/<uuid> URL"},{name:"yes",type:"boolean",default:!1,help:"Actually delete (default is a dry-run preview)"}],columns:["status","id"],func:async(t,o)=>{const i=w(o.id),a=h(o.yes);await c(t);if(!await y(t))throw m();if(!a)return[{status:"dry-run (pass --yes to actually delete)",id:i}];const e=await f(t,i,["删除","delete"]);if(!e||!e.ok){const n=e?.detail?` ${e.detail}`:"";throw new s(`${e?.reason||"Failed to click delete menu item."}${n}`,r)}if(!await k(t,i))throw new s("Delete menu item was clicked, but the conversation is still visible in the sidebar.",r);return[{status:"deleted",id:i}]}});

package/clis/grok/detail.js

@@ -0,0 +1 @@
+import{cli as X,Strategy as Y}from"@jackwener/opencli/registry";import{EmptyResultError as Z}from"@jackwener/opencli/errors";import{GROK_DOMAIN as $,bubbleHtmlToMarkdown as z,getMessageBubbles as F,normalizeBooleanFlag as H,parseGrokSessionId as K}from"./utils.js";X({site:"grok",name:"detail",access:"read",description:"Open a Grok conversation by ID and read its messages",domain:$,strategy:Y.COOKIE,browser:!0,navigateBefore:!1,siteSession:"persistent",args:[{name:"id",positional:!0,required:!0,help:"Session ID (UUID) or full https://grok.com/c/<id> URL"},{name:"markdown",type:"boolean",default:!1,help:"Emit assistant replies as markdown"}],columns:["Role","Text"],func:async(q,x)=>{const C=K(x.id),J=H(x.markdown,!1);await q.goto(`https://grok.com/c/${C}`);await q.wait(2);let v=[];const Q=20000,U=1,W=Date.now();while(Date.now()-W<Q){v=await F(q);if(v.length>0)break;await q.wait(U)}if(!v.length)throw new Z("grok detail",`No visible messages found for conversation ${C}. Verify the ID is correct and that the conversation belongs to the signed-in account.`);return v.map((f)=>({Role:f.role,Text:J&&f.role==="Assistant"&&f.html?z(f.html)||f.text:f.text}))}});

package/clis/grok/export-all.js

@@ -0,0 +1,170 @@
+import{cli as S,Strategy as v}from"@jackwener/opencli/registry";import{ArgumentError as p,AuthRequiredError as M,EmptyResultError as h,TimeoutError as A}from"@jackwener/opencli/errors";import C from"node:fs";import{normalizeConversationRows as E,normalizeManifestRows as k,requireBooleanEvaluateResult as R,requireObjectEvaluateResult as b}from"./export-utils.js";const w="grok.com",H="https://grok.com/";function d(o,e,t,{min:r=0,max:l=Number.MAX_SAFE_INTEGER}={}){const a=Number(o??e);if(!Number.isInteger(a))throw new p(t,"must be an integer");if(a<r)throw new p(t,`must be >= ${r}`);if(a>l)throw new p(t,`must be <= ${l}`);return a}async function T(o,e,t){if(t<=0)return;const r=Math.max(0,t-e),l=e+Math.floor(Math.random()*(r+1));if(l>0)await o.wait(l/1000)}function x(o,{offset:e,limit:t}){const r=String(o||"").trim();if(!r)return null;let l;try{l=JSON.parse(C.readFileSync(r,"utf8"))}catch(c){throw new p("manifestPath",`failed to read JSON manifest: ${c?.message||c}`)}const i=k(l),a=t?i.slice(e,e+t):i.slice(e);if(!a.length)throw new h("grok export-all",`No manifest rows after offset=${e}, limit=${t}`);return a}async function N(o,{offset:e,limit:t,maxScrolls:r}){await o.goto(H);await o.wait(2);const l=await o.evaluate(`(async () => {
+    const targetLimit = ${JSON.stringify(t>0?e+t:0)};
+    const maxScrolls = ${JSON.stringify(r)};
+    const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+    const isVisible = (node) => {
+      if (!(node instanceof Element)) return false;
+      const style = window.getComputedStyle(node);
+      if (style.visibility === 'hidden' || style.display === 'none') return false;
+      const rect = node.getBoundingClientRect();
+      return rect.width > 0 && rect.height > 0;
+    };
+    const hasHistoryEntry = Boolean(document.querySelector('a[href^="/c/"]'));
+    const hasHistoryLauncher = Array.from(document.querySelectorAll('button, [role="button"]'))
+      .some((node) => isVisible(node) && /^(查看全部|show all|view all)$/i.test((node.textContent || '').trim()));
+    const signInCta = Array.from(document.querySelectorAll('button, a'))
+      .some((node) => isVisible(node) && /^(sign in|log in)$/i.test((node.textContent || '').trim()));
+    if (signInCta && !hasHistoryEntry && !hasHistoryLauncher) {
+      return { ok: false, code: 'AUTH' };
+    }
+
+    const clickAllHistory = () => {
+      const buttons = Array.from(document.querySelectorAll('button, [role="button"]'))
+        .filter((node) => node instanceof HTMLElement && isVisible(node));
+      const target = buttons.find((node) => /^(查看全部|show all|view all)$/i.test((node.textContent || '').trim()));
+      if (!target) return false;
+      target.click();
+      return true;
+    };
+
+    if (!document.querySelector('[role="listbox"] a[href^="/c/"]')) {
+      clickAllHistory();
+    }
+
+    let listbox = null;
+    for (let attempt = 0; attempt < 30; attempt += 1) {
+      listbox = document.querySelector('[role="listbox"]');
+      if (listbox && listbox.querySelector('a[href^="/c/"]')) break;
+      await sleep(250);
+    }
+    if (!listbox || !listbox.querySelector('a[href^="/c/"]')) {
+      return { ok: false, code: 'NO_DIALOG' };
+    }
+
+    const scroller = Array.from(listbox.querySelectorAll('*'))
+      .find((node) => node.scrollHeight > node.clientHeight + 20) || listbox;
+    const seen = new Map();
+    const collect = () => {
+      for (const a of Array.from(listbox.querySelectorAll('a[href^="/c/"]'))) {
+        const href = a.getAttribute('href') || '';
+        const match = href.match(/^\\/c\\/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$/i);
+        if (!match) continue;
+        const id = match[1].toLowerCase();
+        const option = a.closest('[role="option"]') || a.parentElement;
+        const lines = (option?.innerText || option?.textContent || a.textContent || '')
+          .split(/\\n+/)
+          .map((line) => line.trim())
+          .filter(Boolean);
+        seen.set(id, {
+          id,
+          title: lines[0] || '',
+          date: lines.slice(1).find(Boolean) || '',
+          url: 'https://grok.com/c/' + id,
+        });
+      }
+    };
+
+    scroller.scrollTop = 0;
+    scroller.dispatchEvent(new Event('scroll', { bubbles: true }));
+    await sleep(250);
+
+    let lastCount = -1;
+    let lastHeight = -1;
+    let stableRounds = 0;
+    for (let attempt = 0; attempt < maxScrolls; attempt += 1) {
+      collect();
+      if (targetLimit > 0 && seen.size >= targetLimit) break;
+      scroller.scrollTop = scroller.scrollHeight;
+      scroller.dispatchEvent(new Event('scroll', { bubbles: true }));
+      await sleep(350);
+      collect();
+      if (targetLimit > 0 && seen.size >= targetLimit) break;
+      if (seen.size === lastCount && scroller.scrollHeight === lastHeight) {
+        stableRounds += 1;
+      } else {
+        stableRounds = 0;
+        lastCount = seen.size;
+        lastHeight = scroller.scrollHeight;
+      }
+      if (targetLimit === 0 && stableRounds >= 8) break;
+    }
+
+    return { ok: true, rows: Array.from(seen.values()) };
+  })()`),i=b(l,"grok export-all history dialog");if(i.ok!==!0){if(i?.code==="AUTH")throw new M(w,"Sign in to grok.com in the browser, then retry.");if(i?.code==="NO_DIALOG")throw new A("grok export-all history dialog",8);throw new h("grok export-all","No Grok conversation history was visible.")}const a=E(i.rows,"grok export-all history dialog");if(!a.length)throw new h("grok export-all","No Grok conversations found in the signed-in account history.");return t?a.slice(e,e+t):a.slice(e)}async function I(o,e,{pageTimeoutMs:t,pageScrolls:r,delayMinMs:l,delayMaxMs:i}){await o.goto(e.url);const a=Date.now();let c=!1;while(Date.now()-a<t){let n;try{n=await o.evaluate(`(() => {
+        return Boolean(document.querySelector('[data-testid="user-message"], [data-testid="assistant-message"]'));
+      })()`);c=R(n,"grok export-all page load check")}catch(s){return{status:"failed",error:`Page load check failed: ${s?.message||s}`,messageCount:0,messagesJson:"[]"}}if(c)break;await o.wait(1)}if(!c)return{status:"empty",error:"No visible message bubbles after waiting for page load.",messageCount:0,messagesJson:"[]"};await T(o,l,i);let f,u;try{f=await o.evaluate(`(async () => {
+      const maxScrolls = ${JSON.stringify(r)};
+      const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+      const isVisible = (node) => {
+        if (!(node instanceof Element)) return false;
+        const style = window.getComputedStyle(node);
+        if (style.visibility === 'hidden' || style.display === 'none') return false;
+        const rect = node.getBoundingClientRect();
+        return rect.width > 0 && rect.height > 0;
+      };
+      const messageSelector = '[data-testid="user-message"], [data-testid="assistant-message"]';
+      const findScrollableAncestors = () => {
+        const first = document.querySelector(messageSelector);
+        const out = [document.scrollingElement || document.documentElement];
+        let node = first ? first.parentElement : null;
+        while (node && node !== document.body) {
+          if (node.scrollHeight > node.clientHeight + 20) out.push(node);
+          node = node.parentElement;
+        }
+        return Array.from(new Set(out));
+      };
+      const scrollables = findScrollableAncestors();
+      const countMessages = () => Array.from(document.querySelectorAll(messageSelector)).filter(isVisible).length;
+
+      let lastCount = -1;
+      let lastBottom = -1;
+      let stableRounds = 0;
+      for (let attempt = 0; attempt < maxScrolls && stableRounds < 5; attempt += 1) {
+        for (const scroller of scrollables) {
+          scroller.scrollTop = scroller.scrollHeight;
+          scroller.dispatchEvent(new Event('scroll', { bubbles: true }));
+        }
+        window.scrollTo(0, document.documentElement.scrollHeight || document.body.scrollHeight);
+        await sleep(300);
+        const count = countMessages();
+        const bottom = Math.max(
+          document.documentElement.scrollHeight || 0,
+          document.body.scrollHeight || 0,
+          ...scrollables.map((node) => node.scrollHeight || 0),
+        );
+        if (count === lastCount && bottom === lastBottom) {
+          stableRounds += 1;
+        } else {
+          stableRounds = 0;
+          lastCount = count;
+          lastBottom = bottom;
+        }
+      }
+
+      const findResponseId = (node) => {
+        let parent = node.parentElement;
+        while (parent && parent !== document.body) {
+          const id = parent.getAttribute('id') || '';
+          if (id.startsWith('response-')) return id.slice('response-'.length);
+          parent = parent.parentElement;
+        }
+        return '';
+      };
+      const messages = [];
+      let position = 0;
+      for (const node of Array.from(document.querySelectorAll(messageSelector))) {
+        if (!(node instanceof HTMLElement) || !isVisible(node)) continue;
+        const isAssistant = node.getAttribute('data-testid') === 'assistant-message';
+        const text = (node.innerText || node.textContent || '').replace(/\\s+/g, ' ').trim();
+        const html = node.innerHTML || '';
+        if (!text && !html) continue;
+        messages.push({
+          messageIndex: messages.length + 1,
+          messageId: findResponseId(node) || ('pos-' + position),
+          messageRole: isAssistant ? 'assistant' : 'user',
+          messageText: text,
+        });
+        position += 1;
+      }
+      return { messages };
+    })()`);u=b(f,"grok export-all conversation reader")}catch(n){return{status:"failed",error:`Conversation reader failed: ${n?.message||n}`,messageCount:0,messagesJson:"[]"}}if(!Array.isArray(u.messages))return{status:"failed",error:"Conversation reader returned malformed message rows.",messageCount:0,messagesJson:"[]"};const m=[];for(let n=0;n<u.messages.length;n+=1){const s=u.messages[n];if(!s||typeof s!=="object"||Array.isArray(s))return{status:"failed",error:`Conversation reader returned malformed message row ${n+1}.`,messageCount:0,messagesJson:"[]"};const g=String(s.messageId||"").trim(),y=String(s.messageText||"").trim();if(!g||!y||s.messageRole!=="assistant"&&s.messageRole!=="user")return{status:"failed",error:`Conversation reader returned malformed message row ${n+1}.`,messageCount:0,messagesJson:"[]"};m.push({messageIndex:Number.isInteger(s.messageIndex)?s.messageIndex:n+1,messageId:g,messageRole:s.messageRole,messageText:y})}if(!m.length)return{status:"empty",error:"Page loaded, but no visible message text was found after scrolling to bottom.",messageCount:0,messagesJson:"[]"};return{status:"ok",error:null,messageCount:m.length,messagesJson:JSON.stringify(m)}}export const grokExportAllCommand=S({site:"grok",name:"export-all",description:"Export Grok conversation history and each conversation transcript",access:"read",example:"opencli grok export-all --limit 5 -f json",domain:w,strategy:v.COOKIE,browser:!0,siteSession:"persistent",navigateBefore:!1,args:[{name:"limit",type:"int",default:0,help:"Max conversations to export; 0 means all loaded history"},{name:"offset",type:"int",default:0,help:"Skip this many conversations before exporting"},{name:"manifestPath",type:"string",default:"",help:"Optional grok/export JSON manifest path; skips history dialog and visits listed /c pages directly"},{name:"maxScrolls",type:"int",default:80,help:"Max history-list scroll rounds when limit is 0 (max 500)"},{name:"pageScrolls",type:"int",default:30,help:"Max per-conversation scroll-to-bottom rounds (max 200)"},{name:"pageTimeoutMs",type:"int",default:30000,help:"Max wait for each conversation page to show messages"},{name:"delayMinMs",type:"int",default:0,help:"Minimum polite delay after a conversation page loads"},{name:"delayMaxMs",type:"int",default:5000,help:"Maximum polite delay after a conversation page loads"}],columns:["index","id","title","date","url","status","messageCount","error","messagesJson"],func:async(o,e)=>{const t=d(e.limit,0,"limit",{min:0}),r=d(e.offset,0,"offset",{min:0}),l=d(e.maxScrolls,80,"maxScrolls",{min:1,max:500}),i=d(e.pageScrolls,30,"pageScrolls",{min:1,max:200}),a=d(e.pageTimeoutMs,30000,"pageTimeoutMs",{min:5000,max:180000}),c=d(e.delayMinMs,0,"delayMinMs",{min:0,max:60000}),f=d(e.delayMaxMs,5000,"delayMaxMs",{min:0,max:60000});if(f<c)throw new p("delayMaxMs","must be >= delayMinMs");const u=x(e.manifestPath,{offset:r,limit:t})||await N(o,{offset:r,limit:t,maxScrolls:l}),m=[];for(let n=0;n<u.length;n+=1){const s=u[n],g=await I(o,s,{pageTimeoutMs:a,pageScrolls:i,delayMinMs:c,delayMaxMs:f});m.push({index:r+n+1,id:s.id,title:s.title||null,date:s.date||null,url:s.url,status:g.status,messageCount:g.messageCount,error:g.error,messagesJson:g.messagesJson})}if(!m.length)throw new h("grok export-all","No Grok conversations were exported.");return m}}),__test__={normalizeInteger:d,readManifest:x};

package/clis/grok/export-utils.js

@@ -0,0 +1 @@
+import{ArgumentError as s,CommandExecutionError as i}from"@jackwener/opencli/errors";export const GROK_CONVERSATION_ID_RE=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;export function unwrapEvaluateResult(e){if(e&&typeof e==="object"&&!Array.isArray(e)&&Object.hasOwn(e,"session")&&Object.hasOwn(e,"data"))return e.data;return e}export function requireObjectEvaluateResult(e,t){const r=unwrapEvaluateResult(e);if(!r||typeof r!=="object"||Array.isArray(r))throw new i(`${t} returned a malformed payload`,"Expected an object payload from the Grok page.");return r}export function requireBooleanEvaluateResult(e,t){const r=unwrapEvaluateResult(e);if(typeof r!=="boolean")throw new i(`${t} returned a malformed payload`,"Expected a boolean payload from the Grok page.");return r}function l(e,t,r){const a=`https://grok.com/c/${t}`,o=e==null||e===""?a:String(e);let n;try{n=new URL(o)}catch{throw r(`invalid url for conversation ${t}`)}const f=n.hostname.toLowerCase(),c=n.pathname.match(/^\/c\/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})\/?$/i);if(n.protocol!=="https:"||f!=="grok.com"&&!f.endsWith(".grok.com")||!c)throw r(`invalid url for conversation ${t}`);if(c[1].toLowerCase()!==t)throw r(`url id mismatch for conversation ${t}`);return`https://grok.com/c/${t}`}export function normalizeConversationRows(e,t){if(!Array.isArray(e))throw new i(`${t} returned malformed rows`,"Expected rows to be an array.");return e.map((r,a)=>{if(!r||typeof r!=="object"||Array.isArray(r))throw new i(`${t} returned a malformed row`,`Row ${a+1} is not an object.`);const o=String(r.id||"").trim().toLowerCase();if(!GROK_CONVERSATION_ID_RE.test(o))throw new i(`${t} returned a malformed row`,`Row ${a+1} is missing a valid Grok conversation id.`);return{id:o,title:r.title==null||r.title===""?"":String(r.title),date:r.date==null||r.date===""?"":String(r.date),url:l(r.url,o,(n)=>new i(`${t} returned a malformed row`,n))}})}export function normalizeManifestRows(e){if(!Array.isArray(e))throw new s("manifestPath","must point to a JSON array exported by grok/export");return e.map((t,r)=>{if(!t||typeof t!=="object"||Array.isArray(t))throw new s("manifestPath",`row ${r+1} must be an object`);const a=String(t.id||"").trim().toLowerCase();if(!GROK_CONVERSATION_ID_RE.test(a))throw new s("manifestPath",`row ${r+1} is missing a valid Grok conversation id`);return{id:a,title:t.title==null||t.title===""?"":String(t.title),date:t.date==null||t.date===""?"":String(t.date),url:l(t.url,a,(o)=>new s("manifestPath",`row ${r+1}: ${o}`))}})}