@rnsk/toolkits 0.0.7 → 0.0.8

package/dist/toolkits/reddit/tools/index.d.ts

@@ -0,0 +1,355 @@
+import { redditCreatePost } from './create-post.js';
+import { redditDeleteComment } from './delete-comment.js';
+import { redditDeletePost } from './delete-post.js';
+import { redditEditCommentOrPost } from './edit-comment-or-post.js';
+import { redditGetListingBySort } from './get-listing-by-sort.js';
+import { redditGetControversialPosts } from './get-controversial-posts.js';
+import { redditGetUserPrefs } from './get-user-prefs.js';
+import { redditGetRandomPost } from './get-random-post.js';
+import { redditGetUserAbout } from './get-user-about.js';
+import { redditGetOauthScopes } from './get-oauth-scopes.js';
+import { redditGetSubredditRules } from './get-subreddit-rules.js';
+import { redditSearchSubreddits } from './search-subreddits.js';
+import { redditGetUserFlair } from './get-user-flair.js';
+import { redditCheckUsernameAvailable } from './check-username-available.js';
+import { redditListSubredditPostFlairs } from './list-subreddit-post-flairs.js';
+import { redditPostComment } from './post-comment.js';
+import { redditRetrievePostComments } from './retrieve-post-comments.js';
+import { redditRetrievePostsFromSubreddit } from './retrieve-posts-from-subreddit.js';
+import { redditRetrieveSpecificCommentOrPost } from './retrieve-specific-comment-or-post.js';
+import { redditSearchAcrossSubreddits } from './search-across-subreddits.js';
+import { redditToggleInboxReplies } from './toggle-inbox-replies.js';
+export { redditCreatePost, redditDeleteComment, redditDeletePost, redditEditCommentOrPost, redditGetListingBySort, redditGetControversialPosts, redditGetUserPrefs, redditGetRandomPost, redditGetUserAbout, redditGetOauthScopes, redditGetSubredditRules, redditSearchSubreddits, redditGetUserFlair, redditCheckUsernameAvailable, redditListSubredditPostFlairs, redditPostComment, redditRetrievePostComments, redditRetrievePostsFromSubreddit, redditRetrieveSpecificCommentOrPost, redditSearchAcrossSubreddits, redditToggleInboxReplies, };
+export declare const redditTools: ({
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        title: string;
+        subreddit: string;
+        url?: string | undefined;
+        text?: string | undefined;
+        kind?: "link" | "self" | undefined;
+        redditToken?: string | undefined;
+        flairId?: string | undefined;
+    }, any>;
+    requiredAuth: "redditToken";
+    scope: "write";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        id: string;
+        redditToken?: string | undefined;
+    }, {
+        error: string;
+        success?: undefined;
+        id?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        success: boolean;
+        id: string;
+        error?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        details: any;
+        success?: undefined;
+        id?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        success?: undefined;
+        id?: undefined;
+        details?: undefined;
+    }>;
+    requiredAuth: "redditToken";
+    scope: "delete";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        text: string;
+        thingId: string;
+        redditToken?: string | undefined;
+    }, any>;
+    requiredAuth: "redditToken";
+    scope: "write";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        sort: "new" | "hot" | "top" | "rising" | "controversial" | "best";
+        limit: number;
+        count?: number | undefined;
+        show?: string | undefined;
+        before?: string | undefined;
+        after?: string | undefined;
+        redditToken?: string | undefined;
+        timeFilter?: "all" | "year" | "month" | "day" | "hour" | "week" | undefined;
+    }, any>;
+    requiredAuth: "redditToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        limit: number;
+        timeFilter: "all" | "year" | "month" | "day" | "hour" | "week";
+        count?: number | undefined;
+        show?: string | undefined;
+        before?: string | undefined;
+        after?: string | undefined;
+        redditToken?: string | undefined;
+    }, any>;
+    requiredAuth: "redditToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        fields?: string | undefined;
+        redditToken?: string | undefined;
+    }, any>;
+    requiredAuth: "redditToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        redditToken?: string | undefined;
+        subreddit?: string | undefined;
+    }, any>;
+    requiredAuth: "redditToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        username: string;
+        redditToken?: string | undefined;
+    }, any>;
+    requiredAuth: "redditToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        redditToken?: string | undefined;
+    }, any>;
+    requiredAuth: "redditToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        subreddit: string;
+        redditToken?: string | undefined;
+    }, any>;
+    requiredAuth: "redditToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        query: string;
+        sort: "activity" | "relevance";
+        limit: number;
+        count?: number | undefined;
+        show?: string | undefined;
+        before?: string | undefined;
+        after?: string | undefined;
+        redditToken?: string | undefined;
+        showUsers?: boolean | undefined;
+    }, any>;
+    requiredAuth: "redditToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        subreddit: string;
+        limit?: number | undefined;
+        before?: string | undefined;
+        after?: string | undefined;
+        redditToken?: string | undefined;
+    }, any>;
+    requiredAuth: "redditToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        username: string;
+        redditToken?: string | undefined;
+    }, {
+        error: string;
+        username?: undefined;
+        available?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        username: string;
+        available: boolean;
+        error?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        details: any;
+        username?: undefined;
+        available?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        username?: undefined;
+        available?: undefined;
+        details?: undefined;
+    }>;
+    requiredAuth: "redditToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        subreddit: string;
+        redditToken?: string | undefined;
+    }, {
+        error: string;
+        flairs?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        flairs: any;
+        error?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        details: any;
+        flairs?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        flairs?: undefined;
+        details?: undefined;
+    }>;
+    requiredAuth: "redditToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        article: string;
+        sort?: "random" | "new" | "top" | "controversial" | "confidence" | "old" | "qa" | "live" | undefined;
+        limit?: number | undefined;
+        depth?: number | undefined;
+        redditToken?: string | undefined;
+    }, any>;
+    requiredAuth: "redditToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        sort: "new" | "hot" | "top" | "rising" | "controversial";
+        maxResults: number;
+        subreddit: string;
+        count?: number | undefined;
+        show?: string | undefined;
+        before?: string | undefined;
+        after?: string | undefined;
+        redditToken?: string | undefined;
+        timeFilter?: "all" | "year" | "month" | "day" | "hour" | "week" | undefined;
+    }, any>;
+    requiredAuth: "redditToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        id: string;
+        redditToken?: string | undefined;
+    }, {
+        error: string;
+        things?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        things: any;
+        error?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        details: any;
+        things?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        things?: undefined;
+        details?: undefined;
+    }>;
+    requiredAuth: "redditToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        sort: "new" | "comments" | "relevance" | "hot" | "top";
+        limit: number;
+        searchQuery: string;
+        restrictSr: boolean;
+        before?: string | undefined;
+        after?: string | undefined;
+        redditToken?: string | undefined;
+        timeFilter?: "all" | "year" | "month" | "day" | "hour" | "week" | undefined;
+        resultType?: ("user" | "link" | "sr")[] | undefined;
+    }, any>;
+    requiredAuth: "redditToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        id: string;
+        state: boolean;
+        redditToken?: string | undefined;
+    }, {
+        error: string;
+        success?: undefined;
+        id?: undefined;
+        state?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        success: boolean;
+        id: string;
+        state: boolean;
+        error?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        details: any;
+        success?: undefined;
+        id?: undefined;
+        state?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        success?: undefined;
+        id?: undefined;
+        state?: undefined;
+        details?: undefined;
+    }>;
+    requiredAuth: "redditToken";
+    scope: "write";
+})[];
+//# sourceMappingURL=index.d.ts.map

package/dist/toolkits/reddit/tools/index.js

@@ -0,0 +1,173 @@
+// @ts-nocheck
+import { redditCreatePost } from './create-post.js';
+import { redditDeleteComment } from './delete-comment.js';
+import { redditDeletePost } from './delete-post.js';
+import { redditEditCommentOrPost } from './edit-comment-or-post.js';
+import { redditGetListingBySort } from './get-listing-by-sort.js';
+import { redditGetControversialPosts } from './get-controversial-posts.js';
+import { redditGetUserPrefs } from './get-user-prefs.js';
+import { redditGetRandomPost } from './get-random-post.js';
+import { redditGetUserAbout } from './get-user-about.js';
+import { redditGetOauthScopes } from './get-oauth-scopes.js';
+import { redditGetSubredditRules } from './get-subreddit-rules.js';
+import { redditSearchSubreddits } from './search-subreddits.js';
+import { redditGetUserFlair } from './get-user-flair.js';
+import { redditCheckUsernameAvailable } from './check-username-available.js';
+import { redditListSubredditPostFlairs } from './list-subreddit-post-flairs.js';
+import { redditPostComment } from './post-comment.js';
+import { redditRetrievePostComments } from './retrieve-post-comments.js';
+import { redditRetrievePostsFromSubreddit } from './retrieve-posts-from-subreddit.js';
+import { redditRetrieveSpecificCommentOrPost } from './retrieve-specific-comment-or-post.js';
+import { redditSearchAcrossSubreddits } from './search-across-subreddits.js';
+import { redditToggleInboxReplies } from './toggle-inbox-replies.js';
+export { redditCreatePost, redditDeleteComment, redditDeletePost, redditEditCommentOrPost, redditGetListingBySort, redditGetControversialPosts, redditGetUserPrefs, redditGetRandomPost, redditGetUserAbout, redditGetOauthScopes, redditGetSubredditRules, redditSearchSubreddits, redditGetUserFlair, redditCheckUsernameAvailable, redditListSubredditPostFlairs, redditPostComment, redditRetrievePostComments, redditRetrievePostsFromSubreddit, redditRetrieveSpecificCommentOrPost, redditSearchAcrossSubreddits, redditToggleInboxReplies, };
+export const redditTools = [
+    {
+        name: 'redditCreatePost',
+        description: redditCreatePost.description,
+        tool: redditCreatePost,
+        requiredAuth: 'redditToken',
+        scope: 'write',
+    },
+    {
+        name: 'redditDeleteComment',
+        description: redditDeleteComment.description,
+        tool: redditDeleteComment,
+        requiredAuth: 'redditToken',
+        scope: 'delete',
+    },
+    {
+        name: 'redditDeletePost',
+        description: redditDeletePost.description,
+        tool: redditDeletePost,
+        requiredAuth: 'redditToken',
+        scope: 'delete',
+    },
+    {
+        name: 'redditEditCommentOrPost',
+        description: redditEditCommentOrPost.description,
+        tool: redditEditCommentOrPost,
+        requiredAuth: 'redditToken',
+        scope: 'write',
+    },
+    {
+        name: 'redditGetListingBySort',
+        description: redditGetListingBySort.description,
+        tool: redditGetListingBySort,
+        requiredAuth: 'redditToken',
+        scope: 'read',
+    },
+    {
+        name: 'redditGetControversialPosts',
+        description: redditGetControversialPosts.description,
+        tool: redditGetControversialPosts,
+        requiredAuth: 'redditToken',
+        scope: 'read',
+    },
+    {
+        name: 'redditGetUserPrefs',
+        description: redditGetUserPrefs.description,
+        tool: redditGetUserPrefs,
+        requiredAuth: 'redditToken',
+        scope: 'read',
+    },
+    {
+        name: 'redditGetRandomPost',
+        description: redditGetRandomPost.description,
+        tool: redditGetRandomPost,
+        requiredAuth: 'redditToken',
+        scope: 'read',
+    },
+    {
+        name: 'redditGetUserAbout',
+        description: redditGetUserAbout.description,
+        tool: redditGetUserAbout,
+        requiredAuth: 'redditToken',
+        scope: 'read',
+    },
+    {
+        name: 'redditGetOauthScopes',
+        description: redditGetOauthScopes.description,
+        tool: redditGetOauthScopes,
+        requiredAuth: 'redditToken',
+        scope: 'read',
+    },
+    {
+        name: 'redditGetSubredditRules',
+        description: redditGetSubredditRules.description,
+        tool: redditGetSubredditRules,
+        requiredAuth: 'redditToken',
+        scope: 'read',
+    },
+    {
+        name: 'redditSearchSubreddits',
+        description: redditSearchSubreddits.description,
+        tool: redditSearchSubreddits,
+        requiredAuth: 'redditToken',
+        scope: 'read',
+    },
+    {
+        name: 'redditGetUserFlair',
+        description: redditGetUserFlair.description,
+        tool: redditGetUserFlair,
+        requiredAuth: 'redditToken',
+        scope: 'read',
+    },
+    {
+        name: 'redditCheckUsernameAvailable',
+        description: redditCheckUsernameAvailable.description,
+        tool: redditCheckUsernameAvailable,
+        requiredAuth: 'redditToken',
+        scope: 'read',
+    },
+    {
+        name: 'redditListSubredditPostFlairs',
+        description: redditListSubredditPostFlairs.description,
+        tool: redditListSubredditPostFlairs,
+        requiredAuth: 'redditToken',
+        scope: 'read',
+    },
+    {
+        name: 'redditPostComment',
+        description: redditPostComment.description,
+        tool: redditPostComment,
+        requiredAuth: 'redditToken',
+        scope: 'write',
+    },
+    {
+        name: 'redditRetrievePostComments',
+        description: redditRetrievePostComments.description,
+        tool: redditRetrievePostComments,
+        requiredAuth: 'redditToken',
+        scope: 'read',
+    },
+    {
+        name: 'redditRetrievePostsFromSubreddit',
+        description: redditRetrievePostsFromSubreddit.description,
+        tool: redditRetrievePostsFromSubreddit,
+        requiredAuth: 'redditToken',
+        scope: 'read',
+    },
+    {
+        name: 'redditRetrieveSpecificCommentOrPost',
+        description: redditRetrieveSpecificCommentOrPost.description,
+        tool: redditRetrieveSpecificCommentOrPost,
+        requiredAuth: 'redditToken',
+        scope: 'read',
+    },
+    {
+        name: 'redditSearchAcrossSubreddits',
+        description: redditSearchAcrossSubreddits.description,
+        tool: redditSearchAcrossSubreddits,
+        requiredAuth: 'redditToken',
+        scope: 'read',
+    },
+    {
+        name: 'redditToggleInboxReplies',
+        description: redditToggleInboxReplies.description,
+        tool: redditToggleInboxReplies,
+        requiredAuth: 'redditToken',
+        scope: 'write',
+    },
+];
+//# sourceMappingURL=index.js.map

package/dist/toolkits/reddit/tools/list-subreddit-post-flairs.d.ts

@@ -0,0 +1,25 @@
+export declare const redditListSubredditPostFlairs: import("ai").Tool<{
+    subreddit: string;
+    redditToken?: string | undefined;
+}, {
+    error: string;
+    flairs?: undefined;
+    details?: undefined;
+    message?: undefined;
+} | {
+    flairs: any;
+    error?: undefined;
+    details?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    details: any;
+    flairs?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    flairs?: undefined;
+    details?: undefined;
+}>;
+//# sourceMappingURL=list-subreddit-post-flairs.d.ts.map

package/dist/toolkits/reddit/tools/list-subreddit-post-flairs.js

@@ -0,0 +1,30 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { redditGet } from './client.js';
+export const redditListSubredditPostFlairs = tool({
+    description: 'List available link/post flair templates for a subreddit, including flair_template_id values. Use before redditCreatePost when the subreddit requires or supports flair.',
+    inputSchema: z.object({
+        redditToken: z.string().optional().describe('Injected by system; do not provide'),
+        subreddit: z.string().describe("Subreddit name without the 'r/' prefix, e.g. 'learnpython'"),
+    }),
+    execute: async ({ redditToken, subreddit }) => {
+        try {
+            if (!redditToken) {
+                return { error: 'Reddit token is required. Connect Reddit first.' };
+            }
+            const flairs = await redditGet(redditToken, `/r/${subreddit}/api/link_flair_v2`);
+            return { flairs };
+        }
+        catch (error) {
+            if (error?.details !== undefined) {
+                return { error: 'Failed to list subreddit post flairs', details: error.details };
+            }
+            return {
+                error: 'Error listing subreddit post flairs',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=list-subreddit-post-flairs.js.map

package/dist/toolkits/reddit/tools/post-comment.d.ts

@@ -0,0 +1,6 @@
+export declare const redditPostComment: import("ai").Tool<{
+    text: string;
+    thingId: string;
+    redditToken?: string | undefined;
+}, any>;
+//# sourceMappingURL=post-comment.d.ts.map

package/dist/toolkits/reddit/tools/post-comment.js

@@ -0,0 +1,35 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { redditPost, throwIfJsonErrors } from './client.js';
+export const redditPostComment = tool({
+    description: 'Post a comment replying to a submission (t3_ ID) or another comment (t1_ ID). Publishes immediately and publicly — confirm target and text first. Fails on locked or archived threads; honor any RATELIMIT cooldown before retrying.',
+    inputSchema: z.object({
+        redditToken: z.string().optional().describe('Injected by system; do not provide'),
+        thingId: z.string().describe("Parent post (t3_) or comment (t1_) fullname ID, e.g. 't3_10omtdx'"),
+        text: z.string().describe('Raw markdown text of the comment'),
+    }),
+    execute: async ({ redditToken, thingId, text }) => {
+        try {
+            if (!redditToken) {
+                return { error: 'Reddit token is required. Connect Reddit first.' };
+            }
+            const data = await redditPost(redditToken, '/api/comment', {
+                thing_id: thingId,
+                text,
+            });
+            throwIfJsonErrors(data, 'Post comment');
+            return data;
+        }
+        catch (error) {
+            if (error?.details !== undefined) {
+                return { error: 'Failed to post Reddit comment', details: error.details };
+            }
+            return {
+                error: 'Error posting Reddit comment',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=post-comment.js.map

package/dist/toolkits/reddit/tools/retrieve-post-comments.d.ts

@@ -0,0 +1,8 @@
+export declare const redditRetrievePostComments: import("ai").Tool<{
+    article: string;
+    sort?: "random" | "new" | "top" | "controversial" | "confidence" | "old" | "qa" | "live" | undefined;
+    limit?: number | undefined;
+    depth?: number | undefined;
+    redditToken?: string | undefined;
+}, any>;
+//# sourceMappingURL=retrieve-post-comments.d.ts.map

package/dist/toolkits/reddit/tools/retrieve-post-comments.js

@@ -0,0 +1,39 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { redditGet } from './client.js';
+export const redditRetrievePostComments = tool({
+    description: 'Get comments for a post by its base-36 article ID (without the t3_ prefix). The response is a two-element array: post metadata first, then comments with nested replies under each comment\'s replies field. Filter out bodies that are [deleted] or [removed].',
+    inputSchema: z.object({
+        redditToken: z.string().optional().describe('Injected by system; do not provide'),
+        article: z.string().describe("Base-36 post ID without the 't3_' prefix, e.g. 'q5u7q5'"),
+        sort: z
+            .enum(['confidence', 'top', 'new', 'controversial', 'old', 'random', 'qa', 'live'])
+            .optional()
+            .describe('Comment sort order'),
+        limit: z.number().min(1).optional().describe('Max comments to return'),
+        depth: z.number().min(0).optional().describe('Max nesting depth of the reply tree'),
+    }),
+    execute: async ({ redditToken, article, sort, limit, depth }) => {
+        try {
+            if (!redditToken) {
+                return { error: 'Reddit token is required. Connect Reddit first.' };
+            }
+            const data = await redditGet(redditToken, `/comments/${article}`, { sort, limit, depth });
+            if (!Array.isArray(data) || data.length < 2) {
+                return data;
+            }
+            return { postListing: data[0], commentsListing: data[1] };
+        }
+        catch (error) {
+            if (error?.details !== undefined) {
+                return { error: 'Failed to retrieve post comments', details: error.details };
+            }
+            return {
+                error: 'Error retrieving post comments',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=retrieve-post-comments.js.map

package/dist/toolkits/reddit/tools/retrieve-posts-from-subreddit.d.ts

@@ -0,0 +1,12 @@
+export declare const redditRetrievePostsFromSubreddit: import("ai").Tool<{
+    sort: "new" | "hot" | "top" | "rising" | "controversial";
+    maxResults: number;
+    subreddit: string;
+    count?: number | undefined;
+    show?: string | undefined;
+    before?: string | undefined;
+    after?: string | undefined;
+    redditToken?: string | undefined;
+    timeFilter?: "all" | "year" | "month" | "day" | "hour" | "week" | undefined;
+}, any>;
+//# sourceMappingURL=retrieve-posts-from-subreddit.d.ts.map