publishport-opencli 1.0.20 → 1.0.22

package/clis/_shared/self-hosted-sites.js

@@ -1,2 +1,2 @@
-import*as D from"node:fs";import*as B from"node:os";import*as T from"node:path";import{ArgumentError as K,CommandExecutionError as J}from"@jackwener/opencli/errors";import{Strategy as M}from"@jackwener/opencli/registry";const _=1,A=1e4;function k(q){return T.join(B.homedir(),".ppcli","sites",q,"connections.json")}function C(q){return T.join(B.homedir(),".opencli","sites",q,"connections.json")}function O(q){const Q=String(q??"").trim();if(!Q)throw new K("站点名称不能为空");if(Q.length>64)throw new K("站点名称不能超过 64 个字符");if(/[\u0000-\u001f\u007f]/.test(Q))throw new K("站点名称不能包含控制字符");return Q}export function normalizeSiteUrl(q,{originOnly:Q=!1,label:H="站点网址"}={}){const X=String(q??"").trim();if(!X)throw new K(`${H}不能为空`);let Z;try{Z=new URL(X.includes("://")?X:`https://${X}`)}catch{throw new K(`${H}不是合法网址: ${X}`)}if(Z.protocol!=="http:"&&Z.protocol!=="https:")throw new K(`${H}必须是 http(s) 网址: ${X}`);if(Z.username||Z.password||Z.search||Z.hash)throw new K(`${H}只应包含站点根地址，不要带账号、查询参数或锚点`);if(Q)return Z.origin;const $=Z.pathname.replace(/\/+$/,"");return`${Z.origin}${$==="/"?"":$}`}function b(){return{version:_,default:"",sites:[]}}function I(q,Q){if(!Q||Q.version!==_||!Array.isArray(Q.sites))throw new J(`${q} 站点连接文件格式不受支持`,"请删除损坏的 connections.json 后重新添加站点。");const H=Q.sites.filter(($)=>$&&typeof $.name==="string"&&typeof $.url==="string").map(($)=>({name:$.name,url:$.url})),X=H[0]?.name??"",Z=typeof Q.default==="string"?Q.default:"";return{version:_,default:H.some(($)=>$.name===Z)?Z:X,sites:H}}export function loadSiteConnections(q){const Q=k(q);try{return I(q,JSON.parse(D.readFileSync(Q,"utf8")))}catch(H){if(H?.code==="ENOENT"){const X=C(q);try{const Z=I(q,JSON.parse(D.readFileSync(X,"utf8")));V(q,Z);return Z}catch(Z){if(Z?.code==="ENOENT")return b();if(Z instanceof J)throw Z;throw new J(`${q} 旧版站点连接读取失败: ${Z?.message??Z}`)}}if(H instanceof J)throw H;throw new J(`${q} 站点连接读取失败: ${H?.message??H}`)}}function V(q,Q){const H=k(q),X=T.dirname(H),Z=`${H}.${process.pid}.tmp`;try{D.mkdirSync(X,{recursive:!0,mode:448});D.writeFileSync(Z,`${JSON.stringify(Q,null,2)}
-`,{mode:384});D.renameSync(Z,H);try{D.chmodSync(H,384)}catch{}}catch($){try{D.rmSync(Z,{force:!0})}catch{}throw new J(`${q} 站点连接保存失败: ${$?.message??$}`)}}function L(q,Q){const H=String(Q??"").trim();return q.sites.find((X)=>X.name===H)??q.sites.find((X)=>X.name.toLocaleLowerCase()===H.toLocaleLowerCase())}export function addSiteConnection(q,Q,H,X={}){const Z=O(Q),$=normalizeSiteUrl(H,X),G=loadSiteConnections(q),W=L(G,Z);if(W){if(W.url===$)return{status:"unchanged",name:W.name,url:$,default:G.default===W.name};throw new K(`站点名称“${W.name}”已指向 ${W.url}`,"请换一个名称，或先删除原连接。")}const F=G.sites.find((j)=>j.url===$);if(F)throw new K(`${$} 已保存为“${F.name}”`);G.sites.push({name:Z,url:$});if(!G.default)G.default=Z;V(q,G);return{status:"added",name:Z,url:$,default:G.default===Z}}export function removeSiteConnection(q,Q){const H=loadSiteConnections(q),X=L(H,Q);if(!X)throw new K(`未找到站点连接: ${String(Q??"").trim()}`);H.sites=H.sites.filter((Z)=>Z.name!==X.name);if(H.default===X.name)H.default=H.sites[0]?.name??"";V(q,H);return{status:"removed",name:X.name,url:X.url}}export function useSiteConnection(q,Q){const H=loadSiteConnections(q),X=L(H,Q);if(!X)throw new K(`未找到站点连接: ${String(Q??"").trim()}`);H.default=X.name;V(q,H);return{status:"default",name:X.name,url:X.url,default:!0}}export function listSiteConnectionRows(q){const Q=loadSiteConnections(q);return Q.sites.map((H)=>({...H,default:H.name===Q.default}))}function N(q,Q){const H=Q.replace(/\/+$/,"");if(q==="mastodon")return`${H}/api/v2/instance`;if(q==="wordpress")return`${H}/wp-json/`;if(q==="ghost")return`${H}/ghost/api/admin/site/`;throw new K(`不支持校验站点类型: ${q}`)}async function P(q){const Q=new AbortController,H=setTimeout(()=>Q.abort(),A);try{return await fetch(q,{method:"GET",headers:{accept:"application/json"},redirect:"follow",signal:Q.signal})}finally{clearTimeout(H)}}async function x(q){const Q=q.headers?.get?.("content-type")??"";if(!/json/i.test(Q))return null;try{return await q.json()}catch{return null}}function R(q){if(!q||typeof q!=="object"||Array.isArray(q))return!1;const Q=q.domain??q.uri;return typeof Q==="string"&&Q.length>0&&(typeof q.version==="string"||q.title&&typeof q.title==="string")}function U(q){if(!q||typeof q!=="object"||Array.isArray(q))return!1;if((Array.isArray(q.namespaces)?q.namespaces:[]).some((X)=>X==="wp/v2"||String(X).startsWith("wp/v2/")))return!0;const H=q.routes;return!!H&&typeof H==="object"&&Object.keys(H).some((X)=>X.startsWith("/wp/v2/"))}function E(q,Q){if(!q||typeof q!=="object"||Array.isArray(q))return!1;if(q.site&&typeof q.site==="object")return!0;if(Q!==401&&Q!==403)return!1;return(Array.isArray(q.errors)?q.errors:[]).some((X)=>{if(!X||typeof X!=="object")return!1;const Z=String(X.type??""),$=String(X.context??"");return/GhostError|NoPermissionError|UnauthorizedError|NotFoundError/i.test(Z)||/ghost admin api/i.test($)})}export async function verifySiteKind(q,Q,{originOnly:H=!1}={}){const X=normalizeSiteUrl(Q,{originOnly:H}),Z=N(q,X);let $;try{$=await P(Z)}catch(F){const j=F?.name==="AbortError"?"连接超时":F?.message??String(F);throw new J(`连接不到 ${q} 站点 ${X}: ${j}`,"请检查站点地址、网络和 HTTPS 证书后重试。")}const G=await x($),W=q==="mastodon"?$.ok&&R(G):q==="wordpress"?$.ok&&U(G):E(G,$.status);if(!W&&q==="mastodon"&&$.status===404)try{const F=await P(`${X.replace(/\/+$/,"")}/api/v1/instance`),j=await x(F);if(F.ok&&R(j))return{platform:q,url:X,verified:!0}}catch{}if(!W){const F=q==="mastodon"?"Mastodon":q==="wordpress"?"WordPress":"Ghost";throw new K(`${X} 不是可识别的 ${F} 站点`,`请填写 ${F} 站点根地址，当前检测地址: ${Z}`)}return{platform:q,url:X,verified:!0}}export function resolveSiteConnection(q,Q={},{selector:H="site",legacySelectors:X=[],envUrl:Z,originOnly:$=!1}={}){const G=X.map((Y)=>Q[Y]).find((Y)=>Y!=null&&String(Y).trim());if(G!=null)return{name:"",url:normalizeSiteUrl(G,{originOnly:$}),saved:!1};const W=Q[H];if(W!=null&&String(W).trim()){const Y=String(W).trim(),h=loadSiteConnections(q),z=L(h,Y);if(z)return{...z,saved:!0};if(Y.includes("://")||Y.includes(".")||/^localhost(?::\d+)?(?:\/|$)/i.test(Y)||/^\[[0-9a-f:]+\](?::\d+)?(?:\/|$)/i.test(Y))return{name:"",url:normalizeSiteUrl(Y,{originOnly:$}),saved:!1};throw new K(`未找到 ${q} 站点连接“${Y}”`,`运行 ppcli ${q} sites 查看已保存站点。`)}const F=loadSiteConnections(q),j=L(F,F.default)??F.sites[0];if(j)return{...j,saved:!0};if(Z&&String(Z).trim())return{name:"",url:normalizeSiteUrl(Z,{originOnly:$}),saved:!1};throw new K(`${q} 尚未添加站点`,`先运行 ppcli ${q} add-site --name <名称> --url <网址>，或在本次命令传 --${H} <网址>。`)}export function connectionCommandDefinitions(q,{originOnly:Q=!1}={}){return[{site:q,name:"sites",access:"read",description:`列出已保存的 ${q} 自部署站点连接。`,strategy:M.LOCAL,browser:!1,args:[],columns:["name","url","default"],func:async()=>listSiteConnectionRows(q)},{site:q,name:"add-site",access:"write",description:`校验并保存一个命名的 ${q} 自部署站点连接（只保存名称和网址）。`,strategy:M.LOCAL,browser:!1,args:[{name:"name",required:!0,help:"连接名称，例如“公司博客”"},{name:"url",required:!0,help:"站点根网址，例如 https://blog.example.com"}],columns:["status","name","url","default"],func:async(H)=>{await verifySiteKind(q,H.url,{originOnly:Q});return[addSiteConnection(q,H.name,H.url,{originOnly:Q})]}},{site:q,name:"remove-site",access:"write",description:`删除一个 ${q} 站点连接；不会清除浏览器里的站点 cookie。`,strategy:M.LOCAL,browser:!1,args:[{name:"site",required:!0,help:"要删除的连接名称"}],columns:["status","name","url"],func:async(H)=>[removeSiteConnection(q,H.site)]},{site:q,name:"use-site",access:"write",description:`设置 ${q} 默认站点；之后省略 --site 时使用它。`,strategy:M.LOCAL,browser:!1,args:[{name:"site",required:!0,help:"要设为默认的连接名称"}],columns:["status","name","url","default"],func:async(H)=>[useSiteConnection(q,H.site)]}]}
+import*as m from"node:fs";import*as b from"node:os";import*as p from"node:path";import{ArgumentError as a,CommandExecutionError as l}from"@jackwener/opencli/errors";import{Strategy as y}from"@jackwener/opencli/registry";const g=1,k=1e4;function A(e){return p.join(b.homedir(),".ppcli","sites",e,"connections.json")}function N(e){return p.join(b.homedir(),".opencli","sites",e,"connections.json")}function O(e){const n=String(e??"").trim();if(!n)throw new a("站点名称不能为空");if(n.length>64)throw new a("站点名称不能超过 64 个字符");if(/[\u0000-\u001f\u007f]/.test(n))throw new a("站点名称不能包含控制字符");return n}export function normalizeSiteUrl(e,{originOnly:n=!1,label:t="站点网址"}={}){const r=String(e??"").trim();if(!r)throw new a(`${t}不能为空`);let s;try{s=new URL(r.includes("://")?r:`https://${r}`)}catch{throw new a(`${t}不是合法网址: ${r}`)}if(s.protocol!=="http:"&&s.protocol!=="https:")throw new a(`${t}必须是 http(s) 网址: ${r}`);if(s.username||s.password||s.search||s.hash)throw new a(`${t}只应包含站点根地址，不要带账号、查询参数或锚点`);if(n)return s.origin;const o=s.pathname.replace(/\/+$/,"");return`${s.origin}${o==="/"?"":o}`}function T(){return{version:g,default:"",sites:[]}}function E(e,n){if(!n||n.version!==g||!Array.isArray(n.sites))throw new l(`${e} 站点连接文件格式不受支持`,"请删除损坏的 connections.json 后重新添加站点。");const t=n.sites.filter((o)=>o&&typeof o.name==="string"&&typeof o.url==="string").map((o)=>({name:o.name,url:o.url})),r=t[0]?.name??"",s=typeof n.default==="string"?n.default:"";return{version:g,default:t.some((o)=>o.name===s)?s:r,sites:t}}export function loadSiteConnections(e){const n=A(e);try{return E(e,JSON.parse(m.readFileSync(n,"utf8")))}catch(t){if(t?.code==="ENOENT"){const r=N(e);try{const s=E(e,JSON.parse(m.readFileSync(r,"utf8")));w(e,s);return s}catch(s){if(s?.code==="ENOENT")return T();if(s instanceof l)throw s;throw new l(`${e} 旧版站点连接读取失败: ${s?.message??s}`)}}if(t instanceof l)throw t;throw new l(`${e} 站点连接读取失败: ${t?.message??t}`)}}function w(e,n){const t=A(e),r=p.dirname(t),s=`${t}.${process.pid}.tmp`;try{m.mkdirSync(r,{recursive:!0,mode:448});m.writeFileSync(s,`${JSON.stringify(n,null,2)}
+`,{mode:384});m.renameSync(s,t);try{m.chmodSync(t,384)}catch{}}catch(o){try{m.rmSync(s,{force:!0})}catch{}throw new l(`${e} 站点连接保存失败: ${o?.message??o}`)}}function h(e,n){const t=String(n??"").trim();return e.sites.find((r)=>r.name===t)??e.sites.find((r)=>r.name.toLocaleLowerCase()===t.toLocaleLowerCase())}export function addSiteConnection(e,n,t,r={}){const s=O(n),o=normalizeSiteUrl(t,r),c=loadSiteConnections(e),u=h(c,s);if(u){if(u.url===o)return{status:"unchanged",name:u.name,url:o,default:c.default===u.name};throw new a(`站点名称“${u.name}”已指向 ${u.url}`,"请换一个名称，或先删除原连接。")}const i=c.sites.find((d)=>d.url===o);if(i)throw new a(`${o} 已保存为“${i.name}”`);c.sites.push({name:s,url:o});if(!c.default)c.default=s;w(e,c);return{status:"added",name:s,url:o,default:c.default===s}}export function removeSiteConnection(e,n){const t=loadSiteConnections(e),r=h(t,n);if(!r)throw new a(`未找到站点连接: ${String(n??"").trim()}`);t.sites=t.sites.filter((s)=>s.name!==r.name);if(t.default===r.name)t.default=t.sites[0]?.name??"";w(e,t);return{status:"removed",name:r.name,url:r.url}}export function useSiteConnection(e,n){const t=loadSiteConnections(e),r=h(t,n);if(!r)throw new a(`未找到站点连接: ${String(n??"").trim()}`);t.default=r.name;w(e,t);return{status:"default",name:r.name,url:r.url,default:!0}}export function listSiteConnectionRows(e){const n=loadSiteConnections(e);return n.sites.map((t)=>({...t,default:t.name===n.default}))}function P(e,n){const t=n.replace(/\/+$/,"");if(e==="mastodon")return`${t}/api/v2/instance`;if(e==="wordpress")return`${t}/wp-json/`;if(e==="ghost")return`${t}/ghost/api/admin/site/`;throw new a(`不支持校验站点类型: ${e}`)}async function j(e){const n=new AbortController,t=setTimeout(()=>n.abort(),k);try{return await fetch(e,{method:"GET",headers:{accept:"application/json"},redirect:"follow",signal:n.signal})}finally{clearTimeout(t)}}async function C(e){const n=e.headers?.get?.("content-type")??"";if(!/json/i.test(n))return null;try{return await e.json()}catch{return null}}function L(e){if(!e||typeof e!=="object"||Array.isArray(e))return!1;const n=e.domain??e.uri;return typeof n==="string"&&n.length>0&&(typeof e.version==="string"||e.title&&typeof e.title==="string")}function U(e){if(!e||typeof e!=="object"||Array.isArray(e))return!1;if((Array.isArray(e.namespaces)?e.namespaces:[]).some((r)=>r==="wp/v2"||String(r).startsWith("wp/v2/")))return!0;const t=e.routes;return!!t&&typeof t==="object"&&Object.keys(t).some((r)=>r.startsWith("/wp/v2/"))}function R(e,n){if(!e||typeof e!=="object"||Array.isArray(e))return!1;if(e.site&&typeof e.site==="object")return!0;if(n!==401&&n!==403)return!1;return(Array.isArray(e.errors)?e.errors:[]).some((r)=>{if(!r||typeof r!=="object")return!1;const s=String(r.type??""),o=String(r.context??"");return/GhostError|NoPermissionError|UnauthorizedError|NotFoundError/i.test(s)||/ghost admin api/i.test(o)})}export async function verifySiteKind(e,n,{originOnly:t=!1}={}){const r=normalizeSiteUrl(n,{originOnly:t}),s=P(e,r);let o;try{o=await j(s)}catch(i){const d=i?.name==="AbortError"?"连接超时":i?.message??String(i);throw new l(`连接不到 ${e} 站点 ${r}: ${d}`,"请检查站点地址、网络和 HTTPS 证书后重试。")}const c=await C(o),u=e==="mastodon"?o.ok&&L(c):e==="wordpress"?o.ok&&U(c):R(c,o.status);if(!u&&e==="mastodon"&&o.status===404)try{const i=await j(`${r.replace(/\/+$/,"")}/api/v1/instance`),d=await C(i);if(i.ok&&L(d))return{platform:e,url:r,verified:!0}}catch{}if(!u){const i=e==="mastodon"?"Mastodon":e==="wordpress"?"WordPress":"Ghost";throw new a(`${r} 不是可识别的 ${i} 站点`,`请填写 ${i} 站点根地址，当前检测地址: ${s}`)}return{platform:e,url:r,verified:!0}}export function resolveSiteConnection(e,n={},{selector:t="site",legacySelectors:r=[],envUrl:s,originOnly:o=!1}={}){const c=r.map((f)=>n[f]).find((f)=>f!=null&&String(f).trim());if(c!=null)return{name:"",url:normalizeSiteUrl(c,{originOnly:o}),saved:!1};const u=n[t];if(u!=null&&String(u).trim()){const f=String(u).trim(),x=loadSiteConnections(e),S=h(x,f);if(S)return{...S,saved:!0};if(f.includes("://")||f.includes(".")||/^localhost(?::\d+)?(?:\/|$)/i.test(f)||/^\[[0-9a-f:]+\](?::\d+)?(?:\/|$)/i.test(f))return{name:"",url:normalizeSiteUrl(f,{originOnly:o}),saved:!1};throw new a(`未找到 ${e} 站点连接“${f}”`,`运行 ppcli ${e} sites 查看已保存站点。`)}const i=loadSiteConnections(e),d=h(i,i.default)??i.sites[0];if(d)return{...d,saved:!0};if(s&&String(s).trim())return{name:"",url:normalizeSiteUrl(s,{originOnly:o}),saved:!1};throw new a(`${e} 尚未添加站点`,`先运行 ppcli ${e} add-site --name <名称> --url <网址>，或在本次命令传 --${t} <网址>。`)}export function connectionCommandDefinitions(e,{originOnly:n=!1}={}){return[{site:e,name:"sites",access:"read",description:`列出已保存的 ${e} 自部署站点连接。`,strategy:y.LOCAL,browser:!1,args:[],columns:["name","url","default"],func:async()=>listSiteConnectionRows(e)},{site:e,name:"add-site",access:"write",description:`校验并保存一个命名的 ${e} 自部署站点连接（只保存名称和网址）。`,strategy:y.LOCAL,browser:!1,args:[{name:"name",required:!0,help:"连接名称，例如“公司博客”"},{name:"url",required:!0,help:"站点根网址，例如 https://blog.example.com"}],columns:["status","name","url","default"],func:async(t)=>{await verifySiteKind(e,t.url,{originOnly:n});return[addSiteConnection(e,t.name,t.url,{originOnly:n})]}},{site:e,name:"remove-site",access:"write",description:`删除一个 ${e} 站点连接；不会清除浏览器里的站点 cookie。`,strategy:y.LOCAL,browser:!1,args:[{name:"site",required:!0,help:"要删除的连接名称"}],columns:["status","name","url"],func:async(t)=>[removeSiteConnection(e,t.site)]},{site:e,name:"use-site",access:"write",description:`设置 ${e} 默认站点；之后省略 --site 时使用它。`,strategy:y.LOCAL,browser:!1,args:[{name:"site",required:!0,help:"要设为默认的连接名称"}],columns:["status","name","url","default"],func:async(t)=>[useSiteConnection(e,t.site)]}]}

package/clis/_shared/site-auth.js

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

package/clis/_shared/token-auth.js

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

package/clis/_shared/video-publish.js

@@ -1,4 +1,4 @@
-import*as Y from"node:fs";import*as L from"node:path";import{ArgumentError as H,CommandExecutionError as $}from"@jackwener/opencli/errors";import{isFileAccessDenied as k,setInputFiles as C}from"./file-inject.js";export const SUPPORTED_VIDEO_EXTENSIONS=new Set([".mp4",".mov",".avi",".mkv",".m4v",".webm",".flv",".wmv"]),SUPPORTED_IMAGE_EXTENSIONS=new Set([".jpg",".jpeg",".png",".webp",".bmp"]);export function parseScheduleDate(q){if(q==null||q==="")return null;const y=String(q),z=/^\d+$/.test(y)?new Date(Number(y)<1000000000000?Number(y)*1000:Number(y)):new Date(y);if(Number.isNaN(z.getTime()))throw new H(`无法解析定时时间: ${q}`);if(z.getTime()<=Date.now())throw new H("定时发布时间必须晚于当前时间");return z}export function unwrap(q){if(q&&typeof q==="object"&&"data"in q&&"session"in q)return q.data;return q}export async function evalPage(q,y){return unwrap(await q.evaluate(y))}export function sleep(q){return new Promise((y)=>setTimeout(y,q*1000))}export const videoTimeoutArg=(q=540)=>({name:"timeout",type:"int",default:q,help:`命令超时（秒，默认 ${q}）。大视频/上行慢时调大；`+"超时不代表没发成功，先用回查命令确认再决定要不要重发。"});export function resolveVideoFile(q){const y=L.resolve(String(q));let z;try{z=Y.statSync(y)}catch{throw new H(`视频文件不存在: ${y}`)}if(!z.isFile())throw new H(`视频路径不是文件: ${y}`);const B=L.extname(y).toLowerCase();if(!SUPPORTED_VIDEO_EXTENSIONS.has(B))throw new H(`不支持的视频格式: ${B}（支持 ${[...SUPPORTED_VIDEO_EXTENSIONS].join("/")}）`);return y}export function resolveImageFile(q){const y=L.resolve(String(q));let z;try{z=Y.statSync(y)}catch{throw new H(`图片文件不存在: ${y}`)}if(!z.isFile())throw new H(`图片路径不是文件: ${y}`);const B=L.extname(y).toLowerCase();if(!SUPPORTED_IMAGE_EXTENSIONS.has(B))throw new H(`不支持的图片格式: ${B}（支持 ${[...SUPPORTED_IMAGE_EXTENSIONS].join("/")}）`);return y}export function throwIfFileAccessDenied(q){if(!k(q))return;throw new $("Chrome 拦截了扩展读取本地文件（DOM.setFileInputFiles → File access not granted）：商店安装的扩展默认没有本地文件访问权限","请让用户在 Chrome 打开 chrome://extensions，找到「ppcli Browser Bridge」→「详情」→ 打开「允许访问文件网址」（Allow access to file URLs），开关即时生效，然后重试本命令")}export async function setVideoInput(q,y,z){return(await C(q,y,z)).selector}export async function currentUrl(q){try{if(q.getCurrentUrl){const y=await q.getCurrentUrl();if(y)return String(y)}}catch{}try{return String(await evalPage(q,"() => location.href")||"")}catch{return""}}export async function waitForUrlIncludes(q,y,z=60000,B=500){const J=Array.isArray(y)?y:[y],K=Date.now()+z;while(Date.now()<K){const Q=await currentUrl(q);if(Q&&J.some((Z)=>Q.includes(Z)))return!0;await q.wait({time:B/1000})}return!1}export async function countByText(q,y){return Number(unwrap(await q.evaluate(`
+import*as l from"node:fs";import*as a from"node:path";import{ArgumentError as o,CommandExecutionError as f}from"@jackwener/opencli/errors";import{isFileAccessDenied as w,setInputFiles as m}from"./file-inject.js";export const SUPPORTED_VIDEO_EXTENSIONS=new Set([".mp4",".mov",".avi",".mkv",".m4v",".webm",".flv",".wmv"]),SUPPORTED_IMAGE_EXTENSIONS=new Set([".jpg",".jpeg",".png",".webp",".bmp"]);export function parseScheduleDate(e){if(e==null||e==="")return null;const t=String(e),n=/^\d+$/.test(t)?new Date(Number(t)<1000000000000?Number(t)*1000:Number(t)):new Date(t);if(Number.isNaN(n.getTime()))throw new o(`无法解析定时时间: ${e}`);if(n.getTime()<=Date.now())throw new o("定时发布时间必须晚于当前时间");return n}export function unwrap(e){if(e&&typeof e==="object"&&"data"in e&&"session"in e)return e.data;return e}export async function evalPage(e,t){return unwrap(await e.evaluate(t))}export function sleep(e){return new Promise((t)=>setTimeout(t,e*1000))}export const videoTimeoutArg=(e=540)=>({name:"timeout",type:"int",default:e,help:`命令超时（秒，默认 ${e}）。大视频/上行慢时调大；`+"超时不代表没发成功，先用回查命令确认再决定要不要重发。"});export function resolveVideoFile(e){const t=a.resolve(String(e));let n;try{n=l.statSync(t)}catch{throw new o(`视频文件不存在: ${t}`)}if(!n.isFile())throw new o(`视频路径不是文件: ${t}`);const r=a.extname(t).toLowerCase();if(!SUPPORTED_VIDEO_EXTENSIONS.has(r))throw new o(`不支持的视频格式: ${r}（支持 ${[...SUPPORTED_VIDEO_EXTENSIONS].join("/")}）`);return t}export function resolveImageFile(e){const t=a.resolve(String(e));let n;try{n=l.statSync(t)}catch{throw new o(`图片文件不存在: ${t}`)}if(!n.isFile())throw new o(`图片路径不是文件: ${t}`);const r=a.extname(t).toLowerCase();if(!SUPPORTED_IMAGE_EXTENSIONS.has(r))throw new o(`不支持的图片格式: ${r}（支持 ${[...SUPPORTED_IMAGE_EXTENSIONS].join("/")}）`);return t}export function throwIfFileAccessDenied(e){if(!w(e))return;throw new f("Chrome 拦截了扩展读取本地文件（DOM.setFileInputFiles → File access not granted）：商店安装的扩展默认没有本地文件访问权限","请让用户在 Chrome 打开 chrome://extensions，找到「ppcli Browser Bridge」→「详情」→ 打开「允许访问文件网址」（Allow access to file URLs），开关即时生效，然后重试本命令")}export async function setVideoInput(e,t,n){return(await m(e,t,n)).selector}export async function currentUrl(e){try{if(e.getCurrentUrl){const t=await e.getCurrentUrl();if(t)return String(t)}}catch{}try{return String(await evalPage(e,"() => location.href")||"")}catch{return""}}export async function waitForUrlIncludes(e,t,n=60000,r=500){const i=Array.isArray(t)?t:[t],s=Date.now()+n;while(Date.now()<s){const c=await currentUrl(e);if(c&&i.some((u)=>c.includes(u)))return!0;await e.wait({time:r/1000})}return!1}export async function countByText(e,t){return Number(unwrap(await e.evaluate(`
     ((want) => {
       let n = 0;
       const nodes = document.querySelectorAll('body *');
@@ -11,8 +11,8 @@ import*as Y from"node:fs";import*as L from"node:path";import{ArgumentError as H,
         }
       }
       return n;
-    })(${JSON.stringify(y)})
-  `)))||0}export async function clickByText(q,y,{exact:z=!1,timeoutMs:B=0,pollMs:J=500}={}){const K=Date.now()+Math.max(0,B);for(;;){if(Boolean(unwrap(await q.evaluate(`
+    })(${JSON.stringify(t)})
+  `)))||0}export async function clickByText(e,t,{exact:n=!1,timeoutMs:r=0,pollMs:i=500}={}){const s=Date.now()+Math.max(0,r);for(;;){if(Boolean(unwrap(await e.evaluate(`
       ((want, exact) => {
         const norm = (v) => (v || '').replace(/\\s+/g, ' ').trim();
         const isVisible = (el) => {
@@ -36,8 +36,8 @@ import*as Y from"node:fs";import*as L from"node:path";import{ArgumentError as H,
           return true;
         }
         return false;
-      })(${JSON.stringify(y)}, ${z?"true":"false"})
-    `))))return!0;if(Date.now()>=K)return!1;await q.wait({time:J/1000})}}export async function existsByText(q,y,{exact:z=!1}={}){return Boolean(unwrap(await q.evaluate(`
+      })(${JSON.stringify(t)}, ${n?"true":"false"})
+    `))))return!0;if(Date.now()>=s)return!1;await e.wait({time:i/1000})}}export async function existsByText(e,t,{exact:n=!1}={}){return Boolean(unwrap(await e.evaluate(`
     ((want, exact) => {
       const norm = (v) => (v || '').replace(/\\s+/g, ' ').trim();
       const isVisible = (el) => {
@@ -51,12 +51,12 @@ import*as Y from"node:fs";import*as L from"node:path";import{ArgumentError as H,
         if (exact ? t === want : (t && t.includes(want))) return true;
       }
       return false;
-    })(${JSON.stringify(y)}, ${z?"true":"false"})
-  `)))}export async function waitForSelector(q,y,z=30000,B=500){const J=Date.now()+z;while(Date.now()<J){if(Boolean(unwrap(await q.evaluate(`
+    })(${JSON.stringify(t)}, ${n?"true":"false"})
+  `)))}export async function waitForSelector(e,t,n=30000,r=500){const i=Date.now()+n;while(Date.now()<i){if(Boolean(unwrap(await e.evaluate(`
       ((sel) => {
         const el = document.querySelector(sel);
         if (!el) return false;
         const r = el.getBoundingClientRect();
         return r.width > 0 && r.height > 0;
-      })(${JSON.stringify(y)})
-    `))))return!0;await q.wait({time:B/1000})}return!1}
+      })(${JSON.stringify(t)})
+    `))))return!0;await e.wait({time:r/1000})}return!1}

package/clis/amazon/offer.js

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

package/clis/amazon/product.js

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

package/clis/amazon/shared.js

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

package/clis/antigravity/_actions.js

@@ -1,18 +1,18 @@
-import{CommandExecutionError as V,selectorError as W}from"@jackwener/opencli/errors";const H="convo-pill-";export function unwrapEvaluateResult(q){if(q&&typeof q==="object"&&Object.prototype.hasOwnProperty.call(q,"data")&&Object.prototype.hasOwnProperty.call(q,"session"))return q.data;return q}export function buildPillTestId(q){return`${H}${String(q).toLowerCase()}`}export async function listConversations(q){const x=unwrapEvaluateResult(await q.evaluate(`(function() {
-    return Array.from(document.querySelectorAll('[data-testid^="${H}"]'))
+import{CommandExecutionError as d,selectorError as m}from"@jackwener/opencli/errors";const i="convo-pill-";export function unwrapEvaluateResult(t){if(t&&typeof t==="object"&&Object.prototype.hasOwnProperty.call(t,"data")&&Object.prototype.hasOwnProperty.call(t,"session"))return t.data;return t}export function buildPillTestId(t){return`${i}${String(t).toLowerCase()}`}export async function listConversations(t){const e=unwrapEvaluateResult(await t.evaluate(`(function() {
+    return Array.from(document.querySelectorAll('[data-testid^="${i}"]'))
       .filter((el) => el.offsetParent)
       .map((el, idx) => ({
         index: idx + 1,
-        id: el.getAttribute('data-testid').slice(${H.length}),
+        id: el.getAttribute('data-testid').slice(${i.length}),
         title: (el.textContent || '').trim().slice(0, 200),
       }));
-  })()`));return Array.isArray(x)?x:[]}export async function conversationVisible(q,x){const z=buildPillTestId(x);return!!unwrapEvaluateResult(await q.evaluate(`(() => {
-    const el = document.querySelector(${JSON.stringify(`[data-testid="${z}"]`)});
+  })()`));return Array.isArray(e)?e:[]}export async function conversationVisible(t,e){const n=buildPillTestId(e);return!!unwrapEvaluateResult(await t.evaluate(`(() => {
+    const el = document.querySelector(${JSON.stringify(`[data-testid="${n}"]`)});
     return !!(el && el.offsetParent);
-  })()`))}export async function getConversationMenuLabels(q,x){const z=buildPillTestId(x);return unwrapEvaluateResult(await q.evaluate(`(async () => {
+  })()`))}export async function getConversationMenuLabels(t,e){const n=buildPillTestId(e);return unwrapEvaluateResult(await t.evaluate(`(async () => {
     const wait = (ms) => new Promise((r) => setTimeout(r, ms));
-    const pill = document.querySelector(${JSON.stringify(`[data-testid="${z}"]`)});
-    if (!pill) return { ok: false, reason: 'Conversation pill not found.', detail: 'testid=${z}' };
+    const pill = document.querySelector(${JSON.stringify(`[data-testid="${n}"]`)});
+    if (!pill) return { ok: false, reason: 'Conversation pill not found.', detail: 'testid=${n}' };
     let row = pill;
     for (let i = 0; i < 3; i++) row = row.parentElement || row;
     row.scrollIntoView({ block: 'center' });
@@ -50,10 +50,10 @@ import{CommandExecutionError as V,selectorError as W}from"@jackwener/opencli/err
     }).filter(Boolean);
     document.body.click();
     return { ok: true, labels };
-  })()`))||{ok:!1,reason:"Empty result from page.evaluate."}}export async function clickConversationMenuItem(q,x,z){const B=buildPillTestId(x),M=JSON.stringify(B),N=JSON.stringify(z);let K;try{K=unwrapEvaluateResult(await q.evaluate(`(async () => {
+  })()`))||{ok:!1,reason:"Empty result from page.evaluate."}}export async function clickConversationMenuItem(t,e,n){const o=buildPillTestId(e),l=JSON.stringify(o),a=JSON.stringify(n);let s;try{s=unwrapEvaluateResult(await t.evaluate(`(async () => {
     const wait = (ms) => new Promise((r) => setTimeout(r, ms));
-    const testId = ${M};
-    const labels = ${N};
+    const testId = ${l};
+    const labels = ${a};
 
     const pill = document.querySelector(\`[data-testid="\${testId}"]\`);
     if (!pill) {
@@ -158,7 +158,7 @@ import{CommandExecutionError as V,selectorError as W}from"@jackwener/opencli/err
       } catch {}
     });
     return { ok: true, clicked: matchedLabel };
-  })()`))}catch(G){const Q=String(G?.message||G);if(/Promise was collected|timed out after \d+s|Runtime\.evaluate/i.test(Q))return{ok:!0,clicked:z[0],note:"eval reply destroyed by post-click re-render; click likely fired"};throw G}return K||{ok:!1,reason:"Empty result from page.evaluate."}}export async function confirmDeleteDialog(q,x){const z=JSON.stringify(x);return unwrapEvaluateResult(await q.evaluate(`(async () => {
+  })()`))}catch(r){const u=String(r?.message||r);if(/Promise was collected|timed out after \d+s|Runtime\.evaluate/i.test(u))return{ok:!0,clicked:n[0],note:"eval reply destroyed by post-click re-render; click likely fired"};throw r}return s||{ok:!1,reason:"Empty result from page.evaluate."}}export async function confirmDeleteDialog(t,e){const n=JSON.stringify(e);return unwrapEvaluateResult(await t.evaluate(`(async () => {
     const wait = (ms) => new Promise((r) => setTimeout(r, ms));
     let dialog = null;
     for (let attempt = 0; attempt < 15; attempt += 1) {
@@ -170,7 +170,7 @@ import{CommandExecutionError as V,selectorError as W}from"@jackwener/opencli/err
       return { ok: false, reason: 'Delete confirm dialog did not appear.' };
     }
     const buttons = Array.from(dialog.querySelectorAll('button'));
-    const labels = ${z};
+    const labels = ${n};
     const confirmBtn = buttons.find((b) => {
       const t = (b.textContent || '').trim();
       return labels.some((l) => t === l || t.toLowerCase() === l.toLowerCase());

package/clis/antigravity/audit-extras.js

@@ -1,6 +1,6 @@
-import{cli as D,Strategy as G}from"@jackwener/opencli/registry";import{ArgumentError as M,CommandExecutionError as H,EmptyResultError as K}from"@jackwener/opencli/errors";import{unwrapEvaluateResult as B}from"./_actions.js";function J(h){return`(() => {
+import{cli as o,Strategy as a}from"@jackwener/opencli/registry";import{ArgumentError as d,CommandExecutionError as s,EmptyResultError as u}from"@jackwener/opencli/errors";import{unwrapEvaluateResult as i}from"./_actions.js";function c(t){return`(() => {
     const isVis = (el) => { const r = el.getBoundingClientRect(); return r.width > 1 && r.height > 1; };
-    for (const sel of ${JSON.stringify(h)}) {
+    for (const sel of ${JSON.stringify(t)}) {
       const t = Array.from(document.querySelectorAll(sel)).filter(isVis)[0];
       if (t) {
         const r = t.getBoundingClientRect();
@@ -14,9 +14,9 @@ import{cli as D,Strategy as G}from"@jackwener/opencli/registry";import{ArgumentE
       }
     }
     return { ok: false, reason: 'No matching visible element.' };
-  })()`}function N(h){return`(() => {
+  })()`}function p(t){return`(() => {
     const isVis = (el) => { const r = el.getBoundingClientRect(); return r.width > 1 && r.height > 1; };
-    for (const sel of ${JSON.stringify(h)}) {
+    for (const sel of ${JSON.stringify(t)}) {
       const found = Array.from(document.querySelectorAll(sel)).filter(isVis);
       if (found.length) {
         const t = found[found.length - 1];
@@ -31,7 +31,7 @@ import{cli as D,Strategy as G}from"@jackwener/opencli/registry";import{ArgumentE
       }
     }
     return { ok: false, reason: 'No matching visible element.' };
-  })()`}D({site:"antigravity",name:"react",access:"write",description:'Click "Good response" or "Bad response" on the LAST assistant message.',domain:"127.0.0.1",strategy:G.UI,browser:!0,args:[{name:"kind",positional:!0,required:!0,help:"good or bad"}],columns:["Status","Reaction"],func:async(h,f)=>{const q=String(f?.kind||"").trim().toLowerCase();if(q!=="good"&&q!=="bad")throw new M("kind",'must be "good" or "bad"');const z=q==="good"?"Good response":"Bad response",I=B(await h.evaluate(N([`button[aria-label="${z}"]`])));if(!I?.ok)throw new H(I?.reason||`${z} click failed`,"");return[{Status:"clicked",Reaction:q}]}});D({site:"antigravity",name:"copy-message",access:"write",description:"Return the text of the last assistant message (best-effort: walks up from the last visible Copy button).",domain:"127.0.0.1",strategy:G.UI,browser:!0,args:[{name:"click-button",type:"boolean",default:!1,help:"Also click the in-UI Copy button"}],columns:["Field","Value"],func:async(h,f)=>{const q=B(await h.evaluate(`(() => {
+  })()`}o({site:"antigravity",name:"react",access:"write",description:'Click "Good response" or "Bad response" on the LAST assistant message.',domain:"127.0.0.1",strategy:a.UI,browser:!0,args:[{name:"kind",positional:!0,required:!0,help:"good or bad"}],columns:["Status","Reaction"],func:async(t,e)=>{const n=String(e?.kind||"").trim().toLowerCase();if(n!=="good"&&n!=="bad")throw new d("kind",'must be "good" or "bad"');const r=n==="good"?"Good response":"Bad response",l=i(await t.evaluate(p([`button[aria-label="${r}"]`])));if(!l?.ok)throw new s(l?.reason||`${r} click failed`,"");return[{Status:"clicked",Reaction:n}]}});o({site:"antigravity",name:"copy-message",access:"write",description:"Return the text of the last assistant message (best-effort: walks up from the last visible Copy button).",domain:"127.0.0.1",strategy:a.UI,browser:!0,args:[{name:"click-button",type:"boolean",default:!1,help:"Also click the in-UI Copy button"}],columns:["Field","Value"],func:async(t,e)=>{const n=i(await t.evaluate(`(() => {
       const isVis = (el) => { const r = el.getBoundingClientRect(); return r.width > 1 && r.height > 1; };
       // Antigravity has both "Copy" (message) and "Copy code" (code block) buttons.
       // We want the bottom-of-message Copy, not the code-block Copy.
@@ -47,19 +47,19 @@ import{cli as D,Strategy as G}from"@jackwener/opencli/registry";import{ArgumentE
         if (best.length > 200) break;
       }
       return { text: best };
-    })()`));if(!q)throw new K("antigravity copy-message","No Copy buttons visible — make sure an assistant reply is on screen.");if(f?.["click-button"]===!0||f?.["click-button"]==="true"){const z=B(await h.evaluate(N(['button[aria-label="Copy"]'])));if(!z?.ok)throw new H(z?.reason||"Copy button click failed","")}return[{Field:"Length",Value:String((q.text||"").length)+" chars"},{Field:"ClipboardClicked",Value:f?.["click-button"]===!0||f?.["click-button"]==="true"?"yes":"no"},{Field:"Text",Value:q.text||""}]}});D({site:"antigravity",name:"copy-code",access:"read",description:"Return the text of a code block in the current conversation. Default: last code block; pass --index N (1-based from top) to pick a specific one.",domain:"127.0.0.1",strategy:G.UI,browser:!0,args:[{name:"index",type:"int",required:!1,help:"1-based index of code block (default: last)"}],columns:["Field","Value"],func:async(h,f)=>{const q=Number.isInteger(f?.index)?f.index:null,z=B(await h.evaluate(`(() => {
+    })()`));if(!n)throw new u("antigravity copy-message","No Copy buttons visible — make sure an assistant reply is on screen.");if(e?.["click-button"]===!0||e?.["click-button"]==="true"){const r=i(await t.evaluate(p(['button[aria-label="Copy"]'])));if(!r?.ok)throw new s(r?.reason||"Copy button click failed","")}return[{Field:"Length",Value:String((n.text||"").length)+" chars"},{Field:"ClipboardClicked",Value:e?.["click-button"]===!0||e?.["click-button"]==="true"?"yes":"no"},{Field:"Text",Value:n.text||""}]}});o({site:"antigravity",name:"copy-code",access:"read",description:"Return the text of a code block in the current conversation. Default: last code block; pass --index N (1-based from top) to pick a specific one.",domain:"127.0.0.1",strategy:a.UI,browser:!0,args:[{name:"index",type:"int",required:!1,help:"1-based index of code block (default: last)"}],columns:["Field","Value"],func:async(t,e)=>{const n=Number.isInteger(e?.index)?e.index:null,r=i(await t.evaluate(`(() => {
       const isVis = (el) => { const r = el.getBoundingClientRect(); return r.width > 1 && r.height > 1; };
       const btns = Array.from(document.querySelectorAll('button[aria-label="Copy code"]')).filter(isVis);
       if (!btns.length) return null;
-      const idx = ${q===null?"btns.length - 1":q-1};
+      const idx = ${n===null?"btns.length - 1":n-1};
       const btn = btns[idx];
-      if (!btn) return { err: 'index ' + (${q} ?? 'last') + ' out of range. Have ' + btns.length + ' code blocks.' };
+      if (!btn) return { err: 'index ' + (${n} ?? 'last') + ' out of range. Have ' + btns.length + ' code blocks.' };
       // Find the <code> or <pre> element inside the parent block.
       let container = btn;
       for (let i = 0; i < 6 && container.parentElement; i++) container = container.parentElement;
       const code = container.querySelector('pre, code');
       return { text: code ? (code.innerText || '').trim() : (container.innerText || '').trim(), total: btns.length };
-    })()`));if(!z)throw new K("antigravity copy-code","No code blocks visible.");if(z.err)throw new H(z.err,"");return[{Field:"TotalCodeBlocks",Value:String(z.total)},{Field:"PickedIndex",Value:String(q===null?z.total:q)},{Field:"Length",Value:String((z.text||"").length)+" chars"},{Field:"Code",Value:z.text||""}]}});D({site:"antigravity",name:"settings",access:"write",description:'Click the Antigravity settings button (matched by data-testid="settings-button").',domain:"127.0.0.1",strategy:G.UI,browser:!0,args:[],columns:["Status"],func:async(h)=>{const f=B(await h.evaluate(J(['[data-testid="settings-button"]','button[aria-label="Settings"]'])));if(!f?.ok)throw new H(f?.reason||"settings click failed","");await h.wait(0.6);return[{Status:`clicked via ${f.sel}`}]}});D({site:"antigravity",name:"sidebar-toggle",access:"write",description:"Click Toggle Sidebar (collapses/expands the Antigravity sidebar).",domain:"127.0.0.1",strategy:G.UI,browser:!0,args:[],columns:["Status"],func:async(h)=>{const f=B(await h.evaluate(J(['button[aria-label="Toggle Sidebar"]'])));if(!f?.ok)throw new H(f?.reason||"sidebar-toggle failed","");return[{Status:"toggled"}]}});D({site:"antigravity",name:"nav",access:"write",description:"Click Go Back or Go Forward (Antigravity in-app history).",domain:"127.0.0.1",strategy:G.UI,browser:!0,args:[{name:"direction",positional:!0,required:!0,help:"back or forward"}],columns:["Status"],func:async(h,f)=>{const q=String(f?.direction||"").trim().toLowerCase();if(q!=="back"&&q!=="forward")throw new M("direction",'must be "back" or "forward"');const z=q==="back"?"Go Back":"Go Forward",I=B(await h.evaluate(J([`button[aria-label="${z}"]`])));if(!I?.ok)throw new H(I?.reason||`${z} click failed`,"");return[{Status:`${q} clicked`}]}});D({site:"antigravity",name:"toggle-aux",access:"write",description:"Toggle the Auxiliary Pane (Antigravity's secondary panel for code/preview).",domain:"127.0.0.1",strategy:G.UI,browser:!0,args:[],columns:["Status"],func:async(h)=>{const f=B(await h.evaluate(J(['button[aria-label="Toggle Auxiliary Pane"]'])));if(!f?.ok)throw new H(f?.reason||"toggle-aux failed","");return[{Status:"toggled"}]}});D({site:"antigravity",name:"display-options",access:"read",description:"Open the Display Options menu and list its items.",domain:"127.0.0.1",strategy:G.UI,browser:!0,args:[],columns:["Index","Item"],func:async(h)=>{const f=B(await h.evaluate(J(['button[aria-label="Display Options"]'])));if(!f?.ok)throw new H(f?.reason||"display-options click failed","");await h.wait(0.4);const q=B(await h.evaluate(`(() => {
+    })()`));if(!r)throw new u("antigravity copy-code","No code blocks visible.");if(r.err)throw new s(r.err,"");return[{Field:"TotalCodeBlocks",Value:String(r.total)},{Field:"PickedIndex",Value:String(n===null?r.total:n)},{Field:"Length",Value:String((r.text||"").length)+" chars"},{Field:"Code",Value:r.text||""}]}});o({site:"antigravity",name:"settings",access:"write",description:'Click the Antigravity settings button (matched by data-testid="settings-button").',domain:"127.0.0.1",strategy:a.UI,browser:!0,args:[],columns:["Status"],func:async(t)=>{const e=i(await t.evaluate(c(['[data-testid="settings-button"]','button[aria-label="Settings"]'])));if(!e?.ok)throw new s(e?.reason||"settings click failed","");await t.wait(0.6);return[{Status:`clicked via ${e.sel}`}]}});o({site:"antigravity",name:"sidebar-toggle",access:"write",description:"Click Toggle Sidebar (collapses/expands the Antigravity sidebar).",domain:"127.0.0.1",strategy:a.UI,browser:!0,args:[],columns:["Status"],func:async(t)=>{const e=i(await t.evaluate(c(['button[aria-label="Toggle Sidebar"]'])));if(!e?.ok)throw new s(e?.reason||"sidebar-toggle failed","");return[{Status:"toggled"}]}});o({site:"antigravity",name:"nav",access:"write",description:"Click Go Back or Go Forward (Antigravity in-app history).",domain:"127.0.0.1",strategy:a.UI,browser:!0,args:[{name:"direction",positional:!0,required:!0,help:"back or forward"}],columns:["Status"],func:async(t,e)=>{const n=String(e?.direction||"").trim().toLowerCase();if(n!=="back"&&n!=="forward")throw new d("direction",'must be "back" or "forward"');const r=n==="back"?"Go Back":"Go Forward",l=i(await t.evaluate(c([`button[aria-label="${r}"]`])));if(!l?.ok)throw new s(l?.reason||`${r} click failed`,"");return[{Status:`${n} clicked`}]}});o({site:"antigravity",name:"toggle-aux",access:"write",description:"Toggle the Auxiliary Pane (Antigravity's secondary panel for code/preview).",domain:"127.0.0.1",strategy:a.UI,browser:!0,args:[],columns:["Status"],func:async(t)=>{const e=i(await t.evaluate(c(['button[aria-label="Toggle Auxiliary Pane"]'])));if(!e?.ok)throw new s(e?.reason||"toggle-aux failed","");return[{Status:"toggled"}]}});o({site:"antigravity",name:"display-options",access:"read",description:"Open the Display Options menu and list its items.",domain:"127.0.0.1",strategy:a.UI,browser:!0,args:[],columns:["Index","Item"],func:async(t)=>{const e=i(await t.evaluate(c(['button[aria-label="Display Options"]'])));if(!e?.ok)throw new s(e?.reason||"display-options click failed","");await t.wait(0.4);const n=i(await t.evaluate(`(() => {
       const isVis = (el) => { const r = el.getBoundingClientRect(); return r.width > 1 && r.height > 1; };
       const candidates = Array.from(document.querySelectorAll('[role="menu"], [role="dialog"], [class*="popover"i]'))
         .filter(isVis)
@@ -75,4 +75,4 @@ import{cli as D,Strategy as G}from"@jackwener/opencli/registry";import{ArgumentE
         .filter(isVis)
         .map((it) => (it.innerText || '').trim().replace(/\\s+/g, ' '))
         .filter(Boolean);
-    })()`));try{await h.evaluate("document.body.dispatchEvent(new KeyboardEvent('keydown', { key: 'Escape', bubbles: true }));")}catch{}if(!q.length)throw new K("antigravity display-options","Menu opened but no items detected.");return q.map((z,I)=>({Index:I+1,Item:z}))}});D({site:"antigravity",name:"add-context",access:"write",description:"Click the Add context button in the composer (opens file/URL picker for context attachment).",domain:"127.0.0.1",strategy:G.UI,browser:!0,args:[],columns:["Status"],func:async(h)=>{const f=B(await h.evaluate(J(['button[aria-label="Add context"]'])));if(!f?.ok)throw new H(f?.reason||"add-context click failed","");await h.wait(0.4);return[{Status:"clicked — picker should be open"}]}});D({site:"antigravity",name:"revert",access:"write",description:"Click the revert button (per-message revert for agent changes). Requires --yes (this modifies your workspace).",domain:"127.0.0.1",strategy:G.UI,browser:!0,args:[{name:"yes",type:"boolean",default:!1,help:"Actually revert (default: dry-run)"}],columns:["Status"],func:async(h,f)=>{if(!(f?.yes===!0||f?.yes==="true"||f?.yes==="1"))return[{Status:"dry-run — pass --yes to revert (modifies workspace)"}];const z=B(await h.evaluate(J(['[data-testid="revert-button"]','button[aria-label="Revert"]'])));if(!z?.ok)throw new H(z?.reason||"revert click failed","");await h.wait(1);return[{Status:"reverted"}]}});
+    })()`));try{await t.evaluate("document.body.dispatchEvent(new KeyboardEvent('keydown', { key: 'Escape', bubbles: true }));")}catch{}if(!n.length)throw new u("antigravity display-options","Menu opened but no items detected.");return n.map((r,l)=>({Index:l+1,Item:r}))}});o({site:"antigravity",name:"add-context",access:"write",description:"Click the Add context button in the composer (opens file/URL picker for context attachment).",domain:"127.0.0.1",strategy:a.UI,browser:!0,args:[],columns:["Status"],func:async(t)=>{const e=i(await t.evaluate(c(['button[aria-label="Add context"]'])));if(!e?.ok)throw new s(e?.reason||"add-context click failed","");await t.wait(0.4);return[{Status:"clicked — picker should be open"}]}});o({site:"antigravity",name:"revert",access:"write",description:"Click the revert button (per-message revert for agent changes). Requires --yes (this modifies your workspace).",domain:"127.0.0.1",strategy:a.UI,browser:!0,args:[{name:"yes",type:"boolean",default:!1,help:"Actually revert (default: dry-run)"}],columns:["Status"],func:async(t,e)=>{if(!(e?.yes===!0||e?.yes==="true"||e?.yes==="1"))return[{Status:"dry-run — pass --yes to revert (modifies workspace)"}];const r=i(await t.evaluate(c(['[data-testid="revert-button"]','button[aria-label="Revert"]'])));if(!r?.ok)throw new s(r?.reason||"revert click failed","");await t.wait(1);return[{Status:"reverted"}]}});

package/clis/antigravity/delete.js

@@ -1 +1 @@
-import{cli as K,Strategy as L}from"@jackwener/opencli/registry";import{CommandExecutionError as H}from"@jackwener/opencli/errors";import{clickConversationMenuItem as N,confirmDeleteDialog as O,conversationVisible as P,conversationTargetArgs as Q}from"./_actions.js";K({site:"antigravity",name:"delete",access:"write",description:"Delete an Antigravity conversation by ID. Antigravity asks for confirmation; we click through it. Require --yes to actually delete.",domain:"127.0.0.1",strategy:L.UI,browser:!0,args:[...Q,{name:"yes",type:"boolean",default:!1,help:"Actually delete (default: dry-run preview)"}],columns:["status","id"],func:async(q,B)=>{const z=String(B.id);if(!(B.yes===!0||B.yes==="true"||B.yes==="1"))return[{status:"dry-run (pass --yes to actually delete)",id:z}];const F=await N(q,z,["Delete Conversation","Delete"]);if(!F.ok)throw new H(`${F.reason}${F.detail?" "+F.detail:""}`,"Make sure Antigravity is in the foreground and the sidebar is open.");const G=await O(q,["Delete","Delete Conversation","Confirm","OK"]);if(!G.ok)throw new H(`${G.reason}${G.detail?" "+G.detail:""}`,"Delete menu fired but the confirm dialog did not show / its button was not found.");await q.wait(1);for(let J=0;J<10;J+=1){if(!await P(q,z))return[{status:"deleted",id:z}];await q.wait(0.5)}throw new H(`Delete did not remove conversation ${z} from the visible sidebar.`,"The delete click/confirmation may have failed or the selector contract drifted.")}});
+import{cli as s,Strategy as l}from"@jackwener/opencli/registry";import{CommandExecutionError as n}from"@jackwener/opencli/errors";import{clickConversationMenuItem as d,confirmDeleteDialog as c,conversationVisible as u,conversationTargetArgs as f}from"./_actions.js";s({site:"antigravity",name:"delete",access:"write",description:"Delete an Antigravity conversation by ID. Antigravity asks for confirmation; we click through it. Require --yes to actually delete.",domain:"127.0.0.1",strategy:l.UI,browser:!0,args:[...f,{name:"yes",type:"boolean",default:!1,help:"Actually delete (default: dry-run preview)"}],columns:["status","id"],func:async(e,i)=>{const t=String(i.id);if(!(i.yes===!0||i.yes==="true"||i.yes==="1"))return[{status:"dry-run (pass --yes to actually delete)",id:t}];const o=await d(e,t,["Delete Conversation","Delete"]);if(!o.ok)throw new n(`${o.reason}${o.detail?" "+o.detail:""}`,"Make sure Antigravity is in the foreground and the sidebar is open.");const r=await c(e,["Delete","Delete Conversation","Confirm","OK"]);if(!r.ok)throw new n(`${r.reason}${r.detail?" "+r.detail:""}`,"Delete menu fired but the confirm dialog did not show / its button was not found.");await e.wait(1);for(let a=0;a<10;a+=1){if(!await u(e,t))return[{status:"deleted",id:t}];await e.wait(0.5)}throw new n(`Delete did not remove conversation ${t} from the visible sidebar.`,"The delete click/confirmation may have failed or the selector contract drifted.")}});

package/clis/antigravity/model.js

@@ -1,10 +1,10 @@
-import{cli as N,Strategy as P}from"@jackwener/opencli/registry";import{ArgumentError as Q,CommandExecutionError as L,selectorError as T}from"@jackwener/opencli/errors";import{unwrapEvaluateResult as J}from"./_actions.js";N({site:"antigravity",name:"model",access:"write",description:"Read or switch the active model in Antigravity. Without arguments, reports the current model. With <name> (substring, case-insensitive), switches.",domain:"127.0.0.1",strategy:P.UI,browser:!0,args:[{name:"name",required:!1,positional:!0,help:"Substring (case-insensitive) of target model name. Omit to read current."},{name:"list",type:"boolean",default:!1,help:"List models in the picker (does not switch)"}],columns:["Status","Model"],func:async(F,G)=>{const K=String(G.name||"").trim().toLowerCase(),H=G.list===!0||G.list==="true",B=(D)=>String(D||"").trim().replace(/\s+/g," ").toLowerCase(),I=J(await F.evaluate(`(function() {
+import{cli as m,Strategy as h}from"@jackwener/opencli/registry";import{ArgumentError as b,CommandExecutionError as u,selectorError as g}from"@jackwener/opencli/errors";import{unwrapEvaluateResult as l}from"./_actions.js";m({site:"antigravity",name:"model",access:"write",description:"Read or switch the active model in Antigravity. Without arguments, reports the current model. With <name> (substring, case-insensitive), switches.",domain:"127.0.0.1",strategy:h.UI,browser:!0,args:[{name:"name",required:!1,positional:!0,help:"Substring (case-insensitive) of target model name. Omit to read current."},{name:"list",type:"boolean",default:!1,help:"List models in the picker (does not switch)"}],columns:["Status","Model"],func:async(i,o)=>{const c=String(o.name||"").trim().toLowerCase(),a=o.list===!0||o.list==="true",n=(r)=>String(r||"").trim().replace(/\s+/g," ").toLowerCase(),s=l(await i.evaluate(`(function() {
       const btn = document.querySelector('button[aria-label^="Select model, current:"]');
       if (!btn) return '';
       const aria = btn.getAttribute('aria-label') || '';
       const m = aria.match(/current:\\s*(.*)$/i);
       return m ? m[1].trim() : (btn.textContent || '').trim();
-    })()`));if(!I)throw T('Antigravity model button (button[aria-label^="Select model, current:"]). Make sure a chat is open in the foreground.');if(!K&&!H)return[{Status:"Active",Model:I}];const M=JSON.stringify(K),h=J(await F.evaluate(`(async () => {
+    })()`));if(!s)throw g('Antigravity model button (button[aria-label^="Select model, current:"]). Make sure a chat is open in the foreground.');if(!c&&!a)return[{Status:"Active",Model:s}];const d=JSON.stringify(c),e=l(await i.evaluate(`(async () => {
       const wait = (ms) => new Promise((r) => setTimeout(r, ms));
       const trigger = document.querySelector('button[aria-label^="Select model, current:"]');
       if (!trigger) return { ok: false, reason: 'trigger missing' };
@@ -41,8 +41,8 @@ import{cli as N,Strategy as P}from"@jackwener/opencli/registry";import{ArgumentE
       }
 
       const labels = rows.map((r) => (r.innerText || r.textContent || '').trim().slice(0, 80));
-      const target = ${M};
-      const listOnly = ${H?"true":"false"};
+      const target = ${d};
+      const listOnly = ${a?"true":"false"};
       if (!target || listOnly) {
         // Close picker (Esc) and return list.
         document.dispatchEvent(new KeyboardEvent('keydown', { bubbles: true, key: 'Escape' }));
@@ -81,10 +81,10 @@ import{cli as N,Strategy as P}from"@jackwener/opencli/registry";import{ArgumentE
         } catch {}
       });
       return { ok: true, switched: true, chosen: chosenLabel, labels };
-    })()`));if(!h.ok){if(h.reason==="Ambiguous model match.")throw new Q(h.detail||"Ambiguous model match.");throw new L(h.reason,h.detail||"")}if(H)return h.labels.map((D)=>({Status:D.startsWith(I.slice(0,20))?"Active":"Available",Model:D}));await F.wait(0.8);let q="";for(let D=0;D<8;D+=1){q=J(await F.evaluate(`(function() {
+    })()`));if(!e.ok){if(e.reason==="Ambiguous model match.")throw new b(e.detail||"Ambiguous model match.");throw new u(e.reason,e.detail||"")}if(a)return e.labels.map((r)=>({Status:r.startsWith(s.slice(0,20))?"Active":"Available",Model:r}));await i.wait(0.8);let t="";for(let r=0;r<8;r+=1){t=l(await i.evaluate(`(function() {
         const btn = document.querySelector('button[aria-label^="Select model, current:"]');
         if (!btn) return '';
         const aria = btn.getAttribute('aria-label') || '';
         const m = aria.match(/current:\\s*(.*)$/i);
         return m ? m[1].trim() : (btn.textContent || '').trim();
-      })()`));if(B(q)&&(B(h.chosen).includes(B(q))||B(q).includes(B(h.chosen))))return[{Status:"switched",Model:q}];if(B(q)===B(h.chosen))return[{Status:"switched",Model:q}];await F.wait(0.4)}throw new L(`Could not verify Antigravity model switched to ${h.chosen}.`,`Read back current model: ${q||"(empty)"}`)}});
+      })()`));if(n(t)&&(n(e.chosen).includes(n(t))||n(t).includes(n(e.chosen))))return[{Status:"switched",Model:t}];if(n(t)===n(e.chosen))return[{Status:"switched",Model:t}];await i.wait(0.4)}throw new u(`Could not verify Antigravity model switched to ${e.chosen}.`,`Read back current model: ${t||"(empty)"}`)}});

package/clis/antigravity/new.js

@@ -1,4 +1,4 @@
-import{cli as d,Strategy as f}from"@jackwener/opencli/registry";export const newCommand=d({site:"antigravity",name:"new",access:"read",description:"Start a new conversation / clear context in Antigravity",domain:"localhost",strategy:f.UI,browser:!0,args:[],columns:["status"],func:async(b)=>{await b.evaluate(`
+import{cli as n,Strategy as a}from"@jackwener/opencli/registry";export const newCommand=n({site:"antigravity",name:"new",access:"read",description:"Start a new conversation / clear context in Antigravity",domain:"localhost",strategy:a.UI,browser:!0,args:[],columns:["status"],func:async(t)=>{await t.evaluate(`
       async () => {
         const btn = document.querySelector('[data-tooltip-id="new-conversation-tooltip"]');
         if (!btn) throw new Error('Could not find New Conversation button');
@@ -6,4 +6,4 @@ import{cli as d,Strategy as f}from"@jackwener/opencli/registry";export const new
         // In case it's disabled, we must check, but we'll try to click it anyway
         btn.click();
       }
-    `);await b.wait(0.5);return[{status:"Successfully started a new conversation"}]}});
+    `);await t.wait(0.5);return[{status:"Successfully started a new conversation"}]}});