publishport-opencli 1.0.0

package/clis/grok/export.js

@@ -0,0 +1,106 @@
+import{cli as h,Strategy as g}from"@jackwener/opencli/registry";import{ArgumentError as n,AuthRequiredError as p,EmptyResultError as i,TimeoutError as b}from"@jackwener/opencli/errors";import{normalizeConversationRows as y,requireObjectEvaluateResult as x}from"./export-utils.js";const a="grok.com",w="https://grok.com/";function c(e){const t=Number(e??0);if(!Number.isInteger(t)||t<0)throw new n("limit","must be 0 or a positive integer");return t}function m(e){const t=Number(e??80);if(!Number.isInteger(t)||t<=0)throw new n("maxScrolls","must be a positive integer");if(t>500)throw new n("maxScrolls","must be <= 500");return t}export const grokExportCommand=h({site:"grok",name:"export",description:"Export all visible Grok conversation history metadata",access:"read",example:"opencli grok export -f yaml",domain:a,strategy:g.COOKIE,browser:!0,siteSession:"persistent",navigateBefore:!1,args:[{name:"limit",type:"int",default:0,help:"Max conversations to export; 0 means all loaded history"},{name:"maxScrolls",type:"int",default:80,help:"Max history-list scroll rounds when limit is 0 (max 500)"}],columns:["index","id","title","date","url"],func:async(e,o)=>{const t=c(o.limit),u=m(o.maxScrolls);await e.goto(w);await e.wait(2);const d=await e.evaluate(`(async () => {
+      const targetLimit = ${JSON.stringify(t)};
+      const maxScrolls = ${JSON.stringify(u)};
+      const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+      const isVisible = (node) => {
+        if (!(node instanceof Element)) return false;
+        const style = window.getComputedStyle(node);
+        if (style.visibility === 'hidden' || style.display === 'none') return false;
+        const rect = node.getBoundingClientRect();
+        return rect.width > 0 && rect.height > 0;
+      };
+      const hasHistoryEntry = Boolean(document.querySelector('a[href^="/c/"]'));
+      const hasHistoryLauncher = Array.from(document.querySelectorAll('button, [role="button"]'))
+        .some((node) => isVisible(node) && /^(查看全部|show all|view all)$/i.test((node.textContent || '').trim()));
+      const signInCta = Array.from(document.querySelectorAll('button, a'))
+        .some((node) => isVisible(node) && /^(sign in|log in)$/i.test((node.textContent || '').trim()));
+      if (signInCta && !hasHistoryEntry && !hasHistoryLauncher) {
+        return { ok: false, code: 'AUTH' };
+      }
+
+      const clickAllHistory = () => {
+        const buttons = Array.from(document.querySelectorAll('button, [role="button"]'))
+          .filter((node) => node instanceof HTMLElement && isVisible(node));
+        const target = buttons.find((node) => /^(查看全部|show all|view all)$/i.test((node.textContent || '').trim()));
+        if (!target) return false;
+        target.click();
+        return true;
+      };
+
+      if (!document.querySelector('[role="listbox"] a[href^="/c/"]')) {
+        clickAllHistory();
+      }
+
+      let listbox = null;
+      for (let attempt = 0; attempt < 30; attempt += 1) {
+        listbox = document.querySelector('[role="listbox"]');
+        if (listbox && listbox.querySelector('a[href^="/c/"]')) break;
+        await sleep(250);
+      }
+      if (!listbox || !listbox.querySelector('a[href^="/c/"]')) {
+        return { ok: false, code: 'NO_DIALOG' };
+      }
+
+      const findScroller = () => {
+        const nodes = Array.from(listbox.querySelectorAll('*'));
+        return nodes.find((node) => node.scrollHeight > node.clientHeight + 20) || listbox;
+      };
+      const scroller = findScroller();
+      const seen = new Map();
+      const collect = () => {
+        const anchors = Array.from(listbox.querySelectorAll('a[href^="/c/"]'));
+        for (const a of anchors) {
+          const href = a.getAttribute('href') || '';
+          const match = href.match(/^\\/c\\/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$/i);
+          if (!match) continue;
+          const id = match[1].toLowerCase();
+          const option = a.closest('[role="option"]') || a.parentElement;
+          const lines = (option?.innerText || option?.textContent || a.textContent || '')
+            .split(/\\n+/)
+            .map((line) => line.trim())
+            .filter(Boolean);
+          seen.set(id, {
+            id,
+            title: lines[0] || '',
+            date: lines.slice(1).find(Boolean) || '',
+            url: 'https://grok.com/c/' + id,
+          });
+        }
+      };
+
+      scroller.scrollTop = 0;
+      scroller.dispatchEvent(new Event('scroll', { bubbles: true }));
+      await sleep(250);
+
+      let lastCount = -1;
+      let stableRounds = 0;
+      let lastScrollHeight = -1;
+      const stableTarget = targetLimit > 0 ? 5 : 8;
+      const settleMs = targetLimit > 0 ? 300 : 350;
+      const maxAttempts = targetLimit > 0 ? maxScrolls : Math.min(maxScrolls, 500);
+      for (let attempt = 0; attempt < maxAttempts && stableRounds < stableTarget; attempt += 1) {
+        collect();
+        if (targetLimit > 0 && seen.size >= targetLimit) break;
+        scroller.scrollTop = scroller.scrollHeight;
+        scroller.dispatchEvent(new Event('scroll', { bubbles: true }));
+        await sleep(settleMs);
+        collect();
+        if (targetLimit > 0 && seen.size >= targetLimit) break;
+        const count = seen.size;
+        const height = scroller.scrollHeight;
+        if (count === lastCount && height === lastScrollHeight) {
+          stableRounds += 1;
+        } else {
+          stableRounds = 0;
+          lastCount = count;
+          lastScrollHeight = height;
+        }
+      }
+
+      return {
+        ok: true,
+        rows: Array.from(seen.values()),
+        scrollTop: scroller.scrollTop,
+        scrollHeight: scroller.scrollHeight,
+      };
+    })()`),r=x(d,"grok export history dialog");if(r.ok!==!0){if(r?.code==="AUTH")throw new p(a,"Sign in to grok.com in the browser, then retry.");if(r?.code==="NO_DIALOG")throw new b("grok export history dialog",8);throw new i("grok export","No Grok conversation history was visible.")}const l=y(r.rows,"grok export history dialog");if(!l.length)throw new i("grok export","No Grok conversations found in the signed-in account history.");return(t?l.slice(0,t):l).map((s,f)=>({index:f+1,id:s.id,title:s.title||null,date:s.date||null,url:s.url}))}}),__test__={normalizeLimit:c,normalizeMaxScrolls:m};

package/clis/grok/history.js

@@ -0,0 +1 @@
+import{cli as a,Strategy as m}from"@jackwener/opencli/registry";import{ArgumentError as o,EmptyResultError as l}from"@jackwener/opencli/errors";import{GROK_DOMAIN as u,authRequired as c,ensureOnGrok as d,getHistoryFromSidebar as f,isLoggedIn as h}from"./utils.js";a({site:"grok",name:"history",access:"read",description:"List recent Grok conversations from the sidebar (requires login)",domain:u,strategy:m.COOKIE,browser:!0,siteSession:"persistent",navigateBefore:!1,args:[{name:"limit",type:"int",default:20,help:"Max conversations to show (default 20, max 100)"}],columns:["Index","Title","Url"],func:async(e,s)=>{const t=Number(s.limit??20);if(!Number.isInteger(t)||t<=0)throw new o("limit","must be a positive integer");if(t>100)throw new o("limit","must be <= 100");await d(e);await e.wait(2);if(!await h(e))throw c();const i=await f(e,t);if(!i.length)throw new l("grok history","No Grok conversations found in the sidebar for the signed-in account.");return i.slice(0,t).map((r,n)=>({Index:n+1,Title:r.title||"(untitled)",Url:`https://grok.com/c/${r.id}`}))}});

package/clis/grok/image.js

@@ -0,0 +1,119 @@
+import*as L from"node:fs";import*as k from"node:path";import*as I from"node:crypto";import{cli as f,Strategy as w}from"@jackwener/opencli/registry";import{ArgumentError as S,CommandExecutionError as x,TimeoutError as b}from"@jackwener/opencli/errors";const O="https://grok.com/",h="Likely login/auth/challenge/session issue in the existing grok.com browser session.";function P(q){if(typeof q==="boolean")return q;const Q=String(q??"").trim().toLowerCase();return Q==="true"||Q==="1"||Q==="yes"||Q==="on"}function T(q,Q,W){const Y=Number(q??Q);if(!Number.isInteger(Y)||Y<=0)throw new S(`${W} must be a positive integer`);return Y}function E(q){const Q=new Set,W=[];for(const X of q){if(!X.src||Q.has(X.src))continue;Q.add(X.src);W.push(X)}return W}function F(q){return q.map((Q)=>Q.src).sort().join("|")}function z(q){if(!q)return"jpg";if(q.includes("png"))return"png";if(q.includes("webp"))return"webp";if(q.includes("gif"))return"gif";return"jpg"}function B(q,Q){const W=z(Q),X=I.createHash("sha1").update(q).digest("hex").slice(0,12);return`grok-${Date.now()}-${X}.${W}`}async function D(q){const Q=await q.evaluate("window.location.href").catch(()=>"");if(typeof Q!=="string"||!Q)return!1;try{const W=new URL(Q).hostname;return W==="grok.com"||W.endsWith(".grok.com")}catch{return!1}}async function c(q){await q.evaluate(`(() => {
+    const isVisible = (node) => {
+      if (!(node instanceof HTMLElement)) return false;
+      const rect = node.getBoundingClientRect();
+      const style = window.getComputedStyle(node);
+      return rect.width > 0 && rect.height > 0 && style.visibility !== 'hidden' && style.display !== 'none';
+    };
+    const candidates = Array.from(document.querySelectorAll('a, button')).filter(node => {
+      if (!isVisible(node)) return false;
+      const text = (node.textContent || '').trim().toLowerCase();
+      const aria = (node.getAttribute('aria-label') || '').trim().toLowerCase();
+      const href = node.getAttribute('href') || '';
+      return text.includes('new chat')
+        || text.includes('new conversation')
+        || aria.includes('new chat')
+        || aria.includes('new conversation')
+        || href === '/';
+    });
+    const target = candidates[0];
+    if (target instanceof HTMLElement) target.click();
+  })()`)}async function d(q,Q){const W=JSON.stringify(Q);return q.evaluate(`(async () => {
+    try {
+      const waitFor = (ms) => new Promise(resolve => setTimeout(resolve, ms));
+      const composerSelector = '.ProseMirror[contenteditable="true"]';
+      const isVisibleEnabledSubmit = (node) => {
+        if (!(node instanceof HTMLButtonElement)) return false;
+        const rect = node.getBoundingClientRect();
+        const style = window.getComputedStyle(node);
+        return !node.disabled
+          && rect.width > 0
+          && rect.height > 0
+          && style.visibility !== 'hidden'
+          && style.display !== 'none';
+      };
+
+      let pm = null;
+      let box = null;
+      for (let attempt = 0; attempt < 12; attempt += 1) {
+        const composer = document.querySelector(composerSelector);
+        if (composer instanceof HTMLElement) {
+          pm = composer;
+          break;
+        }
+
+        const textarea = document.querySelector('textarea');
+        if (textarea instanceof HTMLTextAreaElement) {
+          box = textarea;
+          break;
+        }
+
+        await waitFor(1000);
+      }
+
+      // Prefer the ProseMirror composer when present (current grok.com UI).
+      if (pm && pm.editor && pm.editor.commands) {
+        try {
+          if (pm.editor.commands.clearContent) pm.editor.commands.clearContent();
+          pm.editor.commands.focus();
+          pm.editor.commands.insertContent(${W});
+          for (let attempt = 0; attempt < 6; attempt += 1) {
+            const sbtn = Array.from(document.querySelectorAll('button[aria-label="Submit"], button[aria-label="\\u63d0\\u4ea4"]'))
+              .find(isVisibleEnabledSubmit);
+            if (sbtn) {
+              sbtn.click();
+              return { ok: true, msg: 'pm-submit' };
+            }
+            await waitFor(500);
+          }
+        } catch (e) { /* fall through to textarea */ }
+      }
+
+      // Fallback: legacy textarea composer.
+      if (!box) return { ok: false, msg: 'no composer (neither ProseMirror nor textarea)' };
+      box.focus(); box.value = '';
+      document.execCommand('selectAll');
+      document.execCommand('insertText', false, ${W});
+      for (let attempt = 0; attempt < 6; attempt += 1) {
+        const btn = Array.from(document.querySelectorAll('button[aria-label="\\u63d0\\u4ea4"], button[aria-label="Submit"]'))
+          .find(isVisibleEnabledSubmit);
+        if (btn) {
+          btn.click();
+          return { ok: true, msg: 'clicked' };
+        }
+
+        const sub = Array.from(document.querySelectorAll('button[type="submit"]'))
+          .find(isVisibleEnabledSubmit);
+        if (sub) {
+          sub.click();
+          return { ok: true, msg: 'clicked-submit' };
+        }
+
+        await waitFor(500);
+      }
+      box.dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', code: 'Enter', keyCode: 13, bubbles: true }));
+      return { ok: true, msg: 'enter' };
+    } catch (e) { return { ok: false, msg: e && e.toString ? e.toString() : String(e) }; }
+  })()`)}async function y(q){const Q=await q.evaluate(`(() => {
+    const bubbles = document.querySelectorAll('div.message-bubble, [data-testid="message-bubble"]');
+    return Array.from(bubbles).map(bubble => Array.from(bubble.querySelectorAll('img'))
+      .map(img => ({
+        src: img.currentSrc || img.src || '',
+        w: img.naturalWidth || img.width || 0,
+        h: img.naturalHeight || img.height || 0,
+      }))
+      .filter(i => i.src && /^https?:/.test(i.src))
+      // Ignore tiny UI/avatar images that may live in the bubble chrome.
+      .filter(i => (i.w === 0 || i.w >= 128) && (i.h === 0 || i.h >= 128)));
+  })()`);return(Array.isArray(Q)?Q:[]).map(E)}function R(q,Q){const W=q.slice(Math.max(0,Q));for(let X=W.length-1;X>=0;X-=1)if(W[X].length)return W[X];return[]}async function p(q,Q){const W=JSON.stringify(Q);return q.evaluate(`(async () => {
+    try {
+      const res = await fetch(${W}, { credentials: 'include', referrer: 'https://grok.com/' });
+      if (!res.ok) return { ok: false, error: 'HTTP ' + res.status };
+      const blob = await res.blob();
+      const buf = await blob.arrayBuffer();
+      const bytes = new Uint8Array(buf);
+      let binary = '';
+      for (let i = 0; i < bytes.length; i++) binary += String.fromCharCode(bytes[i]);
+      return { ok: true, base64: btoa(binary), contentType: blob.type || 'image/jpeg' };
+    } catch (e) { return { ok: false, error: e && e.message || String(e) }; }
+  })()`)}async function v(q,Q,W){L.mkdirSync(W,{recursive:!0});const X=[];for(const Y of Q){const Z=await p(q,Y.src);if(!Z||!Z.ok){const M=Z?.error?`: ${Z.error}`:"";throw new x(`Failed to download grok image ${Y.src}${M}`,"assets.grok.com download requires the live grok.com browser session — verify the tab is logged in and try again.")}const H=k.join(W,B(Y.src,Z.contentType));L.writeFileSync(H,Buffer.from(Z.base64||"","base64"));X.push({...Y,path:H})}return X}function K(q,Q=""){return{url:q.src,width:q.w,height:q.h,path:Q}}export const imageCommand=f({site:"grok",name:"image",description:"Generate images on grok.com and return image URLs",access:"write",domain:"grok.com",strategy:w.COOKIE,browser:!0,siteSession:"persistent",args:[{name:"prompt",positional:!0,type:"string",required:!0,help:"Image generation prompt"},{name:"timeout",type:"int",default:240,help:"Max seconds to wait for the image (default: 240)"},{name:"new",type:"boolean",default:!1,help:"Start a new chat before sending (default: false)"},{name:"count",type:"int",default:1,help:"Minimum images to wait for before returning (default: 1)"},{name:"out",type:"string",default:"",help:"Directory to save downloaded images (uses browser session to bypass auth)"}],columns:["url","width","height","path"],func:async(q,Q)=>{const W=Q.prompt,X=(Q.timeout||240)*1000,Y=P(Q.new),Z=T(Q.count,1,"count"),H=(Q.out||"").toString().trim();if(Y){await q.goto(O);await q.wait(2);await c(q);await q.wait(2)}else if(!await D(q)){await q.goto(O);await q.wait(3)}const M=(await y(q)).length,N=await d(q,W);if(!N||!N.ok)throw new x(`Grok composer rejected the prompt: ${JSON.stringify(N)}`,h);const C=Date.now();let V="",U=0,j=[];while(Date.now()-C<X){await q.wait(3);const A=await y(q),$=R(A,M);if($.length>=Z){const J=F($);if(J===V){U+=1;if(U>=2){if(H)return(await v(q,$,H)).map((G)=>K(G,G.path));return $.map((_)=>K(_))}}else{U=0;V=J;j=$}}}if(j.length){if(H)return(await v(q,j,H)).map(($)=>K($,$.path));return j.map((A)=>K(A))}throw new b("grok image generation",Math.round(X/1000))}}),__test__={normalizeBooleanFlag:P,normalizePositiveInteger:T,isOnGrok:D,dedupeBySrc:E,imagesSignature:F,extFromContentType:z,buildFilename:B,pickLatestImageCandidate:R};

package/clis/grok/image.test.ts

@@ -0,0 +1,127 @@
+import { describe, expect, it } from 'vitest';
+import type { IPage } from '@jackwener/opencli/types';
+import { ArgumentError } from '@jackwener/opencli/errors';
+import { __test__ } from './image.js';
+
+describe('grok image helpers', () => {
+  describe('isOnGrok', () => {
+    const fakePage = (url: string | Error): IPage =>
+      ({ evaluate: () => url instanceof Error ? Promise.reject(url) : Promise.resolve(url) }) as unknown as IPage;
+
+    it('returns true for grok.com URLs', async () => {
+      expect(await __test__.isOnGrok(fakePage('https://grok.com/'))).toBe(true);
+      expect(await __test__.isOnGrok(fakePage('https://grok.com/chat/abc123'))).toBe(true);
+    });
+
+    it('returns true for grok.com subdomains', async () => {
+      expect(await __test__.isOnGrok(fakePage('https://assets.grok.com/foo'))).toBe(true);
+    });
+
+    it('returns false for non-grok domains', async () => {
+      expect(await __test__.isOnGrok(fakePage('https://fakegrok.com/'))).toBe(false);
+      expect(await __test__.isOnGrok(fakePage('about:blank'))).toBe(false);
+    });
+
+    it('returns false when evaluate throws (detached tab)', async () => {
+      expect(await __test__.isOnGrok(fakePage(new Error('detached')))).toBe(false);
+    });
+  });
+
+  it('normalizes boolean flags', () => {
+    expect(__test__.normalizeBooleanFlag(true)).toBe(true);
+    expect(__test__.normalizeBooleanFlag('true')).toBe(true);
+    expect(__test__.normalizeBooleanFlag('1')).toBe(true);
+    expect(__test__.normalizeBooleanFlag('yes')).toBe(true);
+    expect(__test__.normalizeBooleanFlag('on')).toBe(true);
+
+    expect(__test__.normalizeBooleanFlag(false)).toBe(false);
+    expect(__test__.normalizeBooleanFlag('false')).toBe(false);
+    expect(__test__.normalizeBooleanFlag(undefined)).toBe(false);
+  });
+
+  it('dedupes images by src', () => {
+    const deduped = __test__.dedupeBySrc([
+      { src: 'https://a.example/1.jpg', w: 500, h: 500 },
+      { src: 'https://a.example/1.jpg', w: 500, h: 500 },
+      { src: 'https://a.example/2.jpg', w: 500, h: 500 },
+      { src: '', w: 500, h: 500 },
+    ]);
+    expect(deduped.map(i => i.src)).toEqual([
+      'https://a.example/1.jpg',
+      'https://a.example/2.jpg',
+    ]);
+  });
+
+  it('builds a deterministic-ish signature order-independent by src', () => {
+    const sigA = __test__.imagesSignature([
+      { src: 'https://a.example/1.jpg', w: 1, h: 1 },
+      { src: 'https://a.example/2.jpg', w: 1, h: 1 },
+    ]);
+    const sigB = __test__.imagesSignature([
+      { src: 'https://a.example/2.jpg', w: 1, h: 1 },
+      { src: 'https://a.example/1.jpg', w: 1, h: 1 },
+    ]);
+    expect(sigA).toBe(sigB);
+  });
+
+  it('maps content-type to sensible image extensions', () => {
+    expect(__test__.extFromContentType('image/png')).toBe('png');
+    expect(__test__.extFromContentType('image/webp')).toBe('webp');
+    expect(__test__.extFromContentType('image/gif')).toBe('gif');
+    expect(__test__.extFromContentType('image/jpeg')).toBe('jpg');
+    expect(__test__.extFromContentType(undefined)).toBe('jpg');
+    expect(__test__.extFromContentType('')).toBe('jpg');
+  });
+
+  it('builds filenames with a stable sha1 slice tied to the src', () => {
+    const a1 = __test__.buildFilename('https://a.example/1.jpg', 'image/jpeg');
+    const a2 = __test__.buildFilename('https://a.example/1.jpg', 'image/jpeg');
+    const b1 = __test__.buildFilename('https://a.example/2.jpg', 'image/png');
+    // Same URL → same 12-char hash slice (timestamps may differ).
+    expect(a1.split('-')[2].split('.')[0]).toBe(a2.split('-')[2].split('.')[0]);
+    expect(a1.split('-')[2].split('.')[0]).not.toBe(b1.split('-')[2].split('.')[0]);
+    expect(a1.endsWith('.jpg')).toBe(true);
+    expect(b1.endsWith('.png')).toBe(true);
+  });
+
+  it('only accepts image bubbles that appeared after the baseline', () => {
+    const candidate = __test__.pickLatestImageCandidate([
+      [{ src: 'https://a.example/stale.jpg', w: 512, h: 512 }],
+      [],
+      [{ src: 'https://a.example/fresh.jpg', w: 1024, h: 1024 }],
+    ], 1);
+
+    expect(candidate).toEqual([
+      { src: 'https://a.example/fresh.jpg', w: 1024, h: 1024 },
+    ]);
+  });
+
+  describe('normalizePositiveInteger', () => {
+    it('returns a parsed positive integer', () => {
+      expect(__test__.normalizePositiveInteger(3, 1, 'count')).toBe(3);
+      expect(__test__.normalizePositiveInteger('5', 1, 'count')).toBe(5);
+    });
+
+    it('falls back to the default when the user did not pass a value', () => {
+      expect(__test__.normalizePositiveInteger(undefined, 1, 'count')).toBe(1);
+      expect(__test__.normalizePositiveInteger(null, 4, 'count')).toBe(4);
+    });
+
+    it('throws ArgumentError instead of silently clamping out-of-range input', () => {
+      expect(() => __test__.normalizePositiveInteger(0, 1, 'count')).toThrow(ArgumentError);
+      expect(() => __test__.normalizePositiveInteger(-1, 1, 'count')).toThrow(ArgumentError);
+      expect(() => __test__.normalizePositiveInteger(1.5, 1, 'count')).toThrow(ArgumentError);
+      expect(() => __test__.normalizePositiveInteger('not-a-number', 1, 'count')).toThrow(ArgumentError);
+    });
+  });
+
+  it('does not reuse stale images when no new image bubble appears after baseline', () => {
+    const candidate = __test__.pickLatestImageCandidate([
+      [{ src: 'https://a.example/stale.jpg', w: 512, h: 512 }],
+      [],
+      [],
+    ], 1);
+
+    expect(candidate).toEqual([]);
+  });
+});

package/clis/grok/new.js

@@ -0,0 +1 @@
+import{cli as e,Strategy as r}from"@jackwener/opencli/registry";import{GROK_DOMAIN as a,startNewChat as s}from"./utils.js";e({site:"grok",name:"new",access:"write",description:"Start a new conversation in Grok",domain:a,strategy:r.COOKIE,browser:!0,siteSession:"persistent",navigateBefore:!1,args:[],columns:["Status"],func:async(t)=>{await s(t);return[{Status:"New chat started"}]}});

package/clis/grok/pin.js

@@ -0,0 +1 @@
+import{cli as D,Strategy as K}from"@jackwener/opencli/registry";import{CommandExecutionError as Y}from"@jackwener/opencli/errors";import{GROK_DOMAIN as F,ensureOnGrok as P,authRequired as R,isLoggedIn as j,parseGrokSessionId as y,clickConversationMenuItem as G,getPinStateFromMenuLabels as H,readConversationMenuLabels as M,waitForConversationPinState as _}from"./utils.js";const Z="Likely login/auth/challenge/session issue in the existing grok.com browser session.";function $(z,q){D({site:"grok",name:z,access:"write",description:`${z==="pin"?"Pin":"Unpin"} a Grok conversation by ID`,domain:F,strategy:K.COOKIE,browser:!0,siteSession:"persistent",args:[{name:"id",positional:!0,type:"string",required:!0,help:"Conversation UUID or grok.com/c/<uuid> URL"}],columns:["status","id"],func:async(B,A)=>{const J=y(A.id);await P(B);if(!await j(B))throw R();const W=z==="pin"?"pinned":"unpinned",Q=await M(B,J);if(!Q.ok){const V=Q.detail?` ${Q.detail}`:"";throw new Y(`${Q.reason||`Failed to inspect ${z} state.`}${V}`,Z)}if(H(Q.labels)===W)return[{status:`already-${W}`,id:J}];const U=await G(B,J,q);if(!U||!U.ok){const V=U?.detail?` ${U.detail}`:"";throw new Y(`${U?.reason||`Failed to ${z} conversation.`}${V}`,Z)}const X=await _(B,J,W);if(!X.ok){const V=X.labels?.length?` labels=${JSON.stringify(X.labels)}`:"";throw new Y(`${z} menu item was clicked, but the conversation did not verify as ${W}.${V}`,Z)}return[{status:z==="pin"?"pinned":"unpinned",id:J}]}})}$("pin",["置顶","pin"]);$("unpin",["取消置顶","unpin"]);

package/clis/grok/read.js

@@ -0,0 +1 @@
+import{cli as n,Strategy as o}from"@jackwener/opencli/registry";import{GROK_DOMAIN as i,bubbleHtmlToMarkdown as l,ensureOnGrok as m,getMessageBubbles as c,normalizeBooleanFlag as u}from"./utils.js";n({site:"grok",name:"read",access:"read",description:"Read messages in the current Grok conversation",domain:i,strategy:o.COOKIE,browser:!0,siteSession:"persistent",navigateBefore:!1,args:[{name:"markdown",type:"boolean",default:!1,help:"Emit assistant replies as markdown"}],columns:["Role","Text"],func:async(t,a)=>{const r=u(a.markdown,!1);await m(t);await t.wait(2);const s=await c(t);if(!s.length)return[{Role:"system",Text:"No visible messages in the current conversation."}];return s.map((e)=>({Role:e.role,Text:r&&e.role==="Assistant"&&e.html?l(e.html)||e.text:e.text}))}});

package/clis/grok/send.js

@@ -0,0 +1 @@
+import{cli as Q,Strategy as T}from"@jackwener/opencli/registry";import{ArgumentError as U,CommandExecutionError as V}from"@jackwener/opencli/errors";import{GROK_DOMAIN as W,authRequired as X,ensureOnGrok as Y,isLoggedIn as Z,normalizeBooleanFlag as $,sendMessage as q,startNewChat as z}from"./utils.js";Q({site:"grok",name:"send",access:"write",description:"Fire-and-forget: send a prompt to Grok without waiting for the reply",domain:W,strategy:T.COOKIE,browser:!0,siteSession:"persistent",navigateBefore:!1,args:[{name:"prompt",required:!0,positional:!0,help:"Prompt to send to Grok"},{name:"new",type:"boolean",default:!1,help:"Start a new chat before sending"}],columns:["Status","Prompt"],func:async(b,H)=>{const v=String(H.prompt||"").trim();if(!v)throw new U("prompt","is required");const P=$(H.new,!1);await Y(b);if(P)await z(b);const J=await q(b,v);if(!J?.ok){if(!await Z(b))throw X();throw new V(J?.reason||"Failed to send Grok prompt")}return[{Status:"sent",Prompt:v}]}});

package/clis/grok/status.js

@@ -0,0 +1 @@
+import{cli as E,Strategy as F}from"@jackwener/opencli/registry";import{GROK_DOMAIN as H,ensureOnGrok as J,getCurrentSessionId as P,getModelLabel as Q,isLoggedIn as T}from"./utils.js";E({site:"grok",name:"status",access:"read",description:"Check Grok page availability, login state, current session and model",domain:H,strategy:F.COOKIE,browser:!0,siteSession:"persistent",navigateBefore:!1,args:[],columns:["Status","Login","Model","SessionId","Url"],func:async(q)=>{await J(q);await q.wait(2);const[B,v,x,z]=await Promise.all([T(q),P(q),Q(q),q.evaluate("window.location.href").catch(()=>"")]);return[{Status:"Connected",Login:B?"Yes":"No",Model:x?x:null,SessionId:v?v:null,Url:typeof z==="string"?z:""}]}});