publishport-opencli 1.0.0

package/clis/linkedin/search.js

@@ -0,0 +1,50 @@
+import{cli as w,Strategy as A}from"@jackwener/opencli/registry";import{ArgumentError as q,AuthRequiredError as V,CommandExecutionError as I}from"@jackwener/opencli/errors";const O="linkedin.com",v=1,k=100,E=0,S={internship:"1",entry:"2","entry-level":"2",associate:"3",mid:"4",senior:"4","mid-senior":"4","mid-senior-level":"4",director:"5",executive:"6"},N={"full-time":"F",fulltime:"F",full:"F","part-time":"P",parttime:"P",part:"P",contract:"C",temporary:"T",temp:"T",volunteer:"V",internship:"I",other:"O"},D={any:"on",month:"r2592000","past-month":"r2592000",week:"r604800","past-week":"r604800",day:"r86400","24h":"r86400","past-24h":"r86400"},L={onsite:"1","on-site":"1",hybrid:"3",remote:"2"};function P(G){if(G===void 0||G===null||G==="")return[];return String(G).split(",").map((Z)=>Z.trim()).filter(Boolean)}function F(G,Z,z){const H=P(G).map((Q)=>{const U=Q.toLowerCase(),W=Z[U];if(!W)throw new q(`Unsupported ${z}: ${Q}`);return W});return[...new Set(H)]}function b(G){return String(G??"").replace(/\s+/g," ").trim()}function R(G,Z,z,$,H=1/0){if(G===void 0||G===null||G==="")return z;const Q=Number(G);if(!Number.isFinite(Q)||!Number.isInteger(Q))throw new q(`${Z} must be an integer, got ${JSON.stringify(G)}`);if(Q<$||Q>H){const U=Number.isFinite(H)?`between ${$} and ${H}`:`at least ${$}`;throw new q(`${Z} must be ${U}, got ${Q}`)}return Q}function T(G){if(!G)return"";try{const Z=new URL(G);if(Z.pathname==="/redir/redirect/")return Z.searchParams.get("url")||G}catch{}return G}function m(G){const z=["origin:"+(G.companyIds.length||G.experienceLevels.length||G.jobTypes.length||G.datePostedValues.length||G.remoteTypes.length?"JOB_SEARCH_PAGE_JOB_FILTER":"JOB_SEARCH_PAGE_OTHER_ENTRY"),"keywords:"+G.keywords];if(G.location)z.push("locationUnion:(seoLocation:(location:"+G.location+"))");const $=[];if(G.companyIds.length)$.push("company:List("+G.companyIds.join(",")+")");if(G.experienceLevels.length)$.push("experience:List("+G.experienceLevels.join(",")+")");if(G.jobTypes.length)$.push("jobType:List("+G.jobTypes.join(",")+")");if(G.datePostedValues.length)$.push("timePostedRange:List("+G.datePostedValues.join(",")+")");if(G.remoteTypes.length)$.push("workplaceType:List("+G.remoteTypes.join(",")+")");if($.length)z.push("selectedFilters:("+$.join(",")+")");z.push("spellCorrectionEnabled:true");return"("+z.join(",")+")"}function c(G,Z,z){const $=new URLSearchParams({decorationId:"com.linkedin.voyager.dash.deco.jobs.search.JobSearchCardsCollection-220",count:String(z),q:"jobSearch"}),H=encodeURIComponent(m(G)).replace(/%3A/gi,":").replace(/%2C/gi,",").replace(/%28/gi,"(").replace(/%29/gi,")");return"/voyager/api/voyagerJobsDashJobCards?"+$.toString()+"&query="+H+"&start="+Z}function _(G){const Z=String(G??"").replace(/\s+/g," ").trim().toLowerCase();if(!Z)return!1;return/\b(sign in|log in|join linkedin)\b/.test(Z)||/linkedin\.com\/(login|checkpoint|authwall)/i.test(Z)||/\b(captcha|verification required)\b/.test(Z)||/(请登录|登录领英|安全验证)/.test(Z)}function g(){return`(() => {
+      const text = [
+        window.location.href || '',
+        document.title || '',
+        document.body ? (document.body.innerText || '').slice(0, 4000) : '',
+      ].join('\\n');
+      return ${_.toString()}(text);
+    })()`}async function x(G,Z){if(await G.evaluate(g()))throw new V(O,`${Z} requires an active signed-in LinkedIn browser session`)}function d(G){const Z=new Set,z=[];for(const $ of P(G)){const H=$.replace(/^urn:li:[a-z_]+:/,"");if(/^\d+$/.test(H))Z.add(H);else z.push($)}if(z.length)throw new q(`--company now requires numeric LinkedIn company IDs (got name(s): ${z.join(", ")}). Find an ID from the company's LinkedIn page URL or its /company/<slug>/ Voyager data.`);return[...Z]}async function o(G,Z){const z=25,$=[];let H=Z.start;const U=(await G.getCookies({url:"https://www.linkedin.com"})).find((B)=>B.name==="JSESSIONID")?.value;if(!U)throw new V(O,"LinkedIn JSESSIONID cookie not found. Please sign in to LinkedIn in the browser.");const W=U.replace(/^"|"$/g,"");while($.length<Z.limit){const B=Math.min(z,Z.limit-$.length),Y=c(Z,H,B),X=await G.evaluate(`(async () => {
+      const res = await fetch(${JSON.stringify(Y)}, {
+        credentials: 'include',
+        headers: { 'csrf-token': ${JSON.stringify(W)}, 'x-restli-protocol-version': '2.0.0' },
+      });
+      if (res.status === 401 || res.status === 403) {
+        const text = await res.text();
+        return {
+          authRequired: true,
+          error: 'LinkedIn API authentication failed: HTTP ' + res.status + ' ' + text.slice(0, 200)
+        };
+      }
+      if (!res.ok) {
+        const text = await res.text();
+        return { error: 'LinkedIn API error: HTTP ' + res.status + ' ' + text.slice(0, 200) };
+      }
+      return res.json();
+    })()`);if(!X||X.error){if(X?.authRequired)throw new V(O,X.error);throw new I(X?.error||"LinkedIn search returned an unexpected response")}const C=Array.isArray(X?.elements)?X.elements:[];if(C.length===0)break;for(const j of C){const K=j?.jobCardUnion?.jobPostingCard;if(!K)continue;const y=[K.jobPostingUrn,K.jobPosting?.entityUrn,K.entityUrn].filter(Boolean).map((J)=>String(J).match(/(\d+)/)?.[1]).find(Boolean)??"",M=(K.footerItems||[]).find((J)=>J?.type==="LISTED_DATE"&&J?.timeAt),h=M?.timeAt?new Date(M.timeAt).toISOString().slice(0,10):"";$.push({title:K.jobPostingTitle||K.title?.text||"",company:K.primaryDescription?.text||"",location:K.secondaryDescription?.text||"",listed:h,salary:K.tertiaryDescription?.text||"",url:y?"https://www.linkedin.com/jobs/view/"+y:""})}if(C.length<B)break;H+=C.length}return $.slice(0,Z.limit).map((B,Y)=>({rank:Z.start+Y+1,...B}))}async function f(G,Z){const z=[];for(let $=0;$<Z.length;$++){const H=Z[$];console.error(`[opencli:linkedin] Fetching details ${$+1}/${Z.length}: ${H.title}`);if(!H.url){const Q="no url";console.error(`[opencli:linkedin] Skipping detail for "${H.title}": ${Q}`);z.push({...H,description:null,apply_url:null,detail_error:Q});continue}try{await G.goto(H.url);await x(G,"LinkedIn job detail");await G.wait({text:"About the job",timeout:8});await G.evaluate(`(() => {
+        const norm = (v) => (v || '').replace(/\\s+/g, ' ').trim().toLowerCase();
+        const section = [...document.querySelectorAll('div, section, article')]
+          .find(el => norm(el.querySelector('h1,h2,h3,h4')?.textContent || '') === 'about the job');
+        const btn = [...(section?.querySelectorAll('button, a[role="button"]') || [])]
+          .find(el => /more/.test(norm(el.textContent || '')) || /more/.test(norm(el.getAttribute('aria-label') || '')));
+        if (btn) btn.click();
+      })()`);await G.wait(1);const Q=await G.evaluate(`(() => {
+        const norm = (v) => (v || '').replace(/\\s+/g, ' ').trim();
+        // Find the most specific (shortest) container with "About the job" heading
+        // Shortest = most specific DOM node, avoiding outer wrappers that include unrelated text
+        const candidates = [...document.querySelectorAll('div, section, article')]
+          .map(el => ({
+            heading: norm(el.querySelector('h1,h2,h3,h4')?.textContent || ''),
+            text: norm(el.innerText || ''),
+          }))
+          .filter(c => c.text && c.heading.toLowerCase() === 'about the job' && c.text.length > 'About the job'.length)
+          .sort((a, b) => a.text.length - b.text.length);
+
+        const description = candidates[0]?.text.replace(/^About the job\\s*/i, '') || '';
+        const applyLink = [...document.querySelectorAll('a[href]')]
+          .map(a => ({ href: a.href || '', text: norm(a.textContent || ''), aria: norm(a.getAttribute('aria-label') || '') }))
+          .find(a => /apply/i.test(a.text) || /apply/i.test(a.aria));
+
+        return { description, applyUrl: applyLink?.href || '' };
+      })()`),U=b(Q?.description),W=T(String(Q?.applyUrl??"")),B=U?null:"missing description";z.push({...H,description:U||null,apply_url:W||null,detail_error:B})}catch(Q){if(Q instanceof V)throw Q;const U=`fetch failed: ${Q?.message||Q}`;console.error(`[opencli:linkedin] Detail fetch failed for ${H.url}: ${U}`);z.push({...H,description:null,apply_url:null,detail_error:U})}}return z}w({site:"linkedin",name:"search",access:"read",description:"Search LinkedIn jobs",domain:"www.linkedin.com",strategy:A.COOKIE,browser:!0,args:[{name:"query",type:"string",required:!0,positional:!0,help:"Job search keywords"},{name:"location",type:"string",required:!1,help:"Location text such as San Francisco Bay Area"},{name:"limit",type:"int",default:10,help:"Number of jobs to return (max 100)"},{name:"start",type:"int",default:0,help:"Result offset for pagination"},{name:"details",type:"bool",default:!1,help:"Include full job description and apply URL (slower)"},{name:"company",type:"string",required:!1,help:"Comma-separated company names or LinkedIn company IDs"},{name:"experience-level",type:"string",required:!1,help:"Comma-separated: internship, entry, associate, mid-senior, director, executive"},{name:"job-type",type:"string",required:!1,help:"Comma-separated: full-time, part-time, contract, temporary, volunteer, internship, other"},{name:"date-posted",type:"string",required:!1,help:"One of: any, month, week, 24h"},{name:"remote",type:"string",required:!1,help:"Comma-separated: on-site, hybrid, remote"}],columns:["rank","title","company","location","listed","salary","url"],func:async(G,Z)=>{const z=R(Z.limit,"--limit",10,v,k),$=R(Z.start,"--start",0,E),H=Boolean(Z.details),Q=(Z.location??"").trim(),U=String(Z.query??"").trim();if(!U)throw new q("query is required");await G.goto("https://www.linkedin.com/jobs/");await G.wait(2);const W=d(Z.company),B={keywords:U,location:Q,limit:z,start:$,companyIds:W,experienceLevels:F(Z["experience-level"],S,"experience_level"),jobTypes:F(Z["job-type"],N,"job_type"),datePostedValues:F(Z["date-posted"],D,"date_posted"),remoteTypes:F(Z.remote,L,"remote")},Y=await o(G,B);if(!H)return Y;return f(G,Y)}});export const __test__={parseCsvArg:P,parseIntegerArg:R,mapFilterValues:F,decodeLinkedinRedirect:T,looksLinkedInAuthWallText:_,assertLinkedInAuthenticated:x,enrichJobDetails:f,EXPERIENCE_LEVELS:S,JOB_TYPES:N,DATE_POSTED:D,REMOTE_TYPES:L};

package/clis/linkedin/sent-invitations.js

@@ -0,0 +1,46 @@
+import{cli as l,Strategy as c}from"@jackwener/opencli/registry";import{AuthRequiredError as d,CommandExecutionError as i}from"@jackwener/opencli/errors";const r="www.linkedin.com",u="https://www.linkedin.com/mynetwork/invitation-manager/sent/";function a(e){if(e&&typeof e==="object"&&"data"in e&&"session"in e)return e.data;return e}function o(){return String.raw`(() => {
+    const clean = (s) => String(s || '').replace(/[  ]/g, ' ').replace(/\s+/g, ' ').trim();
+    const text = document.body ? (document.body.innerText || '') : '';
+    const href = location.href;
+    const authRequired = /\b(sign in|log in|join linkedin)\b/i.test(text)
+      || /linkedin\.com\/(login|checkpoint|authwall|uas)/i.test(href);
+    const warning = /captcha|verification required|unusual activity|account restricted|temporarily restricted|security check|checkpoint/i.test(text);
+    const cleanName = (value) => {
+      const first = String(value || '').split(/\n+/).map(clean).filter(Boolean)[0] || '';
+      return clean(first
+        .replace(/^(view\s+)?profile\s+of\s+/i, '')
+        .replace(/\s*(?:View profile|LinkedIn|Pending|Sent|Withdraw).*$/i, ''));
+    };
+    const cards = Array.from(document.querySelectorAll('li, div, section, article')).filter((el) => {
+      if (!el || el.offsetParent === null) return false;
+      const t = clean(el.innerText || el.textContent || '');
+      return t && /withdraw/i.test(t) && t.length < 1200;
+    });
+    const byName = new Map();
+    for (const card of cards) {
+      const raw = card.innerText || card.textContent || '';
+      if (!/withdraw/i.test(raw)) continue;
+      const lines = raw.split(/\n+/).map(clean).filter(Boolean);
+      const link = card.querySelector('a[href*="/in/"]');
+      const linkName = cleanName(link ? (link.innerText || link.textContent || link.getAttribute('aria-label') || '') : '');
+      const name = linkName
+        || cleanName(lines.find((line) => !/^(pending|sent|withdraw|message|view profile|invitation|invited|ago|manage|received)\b/i.test(line)) || '');
+      if (!name) continue;
+      // Skip page-header rows that bleed through the overly-broad cards selector
+      // (e.g. 'People (81)' counter on the invitation manager page).
+      if (/^people\s*\(\d+\)$/i.test(name) || /^\d+\s+invitations?$/i.test(name)) continue;
+      const hrefAttr = link ? (link.getAttribute('href') || '') : '';
+      const profile_url = hrefAttr ? new URL(hrefAttr, location.origin).toString().replace(/[?#].*$/, '') : '';
+      const invited_date_text = clean((raw.match(/(?:Sent|Invited)\s+(?:\d+\s+\w+\s+ago|yesterday|today)/i) || [''])[0]);
+      const key = name.toLowerCase();
+      const existing = byName.get(key);
+      if (!existing) {
+        byName.set(key, { name, profile_url, invited_date_text });
+      } else {
+        if (!existing.profile_url && profile_url) existing.profile_url = profile_url;
+        if (!existing.invited_date_text && invited_date_text) existing.invited_date_text = invited_date_text;
+      }
+    }
+    const rows = Array.from(byName.values());
+    return { url: href, title: document.title || '', authRequired, warning, count: rows.length, rows, bodyText: text.slice(0, 1000) };
+  })()`}l({site:"linkedin",name:"sent-invitations",access:"read",description:"List pending LinkedIn sent invitations for CRM reconciliation",domain:r,strategy:c.UI,browser:!0,args:[],columns:["rank","name","profile_url","invited_date_text"],func:async(e)=>{if(!e)throw new i("Browser session required for linkedin sent-invitations");await e.goto(u);await e.wait(12);let t=a(await e.evaluate(o()));if(t?.authRequired)throw new d(r,"LinkedIn sent invitations requires an active signed-in browser session.");if(t?.warning)throw new i("LinkedIn warning/restriction state visible on sent invitations page.");return(Array.isArray(t?.rows)?t.rows:[]).map((n,s)=>({rank:s+1,name:n.name||"",profile_url:n.profile_url||"",invited_date_text:n.invited_date_text||""}))}});export const __test__={buildSentInvitationsScript:o,unwrapEvaluateResult:a};

package/clis/linkedin/services-read.js

@@ -0,0 +1,57 @@
+import{cli as S,Strategy as _}from"@jackwener/opencli/registry";import{CommandExecutionError as o,EmptyResultError as A}from"@jackwener/opencli/errors";import{assertLinkedInAuthenticated as u,assertSafeLinkedinUrl as g,normalizeWhitespace as r,unwrapEvaluateResult as v}from"./shared.js";function h(e){const t=g(e||"https://www.linkedin.com/in/me/","profile-url","/in/me/"),i=new URL(t);if(!/^\/in\/[^/?#]+\/?$/.test(i.pathname))throw new o("LinkedIn services-read requires a /in/<handle>/ profile URL");return i.toString()}function m(e){const t=g(e,"services-url","/services/page/"),i=new URL(t);if(!/^\/services\/page\/[^/?#]+\/?$/.test(i.pathname))throw new o("LinkedIn services-read requires a /services/page/<id>/ URL");return i.toString()}function x(){return String.raw`(() => {
+    const link = Array.from(document.querySelectorAll('a[href*="/services/page/"]'))
+      .map((a) => a.href || '')
+      .find(Boolean);
+    return { services_url: link || '' };
+  })()`}function L(){return String.raw`(() => {
+    const clean = (s) => String(s || '').replace(/[\u00a0\u202f]+/g, ' ').replace(/\s+/g, ' ').trim();
+    const lines = (document.body?.innerText || '').split(/\n+/).map(clean).filter(Boolean);
+    const unique = (items) => Array.from(new Set(items.filter(Boolean)));
+    const collectAfter = (label, stops) => {
+      const index = lines.findIndex((line) => line === label);
+      if (index < 0) return [];
+      const out = [];
+      for (let i = index + 1; i < lines.length; i++) {
+        if (stops.includes(lines[i])) break;
+        if (lines[i] !== label) out.push(lines[i]);
+      }
+      return unique(out);
+    };
+    return {
+      service_url: location.href,
+      page_title: clean(document.querySelector('main h1, h1')?.innerText || document.title || ''),
+      overview: collectAfter('Overview', ['Availability', 'Pricing', 'Services provided', 'Media', 'Reviews']).join('\n'),
+      availability: collectAfter('Availability', ['Pricing', 'Services provided', 'Media', 'Reviews']).join('; '),
+      pricing: collectAfter('Pricing', ['Services provided', 'Media', 'Reviews']).join('; '),
+      services_provided: collectAfter('Services provided', ['Media', 'Reviews', 'Pricing', 'Availability', 'Overview']),
+    };
+  })()`}function I(){return String.raw`(() => {
+    const clean = (s) => String(s || '').replace(/[\u00a0\u202f]+/g, ' ').replace(/\s+/g, ' ').trim();
+    const lines = (document.body?.innerText || '').split(/\n+/).map(clean).filter(Boolean);
+    const start = lines.findIndex((line) => line === 'Add media');
+    const end = lines.findIndex((line, index) => index > start && line === 'Done');
+    const media_lines = start >= 0 && end > start ? lines.slice(start + 1, end) : [];
+    return { media_lines };
+  })()`}function R(){return String.raw`(() => {
+    const clean = (s) => String(s || '').replace(/[\u00a0\u202f]+/g, ' ').replace(/\s+/g, ' ').trim();
+    const dialog = document.querySelector('dialog') || document;
+    const overview = dialog.querySelector('textarea')?.value || '';
+    const checked = Array.from(dialog.querySelectorAll('[role="checkbox"], [role="switch"], input[type="checkbox"]'))
+      .map((el) => ({
+        label: clean(el.getAttribute('aria-label') || el.innerText || el.closest('div')?.innerText || el.parentElement?.innerText || ''),
+        checked: el.getAttribute('aria-checked') === 'true' || el.checked === true,
+      }));
+    const radios = Array.from(dialog.querySelectorAll('[role="radio"], input[type="radio"]'))
+      .map((el) => ({
+        label: clean(el.getAttribute('aria-label') || el.innerText || el.closest('div')?.innerText || el.parentElement?.innerText || ''),
+        checked: el.getAttribute('aria-checked') === 'true' || el.checked === true,
+      }));
+    return {
+      overview,
+      work_locations: checked.filter((item) => item.checked && !/message|linkedin members|reviews?/i.test(item.label)).map((item) => item.label),
+      messages: checked.find((item) => /message|open profile/i.test(item.label))?.checked ? 'on' : 'off',
+      reviews_visibility: checked.find((item) => /all linkedin members/i.test(item.label))?.checked ? 'on' : 'off',
+      pricing: radios.find((item) => item.checked)?.label || '',
+    };
+  })()`}function k(e){const t=Array.isArray(e)?e.map(r).filter(Boolean):[],i=[];for(let n=0;n<t.length;n+=2){const s=t[n]||"",a=t[n+1]||"";if(s)i.push(a?`${s} — ${a}`:s)}return i}function b(e){if(!e||typeof e!=="object")throw new o("LinkedIn services-read returned malformed extraction payload");const t=Array.isArray(e.services_provided)?e.services_provided.map(r).filter(Boolean):[],i=k(e.media_lines),n=[],s=r(e.service_url),a=r(e.page_title),c=r(e.overview),l=r(e.availability);if(!s||!a&&!c&&t.length===0)throw new o("LinkedIn services-read could not find stable Services page content");return{service_url:s,page_title:a,overview:c,availability:l,work_locations:Array.isArray(e.work_locations)?e.work_locations.map((y)=>{const p=r(y),d=p.split(" ");if(d.length%2===0){const f=d.length/2,w=d.slice(0,f).join(" ");if(w===d.slice(f).join(" "))return w}return p}).filter(Boolean).join("; "):"",pricing:r(e.pricing).replace(/^Pricing,\s*Select one option,\s*/i,"").replace(/,\s*required$/i,""),services_provided:t.join("; "),services_count:String(t.length),media:(i.length>0?i:n).join(`
+`),media_count:String(i.length||n.length),messages:r(e.messages),reviews_visibility:r(e.reviews_visibility)}}async function U(e,t){const i=new URL(t);i.pathname=i.pathname.replace(/\/?$/,"/edit/");await e.goto(i.toString());await e.wait(4);await u(e,"LinkedIn services-read edit");return v(await e.evaluate(R()))}S({site:"linkedin",name:"services-read",access:"read",description:"Read LinkedIn Services page details including services, overview, availability, pricing, and media titles/descriptions",domain:"www.linkedin.com",strategy:_.COOKIE,browser:!0,args:[{name:"profile-url",type:"string",required:!1,help:"LinkedIn /in/<handle>/ profile URL. Defaults to /in/me/."},{name:"services-url",type:"string",required:!1,help:"LinkedIn /services/page/<id>/ URL. If omitted, it is discovered from the profile."}],columns:["service_url","page_title","overview","availability","work_locations","pricing","services_provided","services_count","media","media_count","messages","reviews_visibility"],func:async(e,t)=>{if(!e)throw new o("Browser session required for linkedin services-read");let i=r(t["services-url"]);const n=!i&&!r(t["profile-url"]);if(i)i=m(i);else{await e.goto(h(t["profile-url"]));await e.wait(5);await u(e,"LinkedIn services-read profile");const l=v(await e.evaluate(x()));i=r(l?.services_url);if(!i)throw new A("linkedin services-read","No LinkedIn Services page link was found on the profile.");i=m(i)}await e.goto(i);await e.wait(5);await u(e,"LinkedIn services-read");const s=v(await e.evaluate(L())),a=n?await U(e,i):{};let c={};if(n){const l=new URL(i);l.pathname=l.pathname.replace(/\/?$/,"/media/");await e.goto(l.toString());await e.wait(4);await u(e,"LinkedIn services-read media");c=v(await e.evaluate(I()))}return[b({...s,...a,...c})]}});export const __test__={normalizeProfileUrl:h,normalizeServicesUrl:m,pairsToMedia:k,normalizeServices:b};

package/clis/linkedin/shared.js

@@ -0,0 +1,10 @@
+import{ArgumentError as o,AuthRequiredError as c,CommandExecutionError as u}from"@jackwener/opencli/errors";export const LINKEDIN_DOMAIN="www.linkedin.com";export function unwrapEvaluateResult(t){if(t&&typeof t==="object"&&"data"in t&&"session"in t)return t.data;return t}export function normalizeWhitespace(t){return String(t??"").replace(/[\u00a0\u202f]+/g," ").replace(/\s+/g," ").trim()}export function normalizeHttpUrl(t,e){const r=normalizeWhitespace(t);if(!r)return"";try{const n=e?new URL(r,e):new URL(r);if(n.protocol!=="http:"&&n.protocol!=="https:")return"";if(n.username||n.password)return"";return n.toString()}catch{return""}}export function compactRepeatedText(t){const e=normalizeWhitespace(t);if(!e)return"";if(e.length%2===0){const n=e.length/2,i=e.slice(0,n);if(i===e.slice(n))return i}const r=e.split(" ");if(r.length%2===0){const n=r.length/2,i=r.slice(0,n).join(" ");if(i===r.slice(n).join(" "))return i}return e}export function looksLinkedInAuthWall(t){const e=normalizeWhitespace(t).toLowerCase();if(!e)return!1;return/linkedin\.com\/(?:login|checkpoint|authwall|uas)/i.test(e)||/\b(sign in|log in|join linkedin|captcha|verification required)\b/i.test(e)||/(请登录|登录领英|安全验证)/.test(e)}export function assertSafeLinkedinUrl(t,e,r="/"){const n=normalizeWhitespace(t||`https://www.linkedin.com${r}`);let i;try{i=new URL(n,"https://www.linkedin.com")}catch{throw new o(`${e} must be a LinkedIn URL`)}const s=i.hostname.toLowerCase();if(i.protocol!=="https:"||i.username||i.password||i.port)throw new o(`${e} must be an https LinkedIn URL without credentials or port`);if(s!=="linkedin.com"&&s!=="www.linkedin.com")throw new o(`${e} must point to linkedin.com`);return i.toString()}export function requireStringArg(t,e,r=e){const n=normalizeWhitespace(t?.[e]);if(!n)throw new o(`${r} is required`);return n}export function parseLimit(t,e,r){if(t===void 0||t===null||t==="")return e;const n=Number(t);if(!Number.isInteger(n)||n<1||n>r)throw new o(`--limit must be an integer between 1 and ${r}`);return n}export async function requireLinkedInCookie(t,e){let r;try{r=await t.getCookies({url:"https://www.linkedin.com"})}catch(i){throw new u(`LinkedIn cookie lookup failed: ${i?.message||i}`)}if(!Array.isArray(r))throw new u("LinkedIn cookie lookup returned malformed payload");const n=r.find((i)=>i.name==="JSESSIONID")?.value;if(!n)throw new c(LINKEDIN_DOMAIN,`${e} requires an active signed-in LinkedIn browser session.`);return n.replace(/^"|"$/g,"")}export function buildAuthProbeScript(){return String.raw`(() => {
+    const text = [
+      window.location.href || '',
+      document.title || '',
+      document.body ? (document.body.innerText || '').slice(0, 4000) : '',
+    ].join('\n');
+    return /linkedin\.com\/(?:login|checkpoint|authwall|uas)/i.test(text)
+      || /\b(sign in|log in|join linkedin|captcha|verification required)\b/i.test(text)
+      || /(请登录|登录领英|安全验证)/.test(text);
+  })()`}export async function assertLinkedInAuthenticated(t,e){if(unwrapEvaluateResult(await t.evaluate(buildAuthProbeScript())))throw new c(LINKEDIN_DOMAIN,`${e} requires an active signed-in LinkedIn browser session.`)}export function splitVisibleLines(t){return String(t||"").split(/\n+/).map(normalizeWhitespace).filter(Boolean)}

package/clis/linkedin/social-api.js

@@ -0,0 +1,260 @@
+import{ArgumentError as F}from"@jackwener/opencli/errors";export const NORM_COMMENT_DECORATION="com.linkedin.voyager.dash.deco.social.NormComment-43",REACTION_CREATE_QID="voyagerSocialDashReactions.b731222600772fd42464c0fe19bd722b",REACTION_DELETE_QID="voyagerSocialDashReactions.f68b48ae5bc0085d7a45c7003b772a39",REPOST_CREATE_QID="voyagerFeedDashReposts.a0663ae5c654123343da36617d2dbfde";export function looksLikeCommentUrn(q){const b=String(q??"");return/urn:li:(fsd_)?comment:\(/.test(b)}export const REACTION_TYPES=["LIKE","CELEBRATE","SUPPORT","LOVE","INSIGHTFUL","FUNNY"];const H={like:"LIKE",celebrate:"PRAISE",praise:"PRAISE",support:"EMPATHY",empathy:"EMPATHY",love:"APPRECIATION",appreciation:"APPRECIATION",insightful:"INTEREST",interest:"INTEREST",funny:"ENTERTAINMENT",entertainment:"ENTERTAINMENT",haha:"ENTERTAINMENT"};export function parseReactionType(q){const b=String(q??"like").trim().toLowerCase(),z=H[b];if(!z)throw new F(`--reaction 只能是 like / celebrate / support / love / insightful / funny（收到 "${q}"）`);return z}export function normalizeThreadUrn(q){const b=String(q??"").trim();if(!b)throw new F("post 标识必填（帖子 URL 或 urn:li:activity:… / urn:li:ugcPost:…）");const z=b.match(/urn:li:(activity|ugcPost|share):(\d+)/);if(z)return`urn:li:${z[1]}:${z[2]}`;const D=b.match(/activity[:\-](\d{6,})/i);if(D)return`urn:li:activity:${D[1]}`;const G=b.match(/ugcPost[:\-](\d{6,})/i);if(G)return`urn:li:ugcPost:${G[1]}`;throw new F(`无法从 "${b}" 解析出帖子 urn（需 activity/ugcPost urn 或含 activity-<id> 的 LinkedIn 链接）`)}export function normalizeCommentUrn(q){const b=String(q??"").trim();if(!b)throw new F("comment 标识必填（urn:li:comment:(…) 或 urn:li:fsd_comment:(…)）");const z=b.match(/urn:li:comment:\((activity|ugcPost):(\d+),(\d+)\)/);if(z)return`urn:li:comment:(${z[1]}:${z[2]},${z[3]})`;const D=b.match(/urn:li:fsd_comment:\((\d+),urn:li:(activity|ugcPost):(\d+)\)/);if(D)return`urn:li:comment:(${D[2]}:${D[3]},${D[1]})`;throw new F(`无法解析评论 urn "${b}"（需 urn:li:comment:(…) 或 urn:li:fsd_comment:(…)；可从 linkedin post-comments 的 comment_urn 列直接取）`)}export const SOCIAL_PREAMBLE=String.raw`
+  const jsessionRaw = (document.cookie.split('; ').find((c) => c.startsWith('JSESSIONID=')) || '').split('=')[1] || '';
+  const csrf = jsessionRaw.replace(/^"|"$/g, '');
+  if (!csrf) return { ok: false, stage: 'auth', error: 'JSESSIONID_missing' };
+  const H = {
+    'csrf-token': csrf,
+    'accept': 'application/vnd.linkedin.normalized+json+2.1',
+    'x-restli-protocol-version': '2.0.0',
+    'x-li-lang': 'en_US',
+    'content-type': 'application/json; charset=UTF-8',
+  };
+`;export function buildReactScript({threadUrn:q,reactionType:b,remove:z}){return`(async () => {
+    ${SOCIAL_PREAMBLE}
+    const THREAD = ${JSON.stringify(q)};
+    const REMOVE = ${JSON.stringify(Boolean(z))};
+    const REACTION = ${JSON.stringify(b)};
+    if (REMOVE) {
+      const res = await fetch('/voyager/api/voyagerSocialDashReactions?action=deleteReaction', {
+        method: 'POST', credentials: 'include', headers: H,
+        body: JSON.stringify({ threadUrn: THREAD }),
+      });
+      if (res.status === 204 || res.status === 200) return { ok: true, removed: true, httpStatus: res.status };
+      return { ok: false, stage: 'unreact', httpStatus: res.status, error: (await res.text()).slice(0, 300) };
+    }
+    const res = await fetch('/voyager/api/voyagerSocialDashReactions?threadUrn=' + encodeURIComponent(THREAD), {
+      method: 'POST', credentials: 'include', headers: H,
+      body: JSON.stringify({ reactionType: REACTION }),
+    });
+    if (res.status === 201 || res.status === 200) return { ok: true, removed: false, reaction: REACTION, httpStatus: res.status };
+    return { ok: false, stage: 'react', httpStatus: res.status, error: (await res.text()).slice(0, 300) };
+  })()`}export function buildCommentScript({threadUrn:q,text:b,decorationId:z}){return`(async () => {
+    ${SOCIAL_PREAMBLE}
+    const THREAD = ${JSON.stringify(q)};
+    const TEXT = ${JSON.stringify(b)};
+    const payload = {
+      commentary: { text: TEXT, attributesV2: [], $type: 'com.linkedin.voyager.dash.common.text.TextViewModel' },
+      threadUrn: THREAD,
+    };
+    const res = await fetch('/voyager/api/voyagerSocialDashNormComments?decorationId=' + ${JSON.stringify(z)}, {
+      method: 'POST', credentials: 'include', headers: H,
+      body: JSON.stringify(payload),
+    });
+    const body = await res.text();
+    if (res.status !== 201 && res.status !== 200) {
+      return { ok: false, stage: 'comment', httpStatus: res.status, error: body.slice(0, 400) };
+    }
+    // 从响应里捞新评论 urn（fsd_comment(commentId, urn:li:activity:postId) → 归一成 comment:(activity:postId,commentId)）
+    let commentUrn = '';
+    const m = body.match(/urn:li:fsd_comment:\\((\\d+),urn:li:(activity|ugcPost):(\\d+)\\)/);
+    if (m) commentUrn = 'urn:li:comment:(' + m[2] + ':' + m[3] + ',' + m[1] + ')';
+    return { ok: true, commentUrn, httpStatus: res.status };
+  })()`}export function buildPostDetailScript({activityUrn:q}){return`(async () => {
+    ${SOCIAL_PREAMBLE}
+    const ACTIVITY = ${JSON.stringify(q)};
+    const res = await fetch('/voyager/api/feed/updates/' + encodeURIComponent(ACTIVITY) + '?commentsCount=0&likesCount=0', { credentials: 'include', headers: H });
+    if (!res.ok) return { ok: false, stage: 'read', httpStatus: res.status, error: (await res.text()).slice(0, 300) };
+    const j = await res.json();
+    const inc = j.included || [];
+    const uv2 = inc.find((e) => /feed\\.render\\.UpdateV2$/.test(e.$type || '')) || {};
+    const actor = uv2.actor || {};
+    const commentary = uv2.commentary || {};
+    const sac = inc.find((e) => /SocialActivityCounts$/.test(e.$type || '')) || {};
+    const content = uv2.content || {};
+    const actorName = (actor.name && (actor.name.text || actor.name)) || '';
+    const actorUrl = (actor.navigationContext && actor.navigationContext.actionTarget) || '';
+    const actorType = /company/i.test(actor.urn || '') ? 'company' : (/member|fsd_profile|miniProfile/i.test(actor.urn || actor['*miniProfile'] || '') ? 'person' : '');
+    const text = (commentary.text && (commentary.text.text
+      || (Array.isArray(commentary.text.values) ? commentary.text.values.map((v) => v.value || '').join('') : ''))) || '';
+    const perm = (inc.find((e) => e.permalink) || {}).permalink || '';
+    return {
+      ok: true,
+      post: {
+        post_urn: ACTIVITY,
+        author: actorName,
+        author_type: actorType,
+        author_url: actorUrl,
+        posted: (actor.subDescription && (actor.subDescription.text || actor.subDescription)) || '',
+        text,
+        content_type: (content.$type || '').split('.').pop(),
+        is_repost: Boolean(uv2.resharedUpdate) ? 'yes' : '',
+        reactions: sac.numLikes || 0,
+        comments: sac.numComments || 0,
+        reposts: sac.numShares || 0,
+        impressions: sac.numImpressions || 0,
+        url: perm,
+      },
+    };
+  })()`}export function buildReadCommentsScript({activityUrn:q,count:b,start:z,sortOrder:D}){return`(async () => {
+    ${SOCIAL_PREAMBLE}
+    const ACTIVITY = ${JSON.stringify(q)};
+    const url = '/voyager/api/feed/comments?count=' + ${JSON.stringify(b)} + '&start=' + ${JSON.stringify(z)}
+      + '&q=comments&sortOrder=' + ${JSON.stringify(D)} + '&updateId=' + encodeURIComponent(ACTIVITY);
+    const res = await fetch(url, { credentials: 'include', headers: H });
+    if (!res.ok) return { ok: false, stage: 'read', httpStatus: res.status, error: (await res.text()).slice(0, 300) };
+    const j = await res.json();
+    const inc = j.included || [];
+    const comments = inc.filter((e) => /\\.feed\\.Comment$/.test(e.$type || ''));
+    // MiniProfile 名字表：entityUrn → 全名
+    const minis = {};
+    for (const e of inc) {
+      if (/MiniProfile$/.test(e.$type || '')) {
+        minis[e.entityUrn] = ((e.firstName || '') + ' ' + (e.lastName || '')).trim();
+      }
+    }
+    // 评论级点赞数：SocialActivityCounts 按 urn 里的 commentId 匹配
+    const countsByComment = {};
+    for (const e of inc) {
+      if (/SocialActivityCounts$/.test(e.$type || '') && /comment/i.test(e.urn || e.entityUrn || '')) {
+        countsByComment[e.urn || e.entityUrn] = e.numLikes || 0;
+      }
+    }
+    const rows = comments.map((c) => {
+      const commenterRef = c['*commenter'] || (c.commenter && c.commenter['*miniProfile']) || '';
+      const author = minis[commenterRef] || (c.commenter && c.commenter.urn) || '';
+      const text = c.comment && Array.isArray(c.comment.values)
+        ? c.comment.values.map((v) => v.value || '').join('')
+        : (c.comment && c.comment.text) || '';
+      const isReply = /replyUrn|dashReplyUrn/.test(c.permalink || '');
+      const sdRef = c['*socialDetail'] || '';
+      let reactions = 0;
+      for (const k in countsByComment) { if (sdRef && k && sdRef.indexOf(k.split(':').pop()) >= 0) { reactions = countsByComment[k]; break; } }
+      return {
+        comment_urn: c.urn || '',
+        author,
+        headline: (c.headline && (c.headline.text || c.headline)) || '',
+        text,
+        created_at: c.createdTime || 0,
+        is_reply: isReply,
+        parent_comment_urn: c.parentCommentUrn || '',
+        reactions,
+        permalink: c.permalink || '',
+      };
+    });
+    const total = (j.data && j.data.paging && j.data.paging.total) || rows.length;
+    return { ok: true, rows, total };
+  })()`}export function buildCommentReactScript({commentUrn:q,reactionType:b,remove:z,createQid:D,deleteQid:G}){return`(async () => {
+    ${SOCIAL_PREAMBLE}
+    const GH = Object.assign({}, H, { 'x-li-graphql-pegasus-client': 'true' });
+    const COMMENT = ${JSON.stringify(q)};
+    const REMOVE = ${JSON.stringify(Boolean(z))};
+    const REACTION = ${JSON.stringify(b)};
+    if (REMOVE) {
+      const qid = ${JSON.stringify(G)};
+      const res = await fetch('/voyager/api/graphql?action=execute&queryId=' + qid, {
+        method: 'POST', credentials: 'include', headers: GH,
+        body: JSON.stringify({ variables: { threadUrn: COMMENT }, queryId: qid, includeWebMetadata: true }),
+      });
+      if (res.status === 200 || res.status === 201) return { ok: true, removed: true };
+      return { ok: false, stage: 'unreact_comment', httpStatus: res.status, error: (await res.text()).slice(0, 300) };
+    }
+    const qid = ${JSON.stringify(D)};
+    const res = await fetch('/voyager/api/graphql?action=execute&queryId=' + qid, {
+      method: 'POST', credentials: 'include', headers: GH,
+      body: JSON.stringify({ variables: { entity: { reactionType: REACTION }, threadUrn: COMMENT }, queryId: qid, includeWebMetadata: true }),
+    });
+    if (res.status === 200 || res.status === 201) return { ok: true, removed: false, reaction: REACTION };
+    return { ok: false, stage: 'react_comment', httpStatus: res.status, error: (await res.text()).slice(0, 300) };
+  })()`}export function buildRepostScript({activityUrn:q,commentary:b,repostQid:z}){return`(async () => {
+    ${SOCIAL_PREAMBLE}
+    const ACTIVITY = ${JSON.stringify(q)};
+    const COMMENTARY = ${JSON.stringify(b||"")};
+    // 1. 解析 shareUrn
+    const u = await fetch('/voyager/api/feed/updates/' + encodeURIComponent(ACTIVITY) + '?commentsCount=0&likesCount=0', { credentials: 'include', headers: H });
+    if (!u.ok) return { ok: false, stage: 'resolve', httpStatus: u.status, error: (await u.text()).slice(0, 200) };
+    const j = await u.json();
+    const uv2 = (j.included || []).find((e) => /feed\\.render\\.UpdateV2$/.test(e.$type || '')) || {};
+    const shareUrn = (uv2.updateMetadata && uv2.updateMetadata.shareUrn) || '';
+    if (!shareUrn) return { ok: false, stage: 'resolve', error: 'shareUrn_not_found' };
+    // 2a. 带评语 → normShares + resharedUpdate
+    if (COMMENTARY) {
+      const payload = { visibleToConnectionsOnly: false, externalAudienceProviders: [], commentaryV2: { text: COMMENTARY, attributes: [] }, origin: 'FEED', allowedCommentersScope: 'ALL', postState: 'PUBLISHED', resharedUpdate: shareUrn };
+      const s = await fetch('/voyager/api/contentcreation/normShares', { method: 'POST', credentials: 'include', headers: H, body: JSON.stringify(payload) });
+      const st = await s.text();
+      if (s.status !== 200 && s.status !== 201) return { ok: false, stage: 'quote', httpStatus: s.status, error: st.slice(0, 300) };
+      const m = st.match(/urn:li:(share|ugcPost|activity):[0-9]+/g) || [];
+      const nu = [...new Set(m)].filter((x) => x !== shareUrn);
+      return { ok: true, quote: true, shared_urn: shareUrn, repost_urn: nu.find((x) => /activity/.test(x)) || nu[0] || '' };
+    }
+    // 2b. 纯转发 → GraphQL Reposts
+    const GH = Object.assign({}, H, { 'x-li-graphql-pegasus-client': 'true' });
+    const qid = ${JSON.stringify(z)};
+    const r = await fetch('/voyager/api/graphql?action=execute&queryId=' + qid, {
+      method: 'POST', credentials: 'include', headers: GH,
+      body: JSON.stringify({ variables: { entity: { rootContentUrn: shareUrn } }, queryId: qid, includeWebMetadata: true }),
+    });
+    const rt = await r.text();
+    if (r.status !== 200 && r.status !== 201) return { ok: false, stage: 'repost', httpStatus: r.status, error: rt.slice(0, 300) };
+    // 新转发 urn：优先响应里的 activity urn，回退到 createFeedDashReposts.resourceKey（instantRepost）。
+    const act = (rt.match(/urn:li:activity:[0-9]+/g) || [])[0] || '';
+    const rk = (rt.match(/urn:li:fsd_repost:[^"\\\\]+/) || [])[0] || '';
+    return { ok: true, quote: false, shared_urn: shareUrn, repost_urn: act || rk };
+  })()`}export function buildNotificationsScript({count:q,start:b,filter:z}){return`(async () => {
+    ${SOCIAL_PREAMBLE}
+    const url = '/voyager/api/voyagerIdentityDashNotificationCards?q=filterVanityName&filterVanityName=' + ${JSON.stringify(z)}
+      + '&count=' + ${JSON.stringify(q)} + '&start=' + ${JSON.stringify(b)};
+    const res = await fetch(url, { credentials: 'include', headers: H });
+    if (!res.ok) return { ok: false, stage: 'read', httpStatus: res.status, error: (await res.text()).slice(0, 300) };
+    const j = await res.json();
+    const inc = j.included || [];
+    const cards = inc.filter((e) => /notifications\\.Card$/.test(e.$type || ''));
+    const textOf = (f) => { if (!f) return ''; if (typeof f === 'string') return f; if (f.text) return f.text; if (f.attributedText && f.attributedText.text) return f.attributedText.text; return ''; };
+    const rows = cards.map((c) => {
+      const target = (c.cardAction && (c.cardAction.actionTarget
+        || (c.cardAction.navigationContext && c.cardAction.navigationContext.actionTarget))) || '';
+      return {
+        read: c.read === true,
+        headline: textOf(c.headline),
+        content: Array.isArray(c.contentPrimaryText) ? textOf(c.contentPrimaryText[0]) : textOf(c.contentPrimaryText),
+        when: c.publishedAt || 0,
+        target,
+      };
+    });
+    const meta = j.data && j.data.metadata;
+    return { ok: true, rows, numUnseen: (meta && meta.numUnseen) || 0, nextStart: (meta && meta.nextStart) || 0 };
+  })()`}export function buildFollowScript({target:q,following:b}){return`(async () => {
+    ${SOCIAL_PREAMBLE}
+    const TARGET = ${JSON.stringify(String(q||"").trim())};
+    const FOLLOWING = ${JSON.stringify(Boolean(b))};
+
+    async function resolveEntityUrn() {
+      // 1. 原生 urn 直接用
+      const rawProfile = TARGET.match(/urn:li:fsd?_?profile:([A-Za-z0-9_-]+)/) || TARGET.match(/urn:li:fs_miniProfile:([A-Za-z0-9_-]+)/);
+      if (rawProfile) return 'urn:li:fsd_profile:' + rawProfile[1];
+      const rawCompany = TARGET.match(/urn:li:fs?d?_?(?:normalized_)?company:(\\d+)/);
+      if (rawCompany) return 'urn:li:fsd_company:' + rawCompany[1];
+      // 2. /in/<handle> → 人（memberIdentity 解析 fsd_profile）
+      const inMatch = TARGET.match(/linkedin\\.com\\/in\\/([^/?#]+)/i);
+      if (inMatch) {
+        const handle = decodeURIComponent(inMatch[1]);
+        const r = await fetch('/voyager/api/identity/dash/profiles?q=memberIdentity&memberIdentity=' + encodeURIComponent(handle), { credentials: 'include', headers: H });
+        if (!r.ok) return '';
+        const j = await r.json();
+        const p = (j.included || []).find((e) => /dash\\.identity\\.profile\\.Profile$/.test(e.$type || '')) || {};
+        return p.entityUrn || ((j.data && j.data.elements && j.data.elements[0]) || '');
+      }
+      // 3. /company/<name> URL 或裸公司名 → 公司（universalName 解析 fsd_company）
+      //    裸字符串一律按公司名解析（人有歧义，必须给 /in/ URL），避免误把公司名当成 member handle。
+      const companyMatch = TARGET.match(/linkedin\\.com\\/company\\/([^/?#]+)/i);
+      const name = companyMatch ? decodeURIComponent(companyMatch[1]) : (/^[^/\\s]+$/.test(TARGET) ? TARGET : '');
+      if (name) {
+        const r = await fetch('/voyager/api/organization/companies?q=universalName&universalName=' + encodeURIComponent(name), { credentials: 'include', headers: H });
+        if (!r.ok) return '';
+        const j = await r.json();
+        const c = (j.included || []).find((e) => /organization\\.Company$/.test(e.$type || '')) || {};
+        const m = (c.entityUrn || '').match(/company:(\\d+)/);
+        return m ? 'urn:li:fsd_company:' + m[1] : '';
+      }
+      return '';
+    }
+
+    const entityUrn = await resolveEntityUrn();
+    if (!entityUrn) return { ok: false, stage: 'resolve', error: 'could_not_resolve_target' };
+    const fsUrn = 'urn:li:fsd_followingState:' + entityUrn;
+    const res = await fetch('/voyager/api/feed/dash/followingStates/' + encodeURIComponent(fsUrn), {
+      method: 'POST', credentials: 'include', headers: H,
+      body: JSON.stringify({ patch: { $set: { following: FOLLOWING } } }),
+    });
+    if (res.status === 200 || res.status === 201) return { ok: true, entity_urn: entityUrn, following: FOLLOWING };
+    return { ok: false, stage: 'follow', httpStatus: res.status, error: (await res.text()).slice(0, 300) };
+  })()`}

package/clis/linkedin/thread-snapshot.js

@@ -0,0 +1,81 @@
+import{cli as w,Strategy as x}from"@jackwener/opencli/registry";import{ArgumentError as l,AuthRequiredError as b,CommandExecutionError as c}from"@jackwener/opencli/errors";const m="www.linkedin.com";function a(e){return String(e??"").replace(/[\u00a0\u202f]/g," ").replace(/\s+/g," ").trim()}function u(e){if(e&&typeof e==="object"&&"data"in e&&"session"in e)return e.data;return e}function k(e){const s=String(e||"").toLowerCase();return s==="linkedin.com"||s.endsWith(".linkedin.com")}function d(e){const s=a(e);if(!s)return"";try{const t=new URL(s);if(t.protocol!=="https:"||t.username||t.password||t.port||!k(t.hostname))return"";const r=t.pathname.match(/^\/messaging\/thread\/([^/]+)\/?$/i);if(!r||!r[1])return"";t.hostname="www.linkedin.com";t.hash="";t.search="";if(!t.pathname.endsWith("/"))t.pathname+="/";return t.toString()}catch{return""}}function _(e,s,t=s){const r=a(e[s]);if(!r)throw new l(`${t} is required`);return r}function y(e,s){const t=d(e);if(!t)throw new l(`${s} must be an exact https://www.linkedin.com/messaging/thread/<id>/ URL`);return t}function h(e){if(e===void 0||e===null||e==="")return 30;const s=Number(e);if(!Number.isInteger(s)||s<0||s>80)throw new l("--max-scrolls must be an integer between 0 and 80");return s}function g(e){const s=e;return String.raw`(async () => {
+    const marker = '__OPENCLI_LINKEDIN_THREAD_SNAPSHOT__';
+    void marker;
+    const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+    const clean = (s) => String(s || '').replace(/[\u00a0\u202f]/g, ' ').replace(/\s+/g, ' ').trim();
+    const text = document.body ? (document.body.innerText || '') : '';
+    const authRequired = /\b(sign in|log in|join linkedin)\b/i.test(text)
+      || /linkedin\.com\/(login|checkpoint|authwall)/i.test(location.href)
+      || /captcha|verification required/i.test(text);
+
+    const selectors = [
+      '.msg-s-message-list',
+      '.msg-s-message-list-scrollable',
+      '.msg-thread',
+      'main [role="main"]',
+      'main'
+    ];
+    let scroller = null;
+    for (const selector of selectors) {
+      const el = document.querySelector(selector);
+      if (el && (el.scrollHeight > el.clientHeight || selector === 'main')) { scroller = el; break; }
+    }
+    scroller = scroller || document.scrollingElement || document.documentElement;
+    let previousHeight = -1;
+    let stable = 0;
+    for (let i = 0; i < ${s}; i += 1) {
+      scroller.scrollTop = 0;
+      window.scrollTo(0, 0);
+      await sleep(750);
+      const height = scroller.scrollHeight || document.body.scrollHeight || 0;
+      if (height === previousHeight) stable += 1; else stable = 0;
+      previousHeight = height;
+      if (stable >= 3) break;
+    }
+    await sleep(1000);
+
+    const headerCandidates = [];
+    const headerSelectors = [
+      '.msg-thread__link-to-profile',
+      '.msg-thread__link-to-profile span[aria-hidden="true"]',
+      '.msg-thread .msg-entity-lockup__entity-title'
+    ];
+    for (const selector of headerSelectors) {
+      for (const el of Array.from(document.querySelectorAll(selector)).slice(0, 8)) {
+        const value = clean(el.innerText || el.textContent || el.getAttribute('aria-label'));
+        if (value && value.length <= 120 && !/^(message|messaging|send|profile|view profile)$/i.test(value)) {
+          headerCandidates.push(value);
+        }
+      }
+    }
+
+    const seen = new Set();
+    const messages = [];
+    const nodes = Array.from(document.querySelectorAll('.msg-s-message-list__event, .msg-s-event-listitem, [data-event-urn], .msg-s-message-list-content'));
+    for (const [nodeIndex, el] of nodes.entries()) {
+      const raw = clean(el.innerText || el.textContent);
+      if (!raw || seen.has(raw)) continue;
+      seen.add(raw);
+      const lines = raw.split(/\n+/).map(clean).filter(Boolean);
+      const speaker = lines.length > 1 && lines[0].length <= 120 ? lines[0] : '';
+      messages.push({ index: messages.length, nodeIndex, speaker, text: raw });
+    }
+
+    const refreshedText = document.body ? (document.body.innerText || '') : '';
+    const fallbackLines = refreshedText.split(/\n+/).map(clean).filter(Boolean);
+    const latestMessageText = messages.length
+      ? messages[messages.length - 1].text
+      : ([...fallbackLines].reverse().find((line) => !/^(send|reply|write a message|press enter to send)$/i.test(line)) || '');
+
+    return {
+      url: location.href,
+      title: document.title || '',
+      headerNames: Array.from(new Set(headerCandidates)).slice(0, 10),
+      latestMessageText,
+      messages,
+      messageCount: messages.length,
+      authRequired,
+      extractedAt: new Date().toISOString(),
+      maxScrolls: ${s}
+    };
+  })()`}w({site:"linkedin",name:"thread-snapshot",access:"read",description:"Load a LinkedIn messaging thread, scroll for available history, and return a full context snapshot",domain:m,strategy:x.UI,browser:!0,args:[{name:"thread-url",required:!0,help:"Exact LinkedIn messaging thread URL to open and snapshot"},{name:"max-scrolls",type:"number",default:30,help:"Maximum upward scroll attempts to load older messages"},{name:"json",type:"bool",default:!1,help:"Return only JSON snapshot string in the snapshot_json field"}],columns:["thread_url","recipient","message_count","latest_text","snapshot_json"],func:async(e,s)=>{if(!e)throw new c("Browser session required for linkedin thread-snapshot");const t=y(_(s,"thread-url","--thread-url"),"--thread-url"),r=h(s["max-scrolls"]);await e.goto("https://www.linkedin.com/messaging/");await e.wait(4);await e.goto(t);await e.wait(10);const n=u(await e.evaluate(g(r)));if(n?.authRequired)throw new b(m,"LinkedIn thread-snapshot requires an active signed-in LinkedIn browser session.");if(!n||typeof n!=="object"||Array.isArray(n)||!Array.isArray(n.headerNames)||!Array.isArray(n.messages))throw new c("LinkedIn thread-snapshot returned malformed snapshot payload");const o=d(n?.url||"");if(t&&o&&t!==o)throw new c("LinkedIn thread-snapshot blocked: thread_url_mismatch",`Expected ${t}; actual ${o}`);const f=a(n.headerNames[0]||""),p=n.messages.length,i={...n,url:o||t,headerNames:n.headerNames,latestMessageText:a(n?.latestMessageText||""),messages:n.messages};return[{thread_url:i.url,recipient:f,message_count:p,latest_text:i.latestMessageText,snapshot_json:JSON.stringify(i)}]}});export const __test__={normalizeWhitespace:a,canonicalizeLinkedInThreadUrl:d,parseMaxScrolls:h,unwrapEvaluateResult:u,buildThreadSnapshotScript:g};

package/clis/linkedin/timeline.js

@@ -0,0 +1,37 @@
+import{cli as L,Strategy as M}from"@jackwener/opencli/registry";import{AuthRequiredError as N,CommandExecutionError as H,EmptyResultError as O}from"@jackwener/opencli/errors";import{unwrapEvaluateResult as P}from"./shared.js";function Q(z){return`(async () => {
+    const norm = (s) => String(s == null ? '' : s).replace(/[  ]+/g, ' ').replace(/\\s+/g, ' ').trim();
+    const csrf = ((document.cookie.split('; ').find((c) => c.startsWith('JSESSIONID=')) || '').split('=')[1] || '').replace(/^"|"$/g, '');
+    if (!csrf) return { ok: false, auth: true };
+    const res = await fetch('/voyager/api/voyagerFeedDashMainFeed?q=mainFeed&count=' + ${z}, { credentials: 'include', headers: {
+      'csrf-token': csrf,
+      'accept': 'application/vnd.linkedin.normalized+json+2.1',
+      'x-restli-protocol-version': '2.0.0',
+      'x-li-lang': 'en_US',
+    } });
+    if (res.status === 401 || res.status === 403) return { ok: false, auth: true, status: res.status };
+    if (!res.ok) return { ok: false, status: res.status };
+    const json = await res.json();
+    const included = json.included || [];
+    const textOf = (o) => (o && o.text && typeof o.text === 'object') ? norm(o.text.text) : norm(o && o.text);
+    const posts = [];
+    for (const up of included) {
+      if (!String(up.$type || '').endsWith('feed.Update')) continue;
+      const actor = up.actor || {};
+      const author = actor.name ? textOf(actor.name) : '';
+      const commentary = up.commentary ? textOf(up.commentary) : '';
+      if (!author && !commentary) continue;
+      const counts = (up.socialDetail && up.socialDetail.totalSocialActivityCounts) || {};
+      const urn = norm(up.updateUrn || up.urn || up.entityUrn);
+      posts.push({
+        author,
+        author_url: norm((actor.navigationContext || {}).actionTarget).split('?')[0],
+        headline: actor.description ? textOf(actor.description) : '',
+        text: commentary,
+        posted_at: actor.subDescription ? textOf(actor.subDescription) : '',
+        reactions: Number(counts.numLikes) || 0,
+        comments: Number(counts.numComments) || 0,
+        url: urn ? 'https://www.linkedin.com/feed/update/' + urn : '',
+      });
+    }
+    return { ok: true, posts };
+  })()`}L({site:"linkedin",name:"timeline",access:"read",description:"Read LinkedIn home timeline posts via the Voyager feed API",domain:"www.linkedin.com",strategy:M.COOKIE,browser:!0,args:[{name:"limit",type:"int",default:20,help:"Number of posts to return (max 50)"}],columns:["rank","author","author_url","headline","text","posted_at","reactions","comments","url"],func:async(z,I)=>{if(!z)throw new H("Browser session required for linkedin timeline");const D=Math.max(1,Math.min(I.limit??20,50));await z.goto("https://www.linkedin.com/feed/");await z.wait(2);const B=P(await z.evaluate(Q(D)));if(B?.auth)throw new N("linkedin.com","LinkedIn timeline requires an active signed-in browser session");if(!B?.ok)throw new H(`LinkedIn timeline: feed API returned HTTP ${B?.status||"?"}`);const G=Array.isArray(B.posts)?B.posts:[];if(G.length===0)throw new O("linkedin timeline","The Voyager feed API returned no posts.");return G.slice(0,D).map((J,K)=>({rank:K+1,...J}))}});export const __test__={};

package/clis/linkedin-learning/auth.js

@@ -0,0 +1,27 @@
+import{AuthRequiredError as e,CommandExecutionError as t}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as o}from"../_shared/site-auth.js";async function a(n){return(await n.getCookies({url:"https://www.linkedin.com"})).some((r)=>r.name==="li_at"&&r.value)}async function s(n){if(!await a(n))throw new e("linkedin.com","LinkedIn li_at cookie missing");await n.goto("https://www.linkedin.com/learning/");await n.wait(2);const i=await n.evaluate(`(async () => {
+    try {
+      const jsessionRaw = (document.cookie.split('; ').find(c => c.startsWith('JSESSIONID=')) || '').split('=')[1] || '';
+      const csrf = jsessionRaw.replace(/^"|"$/g, '');
+      if (!csrf) return { kind: 'auth', detail: 'LinkedIn JSESSIONID missing — csrf token unavailable' };
+      const res = await fetch('/voyager/api/me', { credentials: 'include', headers: { 'csrf-token': csrf, 'Accept': 'application/json' } });
+      if (res.status === 401 || res.status === 403) {
+        return { kind: 'auth', detail: 'LinkedIn /voyager/api/me HTTP ' + res.status };
+      }
+      if (!res.ok) return { kind: 'http', httpStatus: res.status };
+      const d = await res.json();
+      const mini = d && d.miniProfile;
+      if (!mini || !mini.publicIdentifier) {
+        return { kind: 'auth', detail: 'LinkedIn /voyager/api/me 200 but miniProfile missing' };
+      }
+      const firstName = (mini.firstName && (mini.firstName.text || mini.firstName)) || '';
+      const lastName = (mini.lastName && (mini.lastName.text || mini.lastName)) || '';
+      return {
+        ok: true,
+        public_id: String(mini.publicIdentifier),
+        plain_id: String(d.plainId || ''),
+        name: String((firstName + ' ' + lastName).trim()),
+      };
+    } catch (e) {
+      return { kind: 'exception', detail: String(e && e.message || e) };
+    }
+  })()`);if(i?.kind==="auth")throw new e("linkedin.com",i.detail);if(i?.kind==="http")throw new t(`HTTP ${i.httpStatus} from /voyager/api/me`);if(i?.kind==="exception")throw new t(`LinkedIn Learning whoami failed: ${i.detail}`);if(!i?.ok)throw new t(`Unexpected LinkedIn Learning probe: ${JSON.stringify(i)}`);return{public_id:i.public_id,plain_id:i.plain_id,name:i.name}}o({site:"linkedin-learning",domain:"linkedin.com",loginUrl:"https://www.linkedin.com/login?session_redirect=%2Flearning%2F",columns:["public_id","plain_id","name"],quickCheck:a,verify:s,poll:async(n)=>{if(!await a(n))throw new e("linkedin.com","Waiting for LinkedIn li_at cookie");return s(n)}});