publishport-opencli 1.0.23 → 1.0.24

package/README.md

@@ -31,7 +31,7 @@ open the app once and use the System page to install or repair the `opencli`
 command.
 
 **Option B — npm global install (CLI-only / CI / servers):**
-ppcli requires **Node.js >= 20** when installed through npm.
+ppcli requires **Node.js >= 20.18.1** when installed through npm.
 
 ```bash
 node --version
@@ -287,7 +287,7 @@ See **[TESTING.md](./TESTING.md)** for how to run and write tests.
 - **"Extension not connected"** — Ensure the Browser Bridge extension is installed from the [Chrome Web Store](https://chromewebstore.google.com/detail/opencli/ildkmabpimmkaediidaifkhjpohdnifk) and **enabled** in `chrome://extensions`.
 - **"attach failed: Cannot access a chrome-extension:// URL"** — Another extension may be interfering. Try disabling other extensions temporarily.
 - **Empty data or 'Unauthorized' error** — Your Chrome/Chromium login session may have expired. Navigate to the target site and log in again.
-- **Node API errors / missing `fetch` / startup crash on old Node** — ppcli requires **Node.js >= 20**. Run `node --version`, upgrade Node if needed, then retry.
+- **Node API errors / missing `fetch` / startup crash on old Node** — ppcli requires **Node.js >= 20.18.1**. Run `node --version`, upgrade Node if needed, then retry.
 - **Daemon issues** — Check status: `curl localhost:19825/status` · View logs: `curl localhost:19825/logs`
 
 ## Star History

package/README.zh-CN.md

@@ -30,7 +30,7 @@ UI 来做环境诊断、更新、浏览器登录态保活和网页转 Markdown
 System 页面安装或修复 `opencli` 命令。
 
 **方式 B — npm 全局安装（纯 CLI / CI / 服务器）：**
-通过 npm 安装时，ppcli 要求 **Node.js >= 20**。
+通过 npm 安装时，ppcli 要求 **Node.js >= 20.18.1**。
 
 ```bash
 node --version
@@ -324,7 +324,7 @@ ppcli plugin uninstall my-tool                            # 卸载
 - **返回空数据，或者报错 "Unauthorized"**
   - Chrome/Chromium 里的登录态可能已经过期。请打开当前页面，在新标签页重新手工登录或刷新该页面。
 - **Node API 错误 / 缺少 `fetch` / 旧 Node 启动即崩**
-  - ppcli 要求 **Node.js >= 20**。先执行 `node --version`，如果版本过低先升级，再重试命令。
+  - ppcli 要求 **Node.js >= 20.18.1**。先执行 `node --version`，如果版本过低先升级，再重试命令。
 - **Daemon 问题**
   - 检查 daemon 状态：`curl localhost:19825/status`
   - 查看扩展日志：`curl localhost:19825/logs`

package/cli-manifest.json

@@ -6486,7 +6486,7 @@
     "description": "BOSS直聘查看职位详情",
     "access": "read",
     "domain": "www.zhipin.com",
-    "strategy": "cookie",
+    "strategy": "ui",
     "browser": true,
     "args": [
       {
@@ -6494,7 +6494,7 @@
         "type": "str",
         "required": true,
         "positional": true,
-        "help": "Security ID from search results (securityId field)"
+        "help": "Security ID from search results (security_id field)"
       }
     ],
     "columns": [
@@ -6503,7 +6503,7 @@
       "experience",
       "degree",
       "city",
-      "district",
+      "address",
       "description",
       "skills",
       "welfare",
@@ -6514,13 +6514,14 @@
       "industry",
       "scale",
       "stage",
-      "address",
       "url"
     ],
     "type": "js",
     "modulePath": "boss/detail.js",
     "sourceFile": "boss/detail.js",
-    "navigateBefore": false
+    "navigateBefore": false,
+    "siteSession": "persistent",
+    "defaultWindowMode": "background"
   },
   {
     "site": "boss",
@@ -7090,7 +7091,7 @@
     "description": "BOSS直聘搜索职位（不带关键词时返回为你推荐职位）",
     "access": "read",
     "domain": "www.zhipin.com",
-    "strategy": "cookie",
+    "strategy": "intercept",
     "browser": true,
     "args": [
       {
@@ -7173,7 +7174,9 @@
     "type": "js",
     "modulePath": "boss/search.js",
     "sourceFile": "boss/search.js",
-    "navigateBefore": false
+    "navigateBefore": false,
+    "siteSession": "persistent",
+    "defaultWindowMode": "background"
   },
   {
     "site": "boss",
@@ -14575,7 +14578,7 @@
   {
     "site": "douyin",
     "name": "stats",
-    "description": "作品数据分析",
+    "description": "获取单个作品的创作者中心深层指标",
     "access": "read",
     "domain": "creator.douyin.com",
     "strategy": "cookie",
@@ -29058,6 +29061,62 @@
     "sourceFile": "notebooklm/write-note.js",
     "navigateBefore": false
   },
+  {
+    "site": "nowcoder",
+    "name": "article",
+    "description": "发布长文文章(实名长贴,支持 Markdown 正文与图片自动转存;高风险写操作,务必低频且内容有价值)",
+    "access": "write",
+    "domain": "www.nowcoder.com",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "title",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "文章标题(不超过 50 字)"
+      },
+      {
+        "name": "content",
+        "type": "str",
+        "required": false,
+        "positional": true,
+        "help": "正文(默认 Markdown,自动转 HTML;也可直接给 HTML)",
+        "fromFile": true,
+        "requiredUnlessFile": true
+      },
+      {
+        "name": "html",
+        "type": "boolean",
+        "required": false,
+        "help": "把正文按原始 HTML 处理,不做 Markdown 转换"
+      },
+      {
+        "name": "allow-duplicate",
+        "type": "boolean",
+        "required": false,
+        "help": "允许与自己已发文章同标题(默认拦截,防止重试导致重复发布)"
+      },
+      {
+        "name": "file",
+        "type": "str",
+        "required": false,
+        "help": "从本机文件读取content（UTF-8），与 <content> 二选一。长正文建议走文件：命令行上只剩短参数，不受 shell 引号 / 换行 / 编码影响",
+        "generatedFileFor": "content"
+      }
+    ],
+    "columns": [
+      "content_id",
+      "title",
+      "url",
+      "images_uploaded"
+    ],
+    "type": "js",
+    "modulePath": "nowcoder/article.js",
+    "sourceFile": "nowcoder/article.js",
+    "navigateBefore": "https://www.nowcoder.com"
+  },
   {
     "site": "nowcoder",
     "name": "comment",
@@ -29208,7 +29267,7 @@
   {
     "site": "nowcoder",
     "name": "delete",
-    "description": "删除自己发布的动态",
+    "description": "删除自己发布的动态或文章",
     "access": "write",
     "domain": "www.nowcoder.com",
     "strategy": "cookie",
@@ -29219,11 +29278,12 @@
         "type": "str",
         "required": true,
         "positional": true,
-        "help": "要删除的 momentId(my/post 返回的 moment_id)"
+        "help": "要删除的 id(动态取 my/post 的 moment_id,文章取 article 的 content_id)"
       }
     ],
     "columns": [
-      "moment_id",
+      "id",
+      "kind",
       "status"
     ],
     "type": "js",

package/clis/boss/__fixtures__/detail.html

@@ -0,0 +1,30 @@
+<!doctype html>
+<html>
+<head><title>供应链实习生_OpenCLI招聘-BOSS直聘</title></head>
+<body>
+<section class="job-primary">
+<div class="name"><h1 title="供应链实习生">供应链实习生</h1><span class="salary">180-230元/天</span></div>
+<p><a class="text-desc text-city" href="/shanghai/">上海</a><span class="text-desc text-experiece">5天/周 6个月</span><span class="text-desc text-degree">本科</span></p>
+<div class="tag-all job-tags"><span>五险一金</span><span>餐补</span></div>
+</section>
+<main class="job-detail">
+<section class="job-detail-section">
+<ul class="job-keyword-list"><li>供应链/物流类专业</li><li>采购/供应商管理经验</li></ul>
+<div class="job-sec-text">负责订单、仓储与采购协同，使用 Excel 制作供应链报表。</div>
+</section>
+<div class="job-boss-info">
+<h2 class="name">张女士<span class="boss-active-time">本周活跃</span></h2>
+<div class="boss-info-attr">OpenCLI<em class="vdot">·</em>供应链负责人</div>
+</div>
+<div class="detail-section-item company-address"><h3>工作地址</h3><div class="location-address">上海示例路 8 号</div><p>点击查看地图</p></div>
+</main>
+<aside class="job-sider">
+<p class="title">公司基本信息</p>
+<a href="/gongsi/example.html" title="OpenCLI">OpenCLI</a>
+<p>D轮及以上</p>
+<p>1000-9999人</p>
+<p><a href="/i101001/">互联网</a></p>
+<a class="look-all">查看全部职位</a>
+</aside>
+</body>
+</html>

package/clis/boss/detail.js

@@ -1 +1,12 @@
-import{cli as c,Strategy as d}from"@jackwener/opencli/registry";import{requirePage as l,navigateTo as m,bossFetch as p,verbose as b}from"./utils.js";c({site:"boss",name:"detail",access:"read",description:"BOSS直聘查看职位详情",domain:"www.zhipin.com",strategy:d.COOKIE,navigateBefore:!1,browser:!0,args:[{name:"security-id",positional:!0,required:!0,help:"Security ID from search results (securityId field)"}],columns:["name","salary","experience","degree","city","district","description","skills","welfare","boss_name","boss_title","active_time","company","industry","scale","stage","address","url"],func:async(a,r)=>{l(a);const o=r["security-id"];b("Fetching job detail...");await m(a,"https://www.zhipin.com/web/geek/job");const n=`https://www.zhipin.com/wapi/zpgeek/job/detail.json?securityId=${encodeURIComponent(o)}`,i=(await p(a,n)).zpData||{},e=i.jobInfo||{},s=i.bossInfo||{},t=i.brandComInfo||{};if(!e.jobName)throw Error("该职位信息不存在或已下架");return[{name:e.jobName||"",salary:e.salaryDesc||"",experience:e.experienceName||"",degree:e.degreeName||"",city:e.locationName||"",district:[e.areaDistrict,e.businessDistrict].filter(Boolean).join("·"),description:e.postDescription||"",skills:(e.showSkills||[]).join(", "),welfare:(t.labels||[]).join(", "),boss_name:s.name||"",boss_title:s.title||"",active_time:s.activeTimeDesc||"",company:t.brandName||s.brandName||"",industry:t.industryName||"",scale:t.scaleName||"",stage:t.stageName||"",address:e.address||"",url:e.encryptId?"https://www.zhipin.com/job_detail/"+e.encryptId+".html":""}]}});
+import{cli as A,Strategy as _}from"@jackwener/opencli/registry";import{ArgumentError as B,AuthRequiredError as q,CommandExecutionError as k}from"@jackwener/opencli/errors";import{readRequiredString as N,requirePage as C,navigateTo as j,verbose as v}from"./utils.js";const O="www.zhipin.com";function s(e){return String(e||"").replace(/\u00a0/g," ").replace(/[ \t]+\n/g,`
+`).replace(/\n[ \t]+/g,`
+`).replace(/\n{3,}/g,`
+
+`).trim()}function g(e,r){if(!e||typeof e!=="object"||!s(e.jobName))return null;const o=(n)=>[...new Set(n.map(s).filter(Boolean))],i=(n)=>s(n)||null;return{name:s(e.jobName),salary:s(e.salaryText),experience:s(e.experienceText),degree:s(e.degreeText),city:i(e.cityText),address:i(e.addressText),description:s(e.descriptionText),skills:o(Array.isArray(e.skillTexts)?e.skillTexts:[]).join(", "),welfare:o(Array.isArray(e.welfareTexts)?e.welfareTexts:[]).join(", "),boss_name:i(e.recruiterName),boss_title:i(e.recruiterTitle),active_time:i(e.recruiterActiveTime),company:s(e.companyName),industry:i(e.industryText),scale:i(e.scaleText),stage:i(e.stageText),url:`https://www.zhipin.com/job_detail/${r}.html`}}export function extractRenderedJob(){const e=(t,d=document)=>{const a=d.querySelector(t);return a?(a.innerText||a.textContent||"").trim():""},r=(t,d=document)=>Array.from(d.querySelectorAll(t)).map((a)=>(a.innerText||a.textContent||"").trim()).filter(Boolean),o=(t)=>{for(const d of t){const a=e(d);if(a)return a}return""},i=o([".job-primary .name h1",".job-primary h1","h1[title]"]),n=r(".job-primary .job-limit a, .job-primary .job-limit span, .job-primary p a, .job-primary p span"),c=Array.from(document.querySelectorAll('.job-sider a[href^="/gongsi/"], .detail-op a[href*="/gongsi/"]')).map((t)=>(t.getAttribute("title")||t.innerText||t.textContent||"").trim()).filter((t)=>t&&!/查看.*职位/.test(t)),T=document.title.match(/_([^_]+)招聘-BOSS直聘$/)?.[1]||"",u=c[0]||T,b=r('.job-sider p, .job-sider a[href^="/i"]').filter((t)=>t!=="公司基本信息"&&t!=="查看全部职位"),l=document.querySelector(".job-boss-info"),m=l?.querySelector("h2"),h=m?Array.from(m.childNodes).filter((t)=>t.nodeType===3).map((t)=>t.textContent.trim()).filter(Boolean).join(" "):"",y=l?(l.innerText||l.textContent||"").split(/\n|·/).map((t)=>t.trim()).filter(Boolean):[],f=m?e("span",m):y.find((t)=>/活跃|在线/.test(t))||"",x=h||y[0]||"",w=e(".boss-info-attr",l).split("·").map((t)=>t.trim()).filter(Boolean).findLast((t)=>t!==u)||y.findLast((t)=>t!==x&&t!==f&&t!==u)||"",p=document.querySelector(".company-address"),S=e(".location-address",p)||(p?(p.innerText||p.textContent||"").split(`
+`).map((t)=>t.trim()).filter((t)=>t&&t!=="工作地址"&&t!=="点击查看地图")[0]||"":"");return{jobName:i,salaryText:o([".job-primary .salary",".job-banner .salary",".job-primary .name + span"]),cityText:e(".job-primary .text-city")||n[0]||"",experienceText:e(".job-primary .text-experiece")||n[1]||"",degreeText:e(".job-primary .text-degree")||n[2]||"",descriptionText:o([".job-detail .job-detail-section .job-sec-text:not(.fold-text)",".job-detail .job-sec-text:not(.fold-text)",".job-sec-text:not(.fold-text)"]),skillTexts:r(".job-detail .job-keyword-list li, .job-keyword-list li"),welfareTexts:r(".job-banner .job-tags span, .job-primary .job-tags span"),recruiterName:x,recruiterTitle:w,recruiterActiveTime:f,companyName:u,industryText:b.find((t)=>!/人|融资|上市|轮/.test(t))||"",scaleText:b.find((t)=>/\d+.*人/.test(t))||"",stageText:b.find((t)=>/轮|融资|上市/.test(t))||"",addressText:S}}async function R(e,r){const o=await e.evaluate(extractRenderedJob);return g(o,r)}async function z(e,r){const o=`https://www.zhipin.com/job_detail/${encodeURIComponent(r)}.html`;await j(e,"https://www.zhipin.com/web/geek/jobs",2);for(let i=0;i<2;i++){await j(e,o,5);for(let n=0;n<5;n++){try{const c=await R(e,r);if(c?.name&&c?.description&&c?.company)return c}catch{}if(n<4)await e.wait(1)}}if(await E(e))throw new q(O,"BOSS redirected the job detail page to the login flow");throw new k("BOSS detail page did not expose a complete job posting")}async function E(e){try{return await e.evaluate(`
+            (() => {
+                const href = window.location.href || '';
+                if (/\\/login|\\/user\\/login|passport/.test(href)) return true;
+                return !!document.querySelector('.sign-form, .login-card, [class*="login-register"]');
+            })()
+        `)===!0}catch{return!1}}A({site:"boss",name:"detail",access:"read",description:"BOSS直聘查看职位详情",domain:"www.zhipin.com",strategy:_.UI,navigateBefore:!1,browser:!0,defaultWindowMode:"background",siteSession:"persistent",args:[{name:"security-id",positional:!0,required:!0,help:"Security ID from search results (security_id field)"}],columns:["name","salary","experience","degree","city","address","description","skills","welfare","boss_name","boss_title","active_time","company","industry","scale","stage","url"],func:async(e,r)=>{C(e);const o=N(r["security-id"],"security-id");if(!/^[A-Za-z0-9_-]+$/.test(o))throw new B("boss security-id contains unsupported characters","Pass the security_id returned by `opencli boss search`");v("Fetching job detail from the rendered BOSS page...");return[await z(e,o)]}});export const __test__={cleanText:s,domSnapshotToRow:g};

package/clis/boss/search.js

@@ -1 +1 @@
-import{cli as O,Strategy as T}from"@jackwener/opencli/registry";import{ArgumentError as E}from"@jackwener/opencli/errors";import{requirePage as D,navigateTo as x,bossFetch as v,verbose as l,CITY_CODES as d}from"./utils.js";const S={"不限":"0","在校/应届":"108","在校生":"108","在校":"108","应届生":"102","应届":"102","经验不限":"101","1年以内":"103","1-3年":"104","3-5年":"105","5-10年":"106","10年以上":"107"},A={"不限":"0","初中及以下":"209","中专/中技":"208","高中":"206","大专":"202","本科":"203","硕士":"204","博士":"205"},J={"不限":"0","3K以下":"401","3-5K":"402","5-10K":"403","10-15K":"404","15-20K":"405","20-30K":"406","30-50K":"407","50K以上":"408"},z={"不限":"0","互联网":"100020","电子商务":"100021","游戏":"100024","人工智能":"100901","大数据":"100902","金融":"100101","教育培训":"100200","医疗健康":"100300"},f={"不限":"0","全职":"1901","实习":"1902","兼职":"1903"},C=new Set(Object.values(f));function M(e){if(!e)return"101010100";if(/^\d+$/.test(e))return e;if(d[e])return d[e];for(const[r,s]of Object.entries(d))if(r.includes(e))return s;return"101010100"}function a(e,r){if(!e)return"";if(r[e]!==void 0)return r[e];for(const[s,i]of Object.entries(r))if(s.includes(e))return i;return e}function _(e){if(!e)return"";if(f[e]!==void 0)return f[e];if(C.has(e))return e;throw new E(`Invalid jobType: ${e}`,"Use one of: 全职, 兼职, 实习, 不限")}function P(e){if(e===!0)return"Y";if(e===!1)return"N";return""}O({site:"boss",name:"search",access:"read",description:"BOSS直聘搜索职位（不带关键词时返回为你推荐职位）",domain:"www.zhipin.com",strategy:T.COOKIE,navigateBefore:!1,browser:!0,args:[{name:"query",positional:!0,help:"Search keyword (optional, empty = recommended jobs)"},{name:"city",default:"北京",help:"City name or code (e.g. 杭州, 上海, 101010100)"},{name:"experience",default:"",help:"Experience: 在校生(实习)/应届生(校招)/经验不限/1年以内/1-3年/3-5年/5-10年/10年以上"},{name:"degree",default:"",help:"Degree: 大专/本科/硕士/博士"},{name:"salary",default:"",help:"Salary: 3K以下/3-5K/5-10K/10-15K/15-20K/20-30K/30-50K/50K以上"},{name:"industry",default:"",help:"Industry code or name (e.g. 100020, 互联网)"},{name:"jobType",default:"",help:"Job type: 全职/兼职/实习（不传=不限，混合校招与实习）"},{name:"page",type:"int",default:1,help:"Page number"},{name:"limit",type:"int",default:15,help:"Number of results"}],columns:["name","salary","company","area","experience","degree","skills","boss","bossOnline","security_id","url"],func:async(e,r)=>{D(e);const s=String(r.query??"").trim(),i=M(r.city);l("Navigating to set referrer context...");await x(e,`https://www.zhipin.com/web/geek/job?query=${encodeURIComponent(s)}&city=${i}`);await new Promise((n)=>setTimeout(n,1000));const m=a(r.experience,S),u=a(r.degree,A),y=a(r.salary,J),p=a(r.industry,z),b=_(r.jobType),h=r.limit||15;let c=r.page||1,o=[];const g=new Set;while(o.length<h){if(o.length>0)await new Promise((t)=>setTimeout(t,1000+Math.random()*2000));const n=new URLSearchParams({scene:"1",query:s,city:i,page:String(c),pageSize:"15"});if(m)n.set("experience",m);if(u)n.set("degree",u);if(y)n.set("salary",y);if(p)n.set("industry",p);if(b)n.set("jobType",b);const I=`https://www.zhipin.com/wapi/zpgeek/search/joblist.json?${n.toString()}`;l(`Fetching page ${c}... (current jobs: ${o.length})`);const j=(await v(e,I)).zpData||{},w=j.jobList||[];if(w.length===0)break;let K=0;for(const t of w){if(!t.encryptJobId||g.has(t.encryptJobId))continue;g.add(t.encryptJobId);o.push({name:t.jobName,salary:t.salaryDesc,company:t.brandName,area:[t.cityName,t.areaDistrict,t.businessDistrict].filter(Boolean).join("·"),experience:t.jobExperience,degree:t.jobDegree,skills:(t.skills||[]).join(","),boss:t.bossName+" · "+t.bossTitle,bossOnline:P(t.bossOnline),security_id:t.securityId||"",url:"https://www.zhipin.com/job_detail/"+t.encryptJobId+".html"});K++;if(o.length>=h)break}if(K===0){l(`API returned duplicate page, stopping pagination at ${o.length} items`);break}if(!j.hasMore)break;c++}return o}});export const __test__={EXP_MAP:S,resolveMap:a,resolveJobType:_,formatBossOnline:P};
+import{cli as T,Strategy as B}from"@jackwener/opencli/registry";import{ArgumentError as O,CommandExecutionError as P,EmptyResultError as D}from"@jackwener/opencli/errors";import{assertOk as v,readPositiveInteger as E,requirePage as A,navigateTo as x,verbose as u,CITY_CODES as p}from"./utils.js";const N={"不限":"0","在校/应届":"108","在校生(实习)":"108","在校生":"108","在校":"108","应届生(校招)":"102","应届生":"102","应届":"102","经验不限":"101","1年以内":"103","1-3年":"104","3-5年":"105","5-10年":"106","10年以上":"107"},J={"不限":"0","初中及以下":"209","中专/中技":"208","高中":"206","大专":"202","本科":"203","硕士":"204","博士":"205"},k={"不限":"0","3K以下":"401","3-5K":"402","5-10K":"403","10-15K":"404","15-20K":"405","20-30K":"406","30-50K":"407","50K以上":"408"},M={"不限":"0","互联网":"100020","电子商务":"100021","游戏":"100024","人工智能":"100901","大数据":"100902","金融":"100101","教育培训":"100200","医疗健康":"100300"},y={"不限":"0","全职":"1901","实习":"1902","兼职":"1903"},q=new Set(Object.values(y));function _(e){if(!e)return"101010100";if(/^\d+$/.test(e))return e;if(p[e])return p[e];for(const[r,o]of Object.entries(p))if(r.includes(e))return o;throw new O(`Invalid BOSS city: ${e}`,"Use a supported city name or a numeric BOSS city code")}function d(e,r){if(!e)return"";if(r[e]!==void 0)return r[e];for(const[o,c]of Object.entries(r))if(o.includes(e))return c;return e}function K(e){if(!e)return"";if(y[e]!==void 0)return y[e];if(q.has(e))return e;throw new O(`Invalid jobType: ${e}`,"Use one of: 全职, 兼职, 实习, 不限")}function C(e){if(e===!0)return"Y";if(e===!1)return"N";return""}async function z(e,r){if(typeof e.startNetworkCapture!=="function"||typeof e.readNetworkCapture!=="function"||!await e.startNetworkCapture("joblist.json"))throw new P("BOSS search requires CDP network capture");await e.readNetworkCapture();for(let o=0;o<2;o++){const c=r.includes("?")?"&":"?";await x(e,`${r}${c}_opencli=${Date.now()}`,5);await e.wait(1);const l=await e.readNetworkCapture();for(const s of Array.isArray(l)?l:[]){if(!String(s?.url||"").includes("joblist.json")||Number(s?.responseStatus||0)!==200||typeof s?.responsePreview!=="string")continue;let n;try{n=JSON.parse(s.responsePreview)}catch{continue}if(n&&typeof n==="object"&&"code"in n&&n.code!==0)v(n,"BOSS search failed");if(Array.isArray(n?.zpData?.jobList))return n}}throw new P("BOSS search page did not expose its job-list response")}T({site:"boss",name:"search",access:"read",description:"BOSS直聘搜索职位（不带关键词时返回为你推荐职位）",domain:"www.zhipin.com",strategy:B.INTERCEPT,navigateBefore:!1,browser:!0,defaultWindowMode:"background",siteSession:"persistent",args:[{name:"query",positional:!0,help:"Search keyword (optional, empty = recommended jobs)"},{name:"city",default:"北京",help:"City name or code (e.g. 杭州, 上海, 101010100)"},{name:"experience",default:"",help:"Experience: 在校生(实习)/应届生(校招)/经验不限/1年以内/1-3年/3-5年/5-10年/10年以上"},{name:"degree",default:"",help:"Degree: 大专/本科/硕士/博士"},{name:"salary",default:"",help:"Salary: 3K以下/3-5K/5-10K/10-15K/15-20K/20-30K/30-50K/50K以上"},{name:"industry",default:"",help:"Industry code or name (e.g. 100020, 互联网)"},{name:"jobType",default:"",help:"Job type: 全职/兼职/实习（不传=不限，混合校招与实习）"},{name:"page",type:"int",default:1,help:"Page number"},{name:"limit",type:"int",default:15,help:"Number of results"}],columns:["name","salary","company","area","experience","degree","skills","boss","bossOnline","security_id","url"],func:async(e,r)=>{A(e);const o=String(r.query??"").trim(),c=_(r.city);u("Navigating to set referrer context...");const l=d(r.experience,N),s=d(r.degree,J),n=d(r.salary,k),m=d(r.industry,M),b=K(r.jobType),h=E(r.limit,"limit",15,100);let f=E(r.page,"page",1),a=[];const w=new Set;while(a.length<h){if(a.length>0)await new Promise((t)=>setTimeout(t,1000+Math.random()*2000));const i=new URLSearchParams({query:o,city:c,page:String(f)});if(l)i.set("experience",l);if(s)i.set("degree",s);if(n)i.set("salary",n);if(m)i.set("industry",m);if(b)i.set("jobType",b);const I=`https://www.zhipin.com/web/geek/jobs?${i.toString()}`;u(`Capturing page ${f}... (current jobs: ${a.length})`);const S=(await z(e,I)).zpData||{},g=S.jobList||[];if(g.length===0)break;let j=0;for(const t of g){if(!t.encryptJobId||w.has(t.encryptJobId))continue;w.add(t.encryptJobId);a.push({name:t.jobName,salary:t.salaryDesc,company:t.brandName,area:[t.cityName,t.areaDistrict,t.businessDistrict].filter(Boolean).join("·"),experience:t.jobExperience,degree:t.jobDegree,skills:(t.skills||[]).join(","),boss:t.bossName+" · "+t.bossTitle,bossOnline:C(t.bossOnline),security_id:t.encryptJobId||"",url:"https://www.zhipin.com/job_detail/"+t.encryptJobId+".html"});j++;if(a.length>=h)break}if(j===0){u(`API returned duplicate page, stopping pagination at ${a.length} items`);break}if(!S.hasMore)break;f++}if(a.length===0)throw new D("boss search",o?`No BOSS jobs found for "${o}"`:"BOSS returned no recommended jobs");return a}});export const __test__={EXP_MAP:N,resolveCity:_,resolveMap:d,resolveJobType:K,formatBossOnline:C};

package/clis/douyin/stats.js

@@ -1 +1 @@
-import{cli as m,Strategy as d}from"@jackwener/opencli/registry";import{browserFetch as u}from"./_shared/browser-fetch.js";m({site:"douyin",name:"stats",access:"read",description:"作品数据分析",domain:"creator.douyin.com",strategy:d.COOKIE,args:[{name:"aweme_id",required:!0,positional:!0,help:"抖音作品 ID（aweme_id，可从作品 URL 末尾获取）"}],columns:["metric","value"],func:async(e,a)=>{const t=Math.floor(Date.now()/1000),o=t-604800,r="https://creator.douyin.com/janus/douyin/creator/data/item_analysis/metrics_trend",n={aweme_id:a.aweme_id,start_time:o,end_time:t,metrics:["play_count","like_count","comment_count","share_count"]},s=(await u(e,"POST",r,{body:n})).data??{};return Object.entries(s).map(([c,i])=>({metric:c,value:i}))}});
+import{cli as l,Strategy as w}from"@jackwener/opencli/registry";import{ArgumentError as p,EmptyResultError as m}from"@jackwener/opencli/errors";import{browserFetch as y}from"./_shared/browser-fetch.js";const _="https://creator.douyin.com/web/api/creator/item/list",g=50,b=50;export function normalizeAwemeId(t){const e=String(t??"").trim();if(!/^\d{16,20}$/.test(e))throw new p("douyin stats aweme_id must be a 16-20 digit numeric ID");return e}export function sameAwemeId(t,e){if(t==null)return!1;const r=String(t);if(r===e)return!0;return/^\d+$/.test(r)&&Number(r)===Number(e)}l({site:"douyin",name:"stats",access:"read",description:"获取单个作品的创作者中心深层指标",domain:"creator.douyin.com",strategy:w.COOKIE,args:[{name:"aweme_id",required:!0,positional:!0,help:"抖音作品 ID（aweme_id，可从作品 URL 末尾获取）"}],columns:["metric","value"],func:async(t,e)=>{const r=normalizeAwemeId(e.aweme_id);let n;for(let a=0;a<b;a++){const c=new URLSearchParams({count:String(g),order_by:"1",fields:"metrics,review,visibility",need_cooperation:"true",need_long_article:"true"});if(n!==void 0)c.set("max_cursor",String(n));const s=await y(t,"GET",`${_}?${c.toString()}`),u=(s.items??[]).find((i)=>sameAwemeId(i?.id,r));if(u){const i=u.metrics;if(!i||typeof i!=="object"||Array.isArray(i))throw new m(`douyin stats ${r}`,"The work exists, but creator metrics are unavailable");return Object.entries(i).map(([d,f])=>({metric:d,value:f}))}const o=s.max_cursor;if(!s.has_more||o===void 0||o===null||n!==void 0&&String(o)===String(n))break;n=o}throw new m(`douyin stats ${r}`,"The work was not found in the logged-in creator account")}});

package/clis/ke/auth.js

@@ -1,14 +1,16 @@
-import{AuthRequiredError as o,CommandExecutionError as a}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as s}from"../_shared/site-auth.js";async function i(e){return(await e.getCookies({url:"https://www.ke.com"})).some((t)=>t.name==="lianjia_token"&&t.value)}async function r(e){if(!await i(e))throw new o("ke.com","Ke lianjia_token cookie missing — anonymous");await e.goto("https://www.ke.com/");await e.wait(2);const n=await e.evaluate(`
+import{AuthRequiredError as o,CommandExecutionError as s}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as a}from"../_shared/site-auth.js";async function i(e){return(await e.getCookies({url:"https://www.ke.com"})).some((t)=>t.name==="lianjia_token"&&t.value)}async function r(e){if(!await i(e))throw new o("ke.com","Ke lianjia_token cookie missing — anonymous");await e.goto("https://www.ke.com/");await e.wait(2);const n=await e.evaluate(`
     (() => {
       const loginBtn = document.querySelector('.btn-login, a[class*=actLoginBtn], .login-btn');
       if (loginBtn && /登录|登陆/.test(loginBtn.innerText || '')) {
         return { kind: 'auth', detail: 'Ke shows 登录 button — anonymous session' };
       }
-      const el = document.querySelector('.userNick, .user-name, .myInfo a, [class*=userNick]');
+      // 2026-08 贝壳新版 SSR：用户名在 .typeShowUser（脱敏手机号如 15****93），
+      // 旧锚点 .userNick/.user-name/.myInfo 已下线，故把 .typeShowUser 提到最前。
+      const el = document.querySelector('.typeShowUser a span, .typeShowUser a, .userNick, .user-name, .myInfo a, [class*=userNick]');
       const username = (el?.innerText || '').trim();
       if (!username) {
         return { kind: 'auth', detail: 'Ke no user-name DOM anchor — anonymous or SSR failed' };
       }
       return { ok: true, username };
     })()
-  `);if(n?.kind==="auth")throw new o("ke.com",n.detail);if(!n?.ok)throw new a(`Unexpected Ke probe: ${JSON.stringify(n)}`);return{username:n.username}}s({site:"ke",domain:"ke.com",loginUrl:"https://clogin.ke.com/login/?service=https%3A%2F%2Fwww.ke.com",columns:["username"],verify:r,poll:async(e)=>{if(!await i(e))throw new o("ke.com","Waiting for Ke lianjia_token cookie");return r(e)}});
+  `);if(n?.kind==="auth")throw new o("ke.com",n.detail);if(!n?.ok)throw new s(`Unexpected Ke probe: ${JSON.stringify(n)}`);return{username:n.username}}a({site:"ke",domain:"ke.com",loginUrl:"https://clogin.ke.com/login/?service=https%3A%2F%2Fwww.ke.com",columns:["username"],verify:r,poll:async(e)=>{if(!await i(e))throw new o("ke.com","Waiting for Ke lianjia_token cookie");return r(e)}});

package/clis/nowcoder/article.js

@@ -0,0 +1,5 @@
+import{cli as E,Strategy as S}from"@jackwener/opencli/registry";import{ArgumentError as i,CommandExecutionError as c}from"@jackwener/opencli/errors";import{GW_BASE as _,WWW_BASE as r,getJson as M,postJson as q,postMultipart as T,requireOk as m}from"./utils.js";import{assertLiteralContent as y}from"../_shared/content-guard.js";import{normalizeContent as A}from"../_shared/article/format.js";import{inlineLocalImages as C,transferImages as j}from"../_shared/article/images.js";const w={Accept:"application/json, text/plain, */*","X-Requested-With":"XMLHttpRequest"},L={url:`${r}/uploadImage?type=1`,method:"POST",bodyType:"binary-multipart",fileField:"file",fileName:"image.png",headers:w,responsePath:"url"},P=["uploadfiles.nowcoder.com"],g=50;function D(e){return String(e).replace(/<br\s*\/?>/gi,`
+`).replace(/<\/(?:p|h[1-6]|li|blockquote|div)>/gi,`
+`).replace(/<[^>]+>/g,"").replace(/&nbsp;/g," ").replace(/&lt;/g,"<").replace(/&gt;/g,">").replace(/&quot;/g,'"').replace(/&#39;/g,"'").replace(/&amp;/g,"&").split(`
+`).map((n)=>n.trim()).filter(Boolean)}function H(e,n){const t=D(n);return JSON.stringify({editorChildren:t.map((a)=>({type:"paragraph",children:[{text:a}]})),toolData:{title:e,content:t.join(`
+`),type:0,subjectIds:[]}})}E({site:"nowcoder",name:"article",access:"write",description:"发布长文文章(实名长贴,支持 Markdown 正文与图片自动转存;高风险写操作,务必低频且内容有价值)",domain:"www.nowcoder.com",strategy:S.COOKIE,args:[{name:"title",positional:!0,required:!0,help:`文章标题(不超过 ${g} 字)`},{name:"content",fromFile:!0,positional:!0,required:!0,help:"正文(默认 Markdown,自动转 HTML;也可直接给 HTML)"},{name:"html",type:"boolean",help:"把正文按原始 HTML 处理,不做 Markdown 转换"},{name:"allow-duplicate",type:"boolean",help:"允许与自己已发文章同标题(默认拦截,防止重试导致重复发布)"}],columns:["content_id","title","url","images_uploaded"],func:async(e,n)=>{const t=String(n.title??"").trim();y(t,{label:"标题"});if(!t)throw new i("文章标题不能为空");if([...t].length>g)throw new i(`文章标题超长: ${[...t].length} 字,牛客上限 ${g} 字`);const a=y(n.content,{label:"正文"});if(!a)throw new i("文章正文不能为空");const p=await C(a);if(p.missing.length){const s=p.missing.map((o)=>`${o.src}(${o.error})`).join("、");throw new i(`正文引用的本机图片读不到: ${s}`)}const{html:f}=A(p.content,{format:n.html?"html":"auto"});if(!f.trim())throw new i("正文转换后为空");const l=await j(e,f,{spec:L,skip:P});if(l.failed?.length){const s=l.failed.map((o)=>`${o.src}(${o.error??"上传失败"})`).join("、");throw new c(`图片转存牛客图床失败,已中止发布(未产生任何内容,可修好图片后重试): ${s}`)}const d=l.content;if(n["allow-duplicate"]!==!0){const b=(m(await M(e,`${r}/content/my-content?status=-1&page=1&_=${Date.now()}`),"我的内容列表").data?.tableData??[]).find((I)=>String(I.title??"").trim()===t);if(b)throw new c(`牛客上已有同标题的文章(${r}/discuss/${b.id}),已中止发布。`+"若上一次发布其实已成功,请不要重试;确需再发一篇同名文章加 --allow-duplicate。")}if(m(await T(e,`${r}/discuss/check/same?_=${Date.now()}`,{id:"",title:t,content:d,subjectIds:""},w),"长文查重").data===!0)throw new c("牛客站内已存在标题与正文都相同的内容,已中止发布(若上一次发布其实已成功,请勿重试;确需再发请修改内容)");const h=m(await q(e,`${_}/long-content/create?_=${Date.now()}`,{subjectIds:[],zhuanlanIdStr:"",askQuestion:!1,reward:"",tags:[],title:t,content:d,questionId:null,questionTitle:null,questionUrl:null,blogTags:[],isAcm:!1,distinctPost:!1,jsonContent:H(t,d),id:"",mdContent:"",anonymous:!1,publicEntrance:"发帖子",publicEntrancePage:"直接访问"},w),"长文发布"),u=h.data?.result;if(!u)throw new c(`牛客长文发布响应缺少 contentId: ${JSON.stringify(h).slice(0,200)}`);return[{content_id:String(u),title:t,url:`${r}/discuss/${u}`,images_uploaded:(l.uploaded??[]).length}]}});

package/clis/nowcoder/delete.js

@@ -1 +1 @@
-import{cli as m,Strategy as i}from"@jackwener/opencli/registry";import{GW_BASE as r,postMultipart as n,requireOk as d,resolveMomentId as s}from"./utils.js";m({site:"nowcoder",name:"delete",access:"write",description:"删除自己发布的动态",domain:"www.nowcoder.com",strategy:i.COOKIE,args:[{name:"id",positional:!0,required:!0,help:"要删除的 momentId(my/post 返回的 moment_id)"}],columns:["moment_id","status"],func:async(e,o)=>{const t=await s(e,o.id);d(await n(e,`${r}/moment/delete`,{isWeb:"true",momentId:t}),"删帖");return[{moment_id:t,status:"deleted"}]}});
+import{cli as u,Strategy as w}from"@jackwener/opencli/registry";import{GW_BASE as o,postMultipart as s,requireOk as a,resolveMomentId as p}from"./utils.js";const y={Accept:"application/json, text/plain, */*","X-Requested-With":"XMLHttpRequest"};u({site:"nowcoder",name:"delete",access:"write",description:"删除自己发布的动态或文章",domain:"www.nowcoder.com",strategy:w.COOKIE,args:[{name:"id",positional:!0,required:!0,help:"要删除的 id(动态取 my/post 的 moment_id,文章取 article 的 content_id)"}],columns:["id","kind","status"],func:async(r,c)=>{const t=String(c.id??"").trim(),d=/^\d{17,}$/.test(t),n=async()=>{const e=await p(r,t);a(await s(r,`${o}/moment/delete`,{isWeb:"true",momentId:e}),"删除动态");return[{id:e,kind:"moment",status:"deleted"}]},i=async()=>{a(await s(r,`${o}/long-content/delete?_=${Date.now()}`,{id:t},y),"删除文章");return[{id:t,kind:"article",status:"deleted"}]},[m,l]=d?[i,n]:[n,i];try{return await m()}catch(e){try{return await l()}catch{throw e}}}});

package/clis/nowcoder/utils.js

@@ -1,6 +1,6 @@
-import{AuthRequiredError as i,CommandExecutionError as c}from"@jackwener/opencli/errors";export const GW_BASE="https://gw-c.nowcoder.com/api/sparta",WWW_BASE="https://www.nowcoder.com";export async function getJson(t,e){const r=JSON.stringify(e);return t.evaluate(`
+import{AuthRequiredError as a,CommandExecutionError as i}from"@jackwener/opencli/errors";export const GW_BASE="https://gw-c.nowcoder.com/api/sparta",WWW_BASE="https://www.nowcoder.com";export async function getJson(t,e){const s=JSON.stringify(e);return t.evaluate(`
     async () => {
-      const res = await fetch(${r}, { credentials: 'include' });
+      const res = await fetch(${s}, { credentials: 'include' });
       const text = await res.text();
       try {
         return JSON.parse(text);
@@ -8,13 +8,13 @@ import{AuthRequiredError as i,CommandExecutionError as c}from"@jackwener/opencli
         return { code: -1, msg: '非 JSON 响应 (HTTP ' + res.status + '): ' + text.slice(0, 200) };
       }
     }
-  `)}export async function postJson(t,e,r){const s=JSON.stringify(e),n=JSON.stringify(JSON.stringify(r));return t.evaluate(`
+  `)}export async function postJson(t,e,s,r={}){const n=JSON.stringify(e),o=JSON.stringify(JSON.stringify(s)),c=JSON.stringify({"Content-Type":"application/json",...r});return t.evaluate(`
     async () => {
-      const res = await fetch(${s}, {
+      const res = await fetch(${n}, {
         method: 'POST',
         credentials: 'include',
-        headers: { 'Content-Type': 'application/json' },
-        body: ${n},
+        headers: ${c},
+        body: ${o},
       });
       const text = await res.text();
       try {
@@ -23,10 +23,10 @@ import{AuthRequiredError as i,CommandExecutionError as c}from"@jackwener/opencli
         return { code: -1, msg: '非 JSON 响应 (HTTP ' + res.status + '): ' + text.slice(0, 200) };
       }
     }
-  `)}export async function postForm(t,e,r){const s=JSON.stringify(e),n=JSON.stringify(r);return t.evaluate(`
+  `)}export async function postForm(t,e,s){const r=JSON.stringify(e),n=JSON.stringify(s);return t.evaluate(`
     async () => {
       const body = new URLSearchParams(${n});
-      const res = await fetch(${s}, {
+      const res = await fetch(${r}, {
         method: 'POST',
         credentials: 'include',
         headers: {
@@ -42,13 +42,14 @@ import{AuthRequiredError as i,CommandExecutionError as c}from"@jackwener/opencli
         return { code: -1, msg: '非 JSON 响应 (HTTP ' + res.status + '): ' + text.slice(0, 200) };
       }
     }
-  `)}export async function postMultipart(t,e,r){const s=JSON.stringify(e),n=JSON.stringify(r);return t.evaluate(`
+  `)}export async function postMultipart(t,e,s,r={}){const n=JSON.stringify(e),o=JSON.stringify(s),c=JSON.stringify(r);return t.evaluate(`
     async () => {
       const fd = new FormData();
-      for (const [k, v] of Object.entries(${n})) fd.append(k, v);
-      const res = await fetch(${s}, {
+      for (const [k, v] of Object.entries(${o})) fd.append(k, v);
+      const res = await fetch(${n}, {
         method: 'POST',
         credentials: 'include',
+        headers: ${c},
         body: fd,
       });
       const text = await res.text();
@@ -58,11 +59,11 @@ import{AuthRequiredError as i,CommandExecutionError as c}from"@jackwener/opencli
         return { code: -1, msg: '非 JSON 响应 (HTTP ' + res.status + '): ' + text.slice(0, 200) };
       }
     }
-  `)}export function requireOk(t,e){if(!t||typeof t!=="object"||Array.isArray(t))throw new c(`牛客 ${e} 接口返回了畸形响应`);if(Object.hasOwn(t,"success")?!!t.success:Object.hasOwn(t,"code")?t.code===0:Object.hasOwn(t,"data"))return t;const s=String(t.msg??t.message??"未知错误");if(/登录|登陆|未授权|token|身份/i.test(s))throw new i("nowcoder.com",`牛客 ${e} 需要登录: ${s}`);throw new c(`牛客 ${e} 失败: ${s} (code=${t.code??"?"})`)}export async function resolveMomentId(t,e){let r=String(e??"").trim();for(const a of[/detail\/([0-9a-fA-F]{20,})/,/discuss\/(\d+)/]){const o=r.match(a);if(o){r=o[1];break}}if(/^\d+$/.test(r))return r;if(!/^[0-9a-fA-F]{20,}$/.test(r))throw new c(`无法从输入解析牛客帖子 id: ${e}`);const n=requireOk(await getJson(t,`${GW_BASE}/detail/moment-data/detail/${r}`),"帖子解析").data?.id;if(!n)throw new c(`牛客帖子 ${r} 的详情缺少数字 momentId`);return String(n)}export async function getSelfUid(t){const e=await t.evaluate(`
+  `)}export function requireOk(t,e){if(!t||typeof t!=="object"||Array.isArray(t))throw new i(`牛客 ${e} 接口返回了畸形响应`);if(Object.hasOwn(t,"success")?!!t.success:Object.hasOwn(t,"code")?t.code===0:Object.hasOwn(t,"data"))return t;const r=String(t.msg??t.message??"未知错误");if(/登录|登陆|未授权|token|身份/i.test(r))throw new a("nowcoder.com",`牛客 ${e} 需要登录: ${r}`);throw new i(`牛客 ${e} 失败: ${r} (code=${t.code??"?"})`)}export async function resolveMomentId(t,e){let s=String(e??"").trim();for(const o of[/detail\/([0-9a-fA-F]{20,})/,/discuss\/(\d+)/]){const c=s.match(o);if(c){s=c[1];break}}if(/^\d+$/.test(s))return s;if(!/^[0-9a-fA-F]{20,}$/.test(s))throw new i(`无法从输入解析牛客帖子 id: ${e}`);const n=requireOk(await getJson(t,`${GW_BASE}/detail/moment-data/detail/${s}`),"帖子解析").data?.id;if(!n)throw new i(`牛客帖子 ${s} 的详情缺少数字 momentId`);return String(n)}export async function getSelfUid(t){const e=await t.evaluate(`
     async () => {
       const link = document.querySelector('a[href*="/users/"]');
       const href = link ? (link.getAttribute('href') || '') : '';
       const match = href.match(/\\/users\\/(\\d+)/);
       return match ? match[1] : '';
     }
-  `);if(!e)throw new i("nowcoder.com","导航栏无登录用户链接(未登录)");return e}
+  `);if(!e)throw new a("nowcoder.com","导航栏无登录用户链接(未登录)");return e}

package/clis/spotify/spotify.js

@@ -1 +1 @@
-import{cli as i,Strategy as c}from"@jackwener/opencli/registry";import{CliError as u}from"@jackwener/opencli/errors";import{readFileSync as g,writeFileSync as E,mkdirSync as I,existsSync as R}from"fs";import{createServer as C}from"http";import{homedir as m}from"os";import{join as y}from"path";import{exec as v}from"child_process";import{assertSpotifyCredentialsConfigured as L,getFirstSpotifyTrack as x,mapSpotifyTrackResults as A,parseDotEnv as q,resolveSpotifyCredentials as B}from"./utils.js";const d=y(m(),".ppcli","spotify.env");function O(){if(!R(d))return{};return q(g(d,"utf-8"))}const N=O(),h=B(N),w=h.clientId,_=h.clientSecret,T="http://127.0.0.1:8888/callback",D=["user-read-playback-state","user-modify-playback-state","user-read-currently-playing","playlist-read-private"].join(" "),S=y(m(),".ppcli","spotify-tokens.json");function F(){try{return JSON.parse(g(S,"utf-8"))}catch{return null}}function U(t){I(y(m(),".ppcli"),{recursive:!0});E(S,JSON.stringify(t,null,2))}async function M(t){const e=await fetch("https://accounts.spotify.com/api/token",{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded",Authorization:"Basic "+Buffer.from(`${w}:${_}`).toString("base64")},body:new URLSearchParams({grant_type:"refresh_token",refresh_token:t})});if(!e.ok){const r=await e.json().catch(()=>({}));throw new u("REFRESH_FAILED",r?.error_description||`Token refresh failed (${e.status})`)}const s=await e.json(),a={access_token:s.access_token,refresh_token:s.refresh_token||t,expires_at:Date.now()+s.expires_in*1000};U(a);return a.access_token}async function j(){const t=F();if(!t)throw new u("AUTH_REQUIRED","Not authenticated. Run: ppcli spotify auth");if(!t.access_token||!t.refresh_token||!(t.expires_at>0))throw new u("AUTH_CORRUPTED","Token file is corrupted. Run: ppcli spotify auth");if(Date.now()>t.expires_at-60000)return M(t.refresh_token);return t.access_token}async function o(t,e,s){const a=await j(),r=await fetch(`https://api.spotify.com/v1${e}`,{method:t,headers:{Authorization:`Bearer ${a}`,"Content-Type":"application/json"},body:s?JSON.stringify(s):void 0});if(r.status===204||r.status===202)return null;if(!r.ok){const n=await r.json().catch(()=>({}));throw new u("API_ERROR",n?.error?.message||`Spotify API error ${r.status}`)}return r.json()}async function P(t){const e=await o("GET",`/search?q=${encodeURIComponent(t)}&type=track&limit=1`),s=x(e);if(!s)throw new u("EMPTY_RESULT",`No track found for: ${t}`);return s}function H(t){const e=process.platform==="win32"?`start "" "${t}"`:process.platform==="darwin"?`open "${t}"`:`xdg-open "${t}"`;v(e)}i({site:"spotify",name:"auth",access:"write",description:"Authenticate with Spotify (OAuth — run once)",strategy:c.PUBLIC,browser:!1,args:[],columns:["status"],func:async()=>{L(h,d);return new Promise((t,e)=>{const s=C(async(r,n)=>{try{const p=new URL(r.url,"http://localhost:8888");if(p.pathname!=="/callback"){n.end();return}const k=p.searchParams.get("code");if(!k){n.end("Missing code");return}const l=await fetch("https://accounts.spotify.com/api/token",{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded",Authorization:"Basic "+Buffer.from(`${w}:${_}`).toString("base64")},body:new URLSearchParams({grant_type:"authorization_code",code:k,redirect_uri:T})});if(!l.ok){const b=await l.json().catch(()=>({}));s.close();e(new u("AUTH_FAILED",b?.error_description||`Token exchange failed (${l.status})`));return}const f=await l.json();U({access_token:f.access_token,refresh_token:f.refresh_token,expires_at:Date.now()+f.expires_in*1000});n.writeHead(200,{"Content-Type":"text/html"});n.end("<h2>Spotify authenticated! You can close this tab.</h2>");s.close();t([{status:"Authenticated successfully"}])}catch(p){s.close();e(p)}});s.on("error",(r)=>{if(r.code==="EADDRINUSE")e(new u("PORT_IN_USE","Port 8888 is already in use. Stop the other process and retry."));else e(r)});const a=setTimeout(()=>{s.close();e(new u("AUTH_TIMEOUT","Authentication timed out after 5 minutes"))},300000);s.listen(8888,()=>{const r=`https://accounts.spotify.com/authorize?${new URLSearchParams({client_id:w,response_type:"code",redirect_uri:T,scope:D})}`;console.log("Opening browser for Spotify login...");console.log("If it does not open, visit:",r);H(r)});s.on("close",()=>clearTimeout(a))})}});i({site:"spotify",name:"status",access:"read",description:"Show current playback status",strategy:c.PUBLIC,browser:!1,args:[],columns:["track","artist","album","status","progress"],func:async()=>{const t=await o("GET","/me/player");if(!t||!t.item)return[{track:"Nothing playing",artist:"",album:"",status:"",progress:""}];const e=t.item;if(e.type!=="track")return[{track:e.name,artist:"",album:e.show?.name??"",status:t.is_playing?"playing":"paused",progress:""}];const s=(t.progress_ms??0)/1000|0,a=e.duration_ms/1000|0,r=(n)=>`${n/60|0}:${String(n%60).padStart(2,"0")}`;return[{track:e.name,artist:e.artists.map((n)=>n.name).join(", "),album:e.album.name,status:t.is_playing?"playing":"paused",progress:`${r(s)} / ${r(a)}`}]}});i({site:"spotify",name:"play",access:"write",description:"Resume playback or search and play a track/artist",strategy:c.PUBLIC,browser:!1,args:[{name:"query",type:"str",default:"",positional:!0,help:"Track or artist to play (optional)"}],columns:["track","artist","status"],func:async(t)=>{if(t.query){const{uri:e,name:s,artist:a}=await P(t.query);await o("PUT","/me/player/play",{uris:[e]});return[{track:s,artist:a,status:"playing"}]}await o("PUT","/me/player/play");return[{track:"",artist:"",status:"resumed"}]}});i({site:"spotify",name:"pause",access:"write",description:"Pause playback",strategy:c.PUBLIC,browser:!1,args:[],columns:["status"],func:async()=>{await o("PUT","/me/player/pause");return[{status:"paused"}]}});i({site:"spotify",name:"next",access:"write",description:"Skip to next track",strategy:c.PUBLIC,browser:!1,args:[],columns:["status"],func:async()=>{await o("POST","/me/player/next");return[{status:"skipped to next"}]}});i({site:"spotify",name:"prev",access:"write",description:"Skip to previous track",strategy:c.PUBLIC,browser:!1,args:[],columns:["status"],func:async()=>{await o("POST","/me/player/previous");return[{status:"skipped to previous"}]}});i({site:"spotify",name:"volume",access:"write",description:"Set playback volume (0-100)",strategy:c.PUBLIC,browser:!1,args:[{name:"level",type:"int",default:50,positional:!0,required:!0,help:"Volume 0–100"}],columns:["volume"],func:async(t)=>{const e=Math.round(t.level);if(e<0||e>100)throw new u("INVALID_ARGS","Volume must be between 0 and 100");await o("PUT",`/me/player/volume?volume_percent=${e}`);return[{volume:`${e}%`}]}});i({site:"spotify",name:"search",access:"read",description:"Search for tracks",strategy:c.PUBLIC,browser:!1,args:[{name:"query",type:"str",required:!0,positional:!0,help:"Search query"},{name:"limit",type:"int",default:10,help:"Number of results (default: 10)"}],columns:["track","artist","album","uri"],func:async(t)=>{const e=Math.min(50,Math.max(1,Math.round(t.limit))),s=await o("GET",`/search?q=${encodeURIComponent(t.query)}&type=track&limit=${e}`),a=A(s);if(!a.length)throw new u("EMPTY_RESULT",`No results found for: ${t.query}`);return a}});i({site:"spotify",name:"queue",access:"write",description:"Add a track to the playback queue",strategy:c.PUBLIC,browser:!1,args:[{name:"query",type:"str",required:!0,positional:!0,help:"Track to add to queue"}],columns:["track","artist","status"],func:async(t)=>{const{uri:e,name:s,artist:a}=await P(t.query);await o("POST",`/me/player/queue?uri=${encodeURIComponent(e)}`);return[{track:s,artist:a,status:"added to queue"}]}});i({site:"spotify",name:"shuffle",access:"write",description:"Toggle shuffle on/off",strategy:c.PUBLIC,browser:!1,args:[{name:"state",type:"str",default:"on",positional:!0,choices:["on","off"],help:"on or off"}],columns:["shuffle"],func:async(t)=>{await o("PUT",`/me/player/shuffle?state=${t.state==="on"}`);return[{shuffle:t.state}]}});i({site:"spotify",name:"repeat",access:"write",description:"Set repeat mode (off / track / context)",strategy:c.PUBLIC,browser:!1,args:[{name:"mode",type:"str",default:"context",positional:!0,choices:["off","track","context"],help:"off / track / context"}],columns:["repeat"],func:async(t)=>{await o("PUT",`/me/player/repeat?state=${t.mode}`);return[{repeat:t.mode}]}});
+import{cli as i,Strategy as c}from"@jackwener/opencli/registry";import{CliError as u}from"@jackwener/opencli/errors";import{readFileSync as _,writeFileSync as I,mkdirSync as R,existsSync as C}from"fs";import{createServer as v}from"http";import{homedir as m}from"os";import{join as y}from"path";import{execFile as d}from"child_process";import{assertSpotifyCredentialsConfigured as L,getFirstSpotifyTrack as x,mapSpotifyTrackResults as A,parseDotEnv as q,resolveSpotifyCredentials as B}from"./utils.js";const h=y(m(),".ppcli","spotify.env");function O(){if(!C(h))return{};return q(_(h,"utf-8"))}const N=O(),w=B(N),k=w.clientId,T=w.clientSecret,S="http://127.0.0.1:8888/callback",D=["user-read-playback-state","user-modify-playback-state","user-read-currently-playing","playlist-read-private"].join(" "),U=y(m(),".ppcli","spotify-tokens.json");function F(){try{return JSON.parse(_(U,"utf-8"))}catch{return null}}function P(t){R(y(m(),".ppcli"),{recursive:!0});I(U,JSON.stringify(t,null,2))}async function M(t){const e=await fetch("https://accounts.spotify.com/api/token",{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded",Authorization:"Basic "+Buffer.from(`${k}:${T}`).toString("base64")},body:new URLSearchParams({grant_type:"refresh_token",refresh_token:t})});if(!e.ok){const r=await e.json().catch(()=>({}));throw new u("REFRESH_FAILED",r?.error_description||`Token refresh failed (${e.status})`)}const s=await e.json(),a={access_token:s.access_token,refresh_token:s.refresh_token||t,expires_at:Date.now()+s.expires_in*1000};P(a);return a.access_token}async function j(){const t=F();if(!t)throw new u("AUTH_REQUIRED","Not authenticated. Run: ppcli spotify auth");if(!t.access_token||!t.refresh_token||!(t.expires_at>0))throw new u("AUTH_CORRUPTED","Token file is corrupted. Run: ppcli spotify auth");if(Date.now()>t.expires_at-60000)return M(t.refresh_token);return t.access_token}async function o(t,e,s){const a=await j(),r=await fetch(`https://api.spotify.com/v1${e}`,{method:t,headers:{Authorization:`Bearer ${a}`,"Content-Type":"application/json"},body:s?JSON.stringify(s):void 0});if(r.status===204||r.status===202)return null;if(!r.ok){const n=await r.json().catch(()=>({}));throw new u("API_ERROR",n?.error?.message||`Spotify API error ${r.status}`)}return r.json()}async function b(t){const e=await o("GET",`/search?q=${encodeURIComponent(t)}&type=track&limit=1`),s=x(e);if(!s)throw new u("EMPTY_RESULT",`No track found for: ${t}`);return s}function H(t){if(process.platform==="win32")d("cmd",["/c","start","",t]);else if(process.platform==="darwin")d("open",[t]);else d("xdg-open",[t])}i({site:"spotify",name:"auth",access:"write",description:"Authenticate with Spotify (OAuth — run once)",strategy:c.PUBLIC,browser:!1,args:[],columns:["status"],func:async()=>{L(w,h);return new Promise((t,e)=>{const s=v(async(r,n)=>{try{const p=new URL(r.url,"http://localhost:8888");if(p.pathname!=="/callback"){n.end();return}const g=p.searchParams.get("code");if(!g){n.end("Missing code");return}const l=await fetch("https://accounts.spotify.com/api/token",{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded",Authorization:"Basic "+Buffer.from(`${k}:${T}`).toString("base64")},body:new URLSearchParams({grant_type:"authorization_code",code:g,redirect_uri:S})});if(!l.ok){const E=await l.json().catch(()=>({}));s.close();e(new u("AUTH_FAILED",E?.error_description||`Token exchange failed (${l.status})`));return}const f=await l.json();P({access_token:f.access_token,refresh_token:f.refresh_token,expires_at:Date.now()+f.expires_in*1000});n.writeHead(200,{"Content-Type":"text/html"});n.end("<h2>Spotify authenticated! You can close this tab.</h2>");s.close();t([{status:"Authenticated successfully"}])}catch(p){s.close();e(p)}});s.on("error",(r)=>{if(r.code==="EADDRINUSE")e(new u("PORT_IN_USE","Port 8888 is already in use. Stop the other process and retry."));else e(r)});const a=setTimeout(()=>{s.close();e(new u("AUTH_TIMEOUT","Authentication timed out after 5 minutes"))},300000);s.listen(8888,()=>{const r=`https://accounts.spotify.com/authorize?${new URLSearchParams({client_id:k,response_type:"code",redirect_uri:S,scope:D})}`;console.log("Opening browser for Spotify login...");console.log("If it does not open, visit:",r);H(r)});s.on("close",()=>clearTimeout(a))})}});i({site:"spotify",name:"status",access:"read",description:"Show current playback status",strategy:c.PUBLIC,browser:!1,args:[],columns:["track","artist","album","status","progress"],func:async()=>{const t=await o("GET","/me/player");if(!t||!t.item)return[{track:"Nothing playing",artist:"",album:"",status:"",progress:""}];const e=t.item;if(e.type!=="track")return[{track:e.name,artist:"",album:e.show?.name??"",status:t.is_playing?"playing":"paused",progress:""}];const s=(t.progress_ms??0)/1000|0,a=e.duration_ms/1000|0,r=(n)=>`${n/60|0}:${String(n%60).padStart(2,"0")}`;return[{track:e.name,artist:e.artists.map((n)=>n.name).join(", "),album:e.album.name,status:t.is_playing?"playing":"paused",progress:`${r(s)} / ${r(a)}`}]}});i({site:"spotify",name:"play",access:"write",description:"Resume playback or search and play a track/artist",strategy:c.PUBLIC,browser:!1,args:[{name:"query",type:"str",default:"",positional:!0,help:"Track or artist to play (optional)"}],columns:["track","artist","status"],func:async(t)=>{if(t.query){const{uri:e,name:s,artist:a}=await b(t.query);await o("PUT","/me/player/play",{uris:[e]});return[{track:s,artist:a,status:"playing"}]}await o("PUT","/me/player/play");return[{track:"",artist:"",status:"resumed"}]}});i({site:"spotify",name:"pause",access:"write",description:"Pause playback",strategy:c.PUBLIC,browser:!1,args:[],columns:["status"],func:async()=>{await o("PUT","/me/player/pause");return[{status:"paused"}]}});i({site:"spotify",name:"next",access:"write",description:"Skip to next track",strategy:c.PUBLIC,browser:!1,args:[],columns:["status"],func:async()=>{await o("POST","/me/player/next");return[{status:"skipped to next"}]}});i({site:"spotify",name:"prev",access:"write",description:"Skip to previous track",strategy:c.PUBLIC,browser:!1,args:[],columns:["status"],func:async()=>{await o("POST","/me/player/previous");return[{status:"skipped to previous"}]}});i({site:"spotify",name:"volume",access:"write",description:"Set playback volume (0-100)",strategy:c.PUBLIC,browser:!1,args:[{name:"level",type:"int",default:50,positional:!0,required:!0,help:"Volume 0–100"}],columns:["volume"],func:async(t)=>{const e=Math.round(t.level);if(e<0||e>100)throw new u("INVALID_ARGS","Volume must be between 0 and 100");await o("PUT",`/me/player/volume?volume_percent=${e}`);return[{volume:`${e}%`}]}});i({site:"spotify",name:"search",access:"read",description:"Search for tracks",strategy:c.PUBLIC,browser:!1,args:[{name:"query",type:"str",required:!0,positional:!0,help:"Search query"},{name:"limit",type:"int",default:10,help:"Number of results (default: 10)"}],columns:["track","artist","album","uri"],func:async(t)=>{const e=Math.min(50,Math.max(1,Math.round(t.limit))),s=await o("GET",`/search?q=${encodeURIComponent(t.query)}&type=track&limit=${e}`),a=A(s);if(!a.length)throw new u("EMPTY_RESULT",`No results found for: ${t.query}`);return a}});i({site:"spotify",name:"queue",access:"write",description:"Add a track to the playback queue",strategy:c.PUBLIC,browser:!1,args:[{name:"query",type:"str",required:!0,positional:!0,help:"Track to add to queue"}],columns:["track","artist","status"],func:async(t)=>{const{uri:e,name:s,artist:a}=await b(t.query);await o("POST",`/me/player/queue?uri=${encodeURIComponent(e)}`);return[{track:s,artist:a,status:"added to queue"}]}});i({site:"spotify",name:"shuffle",access:"write",description:"Toggle shuffle on/off",strategy:c.PUBLIC,browser:!1,args:[{name:"state",type:"str",default:"on",positional:!0,choices:["on","off"],help:"on or off"}],columns:["shuffle"],func:async(t)=>{await o("PUT",`/me/player/shuffle?state=${t.state==="on"}`);return[{shuffle:t.state}]}});i({site:"spotify",name:"repeat",access:"write",description:"Set repeat mode (off / track / context)",strategy:c.PUBLIC,browser:!1,args:[{name:"mode",type:"str",default:"context",positional:!0,choices:["off","track","context"],help:"off / track / context"}],columns:["repeat"],func:async(t)=>{await o("PUT",`/me/player/repeat?state=${t.mode}`);return[{repeat:t.mode}]}});

package/clis/xiaohongshu/ask.js

@@ -1,12 +1,12 @@
-import{cli as y,Strategy as x}from"@jackwener/opencli/registry";import{ArgumentError as d,AuthRequiredError as b,CommandExecutionError as c,TimeoutError as S}from"@jackwener/opencli/errors";const u="www.xiaohongshu.com",I=["query","answer","source_count","source_total_text","sources_summary","sources","warning","message_id","conversation_id"];export function unwrapEvaluateResult(e){if(e&&!Array.isArray(e)&&typeof e==="object"&&"session"in e&&"data"in e)return e.data;return e}function _(e,t,r,n,i){const o=e??t;let s;if(typeof o==="number")s=o;else if(typeof o==="string"&&/^\d+$/.test(o))s=Number(o);else throw new d(`${i} must be an integer between ${r} and ${n}, got ${JSON.stringify(e)}`);if(!Number.isInteger(s)||s<r||s>n)throw new d(`${i} must be an integer between ${r} and ${n}, got ${JSON.stringify(e)}`);return s}export function parseAskTimeout(e){return _(e,90,1,180,"--timeout")}export function parseAskLimit(e){return _(e,10,1,50,"--source-limit")}function l(e){return String(e??"").replace(/<[^>]+>/g,"").replace(/\u200b/g,"").replace(/\r\n/g,`
-`).trim()}function a(e){return l(e).replace(/\s+/g," ").trim()}function f(...e){for(const t of e){const r=a(t);if(r)return r}return""}function v(e){if(e===null||e===void 0||e==="")return null;const t=(o)=>Number.isSafeInteger(o)&&o>=0?o:null;if(typeof e==="number")return t(e);const r=String(e).trim(),n=r.match(/^(\d+(?:\.\d+)?)\s*(万|[wW]|亿)\+?$/);if(n){const o=Number(n[1]),s=n[2]==="亿"?1e8:1e4;return Number.isFinite(o)?t(Math.round(o*s)):null}const i=r.replace(/,/g,"").replace(/\+$/,"");if(/^\d+$/.test(i)&&(r===i||r===`${i}+`||/^\d{1,3}(?:,\d{3})+\+?$/.test(r)))return t(Number(i));return null}function g(e){if(!e)return null;try{return new URL(String(e))}catch{return null}}function k(e){const t=String(e||"").trim();if(!t)return null;const r=t.match(/^xhsdiscover:\/\/item\/([0-9a-f]{24})(?=[?#/]|$)/i);if(r){const s=g(t);return{noteId:r[1],xsecToken:s?.searchParams.get("xsec_token")||s?.searchParams.get("xsecToken")||"",href:t}}let n=g(t);if(!n&&t.startsWith("/"))n=g(`https://${u}${t}`);const i=n?.hostname.toLowerCase();if(!n||n.protocol!=="https:"||i!==u&&i!=="xiaohongshu.com")return null;const o=n.pathname.match(/^\/(?:explore|search_result|note)\/([0-9a-f]{24})\/?$/i);if(!o)return null;return{noteId:o[1],xsecToken:n.searchParams.get("xsec_token")||n.searchParams.get("xsecToken")||"",href:n.toString()}}function A(e){const t=a(e?.id||e?.noteId||e?.note_id);if(/^[0-9a-f]{24}$/i.test(t))return t;const r=[e?.textLink,e?.link,e?.url];for(const n of r){const i=k(n);if(i?.noteId)return i.noteId}return""}export function buildNoteUrl(e,t){if(!/^[0-9a-f]{24}$/i.test(String(e||"")))return"";const r=new URL(`https://${u}/explore/${e}`);if(t){r.searchParams.set("xsec_token",t);r.searchParams.set("xsec_source","")}return r.toString()}function q(e){const t=l(e?.content);if(!t)return"";const r=Array.isArray(e?.originLocation)?e.originLocation:[],n=Number(r[0]),i=Number(r[1]);if(Number.isInteger(n)&&n>=0&&Number.isInteger(i)&&i>0)return a(t.slice(n,n+i)).slice(0,300);return a(t).slice(0,300)}export function normalizeAskSource(e,t){const r=[e?.textLink,e?.link,e?.url].map(k).find(Boolean),n=A(e),i=r?.xsecToken||"",o={rank:t+1,type:"note",title:f(e?.title,e?.displayTitle,e?.name),url:buildNoteUrl(n,i),note_id:n,xsec_token:i,author:f(e?.nickName,e?.nickname,e?.author,e?.userName)},s=f(e?.noteType);if(s)o.note_type=s;const m=v(e?.like);if(m!==null)o.like_count=m;const p=a(e?.userId);if(p)o.user_id=p;const h=a(e?.time);if(h)o.published_at=h;const w=q(e);if(w)o.quote=w;if(r?.href)o.deeplink=r.href;return o}function C(e){return e.slice(0,5).map((t)=>`${t.rank}. ${t.title||t.note_id}${t.author?` - ${t.author}`:""}`).join(`
-`)}export function buildAskResult(e){const r=(Array.isArray(e?.sources)?e.sources:[]).map((s,m)=>normalizeAskSource(s,m)).filter((s)=>s.note_id||s.title||s.url),n=l(e?.answer||e?.base_info?.text||""),i=a(e?.warning),o=r.length===0&&n?`Xiaohongshu 点点 returned an answer but no citation sources.${i?` ${i}`:""}`:i;return{query:a(e?.query),answer:n,source_count:r.length,source_total_text:a(e?.source_total_text),sources_summary:C(r),sources:r,warning:o,message_id:a(e?.message_id),conversation_id:a(e?.conversation_id)}}export function buildAskEvaluateJs(e,t,r){const n=String(e);return`
+import{cli as _,Strategy as x}from"@jackwener/opencli/registry";import{ArgumentError as m,AuthRequiredError as b,CommandExecutionError as u,TimeoutError as S}from"@jackwener/opencli/errors";const c="www.xiaohongshu.com",I=["query","answer","source_count","source_total_text","sources_summary","sources","warning","message_id","conversation_id"];export function unwrapEvaluateResult(e){if(e&&!Array.isArray(e)&&typeof e==="object"&&"session"in e&&"data"in e)return e.data;return e}function w(e,t,n,r,i){const o=e??t;let s;if(typeof o==="number")s=o;else if(typeof o==="string"&&/^\d+$/.test(o))s=Number(o);else throw new m(`${i} must be an integer between ${n} and ${r}, got ${JSON.stringify(e)}`);if(!Number.isInteger(s)||s<n||s>r)throw new m(`${i} must be an integer between ${n} and ${r}, got ${JSON.stringify(e)}`);return s}export function parseAskTimeout(e){return w(e,90,1,180,"--timeout")}export function parseAskLimit(e){return w(e,10,1,50,"--source-limit")}function l(e){return String(e??"").replace(/<[^>]+>/g,"").replace(/\u200b/g,"").replace(/\r\n/g,`
+`).trim()}function a(e){return l(e).replace(/\s+/g," ").trim()}function f(...e){for(const t of e){const n=a(t);if(n)return n}return""}function v(e){if(e===null||e===void 0||e==="")return null;const t=(o)=>Number.isSafeInteger(o)&&o>=0?o:null;if(typeof e==="number")return t(e);const n=String(e).trim(),r=n.match(/^(\d+(?:\.\d+)?)\s*(万|[wW]|亿)\+?$/);if(r){const o=Number(r[1]),s=r[2]==="亿"?1e8:1e4;return Number.isFinite(o)?t(Math.round(o*s)):null}const i=n.replace(/,/g,"").replace(/\+$/,"");if(/^\d+$/.test(i)&&(n===i||n===`${i}+`||/^\d{1,3}(?:,\d{3})+\+?$/.test(n)))return t(Number(i));return null}function h(e){if(!e)return null;try{return new URL(String(e))}catch{return null}}function y(e){const t=String(e||"").trim();if(!t)return null;const n=t.match(/^xhsdiscover:\/\/item\/([0-9a-f]{24})(?=[?#/]|$)/i);if(n){const s=h(t);return{noteId:n[1],xsecToken:s?.searchParams.get("xsec_token")||s?.searchParams.get("xsecToken")||"",href:t}}let r=h(t);if(!r&&t.startsWith("/"))r=h(`https://${c}${t}`);const i=r?.hostname.toLowerCase();if(!r||r.protocol!=="https:"||i!==c&&i!=="xiaohongshu.com")return null;const o=r.pathname.match(/^\/(?:explore|search_result|note)\/([0-9a-f]{24})\/?$/i);if(!o)return null;return{noteId:o[1],xsecToken:r.searchParams.get("xsec_token")||r.searchParams.get("xsecToken")||"",href:r.toString()}}function A(e){const t=a(e?.id||e?.noteId||e?.note_id);if(/^[0-9a-f]{24}$/i.test(t))return t;const n=[e?.textLink,e?.link,e?.url];for(const r of n){const i=y(r);if(i?.noteId)return i.noteId}return""}export function buildNoteUrl(e,t){if(!/^[0-9a-f]{24}$/i.test(String(e||"")))return"";const n=new URL(`https://${c}/explore/${e}`);if(t){n.searchParams.set("xsec_token",t);n.searchParams.set("xsec_source","")}return n.toString()}function q(e){const t=l(e?.content);if(!t)return"";const n=Array.isArray(e?.originLocation)?e.originLocation:[],r=Number(n[0]),i=Number(n[1]);if(Number.isInteger(r)&&r>=0&&Number.isInteger(i)&&i>0)return a(t.slice(r,r+i)).slice(0,300);return a(t).slice(0,300)}export function normalizeAskSource(e,t){const n=[e?.textLink,e?.link,e?.url].map(y).find(Boolean),r=A(e),i=n?.xsecToken||"",o={rank:t+1,type:"note",title:f(e?.title,e?.displayTitle,e?.name),url:buildNoteUrl(r,i),note_id:r,xsec_token:i,author:f(e?.nickName,e?.nickname,e?.author,e?.userName)},s=f(e?.noteType);if(s)o.note_type=s;const d=v(e?.like);if(d!==null)o.like_count=d;const p=a(e?.userId);if(p)o.user_id=p;const g=a(e?.time);if(g)o.published_at=g;const k=q(e);if(k)o.quote=k;if(n?.href)o.deeplink=n.href;return o}function C(e){return e.slice(0,5).map((t)=>`${t.rank}. ${t.title||t.note_id}${t.author?` - ${t.author}`:""}`).join(`
+`)}export function buildAskResult(e){const n=(Array.isArray(e?.sources)?e.sources:[]).map((s,d)=>normalizeAskSource(s,d)).filter((s)=>s.note_id||s.title||s.url),r=l(e?.answer||e?.base_info?.text||""),i=a(e?.warning),o=n.length===0&&r?`Xiaohongshu 点点 returned an answer but no citation sources.${i?` ${i}`:""}`:i;return{query:a(e?.query),answer:r,source_count:n.length,source_total_text:a(e?.source_total_text),sources_summary:C(n),sources:n,warning:o,message_id:a(e?.message_id),conversation_id:a(e?.conversation_id)}}export function buildAskEvaluateJs(e,t,n){const r=String(e);return`
       (async () => {
         const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
         const timeoutMs = ${Number(t)} * 1000;
-        const sourceLimit = ${Number(r)};
+        const sourceLimit = ${Number(n)};
         const requestSourceSize = Math.max(sourceLimit, 10);
-        const prompt = ${JSON.stringify(n)};
+        const prompt = ${JSON.stringify(r)};
         const simplifyText = (value, max = 6000) => {
           const text = String(value || '');
           return text.length > max ? text.slice(0, max) : text;
@@ -39,7 +39,41 @@ import{cli as y,Strategy as x}from"@jackwener/opencli/registry";import{ArgumentE
           let webpackRequire;
           window.webpackChunkxhs_pc_web.push([[Date.now()], {}, (req) => { webpackRequire = req; }]);
           if (!webpackRequire) return { ok: false, error: 'webpack_require_unavailable', page_url: location.href };
-          const mod = webpackRequire(6404);
+          // Locate the conversation store module.
+          //
+          // A hardcoded webpack module id has no contract with the site: Xiaohongshu
+          // renumbers chunks on redeploys, and when it does, webpackRequire(<stale id>)
+          // throws "Cannot read properties of undefined (reading 'call')" from webpack's
+          // own runtime and every ask fails. That already happened once (6404 -> 32914).
+          //
+          // So: try known ids first (zero scan cost in the common case), then fall back
+          // to locating the module by what it *is* rather than by its number. The scan
+          // only calls .toString() on factory functions, which has no side effects; a
+          // candidate is executed only after its source matches the fingerprint.
+          const looksLikeConversationModule = (candidate) => (
+            candidate
+            && typeof candidate.t === 'function'
+            && candidate.G
+            && typeof candidate.G.AiChat === 'string'
+          );
+          let mod = null;
+          for (const knownId of [32914, 6404]) {
+            try {
+              const candidate = webpackRequire(knownId);
+              if (looksLikeConversationModule(candidate)) { mod = candidate; break; }
+            } catch { /* id absent from this build */ }
+          }
+          if (!mod) {
+            for (const id of Object.keys(webpackRequire.m || {})) {
+              let source = '';
+              try { source = webpackRequire.m[id].toString(); } catch { continue; }
+              if (!source.includes('createConversation') || !source.includes('sendMessage')) continue;
+              try {
+                const candidate = webpackRequire(id);
+                if (looksLikeConversationModule(candidate)) { mod = candidate; break; }
+              } catch { /* not loadable, keep looking */ }
+            }
+          }
           const useConversationStore = mod?.t;
           const scenes = mod?.G || { AiChat: 'aiChat' };
           if (typeof useConversationStore !== 'function') {
@@ -127,4 +161,4 @@ import{cli as y,Strategy as x}from"@jackwener/opencli/registry";import{ArgumentE
           };
         }
       })()
-    `}function N(e){const t=String(e||"").trim();if(!t)throw new d("query is required");return t}function L(e,t){const r=a(e?.error);if(r==="answer_timeout")throw new S("xiaohongshu ask",t,"点点没有在超时时间内返回答案；可以重试或提高 --timeout。");if(r==="send_message_failed")throw new b(u,"Xiaohongshu 点点 did not accept the query. Check login status for www.xiaohongshu.com.");throw new c(`xiaohongshu ask failed: ${r||"unknown error"}`,e?.page_url?`Page URL: ${e.page_url}`:void 0)}function M(e){if(!e||typeof e!=="object")throw new c("xiaohongshu ask returned a malformed page payload");if(!l(e.answer||e.base_info?.text||""))throw new c("xiaohongshu ask returned a malformed page payload: missing answer");if(!a(e.message_id)||!a(e.conversation_id))throw new c("xiaohongshu ask returned a malformed page payload: missing message identity")}export const command=y({site:"xiaohongshu",name:"ask",access:"write",description:"Ask 小红书点点 and return the answer with citation sources.",domain:u,strategy:x.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"query",positional:!0,required:!0,help:"Question for 点点"},{name:"timeout",type:"int",default:90,help:"Seconds to wait for the 点点 answer"},{name:"source-limit",type:"int",default:10,help:"Maximum citation sources to return"}],columns:I,func:async(e,t)=>{const r=N(t?.query),n=parseAskTimeout(t?.timeout),i=parseAskLimit(t?.["source-limit"]),o=encodeURIComponent(r);await e.goto(`https://${u}/search_result?keyword=${o}&source=web_search_result_notes`);await e.wait?.(1);const s=unwrapEvaluateResult(await e.evaluate(buildAskEvaluateJs(r,n,i)));if(!s||typeof s!=="object")throw new c("xiaohongshu ask returned a malformed page payload");if(s.ok===!1)L(s,n);M(s);return buildAskResult(s)}});
+    `}function L(e){const t=String(e||"").trim();if(!t)throw new m("query is required");return t}function M(e,t){const n=a(e?.error);if(n==="answer_timeout")throw new S("xiaohongshu ask",t,"点点没有在超时时间内返回答案；可以重试或提高 --timeout。");if(n==="send_message_failed")throw new b(c,"Xiaohongshu 点点 did not accept the query. Check login status for www.xiaohongshu.com.");throw new u(`xiaohongshu ask failed: ${n||"unknown error"}`,e?.page_url?`Page URL: ${e.page_url}`:void 0)}function N(e){if(!e||typeof e!=="object")throw new u("xiaohongshu ask returned a malformed page payload");if(!l(e.answer||e.base_info?.text||""))throw new u("xiaohongshu ask returned a malformed page payload: missing answer");if(!a(e.message_id)||!a(e.conversation_id))throw new u("xiaohongshu ask returned a malformed page payload: missing message identity")}export const command=_({site:"xiaohongshu",name:"ask",access:"write",description:"Ask 小红书点点 and return the answer with citation sources.",domain:c,strategy:x.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"query",positional:!0,required:!0,help:"Question for 点点"},{name:"timeout",type:"int",default:90,help:"Seconds to wait for the 点点 answer"},{name:"source-limit",type:"int",default:10,help:"Maximum citation sources to return"}],columns:I,func:async(e,t)=>{const n=L(t?.query),r=parseAskTimeout(t?.timeout),i=parseAskLimit(t?.["source-limit"]);await e.goto(`https://${c}/ai_chat`);await e.wait?.(1);const o=unwrapEvaluateResult(await e.evaluate(buildAskEvaluateJs(n,r,i)));if(!o||typeof o!=="object")throw new u("xiaohongshu ask returned a malformed page payload");if(o.ok===!1)M(o,r);N(o);return buildAskResult(o)}});

package/clis/xiaohongshu/comments.js

@@ -1,4 +1,4 @@
-import{cli as p,Strategy as d}from"@jackwener/opencli/registry";import{AuthRequiredError as w,CliError as g,CommandExecutionError as a,EmptyResultError as y}from"@jackwener/opencli/errors";import{parseNoteId as x,buildNoteUrl as b}from"./note-helpers.js";const k='.author-wrapper a[href*="/user/profile/"], a.name[href*="/user/profile/"], a.user-name[href*="/user/profile/"], a[href*="/user/profile/"]';export function parseXhsProfileHref(r,t="www.xiaohongshu.com"){const e=typeof r==="string"?r.trim():"";if(!e)return"";const s=String(t||"www.xiaohongshu.com").toLowerCase();let o;try{o=new URL(e,`https://${s}`)}catch{return""}if(o.protocol!=="https:")return"";if(o.hostname.toLowerCase()!==s)return"";return o.pathname.match(/^\/user\/profile\/([a-zA-Z0-9]+)\/?$/)?.[1]??""}export function buildXhsProfileUrl(r,t="www.xiaohongshu.com"){const e=parseXhsProfileHref(r,t);if(!e)return"";return`https://${t}/user/profile/${e}`}export function parseCommentLimit(r,t=20){const e=Number(r);if(!Number.isFinite(e))return t;return Math.max(1,Math.min(Math.floor(e),50))}export function parseXhsLikeCountText(r){const t=/^(?:\d+|\d{1,3}(?:[,，]\d{3})+)\+?$/u,e=/^((?:\d+|\d{1,3}(?:[,，]\d{3})+)(?:\.\d+)?)([wWkK万千])\+?$/u,s=String(r??"").replace(/\s+/g,"");if(!s)return 0;if(t.test(s))return Number(s.replace(/[,+，]/g,""));const o=s.match(e);if(!o)return 0;const n=Number(o[1].replace(/[,，]/g,""));if(!Number.isFinite(n))return 0;const l=o[2].toLowerCase();return Math.round(n*(l==="w"||l==="万"?1e4:1000))}function c(r,t,e){if(r==null)return"";if(typeof r!=="string")throw new a(`${e}: malformed comment row ${t}`);return r}export function normalizeCommentImages(r,t){if(r==null)return[];if(!Array.isArray(r))throw new a(`${t}: malformed comment row images`);const e=[];for(const s of r){if(typeof s!=="string")throw new a(`${t}: malformed comment row image URL`);const o=s.trim();let n;try{n=new URL(o)}catch{throw new a(`${t}: malformed comment row image URL`)}if(n.protocol!=="https:"&&n.protocol!=="http:"||n.username||n.password)throw new a(`${t}: malformed comment row image URL`);const l=n.toString();if(!e.includes(l))e.push(l)}return e}export function normalizeCommentRows(r,t="xiaohongshu/comments"){if(r==null)return[];if(!Array.isArray(r))throw new a(`${t}: malformed comments payload`);return r.map((e,s)=>{if(!e||typeof e!=="object"||Array.isArray(e))throw new a(`${t}: malformed comment row at index ${s}`);const o=c(e.text,"text",t);if(!o)throw new a(`${t}: malformed comment row text`);const n=Number(e.likes);if(!Number.isInteger(n)||n<0)throw new a(`${t}: malformed comment row likes`);if(typeof e.is_reply!=="boolean")throw new a(`${t}: malformed comment row is_reply`);return{author:c(e.author,"author",t),authorHrefRaw:c(e.authorHrefRaw,"authorHrefRaw",t),text:o,likes:n,time:c(e.time,"time",t),is_reply:e.is_reply,reply_to:c(e.reply_to,"reply_to",t),images:normalizeCommentImages(e.images,t)}})}export function buildCommentsExtractJs(r,t=20){const e=parseXhsLikeCountText.toString();return`
+import{cli as p,Strategy as d}from"@jackwener/opencli/registry";import{AuthRequiredError as g,CommandExecutionError as a,EmptyResultError as w}from"@jackwener/opencli/errors";import{parseNoteId as y,buildNoteUrl as x}from"./note-helpers.js";import{readXhsDetailPage as b}from"./risk-control.js";const R='.author-wrapper a[href*="/user/profile/"], a.name[href*="/user/profile/"], a.user-name[href*="/user/profile/"], a[href*="/user/profile/"]';export function parseXhsProfileHref(r,t="www.xiaohongshu.com"){const e=typeof r==="string"?r.trim():"";if(!e)return"";const s=String(t||"www.xiaohongshu.com").toLowerCase();let o;try{o=new URL(e,`https://${s}`)}catch{return""}if(o.protocol!=="https:")return"";if(o.hostname.toLowerCase()!==s)return"";return o.pathname.match(/^\/user\/profile\/([a-zA-Z0-9]+)\/?$/)?.[1]??""}export function buildXhsProfileUrl(r,t="www.xiaohongshu.com"){const e=parseXhsProfileHref(r,t);if(!e)return"";return`https://${t}/user/profile/${e}`}export function parseCommentLimit(r,t=20){const e=Number(r);if(!Number.isFinite(e))return t;return Math.max(1,Math.min(Math.floor(e),50))}export function parseXhsLikeCountText(r){const t=/^(?:\d+|\d{1,3}(?:[,，]\d{3})+)\+?$/u,e=/^((?:\d+|\d{1,3}(?:[,，]\d{3})+)(?:\.\d+)?)([wWkK万千])\+?$/u,s=String(r??"").replace(/\s+/g,"");if(!s)return 0;if(t.test(s))return Number(s.replace(/[,+，]/g,""));const o=s.match(e);if(!o)return 0;const n=Number(o[1].replace(/[,，]/g,""));if(!Number.isFinite(n))return 0;const l=o[2].toLowerCase();return Math.round(n*(l==="w"||l==="万"?1e4:1000))}function c(r,t,e){if(r==null)return"";if(typeof r!=="string")throw new a(`${e}: malformed comment row ${t}`);return r}export function normalizeCommentImages(r,t){if(r==null)return[];if(!Array.isArray(r))throw new a(`${t}: malformed comment row images`);const e=[];for(const s of r){if(typeof s!=="string")throw new a(`${t}: malformed comment row image URL`);const o=s.trim();let n;try{n=new URL(o)}catch{throw new a(`${t}: malformed comment row image URL`)}if(n.protocol!=="https:"&&n.protocol!=="http:"||n.username||n.password)throw new a(`${t}: malformed comment row image URL`);const l=n.toString();if(!e.includes(l))e.push(l)}return e}export function normalizeCommentRows(r,t="xiaohongshu/comments"){if(r==null)return[];if(!Array.isArray(r))throw new a(`${t}: malformed comments payload`);return r.map((e,s)=>{if(!e||typeof e!=="object"||Array.isArray(e))throw new a(`${t}: malformed comment row at index ${s}`);const o=c(e.text,"text",t);if(!o)throw new a(`${t}: malformed comment row text`);const n=Number(e.likes);if(!Number.isInteger(n)||n<0)throw new a(`${t}: malformed comment row likes`);if(typeof e.is_reply!=="boolean")throw new a(`${t}: malformed comment row is_reply`);return{author:c(e.author,"author",t),authorHrefRaw:c(e.authorHrefRaw,"authorHrefRaw",t),text:o,likes:n,time:c(e.time,"time",t),is_reply:e.is_reply,reply_to:c(e.reply_to,"reply_to",t),images:normalizeCommentImages(e.images,t)}})}export function buildCommentsExtractJs(r,t=20){const e=parseXhsLikeCountText.toString();return`
       (async () => {
         const wait = (ms) => new Promise(r => setTimeout(r, ms))
         const withReplies = ${r}
@@ -52,7 +52,7 @@ import{cli as p,Strategy as d}from"@jackwener/opencli/registry";import{AuthRequi
         const parseLikes = (el) => {
           return parseLikeCountText(clean(el))
         }
-        const HREF_SELECTOR = ${JSON.stringify(k)}
+        const HREF_SELECTOR = ${JSON.stringify(R)}
         const extractAuthorHref = (el) => {
           if (!el) return ''
           const anchor = el.querySelector(HREF_SELECTOR)
@@ -129,4 +129,4 @@ import{cli as p,Strategy as d}from"@jackwener/opencli/registry";import{AuthRequi
 
         return { pageUrl: location.href, securityBlock, loginWall, results }
       })()
-    `}export const command=p({site:"xiaohongshu",name:"comments",access:"read",description:"获取小红书笔记评论（支持楼中楼子回复）",domain:"www.xiaohongshu.com",strategy:d.COOKIE,navigateBefore:!1,args:[{name:"note-id",required:!0,positional:!0,help:"Full Xiaohongshu note URL with xsec_token"},{name:"limit",type:"int",default:20,help:"Number of top-level comments (max 50)"},{name:"with-replies",type:"boolean",default:!1,help:"Include nested replies (楼中楼)"}],columns:["rank","author","userId","profileUrl","text","likes","time","is_reply","reply_to","images"],func:async(r,t)=>{const e=parseCommentLimit(t.limit),s=Boolean(t["with-replies"]),o=String(t["note-id"]),n=x(o);await r.goto(b(o,{commandName:"xiaohongshu comments"}));await r.wait({time:2+Math.random()*3});const l=await r.evaluate(buildCommentsExtractJs(s,e));if(!l||typeof l!=="object")throw new y("xiaohongshu/comments","Unexpected evaluate response");if(l.securityBlock)throw new g("SECURITY_BLOCK","Xiaohongshu security block: the note detail page was blocked by risk control.",/^https?:\/\//.test(o)?"The page may be temporarily restricted. Try again later or from a different session.":"Try using a full URL from search results (with xsec_token) instead of a bare note ID.");if(l.loginWall)throw new w("www.xiaohongshu.com","Note comments require login");const m=normalizeCommentRows(l.results,"xiaohongshu/comments"),f=(i,u)=>({rank:u+1,author:i.author,userId:i.authorHrefRaw?parseXhsProfileHref(i.authorHrefRaw):"",profileUrl:i.authorHrefRaw?buildXhsProfileUrl(i.authorHrefRaw):"",text:i.text,likes:i.likes,time:i.time,is_reply:i.is_reply,reply_to:i.reply_to,images:i.images??[]});if(s){const i=[];let u=0;for(const h of m){if(!h.is_reply)u++;if(u>e)break;i.push(h)}return i.map(f)}return m.slice(0,e).map(f)}});
+    `}export const command=p({site:"xiaohongshu",name:"comments",access:"read",description:"获取小红书笔记评论（支持楼中楼子回复）",domain:"www.xiaohongshu.com",strategy:d.COOKIE,navigateBefore:!1,args:[{name:"note-id",required:!0,positional:!0,help:"Full Xiaohongshu note URL with xsec_token"},{name:"limit",type:"int",default:20,help:"Number of top-level comments (max 50)"},{name:"with-replies",type:"boolean",default:!1,help:"Include nested replies (楼中楼)"}],columns:["rank","author","userId","profileUrl","text","likes","time","is_reply","reply_to","images"],func:async(r,t)=>{const e=parseCommentLimit(t.limit),s=Boolean(t["with-replies"]),o=String(t["note-id"]),n=y(o),l=await b(r,{url:x(o,{commandName:"xiaohongshu comments"}),extractJs:buildCommentsExtractJs(s,e),securityHelp:/^https?:\/\//.test(o)?"The page may be temporarily restricted. Try again later or from a different session.":"Try using a full URL from search results (with xsec_token) instead of a bare note ID."});if(!l||typeof l!=="object")throw new w("xiaohongshu/comments","Unexpected evaluate response");if(l.loginWall)throw new g("www.xiaohongshu.com","Note comments require login");const m=normalizeCommentRows(l.results,"xiaohongshu/comments"),f=(i,u)=>({rank:u+1,author:i.author,userId:i.authorHrefRaw?parseXhsProfileHref(i.authorHrefRaw):"",profileUrl:i.authorHrefRaw?buildXhsProfileUrl(i.authorHrefRaw):"",text:i.text,likes:i.likes,time:i.time,is_reply:i.is_reply,reply_to:i.reply_to,images:i.images??[]});if(s){const i=[];let u=0;for(const h of m){if(!h.is_reply)u++;if(u>e)break;i.push(h)}return i.map(f)}return m.slice(0,e).map(f)}});

package/clis/xiaohongshu/download.js

@@ -1,4 +1,4 @@
-import{cli as c,Strategy as l}from"@jackwener/opencli/registry";import{formatCookieHeader as d}from"@jackwener/opencli/download";import{downloadMedia as u}from"@jackwener/opencli/download/media-download";import{CliError as h,CommandExecutionError as m,EmptyResultError as f}from"@jackwener/opencli/errors";import{buildNoteUrl as p,parseNoteId as g}from"./note-helpers.js";export function buildDownloadExtractJs(t){return`
+import{cli as c,Strategy as l}from"@jackwener/opencli/registry";import{formatCookieHeader as d}from"@jackwener/opencli/download";import{downloadMedia as u}from"@jackwener/opencli/download/media-download";import{CommandExecutionError as m,EmptyResultError as h}from"@jackwener/opencli/errors";import{readXhsDetailPage as f}from"./risk-control.js";import{buildNoteUrl as p,parseNoteId as g}from"./note-helpers.js";export function buildDownloadExtractJs(t){return`
       (() => {
         const bodyText = document.body?.innerText || '';
         const result = {
@@ -197,4 +197,4 @@ import{cli as c,Strategy as l}from"@jackwener/opencli/registry";import{formatCoo
 
         return result;
       })()
-    `}export const command=c({site:"xiaohongshu",name:"download",access:"read",description:"下载小红书笔记中的图片和视频",domain:"www.xiaohongshu.com",strategy:l.COOKIE,navigateBefore:!1,args:[{name:"note-id",positional:!0,required:!0,help:"Full Xiaohongshu note URL with xsec_token, or xhslink short link"},{name:"output",default:"./xiaohongshu-downloads",help:"Output directory"}],columns:["index","type","status","size"],func:async(t,r)=>{const o=String(r["note-id"]),i=r.output,s=g(o);await t.goto(p(o,{allowShortLink:!0,commandName:"xiaohongshu download"}));await t.wait({time:1+Math.random()*2});const e=await t.evaluate(buildDownloadExtractJs(s));if(e?.securityBlock)throw new h("SECURITY_BLOCK","Xiaohongshu security block: the note detail page was blocked by risk control.",/^https?:\/\//.test(o)?"The page may be temporarily restricted. Try again later or from a different session.":"Try using a full URL from search results (with xsec_token) instead of a bare note ID.");if(!e||typeof e!=="object"||!Array.isArray(e.media))throw new m("Xiaohongshu media extraction returned malformed payload.");if(e.media.length===0)throw new f("xiaohongshu download","No downloadable media found on this note.");const n=d(await t.getCookies({domain:"xiaohongshu.com"})),a=typeof e.noteId==="string"&&e.noteId.trim()?e.noteId.trim():s;return u(e.media,{output:i,subdir:a,cookies:n,filenamePrefix:a,timeout:60000})}});
+    `}export const command=c({site:"xiaohongshu",name:"download",access:"read",description:"下载小红书笔记中的图片和视频",domain:"www.xiaohongshu.com",strategy:l.COOKIE,navigateBefore:!1,args:[{name:"note-id",positional:!0,required:!0,help:"Full Xiaohongshu note URL with xsec_token, or xhslink short link"},{name:"output",default:"./xiaohongshu-downloads",help:"Output directory"}],columns:["index","type","status","size"],func:async(t,r)=>{const o=String(r["note-id"]),i=r.output,s=g(o),e=await f(t,{url:p(o,{allowShortLink:!0,commandName:"xiaohongshu download"}),extractJs:buildDownloadExtractJs(s),securityHelp:/^https?:\/\//.test(o)?"The page may be temporarily restricted. Try again later or from a different session.":"Try using a full URL from search results (with xsec_token) instead of a bare note ID.",settleMinS:1,settleMaxS:3});if(!e||typeof e!=="object"||!Array.isArray(e.media))throw new m("Xiaohongshu media extraction returned malformed payload.");if(e.media.length===0)throw new h("xiaohongshu download","No downloadable media found on this note.");const n=d(await t.getCookies({domain:"xiaohongshu.com"})),a=typeof e.noteId==="string"&&e.noteId.trim()?e.noteId.trim():s;return u(e.media,{output:i,subdir:a,cookies:n,filenamePrefix:a,timeout:60000})}});

package/clis/xiaohongshu/note.js

@@ -1,4 +1,4 @@
-import{cli as d,Strategy as h}from"@jackwener/opencli/registry";import{AuthRequiredError as m,CliError as p,EmptyResultError as a}from"@jackwener/opencli/errors";import{parseNoteId as g,buildNoteUrl as f}from"./note-helpers.js";export const NOTE_EXTRACT_JS=`
+import{cli as d,Strategy as h}from"@jackwener/opencli/registry";import{AuthRequiredError as m,EmptyResultError as r}from"@jackwener/opencli/errors";import{parseNoteId as p,buildNoteUrl as f}from"./note-helpers.js";import{readXhsDetailPage as g}from"./risk-control.js";export const NOTE_EXTRACT_JS=`
       (() => {
         const bodyText = document.body?.innerText || ''
         const loginWall = /登录后查看|请登录/.test(bodyText)
@@ -8,9 +8,24 @@ import{cli as d,Strategy as h}from"@jackwener/opencli/registry";import{AuthRequi
 
         const clean = (el) => (el?.textContent || '').replace(/\\s+/g, ' ').trim()
 
-        const title = clean(document.querySelector('#detail-title, .title'))
-        const desc = clean(document.querySelector('#detail-desc, .desc, .note-text'))
-        const author = clean(document.querySelector('.username, .author-wrapper .name'))
+        // Scope the note's own fields to #noteContainer — the detail panel.
+        // The page also renders a recommendation feed next to the note, and
+        // every card in that feed carries a .title. querySelector returns the
+        // FIRST match in document order, so for a note that has no title of
+        // its own (#detail-title absent) the unscoped selector fell through to
+        // .title and reported an unrelated recommendation card's title as this
+        // note's title. Same class of bug as the .interact-container scoping
+        // below.
+        const scope = document.querySelector('#noteContainer')
+        const title = scope
+          ? clean(scope.querySelector('#detail-title, .title'))
+          : clean(document.querySelector('#detail-title'))
+        const desc = scope
+          ? clean(scope.querySelector('#detail-desc, .desc, .note-text'))
+          : clean(document.querySelector('#detail-desc, .note-text'))
+        const author = scope
+          ? clean(scope.querySelector('.username, .author-wrapper .name'))
+          : clean(document.querySelector('.username, .author-wrapper .name'))
         // Scope to .interact-container — the post's main interaction bar.
         // Without scoping, .like-wrapper / .chat-wrapper also match each
         // comment's like/reply buttons in the comment section, and
@@ -29,4 +44,4 @@ import{cli as d,Strategy as h}from"@jackwener/opencli/registry";import{AuthRequi
 
         return { pageUrl: location.href, securityBlock, loginWall, notFound, title, desc, author, likes, collects, comments, tags }
       })()
-    `,command=d({site:"xiaohongshu",name:"note",access:"read",description:"获取小红书笔记正文和互动数据",domain:"www.xiaohongshu.com",strategy:h.COOKIE,navigateBefore:!1,args:[{name:"note-id",required:!0,positional:!0,help:"Full Xiaohongshu note URL with xsec_token"}],columns:["field","value"],func:async(o,i)=>{const n=String(i["note-id"]),l=g(n),u=f(n,{commandName:"xiaohongshu note"});await o.goto(u);await o.wait({time:2+Math.random()*3});const t=await o.evaluate(NOTE_EXTRACT_JS);if(!t||typeof t!=="object")throw new a("xiaohongshu/note","Unexpected evaluate response");if(t.securityBlock)throw new p("SECURITY_BLOCK","Xiaohongshu security block: the note detail page was blocked by risk control.",/^https?:\/\//.test(n)?"The page may be temporarily restricted. Try again later or from a different session.":"Try using a full URL from search results (with xsec_token) instead of a bare note ID.");if(t.loginWall)throw new m("www.xiaohongshu.com","Note content requires login");if(t.notFound)throw new a("xiaohongshu/note",`Note ${l} not found or unavailable — it may have been deleted or restricted`);const e=t,r=(s)=>/^\d+/.test(s)?s:"0";if(!e.title&&!e.author)throw new a("xiaohongshu/note","The note page loaded without visible content. The note may be deleted or restricted.");const c=[{field:"title",value:e.title||""},{field:"author",value:e.author||""},{field:"content",value:e.desc||""},{field:"likes",value:r(e.likes||"")},{field:"collects",value:r(e.collects||"")},{field:"comments",value:r(e.comments||"")}];if(e.tags?.length)c.push({field:"tags",value:e.tags.join(", ")});return c}});
+    `,command=d({site:"xiaohongshu",name:"note",access:"read",description:"获取小红书笔记正文和互动数据",domain:"www.xiaohongshu.com",strategy:h.COOKIE,navigateBefore:!1,args:[{name:"note-id",required:!0,positional:!0,help:"Full Xiaohongshu note URL with xsec_token"}],columns:["field","value"],func:async(s,l)=>{const o=String(l["note-id"]),i=p(o),u=f(o,{commandName:"xiaohongshu note"}),t=await g(s,{url:u,extractJs:NOTE_EXTRACT_JS,securityHelp:/^https?:\/\//.test(o)?"The page may be temporarily restricted. Try again later or from a different session.":"Try using a full URL from search results (with xsec_token) instead of a bare note ID."});if(!t||typeof t!=="object")throw new r("xiaohongshu/note","Unexpected evaluate response");if(t.loginWall)throw new m("www.xiaohongshu.com","Note content requires login");if(t.notFound)throw new r("xiaohongshu/note",`Note ${i} not found or unavailable — it may have been deleted or restricted`);const e=t,n=(c)=>/^\d+/.test(c)?c:"0";if(!e.title&&!e.author)throw new r("xiaohongshu/note","The note page loaded without visible content. The note may be deleted or restricted.");const a=[{field:"title",value:e.title||""},{field:"author",value:e.author||""},{field:"content",value:e.desc||""},{field:"likes",value:n(e.likes||"")},{field:"collects",value:n(e.collects||"")},{field:"comments",value:n(e.comments||"")}];if(e.tags?.length)a.push({field:"tags",value:e.tags.join(", ")});return a}});

package/clis/xiaohongshu/risk-control.js

@@ -0,0 +1 @@
+import{CliError as y}from"@jackwener/opencli/errors";export function jitterSeconds(t,e,o=Math.random){return t+o()*(e-t)}export function isSecurityBlock(t){return Boolean(t&&typeof t==="object"&&!Array.isArray(t)&&t.securityBlock)}export async function readXhsDetailPage(t,{url:e,extractJs:o,securityHelp:n,settleMinS:c=2,settleMaxS:s=5,retryOnBlock:u=!0,cooldownMinS:l=8,cooldownMaxS:w=18,rand:i=Math.random}={}){const a=async()=>{await t.goto(e);await t.wait({time:jitterSeconds(c,s,i)});return t.evaluate(o)};let r=await a();if(u&&isSecurityBlock(r)){await t.wait({time:jitterSeconds(l,w,i)});r=await a()}if(isSecurityBlock(r))throw new y("SECURITY_BLOCK","Xiaohongshu security block: the note detail page was blocked by risk control.",n);return r}export const __test__={jitterSeconds,isSecurityBlock,readXhsDetailPage};

package/dist/src/discovery.js

@@ -1,2 +1,2 @@
-import*as r from"node:fs";import*as h from"node:os";import*as m from"node:path";import{fileURLToPath as g,pathToFileURL as p}from"node:url";import{Strategy as f,registerCommand as P}from"./registry.js";import{getErrorMessage as l}from"./errors.js";import{log as u}from"./logger.js";import{findPackageRoot as j,getCliManifestPath as F}from"./package-paths.js";import{migrateLegacyUserRuntime as S}from"./user-runtime.js";S();export const USER_OPENCLI_DIR=m.join(h.homedir(),".ppcli"),USER_CLIS_DIR=m.join(USER_OPENCLI_DIR,"clis"),PLUGINS_DIR=m.join(USER_OPENCLI_DIR,"plugins");const W=/\b(?:cli|registerSiteAuthCommands|onStartup|onBeforeExecute|onAfterExecute)\s*\(/;function k(s,e=f.COOKIE){if(!s)return e;const i=s.toUpperCase();return f[i]??e}const v=j(g(import.meta.url));export async function ensureUserCliCompatShims(s=USER_OPENCLI_DIR){await r.promises.mkdir(s,{recursive:!0});const e=m.join(s,"package.json"),i=`${JSON.stringify({name:"opencli-user-runtime",private:!0,type:"module"},null,2)}
-`;try{if(await r.promises.readFile(e,"utf-8")!==i)await r.promises.writeFile(e,i,"utf-8")}catch{await r.promises.writeFile(e,i,"utf-8")}const o=v,t=m.join(s,"node_modules","@jackwener"),a=m.join(t,"opencli");try{let n=!0;try{if(await r.promises.readlink(a)===o)n=!1}catch{}if(n){await r.promises.mkdir(t,{recursive:!0});try{await r.promises.rm(a,{recursive:!0,force:!0})}catch{}const c=process.platform==="win32"?"junction":"dir";await r.promises.symlink(o,a,c)}}catch(n){u.warn(`Could not create symlink at ${a}: ${l(n)}`)}}export async function ensureUserAdapters(){await r.promises.mkdir(USER_CLIS_DIR,{recursive:!0})}export async function discoverClis(...s){for(const e of s){const i=F(e);try{await r.promises.access(i);if(await E(i,e))continue}catch{}await R(e)}}async function E(s,e){try{const i=await r.promises.readFile(s,"utf-8"),o=JSON.parse(i);for(const t of o){if(!t.modulePath)continue;const a=m.resolve(e,t.modulePath),n={site:t.site,name:t.name,aliases:t.aliases,description:t.description??"",access:t.access,example:t.example,domain:t.domain,strategy:k(t.strategy),browser:t.browser,args:t.args??[],columns:t.columns,defaultFormat:t.defaultFormat,pipeline:t.pipeline,source:t.sourceFile?m.resolve(e,t.sourceFile):a,navigateBefore:t.navigateBefore,siteSession:t.siteSession,defaultWindowMode:t.defaultWindowMode,_lazy:!0,_modulePath:a};P(n)}return!0}catch(i){u.warn(`Failed to load manifest ${s}: ${l(i)}`);return!1}}async function R(s){try{await r.promises.access(s)}catch{return}const i=(await r.promises.readdir(s,{withFileTypes:!0})).filter((o)=>o.isDirectory()).map(async(o)=>{const t=o.name,a=m.join(s,t),n=await r.promises.readdir(a);await Promise.all(n.map(async(c)=>{const d=m.join(a,c);if(c.endsWith(".yaml")||c.endsWith(".yml"))return;if(c.endsWith(".ts")&&!c.endsWith(".d.ts")&&!c.endsWith(".test.ts")){u.warn(`Ignoring TypeScript adapter ${d} — .ts adapters are no longer loaded. Rename to .js or convert to JavaScript.`);return}if(c.endsWith(".js")&&!c.endsWith(".d.js")&&!c.endsWith(".test.js")){if(!await w(d))return;await import(p(d).href).catch((y)=>{u.warn(`Failed to load module ${d}: ${l(y)}`)})}}))});await Promise.all(i)}export async function discoverPlugins(){try{await r.promises.access(PLUGINS_DIR)}catch{return}const s=await r.promises.readdir(PLUGINS_DIR,{withFileTypes:!0});await Promise.all(s.map(async(e)=>{const i=m.join(PLUGINS_DIR,e.name);if(!await C(e,i))return;await x(i,e.name)}))}async function x(s,e){let i;try{i=await r.promises.readdir(s)}catch(t){const a=t.code;if(a!=="ENOENT"&&a!=="ENOTDIR")u.warn(`Failed to scan plugin directory ${s}: ${l(t)}`);return}const o=new Set(i);await Promise.all(i.map(async(t)=>{const a=m.join(s,t);if(t.endsWith(".yaml")||t.endsWith(".yml"))return;if(t.endsWith(".js")&&!t.endsWith(".d.js")){if(!await w(a))return;await import(p(a).href).catch((n)=>{u.warn(`Plugin ${e}/${t}: ${l(n)}`)})}else if(t.endsWith(".ts")&&!t.endsWith(".d.ts")&&!t.endsWith(".test.ts")){const n=t.replace(/\.ts$/,".js");if(o.has(n))return;u.warn(`Plugin ${e}/${t}: no compiled .js found. Run "ppcli plugin update ${e}" to re-transpile, or install esbuild.`)}}))}async function w(s){try{const e=await r.promises.readFile(s,"utf-8");return W.test(e)}catch(e){u.warn(`Failed to inspect module ${s}: ${l(e)}`);return!1}}async function C(s,e){if(s.isDirectory())return!0;if(!s.isSymbolicLink())return!1;try{return(await r.promises.stat(e)).isDirectory()}catch(i){const o=i.code;if(o!=="ENOENT"&&o!=="ENOTDIR")u.warn(`Failed to inspect plugin link ${e}: ${l(i)}`);return!1}}
+import*as i from"node:fs";import*as R from"node:os";import*as c from"node:path";import{fileURLToPath as S,pathToFileURL as p}from"node:url";import A from"js-yaml";import{Strategy as y,registerCommand as E}from"./registry.js";import{getErrorMessage as m}from"./errors.js";import{log as u}from"./logger.js";import{findPackageRoot as k,getCliManifestPath as I}from"./package-paths.js";import{migrateLegacyUserRuntime as x}from"./user-runtime.js";x();export const USER_OPENCLI_DIR=c.join(R.homedir(),".ppcli"),USER_CLIS_DIR=c.join(USER_OPENCLI_DIR,"clis"),PLUGINS_DIR=c.join(USER_OPENCLI_DIR,"plugins");const M=/\b(?:cli|registerSiteAuthCommands|onStartup|onBeforeExecute|onAfterExecute)\s*\(/,h=/\.ya?ml$/i,g=new Set,F=new Map;function T(e,r=y.COOKIE){if(!e)return r;const t=e.toUpperCase();return y[t]??r}const D=k(S(import.meta.url));export async function ensureUserCliCompatShims(e=USER_OPENCLI_DIR){await i.promises.mkdir(e,{recursive:!0});const r=c.join(e,"package.json"),t=`${JSON.stringify({name:"opencli-user-runtime",private:!0,type:"module"},null,2)}
+`;try{if(await i.promises.readFile(r,"utf-8")!==t)await i.promises.writeFile(r,t,"utf-8")}catch{await i.promises.writeFile(r,t,"utf-8")}const a=D,n=c.join(e,"node_modules","@jackwener"),s=c.join(n,"opencli");try{let o=!0;try{if(await i.promises.readlink(s)===a)o=!1}catch{}if(o){await i.promises.mkdir(n,{recursive:!0});try{await i.promises.rm(s,{recursive:!0,force:!0})}catch{}const l=process.platform==="win32"?"junction":"dir";await i.promises.symlink(a,s,l)}}catch(o){u.warn(`Could not create symlink at ${s}: ${m(o)}`)}}export async function ensureUserAdapters(){await i.promises.mkdir(USER_CLIS_DIR,{recursive:!0})}export async function discoverClis(...e){for(const r of e){const t=I(r);try{await i.promises.access(t);const a=await L(t,r);if(a){await j(r,a.manifestFiles);continue}}catch{}await W(r)}}async function L(e,r){try{const t=await i.promises.readFile(e,"utf-8"),a=JSON.parse(t),n=new Set;for(const s of a){if(!s.modulePath)continue;const o=c.resolve(r,s.modulePath);n.add(o);if(s.sourceFile)n.add(c.resolve(r,s.sourceFile));const l={site:s.site,name:s.name,aliases:s.aliases,description:s.description??"",access:s.access,example:s.example,domain:s.domain,strategy:T(s.strategy),browser:s.browser,args:s.args??[],columns:s.columns,defaultFormat:s.defaultFormat,pipeline:s.pipeline,source:s.sourceFile?c.resolve(r,s.sourceFile):o,navigateBefore:s.navigateBefore,siteSession:s.siteSession,defaultWindowMode:s.defaultWindowMode,_lazy:!0,_modulePath:o};E(l)}return{manifestFiles:n}}catch(t){u.warn(`Failed to load manifest ${e}: ${m(t)}`);return null}}async function W(e){try{await i.promises.access(e)}catch{return}const r=await i.promises.readdir(e,{withFileTypes:!0});await j(e);const t=r.filter((a)=>a.isDirectory()).map(async(a)=>{const n=a.name,s=c.join(e,n),o=await i.promises.readdir(s);await Promise.all(o.map(async(l)=>{const d=c.join(s,l);if(f(l))return;if(l.endsWith(".ts")&&!l.endsWith(".d.ts")&&!l.endsWith(".test.ts")){u.warn(`Ignoring TypeScript adapter ${d} — .ts adapters are no longer loaded. Rename to .js or convert to JavaScript.`);return}if(l.endsWith(".js")&&!l.endsWith(".d.js")&&!l.endsWith(".test.js")){if(!await w(d))return;await import(p(d).href).catch((C)=>{u.warn(`Failed to load module ${d}: ${m(C)}`)})}}))});await Promise.all(t)}export async function discoverPlugins(){try{await i.promises.access(PLUGINS_DIR)}catch{return}const e=(await i.promises.readdir(PLUGINS_DIR,{withFileTypes:!0})).sort((t,a)=>t.name.localeCompare(a.name)),r=[];for(const t of e){const a=c.join(PLUGINS_DIR,t.name);if(await Y(t,a))r.push({entry:t,pluginDir:a})}for(const{entry:t,pluginDir:a}of r)await P(a,{owner:`plugin ${t.name}`,pluginMode:!0});await Promise.all(r.map(async({entry:t,pluginDir:a})=>{await _(a,t.name)}))}async function _(e,r){let t;try{t=await i.promises.readdir(e)}catch(n){const s=n.code;if(s!=="ENOENT"&&s!=="ENOTDIR")u.warn(`Failed to scan plugin directory ${e}: ${m(n)}`);return}const a=new Set(t);await Promise.all(t.map(async(n)=>{const s=c.join(e,n);if(f(n))return;if(n.endsWith(".js")&&!n.endsWith(".d.js")){if(!await w(s))return;await import(p(s).href).catch((o)=>{u.warn(`Plugin ${r}/${n}: ${m(o)}`)})}else if(n.endsWith(".ts")&&!n.endsWith(".d.ts")&&!n.endsWith(".test.ts")){const o=n.replace(/\.ts$/,".js");if(a.has(o))return;u.warn(`Plugin ${r}/${n}: no compiled .js found. Run "ppcli plugin update ${r}" to re-transpile, or install esbuild.`)}}))}async function j(e,r){let t;try{t=await i.promises.readdir(e,{withFileTypes:!0})}catch{return}for(const a of t.filter((n)=>n.isDirectory()).sort((n,s)=>n.name.localeCompare(s.name))){const n=c.join(e,a.name);await P(n,{owner:`site ${a.name}`,manifestFiles:r})}}async function P(e,r){let t;try{t=await i.promises.readdir(e)}catch(s){u.warn(`Could not inspect YAML adapters for ${r.owner}: ${m(s)}`);return}const a=new Set(t),n=[];for(const s of t.filter(f).sort()){const o=c.join(e,s);if(!await N(o,r.pluginMode===!0))continue;if(await U(e,s,a,r.manifestFiles))continue;const l=await v(o);if(g.has(l))continue;g.add(l);n.push(s)}if(n.length===0)return;u.warn(`Ignoring ${n.length} YAML adapter${n.length===1?"":"s"} for ${r.owner}: ${n.join(", ")}. .yaml/.yml adapters are no longer loaded; convert them to .js with the cli() API.`)}function f(e){return h.test(e)}async function U(e,r,t,a){const n=r.replace(h,".js");if(!t.has(n))return!1;const s=c.resolve(e,n);if(a)return a.has(s);return b(s)}async function N(e,r){let t;try{t=await i.promises.readFile(e,"utf-8")}catch{return!r}let a;try{a=A.load(t)}catch{return!r}if(!a||typeof a!=="object"||Array.isArray(a))return!1;const n=a;if(typeof n.name!=="string"||!n.name.trim())return!1;return["site","description","access","strategy","browser","domain","args","columns","pipeline","url","request","steps","extract","output","func","method","headers"].some((o)=>(o in n))}async function v(e){try{return await i.promises.realpath(e)}catch{return c.resolve(e)}}async function O(e){const r=await v(e);try{const t=await i.promises.stat(e);return`${r}:${t.mtimeMs}:${t.size}`}catch{return r}}async function b(e){const r=await O(e);let t=F.get(r);if(!t){t=(async()=>{if(!await w(e))return!1;try{await import(p(e).href);return!0}catch(a){u.warn(`Failed to load module ${e}: ${m(a)}`);return!1}})();F.set(r,t)}return t}async function w(e){try{const r=await i.promises.readFile(e,"utf-8");return M.test(r)}catch(r){u.warn(`Failed to inspect module ${e}: ${m(r)}`);return!1}}async function Y(e,r){if(e.isDirectory())return!0;if(!e.isSymbolicLink())return!1;try{return(await i.promises.stat(r)).isDirectory()}catch(t){const a=t.code;if(a!=="ENOENT"&&a!=="ENOTDIR")u.warn(`Failed to inspect plugin link ${r}: ${m(t)}`);return!1}}

package/dist/src/doctor.d.ts

@@ -29,7 +29,8 @@ export type DoctorReport = {
     issues: string[];
 };
 /**
- * Test connectivity by attempting a real browser command.
+ * Test connectivity with a daemon-to-extension command that does not resolve a
+ * page or create a Browser Bridge container window.
  */
 export declare function checkConnectivity(opts?: {
     timeout?: number;

package/dist/src/doctor.js

@@ -1,13 +1,13 @@
-import{DEFAULT_DAEMON_PORT as v}from"./constants.js";import{BrowserBridge as g}from"./browser/index.js";import{setDaemonCommandTimeoutSeconds as h}from"./browser/daemon-client.js";import{getDaemonHealth as b}from"./browser/daemon-transport.js";import{getErrorMessage as y}from"./errors.js";import{getRuntimeLabel as k}from"./runtime-detect.js";import{aliasForContextId as I,loadProfileConfig as C}from"./browser/profile.js";import{formatDaemonVersion as f,isDaemonStale as V,staleDaemonIssue as S}from"./browser/daemon-version.js";import{findShadowedUserAdapters as D,formatAdapterShadowIssue as P}from"./adapter-shadow.js";const R=8,T="__doctor__";function p(e){const n=e.replace(/^v/,"").split("-")[0].split(".").map(Number);if(n.length<3||n.some(isNaN))return null;return[n[0],n[1],n[2]]}function O(e,n){const o=n.match(/^(>=?)\s*(\S+)$/);if(!o)return!0;const[,s,a]=o,c=p(e),l=p(a);if(!c||!l)return!0;const i=c[0]-l[0]||c[1]-l[1]||c[2]-l[2];return s===">="?i>=0:i>0}export async function checkConnectivity(e){const n=Date.now(),o=e?.timeout??R;h(o);try{const s=new g,a=await s.connect({timeout:o,session:T,surface:"browser"});try{await a.evaluate("1 + 1");await a.closeWindow?.()}finally{await s.close()}return{ok:!0,durationMs:Date.now()-n}}catch(s){return{ok:!1,error:y(s),durationMs:Date.now()-n}}finally{h(null)}}export async function runBrowserDoctor(e={}){const n=await checkConnectivity(),o=await b(),s=o.state!=="stopped",a=o.state==="ready",c=n.ok&&!s,l=n.ok&&s&&!a,i=V(o.status,e.cliVersion),u=o.status?.profiles,r=o.status?.extensionVersion,d=D(),t=[];if(c)t.push(`Daemon connectivity is unstable. The live browser test succeeded, but the daemon was no longer running immediately afterward.
-This usually means the daemon crashed or exited right after serving the live probe.`);else if(!s)t.push("Daemon is not running. It should start automatically when you run an ppcli browser command.");if(i&&e.cliVersion)t.push(S(o.status,e.cliVersion));if(l)t.push(`Extension connection is unstable. The live browser test succeeded, but the daemon reported the extension disconnected immediately afterward.
-This usually means the Browser Bridge service worker is reconnecting slowly or Chrome suspended it.`);else if(s&&!a)if(o.state==="profile-required")t.push(`Multiple Chrome profiles are connected to the daemon, but no default profile was selected.
+import{DEFAULT_DAEMON_PORT as w}from"./constants.js";import{sendCommand as g,setDaemonCommandTimeoutSeconds as h}from"./browser/daemon-client.js";import{getDaemonHealth as b}from"./browser/daemon-transport.js";import{getErrorMessage as y}from"./errors.js";import{getRuntimeLabel as k}from"./runtime-detect.js";import{aliasForContextId as C,loadProfileConfig as I}from"./browser/profile.js";import{formatDaemonVersion as f,isDaemonStale as V,staleDaemonIssue as S}from"./browser/daemon-version.js";import{findShadowedUserAdapters as D,formatAdapterShadowIssue as P}from"./adapter-shadow.js";const R=8,T="__doctor__";function p(e){const n=e.replace(/^v/,"").split("-")[0].split(".").map(Number);if(n.length<3||n.some(isNaN))return null;return[n[0],n[1],n[2]]}function O(e,n){const o=n.match(/^(>=?)\s*(\S+)$/);if(!o)return!0;const[,i,u]=o,r=p(e),c=p(u);if(!r||!c)return!0;const s=r[0]-c[0]||r[1]-c[1]||r[2]-c[2];return i===">="?s>=0:s>0}export async function checkConnectivity(e){const n=Date.now(),o=e?.timeout??R;h(o);try{await g("cookies",{domain:"opencli-probe.invalid",session:T,surface:"browser"});return{ok:!0,durationMs:Date.now()-n}}catch(i){return{ok:!1,error:y(i),durationMs:Date.now()-n}}finally{h(null)}}export async function runBrowserDoctor(e={}){const n=await checkConnectivity(),o=await b(),i=o.state!=="stopped",u=o.state==="ready",r=n.ok&&!i,c=n.ok&&i&&!u,s=V(o.status,e.cliVersion),l=o.status?.profiles,a=o.status?.extensionVersion,d=D(),t=[];if(r)t.push(`Daemon connectivity is unstable. The live browser test succeeded, but the daemon was no longer running immediately afterward.
+This usually means the daemon crashed or exited right after serving the live probe.`);else if(!i)t.push("Daemon is not running. It should start automatically when you run an ppcli browser command.");if(s&&e.cliVersion)t.push(S(o.status,e.cliVersion));if(c)t.push(`Extension connection is unstable. The live browser test succeeded, but the daemon reported the extension disconnected immediately afterward.
+This usually means the Browser Bridge service worker is reconnecting slowly or Chrome suspended it.`);else if(i&&!u)if(o.state==="profile-required")t.push(`Multiple Chrome profiles are connected to the daemon, but no default profile was selected.
   Run ppcli profile list, then ppcli profile use <name>, or pass --profile <name>.`);else if(o.state==="profile-disconnected")t.push(`Selected browser profile is not connected: ${o.status?.contextId??"unknown"}.
   Open that Chrome profile and make sure the ppcli extension is enabled.`);else t.push(`Daemon is running but the Chrome/Chromium extension is not connected.
 If the extension is already installed, try: ppcli daemon restart
 If the extension is not installed, install the PublishPort browser extension
-from the PublishPort desktop app.`);if(a&&!r)t.push(`Extension is connected but did not report a version.
+from the PublishPort desktop app.`);if(u&&!a)t.push(`Extension is connected but did not report a version.
   This usually means an outdated Browser Bridge extension.
-  Reload or reinstall the PublishPort browser extension via the PublishPort desktop app.`);if(!n.ok)t.push(`Browser connectivity test failed: ${n.error??"unknown"}`);const m=o.status?.extensionCompatRange;if(r&&e.cliVersion&&m){if(!O(e.cliVersion,m))t.push(`CLI version incompatible with extension: extension v${r} requires CLI ${m}, but CLI is v${e.cliVersion}
-  Update via the PublishPort desktop app (or: npm install -g publishport-ppcli).`)}else if(r&&e.cliVersion){const x=r.split(".")[0],w=e.cliVersion.split(".")[0];if(x!==w)t.push(`Extension major version mismatch: extension v${r} ≠ CLI v${e.cliVersion}
-  Update the PublishPort browser extension via the PublishPort desktop app.`)}if(d.length>0)t.push(P(d));return{cliVersion:e.cliVersion,daemonRunning:s,daemonFlaky:c,daemonStale:i,daemonVersion:o.status?.daemonVersion,extensionConnected:a,extensionFlaky:l,extensionVersion:r,connectivity:n,profiles:u,adapterShadows:d,issues:t}}export function renderBrowserDoctorReport(e){const n=[`ppcli v${e.cliVersion??"unknown"} doctor (${k()})`,""],o=e.daemonFlaky?"[WARN]":e.daemonStale?"[WARN]":e.daemonRunning?"[OK]":"[MISSING]",s=e.daemonFlaky?"unstable (running during live check, then stopped)":e.daemonRunning?`running on port ${v} (${e.daemonStale?`${f(e)}, stale; CLI v${e.cliVersion??"unknown"}`:f(e)})`:"not running";n.push(`${o} Daemon: ${s}`);const a=e.extensionFlaky||e.extensionConnected&&!e.extensionVersion?"[WARN]":e.extensionConnected?"[OK]":"[MISSING]",c=!e.extensionConnected?"":e.extensionVersion?` (v${e.extensionVersion})`:" (version unknown)",l=e.extensionFlaky?"unstable (connected during live check, then disconnected)":e.extensionConnected?"connected":"not connected";n.push(`${a} Extension: ${l}${c}`);if(e.profiles&&e.profiles.length>0){const i=C();n.push("","Profiles:");for(const u of e.profiles){const r=I(i,u.contextId),d=r?` (${r})`:"",t=i.defaultContextId===u.contextId?", default":"",m=u.extensionVersion?`v${u.extensionVersion}`:"version unknown";n.push(`  • ${u.contextId}${d}: connected ${m}${t}`)}}if(e.connectivity){const i=e.connectivity.ok?"[OK]":"[FAIL]",u=e.connectivity.ok?`connected in ${(e.connectivity.durationMs/1000).toFixed(1)}s`:`failed (${e.connectivity.error??"unknown"})`;n.push(`${i} Connectivity: ${u}`)}if(e.issues.length){n.push("","Issues:");for(const i of e.issues)n.push(`  • ${i}`)}else if(e.daemonRunning&&e.extensionConnected)n.push("","Everything looks good!");return n.join(`
+  Reload or reinstall the PublishPort browser extension via the PublishPort desktop app.`);if(!n.ok)t.push(`Browser connectivity test failed: ${n.error??"unknown"}`);const m=o.status?.extensionCompatRange;if(a&&e.cliVersion&&m){if(!O(e.cliVersion,m))t.push(`CLI version incompatible with extension: extension v${a} requires CLI ${m}, but CLI is v${e.cliVersion}
+  Update via the PublishPort desktop app (or: npm install -g publishport-ppcli).`)}else if(a&&e.cliVersion){const x=a.split(".")[0],v=e.cliVersion.split(".")[0];if(x!==v)t.push(`Extension major version mismatch: extension v${a} ≠ CLI v${e.cliVersion}
+  Update the PublishPort browser extension via the PublishPort desktop app.`)}if(d.length>0)t.push(P(d));return{cliVersion:e.cliVersion,daemonRunning:i,daemonFlaky:r,daemonStale:s,daemonVersion:o.status?.daemonVersion,extensionConnected:u,extensionFlaky:c,extensionVersion:a,connectivity:n,profiles:l,adapterShadows:d,issues:t}}export function renderBrowserDoctorReport(e){const n=[`ppcli v${e.cliVersion??"unknown"} doctor (${k()})`,""],o=e.daemonFlaky?"[WARN]":e.daemonStale?"[WARN]":e.daemonRunning?"[OK]":"[MISSING]",i=e.daemonFlaky?"unstable (running during live check, then stopped)":e.daemonRunning?`running on port ${w} (${e.daemonStale?`${f(e)}, stale; CLI v${e.cliVersion??"unknown"}`:f(e)})`:"not running";n.push(`${o} Daemon: ${i}`);const u=e.extensionFlaky||e.extensionConnected&&!e.extensionVersion?"[WARN]":e.extensionConnected?"[OK]":"[MISSING]",r=!e.extensionConnected?"":e.extensionVersion?` (v${e.extensionVersion})`:" (version unknown)",c=e.extensionFlaky?"unstable (connected during live check, then disconnected)":e.extensionConnected?"connected":"not connected";n.push(`${u} Extension: ${c}${r}`);if(e.profiles&&e.profiles.length>0){const s=I();n.push("","Profiles:");for(const l of e.profiles){const a=C(s,l.contextId),d=a?` (${a})`:"",t=s.defaultContextId===l.contextId?", default":"",m=l.extensionVersion?`v${l.extensionVersion}`:"version unknown";n.push(`  • ${l.contextId}${d}: connected ${m}${t}`)}}if(e.connectivity){const s=e.connectivity.ok?"[OK]":"[FAIL]",l=e.connectivity.ok?`connected in ${(e.connectivity.durationMs/1000).toFixed(1)}s`:`failed (${e.connectivity.error??"unknown"})`;n.push(`${s} Connectivity: ${l}`)}if(e.issues.length){n.push("","Issues:");for(const s of e.issues)n.push(`  • ${s}`)}else if(e.daemonRunning&&e.extensionConnected)n.push("","Everything looks good!");return n.join(`
 `)}

package/dist/src/errors.js

@@ -1,2 +1,2 @@
-export const EXIT_CODES={SUCCESS:0,GENERIC_ERROR:1,USAGE_ERROR:2,EMPTY_RESULT:66,SERVICE_UNAVAIL:69,TEMPFAIL:75,NOPERM:77,CONFIG_ERROR:78,INTERRUPTED:130};export class CliError extends Error{code;hint;exitCode;constructor(e,t,n,o=EXIT_CODES.GENERIC_ERROR){super(t);this.name=new.target.name;this.code=e;this.hint=n;this.exitCode=o}}const r=Symbol.for("ppcli.traceReceipt");export function attachTraceReceipt(e,t){if(!e||typeof e!=="object"&&typeof e!=="function")return;try{Object.defineProperty(e,r,{value:t,enumerable:!1,configurable:!0})}catch{}}export function getTraceReceipt(e){if(!e||typeof e!=="object"&&typeof e!=="function")return;return e[r]}export class BrowserConnectError extends CliError{kind;constructor(e,t,n="unknown"){super("BROWSER_CONNECT",e,t,EXIT_CODES.SERVICE_UNAVAIL);this.kind=n}}export class CommandExecutionError extends CliError{constructor(e,t){super("COMMAND_EXEC",e,t,EXIT_CODES.GENERIC_ERROR)}}export class ConfigError extends CliError{constructor(e,t){super("CONFIG",e,t,EXIT_CODES.CONFIG_ERROR)}}export class AuthRequiredError extends CliError{domain;constructor(e,t){super("AUTH_REQUIRED",t??`Not logged in to ${e}`,`Please open Chrome or Chromium and log in to https://${e}`,EXIT_CODES.NOPERM);this.domain=e}}export class TimeoutError extends CliError{constructor(e,t,n){super("TIMEOUT",`${e} timed out after ${t}s`,n??"Try again, or increase timeout with --timeout <seconds> (or OPENCLI_BROWSER_COMMAND_TIMEOUT for the global default)",EXIT_CODES.TEMPFAIL)}}export class RateLimitError extends CliError{constructor(e,t,n){const o=c(t);super("RATE_LIMITED",`Rate limit exceeded for ${e}`,`Retry after ${o}. To change this limit, edit ${n}.`,EXIT_CODES.TEMPFAIL)}}export class ArgumentError extends CliError{constructor(e,t){super("ARGUMENT",e,t,EXIT_CODES.USAGE_ERROR)}}export class SessionBusyError extends CliError{constructor(e,t){super("SESSION_BUSY",e,t,EXIT_CODES.TEMPFAIL)}}export class EmptyResultError extends CliError{constructor(e,t){super("EMPTY_RESULT",`${e} returned no data`,t??"This usually means the target genuinely has no matching content — "+"an empty result is a valid answer, not a failure, and can be relied on (e.g. no comments found = this account has not commented there). Only suspect a broken adapter or expired login if you have other evidence that content should be there.",EXIT_CODES.EMPTY_RESULT)}}export function adapterLoadError(e,t){return new CliError("ADAPTER_LOAD",e,t,EXIT_CODES.SERVICE_UNAVAIL)}export function selectorError(e,t){return new CliError("SELECTOR",`Could not find element: ${e}`,t??"The page UI may have changed. Please report this issue.",EXIT_CODES.GENERIC_ERROR)}export class PluginError extends CliError{constructor(e,t){super("PLUGIN",e,t,EXIT_CODES.GENERIC_ERROR)}}function c(e){const t=Math.max(0,Math.ceil(e));if(t<1000)return`${t}ms`;const n=Math.ceil(t/1000);if(n<60)return`${n}s`;const o=Math.ceil(n/60);if(o<60)return`${o}m`;return`${Math.ceil(o/60)}h`}export class LoginWallError extends CliError{status;url;bodyPreview;constructor(e,t,n,o,s){super("LOGIN_WALL",e,s??"The server returned an HTML page instead of JSON — likely a login wall, rate limit, or WAF challenge. Try re-logging in via your browser, or wait a few minutes before retrying.",EXIT_CODES.NOPERM);this.status=t;this.url=n;this.bodyPreview=o}}export function getErrorMessage(e){return e instanceof Error?e.message:String(e)}function a(e,t=0){if(t>10)return"(cause chain truncated)";if(e instanceof Error){const n=[e.message];if(e.cause)n.push(`  caused by: ${a(e.cause,t+1)}`);return n.join(`
-`)}return String(e)}export function toEnvelope(e){const t=e instanceof Error&&e.cause?a(e.cause):void 0,n=getTraceReceipt(e),o=n?{traceId:n.traceId,dir:n.traceDir,summaryPath:n.summaryPath,receiptPath:n.receiptPath,status:n.status}:void 0;if(e instanceof CliError)return{ok:!1,error:{code:e.code,message:e.message,...e.hint?{help:e.hint}:{},exitCode:e.exitCode,...t?{cause:t}:{}},...o?{trace:o}:{}};return{ok:!1,error:{code:"UNKNOWN",message:getErrorMessage(e),exitCode:EXIT_CODES.GENERIC_ERROR,...t?{cause:t}:{}},...o?{trace:o}:{}}}
+export const EXIT_CODES={SUCCESS:0,GENERIC_ERROR:1,USAGE_ERROR:2,EMPTY_RESULT:66,SERVICE_UNAVAIL:69,TEMPFAIL:75,NOPERM:77,CONFIG_ERROR:78,INTERRUPTED:130};export class CliError extends Error{code;hint;exitCode;constructor(e,t,n,o=EXIT_CODES.GENERIC_ERROR){super(t);this.name=new.target.name;this.code=e;this.hint=n;this.exitCode=o}}const a=Symbol.for("ppcli.traceReceipt");export function attachTraceReceipt(e,t){if(!e||typeof e!=="object"&&typeof e!=="function")return;try{Object.defineProperty(e,a,{value:t,enumerable:!1,configurable:!0})}catch{}}export function getTraceReceipt(e){if(!e||typeof e!=="object"&&typeof e!=="function")return;return e[a]}export class BrowserConnectError extends CliError{kind;constructor(e,t,n="unknown"){super("BROWSER_CONNECT",e,t,EXIT_CODES.SERVICE_UNAVAIL);this.kind=n}}export class CommandExecutionError extends CliError{constructor(e,t){super("COMMAND_EXEC",e,t,EXIT_CODES.GENERIC_ERROR)}}export class ConfigError extends CliError{constructor(e,t){super("CONFIG",e,t,EXIT_CODES.CONFIG_ERROR)}}export class AuthRequiredError extends CliError{domain;constructor(e,t){super("AUTH_REQUIRED",t??`Not logged in to ${e}`,`Please open Chrome or Chromium and log in to https://${e}`,EXIT_CODES.NOPERM);this.domain=e}}export class TimeoutError extends CliError{constructor(e,t,n){super("TIMEOUT",`${e} timed out after ${t}s`,n??"Try again, or increase timeout with --timeout <seconds> (or OPENCLI_BROWSER_COMMAND_TIMEOUT for the global default)",EXIT_CODES.TEMPFAIL)}}export class RateLimitError extends CliError{constructor(e,t,n){const o=i(t);super("RATE_LIMITED",`Rate limit exceeded for ${e}`,`Retry after ${o}. To change this limit, edit ${n}.`,EXIT_CODES.TEMPFAIL)}}export class ArgumentError extends CliError{constructor(e,t){super("ARGUMENT",e,t,EXIT_CODES.USAGE_ERROR)}}export class SessionBusyError extends CliError{constructor(e,t){super("SESSION_BUSY",e,t,EXIT_CODES.TEMPFAIL)}}export class EmptyResultError extends CliError{constructor(e,t){super("EMPTY_RESULT",`${e} returned no data`,t??"This usually means the target genuinely has no matching content — "+"an empty result is a valid answer, not a failure, and can be relied on (e.g. no comments found = this account has not commented there). Only suspect a broken adapter or expired login if you have other evidence that content should be there.",EXIT_CODES.EMPTY_RESULT)}}export function adapterLoadError(e,t){return new CliError("ADAPTER_LOAD",e,t,EXIT_CODES.SERVICE_UNAVAIL)}export function selectorError(e,t){return new CliError("SELECTOR",`Could not find element: ${e}`,t??"The page UI may have changed. Please report this issue.",EXIT_CODES.GENERIC_ERROR)}export class PluginError extends CliError{constructor(e,t){super("PLUGIN",e,t,EXIT_CODES.GENERIC_ERROR)}}function i(e){const t=Math.max(0,Math.ceil(e));if(t<1000)return`${t}ms`;const n=Math.ceil(t/1000);if(n<60)return`${n}s`;const o=Math.ceil(n/60);if(o<60)return`${o}m`;return`${Math.ceil(o/60)}h`}export class LoginWallError extends CliError{status;url;bodyPreview;constructor(e,t,n,o,r){super("LOGIN_WALL",e,r??"The server returned an HTML page instead of JSON — likely a login wall, rate limit, or WAF challenge. Try re-logging in via your browser, or wait a few minutes before retrying.",EXIT_CODES.NOPERM);this.status=t;this.url=n;this.bodyPreview=o}}export function getErrorMessage(e){return e instanceof Error?e.message:String(e)}function c(e,t=0){if(t>10)return"(cause chain truncated)";if(e instanceof Error){const n=[e.message];if(e.cause)n.push(`  caused by: ${c(e.cause,t+1)}`);return n.join(`
+`)}return String(e)}export function toEnvelope(e){const t=e instanceof Error&&e.cause?c(e.cause):void 0,n=getTraceReceipt(e),o=n?{traceId:n.traceId,dir:n.traceDir,summaryPath:n.summaryPath,receiptPath:n.receiptPath,status:n.status}:void 0,r=e!==null&&typeof e==="object"&&typeof e.code==="string"&&typeof e.message==="string"&&typeof e.exitCode==="number";if(e instanceof CliError||r){const s=e;return{ok:!1,error:{code:s.code,message:s.message,...typeof s.hint==="string"&&s.hint?{help:s.hint}:{},exitCode:s.exitCode??EXIT_CODES.GENERIC_ERROR,...t?{cause:t}:{}},...o?{trace:o}:{}}}return{ok:!1,error:{code:"UNKNOWN",message:getErrorMessage(e),exitCode:EXIT_CODES.GENERIC_ERROR,...t?{cause:t}:{}},...o?{trace:o}:{}}}

package/dist/src/execution.js

@@ -1,2 +1,2 @@
-import{getRegistry as oe,fullName as g}from"./registry.js";import{pathToFileURL as ie}from"node:url";import*as se from"node:crypto";import*as N from"node:fs";import*as j from"node:os";import*as M from"node:path";import{executePipeline as V}from"./pipeline/index.js";import{adapterLoadError as ae,ArgumentError as d,CommandExecutionError as x,SessionBusyError as ce,attachTraceReceipt as ue,getErrorMessage as D}from"./errors.js";import{shouldUseBrowserSession as le}from"./capabilityRouting.js";import{getBrowserFactory as fe,browserSession as me,runWithTimeout as G,DEFAULT_BROWSER_COMMAND_TIMEOUT as de}from"./runtime.js";import{withBrowserSessionLockIf as pe}from"./browser-session-lock.js";import{resolveProfile as he}from"./browser/profile.js";import{ensureManagedChrome as we}from"./browser/managed-chrome.js";import{generateFingerprintJs as ge}from"./browser/fingerprint.js";import{CDPBridge as ye}from"./browser/index.js";import{clearDaemonRunContext as ve,generateRunId as Se,isUnknownOutcomeError as J,releaseSiteSessionLease as K,setDaemonCommandTimeoutSeconds as be,setDaemonRunContext as Q}from"./browser/daemon-client.js";import{emitHook as k}from"./hooks.js";import{setContentBaseDir as $e}from"./utils.js";import{log as X}from"./logger.js";import{isElectronApp as Ee}from"./electron-apps.js";import{probeCDP as Pe,resolveElectronEndpoint as xe}from"./launcher.js";import{ObservationSession as Ae,exportObservationSession as Ce}from"./observation/index.js";import{resolveAdapterSourcePath as Te}from"./adapter-source.js";const S=new Map,B=new Map,Re=`${j.homedir()}/.ppcli/clis/`;function Ie(e){if(e===void 0||e===null||e===""||e==="off")return"off";if(e==="on"||e==="retain-on-failure")return e;throw new d(`--trace must be one of: off, on, retain-on-failure. Received: "${String(e)}"`)}export function coerceAndValidateArgs(e,t){const r={...t};for(const n of e){const o=r[n.name];if(n.required&&(o===void 0||o===null||o===""))throw new d(`Argument "${n.name}" is required.`,n.help??`Provide a value for --${n.name}`);if(o!==void 0&&o!==null){if(n.type==="int"||n.type==="number"){const f=Number(o);if(Number.isNaN(f))throw new d(`Argument "${n.name}" must be a valid number. Received: "${o}"`);r[n.name]=f}else if(n.type==="boolean"||n.type==="bool")if(typeof o==="string"){const f=o.toLowerCase();if(f==="true"||f==="1")r[n.name]=!0;else if(f==="false"||f==="0")r[n.name]=!1;else throw new d(`Argument "${n.name}" must be a boolean (true/false). Received: "${o}"`)}else r[n.name]=Boolean(o);const s=r[n.name];if(n.choices&&n.choices.length>0){if(!n.choices.map(String).includes(String(s)))throw new d(`Argument "${n.name}" must be one of: ${n.choices.join(", ")}. Received: "${s}"`)}}else if(n.default!==void 0)r[n.name]=n.default}return r}async function U(e,t,r,n){const o=e;if(o._lazy&&o._modulePath){const s=o._modulePath;if(s.startsWith(Re)&&S.has(s))try{const m=N.statSync(s),i=B.get(s);if(i!==void 0&&m.mtimeMs!==i)S.delete(s)}catch{}if(!S.has(s)){const m=ie(s).href,w=import(B.has(s)?`${m}?t=${Date.now()}`:m).then(()=>{try{B.set(s,N.statSync(s).mtimeMs)}catch{}},(p)=>{S.delete(s);throw ae(`Failed to load adapter module ${s}: ${D(p)}`,"Check that the adapter file exists and has no syntax errors.")});S.set(s,w)}await S.get(s);const u=oe().get(g(e));if(u?.func)return Y(u,t,r,n);if(u?.pipeline)return V(t,u.pipeline,{args:r,debug:n})}if(e.func)return Y(e,t,r,n);if(e.pipeline)return V(t,e.pipeline,{args:r,debug:n});throw new x(`Command ${g(e)} has no func or pipeline`,"This is likely a bug in the adapter definition. Please report this issue.")}function Y(e,t,r,n){if(e.browser===!1)return e.func(r,n);if(!t)throw new x(`Command ${g(e)} requires a browser session but none was provided`);return e.func(t,r,n)}function Ne(e){if(e.navigateBefore===!1)return null;if(typeof e.navigateBefore==="string")return e.navigateBefore;return null}function Me(e,t){if(!e||!t)return!1;try{const r=new URL(e).hostname;return r===t||r.endsWith(`.${t}`)}catch{return!1}}function De(e,t){if(!t)return!1;try{const r=new URL(e),n=r.hostname===t||r.hostname.endsWith(`.${t}`),o=r.pathname===""||r.pathname==="/";return n&&o&&r.search===""&&r.hash===""}catch{return!1}}async function ke(e,t,r,n){if(r!=="persistent"||!e.domain)return!0;if(!De(n,e.domain))return!0;const o=await t.getCurrentUrl?.().catch(()=>null);return!Me(o,e.domain)}export async function executeCommand(e,t,r=!1,n={}){let o;try{o=n.prepared?t:prepareCommandArgs(e,t)}catch(i){if(i instanceof d)throw i;throw new d(D(i))}const s=qe(e,o);be(s);const f=Ie(n.trace),u={command:g(e),args:o,startedAt:Date.now()};await k("onBeforeExecute",u);let m;try{if(le(e)){const i=Ee(e.site),w=he(n.profile),p=!i&&w.kind==="managed"?w:null;let P;const A=Le(e.defaultWindowMode??"background",n.windowMode);let F,W;if(p){P=await we(p.name,p.entry,{windowMode:A});const c=p.entry.fingerprint;if(c?.enabled)F=ge(c);const a=p.entry.proxy;if(a?.username)W={username:a.username,password:a.password??""}}else if(i){const c=process.env.OPENCLI_CDP_ENDPOINT;if(c){const a=Number(new URL(c).port);if(!await Pe(a))throw new x(`CDP not reachable at ${c}`,"Check that the app is running with --remote-debugging-port and the endpoint is correct.");P=c}else P=await xe(e.site)}const re=p?ye:fe(e.site),L=!p&&w.kind==="extension"?w.contextId:void 0,ne=e,b=_e(e,n.siteSession),C=Oe(e,b),q=We(b,n.keepTab),y=b==="persistent"&&e.access==="write"?{runId:Se(),session:C}:null;if(y)Q({runId:y.runId,command:g(e),access:"write"});let z,H=!1,T=null;try{m=await pe(A!=="foreground",()=>me(re,async(c)=>{const a=f==="off"?null:new Ae({scope:{contextId:L??p?.name,session:C,target:c.getActivePage?.(),site:e.site,command:g(e),adapterSourcePath:Te(ne)}});if(a){a.record({stream:"action",name:"command",phase:"start",data:{args:o}});await c.startNetworkCapture?.().catch(()=>!1)}const h=Ne(e);if(h&&await ke(e,c,b,h)){a?.record({stream:"action",name:"pre_navigate",phase:"start",data:{url:h}});try{await c.goto(h);a?.record({stream:"action",name:"pre_navigate",phase:"end",data:{url:h}})}catch(l){if(l instanceof ce)throw l;a?.record({stream:"action",name:"pre_navigate",phase:"error",data:{url:h,error:l instanceof Error?l.message:String(l)}});const v=new x(`Pre-navigation to ${h} failed: ${l instanceof Error?l.message:l}`,"Check that the site is reachable and the browser extension is running.");v.cause=l;if(a&&(f==="on"||f==="retain-on-failure")){a.record({stream:"error",message:v.message,stack:v.stack,code:v.code,hint:v.hint});await _(a,c).catch(()=>{});O(a,"failure",v,n.onTraceExport)}throw v}}const E=s!==null?s+Z:de,R=U(e,c,o,r);T=R;let I=!1;R.then(()=>{I=!0},()=>{I=!0});try{const l=await G(R,{timeout:E,label:g(e),hint:te(e,s)});a?.record({stream:"action",name:"command",phase:"end"});if(a&&f==="on"){await _(a,c).catch(()=>{});O(a,"success",void 0,n.onTraceExport)}if(!q)await c.closeWindow?.().catch(()=>{});return l}catch(l){if(!I)H=!0;if(a){a.record({stream:"action",name:"command",phase:"error",data:{error:l instanceof Error?l.message:String(l)}});a.record({stream:"error",message:l instanceof Error?l.message:String(l),stack:l instanceof Error?l.stack:void 0});if(f==="on"||f==="retain-on-failure"){await _(a,c).catch(()=>{});O(a,"failure",l,n.onTraceExport)}}if(!q)await c.closeWindow?.().catch(()=>{});throw l}},{session:C,cdpEndpoint:P,contextId:L,windowMode:A,surface:"adapter",siteSession:b,initScript:F,proxyAuth:W}),p?.name)}catch(c){z=c;throw c}finally{if(y)if(H&&T){const{runId:c,session:a}=y,h=(E)=>{ve(c);if(!J(E))K({runId:c,session:a,surface:"adapter"})};T.then(()=>h(),(E)=>h(E))}else{Q(null);if(!J(z))await K({runId:y.runId,session:y.session,surface:"adapter"})}}}else if(s!==null){const i=s+Z;m=await G(U(e,null,o,r),{timeout:i,label:g(e),hint:te(e,s)})}else m=await U(e,null,o,r)}catch(i){u.error=i;u.finishedAt=Date.now();await k("onAfterExecute",u);throw i}u.finishedAt=Date.now();await k("onAfterExecute",u,m);return m}async function _(e,t){const r=t.getActivePage?.()??e.scope.target,[n,o,s,f,u]=await Promise.all([t.getCurrentUrl?.().catch(()=>null)??Promise.resolve(null),t.snapshot().catch(()=>{return}),t.readNetworkCapture?.().catch(()=>[])??Promise.resolve([]),t.consoleMessages("all").catch(()=>[]),t.screenshot({format:"png"}).catch(()=>{return})]);if(o!==void 0||n!==void 0)e.record({stream:"state",url:n,target:r,snapshot:o,label:"final"});for(const m of Array.isArray(s)?s:[]){const i=m;e.record({stream:"network",url:String(i.url??""),method:typeof i.method==="string"?i.method:void 0,status:typeof i.responseStatus==="number"?i.responseStatus:void 0,contentType:typeof i.responseContentType==="string"?i.responseContentType:void 0,size:typeof i.responseBodyFullSize==="number"?i.responseBodyFullSize:void 0,requestHeaders:i.requestHeaders,responseHeaders:i.responseHeaders,requestBody:i.requestBodyPreview,responseBody:i.responsePreview,ts:typeof i.timestamp==="number"?i.timestamp:void 0})}for(const m of Array.isArray(f)?f:[])if(m&&typeof m==="object"){const i=m;e.record({stream:"console",level:String(i.type??i.level??"log"),text:String(i.text??i.message??""),ts:typeof i.timestamp==="number"?i.timestamp:void 0})}else e.record({stream:"console",level:"log",text:String(m)});if(typeof u==="string"&&u)e.record({stream:"screenshot",format:"png",data:u,label:"final"})}function O(e,t,r,n){try{const o=Ce(e,{error:r,status:t});if(t==="failure"&&r!==void 0)ue(r,o.receipt);else process.stderr.write(`ppcli trace artifact: ${o.dir}
-`);try{n?.(o)}catch(s){X.warn(`[trace] Trace export callback failed: ${s instanceof Error?s.message:String(s)}`)}return o}catch(o){X.warn(`[trace] Failed to export trace artifact: ${o instanceof Error?o.message:String(o)}`);return}}export function resolveFileBackedArg(e,t){const r=e.args.find((u)=>u.fromFile);if(!r)return;const n=typeof r.fromFile==="string"?r.fromFile:"file",o=r.positional?`<${r.name}>`:`--${r.name}`,s=t[n]==null?"":String(t[n]).trim(),f=t[r.name]==null?"":String(t[r.name]);if(s){if(f.trim())throw new d(`${o} 和 --${n} 只能二选一，不能同时给`);const u=M.resolve(s.startsWith("~/")?M.join(j.homedir(),s.slice(2)):s);let m;try{m=N.readFileSync(u,"utf-8")}catch(w){throw new d(`--${n} 指向的文件读不到: ${u}（${D(w)}）`)}const i=m.trim();if(!i)throw new d(`--${n} 指向的文件内容为空: ${u}`);t[r.name]=i;$e(M.dirname(u));return}if(!f.trim()&&r.requiredUnlessFile)throw new d(`缺少 ${r.name}：${o} 或 --${n} 给其一`)}export function prepareCommandArgs(e,t){const r=coerceAndValidateArgs(e.args,t);resolveFileBackedArg(e,r);e.validateArgs?.(r);return r}const Z=30;function Be(e){if(e===void 0||e===null||e==="")return null;if(e==="ephemeral"||e==="persistent")return e;throw new d(`--site-session must be one of: ephemeral, persistent. Received: "${String(e)}"`)}function Ue(){const e=process.env.PUBLISHPORT_SITE_SESSION;if(e==="persistent"||e==="ephemeral")return e;return null}function _e(e,t){return Be(t)??Ue()??e.siteSession??"persistent"}function Oe(e,t){if(t==="persistent")return`site:${e.site}`;return`site:${e.site}:${se.randomUUID()}`}function Fe(e,t){if(t===void 0||t==="")return null;if(t==="true")return!0;if(t==="false")return!1;throw new d(`${e} must be one of: true, false. Received: "${String(t)}"`)}function We(e,t){if(e==="persistent")return!0;return Fe("--keep-tab",t)??!1}function ee(e,t){if(t===void 0||t==="")return null;if(t==="foreground"||t==="background")return t;throw new d(`${e} must be one of: foreground, background. Received: "${String(t)}"`)}function Le(e="background",t){return ee("--window",t)??ee("OPENCLI_WINDOW",process.env.OPENCLI_WINDOW)??e}function te(e,t){const r=e.access==="write"?"⚠️ 这是写操作，超时不代表没写成功——请求可能已经到达平台。禁止直接重试："+"先用该平台的列表/统计命令（stats / lists / articles 等）按标题回查，确认没写进去再重发。 ":"";if(t!==null)return`${r}Pass a higher --timeout value (currently ${t}s)`;if(e.args.some((n)=>n.name==="timeout"))return`${r}Try again, or pass a higher --timeout <seconds>`;return r+"This command has no --timeout option. Retry once; if it keeps timing out, "+"the page or browser bridge is likely stuck — have the user reopen the PublishPort client. "+"The global default can be raised with OPENCLI_BROWSER_COMMAND_TIMEOUT."}function qe(e,t){if(!e.args.some((o)=>o.name==="timeout"))return null;const r=t.timeout;if(r===void 0||r===null||r==="")throw new d(`Argument "timeout" must be a positive integer. Received: "${String(r)}"`);const n=Number(r);if(!Number.isInteger(n)||n<=0)throw new d(`Argument "timeout" must be a positive integer. Received: "${String(r)}"`);return n}
+import{getRegistry as oe,fullName as g}from"./registry.js";import{pathToFileURL as ie}from"node:url";import*as se from"node:crypto";import*as M from"node:fs";import*as j from"node:os";import*as N from"node:path";import{executePipeline as V}from"./pipeline/index.js";import{adapterLoadError as ae,ArgumentError as d,CommandExecutionError as x,SessionBusyError as ce,attachTraceReceipt as ue,getErrorMessage as D}from"./errors.js";import{shouldUseBrowserSession as le}from"./capabilityRouting.js";import{getBrowserFactory as fe,browserSession as me,runWithTimeout as G,DEFAULT_BROWSER_COMMAND_TIMEOUT as de}from"./runtime.js";import{withBrowserSessionLockIf as pe}from"./browser-session-lock.js";import{resolveProfile as he}from"./browser/profile.js";import{ensureManagedChrome as we}from"./browser/managed-chrome.js";import{generateFingerprintJs as ge}from"./browser/fingerprint.js";import{CDPBridge as ye}from"./browser/index.js";import{clearDaemonRunContext as ve,generateRunId as Se,isUnknownOutcomeError as J,releaseSiteSessionLease as K,setDaemonCommandTimeoutSeconds as be,setDaemonRunContext as Q}from"./browser/daemon-client.js";import{emitHook as k}from"./hooks.js";import{setContentBaseDir as $e}from"./utils.js";import{log as X}from"./logger.js";import{isElectronApp as Ee}from"./electron-apps.js";import{probeCDP as Pe,resolveElectronEndpoint as xe}from"./launcher.js";import{ObservationSession as Ae,exportObservationSession as Ce}from"./observation/index.js";import{resolveAdapterSourcePath as Re}from"./adapter-source.js";const S=new Map,B=new Map,Te=`${j.homedir()}/.ppcli/clis/`;function Ie(e){if(e===void 0||e===null||e===""||e==="off")return"off";if(e==="on"||e==="retain-on-failure")return e;throw new d(`--trace must be one of: off, on, retain-on-failure. Received: "${String(e)}"`)}export function coerceAndValidateArgs(e,t){const n={...t};for(const r of e){const o=n[r.name];if(r.required&&(o===void 0||o===null||o===""))throw new d(`Argument "${r.name}" is required.`,r.help??`Provide a value for --${r.name}`);if(o!==void 0&&o!==null){if(r.type==="int"||r.type==="number"){const u=Number(o);if(!Number.isFinite(u))throw new d(`Argument "${r.name}" must be a valid number. Received: "${o}"`);if(r.type==="int"&&!Number.isInteger(u))throw new d(`Argument "${r.name}" must be a valid integer. Received: "${o}"`);n[r.name]=u}else if(r.type==="boolean"||r.type==="bool")if(typeof o==="string"){const u=o.toLowerCase();if(u==="true"||u==="1")n[r.name]=!0;else if(u==="false"||u==="0")n[r.name]=!1;else throw new d(`Argument "${r.name}" must be a boolean (true/false). Received: "${o}"`)}else n[r.name]=Boolean(o);const s=n[r.name];if(r.choices&&r.choices.length>0){if(!r.choices.map(String).includes(String(s)))throw new d(`Argument "${r.name}" must be one of: ${r.choices.join(", ")}. Received: "${s}"`)}}else if(r.default!==void 0)n[r.name]=r.default}return n}async function U(e,t,n,r){const o=e;if(o._lazy&&o._modulePath){const s=o._modulePath;if(s.startsWith(Te)&&S.has(s))try{const m=M.statSync(s),i=B.get(s);if(i!==void 0&&m.mtimeMs!==i)S.delete(s)}catch{}if(!S.has(s)){const m=ie(s).href,w=import(B.has(s)?`${m}?t=${Date.now()}`:m).then(()=>{try{B.set(s,M.statSync(s).mtimeMs)}catch{}},(p)=>{S.delete(s);throw ae(`Failed to load adapter module ${s}: ${D(p)}`,"Check that the adapter file exists and has no syntax errors.")});S.set(s,w)}await S.get(s);const l=oe().get(g(e));if(l?.func)return Y(l,t,n,r);if(l?.pipeline)return V(t,l.pipeline,{args:n,debug:r})}if(e.func)return Y(e,t,n,r);if(e.pipeline)return V(t,e.pipeline,{args:n,debug:r});throw new x(`Command ${g(e)} has no func or pipeline`,"This is likely a bug in the adapter definition. Please report this issue.")}function Y(e,t,n,r){if(e.browser===!1)return e.func(n,r);if(!t)throw new x(`Command ${g(e)} requires a browser session but none was provided`);return e.func(t,n,r)}function Me(e){if(e.navigateBefore===!1)return null;if(typeof e.navigateBefore==="string")return e.navigateBefore;return null}function Ne(e,t){if(!e||!t)return!1;try{const n=new URL(e).hostname;return n===t||n.endsWith(`.${t}`)}catch{return!1}}function De(e,t){if(!t)return!1;try{const n=new URL(e),r=n.hostname===t||n.hostname.endsWith(`.${t}`),o=n.pathname===""||n.pathname==="/";return r&&o&&n.search===""&&n.hash===""}catch{return!1}}async function ke(e,t,n,r){if(n!=="persistent"||!e.domain)return!0;if(!De(r,e.domain))return!0;const o=await t.getCurrentUrl?.().catch(()=>null);return!Ne(o,e.domain)}export async function executeCommand(e,t,n=!1,r={}){let o;try{o=r.prepared?t:prepareCommandArgs(e,t)}catch(i){if(i instanceof d)throw i;throw new d(D(i))}const s=qe(e,o);be(s);const u=Ie(r.trace),l={command:g(e),args:o,startedAt:Date.now()};await k("onBeforeExecute",l);let m;try{if(le(e)){const i=Ee(e.site),w=he(r.profile),p=!i&&w.kind==="managed"?w:null;let P;const A=Le(e.defaultWindowMode??"background",r.windowMode);let F,W;if(p){P=await we(p.name,p.entry,{windowMode:A});const c=p.entry.fingerprint;if(c?.enabled)F=ge(c);const a=p.entry.proxy;if(a?.username)W={username:a.username,password:a.password??""}}else if(i){const c=process.env.OPENCLI_CDP_ENDPOINT;if(c){const a=Number(new URL(c).port);if(!await Pe(a))throw new x(`CDP not reachable at ${c}`,"Check that the app is running with --remote-debugging-port and the endpoint is correct.");P=c}else P=await xe(e.site)}const re=p?ye:fe(e.site),L=!p&&w.kind==="extension"?w.contextId:void 0,ne=e,b=_e(e,r.siteSession),C=Oe(e,b),q=We(b,r.keepTab),y=b==="persistent"&&e.access==="write"?{runId:Se(),session:C}:null;if(y)Q({runId:y.runId,command:g(e),access:"write"});let z,H=!1,R=null;try{m=await pe(A!=="foreground",()=>me(re,async(c)=>{const a=u==="off"?null:new Ae({scope:{contextId:L??p?.name,session:C,target:c.getActivePage?.(),site:e.site,command:g(e),adapterSourcePath:Re(ne)}});if(a){a.record({stream:"action",name:"command",phase:"start",data:{args:o}});await c.startNetworkCapture?.().catch(()=>!1)}const h=Me(e);if(h&&await ke(e,c,b,h)){a?.record({stream:"action",name:"pre_navigate",phase:"start",data:{url:h}});try{await c.goto(h);a?.record({stream:"action",name:"pre_navigate",phase:"end",data:{url:h}})}catch(f){if(f instanceof ce)throw f;a?.record({stream:"action",name:"pre_navigate",phase:"error",data:{url:h,error:f instanceof Error?f.message:String(f)}});const v=new x(`Pre-navigation to ${h} failed: ${f instanceof Error?f.message:f}`,"Check that the site is reachable and the browser extension is running.");v.cause=f;if(a&&(u==="on"||u==="retain-on-failure")){a.record({stream:"error",message:v.message,stack:v.stack,code:v.code,hint:v.hint});await _(a,c).catch(()=>{});O(a,"failure",v,r.onTraceExport)}throw v}}const E=s!==null?s+Z:de,T=U(e,c,o,n);R=T;let I=!1;T.then(()=>{I=!0},()=>{I=!0});try{const f=await G(T,{timeout:E,label:g(e),hint:te(e,s)});a?.record({stream:"action",name:"command",phase:"end"});if(a&&u==="on"){await _(a,c).catch(()=>{});O(a,"success",void 0,r.onTraceExport)}if(!q)await c.closeWindow?.().catch(()=>{});return f}catch(f){if(!I)H=!0;if(a){a.record({stream:"action",name:"command",phase:"error",data:{error:f instanceof Error?f.message:String(f)}});a.record({stream:"error",message:f instanceof Error?f.message:String(f),stack:f instanceof Error?f.stack:void 0});if(u==="on"||u==="retain-on-failure"){await _(a,c).catch(()=>{});O(a,"failure",f,r.onTraceExport)}}if(!q)await c.closeWindow?.().catch(()=>{});throw f}},{session:C,cdpEndpoint:P,contextId:L,windowMode:A,surface:"adapter",siteSession:b,initScript:F,proxyAuth:W}),p?.name)}catch(c){z=c;throw c}finally{if(y)if(H&&R){const{runId:c,session:a}=y,h=(E)=>{ve(c);if(!J(E))K({runId:c,session:a,surface:"adapter"})};R.then(()=>h(),(E)=>h(E))}else{Q(null);if(!J(z))await K({runId:y.runId,session:y.session,surface:"adapter"})}}}else if(s!==null){const i=s+Z;m=await G(U(e,null,o,n),{timeout:i,label:g(e),hint:te(e,s)})}else m=await U(e,null,o,n)}catch(i){l.error=i;l.finishedAt=Date.now();await k("onAfterExecute",l);throw i}l.finishedAt=Date.now();await k("onAfterExecute",l,m);return m}async function _(e,t){const n=t.getActivePage?.()??e.scope.target,[r,o,s,u,l]=await Promise.all([t.getCurrentUrl?.().catch(()=>null)??Promise.resolve(null),t.snapshot().catch(()=>{return}),t.readNetworkCapture?.().catch(()=>[])??Promise.resolve([]),t.consoleMessages("all").catch(()=>[]),t.screenshot({format:"png"}).catch(()=>{return})]);if(o!==void 0||r!==void 0)e.record({stream:"state",url:r,target:n,snapshot:o,label:"final"});for(const m of Array.isArray(s)?s:[]){const i=m;e.record({stream:"network",url:String(i.url??""),method:typeof i.method==="string"?i.method:void 0,status:typeof i.responseStatus==="number"?i.responseStatus:void 0,contentType:typeof i.responseContentType==="string"?i.responseContentType:void 0,size:typeof i.responseBodyFullSize==="number"?i.responseBodyFullSize:void 0,requestHeaders:i.requestHeaders,responseHeaders:i.responseHeaders,requestBody:i.requestBodyPreview,responseBody:i.responsePreview,ts:typeof i.timestamp==="number"?i.timestamp:void 0})}for(const m of Array.isArray(u)?u:[])if(m&&typeof m==="object"){const i=m;e.record({stream:"console",level:String(i.type??i.level??"log"),text:String(i.text??i.message??""),ts:typeof i.timestamp==="number"?i.timestamp:void 0})}else e.record({stream:"console",level:"log",text:String(m)});if(typeof l==="string"&&l)e.record({stream:"screenshot",format:"png",data:l,label:"final"})}function O(e,t,n,r){try{const o=Ce(e,{error:n,status:t});if(t==="failure"&&n!==void 0)ue(n,o.receipt);else process.stderr.write(`ppcli trace artifact: ${o.dir}
+`);try{r?.(o)}catch(s){X.warn(`[trace] Trace export callback failed: ${s instanceof Error?s.message:String(s)}`)}return o}catch(o){X.warn(`[trace] Failed to export trace artifact: ${o instanceof Error?o.message:String(o)}`);return}}export function resolveFileBackedArg(e,t){const n=e.args.find((l)=>l.fromFile);if(!n)return;const r=typeof n.fromFile==="string"?n.fromFile:"file",o=n.positional?`<${n.name}>`:`--${n.name}`,s=t[r]==null?"":String(t[r]).trim(),u=t[n.name]==null?"":String(t[n.name]);if(s){if(u.trim())throw new d(`${o} 和 --${r} 只能二选一，不能同时给`);const l=N.resolve(s.startsWith("~/")?N.join(j.homedir(),s.slice(2)):s);let m;try{m=M.readFileSync(l,"utf-8")}catch(w){throw new d(`--${r} 指向的文件读不到: ${l}（${D(w)}）`)}const i=m.trim();if(!i)throw new d(`--${r} 指向的文件内容为空: ${l}`);t[n.name]=i;$e(N.dirname(l));return}if(!u.trim()&&n.requiredUnlessFile)throw new d(`缺少 ${n.name}：${o} 或 --${r} 给其一`)}export function prepareCommandArgs(e,t){const n=coerceAndValidateArgs(e.args,t);resolveFileBackedArg(e,n);e.validateArgs?.(n);return n}const Z=30;function Be(e){if(e===void 0||e===null||e==="")return null;if(e==="ephemeral"||e==="persistent")return e;throw new d(`--site-session must be one of: ephemeral, persistent. Received: "${String(e)}"`)}function Ue(){const e=process.env.PUBLISHPORT_SITE_SESSION;if(e==="persistent"||e==="ephemeral")return e;return null}function _e(e,t){return Be(t)??Ue()??e.siteSession??"persistent"}function Oe(e,t){if(t==="persistent")return`site:${e.site}`;return`site:${e.site}:${se.randomUUID()}`}function Fe(e,t){if(t===void 0||t==="")return null;if(t==="true")return!0;if(t==="false")return!1;throw new d(`${e} must be one of: true, false. Received: "${String(t)}"`)}function We(e,t){if(e==="persistent")return!0;return Fe("--keep-tab",t)??!1}function ee(e,t){if(t===void 0||t==="")return null;if(t==="foreground"||t==="background")return t;throw new d(`${e} must be one of: foreground, background. Received: "${String(t)}"`)}function Le(e="background",t){return ee("--window",t)??ee("OPENCLI_WINDOW",process.env.OPENCLI_WINDOW)??e}function te(e,t){const n=e.access==="write"?"⚠️ 这是写操作，超时不代表没写成功——请求可能已经到达平台。禁止直接重试："+"先用该平台的列表/统计命令（stats / lists / articles 等）按标题回查，确认没写进去再重发。 ":"";if(t!==null)return`${n}Pass a higher --timeout value (currently ${t}s)`;if(e.args.some((r)=>r.name==="timeout"))return`${n}Try again, or pass a higher --timeout <seconds>`;return n+"This command has no --timeout option. Retry once; if it keeps timing out, "+"the page or browser bridge is likely stuck — have the user reopen the PublishPort client. "+"The global default can be raised with OPENCLI_BROWSER_COMMAND_TIMEOUT."}function qe(e,t){if(!e.args.some((o)=>o.name==="timeout"))return null;const n=t.timeout;if(n===void 0||n===null||n==="")throw new d(`Argument "timeout" must be a positive integer. Received: "${String(n)}"`);const r=Number(n);if(!Number.isInteger(r)||r<=0)throw new d(`Argument "timeout" must be a positive integer. Received: "${String(n)}"`);return r}

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "publishport-opencli",
-  "version": "1.0.23",
+  "version": "1.0.24",
   "publishConfig": {
     "access": "public",
     "provenance": false
   },
   "description": "Make any website or Electron App your CLI. AI-powered.",
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=20.18.1"
   },
   "type": "module",
   "main": "dist/src/main.js",
@@ -87,13 +87,13 @@
     "@mozilla/readability": "^0.6.0",
     "cli-table3": "^0.6.5",
     "commander": "^14.0.3",
-    "js-yaml": "^4.1.0",
+    "js-yaml": "^4.3.1",
     "markdown-draft-js": "^2.4.0",
     "markdown-it": "^14.2.0",
     "remarkable": "^2.0.1",
     "turndown": "^7.2.2",
     "turndown-plugin-gfm": "^1.0.2",
-    "undici": "^6.27.0",
+    "undici": "^7.29.0",
     "ws": "^8.18.0"
   },
   "devDependencies": {