publishport-opencli 1.0.0

package/clis/reddit/read.js

@@ -0,0 +1,398 @@
+import{cli as v,Strategy as B}from"@jackwener/opencli/registry";import{ArgumentError as K,AuthRequiredError as z,CommandExecutionError as W,EmptyResultError as h}from"@jackwener/opencli/errors";const f=1,j=5,F=2,C=/^[a-z0-9]+$/i;function q(H){const b=String(H||"").trim();if(!C.test(b))throw new K("Post ID must be a Reddit post id, t3_ fullname, or reddit.com post URL.","Use a bare post id like 1abc123, a fullname like t3_1abc123, or a full Reddit post URL.");return b.toLowerCase()}export function normalizeRedditPostId(H){const b=String(H||"").trim();if(!b)throw new K("Post ID is required.","Use a bare post id like 1abc123, a fullname like t3_1abc123, or a full Reddit post URL.");const Y=b.match(/^t3_([a-z0-9]+)$/i);if(Y)return q(Y[1]);if(/^https?:\/\//i.test(b)){let V;try{V=new URL(b)}catch{throw new K(`Invalid Reddit post URL: ${b}`)}const Z=V.hostname.toLowerCase();if(V.protocol!=="https:"||Z!=="reddit.com"&&!Z.endsWith(".reddit.com"))throw new K("Post URL must be an https reddit.com URL.","Use a URL like https://www.reddit.com/r/sub/comments/1abc123/title_slug/");const J=V.pathname.split("/").filter(Boolean),$=J.indexOf("comments"),Q=$+1;if($<0||J.length<=Q)throw new K("Post URL must include the target post id.","Use a URL like https://www.reddit.com/r/sub/comments/1abc123/title_slug/");if(J.length>Q+3)throw new K("Post URL must end at the post slug or comment permalink id.","Remove extra path segments after the post slug or comment id.");if(J.length===Q+3)q(J[Q+2]);return q(J[Q])}if(b.includes("/")||b.startsWith("t1_"))throw new K("Post ID must be a Reddit post id, t3_ fullname, or reddit.com post URL.","Use a bare post id like 1abc123, a fullname like t3_1abc123, or a full Reddit post URL.");return q(b)}export function parseExpandRounds(H){if(H===void 0||H===null||H==="")return F;const b=Number(H);if(!Number.isFinite(b)||!Number.isInteger(b)||b<f||b>j)throw new K(`expand-rounds must be an integer in [${f}, ${j}].`,`Got: ${H}`);return b}v({site:"reddit",name:"read",access:"read",description:"Read a Reddit post and its comments",domain:"reddit.com",strategy:B.COOKIE,browser:!0,args:[{name:"post-id",required:!0,positional:!0,help:"Post ID (e.g. 1abc123) or full URL"},{name:"sort",default:"best",help:"Comment sort: best, top, new, controversial, old, qa"},{name:"limit",type:"int",default:25,help:"Number of top-level comments"},{name:"depth",type:"int",default:2,help:"Max reply depth (1=no replies, 2=one level of replies, etc.)"},{name:"replies",type:"int",default:5,help:"Max replies shown per comment at each level (sorted by score)"},{name:"max-length",type:"int",default:2000,help:"Max characters per comment body (min 100)"},{name:"expand-more",type:"bool",default:!1,help:'Follow Reddit "more comments" stubs by calling /api/morechildren.json'},{name:"expand-rounds",type:"int",default:F,help:`Max expansion passes when --expand-more is on (${f}–${j}; each round can fan out new "more" stubs)`}],columns:["type","author","score","text","post_hint","url_overridden_by_dest","preview_image_url","gallery_urls"],func:async(H,b)=>{const Y=b.sort??"best",V=Math.max(1,b.limit??25),Z=Math.max(1,b.depth??2),J=Math.max(1,b.replies??5),$=Math.max(100,b["max-length"]??2000),Q=Boolean(b["expand-more"]),y=parseExpandRounds(b["expand-rounds"]),L=normalizeRedditPostId(b["post-id"]),G=await H.evaluate(`
+      (async function() {
+        function decodeHtml(s) {
+          if (typeof s !== 'string' || !s) return '';
+          return s
+            .replace(/&amp;/g, '&')
+            .replace(/&lt;/g, '<')
+            .replace(/&gt;/g, '>')
+            .replace(/&quot;/g, '"')
+            .replace(/&#x27;/gi, "'")
+            .replace(/&#39;/g, "'");
+        }
+        function extractRedditMedia(d) {
+          var post_hint = (d && d.post_hint) || '';
+          var url_overridden_by_dest = decodeHtml((d && d.url_overridden_by_dest) || '');
+          var preview_image_url = decodeHtml(
+            (d && d.preview && d.preview.images && d.preview.images[0] && d.preview.images[0].source && d.preview.images[0].source.url) || ''
+          );
+          var gallery_urls = [];
+          var items = d && d.gallery_data && d.gallery_data.items;
+          var meta = d && d.media_metadata;
+          if (Array.isArray(items) && meta) {
+            for (var gi = 0; gi < items.length; gi++) {
+              var it = items[gi];
+              var m = it && meta[it.media_id];
+              var u = m && m.s && (m.s.u || m.s.gif || m.s.mp4);
+              if (u) gallery_urls.push(decodeHtml(u));
+            }
+          }
+          return {
+            post_hint: post_hint,
+            url_overridden_by_dest: url_overridden_by_dest,
+            preview_image_url: preview_image_url,
+            gallery_urls: gallery_urls,
+          };
+        }
+        var postId = ${JSON.stringify(L)};
+        var linkFullname = 't3_' + postId;
+
+        var sort = ${JSON.stringify(Y)};
+        var limit = ${V};
+        var maxDepth = ${Z};
+        var maxReplies = ${J};
+        var maxLength = ${$};
+        var expandMore = ${JSON.stringify(Q)};
+        var expandRounds = ${y};
+
+        // ---------------------------------------------------------------
+        // Step 1: fetch the post + initial comment tree
+        // ---------------------------------------------------------------
+        // Request more from API than top-level limit to get inline replies.
+        // depth param tells Reddit how deep to inline replies vs "more" stubs.
+        var apiLimit = Math.max(limit * 3, 100);
+        var res = await fetch(
+          '/comments/' + postId + '.json?sort=' + sort + '&limit=' + apiLimit + '&depth=' + (maxDepth + 1) + '&raw_json=1',
+          { credentials: 'include' }
+        );
+        if (res.status === 401 || res.status === 403 || res.status === 404) {
+          return { kind: 'inaccessible', detail: 'Reddit post ' + postId + ' is not accessible (HTTP ' + res.status + ').' };
+        }
+        if (!res.ok) {
+          return { kind: 'http', httpStatus: res.status, where: '/comments/' + postId + '.json' };
+        }
+        var data;
+        try { data = await res.json(); } catch (e) {
+          return { kind: 'malformed', detail: 'Failed to parse Reddit /comments/' + postId + '.json response: ' + (e && e.message || e) };
+        }
+        if (!Array.isArray(data) || data.length < 2) {
+          return { kind: 'malformed', detail: 'Reddit /comments/' + postId + '.json had unexpected envelope shape (length ' + (Array.isArray(data) ? data.length : typeof data) + ').' };
+        }
+
+        var post = data[0] && data[0].data && data[0].data.children && data[0].data.children[0] && data[0].data.children[0].data;
+        if (!post) {
+          return { kind: 'malformed', detail: 'Reddit /comments/' + postId + '.json had no post body.' };
+        }
+        var topListing = data[1] && data[1].data && Array.isArray(data[1].data.children) ? data[1].data.children : null;
+        if (!topListing) {
+          return { kind: 'malformed', detail: 'Reddit /comments/' + postId + '.json had no comment listing.' };
+        }
+
+        // ---------------------------------------------------------------
+        // Step 2: optionally follow "more" stubs via /api/morechildren.json
+        // ---------------------------------------------------------------
+        // Each "more" thing has a .data.children array (t1 ids to fetch).
+        // The morechildren API returns a FLAT list of things; we re-thread
+        // them by parent_id (either t3_<postId> for top-level or t1_<id>
+        // for nested). Each round may surface new "more" stubs (because
+        // expansion is bounded by Reddit's depth param), so we iterate up
+        // to expandRounds times.
+        var expandMeta = { rounds: 0, fetched: 0, capped: false, errors: [] };
+
+        if (expandMore) {
+          // Index every existing t1 node so we can splice replies onto it.
+          var t1Index = {};
+          function indexT1(arr) {
+            if (!Array.isArray(arr)) return;
+            for (var i = 0; i < arr.length; i++) {
+              var node = arr[i];
+              if (node && node.kind === 't1' && node.data && node.data.id) {
+                t1Index[node.data.name || ('t1_' + node.data.id)] = node;
+                if (node.data.replies && node.data.replies.data && node.data.replies.data.children) {
+                  indexT1(node.data.replies.data.children);
+                }
+              }
+            }
+          }
+          indexT1(topListing);
+
+          // Collect "more" stubs (with non-empty children) from anywhere in
+          // the tree. Each stub knows its host array via a closure-bound
+          // reference we attach.
+          function collectMoreStubs(parentArr, parentT1) {
+            var out = [];
+            if (!Array.isArray(parentArr)) return out;
+            for (var i = 0; i < parentArr.length; i++) {
+              var n = parentArr[i];
+              if (!n || !n.data) continue;
+              if (n.kind === 'more' && Array.isArray(n.data.children) && n.data.children.length > 0) {
+                out.push({ stub: n, hostArr: parentArr, hostT1: parentT1 });
+              } else if (n.kind === 't1' && n.data.replies && n.data.replies.data && n.data.replies.data.children) {
+                var nested = collectMoreStubs(n.data.replies.data.children, n);
+                for (var k = 0; k < nested.length; k++) out.push(nested[k]);
+              }
+            }
+            return out;
+          }
+
+          for (var r = 0; r < expandRounds; r++) {
+            var stubs = collectMoreStubs(topListing, null);
+            if (stubs.length === 0) break;
+
+            // Build the union of t1 ids to request this round. Reddit's
+            // morechildren API caps at ~100 ids per call; batch accordingly.
+            var allIds = [];
+            for (var s = 0; s < stubs.length; s++) {
+              var st = stubs[s].stub;
+              for (var c = 0; c < st.data.children.length; c++) allIds.push(st.data.children[c]);
+            }
+            if (allIds.length === 0) break;
+
+            // dedupe preserving order
+            var seen = {};
+            var uniqIds = [];
+            for (var j = 0; j < allIds.length; j++) {
+              if (!seen[allIds[j]]) { seen[allIds[j]] = 1; uniqIds.push(allIds[j]); }
+            }
+
+            var fetchedThings = [];
+            var batchSize = 100;
+            var batchFailed = false;
+            for (var b = 0; b < uniqIds.length; b += batchSize) {
+              var batch = uniqIds.slice(b, b + batchSize);
+              var body = 'api_type=json'
+                + '&link_id=' + encodeURIComponent(linkFullname)
+                + '&children=' + encodeURIComponent(batch.join(','))
+                + '&sort=' + encodeURIComponent(sort)
+                + '&raw_json=1';
+              var mcRes;
+              try {
+                mcRes = await fetch('/api/morechildren', {
+                  method: 'POST',
+                  credentials: 'include',
+                  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+                  body: body,
+                });
+              } catch (e) {
+                return { kind: 'expand-failed', detail: 'morechildren request threw: ' + (e && e.message || e), expandMeta: expandMeta };
+              }
+              if (mcRes.status === 401 || mcRes.status === 403) {
+                return { kind: 'auth', detail: '/api/morechildren returned HTTP ' + mcRes.status + ' (write/expand likely requires login)' };
+              }
+              if (!mcRes.ok) {
+                return { kind: 'http', httpStatus: mcRes.status, where: '/api/morechildren (round ' + (r + 1) + ', batch ' + ((b / batchSize) + 1) + ')' };
+              }
+              var mcData;
+              try { mcData = await mcRes.json(); } catch (e) {
+                return { kind: 'malformed', detail: 'Failed to parse /api/morechildren response: ' + (e && e.message || e) };
+              }
+              var errs = mcData && mcData.json && mcData.json.errors;
+              if (Array.isArray(errs) && errs.length > 0) {
+                return { kind: 'expand-failed', detail: 'Reddit /api/morechildren rejected: ' + errs.map(function(e) { return e.join(': '); }).join('; '), expandMeta: expandMeta };
+              }
+              var things = mcData && mcData.json && mcData.json.data && mcData.json.data.things;
+              if (!Array.isArray(things)) {
+                return { kind: 'malformed', detail: '/api/morechildren returned no things array.' };
+              }
+              for (var t = 0; t < things.length; t++) fetchedThings.push(things[t]);
+            }
+            expandMeta.rounds = r + 1;
+            expandMeta.fetched += fetchedThings.length;
+
+            var fetchedById = {};
+            for (var t = 0; t < fetchedThings.length; t++) {
+              var thing = fetchedThings[t];
+              if (!thing || !thing.data) continue;
+              if (thing.data.id) fetchedById[thing.data.id] = thing;
+              if (thing.data.name) fetchedById[thing.data.name] = thing;
+            }
+
+            var inserted = {};
+            function thingKey(thing) {
+              return thing && thing.data && (thing.data.name || (thing.kind + '_' + thing.data.id));
+            }
+
+            // Replace each collected stub in-place so expansion preserves the
+            // surrounding tree order instead of appending fetched comments at
+            // the end of the parent array.
+            for (var s = 0; s < stubs.length; s++) {
+              var rec = stubs[s];
+              var idx = rec.hostArr.indexOf(rec.stub);
+              if (idx < 0) continue;
+              var expectedParent = rec.hostT1
+                ? (rec.hostT1.data.name || ('t1_' + rec.hostT1.data.id))
+                : linkFullname;
+              var replacements = [];
+              for (var c = 0; c < rec.stub.data.children.length; c++) {
+                var childId = rec.stub.data.children[c];
+                var replacement = fetchedById[childId] || fetchedById['t1_' + childId];
+                if (!replacement || !replacement.data) {
+                  expandMeta.errors.push('missing: ' + childId + ' parent=' + expectedParent);
+                  continue;
+                }
+                var key = thingKey(replacement);
+                if (key && inserted[key]) continue;
+                if (replacement.data.parent_id !== expectedParent) {
+                  expandMeta.errors.push('orphan: ' + (replacement.data.id || '?') + ' parent=' + (replacement.data.parent_id || '?'));
+                  continue;
+                }
+                replacements.push(replacement);
+                if (key) inserted[key] = 1;
+                if (replacement.kind === 't1' && replacement.data && replacement.data.id) {
+                  t1Index[replacement.data.name || ('t1_' + replacement.data.id)] = replacement;
+                }
+              }
+              rec.hostArr.splice(idx, 1, ...replacements);
+            }
+
+            for (var t = 0; t < fetchedThings.length; t++) {
+              var unplaced = fetchedThings[t];
+              var unplacedKey = thingKey(unplaced);
+              if (unplacedKey && inserted[unplacedKey]) continue;
+              if (unplaced && unplaced.data) {
+                expandMeta.errors.push('unplaced: ' + (unplaced.data.id || '?') + ' parent=' + (unplaced.data.parent_id || '?'));
+                continue;
+              }
+            }
+
+            if (r + 1 >= expandRounds) {
+              // If after the last round there are still "more" stubs, mark capped.
+              var remaining = collectMoreStubs(topListing, null);
+              if (remaining.length > 0) expandMeta.capped = true;
+            }
+          }
+
+          if (expandMeta.errors.length > 0) {
+            return { kind: 'expand-failed', detail: 'Reddit /api/morechildren returned unplaceable comments: ' + expandMeta.errors.slice(0, 5).join('; '), expandMeta: expandMeta };
+          }
+        }
+
+        // ---------------------------------------------------------------
+        // Step 3: walk the (possibly augmented) tree into indented rows
+        // ---------------------------------------------------------------
+        var rows = [];
+
+        // Post header row.
+        var body = post.selftext || '';
+        if (body.length > maxLength) body = body.slice(0, maxLength) + '\\n... [truncated]';
+        var postMedia = extractRedditMedia(post);
+        rows.push({
+          type: 'POST',
+          author: post.author || '[deleted]',
+          score: post.score || 0,
+          text: post.title + (body ? '\\n\\n' + body : '') + (post.url && !post.is_self ? '\\n' + post.url : ''),
+          post_hint: postMedia.post_hint,
+          url_overridden_by_dest: postMedia.url_overridden_by_dest,
+          preview_image_url: postMedia.preview_image_url,
+          gallery_urls: postMedia.gallery_urls,
+        });
+
+        // Recursive comment walker.
+        function walkComment(node, depth) {
+          if (!node || node.kind !== 't1') return;
+          var d = node.data;
+          var cBody = d.body || '';
+          if (cBody.length > maxLength) cBody = cBody.slice(0, maxLength) + '...';
+
+          var indent = '';
+          for (var i = 0; i < depth; i++) indent += '  ';
+          var prefix = depth === 0 ? '' : indent + '> ';
+          var indentedBody = depth === 0
+            ? cBody
+            : cBody.split('\\n').map(function(line) { return prefix + line; }).join('\\n');
+
+          rows.push({
+            type: depth === 0 ? 'L0' : 'L' + depth,
+            author: d.author || '[deleted]',
+            score: d.score || 0,
+            text: indentedBody,
+            post_hint: '',
+            url_overridden_by_dest: '',
+            preview_image_url: '',
+            gallery_urls: [],
+          });
+
+          var t1Children = [];
+          var moreCount = 0;
+          if (d.replies && d.replies.data && d.replies.data.children) {
+            var children = d.replies.data.children;
+            for (var i = 0; i < children.length; i++) {
+              if (children[i].kind === 't1') {
+                t1Children.push(children[i]);
+              } else if (children[i].kind === 'more') {
+                moreCount += children[i].data.count || 0;
+              }
+            }
+          }
+
+          if (depth + 1 >= maxDepth) {
+            var totalHidden = t1Children.length + moreCount;
+            if (totalHidden > 0) {
+              var cutoffIndent = '';
+              for (var j = 0; j <= depth; j++) cutoffIndent += '  ';
+              rows.push({
+                type: 'L' + (depth + 1),
+                author: '',
+                score: '',
+                text: cutoffIndent + '[+' + totalHidden + ' more replies]',
+                post_hint: '',
+                url_overridden_by_dest: '',
+                preview_image_url: '',
+                gallery_urls: [],
+              });
+            }
+            return;
+          }
+
+          t1Children.sort(function(a, b) { return (b.data.score || 0) - (a.data.score || 0); });
+          var toProcess = Math.min(t1Children.length, maxReplies);
+          for (var i = 0; i < toProcess; i++) {
+            walkComment(t1Children[i], depth + 1);
+          }
+
+          var hidden = t1Children.length - toProcess + moreCount;
+          if (hidden > 0) {
+            var moreIndent = '';
+            for (var j = 0; j <= depth; j++) moreIndent += '  ';
+            rows.push({
+              type: 'L' + (depth + 1),
+              author: '',
+              score: '',
+              text: moreIndent + '[+' + hidden + ' more replies]',
+              post_hint: '',
+              url_overridden_by_dest: '',
+              preview_image_url: '',
+              gallery_urls: [],
+            });
+          }
+        }
+
+        var t1TopLevel = [];
+        for (var i = 0; i < topListing.length; i++) {
+          if (topListing[i].kind === 't1') t1TopLevel.push(topListing[i]);
+        }
+
+        // Detect parser drift: tree had content but the walker produced nothing.
+        // We must check this AFTER the walk because top-level may be only "more"
+        // stubs (legitimate empty case for a brand-new post).
+        var preWalkSize = topListing.length;
+        for (var i = 0; i < Math.min(t1TopLevel.length, limit); i++) {
+          walkComment(t1TopLevel[i], 0);
+        }
+
+        var moreTopLevel = topListing.filter(function(c) { return c.kind === 'more'; })
+          .reduce(function(sum, c) { return sum + (c.data.count || 0); }, 0);
+        var hiddenTopLevel = Math.max(0, t1TopLevel.length - limit) + moreTopLevel;
+        if (hiddenTopLevel > 0) {
+          rows.push({
+            type: '',
+            author: '',
+            score: '',
+            text: '[+' + hiddenTopLevel + ' more top-level comments]',
+            post_hint: '',
+            url_overridden_by_dest: '',
+            preview_image_url: '',
+            gallery_urls: [],
+          });
+        }
+
+        // If we produced nothing beyond the POST row but the comment listing
+        // wasn't empty, that's parser drift (e.g. Reddit changed t1/more
+        // schema). Surface as CommandExecutionError on the Node side.
+        if (rows.length <= 1 && preWalkSize > 0 && t1TopLevel.length > 0) {
+          return { kind: 'parser-drift', detail: 'Reddit comment listing for post ' + postId + ' had ' + t1TopLevel.length + ' t1 entries but walker produced no rows.' };
+        }
+
+        return { kind: 'ok', rows: rows, expandMeta: expandMeta };
+      })()
+    `);if(!G||typeof G!=="object")throw new W("Reddit /comments fetch returned no result envelope.");if(G.kind==="inaccessible")throw new h(G.detail);if(G.kind==="auth")throw new z("reddit.com",G.detail);if(G.kind==="http")throw new W(`HTTP ${G.httpStatus} from ${G.where}`);if(G.kind==="malformed")throw new W(G.detail);if(G.kind==="parser-drift")throw new W(G.detail);if(G.kind==="expand-failed")throw new W(G.detail);if(G.kind!=="ok"||!Array.isArray(G.rows))throw new W(`Unexpected result from reddit read: ${JSON.stringify(G)}`);return G.rows}});

package/clis/reddit/reply.js

@@ -0,0 +1,56 @@
+import{ArgumentError as J,AuthRequiredError as Y,CommandExecutionError as L}from"@jackwener/opencli/errors";import{cli as Z,Strategy as $}from"@jackwener/opencli/registry";const F=/^[a-z0-9]+$/i;function W(H){const b=String(H||"").trim();if(!F.test(b))throw new J("Comment ID must be a Reddit comment id, t1_ fullname, or reddit.com comment URL.","Use a bare comment id like okf3s7u, a fullname like t1_okf3s7u, or a full Reddit comment URL.");return b.toLowerCase()}export function normalizeRedditCommentFullname(H){const b=String(H||"").trim();if(!b)throw new J("Comment ID is required.","Use a bare comment id like okf3s7u, a fullname like t1_okf3s7u, or a full Reddit comment URL.");const Q=b.match(/^t1_([a-z0-9]+)$/i);if(Q)return`t1_${W(Q[1])}`;if(/^https?:\/\//i.test(b)){let K;try{K=new URL(b)}catch{throw new J(`Invalid Reddit comment URL: ${b}`)}const G=K.hostname.toLowerCase();if(K.protocol!=="https:"||G!=="reddit.com"&&!G.endsWith(".reddit.com"))throw new J("Comment URL must be an https reddit.com URL.","Use a URL like https://www.reddit.com/r/sub/comments/post/title/okf3s7u/");const U=K.pathname.split("/").filter(Boolean),X=U.indexOf("comments"),V=X+3;if(X<0||U.length<=V)throw new J("Comment URL must include the target comment id.","Use a URL like https://www.reddit.com/r/sub/comments/post/title/okf3s7u/");if(U.length!==V+1)throw new J("Comment URL must end at the target comment id.","Remove extra path segments after the comment id.");return`t1_${W(U[V])}`}if(b.includes("/")||b.startsWith("t3_"))throw new J("Comment ID must be a Reddit comment id, t1_ fullname, or reddit.com comment URL.","Use a bare comment id like okf3s7u, a fullname like t1_okf3s7u, or a full Reddit comment URL.");return`t1_${W(b)}`}export function requireReplyText(H){const b=String(H||"");if(!b.trim())throw new J("Reply text is required.","Pass non-empty text to post as the Reddit reply.");return b}Z({site:"reddit",name:"reply",access:"write",description:"Reply to a Reddit comment",domain:"reddit.com",strategy:$.COOKIE,browser:!0,args:[{name:"comment-id",type:"string",required:!0,positional:!0,help:"Comment ID (e.g. okf3s7u) or fullname (t1_xxx)"},{name:"text",type:"string",required:!0,positional:!0,help:"Reply text"}],columns:["status","message"],func:async(H,b)=>{const Q=normalizeRedditCommentFullname(b["comment-id"]),K=requireReplyText(b.text);await H.goto("https://www.reddit.com");const G=await H.evaluate(`(async () => {
+      try {
+        const fullname = ${JSON.stringify(Q)};
+        const text = ${JSON.stringify(K)};
+
+        // Probe identity + modhash. /api/me.json returns data.name only when
+        // logged in — empty modhash alone is not a strong enough auth signal
+        // because Reddit sometimes returns 200 with empty modhash for stale
+        // anonymous sessions.
+        const meRes = await fetch('/api/me.json', { credentials: 'include' });
+        if (meRes.status === 401 || meRes.status === 403) {
+          return { kind: 'auth', detail: 'Reddit /api/me.json returned HTTP ' + meRes.status };
+        }
+        if (!meRes.ok) {
+          return { kind: 'http', httpStatus: meRes.status, where: '/api/me.json' };
+        }
+        const me = await meRes.json();
+        if (!me?.data?.name) {
+          return { kind: 'auth', detail: 'Not logged in to reddit.com (no identity in /api/me.json)' };
+        }
+        const modhash = me.data.modhash || '';
+
+        const res = await fetch('/api/comment', {
+          method: 'POST',
+          credentials: 'include',
+          headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+          body: 'parent=' + encodeURIComponent(fullname)
+            + '&text=' + encodeURIComponent(text)
+            + '&api_type=json'
+            + (modhash ? '&uh=' + encodeURIComponent(modhash) : ''),
+        });
+
+        if (res.status === 401 || res.status === 403) {
+          return { kind: 'auth', detail: 'Reddit /api/comment returned HTTP ' + res.status };
+        }
+        if (!res.ok) {
+          return { kind: 'http', httpStatus: res.status, where: '/api/comment' };
+        }
+        const data = await res.json();
+        const errors = data?.json?.errors;
+        if (errors && errors.length > 0) {
+          return { kind: 'reddit-error', detail: errors.map(e => e.join(': ')).join('; ') };
+        }
+        const things = data?.json?.data?.things;
+        const created = Array.isArray(things)
+          ? things.find((thing) => thing?.kind === 't1' || String(thing?.data?.name || '').startsWith('t1_'))
+          : null;
+        const createdName = created?.data?.name || (created?.data?.id ? 't1_' + created.data.id : '');
+        if (!createdName) {
+          return { kind: 'postcondition', detail: 'Reddit comment response did not include a created reply id' };
+        }
+        return { kind: 'ok', detail: 'Reply posted on ' + fullname + ' as ' + createdName };
+      } catch (e) {
+        return { kind: 'exception', detail: String(e && e.message || e) };
+      }
+    })()`);if(G?.kind==="auth")throw new Y("reddit.com",G.detail);if(G?.kind==="http")throw new L(`HTTP ${G.httpStatus} from ${G.where}`);if(G?.kind==="reddit-error")throw new L(`Reddit rejected reply: ${G.detail}`);if(G?.kind==="postcondition")throw new L(G.detail);if(G?.kind==="exception")throw new L(`Reply failed: ${G.detail}`);if(G?.kind!=="ok")throw new L(`Unexpected result from reddit reply: ${JSON.stringify(G)}`);return[{status:"success",message:G.detail}]}});

package/clis/reddit/save.js

@@ -0,0 +1,30 @@
+import{CommandExecutionError as o}from"@jackwener/opencli/errors";import{cli as a,Strategy as n}from"@jackwener/opencli/registry";a({site:"reddit",name:"save",access:"write",description:"Save or unsave a Reddit post",domain:"reddit.com",strategy:n.COOKIE,browser:!0,args:[{name:"post-id",type:"string",required:!0,positional:!0,help:"Post ID (e.g. 1abc123) or fullname (t3_xxx)"},{name:"undo",type:"boolean",default:!1,help:"Unsave instead of save"}],columns:["status","message"],func:async(e,t)=>{if(!e)throw new o("Browser session required");await e.goto("https://www.reddit.com");const s=await e.evaluate(`(async () => {
+      try {
+        let postId = ${JSON.stringify(t["post-id"])};
+        const urlMatch = postId.match(/comments\\/([a-z0-9]+)/);
+        if (urlMatch) postId = urlMatch[1];
+        const fullname = postId.startsWith('t3_') || postId.startsWith('t1_')
+          ? postId : 't3_' + postId;
+
+        const undo = ${t.undo?"true":"false"};
+        const endpoint = undo ? '/api/unsave' : '/api/save';
+
+        // Get modhash
+        const meRes = await fetch('/api/me.json', { credentials: 'include' });
+        const me = await meRes.json();
+        const modhash = me?.data?.modhash || '';
+
+        const res = await fetch(endpoint, {
+          method: 'POST',
+          credentials: 'include',
+          headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+          body: 'id=' + encodeURIComponent(fullname)
+            + (modhash ? '&uh=' + encodeURIComponent(modhash) : ''),
+        });
+
+        if (!res.ok) return { ok: false, message: 'HTTP ' + res.status };
+        return { ok: true, message: (undo ? 'Unsaved' : 'Saved') + ' ' + fullname };
+      } catch (e) {
+        return { ok: false, message: e.toString() };
+      }
+    })()`);return[{status:s.ok?"success":"failed",message:s.message}]}});

package/clis/reddit/saved.js

@@ -0,0 +1,24 @@
+import{AuthRequiredError as a,CommandExecutionError as i}from"@jackwener/opencli/errors";import{cli as s,Strategy as n}from"@jackwener/opencli/registry";s({site:"reddit",name:"saved",access:"read",description:"Browse your saved Reddit posts",domain:"reddit.com",strategy:n.COOKIE,browser:!0,args:[{name:"limit",type:"int",default:15}],columns:["title","subreddit","score","comments","url"],func:async(t,r)=>{if(!t)throw new i("Browser session required");await t.goto("https://www.reddit.com");const e=await t.evaluate(`(async () => {
+      try {
+        // Get current username
+        const meRes = await fetch('/api/me.json?raw_json=1', { credentials: 'include' });
+        const me = await meRes.json();
+        const username = me?.name || me?.data?.name;
+        if (!username) return { error: 'Not logged in — cannot determine username' };
+
+        const limit = ${r.limit};
+        const res = await fetch('/user/' + username + '/saved.json?limit=' + limit + '&raw_json=1', {
+          credentials: 'include'
+        });
+        const d = await res.json();
+        return (d?.data?.children || []).map(c => ({
+          title: c.data.title || c.data.body?.slice(0, 100) || '',
+          subreddit: c.data.subreddit_name_prefixed || 'r/' + (c.data.subreddit || '?'),
+          score: c.data.score || 0,
+          comments: c.data.num_comments || 0,
+          url: 'https://www.reddit.com' + (c.data.permalink || ''),
+        }));
+      } catch (e) {
+        return { error: e.toString() };
+      }
+    })()`);if(e?.error){if(String(e.error).includes("Not logged in"))throw new a("reddit.com",e.error);throw new i(e.error)}return(e||[]).slice(0,r.limit)}});

package/clis/reddit/search.js

@@ -0,0 +1,51 @@
+import{cli as e,Strategy as t}from"@jackwener/opencli/registry";e({site:"reddit",name:"search",access:"read",description:"Search Reddit Posts",domain:"reddit.com",strategy:t.COOKIE,browser:!0,args:[{name:"query",type:"string",required:!0,positional:!0,help:"Reddit search query"},{name:"subreddit",type:"string",default:"",help:"Search within a specific subreddit"},{name:"sort",type:"string",default:"relevance",help:"Sort order: relevance, hot, top, new, comments"},{name:"time",type:"string",default:"all",help:"Time filter: hour, day, week, month, year, all"},{name:"limit",type:"int",default:15}],columns:["id","title","subreddit","author","score","comments","url","created_utc","selftext","post_hint","url_overridden_by_dest","preview_image_url","gallery_urls"],pipeline:[{evaluate:`(async () => {
+  function decodeHtml(s) {
+    if (typeof s !== 'string' || !s) return '';
+    return s
+      .replace(/&/g, '&')
+      .replace(/&lt;/g, '<')
+      .replace(/&gt;/g, '>')
+      .replace(/&quot;/g, '"')
+      .replace(/&#x27;/gi, "'")
+      .replace(/&#39;/g, "'");
+  }
+  function extractRedditMedia(d) {
+    const post_hint = d?.post_hint || '';
+    const url_overridden_by_dest = d?.url_overridden_by_dest || '';
+    const preview_image_url = decodeHtml(d?.preview?.images?.[0]?.source?.url || '');
+    const gallery_urls = [];
+    const items = d?.gallery_data?.items;
+    const meta = d?.media_metadata;
+    if (Array.isArray(items) && meta) {
+      for (const it of items) {
+        const m = it && meta[it.media_id];
+        const u = m?.s?.u;
+        if (u) gallery_urls.push(decodeHtml(u));
+      }
+    }
+    return { post_hint, url_overridden_by_dest, preview_image_url, gallery_urls };
+  }
+  const q = encodeURIComponent(\${{ args.query | json }});
+  const sub = \${{ args.subreddit | json }};
+  const sort = \${{ args.sort | json }};
+  const time = \${{ args.time | json }};
+  const limit = \${{ args.limit }};
+  const basePath = sub ? '/r/' + sub + '/search.json' : '/search.json';
+  const params = 'q=' + q + '&sort=' + sort + '&t=' + time + '&limit=' + limit
+    + '&restrict_sr=' + (sub ? 'on' : 'off') + '&raw_json=1';
+  const res = await fetch(basePath + '?' + params, { credentials: 'include' });
+  const d = await res.json();
+  return (d?.data?.children || []).map(c => ({
+    id: c.data.id,
+    title: c.data.title,
+    subreddit: c.data.subreddit_name_prefixed,
+    author: c.data.author,
+    score: c.data.score,
+    comments: c.data.num_comments,
+    url: 'https://www.reddit.com' + c.data.permalink,
+    created_utc: c.data.created_utc,
+    selftext: c.data.selftext || '',
+    ...extractRedditMedia(c.data),
+  }));
+})()
+`},{map:{id:"${{ item.id }}",title:"${{ item.title }}",subreddit:"${{ item.subreddit }}",author:"${{ item.author }}",score:"${{ item.score }}",comments:"${{ item.comments }}",url:"${{ item.url }}",created_utc:"${{ item.created_utc }}",selftext:"${{ item.selftext }}",post_hint:"${{ item.post_hint }}",url_overridden_by_dest:"${{ item.url_overridden_by_dest }}",preview_image_url:"${{ item.preview_image_url }}",gallery_urls:"${{ item.gallery_urls }}"}},{limit:"${{ args.limit }}"}]});

package/clis/reddit/submit.js

@@ -0,0 +1,42 @@
+import{ArgumentError as H,AuthRequiredError as V,CommandExecutionError as P}from"@jackwener/opencli/errors";import{cli as W,Strategy as X}from"@jackwener/opencli/registry";const Y=/^[A-Za-z0-9][A-Za-z0-9_]{1,20}$/;export function normalizeSubreddit(M){let F=String(M||"").trim();if(!F)throw new H("Subreddit is required.",'Pass a subreddit like "test" or "r/test".');if(/^https?:\/\//i.test(F)){let N;try{N=new URL(F)}catch{throw new H(`Invalid subreddit URL: ${F}`)}const J=N.pathname.split("/").filter(Boolean),K=J.indexOf("r");if(K<0||J.length<=K+1)throw new H("Subreddit URL must contain /r/<name>.");F=J[K+1]}F=F.replace(/^\/?r\//i,"").replace(/^\/+/,"");if(!Y.test(F))throw new H(`Invalid subreddit name: ${JSON.stringify(F)}`,'Use the bare name, e.g. "test" (2–21 chars, letters/digits/underscore).');return F}W({site:"reddit",name:"submit",access:"write",description:"Submit a new post to a subreddit. Text post by default (--text); pass --url for a link post. Note: many subreddits gate submissions behind karma/age requirements or flair — a rejection is surfaced verbatim.",domain:"reddit.com",strategy:X.COOKIE,browser:!0,args:[{name:"subreddit",type:"string",required:!0,positional:!0,help:'Target subreddit, e.g. "test" or "r/test"'},{name:"title",type:"string",required:!0,positional:!0,help:"Post title (max 300 chars)"},{name:"text",type:"string",help:"Body text (markdown) for a self/text post"},{name:"url",type:"string",help:"External URL for a link post (mutually exclusive with --text)"},{name:"flair-id",type:"string",help:"Flair template id, if the subreddit requires one"},{name:"flair-text",type:"string",help:"Flair text to accompany --flair-id"},{name:"nsfw",type:"bool",default:!1,help:"Mark the post as NSFW"},{name:"spoiler",type:"bool",default:!1,help:"Mark the post as a spoiler"},{name:"sendreplies",type:"bool",default:!0,help:"Receive inbox replies for this post (default: true)"}],columns:["status","url","id","message"],func:async(M,F)=>{if(!M)throw new P("Browser session required");const N=normalizeSubreddit(F.subreddit),J=String(F.title??"").trim();if(!J)throw new H("Title is required.");if(J.length>300)throw new H("Title must be at most 300 characters.");const K=typeof F.text==="string"?F.text:"",O=typeof F.url==="string"?F.url.trim():"";if(O&&K)throw new H("Pass either --text (self post) or --url (link post), not both.");const Q=O?"link":"self";if(Q==="link")try{new URL(O)}catch{throw new H(`Invalid --url: ${O}`)}await M.goto("https://www.reddit.com");const G=await M.evaluate(`(async () => {
+      try {
+        const meRes = await fetch('/api/me.json', { credentials: 'include' });
+        if (meRes.status === 401 || meRes.status === 403) {
+          return { kind: 'auth', detail: 'Reddit /api/me.json HTTP ' + meRes.status };
+        }
+        const me = await meRes.json();
+        const modhash = me && me.data && me.data.modhash;
+        if (!modhash) return { kind: 'auth', detail: 'No modhash — anonymous or expired session' };
+
+        const p = new URLSearchParams();
+        p.set('sr', ${JSON.stringify(N)});
+        p.set('title', ${JSON.stringify(J)});
+        p.set('kind', ${JSON.stringify(Q)});
+        ${Q==="link"?`p.set('url', ${JSON.stringify(O)}); p.set('resubmit', 'true');`:`p.set('text', ${JSON.stringify(K)});`}
+        p.set('api_type', 'json');
+        p.set('validate_on_submit', 'true');
+        p.set('sendreplies', ${F.sendreplies===!1?"'false'":"'true'"});
+        ${F.nsfw?"p.set('nsfw', 'true');":""}
+        ${F.spoiler?"p.set('spoiler', 'true');":""}
+        ${F["flair-id"]?`p.set('flair_id', ${JSON.stringify(String(F["flair-id"]))});`:""}
+        ${F["flair-text"]?`p.set('flair_text', ${JSON.stringify(String(F["flair-text"]))});`:""}
+        p.set('uh', modhash);
+
+        const res = await fetch('/api/submit', {
+          method: 'POST',
+          credentials: 'include',
+          headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+          body: p.toString(),
+        });
+        if (!res.ok) return { kind: 'http', httpStatus: res.status };
+        const data = await res.json();
+        const errors = data && data.json && data.json.errors;
+        if (errors && errors.length > 0) {
+          return { kind: 'reject', detail: errors.map(e => e.join(': ')).join('; ') };
+        }
+        const d = (data && data.json && data.json.data) || {};
+        return { ok: true, url: d.url || '', id: d.id || (d.name || '') };
+      } catch (e) {
+        return { kind: 'exception', detail: String((e && e.message) || e) };
+      }
+    })()`);if(G?.kind==="auth")throw new V("reddit.com",G.detail);if(G?.kind==="http")throw new P(`HTTP ${G.httpStatus} from /api/submit`);if(G?.kind==="exception")throw new P(`Reddit submit failed: ${G.detail}`);if(G?.kind==="reject")return[{status:"failed",url:"",id:"",message:G.detail}];if(!G?.ok)throw new P(`Unexpected Reddit submit result: ${JSON.stringify(G)}`);return[{status:"success",url:G.url,id:G.id,message:"Post submitted to r/"+N}]}});