publishport-opencli 1.0.0

package/clis/steam/app.js

@@ -0,0 +1 @@
+import{cli as d,Strategy as l}from"@jackwener/opencli/registry";import{EmptyResultError as u}from"@jackwener/opencli/errors";import{STEAM_STORE as s,decodeHtmlEntities as o,priceCents as f,requireAppId as g,requireCountryCode as y,steamFetch as b}from"./utils.js";function n(t){if(!Array.isArray(t))return"";return t.map((r)=>r&&typeof r==="object"?r.description??r.name??"":String(r)).filter(Boolean).join(", ")}d({site:"steam",name:"app",access:"read",description:"Steam storefront detail for a single app id",domain:"store.steampowered.com",strategy:l.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,help:'Numeric Steam app id (e.g. "620" for Portal 2)'},{name:"currency",default:"us",help:"Storefront country code (e.g. us / cn / jp / de)"}],columns:["id","name","type","isFree","releaseDate","developers","publishers","price","currency","metacritic","recommendations","genres","categories","shortDescription","website","url"],func:async(t)=>{const r=g(t.id),p=y(t.currency),c=`${s}/api/appdetails?appids=${r}&l=en&cc=${encodeURIComponent(p)}`,a=(await b(c,`steam app ${r}`))?.[r];if(!a||a.success!==!0||!a.data)throw new u("steam app",`Steam app id ${r} returned no data (may be region-locked or removed).`);const e=a.data,i=e.is_free===!0,m=f(e?.price_overview?.final??null);return[{id:String(e.steam_appid??r),name:o(e.name??""),type:String(e.type??""),isFree:i,releaseDate:String(e?.release_date?.date??""),developers:Array.isArray(e.developers)?e.developers.join(", "):"",publishers:Array.isArray(e.publishers)?e.publishers.join(", "):"",price:i?0:m,currency:String(e?.price_overview?.currency??"").toUpperCase(),metacritic:e?.metacritic?.score!=null?Number(e.metacritic.score):null,recommendations:e?.recommendations?.total!=null?Number(e.recommendations.total):null,genres:n(e.genres),categories:n(e.categories),shortDescription:o(e.short_description??""),website:String(e.website??""),url:`${s}/app/${e.steam_appid??r}/`}]}});

package/clis/steam/search.js

@@ -0,0 +1 @@
+import{cli as u,Strategy as p}from"@jackwener/opencli/registry";import{EmptyResultError as l}from"@jackwener/opencli/errors";import{STEAM_STORE as s,decodeHtmlEntities as d,priceCents as h,requireBoundedInt as y,requireCountryCode as f,requireString as w,steamFetch as S}from"./utils.js";function g(r){if(!r||typeof r!=="object")return"";return["windows","mac","linux"].filter((t)=>r[t]).join(",")}u({site:"steam",name:"search",access:"read",description:"Search the Steam storefront by name keyword",domain:"store.steampowered.com",strategy:p.PUBLIC,browser:!1,args:[{name:"query",positional:!0,required:!0,help:'Search keyword (e.g. "portal", "stardew")'},{name:"limit",type:"int",default:20,help:"Max results (1-50)"},{name:"currency",default:"us",help:"Storefront country code (e.g. us / cn / jp / de)"}],columns:["rank","id","name","price","currency","metascore","platforms","url"],func:async(r)=>{const t=w(r.query,"query"),n=y(r.limit,20,50),c=f(r.currency),i=`${s}/api/storesearch/?term=${encodeURIComponent(t)}&l=en&cc=${encodeURIComponent(c)}`,o=await S(i,"steam search"),a=Array.isArray(o?.items)?o.items:[];if(!a.length)throw new l("steam search",`No Steam results matched "${t}".`);return a.slice(0,n).map((e,m)=>({rank:m+1,id:String(e.id??""),name:d(e.name??""),price:h(e?.price?.final??null),currency:String(e?.price?.currency??"").toUpperCase(),metascore:e.metascore!=null&&e.metascore!==""?Number(e.metascore):null,platforms:g(e.platforms),url:e.id?`${s}/app/${e.id}/`:""}))}});

package/clis/steam/top-sellers.js

@@ -0,0 +1 @@
+import{cli as e,Strategy as t}from"@jackwener/opencli/registry";e({site:"steam",name:"top-sellers",access:"read",description:"Steam top selling games",domain:"store.steampowered.com",strategy:t.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:10,help:"Number of games"}],columns:["rank","name","price","discount","url"],pipeline:[{fetch:{url:"https://store.steampowered.com/api/featuredcategories/"}},{select:"top_sellers.items"},{map:{rank:"${{ index + 1 }}",name:"${{ item.name }}",price:"${{ item.final_price }}",discount:"${{ item.discount_percent }}",url:"https://store.steampowered.com/app/${{ item.id }}"}},{limit:"${{ args.limit }}"}]});

package/clis/steam/utils.js

@@ -0,0 +1 @@
+import{ArgumentError as s,CommandExecutionError as a,EmptyResultError as u}from"@jackwener/opencli/errors";export const STEAM_STORE="https://store.steampowered.com";const c="opencli-steam-adapter (+https://github.com/jackwener/opencli)";export function requireString(e,t){const r=String(e??"").trim();if(!r)throw new s(`steam ${t} cannot be empty`);return r}export function requireCountryCode(e,t="us"){const o=String(e===void 0||e===null?t:e).trim().toLowerCase();if(!/^[a-z]{2}$/.test(o))throw new s(`steam currency must be a two-letter storefront country code (got "${e}")`,"Examples: us, cn, jp, de. This controls Steam regional pricing and availability.");return o}export function requireBoundedInt(e,t,r,o="limit"){const n=e??t,i=typeof n==="number"?n:Number(n);if(!Number.isInteger(i)||i<=0)throw new s(`steam ${o} must be a positive integer`);if(i>r)throw new s(`steam ${o} must be <= ${r}`);return i}export function requireAppId(e){const t=String(e??"").trim();if(!t)throw new s('steam app id is required (e.g. "620" for Portal 2)');if(!/^\d+$/.test(t))throw new s(`steam app id "${e}" must be a positive integer`,"Copy the numeric id from `steam search` or the URL `store.steampowered.com/app/<id>/`.");return t}export async function steamFetch(e,t){let r;try{r=await fetch(e,{headers:{"user-agent":c,accept:"application/json"}})}catch(n){throw new a(`${t} request failed: ${n?.message??n}`,"Check that store.steampowered.com is reachable from this network.")}if(r.status===429)throw new a(`${t} returned HTTP 429 (rate limited)`,"Steam throttles bursty traffic; wait a few seconds and retry.");if(r.status===404)throw new u(t,"Steam returned 404 — the resource does not exist.");if(!r.ok)throw new a(`${t} returned HTTP ${r.status}`);let o;try{o=await r.json()}catch(n){throw new a(`${t} returned malformed JSON: ${n?.message??n}`)}return o}export function asString(e){return e==null?"":String(e)}const m={"&amp;":"&","&lt;":"<","&gt;":">","&quot;":'"',"&apos;":"'","&#39;":"'","&nbsp;":" "};export function decodeHtmlEntities(e){return String(e??"").replace(/&#x([0-9a-fA-F]+);/g,(t,r)=>String.fromCodePoint(parseInt(r,16))).replace(/&#(\d+);/g,(t,r)=>String.fromCodePoint(parseInt(r,10))).replace(/&(amp|lt|gt|quot|apos|#39|nbsp);/g,(t)=>m[t]||t)}export function priceCents(e){if(e==null||e==="")return null;const t=Number(e);if(!Number.isFinite(t))return null;return Number((t/100).toFixed(2))}

package/clis/substack/auth.js

@@ -0,0 +1,11 @@
+import{AuthRequiredError as i,CommandExecutionError as o}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as n}from"../_shared/site-auth.js";import{publicationContext as c}from"./post-utils.js";async function a(e){return(await e.getCookies({url:"https://substack.com"})).some((s)=>s.name==="substack.sid"||s.name==="connect.sid")}async function r(e){if(!await a(e))throw new i("substack.com","Substack session cookie missing");await e.goto("https://substack.com/");const t=await e.evaluate(`(async () => {
+    try {
+      const res = await fetch('/api/v1/user/profile/self', { credentials: 'include', headers: { 'Accept': 'application/json' } });
+      if (res.status === 401 || res.status === 403) return { kind: 'auth', detail: 'profile/self HTTP ' + res.status };
+      if (!res.ok) return { kind: 'http', httpStatus: res.status };
+      const text = await res.text();
+      let data = null; try { data = JSON.parse(text); } catch {}
+      if (!data || data.id == null) return { kind: 'auth', detail: 'profile/self returned no user — anonymous' };
+      return { ok: true, profile: data };
+    } catch (e) { return { kind: 'exception', detail: String(e && e.message || e) }; }
+  })()`);if(t?.kind==="auth")throw new i("substack.com",t.detail);if(t?.kind==="http")throw new o(`HTTP ${t.httpStatus} from profile/self`);if(t?.kind==="exception")throw new o(`Substack whoami failed: ${t.detail}`);if(!t?.ok)throw new o(`Unexpected Substack probe: ${JSON.stringify(t)}`);const s=c(t.profile);return{user_id:String(s.userId),publication:s.publication,url:s.host}}n({site:"substack",domain:"substack.com",loginUrl:"https://substack.com/sign-in",columns:["user_id","publication","url"],quickCheck:a,verify:r,poll:async(e)=>{if(!await a(e))throw new i("substack.com","Waiting for Substack session cookie");return r(e)}});

package/clis/substack/feed.js

@@ -0,0 +1 @@
+import{cli as a,Strategy as c}from"@jackwener/opencli/registry";import{buildSubstackBrowseUrl as l,loadSubstackFeed as s}from"./utils.js";a({site:"substack",name:"feed",access:"read",description:"Substack 热门文章 Feed",domain:"substack.com",strategy:c.COOKIE,args:[{name:"category",default:"all",help:"文章分类: all, tech, business, culture, politics, science, health"},{name:"limit",type:"int",default:20,help:"返回的文章数量"}],columns:["rank","title","author","date","readTime","url"],func:async(t,e)=>s(t,l(e.category),Number(e.limit)||20)});

package/clis/substack/post-utils.js

@@ -0,0 +1,2 @@
+import{AuthRequiredError as P,ArgumentError as M,CommandExecutionError as Q}from"@jackwener/opencli/errors";const O=new Set(["everyone","only_paid"]);export function publicationContext(z){if(!z||z.id==null)throw new P("substack.com","Not logged in to Substack (profile has no id)");const F=Array.isArray(z.publicationUsers)?z.publicationUsers:[],H=F.find((K)=>K&&K.is_primary)||F[0],G=H&&H.publication;if(!G||!G.subdomain)throw new Q("Substack account has no publication to publish to");return{host:G.custom_domain&&!G.custom_domain_optional?`https://${G.custom_domain}`:`https://${G.subdomain}.substack.com`,userId:z.id,publication:G.name||G.subdomain,subdomain:G.subdomain}}export function validateAudience(z){const F=String(z??"everyone");if(!O.has(F))throw new M(`Invalid --audience "${F}" (allowed: everyone, only_paid)`);return F}export function imageDataUri(z,F){return`data:image/${F||"jpeg"};base64,${z}`}export function textToParagraphs(z){const F=String(z??"").replace(/\r\n/g,`
+`).trim();if(!F)return[];return F.split(/\n{2,}/).map((H)=>H.trim()).filter(Boolean)}export function paragraphNode(z){return{type:"paragraph",content:String(z??"").length?[{type:"text",text:String(z)}]:[]}}export function imageBlock(z,{width:F=1456,height:H=819}={}){return{type:"captionedImage",content:[{type:"image2",attrs:{src:z,fullscreen:!1,imageSize:"normal",height:H,width:F,resizeWidth:Math.round(F/2),bytes:null,alt:null,title:null,type:null,href:null,belowTheFold:!1,internalRedirect:null}}]}}export function buildDraftBody(z){return{type:"doc",content:Array.isArray(z)?z:[]}}export function buildDraftPayload({title:z,subtitle:F="",bodyDoc:H,userId:G,audience:J="everyone",sectionId:K=null}){return{draft_title:String(z??""),draft_subtitle:String(F??""),draft_body:JSON.stringify(H??buildDraftBody([])),draft_bylines:[{id:G,is_guest:!1}],audience:J,draft_section_id:K,section_chosen:K!=null,write_comment_permissions:"everyone"}}export function collectSections(z){const F=z&&Array.isArray(z.publications)?z.publications:[],H=[];for(const G of F)for(const J of Array.isArray(G?.sections)?G.sections:[])if(J&&J.id!=null&&J.name)H.push({id:J.id,name:String(J.name)});return H}export function resolveSectionId(z,F){const H=String(F??"").trim().toLowerCase(),G=(z||[]).find((J)=>String(J.name).toLowerCase()===H);if(!G){const J=(z||[]).map((K)=>K.name).join(", ")||"(none)";throw new M(`Substack section "${F}" not found. Available: ${J}`)}return G.id}export function classifyImages(z){if(!z)return[];return String(z).split(",").map((F)=>F.trim()).filter(Boolean).map((F)=>({kind:/^https?:\/\//i.test(F)?"url":"path",value:F}))}export const __test__={VALID_AUDIENCES:O};

package/clis/substack/publication.js

@@ -0,0 +1 @@
+import{cli as a,Strategy as r}from"@jackwener/opencli/registry";import{loadSubstackArchive as i}from"./utils.js";a({site:"substack",name:"publication",access:"read",description:"获取特定 Substack Newsletter 的最新文章",domain:"substack.com",strategy:r.COOKIE,args:[{name:"url",required:!0,positional:!0,help:"Newsletter URL（如 https://example.substack.com）"},{name:"limit",type:"int",default:20,help:"返回的文章数量"}],columns:["rank","title","date","description","url"],func:async(t,e)=>i(t,e.url.replace(/\/$/,""),Number(e.limit)||20)});

package/clis/substack/publish.js

@@ -0,0 +1,10 @@
+import*as T from"node:fs";import*as A from"node:path";import{cli as f,Strategy as E}from"@jackwener/opencli/registry";import{AuthRequiredError as w,ArgumentError as N,CommandExecutionError as $}from"@jackwener/opencli/errors";import{publicationContext as b,validateAudience as k,imageDataUri as h,textToParagraphs as m,paragraphNode as D,imageBlock as y,buildDraftBody as u,buildDraftPayload as n,collectSections as c,resolveSectionId as i,classifyImages as l}from"./post-utils.js";const P={".jpg":"jpeg",".jpeg":"jpeg",".png":"png",".gif":"gif",".webp":"webp"};function d(z){if(z&&typeof z==="object"&&!Array.isArray(z)&&"session"in z&&"data"in z)return z.data;return z}async function V(z,{url:G,method:H="GET",headers:L={},body:O=null}){const J=`(async () => {
+    try {
+      const opts = { method: ${JSON.stringify(H)}, credentials: 'include', headers: ${JSON.stringify({Accept:"application/json",...L})} };
+      ${O!=null?`opts.body = ${JSON.stringify(O)};`:""}
+      const res = await fetch(${JSON.stringify(G)}, opts);
+      const text = await res.text();
+      let data = null; try { data = JSON.parse(text); } catch {}
+      return { ok: res.ok, status: res.status, data, text: text.slice(0, 300) };
+    } catch (e) { return { ok: false, status: 0, data: null, text: String(e && e.message || e) }; }
+  })()`;return d(await z.evaluate(J))}function F(z){return l(z).map((G)=>{if(G.kind==="url")return G;const H=A.resolve(G.value),L=A.extname(H).toLowerCase();if(!P[L])throw new N(`Unsupported image "${L}" (jpg/png/gif/webp): ${G.value}`);const O=T.statSync(H,{throwIfNoEntry:!1});if(!O||!O.isFile())throw new N(`Not a file: ${H}`);return{kind:"path",value:H,mime:P[L]}})}f({site:"substack",name:"publish",access:"write",description:"Publish a post to your Substack publication (or save a draft with --draft)",domain:"substack.com",strategy:E.COOKIE,browser:!0,args:[{name:"title",type:"string",required:!0,positional:!0,help:"Post title"},{name:"body",type:"string",help:"Post body text (blank lines split paragraphs)"},{name:"subtitle",type:"string",help:"Optional subtitle"},{name:"images",type:"string",help:"Images: comma-separated local paths and/or http(s) urls"},{name:"audience",type:"string",default:"everyone",help:"Visibility: everyone | only_paid"},{name:"section",type:"string",help:"Section name to file the post under"},{name:"send",type:"boolean",default:!1,help:"Also email subscribers on publish"},{name:"draft",type:"boolean",default:!1,help:"Create the draft but do not publish"}],columns:["status","publication","draft_id","url"],func:async(z,G)=>{if(!z)throw new $("Browser session required for substack publish");const H=String(G.title??"").trim();if(!H)throw new N("substack publish: title is required");const L=k(G.audience),O=F(G.images);await z.goto("https://substack.com/");const J=await V(z,{url:"https://substack.com/api/v1/user/profile/self"});if(J.status===401||J.status===403||!J.data||J.data.id==null)throw new w("substack.com",`Not logged in (profile/self HTTP ${J.status})`);const{host:K,userId:M,publication:S}=b(J.data);await z.goto(`${K}/`);const U=[];for(const Q of O){let B=Q.value;if(Q.kind==="path"){const I=T.readFileSync(Q.value).toString("base64"),Z=await V(z,{url:`${K}/api/v1/image`,method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:`image=${encodeURIComponent(h(I,Q.mime))}`});if(!Z.ok||!Z.data?.url)throw new $(`Substack image upload failed: HTTP ${Z.status} ${Z.text}`);B=Z.data.url}U.push(y(B))}const R=[...m(G.body).map(D),...U];if(!R.length)R.push(D(""));const C=u(R);let X=null;if(G.section){const Q=await V(z,{url:`${K}/api/v1/subscriptions`});X=i(c(Q.data),G.section)}const x=n({title:H,subtitle:G.subtitle,bodyDoc:C,userId:M,audience:L,sectionId:X}),W=await V(z,{url:`${K}/api/v1/drafts`,method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(x)});if(!W.ok||W.data?.id==null)throw new $(`Substack create-draft failed: HTTP ${W.status} ${W.text}`);const Y=W.data.id,_=`${K}/publish/post/${Y}`;if(G.draft)return{status:"draft",publication:S,draft_id:String(Y),url:_};const j=await V(z,{url:`${K}/api/v1/drafts/${Y}/prepublish`});if(!j.ok)throw new $(`Substack prepublish failed: HTTP ${j.status} ${j.text}`);const q=await V(z,{url:`${K}/api/v1/drafts/${Y}/publish`,method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({send:!!G.send,share_automatically:!1})});if(!q.ok)throw new $(`Substack publish failed: HTTP ${q.status} ${q.text}`);const v=q.data?.slug;return{status:"published",publication:S,draft_id:String(Y),url:v?`${K}/p/${v}`:_}}});export const __test__={resolveImageEntries:F,EXT_MIME:P};

package/clis/substack/search.js

@@ -0,0 +1 @@
+import{CommandExecutionError as u}from"@jackwener/opencli/errors";import{cli as d,Strategy as h}from"@jackwener/opencli/registry";function l(){return{"User-Agent":"Mozilla/5.0",Accept:"application/json"}}function e(t){return typeof t==="string"?t.replace(/\s+/g," ").trim():""}function m(t){if(t?.custom_domain)return`https://${t.custom_domain}`;if(t?.subdomain)return`https://${t.subdomain}.substack.com`;return""}async function b(t,n){const a=new URL("https://substack.com/api/v1/post/search");a.searchParams.set("query",t);a.searchParams.set("page","0");a.searchParams.set("includePlatformResults","true");const r=await fetch(a,{headers:l()});if(!r.ok)throw new u(`Substack post search failed: HTTP ${r.status}`);const o=await r.json();return(Array.isArray(o?.results)?o.results:[]).slice(0,n).map((s,c)=>({rank:c+1,title:e(s?.title),author:e(s?.publishedBylines?.[0]?.name),date:e(s?.post_date).split("T")[0]||e(s?.post_date),description:e(s?.description||s?.subtitle||s?.truncated_body_text).slice(0,150),url:e(s?.canonical_url)}))}async function f(t,n){const a=new URL("https://substack.com/api/v1/profile/search");a.searchParams.set("query",t);a.searchParams.set("page","0");const r=await fetch(a,{headers:l()});if(!r.ok)throw new u(`Substack publication search failed: HTTP ${r.status}`);const o=await r.json();return(Array.isArray(o?.results)?o.results:[]).slice(0,n).map((s,c)=>{const i=s?.primaryPublication||s?.publicationUsers?.[0]?.publication||{};return{rank:c+1,title:e(i?.name||s?.name),author:e(s?.name),date:"",description:e(i?.hero_text||s?.bio).slice(0,150),url:m(i)}})}d({site:"substack",name:"search",access:"read",description:"搜索 Substack 文章和 Newsletter",domain:"substack.com",strategy:h.PUBLIC,browser:!1,args:[{name:"keyword",required:!0,positional:!0,help:"搜索关键词"},{name:"type",default:"posts",choices:["posts","publications"],help:"搜索类型（posts=文章, publications=Newsletter）"},{name:"limit",type:"int",default:20,help:"返回结果数量"}],columns:["rank","title","author","date","description","url"],func:async(t)=>{const n=Math.max(1,Math.min(Number(t.limit)||20,50));return t.type==="publications"?f(t.keyword,n):b(t.keyword,n)}});

package/clis/substack/utils.js

@@ -0,0 +1,108 @@
+import{CommandExecutionError as r}from"@jackwener/opencli/errors";const i='a[href*="/home/post/"], a[href*="/p/"]',o='a[href*="/p/"]';export function buildSubstackBrowseUrl(t){if(!t||t==="all")return"https://substack.com/";return`https://substack.com/browse/${t==="tech"?"technology":t}`}export async function loadSubstackFeed(t,e,s){if(!t)throw new r("Browser session required for substack feed");await t.goto(e);await t.wait({selector:i,timeout:5});const n=await t.evaluate(`
+    (async () => {
+      await new Promise((resolve) => setTimeout(resolve, 3000));
+      const limit = ${Math.max(1,Math.min(s,50))};
+      const normalize = (value) => (value || '').replace(/\\s+/g, ' ').trim();
+      const posts = [];
+      const seen = new Set();
+
+      const allLinks = Array.from(document.querySelectorAll('a')).filter((link) => {
+        const href = link.getAttribute('href') || '';
+        return href.includes('/home/post/') || href.includes('/p/');
+      });
+
+      for (const linkEl of allLinks) {
+        let postUrl = linkEl.getAttribute('href') || '';
+        if (!postUrl) continue;
+        if (!postUrl.startsWith('http')) postUrl = 'https://substack.com' + postUrl;
+        if (seen.has(postUrl)) continue;
+
+        const lines = (linkEl.innerText || '')
+          .split('\\n')
+          .map((line) => normalize(line))
+          .filter(Boolean);
+
+        const readMeta = lines.find((line) => /\\b(read|watch|listen)\\b/i.test(line)) || '';
+        if (!readMeta) continue;
+
+        const date = lines.find((line) => /^[A-Z]{3}\\s+\\d{1,2}$/i.test(line)) || '';
+        const contentLines = lines.filter((line) =>
+          line &&
+          line !== date &&
+          line !== readMeta &&
+          line.toLowerCase() !== 'save' &&
+          line.toLowerCase() !== 'more' &&
+          !/^(sign in|create account|get app)$/i.test(line),
+        );
+
+        const metaParts = readMeta.split('∙').map((part) => normalize(part));
+        const author = metaParts[0] || '';
+        const readTime = metaParts.slice(1).join(' ∙ ') || readMeta;
+        const title = contentLines.length >= 2 ? contentLines[1] : (contentLines[0] || '');
+        const description = contentLines.length >= 3 ? contentLines.slice(2).join(' ') : '';
+        if (!title) continue;
+
+        seen.add(postUrl);
+        posts.push({
+          rank: posts.length + 1,
+          title,
+          author,
+          date,
+          readTime,
+          description: description.slice(0, 150),
+          url: postUrl,
+        });
+
+        if (posts.length >= limit) break;
+      }
+
+      return posts;
+    })()
+  `);return Array.isArray(n)?n:[]}export async function loadSubstackArchive(t,e,s){if(!t)throw new r("Browser session required for substack archive");await t.goto(`${e}/archive`);await t.wait({selector:o,timeout:5});const n=await t.evaluate(`
+    (async () => {
+      await new Promise((resolve) => setTimeout(resolve, 3000));
+      const normalize = (value) => (value || '').replace(/\\s+/g, ' ').trim();
+      const limit = ${Math.max(1,Math.min(s,50))};
+      const grouped = new Map();
+
+      for (const link of Array.from(document.querySelectorAll('a[href*="/p/"]'))) {
+        const rawHref = link.getAttribute('href') || '';
+        if (!rawHref || rawHref === '/p/upgrade') continue;
+
+        const url = rawHref.startsWith('http') ? rawHref : ${JSON.stringify(e)} + rawHref;
+        const text = normalize(link.textContent);
+        if (!text) continue;
+        if (/^(subscribe|paid|home|about|latest|top|discussions)$/i.test(text)) continue;
+        if (/^[\\d,]+$/.test(text)) continue;
+
+        const entry = grouped.get(url) || { texts: new Set(), date: '' };
+        entry.texts.add(text);
+
+        const container = link.closest('article, section, div') || link.parentElement || link;
+        const containerText = normalize(container.textContent);
+        if (!entry.date) {
+          entry.date = containerText.match(/\\b(?:[A-Z]{3}\\s+\\d{1,2}|[A-Z][a-z]{2}\\s+\\d{1,2})\\b/)?.[0] || '';
+        }
+
+        grouped.set(url, entry);
+      }
+
+      const posts = [];
+      for (const [url, entry] of Array.from(grouped.entries())) {
+        const texts = Array.from(entry.texts).map((text) => normalize(text)).filter((text) => text.length > 3).sort((a, b) => a.length - b.length);
+        const title = texts[0] || '';
+        const description = texts.find((text) => text !== title) || '';
+        if (!title) continue;
+        posts.push({
+          rank: posts.length + 1,
+          title,
+          date: entry.date,
+          description: description.slice(0, 150),
+          url,
+        });
+        if (posts.length >= limit) break;
+      }
+
+      return posts;
+    })()
+  `);return Array.isArray(n)?n:[]}export const __test__={FEED_POST_LINK_SELECTOR:i,ARCHIVE_POST_LINK_SELECTOR:o};

package/clis/suno/auth.js

@@ -0,0 +1,21 @@
+import{AuthRequiredError as D,CommandExecutionError as F}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as K}from"../_shared/site-auth.js";async function G(B){return(await B.getCookies({url:"https://clerk.suno.com"})).some((H)=>H.name==="__session"&&H.value)}async function J(B){if(!await G(B))throw new D("suno.com","Suno Clerk __session/__client cookie missing");await B.goto("https://suno.com/");await B.wait(2);const z=await B.evaluate(`(async () => {
+    try {
+      for (let i = 0; i < 20; i += 1) {
+        if (window.Clerk && window.Clerk.loaded) break;
+        await new Promise(r => setTimeout(r, 250));
+      }
+      const C = window.Clerk;
+      if (!C) return { kind: 'exception', detail: 'window.Clerk never mounted' };
+      const user = C.user;
+      const session = C.session;
+      if (!user || !session) {
+        return { kind: 'auth', detail: 'Suno Clerk mounted but no active user/session — anonymous' };
+      }
+      const email = user.primaryEmailAddress?.emailAddress
+        || user.emailAddresses?.[0]?.emailAddress
+        || '';
+      return { ok: true, user_id: String(user.id), name: String(user.username || email || '') };
+    } catch (e) {
+      return { kind: 'exception', detail: String(e && e.message || e) };
+    }
+  })()`);if(z?.kind==="auth")throw new D("suno.com",z.detail);if(z?.kind==="http")throw new F(`HTTP ${z.httpStatus} from clerk.suno.com`);if(z?.kind==="exception")throw new F(`Suno whoami failed: ${z.detail}`);if(!z?.ok)throw new F(`Unexpected Suno probe: ${JSON.stringify(z)}`);return{user_id:z.user_id,name:z.name}}K({site:"suno",domain:"suno.com",loginUrl:"https://suno.com/?sign-in=true",columns:["user_id","name"],quickCheck:G,verify:J,poll:async(B)=>{if(!await G(B))throw new D("suno.com","Waiting for Suno Clerk __session/__client cookie");return J(B)}});

package/clis/suno/download.js

@@ -0,0 +1,17 @@
+import{cli as N,Strategy as D}from"@jackwener/opencli/registry";import{ArgumentError as b,CommandExecutionError as Y,EmptyResultError as C}from"@jackwener/opencli/errors";import{STUDIO_API as U,SUNO_DOMAIN as v,SUNO_URL as B,downloadSunoClip as y,ensureSunoSession as A,normalizeBooleanFlag as O,parseFormats as _,resolveSunoOutputDir as R,unwrapEvaluateResult as I}from"./utils.js";import*as S from"node:os";function E(J){if(!J)return"-";const H=S.homedir();return J.startsWith(H)?`~${J.slice(H.length)}`:J}function k(J){const H=String(J||"").trim();if(!H)throw new b("clip-id required (UUID or /song/<id> URL)");if(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(H))return H.toLowerCase();try{const V=new URL(H),W=V.pathname.match(/^\/song\/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})\/?$/i);if(V.protocol==="https:"&&V.hostname==="suno.com"&&W)return W[1].toLowerCase()}catch{}throw new b(`Invalid clip-id: ${H}`,"Pass a UUID or a https://suno.com/song/<uuid> URL.")}export const downloadCommand=N({site:"suno",name:"download",access:"write",description:"Download an existing Suno clip (MP3 + optional WAV/M4A/video) by id",domain:v,strategy:D.COOKIE,browser:!0,siteSession:"persistent",navigateBefore:!1,defaultFormat:"plain",args:[{name:"clip",positional:!0,required:!0,help:"Clip UUID or https://suno.com/song/<id> URL"},{name:"formats",help:"Comma-separated formats: mp3, m4a, wav, video, cover, metadata. Default: mp3,metadata"},{name:"op",help:"Output directory (default: ~/Music/suno)"},{name:"confirm-paid",type:"boolean",default:!1,help:"Required to allow paid downloads (wav). Without it, paid formats are skipped with a warning."}],columns:["status","clip","title","files","link"],func:async(J,H)=>{const K=k(H.clip),V=_(H.formats),W=O(H["confirm-paid"]),L=new Set(["wav"]),Z=[],q=V.filter((G)=>{if(L.has(G)&&!W){Z.push(G);return!1}return!0});if(!q.length)throw new b("All requested formats require --confirm-paid true","Add --confirm-paid true or include a free format such as mp3 or metadata.");const T=R(H.op),z=(await A(J)).deviceId,X=I(await J.evaluate(`(async () => {
+            const browserToken = JSON.stringify({ token: btoa(JSON.stringify({ timestamp: Date.now() })) });
+            const res = await fetch('${U}/api/feed/v3', {
+                method: 'POST',
+                headers: {
+                    'Authorization': 'Bearer ' + (await window.Clerk.session.getToken()),
+                    'browser-token': browserToken,
+                    'device-id': ${JSON.stringify(z)},
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({ clip_ids: ['${K}'] }),
+            });
+            if (!res.ok) return { ok: false, error: 'HTTP ' + res.status };
+            const payload = await res.json().catch(() => null);
+            if (!payload || !Array.isArray(payload.clips)) return { ok: false, error: 'malformed clips payload' };
+            return { ok: true, clips: payload.clips };
+        })()`));if(!X?.ok)throw new Y(`Suno feed lookup failed: ${X?.error||"unknown"}`);if(!Array.isArray(X.clips))throw new Y("Suno feed lookup returned malformed clips payload");const Q=X.clips.find((G)=>G.id===K);if(!Q)throw new C("suno download",`Clip ${K} not found in your account. Confirm at ${B}/song/${K}.`);if(Q.status!=="complete")throw new Y(`Clip ${K} status is "${Q.status}" — not complete yet. Retry once generation finishes.`);const $=await y(J,Q,T,q,z);if(!$.written.some((G)=>G.ok))throw new Y(`Suno download wrote no files for clip ${K}`);const j=`${B}/song/${Q.id}`,x=$.written.map((G)=>G.ok?`${G.format}:${E(G.file)}`:`${G.format}:✗(${G.reason})`).join(" | "),F=Z.length?` | skipped(needs --confirm-paid):${Z.join(",")}`:"",M=`${x}${F}`;return[{status:$.written.some((G)=>!G.ok)?"⚠ partial":"✅ saved",clip:Q.id.slice(0,8),title:Q.title||"(untitled)",files:`\uD83D\uDCC1 ${M}`,link:`\uD83D\uDD17 ${j}`}]}});

package/clis/suno/generate.js

@@ -0,0 +1,4 @@
+import{cli as c,Strategy as n}from"@jackwener/opencli/registry";import{ArgumentError as z,CommandExecutionError as V}from"@jackwener/opencli/errors";import{DEFAULT_SUNO_MODEL as y,SUNO_DOMAIN as t,SUNO_MODELS as v,SUNO_URL as Z,checkSunoCaptcha as o,clampSlider as _,downloadSunoClip as i,ensureSunoSession as e,normalizeBooleanFlag as A,parseFormats as a,pollSunoClips as s,requirePositiveInt as r,resolveSunoOutputDir as HH,submitSunoGeneration as JH}from"./utils.js";import*as C from"node:crypto";import*as KH from"node:os";function QH(K){if(!K)return"-";const J=KH.homedir();return K.startsWith(J)?`~${K.slice(J.length)}`:K}export const generateCommand=c({site:"suno",name:"generate",access:"write",description:"Generate music with Suno (V5.5 chirp-fenix by default) and download clips locally",domain:t,strategy:n.COOKIE,browser:!0,siteSession:"persistent",navigateBefore:!1,defaultFormat:"plain",args:[{name:"prompt",positional:!0,required:!1,help:"Simple-mode description (ignored when --lyrics is provided)"},{name:"lyrics",help:"Custom-mode lyrics (with [Verse]/[Chorus] metatags). Triggers Custom mode."},{name:"tags",help:"Custom-mode style tags (genre, BPM, instruments...). Used with --lyrics."},{name:"negative-tags",help:'Custom-mode style exclusions (e.g. "no vocals, no autotune"). Used with --lyrics.'},{name:"title",help:"Song title (default: auto-derived from prompt)"},{name:"instrumental",type:"boolean",default:!1,help:"No vocals"},{name:"model",help:`Model id: ${v.join(", ")}. Default: ${y}`},{name:"weirdness",help:"Creative weirdness slider (0..1). Default: 0.5"},{name:"style-weight",help:"Style adherence slider (0..1). Default: 0.5"},{name:"formats",help:"Comma-separated download formats: mp3, m4a, wav, video, cover, metadata. Default: mp3,metadata"},{name:"op",help:"Output directory (default: ~/Music/suno)"},{name:"timeout",type:"int",default:300,help:"Max seconds to wait for clips to finish (default: 300)"},{name:"sd",type:"boolean",default:!1,help:"Skip download; only print clip ids and Suno URLs"},{name:"confirm-paid",type:"boolean",default:!1,help:"Required to allow paid downloads (wav). Without it, paid formats are skipped with a warning."}],columns:["status","clip","title","files","link"],func:async(K,J)=>{const B=J.lyrics?String(J.lyrics):"",M=J.tags?String(J.tags):"",D=J["negative-tags"]?String(J["negative-tags"]):"",R=J.prompt?String(J.prompt):"",P=J.title?String(J.title):"",T=J.model?String(J.model).trim():y;if(!v.includes(T))throw new z(`Unsupported --model "${T}"`,`Choices: ${v.join(", ")}`);const $=B.trim()!=="";if(!$&&!R.trim())throw new z("Either provide a Simple-mode prompt as the positional argument, or pass --lyrics for Custom mode.",`Examples:
+  opencli suno generate "lo-fi study beat, 80 bpm"
+  opencli suno generate --lyrics "[Verse]\\n..." --tags "synthwave, 120 bpm"`);if(!$&&(M||D))throw new z("--tags and --negative-tags only apply in Custom mode (alongside --lyrics).");const f=a(J.formats),h=A(J["confirm-paid"]),I=A(J.sd),O=new Set(["wav"]),b=[],L=f.filter((H)=>{if(O.has(H)&&!h){b.push(H);return!1}return!0});if(!I&&!L.length)throw new z("All requested formats require --confirm-paid true","Add --confirm-paid true or include a free format such as mp3 or metadata.");const U=HH(J.op),E=r(J.timeout,"--timeout"),S=A(J.instrumental),u=_(J.weirdness,"--weirdness",0.5),m=_(J["style-weight"],"--style-weight",0.5),d=(P||($?M||B.split(`
+`)[0]:R)).replace(/\s+/g," ").trim().slice(0,60)||"Untitled",X=await e(K);if(!X.planId)throw new V(`Suno generation needs a resolved plan id for the user_tier field, but billing/info did not surface one for this account (subscription_type=${X.planKey}). Verify the account is active at ${Z}/account, then retry.`);const G=X.deviceId,W=await o(K,G);if(!W?.ok)throw new V(`Suno captcha pre-flight failed${W?.status?` (HTTP ${W.status})`:""}.`,`Open ${Z}/create in Chrome and verify the account is ready, then retry.`);if(W?.required)throw new V("Suno requires a CAPTCHA challenge for this account/IP right now.",`Open ${Z}/create in Chrome, solve a Create challenge once, then retry.`);if(X.totalCreditsAvailable<10){const H=X.breakdown;throw new V(`Suno generation needs ~10 credits; you have ${X.totalCreditsAvailable} (monthly ${H.monthlyRemaining}/${H.monthlyLimit} + packs ${H.purchasedPacks} + leftover ${H.pack}). Top up at ${Z}/account.`)}const k=C.randomUUID(),p=C.randomUUID(),N=await JH(K,{mode:$?"custom":"simple",model:T,title:d,lyrics:B,tags:M,negativeTags:D,description:R,makeInstrumental:S,weirdness:u,styleWeight:m,userTier:X.planId,createSessionToken:p,transactionUuid:k,deviceId:G});if(!Array.isArray(N.clips))throw new V("Suno generation returned malformed clips payload.");const j=N.clips.map((H)=>H?.id);if(j.some((H)=>!H))throw new V("Suno generation returned malformed clip identity.");if(!j.length)throw new V("Suno accepted the request but returned no clip ids.");const x=await s(K,j,E,G);if(!x.filter((H)=>H.status==="complete").length){const H=x.map((Y)=>`${Y.id.slice(0,8)}:${Y.status}`).join(", ");throw new V(`All Suno clips failed (${H}). Open ${Z}/song/${j[0]} to inspect.`)}const q=[];for(const H of x){const Y=`${Z}/song/${H.id}`;if(H.status!=="complete"){q.push({status:`❌ ${H.status}`,clip:H.id.slice(0,8),title:H.title||"(untitled)",files:"-",link:`\uD83D\uDD17 ${Y}`});continue}if(I){q.push({status:"\uD83C\uDFB5 generated",clip:H.id.slice(0,8),title:H.title||"(untitled)",files:"\uD83D\uDCC1 -",link:`\uD83D\uDD17 ${Y}`});continue}const F=await i(K,H,U,L,G);if(!F.written.some((Q)=>Q.ok))throw new V(`Suno download wrote no files for clip ${H.id}`);const w=F.written.map((Q)=>Q.ok?`${Q.format}:${QH(Q.file)}`:`${Q.format}:✗(${Q.reason})`).join(" | "),g=b.length?` | skipped(needs --confirm-paid):${b.join(",")}`:"",l=F.written.some((Q)=>!Q.ok);q.push({status:l?"⚠ partial":"✅ saved",clip:H.id.slice(0,8),title:H.title||"(untitled)",files:`\uD83D\uDCC1 ${w}${g}`,link:`\uD83D\uDD17 ${Y}`})}return q}});

package/clis/suno/list.js

@@ -0,0 +1,14 @@
+import{cli as d,Strategy as u}from"@jackwener/opencli/registry";import{CommandExecutionError as i,EmptyResultError as c}from"@jackwener/opencli/errors";import{STUDIO_API as p,SUNO_DOMAIN as f,SUNO_URL as m,ensureSunoSession as y,requireNonNegativeInt as w,requirePositiveInt as g,unwrapEvaluateResult as k}from"./utils.js";export const listCommand=d({site:"suno",name:"list",access:"read",description:"List recent Suno clips in your library (id, title, status, created_at, link)",domain:f,strategy:u.COOKIE,browser:!0,siteSession:"persistent",navigateBefore:!1,args:[{name:"limit",type:"int",default:20,help:"Max clips to list (default: 20)"},{name:"page",type:"int",default:0,help:"Pagination offset, 0-based (default: 0)"}],columns:["rank","clip","title","status","created","link"],func:async(r,s)=>{const a=g(s.limit,"--limit"),o=w(s.page??0,"--page"),n=(await y(r)).deviceId,t=k(await r.evaluate(`(async () => {
+            const browserToken = JSON.stringify({ token: btoa(JSON.stringify({ timestamp: Date.now() })) });
+            const res = await fetch('${p}/api/feed/v2?page=${o}', {
+                headers: {
+                    'Authorization': 'Bearer ' + (await window.Clerk.session.getToken()),
+                    'browser-token': browserToken,
+                    'device-id': ${JSON.stringify(n)},
+                },
+            });
+            if (!res.ok) return { ok: false, status: res.status };
+            const data = await res.json().catch(() => null);
+            if (!data || !Array.isArray(data.clips)) return { ok: false, error: 'malformed clips payload' };
+            return { ok: true, clips: data.clips };
+        })()`));if(!t?.ok)throw new i(t?.error||`Suno feed lookup failed (HTTP ${t?.status||"?"}).`);if(!Array.isArray(t.clips))throw new i("Suno feed lookup returned malformed clips payload");if(t.clips.length===0)throw new c("suno list","No Suno clips found in your library.");return t.clips.slice(0,a).map((e,l)=>{if(!e||typeof e.id!=="string"||!e.id)throw new i("Suno feed lookup returned malformed clip identity");return{rank:l+1+o*a,clip:e.id.slice(0,8),title:e.title||"(untitled)",status:e.status||"?",created:(e.created_at||"").replace("T"," ").replace(/\..*$/,"").replace(/Z$/,""),link:`${m}/song/${e.id}`}})}});

package/clis/suno/status.js

@@ -0,0 +1 @@
+import{cli as H,Strategy as J}from"@jackwener/opencli/registry";import{AuthRequiredError as K,CommandExecutionError as W}from"@jackwener/opencli/errors";import{SUNO_DOMAIN as L,checkSunoCaptcha as P,ensureSunoSession as Q}from"./utils.js";export const statusCommand=H({site:"suno",name:"status",access:"read",description:"Check Suno login, plan, credit balance, and captcha readiness",domain:L,strategy:J.COOKIE,browser:!0,siteSession:"persistent",navigateBefore:!1,args:[],columns:["Status","Plan","Credits","Monthly","Captcha"],func:async(F)=>{let x;try{x=await Q(F)}catch(B){if(B instanceof K)return[{Status:"Not logged in",Plan:"-",Credits:"-",Monthly:"-",Captcha:"-"}];throw B}let z;try{z=await P(F,x.deviceId)}catch(B){z={required:!0}}const G=x.breakdown;return[{Status:"Connected",Plan:x.planKey,Credits:String(x.totalCreditsAvailable),Monthly:`${G.monthlyRemaining}/${G.monthlyLimit}`,Captcha:z?.required===!0?"Required (solve in UI)":"Not required"}]}});

package/clis/suno/utils.js

@@ -0,0 +1,102 @@
+import*as J from"node:fs";import*as M from"node:path";import{ArgumentError as N,AuthRequiredError as k,CommandExecutionError as L,EmptyResultError as x,TimeoutError as b}from"@jackwener/opencli/errors";export const SUNO_DOMAIN="suno.com",SUNO_URL="https://suno.com",STUDIO_API="https://studio-api-prod.suno.com",SUNO_CDN="https://cdn1.suno.ai",SUNO_MODELS=["chirp-fenix","chirp-bluejay","chirp-v4","chirp-v3-5"],DEFAULT_SUNO_MODEL="chirp-fenix",SUPPORTED_FORMATS=["mp3","m4a","wav","video","cover","metadata"],DEFAULT_FORMATS=["mp3","metadata"];export function parseFormats(G){if(G===void 0||G===null||G==="")return DEFAULT_FORMATS.slice();const V=(Array.isArray(G)?G.join(","):String(G)).split(",").map((Z)=>Z.trim().toLowerCase()).filter(Boolean);if(!V.length)return DEFAULT_FORMATS.slice();const X=V.filter((Z)=>!SUPPORTED_FORMATS.includes(Z));if(X.length)throw new N(`Unsupported --formats value(s): ${X.join(", ")}`,`Supported: ${SUPPORTED_FORMATS.join(", ")}. (stems require multi-step extraction and are not yet wired.)`);return Array.from(new Set(V))}export function resolveSunoOutputDir(G){const Q=String(G||"").trim();if(!Q)return M.join(process.env.HOME||"~","Music","suno");if(Q==="~")return process.env.HOME||"~";if(Q.startsWith("~/"))return M.join(process.env.HOME||"~",Q.slice(2));return M.resolve(Q)}export function sanitizeTitleForFilename(G,Q="untitled"){return String(G||Q).replace(/[\\/:*?"<>|\x00-\x1f]+/g,"-").replace(/\s+/g," ").trim().slice(0,60)||Q}export function ensureDir(G){J.mkdirSync(G,{recursive:!0})}export function normalizeBooleanFlag(G,Q=!1){if(typeof G==="boolean")return G;if(G===null||G===void 0||G==="")return Q;const V=String(G).trim().toLowerCase();return V==="true"||V==="1"||V==="yes"||V==="on"}export function unwrapEvaluateResult(G){if(G&&typeof G==="object"&&"session"in G&&"data"in G)return G.data;return G}export function requirePositiveInt(G,Q){const V=Number(G);if(!Number.isInteger(V)||V<1)throw new N(`${Q} must be a positive integer`);return V}export function requireNonNegativeInt(G,Q){const V=Number(G);if(!Number.isInteger(V)||V<0)throw new N(`${Q} must be a non-negative integer`);return V}export function clampSlider(G,Q,V){if(G===void 0||G===null||G==="")return V;const X=Number(G);if(!Number.isFinite(X)||X<0||X>1)throw new N(`${Q} must be a number between 0 and 1`);return X}const C="JSON.stringify({ token: btoa(JSON.stringify({ timestamp: Date.now() })) })",h="await window.Clerk.session.getToken()";function q(G,Q={}){const V=Object.entries(Q).map(([X,Z])=>`${JSON.stringify(X)}: ${JSON.stringify(Z)}`).join(", ");return`{
+        'Authorization': 'Bearer ' + ${h},
+        'browser-token': ${C},
+        'device-id': ${JSON.stringify(G)},
+        ${V}${V?",":""}
+    }`}export function parseSunoBillingInfo(G){const Q=(G?.credit_packs||[]).reduce(($,z)=>$+(z?.amount??z?.credits??0),0),V=Math.max(0,(G?.monthly_limit??0)-(G?.monthly_usage??0)),X=typeof G?.total_credits_left==="number"?G.total_credits_left:(G?.credits??0)+Q+V,Z=Array.isArray(G?.plans)?G.plans:[],W=typeof G?.subscription_type==="string"&&G.subscription_type?G.subscription_type:null,Y=W?Z.find(($)=>$?.plan_key===W):Z.find(($)=>$?.plan_key==="free");return{planId:Y?.id||G?.plan?.id||null,planKey:Y?.plan_key||G?.plan?.plan_key||(W??"free"),totalCreditsAvailable:X,breakdown:{pack:G?.credits??0,purchasedPacks:Q,monthlyRemaining:V,monthlyLimit:G?.monthly_limit??0,monthlyUsed:G?.monthly_usage??0}}}export async function ensureSunoSession(G){await G.goto(`${SUNO_URL}/me`,{settleMs:2000});await G.evaluate(`(() => {
+        const btn = Array.from(document.querySelectorAll('button')).find(b => /^reject all$|^accept all$|^confirm/i.test((b.innerText || '').trim()));
+        if (btn) btn.click();
+    })()`);for(let X=0;X<20;X+=1){if(unwrapEvaluateResult(await G.evaluate("!!(window.Clerk && window.Clerk.session)")))break;await G.wait(0.5)}const Q=await getSunoDeviceId(G),V=unwrapEvaluateResult(await G.evaluate(`(async () => {
+        try {
+            if (!window.Clerk?.session) return { ok: false, auth: true, error: 'Clerk session unavailable' };
+            const res = await fetch('${STUDIO_API}/api/billing/info/', { headers: ${q(Q)} });
+            if (!res.ok) return { ok: false, status: res.status, body: (await res.text()).slice(0, 300) };
+            let data = null;
+            try {
+                data = await res.json();
+            } catch (e) {
+                return { ok: false, error: 'Malformed billing/info JSON: ' + String(e).slice(0, 200) };
+            }
+            const parse = ${parseSunoBillingInfo.toString()};
+            return { ok: true, ...parse(data) };
+        } catch (e) {
+            return { ok: false, error: String(e).slice(0, 200) };
+        }
+    })()`));if(!V||!V.ok){const X=V?.status||V?.error||"unknown";if(V?.auth||V?.status===401||V?.status===403)throw new k(SUNO_DOMAIN,`Suno session check failed (${X}). Open https://suno.com in Chrome and sign in, then retry.`);throw new L(`Suno session check failed (${X}).`)}return{...V,deviceId:Q}}export async function checkSunoCaptcha(G,Q){return unwrapEvaluateResult(await G.evaluate(`(async () => {
+        const res = await fetch('${STUDIO_API}/api/c/check', {
+            method: 'POST',
+            headers: ${q(Q,{"Content-Type":"application/json"})},
+            body: JSON.stringify({ ctype: 'generation' }),
+        });
+        if (!res.ok) return { ok: false, status: res.status };
+        return { ok: true, ...(await res.json()) };
+    })()`))}export async function getSunoDeviceId(G){const Q=unwrapEvaluateResult(await G.evaluate(`(() => {
+        try {
+            const fromCookie = document.cookie.split(';').map(s => s.trim()).find(s => s.startsWith('suno_device_id='));
+            if (fromCookie) return decodeURIComponent(fromCookie.split('=')[1]);
+            for (const key of ['device_id', 'deviceId', 'suno_device_id']) {
+                const v = localStorage.getItem(key);
+                if (v) return v.replace(/^"|"$/g, '');
+            }
+        } catch {}
+        return null;
+    })()`));if(Q&&typeof Q==="string")return Q;return unwrapEvaluateResult(await G.evaluate("crypto.randomUUID()"))}export async function submitSunoGeneration(G,Q){const V=Q.mode==="custom",X={token:null,generation_type:"TEXT",title:Q.title||"",tags:V?Q.tags||"":"",negative_tags:V?Q.negativeTags||"":"",mv:Q.model||DEFAULT_SUNO_MODEL,prompt:V?Q.lyrics||"":Q.description||"",make_instrumental:!!Q.makeInstrumental,user_uploaded_images_b64:null,metadata:{web_client_pathname:"/create",is_max_mode:!1,is_mumble:!1,create_mode:V?"custom":"simple",user_tier:Q.userTier,create_session_token:Q.createSessionToken,disable_volume_normalization:!1,control_sliders:{weirdness_constraint:Q.weirdness,style_weight:Q.styleWeight}},override_fields:[],cover_clip_id:null,cover_start_s:null,cover_end_s:null,persona_id:null,artist_clip_id:null,artist_start_s:null,artist_end_s:null,continue_clip_id:null,continued_aligned_prompt:null,continue_at:null,transaction_uuid:Q.transactionUuid,token_provider:null},Z=JSON.stringify(X),W=Q.deviceId,Y=unwrapEvaluateResult(await G.evaluate(`(async () => {
+        const res = await fetch('${STUDIO_API}/api/generate/v2-web/', {
+            method: 'POST',
+            headers: ${q(W,{"Content-Type":"application/json"})},
+            body: ${JSON.stringify(Z)},
+        });
+        const text = await res.text();
+        let parsed = null;
+        try { parsed = JSON.parse(text); } catch {}
+        return { status: res.status, ok: res.ok, body: parsed, raw: parsed ? null : text.slice(0, 600) };
+    })()`));if(!Y||!Y.ok){const z=Y?.status||"unknown",j=Y?.body?.detail||Y?.raw||JSON.stringify(Y?.body||{}).slice(0,500);if(z===401||z===403)throw new k(SUNO_DOMAIN,`Suno API rejected request (HTTP ${z}). Re-login on suno.com.`);if(z===402)throw new L(`Suno API: insufficient credits (HTTP 402). ${j}`);throw new L(`Suno generate failed (HTTP ${z}): ${j}`)}if(!Y.body||typeof Y.body!=="object"||Array.isArray(Y.body))throw new L("Suno generate returned malformed JSON payload.");if(!(Y.body?.clips||[]).length)throw new x("suno generate",`Submission accepted but Suno returned no clip ids. Raw: ${JSON.stringify(Y.body).slice(0,300)}`);return Y.body}export async function pollSunoClips(G,Q,V,X,Z=5,W=null){const Y=Date.now()+V*1000,$=new Set(Q),z=JSON.stringify(Q);while(Date.now()<Y){const j=unwrapEvaluateResult(await G.evaluate(`(async () => {
+            const res = await fetch('${STUDIO_API}/api/feed/v3', {
+                method: 'POST',
+                headers: ${q(X,{"Content-Type":"application/json"})},
+                body: JSON.stringify({ clip_ids: ${z} }),
+            });
+            const body = await res.json().catch(() => null);
+            return { status: res.status, body };
+        })()`));if(!j){await G.wait(Z);continue}if(j.status===401||j.status===403)throw new k(SUNO_DOMAIN,`Suno feed API rejected (HTTP ${j.status}). Re-login.`);if(j.status<200||j.status>=300)throw new L(`Suno feed API failed while polling clips (HTTP ${j.status||"?"})`);if(!j.body||typeof j.body!=="object"||Array.isArray(j.body))throw new L("Suno feed API returned malformed JSON while polling clips");const H=j.body.clips||[];if(!Array.isArray(H))throw new L("Suno feed API returned malformed clips payload");const B=H.filter((K)=>$.has(K.id)),F=B.filter((K)=>K.status==="complete"||K.status==="error");if(typeof W==="function")W({total:Q.length,done:F.length,statuses:B.map((K)=>`${K.id.slice(0,8)}:${K.status}`)});if(F.length===Q.length)return B;await G.wait(Z)}throw new b(`Suno generation did not complete within ${V}s. Try --timeout <higher>.`)}function T(G,Q){return(Array.isArray(G.media_urls)?G.media_urls:[]).find((Z)=>(Z.content_type||"").toLowerCase().includes(Q))?.url||null}async function _(G,Q,V){return await G.evaluate(`(async () => {
+        try {
+            const res = await fetch('${STUDIO_API}/api/download/clip/${Q.id}?format=mp3', { headers: ${q(V)} });
+            if (!res.ok) return null;
+            const data = await res.json();
+            return data?.download_url || null;
+        } catch { return null; }
+    })()`)||Q.audio_url||`${SUNO_CDN}/${Q.id}.mp3`}async function U(G,Q,V,X=120,Z=3){await G.evaluate(`(async () => {
+        try {
+            await fetch('${STUDIO_API}/api/billing/clips/${Q}/download/', {
+                method: 'POST',
+                headers: ${q(V,{"Content-Type":"application/json"})},
+                body: JSON.stringify({}),
+            });
+        } catch {}
+        try {
+            await fetch('${STUDIO_API}/api/gen/${Q}/convert_wav/', {
+                method: 'POST',
+                headers: ${q(V,{"Content-Type":"application/json"})},
+            });
+        } catch {}
+    })()`);const W=Date.now()+X*1000;while(Date.now()<W){const Y=unwrapEvaluateResult(await G.evaluate(`(async () => {
+            const res = await fetch('${STUDIO_API}/api/gen/${Q}/wav_file/', { headers: ${q(V)} });
+            if (!res.ok) return { ok: false, status: res.status };
+            const data = await res.json().catch(() => null);
+            return { ok: true, url: data?.wav_file_url || null };
+        })()`));if(Y?.ok&&Y.url)return Y.url;await G.wait(Z)}return null}async function R(G,Q){return unwrapEvaluateResult(await G.evaluate(`(async () => {
+        try {
+            const res = await fetch(${JSON.stringify(Q)});
+            if (!res.ok) return { ok: false, status: res.status };
+            const blob = await res.blob();
+            const dataUrl = await new Promise((resolve, reject) => {
+                const reader = new FileReader();
+                reader.onloadend = () => resolve(String(reader.result || ''));
+                reader.onerror = () => reject(new Error('reader failed'));
+                reader.readAsDataURL(blob);
+            });
+            return { ok: true, mime: blob.type || '', dataUrl };
+        } catch (e) {
+            return { ok: false, error: String(e).slice(0, 200) };
+        }
+    })()`))}async function w(G,Q,V){const X=await R(G,Q);if(!X?.ok)return{ok:!1,reason:X?.status?`HTTP ${X.status}`:X?.error||"unknown"};const Z=String(X.dataUrl||"").replace(/^data:[^;]+;base64,/,"");if(!Z)return{ok:!1,reason:"empty response body"};J.writeFileSync(V,Buffer.from(Z,"base64"));if(!J.statSync(V).size)return{ok:!1,reason:"empty file written"};return{ok:!0}}export async function downloadSunoClip(G,Q,V,X,Z){ensureDir(V);const W=`${sanitizeTitleForFilename(Q.title||Q.id)}_${Q.id.slice(0,8)}`,Y=[];if(X.includes("metadata")){const $=M.join(V,`${W}.json`);J.writeFileSync($,JSON.stringify(Q,null,2),"utf8");Y.push({format:"metadata",file:$,ok:!0})}for(const $ of X){if($==="metadata")continue;let z=null,j="";try{if($==="mp3"){j=".mp3";z=await _(G,Q,Z)}else if($==="m4a"){j=".m4a";z=T(Q,"m4a")}else if($==="video"){j=".mp4";z=Q.video_url||null}else if($==="cover"){j=".jpeg";z=Q.image_large_url||Q.image_url||null}else if($==="wav"){j=".wav";z=await U(G,Q.id,Z)}}catch(F){Y.push({format:$,file:null,ok:!1,reason:`prep failed: ${String(F).slice(0,100)}`});continue}if(!z){Y.push({format:$,file:null,ok:!1,reason:"not available"});continue}const H=M.join(V,`${W}${j}`),B=await w(G,z,H);Y.push({format:$,file:H,ok:B.ok,reason:B.ok?null:B.reason})}return{slug:W,written:Y}}

package/clis/taobao/add-cart.js

@@ -0,0 +1,93 @@
+import{AuthRequiredError as m}from"@jackwener/opencli/errors";import{cli as d,Strategy as p}from"@jackwener/opencli/registry";import{normalizeNumericId as f}from"../_shared/common.js";d({site:"taobao",name:"add-cart",access:"write",description:"淘宝加入购物车",domain:"item.taobao.com",strategy:p.COOKIE,args:[{name:"id",positional:!0,required:!0,help:"商品 ID"},{name:"spec",help:'规格关键词（如 "180度" "红色 XL"），多个规格用空格分隔，模糊匹配'},{name:"dry-run",type:"bool",default:!1,help:"仅预览，不实际加入购物车"}],columns:["status","title","price","selected_spec","item_id"],navigateBefore:!1,func:async(e,t)=>{const i=f(t.id,"id","827563850178"),c=t.spec?String(t.spec).split(/\s+/).filter(Boolean):[],l=!!t["dry-run"];await e.goto("https://www.taobao.com");await e.wait(2);await e.evaluate(`location.href = ${JSON.stringify(`https://item.taobao.com/item.htm?id=${i}`)}`);await e.wait(6);const s=await e.evaluate(`
+      (() => {
+        const normalize = v => (v || '').replace(/\\s+/g, ' ').trim();
+        const titleEl = document.querySelector('[class*="mainTitle--"]');
+        const title = titleEl ? normalize(titleEl.textContent) : document.title.split('-')[0].trim();
+        const text = document.body?.innerText || '';
+        const priceMatch = text.match(/[￥¥]\\s*(\\d+(?:\\.\\d{1,2})?)/);
+        const price = priceMatch ? '¥' + priceMatch[1] : '';
+        return { title: title.slice(0, 80), price };
+      })()
+    `);if(l)return[{status:"dry-run",title:s?.title||"",price:s?.price||"",selected_spec:c.join(" ")||"(未选择)",item_id:i}];const a=JSON.stringify(c),n=await e.evaluate(`
+      (() => {
+        const normalize = v => (v || '').replace(/\\s+/g, ' ').trim();
+        const keywords = ${a};
+        const items = document.querySelectorAll('[class*="valueItem--"]');
+        const selected = [];
+
+        if (keywords.length === 0 && items.length > 0) {
+          const groups = new Map();
+          for (const item of items) {
+            const group = item.closest('[class*="skuItem--"], [class*="prop--"]') || item.parentElement;
+            const groupKey = group?.className?.substring(0, 30) || 'default';
+            if (!groups.has(groupKey)) groups.set(groupKey, []);
+            groups.get(groupKey).push(item);
+          }
+          for (const [, groupItems] of groups) {
+            const hasSelected = groupItems.some(el => el.className.includes('selected') || el.className.includes('active'));
+            if (hasSelected) continue;
+            for (const item of groupItems) {
+              if (!item.className.includes('disabled') && !item.className.includes('gray')) {
+                item.click();
+                selected.push(normalize(item.textContent).substring(0, 40));
+                break;
+              }
+            }
+          }
+        } else {
+          const groups = new Map();
+          for (const item of items) {
+            const group = item.closest('[class*="skuItem--"], [class*="prop--"]') || item.parentElement;
+            const groupKey = group?.className?.substring(0, 30) || 'default';
+            if (!groups.has(groupKey)) groups.set(groupKey, []);
+            groups.get(groupKey).push(item);
+          }
+
+          for (const [, groupItems] of groups) {
+            let best = null;
+            let bestScore = 0;
+            for (const item of groupItems) {
+              if (item.className.includes('disabled')) continue;
+              const t = normalize(item.textContent);
+              const score = keywords.filter(kw => t.includes(kw)).length;
+              if (score > bestScore) { bestScore = score; best = item; }
+            }
+            if (best && bestScore > 0) {
+              best.click();
+              selected.push(normalize(best.textContent).substring(0, 40));
+            }
+          }
+        }
+        return selected;
+      })()
+    `);await e.wait(1);await e.evaluate(`
+      (() => {
+        const all = document.querySelectorAll('button, [role="button"], a, div, span');
+        for (const el of all) {
+          const t = (el.textContent || '').trim();
+          if ((t === '加入购物车' || t === '加入 购物车') && el.children.length < 5) {
+            el.click();
+            return 'clicked';
+          }
+        }
+        return 'btn_not_found';
+      })()
+    `);const o=await e.evaluate(`
+      (async () => {
+        for (let i = 0; i < 10; i++) {
+          await new Promise(r => setTimeout(r, 500));
+          const text = document.body?.innerText || '';
+          if (text.includes('已加入购物车') || text.includes('商品已成功') || text.includes('去购物车结算') || text.includes('去购物车')) {
+            return 'success';
+          }
+          if (text.includes('请选择') || text.includes('请先选择')) {
+            return 'need_spec';
+          }
+          if (text.includes('请登录')) {
+            return 'login_required';
+          }
+        }
+        if (location.href.includes('cart')) return 'success';
+        return 'unknown';
+      })()
+    `);if(o==="login_required")throw new m("taobao add-cart requires a logged-in Taobao session");let r="? 未确认";if(o==="success")r="✓ 已加入购物车";else if(o==="need_spec")r="✗ 需要选择更多规格";const u=Array.isArray(n)?n.join(" | "):"";return[{status:r,title:s?.title||"",price:s?.price||"",selected_spec:u||"(未选择)",item_id:i}]}});

package/clis/taobao/auth.js

@@ -0,0 +1,8 @@
+import{AuthRequiredError as t,CommandExecutionError as k}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as d}from"../_shared/site-auth.js";async function c(o){return(await o.getCookies({url:"https://www.taobao.com"})).some((i)=>i.name==="tracknick"&&i.value)}async function s(o){if(!await c(o))throw new t("taobao.com","Taobao tracknick cookie missing — anonymous");await o.goto("https://i.taobao.com/my_itaobao");await o.wait(2);const a=await o.evaluate("location.href");if(/login\.taobao\.com\/member\/login/.test(String(a||"")))throw new t("taobao.com",`Taobao my_itaobao redirected to login: ${a}`);const e=(await o.getCookies({url:"https://www.taobao.com"})).find((u)=>u.name==="tracknick")?.value||"";if(!e)throw new t("taobao.com","Taobao tracknick cookie absent after navigation");const n=await o.evaluate(`
+    (() => {
+      const nick = (document.querySelector('.user-nick, .site-nav-user, .user-name')?.innerText || '').trim();
+      const html = document.body?.innerHTML || '';
+      const userIdMatch = html.match(/userId["'\\s:=]+(\\d+)/i);
+      return { nickname: nick, user_id: userIdMatch?.[1] || '' };
+    })()
+  `);let r="";try{r=JSON.parse('"'+e.replace(/\\/g,"\\\\")+'"')}catch{r=e}const m=n.nickname||r;if(!n.user_id)throw new k("Taobao my_itaobao rendered but no user_id extractable — stale cookie2 or layout drift");return{user_id:String(n.user_id),nickname:String(m)}}d({site:"taobao",domain:"taobao.com",loginUrl:"https://login.taobao.com/member/login.jhtml",columns:["user_id","nickname"],quickCheck:c,verify:s,poll:async(o)=>{if(!await c(o))throw new t("taobao.com","Waiting for Taobao tracknick cookie");return s(o)}});

package/clis/taobao/cart.js

@@ -0,0 +1,68 @@
+import{AuthRequiredError as s}from"@jackwener/opencli/errors";import{cli as r,Strategy as n}from"@jackwener/opencli/registry";import{clampInt as o}from"../_shared/common.js";r({site:"taobao",name:"cart",access:"read",description:"查看淘宝购物车",domain:"cart.taobao.com",strategy:n.COOKIE,args:[{name:"limit",type:"int",default:20,help:"返回数量 (max 50)"}],columns:["index","title","price","spec","shop"],navigateBefore:!1,func:async(t,i)=>{const l=o(i.limit,20,1,50);await t.goto("https://www.taobao.com");await t.wait(2);await t.evaluate("location.href = 'https://cart.taobao.com/cart.htm'");await t.wait(6);await t.autoScroll({times:3,delayMs:1500});const e=await t.evaluate(`
+      (async () => {
+        const text = document.body?.innerText || '';
+        if (text.length < 500 || text.includes('请登录')) {
+          return { error: 'auth-required' };
+        }
+
+        const sections = text.split(/移入收藏/);
+        const results = [];
+
+        for (const section of sections) {
+          const lines = section.split('\\n').map(l => l.trim()).filter(Boolean);
+          if (lines.length < 3) continue;
+
+          let title = '';
+          let titleIdx = -1;
+          for (let i = 0; i < lines.length; i++) {
+            const l = lines[i];
+            if (l.length > 15 && l.length < 200 && !l.match(/^(删除|全选|全部商品|合计|结算|找同款|退货|￥|¥|\\d+$|颜色|尺码|规格|套餐|主板|运行)/)) {
+              if (l.length > title.length) {
+                title = l;
+                titleIdx = i;
+              }
+            }
+          }
+          if (!title) continue;
+
+          let price = '';
+          for (let i = 0; i < lines.length; i++) {
+            if (lines[i] === '￥' || lines[i] === '¥') {
+              let p = '';
+              for (let j = i + 1; j < Math.min(i + 4, lines.length); j++) {
+                if (lines[j].match(/^[\\d,.]+$/)) p += lines[j];
+                else if (lines[j] === '.') p += '.';
+                else break;
+              }
+              if (p) { price = '￥' + p; break; }
+            }
+          }
+
+          let spec = '';
+          for (const l of lines) {
+            if (l.match(/^(颜色分类|尺码|规格|套餐|主板|运行)[：:]/)) {
+              spec = l.slice(0, 40);
+              break;
+            }
+          }
+
+          let shop = '';
+          if (titleIdx > 0) {
+            const prev = lines[titleIdx - 1];
+            if (prev && prev.length > 2 && prev.length < 30 && !prev.match(/^(删除|\\d|￥|¥|券|退|满|超)/)) {
+              shop = prev;
+            }
+          }
+
+          results.push({
+            index: results.length + 1,
+            title: title.slice(0, 80),
+            price,
+            spec,
+            shop,
+          });
+          if (results.length >= ${l}) break;
+        }
+        return { results };
+      })()
+    `);if(e?.error==="auth-required")throw new s("taobao cart requires a logged-in Taobao session");return Array.isArray(e?.results)?e.results:[]}});