@opentabs-dev/opentabs-plugin-reddit 0.0.76 → 0.0.77

package/README.md

@@ -0,0 +1,75 @@
+# Reddit
+
+OpenTabs plugin for Reddit — gives AI agents access to Reddit through your authenticated browser session.
+
+## Install
+
+```bash
+opentabs plugin install reddit
+```
+
+Or install globally via npm:
+
+```bash
+npm install -g @opentabs-dev/opentabs-plugin-reddit
+```
+
+## Setup
+
+1. Open [www.reddit.com](https://www.reddit.com) in Chrome and log in
+2. Open the OpenTabs side panel — the Reddit plugin should appear as **ready**
+
+## Tools (15)
+
+### User (2)
+
+| Tool | Description | Type |
+|---|---|---|
+| `get_me` | Get the current user profile | Read |
+| `get_user` | Get a user profile | Read |
+
+### Posts (4)
+
+| Tool | Description | Type |
+|---|---|---|
+| `list_posts` | List posts from a subreddit | Read |
+| `get_post` | Get a post and its comments | Read |
+| `search_posts` | Search Reddit posts | Read |
+| `submit_post` | Submit a new post | Write |
+
+### Comments (1)
+
+| Tool | Description | Type |
+|---|---|---|
+| `submit_comment` | Post a comment or reply | Write |
+
+### Actions (2)
+
+| Tool | Description | Type |
+|---|---|---|
+| `vote` | Vote on a post or comment | Write |
+| `save` | Save or unsave a post/comment | Write |
+
+### Subreddits (4)
+
+| Tool | Description | Type |
+|---|---|---|
+| `get_subreddit` | Get subreddit details | Read |
+| `search_subreddits` | Search subreddits | Read |
+| `list_subscriptions` | List subscribed subreddits | Read |
+| `subscribe` | Subscribe or unsubscribe from a subreddit | Write |
+
+### Messages (2)
+
+| Tool | Description | Type |
+|---|---|---|
+| `send_message` | Send a private message | Write |
+| `read_inbox` | Read inbox messages | Read |
+
+## How It Works
+
+This plugin runs inside your Reddit tab through the [OpenTabs](https://opentabs.dev) Chrome extension. It uses your existing browser session — no API tokens or OAuth apps required. All operations happen as you, with your permissions.
+
+## License
+
+MIT

package/dist/adapter.iife.js

@@ -265,6 +265,8 @@
      * (e.g., 'https://github.com'), not a match pattern.
      */
     homepage;
+    /** Typed configuration schema — declares settings that users provide via config.json or the side panel. */
+    configSchema;
   };
 
   // src/reddit-api.ts
@@ -14229,6 +14231,145 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
   // node_modules/zod/v4/classic/external.js
   config(en_default());
 
+  // src/tools/delete-thing.ts
+  var deleteThing = defineTool({
+    name: "delete",
+    displayName: "Delete Post/Comment",
+    description: "Permanently delete a post or comment. Only the author can delete their own content. This action cannot be undone.",
+    summary: "Delete a post or comment",
+    icon: "trash",
+    group: "Actions",
+    input: external_exports.object({
+      id: external_exports.string().min(1).describe('Fullname of the post or comment to delete (e.g., "t3_abc123" for a post, "t1_xyz" for a comment)')
+    }),
+    output: external_exports.object({
+      success: external_exports.boolean().describe("Whether the deletion was successful")
+    }),
+    handle: async (params) => {
+      await redditPost("/api/del", { id: params.id });
+      return { success: true };
+    }
+  });
+
+  // src/tools/edit-text.ts
+  var editText = defineTool({
+    name: "edit_text",
+    displayName: "Edit Post/Comment",
+    description: "Edit the body text of a self-post or comment. Only the author can edit their own content. Link posts cannot be edited.",
+    summary: "Edit a post or comment",
+    icon: "edit",
+    group: "Actions",
+    input: external_exports.object({
+      thing_id: external_exports.string().min(1).describe('Fullname of the post or comment to edit (e.g., "t3_abc123" for a post, "t1_xyz" for a comment)'),
+      text: external_exports.string().min(1).describe("New body text (supports Reddit markdown)")
+    }),
+    output: external_exports.object({
+      success: external_exports.boolean().describe("Whether the edit was applied"),
+      body: external_exports.string().describe("Updated body text as returned by Reddit")
+    }),
+    handle: async (params) => {
+      const data = await redditPost("/api/editusertext", {
+        thing_id: params.thing_id,
+        text: params.text
+      });
+      if (data.json.errors.length > 0) {
+        const errorMsg = data.json.errors.map((e) => e[1]).join("; ");
+        throw ToolError.validation(`Reddit API error: ${errorMsg}`);
+      }
+      const thing = data.json.data?.things[0]?.data;
+      return {
+        success: true,
+        body: thing?.contentText ?? params.text
+      };
+    }
+  });
+
+  // src/tools/get-comment-thread.ts
+  var commentSchema = external_exports.object({
+    id: external_exports.string().describe("Comment ID"),
+    name: external_exports.string().describe('Comment fullname (e.g., "t1_abc123")'),
+    author: external_exports.string().describe("Comment author username"),
+    body: external_exports.string().describe("Comment body text (markdown)"),
+    score: external_exports.number().describe("Comment score"),
+    created_utc: external_exports.number().describe("Comment creation time as Unix timestamp"),
+    parent_id: external_exports.string().describe("Parent thing fullname (t3_ for post, t1_ for parent comment)"),
+    depth: external_exports.number().describe("Nesting depth (0 = top-level reply)"),
+    is_submitter: external_exports.boolean().describe("Whether the commenter is the post author (OP)")
+  });
+  var flattenComments = (children, maxDepth) => {
+    const result = [];
+    for (const child of children) {
+      if (child.kind !== "t1") continue;
+      result.push(child.data);
+      if (child.data.replies && typeof child.data.replies === "object" && child.data.depth < maxDepth) {
+        result.push(...flattenComments(child.data.replies.data.children, maxDepth));
+      }
+    }
+    return result;
+  };
+  var getCommentThread = defineTool({
+    name: "get_comment_thread",
+    displayName: "Get Comment Thread",
+    description: "Get a specific comment and its nested replies. Focuses the comment tree on a particular comment, returning its full reply chain regardless of nesting depth. Use this to read deeply nested conversations that get_post may truncate.",
+    summary: "Get a comment and its replies",
+    icon: "message-square",
+    group: "Comments",
+    input: external_exports.object({
+      subreddit: external_exports.string().min(1).describe("Subreddit name without r/ prefix"),
+      post_id: external_exports.string().min(1).describe('Post ID without t3_ prefix (e.g., "1ki00n1")'),
+      comment_id: external_exports.string().min(1).describe('Comment ID without t1_ prefix (e.g., "o9z5cx1") \u2014 the comment to focus on'),
+      depth: external_exports.number().int().min(0).max(10).optional().describe("Max reply nesting depth below the target comment (default 8)"),
+      limit: external_exports.number().int().min(0).max(500).optional().describe("Max number of child comments to return (default 100)")
+    }),
+    output: external_exports.object({
+      comment: commentSchema.describe("The target comment"),
+      replies: external_exports.array(commentSchema).describe("Flattened array of nested replies with depth info")
+    }),
+    handle: async (params) => {
+      const queryParams = {
+        comment: params.comment_id,
+        depth: String((params.depth ?? 8) + 1),
+        limit: String(params.limit ?? 100)
+      };
+      const data = await redditGet(
+        `/r/${params.subreddit}/comments/${params.post_id}.json`,
+        queryParams
+      );
+      const commentChildren = data[1]?.data.children ?? [];
+      const targetChild = commentChildren.find((c) => c.kind === "t1" && c.data.id === params.comment_id);
+      if (!targetChild || targetChild.kind !== "t1") {
+        throw ToolError.notFound(`Comment ${params.comment_id} not found in post ${params.post_id}`);
+      }
+      const target = targetChild.data;
+      const maxDepth = target.depth + (params.depth ?? 8);
+      const replies = target.replies && typeof target.replies === "object" ? flattenComments(target.replies.data.children, maxDepth) : [];
+      return {
+        comment: {
+          id: target.id,
+          name: target.name,
+          author: target.author,
+          body: target.body,
+          score: target.score,
+          created_utc: target.created_utc,
+          parent_id: target.parent_id,
+          depth: target.depth,
+          is_submitter: target.is_submitter
+        },
+        replies: replies.map((c) => ({
+          id: c.id,
+          name: c.name,
+          author: c.author,
+          body: c.body,
+          score: c.score,
+          created_utc: c.created_utc,
+          parent_id: c.parent_id,
+          depth: c.depth,
+          is_submitter: c.is_submitter
+        }))
+      };
+    }
+  });
+
   // src/tools/get-me.ts
   var getMe = defineTool({
     name: "get_me",
@@ -14267,7 +14408,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
   });
 
   // src/tools/get-post.ts
-  var commentSchema = external_exports.object({
+  var commentSchema2 = external_exports.object({
     id: external_exports.string().describe("Comment ID"),
     name: external_exports.string().describe('Comment fullname (e.g., "t1_abc123")'),
     author: external_exports.string().describe("Comment author username"),
@@ -14278,13 +14419,13 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     depth: external_exports.number().describe("Nesting depth (0 = top-level reply)"),
     is_submitter: external_exports.boolean().describe("Whether the commenter is the post author (OP)")
   });
-  var flattenComments = (children, maxDepth) => {
+  var flattenComments2 = (children, maxDepth) => {
     const result = [];
     for (const child of children) {
       if (child.kind !== "t1") continue;
       result.push(child.data);
       if (child.data.replies && typeof child.data.replies === "object" && child.data.depth < maxDepth) {
-        result.push(...flattenComments(child.data.replies.data.children, maxDepth));
+        result.push(...flattenComments2(child.data.replies.data.children, maxDepth));
       }
     }
     return result;
@@ -14319,7 +14460,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
         is_self: external_exports.boolean().describe("Whether this is a text post"),
         created_utc: external_exports.number().describe("Creation timestamp")
       }),
-      comments: external_exports.array(commentSchema).describe("Flattened array of comments with depth info")
+      comments: external_exports.array(commentSchema2).describe("Flattened array of comments with depth info")
     }),
     handle: async (params) => {
       const queryParams = {
@@ -14337,7 +14478,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       if (!postData) {
         throw ToolError.notFound("Post not found");
       }
-      const comments = flattenComments(data[1]?.data.children ?? [], params.comment_depth ?? 3);
+      const comments = flattenComments2(data[1]?.data.children ?? [], params.comment_depth ?? 3);
       return {
         post: {
           id: postData.id,
@@ -14449,6 +14590,77 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     }
   });
 
+  // src/tools/hide.ts
+  var hide = defineTool({
+    name: "hide",
+    displayName: "Hide/Unhide Post",
+    description: "Hide or unhide a post from your feed. Hidden posts no longer appear in listings but can be viewed directly.",
+    summary: "Hide or unhide a post",
+    icon: "eye-off",
+    group: "Actions",
+    input: external_exports.object({
+      id: external_exports.string().min(1).describe('Fullname of the post to hide (e.g., "t3_abc123")'),
+      unhide: external_exports.boolean().optional().describe("Set to true to unhide instead of hide (default: false)")
+    }),
+    output: external_exports.object({
+      success: external_exports.boolean().describe("Whether the action was successful")
+    }),
+    handle: async (params) => {
+      const endpoint = params.unhide ? "/api/unhide" : "/api/hide";
+      await redditPost(endpoint, { id: params.id });
+      return { success: true };
+    }
+  });
+
+  // src/tools/list-popular-subreddits.ts
+  var listPopularSubreddits = defineTool({
+    name: "list_popular_subreddits",
+    displayName: "List Popular Subreddits",
+    description: 'List popular, new, or default subreddits. Use category "popular" for most popular, "new" for newest, or "default" for default subreddits.',
+    summary: "List popular subreddits",
+    icon: "trending-up",
+    group: "Subreddits",
+    input: external_exports.object({
+      category: external_exports.enum(["popular", "new", "default"]).optional().describe('Subreddit category to list (default "popular")'),
+      limit: external_exports.number().int().min(1).max(100).optional().describe("Number of results (default 25, max 100)"),
+      after: external_exports.string().optional().describe("Pagination cursor for the next page")
+    }),
+    output: external_exports.object({
+      subreddits: external_exports.array(
+        external_exports.object({
+          display_name: external_exports.string().describe("Subreddit name"),
+          title: external_exports.string().describe("Subreddit title"),
+          subscribers: external_exports.number().describe("Subscriber count"),
+          active_user_count: external_exports.number().describe("Active users online"),
+          url: external_exports.string().describe("Subreddit URL path"),
+          public_description: external_exports.string().describe("Short description"),
+          over18: external_exports.boolean().describe("NSFW flag")
+        })
+      ).describe("Subreddits"),
+      after: external_exports.string().nullable().describe("Pagination cursor for next page")
+    }),
+    handle: async (params) => {
+      const category = params.category ?? "popular";
+      const queryParams = {
+        limit: String(params.limit ?? 25)
+      };
+      if (params.after) queryParams.after = params.after;
+      const data = await redditGet(`/subreddits/${category}.json`, queryParams);
+      return {
+        subreddits: data.data.children.map((child) => ({
+          display_name: child.data.display_name,
+          title: child.data.title,
+          subscribers: child.data.subscribers,
+          active_user_count: child.data.active_user_count ?? 0,
+          url: child.data.url,
+          public_description: child.data.public_description ?? "",
+          over18: child.data.over18
+        })),
+        after: data.data.after ?? null
+      };
+    }
+  });
+
   // src/tools/list-posts.ts
   var postSchema = external_exports.object({
     id: external_exports.string().describe("Post ID (without t3_ prefix)"),
@@ -14563,6 +14775,77 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     }
   });
 
+  // src/tools/list-user-content.ts
+  var contentItemSchema = external_exports.object({
+    kind: external_exports.string().describe('"t3" for post, "t1" for comment'),
+    id: external_exports.string().describe("Item ID"),
+    name: external_exports.string().describe("Item fullname"),
+    author: external_exports.string().describe("Author username"),
+    subreddit: external_exports.string().describe("Subreddit name"),
+    score: external_exports.number().describe("Score"),
+    created_utc: external_exports.number().describe("Creation timestamp"),
+    permalink: external_exports.string().describe("Reddit permalink"),
+    title: external_exports.string().nullable().describe("Post title (null for comments)"),
+    selftext: external_exports.string().nullable().describe("Post body (null for comments)"),
+    body: external_exports.string().nullable().describe("Comment body (null for posts)"),
+    link_title: external_exports.string().nullable().describe("Parent post title (for comments)"),
+    link_id: external_exports.string().nullable().describe("Parent post fullname, e.g. t3_abc123 (for comments)"),
+    parent_id: external_exports.string().nullable().describe("Parent comment/post fullname (for comments)"),
+    num_comments: external_exports.number().nullable().describe("Comment count (for posts)")
+  });
+  var listUserContent = defineTool({
+    name: "list_user_content",
+    displayName: "List User Content",
+    description: `Browse a user's posts, comments, or saved items. Use "submitted" for posts, "comments" for comments, "saved" for saved items (own profile only), "upvoted"/"downvoted" for voted items (own profile only), or "overview" for both posts and comments.`,
+    summary: "List a user's posts, comments, or saved items",
+    icon: "list",
+    group: "User",
+    input: external_exports.object({
+      username: external_exports.string().min(1).describe("Reddit username (without u/ prefix)"),
+      where: external_exports.enum(["overview", "submitted", "comments", "saved", "upvoted", "downvoted", "hidden", "gilded"]).describe("Content type to list"),
+      sort: external_exports.enum(["hot", "new", "top", "controversial"]).optional().describe('Sort order (default "new")'),
+      t: external_exports.enum(["hour", "day", "week", "month", "year", "all"]).optional().describe('Time period for "top" and "controversial" sort'),
+      limit: external_exports.number().int().min(1).max(100).optional().describe("Number of results (default 25, max 100)"),
+      after: external_exports.string().optional().describe("Pagination cursor for the next page")
+    }),
+    output: external_exports.object({
+      items: external_exports.array(contentItemSchema).describe("User content items"),
+      after: external_exports.string().nullable().describe("Pagination cursor for next page")
+    }),
+    handle: async (params) => {
+      const queryParams = {
+        limit: String(params.limit ?? 25)
+      };
+      if (params.sort) queryParams.sort = params.sort;
+      if (params.t) queryParams.t = params.t;
+      if (params.after) queryParams.after = params.after;
+      const data = await redditGet(
+        `/user/${params.username}/${params.where}.json`,
+        queryParams
+      );
+      return {
+        items: data.data.children.map((child) => ({
+          kind: child.kind,
+          id: child.data.id,
+          name: child.data.name,
+          author: child.data.author ?? "",
+          subreddit: child.data.subreddit ?? "",
+          score: child.data.score ?? 0,
+          created_utc: child.data.created_utc,
+          permalink: child.data.permalink,
+          title: child.data.title ?? null,
+          selftext: child.data.selftext ?? null,
+          body: child.data.body ?? null,
+          link_title: child.data.link_title ?? null,
+          link_id: child.data.link_id ?? null,
+          parent_id: child.data.parent_id ?? null,
+          num_comments: child.data.num_comments ?? null
+        })),
+        after: data.data.after ?? null
+      };
+    }
+  });
+
   // src/tools/read-inbox.ts
   var readInbox = defineTool({
     name: "read_inbox",
@@ -14614,6 +14897,30 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     }
   });
 
+  // src/tools/report.ts
+  var report = defineTool({
+    name: "report",
+    displayName: "Report",
+    description: "Report a post or comment to the subreddit moderators for rule violations.",
+    summary: "Report a post or comment",
+    icon: "flag",
+    group: "Actions",
+    input: external_exports.object({
+      thing_id: external_exports.string().min(1).describe('Fullname of the post or comment to report (e.g., "t3_abc123" or "t1_xyz")'),
+      reason: external_exports.string().min(1).describe("Reason for the report")
+    }),
+    output: external_exports.object({
+      success: external_exports.boolean().describe("Whether the report was submitted")
+    }),
+    handle: async (params) => {
+      await redditPost("/api/report", {
+        thing_id: params.thing_id,
+        reason: params.reason
+      });
+      return { success: true };
+    }
+  });
+
   // src/tools/save.ts
   var save = defineTool({
     name: "save",
@@ -14934,11 +15241,18 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       searchPosts,
       submitPost,
       submitComment,
+      getCommentThread,
+      editText,
+      deleteThing,
       vote,
       save,
+      hide,
+      report,
+      listUserContent,
       getSubreddit,
       searchSubreddits,
       listSubscriptions,
+      listPopularSubreddits,
       subscribe,
       getUser,
       sendMessage,
@@ -14957,7 +15271,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
   };
   var src_default = new RedditPlugin();
 
-  // dist/_adapter_entry_12b71574-e200-4403-8d14-7bb63132c2fd.ts
+  // dist/_adapter_entry_344d4fb8-80ec-4428-8e67-473b136c90be.ts
   if (!globalThis.__openTabs) {
     globalThis.__openTabs = {};
   } else {
@@ -15173,5 +15487,5 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     };
     delete src_default.onDeactivate;
   }
-})();(function(){var o=(globalThis).__openTabs;if(o&&o.adapters&&o.adapters["reddit"]){var a=o.adapters["reddit"];a.__adapterHash="b2ed9c82c456ebc9aa2d141756f608e0d830c57bbdbcffe8c0e4710f5b28f890";if(a.tools&&Array.isArray(a.tools)){for(var i=0;i<a.tools.length;i++){Object.freeze(a.tools[i]);}Object.freeze(a.tools);}Object.freeze(a);Object.defineProperty(o.adapters,"reddit",{value:a,writable:false,configurable:false,enumerable:true});Object.defineProperty(o,"adapters",{value:o.adapters,writable:false,configurable:false});}})();
+})();(function(){var o=(globalThis).__openTabs;if(o&&o.adapters&&o.adapters["reddit"]){var a=o.adapters["reddit"];a.__adapterHash="7dc28e95496e5caf6c03ada6f479afbdccadc333334653f591509dae45599c2f";if(a.tools&&Array.isArray(a.tools)){for(var i=0;i<a.tools.length;i++){Object.freeze(a.tools[i]);}Object.freeze(a.tools);}Object.freeze(a);Object.defineProperty(o.adapters,"reddit",{value:a,writable:false,configurable:false,enumerable:true});Object.defineProperty(o,"adapters",{value:o.adapters,writable:false,configurable:false});}})();
 //# sourceMappingURL=adapter.iife.js.map