publishport-opencli 1.0.0

package/clis/trae-solo/model.js

@@ -0,0 +1,50 @@
+import{cli as R,Strategy as T}from"@jackwener/opencli/registry";import{CommandExecutionError as H,selectorError as U}from"@jackwener/opencli/errors";async function P(q){const A=await q.evaluate(`(function() {
+      const trigger = document.querySelector('.core-model-select-trigger');
+      return trigger ? (trigger.textContent || '').trim() : '';
+    })()`);return typeof A==="string"?A.trim():""}R({site:"trae-solo",name:"model",access:"write",description:"Read or switch the current AI model in TRAE SOLO. Without arguments, reports the current model. With <name> argument (substring, case-insensitive), switches to a matching model. Pass --list to enumerate available models.",domain:"localhost",strategy:T.UI,browser:!0,args:[{name:"name",required:!1,positional:!0,help:"Target model name (substring match, case-insensitive). Omit to read current."},{name:"list",type:"boolean",default:!1,help:"List all available models (does not switch)"}],columns:["Status","Model"],func:async(q,A)=>{const B=String(A.name||"").trim().toLowerCase(),K=A.list===!0||A.list==="true",I=await P(q);if(!I)throw U("TRAE SOLO model trigger (.core-model-select-trigger). Make sure a chat task is open (not the project-list view).");if(K||B){const V=JSON.stringify(B),z=await q.evaluate(`(async () => {
+        const wait = (ms) => new Promise((r) => setTimeout(r, ms));
+        const trigger = document.querySelector('.core-model-select-trigger');
+        if (!trigger) return { ok: false, reason: 'model trigger gone' };
+        const r = trigger.getBoundingClientRect();
+        const init = {
+          bubbles: true, cancelable: true, button: 0, buttons: 1,
+          clientX: Math.round(r.left + Math.min(r.width / 2, 20)),
+          clientY: Math.round(r.top + Math.min(r.height / 2, 10)),
+        };
+        trigger.dispatchEvent(new PointerEvent('pointerdown', { ...init, pointerType: 'mouse' }));
+        trigger.dispatchEvent(new MouseEvent('mousedown', init));
+        trigger.dispatchEvent(new PointerEvent('pointerup', { ...init, pointerType: 'mouse' }));
+        trigger.dispatchEvent(new MouseEvent('mouseup', init));
+        trigger.dispatchEvent(new MouseEvent('click', init));
+
+        let opts = [];
+        for (let attempt = 0; attempt < 16; attempt += 1) {
+          await wait(80);
+          opts = Array.from(document.querySelectorAll('.core-model-select-model-item[role="option"]'))
+            .filter((el) => el instanceof HTMLElement && el.offsetParent);
+          if (opts.length) break;
+        }
+        if (!opts.length) {
+          return { ok: false, reason: 'Model menu did not open.' };
+        }
+        const labels = opts.map((o) => {
+          const nameEl = o.querySelector('.core-model-select-model-item-name');
+          return ((nameEl ? nameEl.textContent : o.textContent) || '').trim();
+        });
+        return { ok: true, labels };
+      })()`);if(!z.ok)throw new H(z.reason,z.detail||"");if(K){try{await q.evaluate("document.body.click()")}catch{}return z.labels.map((F)=>({Status:F===I?"Active":"Available",Model:F}))}const G=z.labels.findIndex((F)=>F.toLowerCase().includes(B));if(G<0){try{await q.evaluate("document.body.click()")}catch{}throw new H(`No model matched: '${B}'`,"available="+JSON.stringify(z.labels))}const N=z.labels[G],Q=`.core-model-select-model-item[role="option"]:nth-of-type(${G+1})`;try{await q.click(Q)}catch(F){if(!await q.evaluate(`(function(i) {
+          const opts = Array.from(document.querySelectorAll('.core-model-select-model-item[role="option"]'))
+            .filter((el) => el.offsetParent);
+          const target = opts[i];
+          if (!target) return false;
+          const r = target.getBoundingClientRect();
+          const init = { bubbles: true, cancelable: true, button: 0, buttons: 1,
+            clientX: Math.round(r.left + r.width / 2),
+            clientY: Math.round(r.top + r.height / 2) };
+          target.dispatchEvent(new PointerEvent('pointerdown', { ...init, pointerType: 'mouse' }));
+          target.dispatchEvent(new MouseEvent('mousedown', init));
+          target.dispatchEvent(new PointerEvent('pointerup', { ...init, pointerType: 'mouse' }));
+          target.dispatchEvent(new MouseEvent('mouseup', init));
+          target.dispatchEvent(new MouseEvent('click', init));
+          return true;
+        })(${G})`))throw new H("Click on model option failed.",`model=${N}`)}await q.wait(0.6);const D=await P(q);if(!D||!D.toLowerCase().includes(B))throw new H(`Model click did not verify selected model "${N}".`,D?`current=${D}`:"model trigger was unreadable after click");return[{Status:"switched",Model:D}]}return[{Status:"Active",Model:I}]}});

package/clis/trae-solo/renderer-storage.js

@@ -0,0 +1,11 @@
+import{cli as I,Strategy as J}from"@jackwener/opencli/registry";import{ArgumentError as M,CommandExecutionError as O,EmptyResultError as K}from"@jackwener/opencli/errors";function N(D){const h=String(D?.storage||"local").trim().toLowerCase();if(h!=="local"&&h!=="session")throw new M("storage",'must be "local" or "session"');return h==="session"?"sessionStorage":"localStorage"}I({site:"trae-solo",name:"storage-keys",access:"read",description:"List localStorage / sessionStorage keys on the Trae SOLO renderer (CDP). For the on-disk VSCode state.vscdb, see state-keys.",domain:"localhost",strategy:J.UI,browser:!0,args:[{name:"storage",required:!1,default:"local",help:'"local" or "session"'},{name:"filter",required:!1,help:"Case-insensitive substring filter"},{name:"limit",type:"int",required:!1,default:100,help:"Max rows to return"}],columns:["Index","Key","Bytes","Name","Preview","Database","Version"],func:async(D,h)=>{const z=N(h),q=await D.evaluate(`(() => {
+      const s = ${z};
+      const out = [];
+      for (let i = 0; i < s.length; i++) {
+        const k = s.key(i);
+        const v = s.getItem(k) || '';
+        out.push({ k, bytes: v.length });
+      }
+      return out;
+    })()`),v=h?.filter?String(h.filter).toLowerCase():null,H=v?q.filter((B)=>B.k.toLowerCase().includes(v)):q;if(!H.length)throw new K("trae-solo storage-keys",v?`No keys match "${v}".`:`${z} is empty.`);H.sort((B,F)=>B.k.localeCompare(F.k));const G=Number.isInteger(h?.limit)&&h.limit>0?h.limit:100;return H.slice(0,G).map((B,F)=>({Index:F+1,Key:B.k,Bytes:B.bytes,Name:"",Preview:"",Database:"",Version:""}))}});I({site:"trae-solo",name:"storage-get",access:"read",description:"Read a single localStorage / sessionStorage value on the Trae SOLO renderer.",domain:"localhost",strategy:J.UI,browser:!0,args:[{name:"key",positional:!0,required:!0,help:"Storage key (use storage-keys to discover)"},{name:"storage",required:!1,default:"local",help:'"local" or "session"'},{name:"max-bytes",type:"int",required:!1,default:4000,help:"Truncate value to this many chars"}],columns:["Field","Value"],func:async(D,h)=>{const z=String(h?.key||"").trim();if(!z)throw new M("key","is required");const q=N(h),v=await D.evaluate(`${q}.getItem(${JSON.stringify(z)})`);if(v===null)throw new O(`Key not found in ${q}: ${z}`,"");const H=Number.isInteger(h["max-bytes"])&&h["max-bytes"]>0?h["max-bytes"]:4000;let G=v,B="string";try{G=JSON.parse(v);B=Array.isArray(G)?"array":typeof G}catch{}const F=B==="string"?G:JSON.stringify(G,null,2),L=F.length>H;return[{Field:"Key",Value:z},{Field:"Store",Value:q},{Field:"Type",Value:B},{Field:"Size",Value:`${F.length} chars${L?" (truncated)":""}`},{Field:"Value",Value:L?F.slice(0,H)+`
+...(truncated)`:F}]}});I({site:"trae-solo",name:"cookies",access:"read",description:"List cookies on the Trae SOLO renderer (JS-visible via document.cookie; httpOnly cookies not shown).",domain:"localhost",strategy:J.UI,browser:!0,args:[],columns:["Index","Key","Bytes","Name","Preview","Database","Version"],func:async(D)=>{const h=await D.evaluate("document.cookie");if(!h)throw new K("trae-solo cookies","document.cookie is empty (Trae uses Electron session cookies, mostly httpOnly).");return h.split("; ").map((q)=>{const v=q.indexOf("=");if(v<0)return{name:q,value:""};return{name:q.slice(0,v),value:q.slice(v+1)}}).map((q,v)=>({Index:v+1,Key:"",Name:q.name,Bytes:q.value.length,Preview:q.value.slice(0,40)+(q.value.length>40?"…":""),Database:"",Version:""}))}});I({site:"trae-solo",name:"idb-list",access:"read",description:"List IndexedDB databases on the Trae SOLO renderer. Trae ships an @byted/ve-rtc DB used by the Volcengine RTC voice/video infrastructure.",domain:"localhost",strategy:J.UI,browser:!0,args:[],columns:["Index","Key","Bytes","Name","Preview","Database","Version"],func:async(D)=>{const h=await D.evaluate("(async () => indexedDB.databases ? await indexedDB.databases() : [])()");if(!Array.isArray(h)||!h.length)throw new K("trae-solo idb-list","No IndexedDB databases.");return h.map((z,q)=>({Index:q+1,Key:"",Bytes:"",Name:"",Preview:"",Database:z.name||"(unnamed)",Version:String(z.version||"")}))}});

package/clis/trae-solo/settings.js

@@ -0,0 +1 @@
+import*as H from"node:fs";import*as M from"node:path";import{cli as Q,Strategy as V}from"@jackwener/opencli/registry";import{CommandExecutionError as W,EmptyResultError as K}from"@jackwener/opencli/errors";import{TRAE_APP_SUPPORT as X}from"./_fs.js";const D=M.join(X,"User/settings.json");Q({site:"trae-solo",name:"settings-read",access:"read",description:"Parse and pretty-print Trae SOLO user settings.json (~/Library/Application Support/TRAE SOLO/User/settings.json). Handles VSCode JSONC syntax (line comments + trailing commas).",domain:"localhost",strategy:V.LOCAL,browser:!1,args:[],columns:["Field","Value"],func:async()=>{if(!H.existsSync(D))throw new K("trae-solo settings-read",`settings.json not found: ${D}`);const L=H.readFileSync(D,"utf-8").replace(/\/\*[\s\S]*?\*\//g,"").replace(/^\s*\/\/.*$/gm,"").replace(/([^:"])\/\/.*$/gm,"$1").replace(/,(\s*[}\]])/g,"$1");let F;try{F=JSON.parse(L)}catch(z){throw new W(`Failed to parse settings.json: ${z.message}`,"")}const q=[];for(const[z,B]of Object.entries(F))q.push({Field:z,Value:typeof B==="object"?JSON.stringify(B):String(B)});if(!q.length)throw new K("trae-solo settings-read","settings.json is empty (or contains only defaults).");return q}});

package/clis/trae-solo/skill-fs.js

@@ -0,0 +1 @@
+import*as H from"node:fs";import*as N from"node:path";import{cli as O,Strategy as P}from"@jackwener/opencli/registry";import{ArgumentError as V,CommandExecutionError as W,EmptyResultError as Q}from"@jackwener/opencli/errors";import{TRAE_SKILLS_DIR as J,assertReadable as X,parseSkillMd as U,readSkillConfig as Y}from"./_fs.js";O({site:"trae-solo",name:"skill-fs-list",access:"read",description:"List all Trae SOLO skills present on disk under ~/.trae/skills/. Reads SKILL.md front-matter for descriptions. Works while Trae is closed.",domain:"localhost",browser:!1,strategy:P.LOCAL,args:[{name:"limit",type:"int",required:!1,default:200,help:"Max rows"}],columns:["Index","Name","Description","Source"],func:async(F)=>{X(J,"~/.trae/skills");const q=H.readdirSync(J).filter((v)=>{const B=N.join(J,v);return H.statSync(B).isDirectory()&&!v.startsWith("_")}).map((v)=>U(N.join(J,v))),z=Number.isInteger(F.limit)&&F.limit>0?F.limit:200;if(!q.length)throw new Q("trae-solo skill-fs-list","No skills found under ~/.trae/skills/.");return q.slice(0,z).map((v,B)=>({Index:B+1,Name:v.name,Description:(v.description||"").slice(0,120),Source:""}))}});O({site:"trae-solo",name:"skill-fs-installed",access:"read",description:"List INSTALLED Trae SOLO skills (managedSkills entry in ~/.trae/skill-config.json).",domain:"localhost",browser:!1,strategy:P.LOCAL,args:[],columns:["Index","Name","Description","Source"],func:async()=>{const G=Y().managedSkills||{},q=Object.entries(G);if(!q.length)throw new Q("trae-solo skill-fs-installed","No installed skills.");return q.map(([z,v],B)=>({Index:B+1,Name:z,Description:"",Source:v}))}});O({site:"trae-solo",name:"skill-fs-show",access:"read",description:"Print a skill's SKILL.md content + on-disk path.",domain:"localhost",browser:!1,strategy:P.LOCAL,args:[{name:"name",positional:!0,required:!0,help:"Skill name (folder under ~/.trae/skills/)"}],columns:["Field","Value"],func:async(F)=>{const G=String(F.name||"").trim();if(!G)throw new V("name required");const q=N.join(J,G);if(!H.existsSync(q))throw new W(`Skill "${G}" not found.`,`Tried: ${q}`);const z=U(q),v=N.join(q,"SKILL.md"),B=H.existsSync(v)?H.readFileSync(v,"utf-8"):"(no SKILL.md)";return[{Field:"Name",Value:z.name},{Field:"Path",Value:q},{Field:"Description",Value:(z.description||"").slice(0,200)},{Field:"Tags",Value:(z.tags||[]).join(", ")},{Field:"Author",Value:z.author},{Field:"Version",Value:z.version},{Field:"Files",Value:H.readdirSync(q).join(", ").slice(0,200)},{Field:"SKILL.md (head)",Value:B.slice(0,1200)}]}});

package/clis/trae-solo/skill.js

@@ -0,0 +1,81 @@
+import{cli as L,Strategy as M}from"@jackwener/opencli/registry";import{ArgumentError as V,CommandExecutionError as Y,EmptyResultError as W}from"@jackwener/opencli/errors";import{switchToPanel as Q}from"./_actions.js";const Z="Make sure TRAE SOLO is running and the Skills panel is reachable.";async function U(q,f){const v=JSON.stringify(f);await q.evaluate(`(async () => {
+    const wait = (ms) => new Promise((r) => setTimeout(r, ms));
+    const target = ${v};
+    const tab = Array.from(document.querySelectorAll('.marketplace-tab'))
+      .find((t) => (t.textContent || '').trim().startsWith(target));
+    if (!tab) return;
+    if (tab.className.includes('active')) return;
+    const r = tab.getBoundingClientRect();
+    const init = {
+      bubbles: true, cancelable: true, button: 0, buttons: 1,
+      clientX: Math.round(r.left + r.width / 2),
+      clientY: Math.round(r.top + r.height / 2),
+    };
+    tab.dispatchEvent(new PointerEvent('pointerdown', { ...init, pointerType: 'mouse' }));
+    tab.dispatchEvent(new MouseEvent('mousedown', init));
+    tab.dispatchEvent(new PointerEvent('pointerup', { ...init, pointerType: 'mouse' }));
+    tab.dispatchEvent(new MouseEvent('mouseup', init));
+    tab.dispatchEvent(new MouseEvent('click', init));
+    await wait(700);
+  })()`);await q.wait(0.3)}L({site:"trae-solo",name:"skill-list",access:"read",description:"List Trae SOLO Skills — by default the Marketplace; pass --installed to list installed ones.",domain:"localhost",strategy:M.UI,browser:!0,args:[{name:"installed",type:"boolean",default:!1,help:"List installed skills instead of the marketplace"},{name:"limit",type:"int",required:!1,default:100,help:"Max rows to return"}],columns:["Index","Name","Description"],func:async(q,f)=>{await Q(q,"Skills");const v=f.installed===!0||f.installed==="true"||f.installed==="1";await U(q,v?"Installed":"Skills Marketplace");const B=await q.evaluate(`(function() {
+      const sel = ${v?"'.installed-card'":"'.marketplace-card-v2'"};
+      const cards = Array.from(document.querySelectorAll(sel)).filter((c) => c.offsetParent);
+      return cards.map((c, i) => {
+        const logo = c.querySelector('.skill-logo-svg');
+        const name = (logo && logo.getAttribute('aria-label')) || '';
+        // Card text starts with the name; trim that off to get description.
+        const full = (c.innerText || '').replace(/\\s+/g, ' ').trim();
+        let desc = full;
+        if (name && desc.startsWith(name)) desc = desc.slice(name.length).trim();
+        return { index: i + 1, name: name || full.split(' ')[0], description: desc.slice(0, 200) };
+      });
+    })()`),G=Number.isInteger(f.limit)&&f.limit>0?f.limit:100,D=(B||[]).slice(0,G);if(!D.length)throw new W("trae-solo skill-list",v?"No installed skills visible.":"No marketplace skills visible.");return D.map((z)=>({Index:z.index,Name:z.name,Description:z.description}))}});L({site:"trae-solo",name:"skill-search",access:"read",description:"Filter Skills Marketplace by keyword.",domain:"localhost",strategy:M.UI,browser:!0,args:[{name:"keyword",positional:!0,required:!0,help:"Search keyword (substring)"},{name:"limit",type:"int",required:!1,default:50,help:"Max rows"}],columns:["Index","Name","Description"],func:async(q,f)=>{await Q(q,"Skills");await U(q,"Skills Marketplace");const v=String(f.keyword||"").trim();if(!v)throw new V("keyword cannot be empty");const B=JSON.stringify(v);await q.evaluate(`(function() {
+      const inp = document.querySelector('input[placeholder="Search"]');
+      if (!inp) return;
+      inp.focus();
+      const setter = Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype, 'value').set;
+      setter.call(inp, ${B});
+      inp.dispatchEvent(new Event('input', { bubbles: true }));
+    })()`);await q.wait(0.7);const G=await q.evaluate(`(function() {
+      const cards = Array.from(document.querySelectorAll('.marketplace-card-v2')).filter((c) => c.offsetParent);
+      return cards.map((c, i) => {
+        const logo = c.querySelector('.skill-logo-svg');
+        const name = (logo && logo.getAttribute('aria-label')) || '';
+        const full = (c.innerText || '').replace(/\\s+/g, ' ').trim();
+        let desc = full;
+        if (name && desc.startsWith(name)) desc = desc.slice(name.length).trim();
+        return { index: i + 1, name: name || full.split(' ')[0], description: desc.slice(0, 200) };
+      });
+    })()`),D=Number.isInteger(f.limit)&&f.limit>0?f.limit:50,z=(G||[]).slice(0,D);if(!z.length)throw new W("trae-solo skill-search",`No skills matched "${v}".`);return z.map((K)=>({Index:K.index,Name:K.name,Description:K.description}))}});L({site:"trae-solo",name:"skill-category",access:"read",description:"Filter Skills Marketplace by category. Pass --list to see categories.",domain:"localhost",strategy:M.UI,browser:!0,args:[{name:"name",positional:!0,required:!1,help:"Category name (substring; case-insensitive). Common: All / Developer Tools / Data Analysis / UI Design / Content Creation / Productivity"},{name:"list",type:"boolean",default:!1,help:"List available categories"},{name:"limit",type:"int",required:!1,default:100}],columns:["Index","Name","Description"],func:async(q,f)=>{await Q(q,"Skills");await U(q,"Skills Marketplace");const v=f.list===!0||f.list==="true",B=String(f.name||"").trim().toLowerCase(),G=await q.evaluate(`(function() {
+      return Array.from(document.querySelectorAll('.marketplace-tag'))
+        .filter((c) => c.offsetParent)
+        .map((c) => ({ text: (c.textContent || '').trim(), active: c.className.includes('active') }));
+    })()`);if(v)return(G||[]).map((F)=>({Index:"-",Name:F.text+(F.active?" (active)":""),Description:""}));if(!B)throw new V("name required (or pass --list)");const D=JSON.stringify(B),z=await q.evaluate(`(async () => {
+      const wait = (ms) => new Promise((r) => setTimeout(r, ms));
+      const tag = Array.from(document.querySelectorAll('.marketplace-tag'))
+        .find((t) => t.offsetParent && (t.textContent || '').trim().toLowerCase().includes(${D}));
+      if (!tag) return { ok: false, reason: 'Category not found.' };
+      const r = tag.getBoundingClientRect();
+      const init = {
+        bubbles: true, cancelable: true, button: 0, buttons: 1,
+        clientX: Math.round(r.left + r.width / 2),
+        clientY: Math.round(r.top + r.height / 2),
+      };
+      tag.dispatchEvent(new PointerEvent('pointerdown', { ...init, pointerType: 'mouse' }));
+      tag.dispatchEvent(new MouseEvent('mousedown', init));
+      tag.dispatchEvent(new PointerEvent('pointerup', { ...init, pointerType: 'mouse' }));
+      tag.dispatchEvent(new MouseEvent('mouseup', init));
+      tag.dispatchEvent(new MouseEvent('click', init));
+      await wait(700);
+      return { ok: true, chosen: (tag.textContent || '').trim() };
+    })()`);if(!z?.ok)throw new Y(z?.reason||"Category click failed.",Z);const K=await q.evaluate(`(function() {
+      const cards = Array.from(document.querySelectorAll('.marketplace-card-v2')).filter((c) => c.offsetParent);
+      return cards.map((c, i) => {
+        const logo = c.querySelector('.skill-logo-svg');
+        const name = (logo && logo.getAttribute('aria-label')) || '';
+        const full = (c.innerText || '').replace(/\\s+/g, ' ').trim();
+        let desc = full;
+        if (name && desc.startsWith(name)) desc = desc.slice(name.length).trim();
+        return { index: i + 1, name: name || full.split(' ')[0], description: desc.slice(0, 200) };
+      });
+    })()`),X=Number.isInteger(f.limit)&&f.limit>0?f.limit:100;return(K||[]).slice(0,X).map((F)=>({Index:F.index,Name:F.name,Description:F.description}))}});

package/clis/trae-solo/state-fs.js

@@ -0,0 +1,2 @@
+import*as $ from"node:fs";import*as h from"node:path";import{cli as U,Strategy as X}from"@jackwener/opencli/registry";import{ArgumentError as K,CommandExecutionError as Y,EmptyResultError as Z}from"@jackwener/opencli/errors";import{TRAE_GLOBAL_STATE_DB as Q,TRAE_WORKSPACE_STORAGE as V,listKeys as j,getValue as P}from"./_state.js";function W(q){const H=q.workspace?String(q.workspace).trim():"";if(!H)return Q;const I=h.join(V,H,"state.vscdb");if(!$.existsSync(I))throw new Y(`Workspace state.vscdb not found: ${I}`,"List valid workspace ids with `opencli trae-solo workspaces-list`.");return I}U({site:"trae-solo",name:"state-keys",access:"read",description:"List all keys present in Trae SOLO's globalStorage state.vscdb (VSCode-style UI/agent state). Pass --workspace <ws-id> to query a per-workspace DB instead. Use state-get to read a specific value. (See renderer storage-keys for browser-side LS/SS.)",domain:"localhost",browser:!1,strategy:X.LOCAL,args:[{name:"filter",required:!1,help:"Case-insensitive substring filter over keys"},{name:"workspace",required:!1,help:"Workspace id (from workspaces-list) to query a per-workspace DB"},{name:"limit",type:"int",required:!1,default:200}],columns:["Index","Key","Kind","Path"],func:async(q)=>{const H=W(q),I=j(H),z=q.filter?String(q.filter).toLowerCase():null,F=z?I.filter((J)=>J.toLowerCase().includes(z)):I;if(!F.length)throw new Z("trae-solo storage-keys",z?`No keys match "${z}".`:"No keys.");const M=Number.isInteger(q.limit)&&q.limit>0?q.limit:200;return F.slice(0,M).map((J,N)=>({Index:N+1,Key:J,Kind:"",Path:""}))}});U({site:"trae-solo",name:"state-get",access:"read",description:"Read a single key from Trae SOLO's globalStorage state.vscdb. Pass --workspace <ws-id> to query a per-workspace DB instead. Returns parsed JSON if the value is JSON.",domain:"localhost",browser:!1,strategy:X.LOCAL,args:[{name:"key",positional:!0,required:!0,help:"State key (use state-keys to discover)"},{name:"workspace",required:!1,help:"Workspace id (from workspaces-list) to query a per-workspace DB"},{name:"max-bytes",type:"int",required:!1,default:8000,help:"Truncate value to this many bytes"}],columns:["Field","Value"],func:async(q)=>{const H=String(q.key||"").trim();if(!H)throw new K("key required");const I=W(q),z=P(I,H);if(z===null)throw new Y(`Key not found: ${H}`,"List available keys with `opencli trae-solo state-keys`.");const F=Number.isInteger(q["max-bytes"])&&q["max-bytes"]>0?q["max-bytes"]:8000,M=typeof z==="string"?z:JSON.stringify(z,null,2),J=M.length>F;return[{Field:"Key",Value:H},{Field:"Type",Value:typeof z==="string"?"string":Array.isArray(z)?"array":typeof z},{Field:"Size",Value:`${M.length} chars${J?" (truncated)":""}`},{Field:"Value",Value:J?M.slice(0,F)+`
+...(truncated, use --max-bytes to read more)`:M}]}});U({site:"trae-solo",name:"recent-workspaces",access:"read",description:`Show Trae SOLO's recently-opened workspaces (the File → Open Recent menu, stored under key "history.recentlyOpenedPathsList" in state.vscdb).`,domain:"localhost",browser:!1,strategy:X.LOCAL,args:[{name:"limit",type:"int",required:!1,default:20}],columns:["Index","Key","Kind","Path"],func:async(q)=>{if(!$.existsSync(Q))throw new Y(`state.vscdb not found: ${Q}`,"");const H=P(Q,"history.recentlyOpenedPathsList");if(!H)throw new Z("trae-solo recent-workspaces","No recent workspaces recorded.");const I=H.entries||[];if(!I.length)throw new Z("trae-solo recent-workspaces","history.recentlyOpenedPathsList has no entries.");const z=Number.isInteger(q.limit)&&q.limit>0?q.limit:20;return I.slice(0,z).map((F,M)=>{let J="other",N=JSON.stringify(F).slice(0,200);if(F.folderUri){J="folder";N=decodeURI(String(F.folderUri).replace(/^file:\/\//,""))}else if(F.workspace&&F.workspace.configPath){J="workspace";N=decodeURI(String(F.workspace.configPath).replace(/^file:\/\//,""))}else if(F.fileUri){J="file";N=decodeURI(String(F.fileUri).replace(/^file:\/\//,""))}return{Index:M+1,Key:"",Kind:J,Path:N}})}});

package/clis/trae-solo/status.js

@@ -0,0 +1 @@
+import{makeStatusCommand as o}from"../_shared/desktop-commands.js";export const statusCommand=o("trae-solo","Trae SOLO Desktop");

package/clis/trae-solo/task-fs.js

@@ -0,0 +1,5 @@
+import*as Q from"node:fs";import*as Y from"node:path";import{execFileSync as O}from"node:child_process";import{cli as b,Strategy as k}from"@jackwener/opencli/registry";import{ArgumentError as F,CommandExecutionError as z,EmptyResultError as G}from"@jackwener/opencli/errors";import{TRAE_SNAPSHOT_DIR as $,TRAE_AGENTCONFIG_DIR as H,assertReadable as x}from"./_fs.js";function w(B){return Y.join($,B,"v2")}function j(B,K){return O("git",K,{cwd:B,encoding:"utf-8"}).trim()}b({site:"trae-solo",name:"task-fs-list",access:"read",description:"List Trae SOLO task ids from disk (snapshot/<uuid> + agentconfig/<uuid>.json). Works while Trae is closed.",domain:"localhost",browser:!1,strategy:k.LOCAL,args:[{name:"limit",type:"int",required:!1,default:100}],columns:["Index","Task Id","Has Snapshot","Has Config","Modified","Phase","Turn Id","Commit"],func:async(B)=>{x($,"ai-agent/snapshot");const K=new Set(Q.readdirSync($).filter((q)=>Q.statSync(Y.join($,q)).isDirectory())),J=Q.existsSync(H)?new Set(Q.readdirSync(H).filter((q)=>q.endsWith(".json")&&!q.endsWith("-hooks.json")&&!q.startsWith("boot")&&!q.startsWith("ide_")).map((q)=>q.replace(/\.json$/,""))):new Set,X=[...new Set([...K,...J])].map((q)=>{const v=Y.join($,q),L=Y.join(H,q+".json"),W=Q.existsSync(v),U=Q.existsSync(L);let M=0;if(W)M=Math.max(M,Q.statSync(v).mtimeMs);if(U)M=Math.max(M,Q.statSync(L).mtimeMs);return{id:q,hasSnap:W,hasCfg:U,mtime:M}}).sort((q,v)=>v.mtime-q.mtime),Z=Number.isInteger(B.limit)&&B.limit>0?B.limit:100;if(!X.length)throw new G("trae-solo task-fs-list","No tasks on disk.");return X.slice(0,Z).map((q,v)=>({Index:v+1,"Task Id":q.id,"Has Snapshot":q.hasSnap?"yes":"no","Has Config":q.hasCfg?"yes":"no",Modified:new Date(q.mtime).toISOString().replace("T"," ").slice(0,19),Phase:"","Turn Id":"",Commit:""}))}});b({site:"trae-solo",name:"task-fs-turns",access:"read",description:"Show the chat-turn timeline for a Trae SOLO task as git tags (before-chat-turn-* / after-chat-turn-*).",domain:"localhost",browser:!1,strategy:k.LOCAL,args:[{name:"task-id",positional:!0,required:!0,help:"Task UUID (folder name under snapshot/)"},{name:"limit",type:"int",required:!1,default:50}],columns:["Index","Task Id","Has Snapshot","Has Config","Modified","Phase","Turn Id","Commit"],func:async(B)=>{const K=String(B["task-id"]||"").trim();if(!K)throw new F("task-id required");const J=w(K);if(!Q.existsSync(Y.join(J,".git")))throw new z(`No snapshot repo for task ${K}.`,`Tried: ${J}`);const X=j(J,["for-each-ref","--format=%(refname:short)|%(*objectname:short)|%(objectname:short)|%(committerdate:iso8601)","refs/tags"]).split(`
+`).filter(Boolean).map((q)=>{const[v,L,W,U]=q.split("|"),M=v.match(/^(before|after)-chat-turn-([0-9a-f]+)(?:-(refresh))?$/),y=M?M[1]+(M[3]?"/refresh":""):"misc",D=M?M[2]:v;return{phase:y,turnId:D,oid:W,date:U}}).sort((q,v)=>q.date.localeCompare(v.date));if(!X.length)throw new G("trae-solo task-fs-turns",`No chat-turn refs in ${J}.`);const Z=Number.isInteger(B.limit)&&B.limit>0?B.limit:50;return X.slice(0,Z).map((q,v)=>({Index:v+1,"Task Id":"","Has Snapshot":"","Has Config":"",Modified:"",Phase:q.phase,"Turn Id":q.turnId,Commit:q.oid}))}});b({site:"trae-solo",name:"task-fs-show",access:"read",description:"Show the workspace tree at a given chat-turn ref (via git ls-tree). Pass --turn <turn-id> to pick a turn; otherwise the latest after-chat-turn ref.",domain:"localhost",browser:!1,strategy:k.LOCAL,args:[{name:"task-id",positional:!0,required:!0,help:"Task UUID"},{name:"turn",required:!1,help:"Specific turn id (omit for latest after-chat-turn)"},{name:"limit",type:"int",required:!1,default:50}],columns:["Mode","Path","Size"],func:async(B)=>{const K=String(B["task-id"]||"").trim();if(!K)throw new F("task-id required");const J=w(K);if(!Q.existsSync(Y.join(J,".git")))throw new z(`No snapshot repo for task ${K}.`,`Tried: ${J}`);let V;if(B.turn){const v=String(B.turn).trim(),W=j(J,["for-each-ref","--format=%(refname:short)","refs/tags"]).split(`
+`).filter((U)=>U.includes(v));V=W.find((U)=>U.startsWith("after-chat-turn-"))||W[0];if(!V)throw new z(`No tag matched turn "${v}".`,"")}else{V=j(J,["for-each-ref","--sort=-committerdate","--format=%(refname:short)","refs/tags"]).split(`
+`).find((L)=>L.startsWith("after-chat-turn-"));if(!V)throw new z("No after-chat-turn tags found.","")}const Z=j(J,["ls-tree","-r","-l",V]).split(`
+`).filter(Boolean).map((v)=>{const L=v.split(/\s+/);return{mode:L[0],oid:L[2],size:L[3],pth:L.slice(4).join(" ")}}),q=Number.isInteger(B.limit)&&B.limit>0?B.limit:50;return Z.slice(0,q).map((v)=>({Mode:v.mode,Path:v.pth,Size:v.size}))}});

package/clis/trae-solo/user-rules.js

@@ -0,0 +1 @@
+import*as t from"node:fs";import{cli as i,Strategy as a}from"@jackwener/opencli/registry";import{TRAE_USER_RULES as e}from"./_fs.js";i({site:"trae-solo",name:"user-rules",access:"read",description:"Print Trae SOLO user rules (~/.trae/user_rules.md).",domain:"localhost",browser:!1,strategy:a.LOCAL,args:[],columns:["Field","Value"],func:async()=>{if(!t.existsSync(e))return[{Field:"path",Value:e},{Field:"content",Value:"(file does not exist yet)"}];const r=t.readFileSync(e,"utf-8"),s=t.statSync(e);return[{Field:"path",Value:e},{Field:"size",Value:String(s.size)+" bytes"},{Field:"modified",Value:s.mtime.toISOString().replace("T"," ").slice(0,19)},{Field:"content",Value:r}]}});

package/clis/trae-solo/workspaces-fs.js

@@ -0,0 +1 @@
+import*as F from"node:fs";import*as Q from"node:path";import{cli as Z,Strategy as $}from"@jackwener/opencli/registry";import{CommandExecutionError as U,EmptyResultError as b}from"@jackwener/opencli/errors";import{TRAE_WORKSPACE_STORAGE as H,TRAE_EXTENSIONS_JSON as V,resolveWorkspaceJson as I}from"./_state.js";Z({site:"trae-solo",name:"workspaces-list",access:"read",description:"List Trae SOLO workspaceStorage entries (~/Library/.../TRAE SOLO/User/workspaceStorage/<uuid>/), resolving each workspace.json to its single-folder path or multi-folder workspace target. Works while Trae is closed.",domain:"localhost",browser:!1,strategy:$.LOCAL,args:[{name:"limit",type:"int",required:!1,default:100}],columns:["Index","Workspace Id","Kind","Target","Modified","Id","Version","Source","Installed"],func:async(B)=>{if(!F.existsSync(H))throw new U(`workspaceStorage not found: ${H}`,"");const z=F.readdirSync(H).filter((q)=>{const D=Q.join(H,q);return F.statSync(D).isDirectory()});if(!z.length)throw new b("trae-solo workspaces-list","No workspace storage entries.");const M=z.map((q)=>{const D=Q.join(H,q),k=Q.join(D,"workspace.json"),Y=I(k),v=F.statSync(D).mtimeMs;return{id:q,kind:Y.kind,target:Y.target,mtime:v}}).sort((q,D)=>D.mtime-q.mtime),L=Number.isInteger(B.limit)&&B.limit>0?B.limit:100;return M.slice(0,L).map((q,D)=>({Index:D+1,"Workspace Id":q.id,Kind:q.kind,Target:(q.target||"").slice(0,120),Modified:new Date(q.mtime).toISOString().replace("T"," ").slice(0,19),Id:"",Version:"",Source:"",Installed:""}))}});Z({site:"trae-solo",name:"extensions-list",access:"read",description:"List VSCode extensions installed in Trae SOLO (~/.trae/extensions/extensions.json). Works while Trae is closed.",domain:"localhost",browser:!1,strategy:$.LOCAL,args:[],columns:["Index","Workspace Id","Kind","Target","Modified","Id","Version","Source","Installed"],func:async()=>{if(!F.existsSync(V))throw new U(`extensions.json not found: ${V}`,"Trae SOLO has not installed any VSCode extensions yet.");let B;try{B=JSON.parse(F.readFileSync(V,"utf-8"))}catch(z){throw new U(`Failed to parse extensions.json: ${z.message}`,"")}if(!Array.isArray(B)||!B.length)throw new b("trae-solo extensions-list","No extensions installed.");return B.map((z,M)=>{const L=z?.metadata?.installedTimestamp,q=L?new Date(L).toISOString().replace("T"," ").slice(0,19):"";return{Index:M+1,"Workspace Id":"",Kind:"",Target:"",Modified:"",Id:z?.identifier?.id||"?",Version:z?.version||"",Source:z?.metadata?.source||"",Installed:q}})}});

package/clis/tumblr/auth.js

@@ -0,0 +1,24 @@
+import{AuthRequiredError as I}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as N}from"../_shared/site-auth.js";const P="https://www.tumblr.com",Q="https://www.tumblr.com/dashboard";async function J(z){const G=(await z.getCookies({url:P})).find((L)=>L.name==="logged_in");return!!(G&&G.value&&G.value!=="0")}async function K(z){await z.goto(Q);const y=await z.evaluate(`(async () => {
+    try {
+      if (!(window.tumblr && typeof window.tumblr.apiFetch === 'function')) {
+        return { ok: false, reason: 'apiFetch unavailable — not on a logged-in tumblr page?' };
+      }
+      var r = await window.tumblr.apiFetch('/v2/user/info');
+      var u = (r && r.response && r.response.user) || null;
+      if (!u || !u.name) return { ok: false, reason: 'anonymous' };
+      var blogs = (u.blogs || []).map(function (b) {
+        return { name: String(b.name || ''), primary: !!b.primary, uuid: String(b.uuid || '') };
+      });
+      var primary = blogs.filter(function (b) { return b.primary; })[0] || blogs[0] || null;
+      return {
+        ok: true,
+        name: String(u.name),
+        primary_blog: primary ? primary.name : '',
+        blogs: blogs.map(function (b) { return b.name; }).join(','),
+      };
+    } catch (e) {
+      var status = e && e.status;
+      if (status === 401 || status === 403) return { ok: false, reason: 'HTTP ' + status };
+      return { ok: false, reason: String((e && e.message) || e) };
+    }
+  })()`);if(!y||!y.ok)throw new I("tumblr.com",`Not logged in (${y?y.reason:"no probe"})`);return{name:y.name,primary_blog:y.primary_blog,blogs:y.blogs}}N({site:"tumblr",domain:"tumblr.com",loginUrl:"https://www.tumblr.com/login",columns:["name","primary_blog","blogs"],loginDescription:"打开 Tumblr 登录页并等待浏览器完成登录（供桌面客户端引导登录）。",quickCheck:J,verify:K,poll:async(z)=>{if(!await J(z))throw new I("tumblr.com","Waiting for tumblr.com session cookie");return K(z)}});

package/clis/tumblr/publish.js

@@ -0,0 +1,14 @@
+import*as M from"node:fs";import{cli as _,Strategy as L}from"@jackwener/opencli/registry";import{ArgumentError as U,AuthRequiredError as X,CommandExecutionError as P}from"@jackwener/opencli/errors";import{assertLiteralContent as j}from"../_shared/content-guard.js";const O="https://www.tumblr.com",q="https://www.tumblr.com/dashboard",Y=["published","draft","queue","private"];export function blogHost(z){const G=String(z||"").trim();if(!G)return"";return G.includes(".")?G:`${G}.tumblr.com`}export function resolveBody(z){if(z["body-file"]){const G=String(z["body-file"]);if(!M.statSync(G,{throwIfNoEntry:!1})?.isFile())throw new U(`--body-file not found: ${G}`);return M.readFileSync(G,"utf8")}if(z.body!==void 0&&z.body!==null){j(String(z.body),{fileFlag:"--body-file"});return String(z.body)}if(z.text!==void 0&&z.text!==null){j(String(z.text),{fileFlag:"--body-file"});return String(z.text)}return}export function buildContent(z,G){const I=[];if(z.title)I.push({type:"text",subtype:"heading1",text:String(z.title)});if(G!==void 0&&G!=="")for(const N of String(G).split(/\n{2,}/)){const J=N.replace(/\n+$/,"");if(J.trim()!=="")I.push({type:"text",text:J})}if(z["image-url"])I.push({type:"image",media:[{url:String(z["image-url"])}]});if(z.link)I.push({type:"link",url:String(z.link)});if(I.length===0)throw new U("Provide at least one of --title, --text/--body/--body-file, --image-url, or --link");return I}export function resolveTags(z){if(z===void 0||z===null||z==="")return"";return String(z).split(",").map((G)=>G.trim()).filter(Boolean).join(",")}async function Z(z,G,I){return z.evaluate(`(async () => {
+    try {
+      if (!(window.tumblr && typeof window.tumblr.apiFetch === 'function')) {
+        return { kind: 'auth', detail: 'apiFetch unavailable — not on a logged-in tumblr page?' };
+      }
+      var r = await window.tumblr.apiFetch(${JSON.stringify(G)}, ${JSON.stringify(I)});
+      return { kind: 'ok', response: (r && r.response) || null, meta: (r && r.meta) || null };
+    } catch (e) {
+      var status = (e && (e.status || (e.body && e.body.meta && e.body.meta.status))) || 0;
+      var msg = (e && (e.message || (e.body && e.body.meta && e.body.meta.msg))) || String(e);
+      if (status === 401 || status === 403) return { kind: 'auth', detail: 'HTTP ' + status + ' ' + msg };
+      return { kind: 'http', status: status, detail: String(msg).slice(0, 300) };
+    }
+  })()`)}async function F(z,G){if(G.blog)return blogHost(G.blog);const I=await Z(z,"/v2/user/info",{method:"GET"});if(I?.kind==="auth")throw new X("tumblr.com",`Not logged in (${I.detail}). Run \`opencli tumblr login\`.`);if(I?.kind!=="ok"||!I.response||!I.response.user)throw new P(`Failed to resolve default blog: ${JSON.stringify(I)}`);const N=I.response.user.blogs||[],J=N.find((Q)=>Q.primary)||N[0];if(!J||!J.name)throw new P("No blog found on this account; pass --blog explicitly.");return blogHost(J.name)}_({site:"tumblr",name:"publish",access:"write",description:"Publish a Tumblr post (NPF: title/text/image/link). Draft by default; pass --state published to go live.",domain:"tumblr.com",strategy:L.COOKIE,browser:!0,args:[{name:"title",type:"string",required:!1,help:"Title (rendered as a heading1 text block)"},{name:"text",type:"string",required:!1,help:"Body text (blank lines split paragraphs); alias of --body"},{name:"body",type:"string",required:!1,help:"Body text (blank lines split paragraphs)"},{name:"body-file",type:"string",required:!1,help:"Path to a text file for the body"},{name:"image-url",type:"string",required:!1,help:"Image URL (NPF image block)"},{name:"link",type:"string",required:!1,help:"Link URL (NPF link block)"},{name:"tags",type:"string",required:!1,help:"Comma-separated tags"},{name:"state",type:"string",required:!1,default:"draft",choices:Y,help:"draft | published | queue | private (default: draft)"},{name:"blog",type:"string",required:!1,help:"Target blog identifier (else your primary blog)"}],columns:["status","id","blog","state","url"],func:async(z,G)=>{if(!z)throw new P("Browser session required for tumblr publish");const I=String(G.state??"draft");if(!Y.includes(I))throw new U(`Invalid --state "${I}". One of: ${Y.join(", ")}`);const N=resolveBody(G),J=buildContent(G,N),Q=resolveTags(G.tags);await z.goto(q);const V=await F(z,G),$={content:J,state:I};if(Q)$.tags=Q;const K=await Z(z,`/v2/blog/${V}/posts`,{method:"POST",body:$});if(K?.kind==="auth")throw new X("tumblr.com",`Not logged in (${K.detail}). Run \`opencli tumblr login\`.`);if(K?.kind==="http")throw new P(`Tumblr publish failed: HTTP ${K.status} ${K.detail}`);if(K?.kind!=="ok"||!K.response)throw new P(`Unexpected Tumblr response: ${JSON.stringify(K)}`);const W=K.response.id_string??(K.response.id!=null?String(K.response.id):"");if(!W)throw new P("Tumblr post response missing id");return[{status:"success",id:W,blog:V,state:I,url:I==="published"?`${O}/${V}/${W}`:""}]}});_({site:"tumblr",name:"delete",access:"write",description:"Delete a Tumblr post by id (POST /v2/blog/{blog}/post/delete).",domain:"tumblr.com",strategy:L.COOKIE,browser:!0,args:[{name:"id",type:"string",required:!0,help:"Post id to delete"},{name:"blog",type:"string",required:!1,help:"Target blog identifier (else your primary blog)"}],columns:["status","id","blog"],func:async(z,G)=>{if(!z)throw new P("Browser session required for tumblr delete");const I=String(G.id??"").trim();if(!I)throw new U("--id is required");await z.goto(q);const N=await F(z,G),J=await Z(z,`/v2/blog/${N}/post/delete`,{method:"POST",body:{id:I}});if(J?.kind==="auth")throw new X("tumblr.com",`Not logged in (${J.detail}). Run \`opencli tumblr login\`.`);if(J?.kind==="http")throw new P(`Tumblr delete failed: HTTP ${J.status} ${J.detail}`);if(J?.kind!=="ok")throw new P(`Unexpected Tumblr delete response: ${JSON.stringify(J)}`);return[{status:"deleted",id:I,blog:N}]}});export const __test__={blogHost,resolveBody,buildContent,resolveTags};

package/clis/tvmaze/search.js

@@ -0,0 +1 @@
+import{cli as o,Strategy as u}from"@jackwener/opencli/registry";import{EmptyResultError as l}from"@jackwener/opencli/errors";import{TVMAZE_BASE as d,joinList as c,requireBoundedInt as g,requireString as h,stripHtml as p,tvmazeFetch as w}from"./utils.js";o({site:"tvmaze",name:"search",access:"read",description:"TVmaze TV show search by title (returns id, name, network, premiered/ended, rating)",domain:"tvmaze.com",strategy:u.PUBLIC,browser:!1,args:[{name:"query",positional:!0,type:"string",required:!0,help:"TV show title or fragment to search for"},{name:"limit",type:"int",default:20,help:"Max rows to return (1-50)"}],columns:["rank","id","name","type","language","genres","status","premiered","ended","network","rating","matchScore","summary","url"],func:async(a)=>{const r=h(a.query,"query"),i=g(a.limit,20,50,"limit"),t=await w(`${d}/search/shows?q=${encodeURIComponent(r)}`,`tvmaze search ${r}`);if(!Array.isArray(t)||t.length===0)throw new l("tvmaze search",`TVmaze returned no shows matching "${r}".`);return t.slice(0,i).map((n,s)=>{const e=n?.show??{},m=e.network?.name??e.webChannel?.name??"";return{rank:s+1,id:typeof e.id==="number"?e.id:null,name:String(e.name??"").trim(),type:String(e.type??"").trim(),language:String(e.language??"").trim(),genres:c(e.genres),status:String(e.status??"").trim(),premiered:typeof e.premiered==="string"?e.premiered:null,ended:typeof e.ended==="string"?e.ended:null,network:String(m).trim(),rating:e.rating?.average==null?null:Number(e.rating.average),matchScore:typeof n?.score==="number"?n.score:null,summary:p(e.summary),url:String(e.url??"").trim()}})}});

package/clis/tvmaze/show.js

@@ -0,0 +1 @@
+import{cli as o,Strategy as u}from"@jackwener/opencli/registry";import{EmptyResultError as l}from"@jackwener/opencli/errors";import{TVMAZE_BASE as d,joinList as g,requireShowId as c,stripHtml as h,tvmazeFetch as w}from"./utils.js";o({site:"tvmaze",name:"show",access:"read",description:"Single TVmaze TV show detail by id (network, schedule, rating, IMDB/TheTVDB cross-refs)",domain:"tvmaze.com",strategy:u.PUBLIC,browser:!1,args:[{name:"id",positional:!0,type:"int",required:!0,help:"TVmaze show id (positive integer)"}],columns:["id","name","type","language","genres","status","premiered","ended","runtime","averageRuntime","network","country","schedule","rating","imdb","thetvdb","officialSite","summary","url"],func:async(i)=>{const t=c(i.id),e=await w(`${d}/shows/${t}`,`tvmaze show ${t}`);if(!e||e.id==null)throw new l("tvmaze show",`TVmaze returned no show for id ${t}.`);const a=e.network?.name??e.webChannel?.name??"",s=e.network?.country?.name??e.webChannel?.country?.name??"",r=Array.isArray(e.schedule?.days)?e.schedule.days.join(", "):"",n=String(e.schedule?.time??"").trim(),m=r||n?`${r}${r&&n?" ":""}${n}`.trim():"";return[{id:Number(e.id),name:String(e.name??"").trim(),type:String(e.type??"").trim(),language:String(e.language??"").trim(),genres:g(e.genres),status:String(e.status??"").trim(),premiered:typeof e.premiered==="string"?e.premiered:null,ended:typeof e.ended==="string"?e.ended:null,runtime:e.runtime==null?null:Number(e.runtime),averageRuntime:e.averageRuntime==null?null:Number(e.averageRuntime),network:String(a).trim(),country:String(s).trim(),schedule:m,rating:e.rating?.average==null?null:Number(e.rating.average),imdb:String(e.externals?.imdb??"").trim(),thetvdb:e.externals?.thetvdb==null?null:Number(e.externals.thetvdb),officialSite:String(e.officialSite??"").trim(),summary:h(e.summary),url:String(e.url??"").trim()}]}});

package/clis/tvmaze/utils.js

@@ -0,0 +1 @@
+import{ArgumentError as J,CommandExecutionError as K,EmptyResultError as O}from"@jackwener/opencli/errors";export const TVMAZE_BASE="https://api.tvmaze.com";const Q="opencli-tvmaze-adapter (+https://github.com/jackwener/opencli)";export function requireString(D,z){const q=String(D??"").trim();if(!q)throw new J(`tvmaze ${z} cannot be empty`);return q}export function requireShowId(D){const z=D,q=typeof z==="number"?z:Number(String(z??"").trim());if(!Number.isInteger(q)||q<=0)throw new J("tvmaze show id is required and must be a positive integer","TVmaze show ids appear in the URL: https://www.tvmaze.com/shows/<id>/<slug>.");return q}export function requireBoundedInt(D,z,q,F="limit"){const B=D??z,G=typeof B==="number"?B:Number(B);if(!Number.isInteger(G)||G<=0)throw new J(`tvmaze ${F} must be a positive integer`);if(G>q)throw new J(`tvmaze ${F} must be <= ${q}`);return G}export async function tvmazeFetch(D,z){let q;try{q=await fetch(D,{headers:{"user-agent":Q,accept:"application/json"}})}catch(B){throw new K(`${z} request failed: ${B?.message??B}`,"Check that api.tvmaze.com is reachable from this network.")}if(q.status===404)throw new O(z,`TVmaze returned 404 for ${D}.`);if(q.status===429)throw new K(`${z} returned HTTP 429 (rate limited)`,"TVmaze caps unauthenticated traffic at ~20 req/10s; wait a few seconds and retry.");if(!q.ok)throw new K(`${z} returned HTTP ${q.status}`);let F;try{F=await q.json()}catch(B){throw new K(`${z} returned malformed JSON: ${B?.message??B}`)}return F}const S={amp:"&",lt:"<",gt:">",quot:'"',apos:"'",nbsp:" ",rsquo:"’",lsquo:"‘",rdquo:"”",ldquo:"“",hellip:"…",ndash:"–",mdash:"—"};export function stripHtml(D){if(D==null)return"";let z=String(D);z=z.replace(/<[^>]+>/g,"");z=z.replace(/&#x([0-9a-fA-F]+);/g,(q,F)=>{const B=parseInt(F,16);return Number.isFinite(B)?String.fromCodePoint(B):""}).replace(/&#(\d+);/g,(q,F)=>{const B=parseInt(F,10);return Number.isFinite(B)?String.fromCodePoint(B):""}).replace(/&([a-zA-Z]+);/g,(q,F)=>S[F]??q);return z.replace(/\s+/g," ").trim()}export function joinList(D){return Array.isArray(D)?D.filter(Boolean).join(", "):""}

package/clis/twitter/accept.js

@@ -0,0 +1,116 @@
+import{CommandExecutionError as V}from"@jackwener/opencli/errors";import{cli as W,Strategy as X}from"@jackwener/opencli/registry";W({site:"twitter",name:"accept",access:"write",description:"Auto-accept DM requests containing specific keywords",domain:"x.com",strategy:X.UI,browser:!0,args:[{name:"query",type:"string",required:!0,positional:!0,help:'Keywords to match (comma-separated for OR, e.g. "群,微信")'},{name:"max",type:"int",required:!1,default:20,help:"Maximum number of requests to accept (default: 20)"},{name:"timeout",type:"int",required:!1,default:600,help:"Max seconds for the overall command (default: 600 — batch op)"}],columns:["index","status","user","message"],func:async(z,N)=>{if(!z)throw new V("Browser session required for twitter accept");const L=N.query.split(",").map((G)=>G.trim()).filter(Boolean),D=N.max??20,B=[];let F=0;const O=new Set;for(let G=0;G<D+50;G++){if(F>=D)break;await z.goto("https://x.com/messages/requests");await z.wait(4);const M=await z.evaluate(`(async () => {
+        try {
+          // Wait for initial items
+          let attempts = 0;
+          while (attempts < 10) {
+            const convs = document.querySelectorAll('[data-testid="conversation"]');
+            if (convs.length > 0) break;
+            await new Promise(r => setTimeout(r, 1000));
+            attempts++;
+          }
+
+          // Scroll to load more
+          const seenCount = new Set();
+          let noNewCount = 0;
+          for (let scroll = 0; scroll < 20; scroll++) {
+            const convs = Array.from(document.querySelectorAll('[data-testid="conversation"]'));
+            const prevSize = seenCount.size;
+            convs.forEach((_, i) => seenCount.add(i));
+            if (convs.length >= ${D+10}) break;
+
+            // Scroll last item into view
+            if (convs.length > 0) {
+              convs[convs.length - 1].scrollIntoView({ behavior: 'instant', block: 'end' });
+            }
+            await new Promise(r => setTimeout(r, 1500));
+
+            if (seenCount.size <= prevSize) {
+              noNewCount++;
+              if (noNewCount >= 3) break;
+            } else {
+              noNewCount = 0;
+            }
+          }
+
+          const convs = Array.from(document.querySelectorAll('[data-testid="conversation"]'));
+          if (convs.length === 0) return { ok: false, count: 0, items: [] };
+
+          const items = convs.map((conv, idx) => {
+            const text = conv.innerText || '';
+            const link = conv.querySelector('a[href]');
+            const href = link ? link.href : '';
+            const lines = text.split('\\n').filter(l => l.trim());
+            const user = lines[0] || 'Unknown';
+            return { idx, text, href, user };
+          });
+          return { ok: true, count: convs.length, items };
+        } catch(e) {
+          return { ok: false, error: String(e), count: 0, items: [] };
+        }
+      })()`);if(!M?.ok||M.count===0){if(B.length===0)B.push({index:1,status:"info",user:"System",message:"No message requests found"});break}let P=!1;for(const H of M.items){if(F>=D)break;const Q=H.href||`conv-${H.idx}`;if(O.has(Q))continue;O.add(Q);if(!L.some((U)=>H.text.includes(U)))continue;if(!(await z.evaluate(`(async () => {
+          try {
+            const convs = Array.from(document.querySelectorAll('[data-testid="conversation"]'));
+            const conv = convs[${H.idx}];
+            if (!conv) return { ok: false, error: 'Conversation element not found' };
+            conv.click();
+            await new Promise(r => setTimeout(r, 2000));
+            return { ok: true };
+          } catch(e) {
+            return { ok: false, error: String(e) };
+          }
+        })()`))?.ok)continue;await z.wait(2);const J=await z.evaluate(`(async () => {
+          try {
+            const keywords = ${JSON.stringify(L)};
+
+            // Get username from conversation header
+            const heading = document.querySelector('[data-testid="conversation-header"]') ||
+                            document.querySelector('[data-testid="DM-conversation-header"]');
+            let username = 'Unknown';
+            if (heading) {
+              username = heading.innerText.trim().split('\\n')[0];
+            }
+
+            // Read full chat area text
+            const chatArea = document.querySelector('[data-testid="DmScrollerContainer"]') ||
+                             document.querySelector('[data-testid="DMConversationBody"]') ||
+                             document.querySelector('main [data-testid="cellInnerDiv"]')?.closest('section') ||
+                             document.querySelector('main');
+            const text = chatArea ? chatArea.innerText : '';
+
+            // Verify keyword match in full chat content
+            const matchedKw = keywords.filter(k => text.includes(k));
+            if (matchedKw.length === 0) {
+              return { status: 'skipped', user: username, message: 'No keyword match in full content' };
+            }
+
+            // Find the Accept button
+            const allBtns = Array.from(document.querySelectorAll('[role="button"]'));
+            const acceptBtn = allBtns.find(btn => {
+              const t = btn.innerText.trim().toLowerCase();
+              return t === 'accept' || t === '接受';
+            });
+
+            if (!acceptBtn) {
+              return { status: 'no_button', user: username, message: 'Keyword matched but no Accept button (already accepted?)' };
+            }
+
+            // Click Accept
+            acceptBtn.click();
+            await new Promise(r => setTimeout(r, 2000));
+
+            // Check for confirmation dialog
+            const btnsAfter = Array.from(document.querySelectorAll('[role="button"]'));
+            const confirmBtn = btnsAfter.find(btn => {
+              const t = btn.innerText.trim().toLowerCase();
+              return (t === 'accept' || t === '接受') && btn !== acceptBtn;
+            });
+            if (confirmBtn) {
+              confirmBtn.click();
+              await new Promise(r => setTimeout(r, 1000));
+            }
+
+            return { status: 'accepted', user: username, message: 'Accepted! Matched: ' + matchedKw.join(', ') };
+          } catch(e) {
+            return { status: 'error', user: 'system', message: String(e) };
+          }
+        })()`);if(J?.status==="accepted"){F++;P=!0;B.push({index:F,status:"accepted",user:J.user||"Unknown",message:J.message||"Accepted"});await z.wait(2);break}else if(J?.status==="no_button")continue}if(!P)break}if(B.length===0)B.push({index:0,status:"info",user:"System",message:`No requests matched keywords "${L.join(", ")}"`});return B}});

package/clis/twitter/article.js

@@ -0,0 +1,116 @@
+import{AuthRequiredError as Z,CommandExecutionError as G}from"@jackwener/opencli/errors";import{cli as $,Strategy as b}from"@jackwener/opencli/registry";import{resolveTwitterQueryId as K,describeTwitterApiError as L}from"./shared.js";import{TWITTER_BEARER_TOKEN as N}from"./utils.js";const O="7xflPyRiUxGVbJd4uWmbfg";$({site:"twitter",name:"article",access:"read",description:"Fetch a Twitter Article (long-form content) and export as Markdown",domain:"x.com",strategy:b.COOKIE,browser:!0,args:[{name:"tweet-id",type:"string",positional:!0,required:!0,help:"Tweet ID or URL containing the article"}],columns:["title","author","content","url"],func:async(f,P)=>{let j=P["tweet-id"];const V=/\/article\/\d+/.test(j),H=j.match(/\/(?:status|article)\/(\d+)/);if(H)j=H[1];if(V){await f.goto(`https://x.com/i/article/${j}`);await f.wait(3);const F=await f.evaluate(`
+        (function() {
+          var links = document.querySelectorAll('a[href*="/status/"]');
+          for (var i = 0; i < links.length; i++) {
+            var m = links[i].href.match(/\\/status\\/(\\d+)/);
+            if (m) return m[1];
+          }
+          var og = document.querySelector('meta[property="og:url"]');
+          if (og && og.content) {
+            var m2 = og.content.match(/\\/status\\/(\\d+)/);
+            if (m2) return m2[1];
+          }
+          return null;
+        })()
+      `);if(!F||typeof F!=="string")throw new G(`Could not resolve article ${j} to a tweet ID. The article page may not contain a linked tweet.`);j=F}await f.goto(`https://x.com/i/status/${j}`);await f.wait(3);const J=(await f.getCookies({url:"https://x.com"})).find((F)=>F.name==="ct0")?.value||null;if(!J)throw new Z("x.com","Not logged into x.com (no ct0 cookie)");const X=await K(f,"TweetResultByRestId",O),z=await f.evaluate(`
+      async () => {
+        const tweetId = "${j}";
+        const ct0 = ${JSON.stringify(J)};
+
+        const bearer = ${JSON.stringify(N)};
+        const headers = {
+          'Authorization': 'Bearer ' + decodeURIComponent(bearer),
+          'X-Csrf-Token': ct0,
+          'X-Twitter-Auth-Type': 'OAuth2Session',
+          'X-Twitter-Active-User': 'yes'
+        };
+
+        const variables = JSON.stringify({
+          tweetId: tweetId,
+          withCommunity: false,
+          includePromotedContent: false,
+          withVoice: false,
+        });
+        const features = JSON.stringify({
+          longform_notetweets_consumption_enabled: true,
+          responsive_web_twitter_article_tweet_consumption_enabled: true,
+          longform_notetweets_rich_text_read_enabled: true,
+          longform_notetweets_inline_media_enabled: true,
+          articles_preview_enabled: true,
+          responsive_web_graphql_exclude_directive_enabled: true,
+          verified_phone_label_enabled: false,
+        });
+        const fieldToggles = JSON.stringify({
+          withArticleRichContentState: true,
+          withArticlePlainText: true,
+        });
+
+        const url = '/i/api/graphql/' + ${JSON.stringify(X)} + '/TweetResultByRestId?variables='
+          + encodeURIComponent(variables)
+          + '&features=' + encodeURIComponent(features)
+          + '&fieldToggles=' + encodeURIComponent(fieldToggles);
+
+        const resp = await fetch(url, {headers, credentials: 'include'});
+        if (!resp.ok) return {httpStatus: resp.status};
+        const d = await resp.json();
+
+        const result = d.data?.tweetResult?.result;
+        if (!result) return {error: 'Article not found'};
+
+        // Unwrap TweetWithVisibilityResults
+        const tw = result.tweet || result;
+        const legacy = tw.legacy || {};
+        const user = tw.core?.user_results?.result;
+        const screenName = user?.legacy?.screen_name || user?.core?.screen_name || 'unknown';
+
+        // Extract article content
+        const articleResults = tw.article?.article_results?.result;
+        if (!articleResults) {
+          // Fallback: return note_tweet text if present
+          const noteText = tw.note_tweet?.note_tweet_results?.result?.text;
+          if (noteText) {
+            return [{
+              title: '(Note Tweet)',
+              author: screenName,
+              content: noteText,
+              url: 'https://x.com/' + screenName + '/status/' + tweetId,
+            }];
+          }
+          return {error: 'Tweet ' + tweetId + ' has no article content'};
+        }
+
+        const title = articleResults.title || '(Untitled)';
+        const contentState = articleResults.content_state || {};
+        const blocks = contentState.blocks || [];
+
+        // Convert draft.js blocks to Markdown
+        const parts = [];
+        let orderedCounter = 0;
+        for (const block of blocks) {
+          const blockType = block.type || 'unstyled';
+          if (blockType === 'atomic') continue;
+          const text = block.text || '';
+          if (!text) continue;
+          if (blockType !== 'ordered-list-item') orderedCounter = 0;
+
+          if (blockType === 'header-one')           parts.push('# ' + text);
+          else if (blockType === 'header-two')      parts.push('## ' + text);
+          else if (blockType === 'header-three')    parts.push('### ' + text);
+          else if (blockType === 'blockquote')       parts.push('> ' + text);
+          else if (blockType === 'unordered-list-item') parts.push('- ' + text);
+          else if (blockType === 'ordered-list-item') {
+            orderedCounter++;
+            parts.push(orderedCounter + '. ' + text);
+          }
+          else if (blockType === 'code-block')       parts.push('\`\`\`\\n' + text + '\\n\`\`\`');
+          else                                       parts.push(text);
+        }
+
+        return [{
+          title,
+          author: screenName,
+          content: parts.join('\\n\\n') || legacy.full_text || '',
+          url: 'https://x.com/' + screenName + '/status/' + tweetId,
+        }];
+      }
+    `);if(z?.httpStatus)throw new G(L("TweetResultByRestId",z.httpStatus));if(z?.error)throw new G(z.error+(z.hint?` (${z.hint})`:""));return z||[]}});

package/clis/twitter/auth.js

@@ -0,0 +1,4 @@
+import{AuthRequiredError as r}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as s}from"../_shared/site-auth.js";import{normalizeTwitterScreenName as c,unwrapBrowserResult as m}from"./shared.js";async function n(t){const o=await t.getCookies({url:"https://x.com"}),e=new Set(o.filter((i)=>i.value).map((i)=>i.name));return e.has("auth_token")&&e.has("ct0")}async function a(t){if(!await n(t))throw new r("x.com","Twitter/X auth cookies are missing");await t.goto("https://x.com/home");await t.wait(1);const o=m(await t.evaluate(`() => {
+    const link = document.querySelector('a[data-testid="AppTabBar_Profile_Link"]');
+    return link ? link.getAttribute('href') : null;
+  }`)),e=c(typeof o==="string"?o:"");if(!e)throw new r("x.com","Could not detect the logged-in Twitter/X profile link");return{username:e,url:`https://x.com/${e}`}}s({site:"twitter",domain:"x.com",loginUrl:"https://x.com/i/flow/login",columns:["username","url"],quickCheck:n,verify:a,poll:async(t)=>{if(!await n(t))throw new r("x.com","Waiting for Twitter/X auth cookies");return a(t)}});

package/clis/twitter/block.js

@@ -0,0 +1,62 @@
+import{CommandExecutionError as i}from"@jackwener/opencli/errors";import{cli as n,Strategy as s}from"@jackwener/opencli/registry";n({site:"twitter",name:"block",access:"write",description:"Block a Twitter user",domain:"x.com",strategy:s.UI,browser:!0,args:[{name:"username",type:"string",positional:!0,required:!0,help:"Twitter screen name (without @)"}],columns:["status","message"],func:async(e,r)=>{if(!e)throw new i("Browser session required for twitter block");const t=r.username.replace(/^@/,"");await e.goto(`https://x.com/${t}`);await e.wait({selector:'[data-testid="primaryColumn"]'});const o=await e.evaluate(`(async () => {
+        try {
+            let attempts = 0;
+
+            // Check if already blocked (profile shows "Blocked" / unblock button)
+            while (attempts < 20) {
+                const blockedIndicator = document.querySelector('[data-testid$="-unblock"]');
+                if (blockedIndicator) {
+                    return { ok: true, message: 'Already blocking @${t}.' };
+                }
+
+                const moreBtn = document.querySelector('[data-testid="userActions"]');
+                if (moreBtn) break;
+
+                await new Promise(r => setTimeout(r, 500));
+                attempts++;
+            }
+
+            const moreBtn = document.querySelector('[data-testid="userActions"]');
+            if (!moreBtn) {
+                return { ok: false, message: 'Could not find user actions menu. Are you logged in?' };
+            }
+
+            // Open the more actions menu
+            moreBtn.click();
+            await new Promise(r => setTimeout(r, 1000));
+
+            // Find the Block menu item
+            const menuItems = document.querySelectorAll('[role="menuitem"]');
+            let blockItem = null;
+            for (const item of menuItems) {
+                if (item.textContent && item.textContent.includes('Block')) {
+                    blockItem = item;
+                    break;
+                }
+            }
+
+            if (!blockItem) {
+                return { ok: false, message: 'Could not find Block option in menu.' };
+            }
+
+            blockItem.click();
+            await new Promise(r => setTimeout(r, 1000));
+
+            // Confirm the block in the dialog
+            const confirmBtn = document.querySelector('[data-testid="confirmationSheetConfirm"]');
+            if (confirmBtn) {
+                confirmBtn.click();
+                await new Promise(r => setTimeout(r, 1500));
+            }
+
+            // Verify
+            const verify = document.querySelector('[data-testid$="-unblock"]');
+            if (verify) {
+                return { ok: true, message: 'Successfully blocked @${t}.' };
+            } else {
+                return { ok: false, message: 'Block action initiated but UI did not update.' };
+            }
+        } catch (e) {
+            return { ok: false, message: e.toString() };
+        }
+    })()`);if(o.ok)await e.wait(2);return[{status:o.ok?"success":"failed",message:o.message}]}});