@rnsk/toolkits 0.0.9 → 0.0.11

package/dist/toolkits/dev-to/tools/community.js

@@ -0,0 +1,244 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { devToRequest, toDevToError, requireApiKey } from './client.js';
+const apiKeyField = z.string().optional().describe('Injected by system; do not provide');
+const paginationFields = {
+    page: z.number().int().min(1).optional().describe('Page number for pagination'),
+    perPage: z.number().int().min(1).optional().describe('Number of items per page'),
+};
+export const devToGetComment = tool({
+    description: 'Get a single comment and its nested replies by comment ID code (e.g. "32k5a").',
+    inputSchema: z.object({
+        devToApiKey: apiKeyField,
+        id: z.string().describe('The comment ID code'),
+    }),
+    execute: async ({ devToApiKey, id }) => {
+        try {
+            return await devToRequest(devToApiKey, 'GET', `/comments/${encodeURIComponent(id)}`);
+        }
+        catch (error) {
+            return toDevToError(error, 'Failed to get comment');
+        }
+    },
+});
+export const devToListComments = tool({
+    description: 'List threaded comments for an article or a podcast episode. Provide articleId or podcastEpisodeId, not both.',
+    inputSchema: z.object({
+        devToApiKey: apiKeyField,
+        articleId: z.number().int().optional().describe('Article ID to get comments for'),
+        podcastEpisodeId: z.number().int().optional().describe('Podcast episode ID to get comments for'),
+    }),
+    execute: async ({ devToApiKey, articleId, podcastEpisodeId }) => {
+        try {
+            const query = {};
+            if (articleId !== undefined)
+                query.a_id = articleId;
+            if (podcastEpisodeId !== undefined)
+                query.p_id = podcastEpisodeId;
+            return await devToRequest(devToApiKey, 'GET', '/comments', { query });
+        }
+        catch (error) {
+            return toDevToError(error, 'Failed to list comments');
+        }
+    },
+});
+export const devToGetCurrentUser = tool({
+    description: "Get the authenticated user's profile information.",
+    inputSchema: z.object({
+        devToApiKey: apiKeyField,
+    }),
+    execute: async ({ devToApiKey }) => {
+        const missing = requireApiKey(devToApiKey);
+        if (missing)
+            return missing;
+        try {
+            return await devToRequest(devToApiKey, 'GET', '/users/me');
+        }
+        catch (error) {
+            return toDevToError(error, 'Failed to get current user');
+        }
+    },
+});
+export const devToGetUser = tool({
+    description: 'Get a single user by numeric ID or username.',
+    inputSchema: z.object({
+        devToApiKey: apiKeyField,
+        id: z.string().describe("Numeric user ID (e.g. '1') or username (e.g. 'ben')"),
+    }),
+    execute: async ({ devToApiKey, id }) => {
+        try {
+            return await devToRequest(devToApiKey, 'GET', `/users/${encodeURIComponent(id)}`);
+        }
+        catch (error) {
+            return toDevToError(error, 'Failed to get user');
+        }
+    },
+});
+export const devToGetOrganization = tool({
+    description: 'Get a single organization by username, including summary, links, and profile image.',
+    inputSchema: z.object({
+        devToApiKey: apiKeyField,
+        username: z.string().describe("The organization's username (e.g. 'devteam')"),
+    }),
+    execute: async ({ devToApiKey, username }) => {
+        try {
+            return await devToRequest(devToApiKey, 'GET', `/organizations/${encodeURIComponent(username)}`);
+        }
+        catch (error) {
+            return toDevToError(error, 'Failed to get organization');
+        }
+    },
+});
+export const devToListOrganizationUsers = tool({
+    description: 'List member users of a specific organization.',
+    inputSchema: z.object({
+        devToApiKey: apiKeyField,
+        username: z.string().describe("The organization's username"),
+        ...paginationFields,
+    }),
+    execute: async ({ devToApiKey, username, perPage, ...rest }) => {
+        try {
+            const query = { ...rest };
+            if (perPage !== undefined)
+                query.per_page = perPage;
+            return await devToRequest(devToApiKey, 'GET', `/organizations/${encodeURIComponent(username)}/users`, {
+                query,
+            });
+        }
+        catch (error) {
+            return toDevToError(error, 'Failed to list organization users');
+        }
+    },
+});
+export const devToGetProfileImage = tool({
+    description: 'Get the full-size and 90px profile image URLs for a user or organization by username.',
+    inputSchema: z.object({
+        devToApiKey: apiKeyField,
+        username: z.string().describe('The username of the user or organization'),
+    }),
+    execute: async ({ devToApiKey, username }) => {
+        try {
+            return await devToRequest(devToApiKey, 'GET', `/profile_images/${encodeURIComponent(username)}`);
+        }
+        catch (error) {
+            return toDevToError(error, 'Failed to get profile image');
+        }
+    },
+});
+export const devToListTags = tool({
+    description: 'List tags used on DEV Community ordered by popularity. Useful for discovery and autocomplete.',
+    inputSchema: z.object({
+        devToApiKey: apiKeyField,
+        ...paginationFields,
+    }),
+    execute: async ({ devToApiKey, perPage, ...rest }) => {
+        try {
+            const query = { ...rest };
+            if (perPage !== undefined)
+                query.per_page = perPage;
+            return await devToRequest(devToApiKey, 'GET', '/tags', { query });
+        }
+        catch (error) {
+            return toDevToError(error, 'Failed to list tags');
+        }
+    },
+});
+export const devToListFollowedTags = tool({
+    description: 'List tags followed by the authenticated user, with IDs and points.',
+    inputSchema: z.object({
+        devToApiKey: apiKeyField,
+    }),
+    execute: async ({ devToApiKey }) => {
+        const missing = requireApiKey(devToApiKey);
+        if (missing)
+            return missing;
+        try {
+            return await devToRequest(devToApiKey, 'GET', '/follows/tags');
+        }
+        catch (error) {
+            return toDevToError(error, 'Failed to list followed tags');
+        }
+    },
+});
+export const devToListFollowers = tool({
+    description: 'List users who follow the authenticated user. 80 followers per page by default.',
+    inputSchema: z.object({
+        devToApiKey: apiKeyField,
+        sort: z.string().optional().describe("Sort order, e.g. 'created_at' for newest first"),
+        ...paginationFields,
+    }),
+    execute: async ({ devToApiKey, perPage, ...rest }) => {
+        const missing = requireApiKey(devToApiKey);
+        if (missing)
+            return missing;
+        try {
+            const query = { ...rest };
+            if (perPage !== undefined)
+                query.per_page = perPage;
+            return await devToRequest(devToApiKey, 'GET', '/followers/users', { query });
+        }
+        catch (error) {
+            return toDevToError(error, 'Failed to list followers');
+        }
+    },
+});
+export const devToListPodcastEpisodes = tool({
+    description: 'List podcast episodes, optionally filtered by podcast username.',
+    inputSchema: z.object({
+        devToApiKey: apiKeyField,
+        username: z.string().optional().describe('Filter by podcast username/slug (e.g. codenewbie)'),
+        ...paginationFields,
+    }),
+    execute: async ({ devToApiKey, perPage, ...rest }) => {
+        try {
+            const query = { ...rest };
+            if (perPage !== undefined)
+                query.per_page = perPage;
+            return await devToRequest(devToApiKey, 'GET', '/podcast_episodes', { query });
+        }
+        catch (error) {
+            return toDevToError(error, 'Failed to list podcast episodes');
+        }
+    },
+});
+export const devToListReadingList = tool({
+    description: "List articles saved to the authenticated user's reading list.",
+    inputSchema: z.object({
+        devToApiKey: apiKeyField,
+        ...paginationFields,
+    }),
+    execute: async ({ devToApiKey, perPage, ...rest }) => {
+        const missing = requireApiKey(devToApiKey);
+        if (missing)
+            return missing;
+        try {
+            const query = { ...rest };
+            if (perPage !== undefined)
+                query.per_page = perPage;
+            return await devToRequest(devToApiKey, 'GET', '/readinglist', { query });
+        }
+        catch (error) {
+            return toDevToError(error, 'Failed to list reading list');
+        }
+    },
+});
+export const devToListVideos = tool({
+    description: 'List articles on DEV Community that contain videos.',
+    inputSchema: z.object({
+        devToApiKey: apiKeyField,
+        ...paginationFields,
+    }),
+    execute: async ({ devToApiKey, perPage, ...rest }) => {
+        try {
+            const query = { ...rest };
+            if (perPage !== undefined)
+                query.per_page = perPage;
+            return await devToRequest(devToApiKey, 'GET', '/videos', { query });
+        }
+        catch (error) {
+            return toDevToError(error, 'Failed to list videos');
+        }
+    },
+});
+//# sourceMappingURL=community.js.map

package/dist/toolkits/dev-to/tools/index.d.ts

@@ -0,0 +1,202 @@
+import { devToCreateArticle, devToGetArticle, devToGetArticleByPath, devToListArticles, devToListLatestArticles, devToListUserArticles, devToListUserPublishedArticles, devToListUserUnpublishedArticles, devToListUserAllArticles, devToListOrganizationArticles, devToUpdateArticle } from './articles.js';
+import { devToGetComment, devToListComments, devToGetCurrentUser, devToGetUser, devToGetOrganization, devToListOrganizationUsers, devToGetProfileImage, devToListTags, devToListFollowedTags, devToListFollowers, devToListPodcastEpisodes, devToListReadingList, devToListVideos } from './community.js';
+import { devToGetListing, devToListListings, devToListListingsByCategory, devToUpdateListing } from './listings.js';
+export { devToCreateArticle, devToGetArticle, devToGetArticleByPath, devToListArticles, devToListLatestArticles, devToListUserArticles, devToListUserPublishedArticles, devToListUserUnpublishedArticles, devToListUserAllArticles, devToListOrganizationArticles, devToUpdateArticle, devToGetComment, devToListComments, devToGetCurrentUser, devToGetUser, devToGetOrganization, devToListOrganizationUsers, devToGetProfileImage, devToListTags, devToListFollowedTags, devToListFollowers, devToListPodcastEpisodes, devToListReadingList, devToListVideos, devToGetListing, devToListListings, devToListListingsByCategory, devToUpdateListing, };
+export declare const devToTools: ({
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        title: string;
+        bodyMarkdown: string;
+        description?: string | undefined;
+        published?: boolean | undefined;
+        tags?: string[] | undefined;
+        series?: string | undefined;
+        organizationId?: number | undefined;
+        devToApiKey?: string | undefined;
+        mainImage?: string | undefined;
+        canonicalUrl?: string | undefined;
+    }, any>;
+    requiredAuth: "devToApiKey";
+    scope: "write";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        id: number;
+        devToApiKey?: string | undefined;
+    }, any>;
+    scope: "read";
+    requiredAuth?: undefined;
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        username: string;
+        slug: string;
+        devToApiKey?: string | undefined;
+    }, any>;
+    scope: "read";
+    requiredAuth?: undefined;
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        perPage?: number | undefined;
+        page?: number | undefined;
+        username?: string | undefined;
+        state?: "all" | "rising" | "fresh" | undefined;
+        tags?: string | undefined;
+        collectionId?: number | undefined;
+        tag?: string | undefined;
+        top?: number | undefined;
+        devToApiKey?: string | undefined;
+        tagsExclude?: string | undefined;
+    }, any>;
+    scope: "read";
+    requiredAuth?: undefined;
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        perPage?: number | undefined;
+        page?: number | undefined;
+        devToApiKey?: string | undefined;
+    }, any>;
+    scope: "read";
+    requiredAuth?: undefined;
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        perPage?: number | undefined;
+        page?: number | undefined;
+        devToApiKey?: string | undefined;
+    }, any>;
+    requiredAuth: "devToApiKey";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        username: string;
+        perPage?: number | undefined;
+        page?: number | undefined;
+        devToApiKey?: string | undefined;
+    }, any>;
+    scope: "read";
+    requiredAuth?: undefined;
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        id: number;
+        description?: string | undefined;
+        title?: string | undefined;
+        published?: boolean | undefined;
+        tags?: string[] | undefined;
+        series?: string | undefined;
+        organizationId?: number | undefined;
+        devToApiKey?: string | undefined;
+        bodyMarkdown?: string | undefined;
+        mainImage?: string | undefined;
+        canonicalUrl?: string | undefined;
+    }, any>;
+    requiredAuth: "devToApiKey";
+    scope: "write";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        id: string;
+        devToApiKey?: string | undefined;
+    }, any>;
+    scope: "read";
+    requiredAuth?: undefined;
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        articleId?: number | undefined;
+        devToApiKey?: string | undefined;
+        podcastEpisodeId?: number | undefined;
+    }, any>;
+    scope: "read";
+    requiredAuth?: undefined;
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        devToApiKey?: string | undefined;
+    }, any>;
+    requiredAuth: "devToApiKey";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        username: string;
+        devToApiKey?: string | undefined;
+    }, any>;
+    scope: "read";
+    requiredAuth?: undefined;
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        sort?: string | undefined;
+        perPage?: number | undefined;
+        page?: number | undefined;
+        devToApiKey?: string | undefined;
+    }, any>;
+    requiredAuth: "devToApiKey";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        perPage?: number | undefined;
+        page?: number | undefined;
+        username?: string | undefined;
+        devToApiKey?: string | undefined;
+    }, any>;
+    scope: "read";
+    requiredAuth?: undefined;
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        perPage?: number | undefined;
+        page?: number | undefined;
+        category?: "events" | "cfp" | "education" | "jobs" | "mentors" | "products" | "mentees" | "forsale" | "collabs" | "misc" | undefined;
+        devToApiKey?: string | undefined;
+    }, any>;
+    scope: "read";
+    requiredAuth?: undefined;
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        category: "events" | "cfp" | "education" | "jobs" | "mentors" | "products" | "mentees" | "forsale" | "collabs" | "misc";
+        perPage?: number | undefined;
+        page?: number | undefined;
+        devToApiKey?: string | undefined;
+    }, any>;
+    scope: "read";
+    requiredAuth?: undefined;
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        id: number;
+        title?: string | undefined;
+        action?: string | undefined;
+        tags?: string[] | undefined;
+        category?: string | undefined;
+        devToApiKey?: string | undefined;
+        bodyMarkdown?: string | undefined;
+    }, any>;
+    requiredAuth: "devToApiKey";
+    scope: "write";
+})[];
+//# sourceMappingURL=index.d.ts.map

package/dist/toolkits/dev-to/tools/index.js

@@ -0,0 +1,37 @@
+// @ts-nocheck
+import { devToCreateArticle, devToGetArticle, devToGetArticleByPath, devToListArticles, devToListLatestArticles, devToListUserArticles, devToListUserPublishedArticles, devToListUserUnpublishedArticles, devToListUserAllArticles, devToListOrganizationArticles, devToUpdateArticle, } from './articles.js';
+import { devToGetComment, devToListComments, devToGetCurrentUser, devToGetUser, devToGetOrganization, devToListOrganizationUsers, devToGetProfileImage, devToListTags, devToListFollowedTags, devToListFollowers, devToListPodcastEpisodes, devToListReadingList, devToListVideos, } from './community.js';
+import { devToGetListing, devToListListings, devToListListingsByCategory, devToUpdateListing, } from './listings.js';
+export { devToCreateArticle, devToGetArticle, devToGetArticleByPath, devToListArticles, devToListLatestArticles, devToListUserArticles, devToListUserPublishedArticles, devToListUserUnpublishedArticles, devToListUserAllArticles, devToListOrganizationArticles, devToUpdateArticle, devToGetComment, devToListComments, devToGetCurrentUser, devToGetUser, devToGetOrganization, devToListOrganizationUsers, devToGetProfileImage, devToListTags, devToListFollowedTags, devToListFollowers, devToListPodcastEpisodes, devToListReadingList, devToListVideos, devToGetListing, devToListListings, devToListListingsByCategory, devToUpdateListing, };
+const authed = 'devToApiKey';
+export const devToTools = [
+    { name: 'devToCreateArticle', description: devToCreateArticle.description, tool: devToCreateArticle, requiredAuth: authed, scope: 'write' },
+    { name: 'devToGetArticle', description: devToGetArticle.description, tool: devToGetArticle, scope: 'read' },
+    { name: 'devToGetArticleByPath', description: devToGetArticleByPath.description, tool: devToGetArticleByPath, scope: 'read' },
+    { name: 'devToListArticles', description: devToListArticles.description, tool: devToListArticles, scope: 'read' },
+    { name: 'devToListLatestArticles', description: devToListLatestArticles.description, tool: devToListLatestArticles, scope: 'read' },
+    { name: 'devToListUserArticles', description: devToListUserArticles.description, tool: devToListUserArticles, requiredAuth: authed, scope: 'read' },
+    { name: 'devToListUserPublishedArticles', description: devToListUserPublishedArticles.description, tool: devToListUserPublishedArticles, requiredAuth: authed, scope: 'read' },
+    { name: 'devToListUserUnpublishedArticles', description: devToListUserUnpublishedArticles.description, tool: devToListUserUnpublishedArticles, requiredAuth: authed, scope: 'read' },
+    { name: 'devToListUserAllArticles', description: devToListUserAllArticles.description, tool: devToListUserAllArticles, requiredAuth: authed, scope: 'read' },
+    { name: 'devToListOrganizationArticles', description: devToListOrganizationArticles.description, tool: devToListOrganizationArticles, scope: 'read' },
+    { name: 'devToUpdateArticle', description: devToUpdateArticle.description, tool: devToUpdateArticle, requiredAuth: authed, scope: 'write' },
+    { name: 'devToGetComment', description: devToGetComment.description, tool: devToGetComment, scope: 'read' },
+    { name: 'devToListComments', description: devToListComments.description, tool: devToListComments, scope: 'read' },
+    { name: 'devToGetCurrentUser', description: devToGetCurrentUser.description, tool: devToGetCurrentUser, requiredAuth: authed, scope: 'read' },
+    { name: 'devToGetUser', description: devToGetUser.description, tool: devToGetUser, scope: 'read' },
+    { name: 'devToGetOrganization', description: devToGetOrganization.description, tool: devToGetOrganization, scope: 'read' },
+    { name: 'devToListOrganizationUsers', description: devToListOrganizationUsers.description, tool: devToListOrganizationUsers, scope: 'read' },
+    { name: 'devToGetProfileImage', description: devToGetProfileImage.description, tool: devToGetProfileImage, scope: 'read' },
+    { name: 'devToListTags', description: devToListTags.description, tool: devToListTags, scope: 'read' },
+    { name: 'devToListFollowedTags', description: devToListFollowedTags.description, tool: devToListFollowedTags, requiredAuth: authed, scope: 'read' },
+    { name: 'devToListFollowers', description: devToListFollowers.description, tool: devToListFollowers, requiredAuth: authed, scope: 'read' },
+    { name: 'devToListPodcastEpisodes', description: devToListPodcastEpisodes.description, tool: devToListPodcastEpisodes, scope: 'read' },
+    { name: 'devToListReadingList', description: devToListReadingList.description, tool: devToListReadingList, requiredAuth: authed, scope: 'read' },
+    { name: 'devToListVideos', description: devToListVideos.description, tool: devToListVideos, scope: 'read' },
+    { name: 'devToGetListing', description: devToGetListing.description, tool: devToGetListing, scope: 'read' },
+    { name: 'devToListListings', description: devToListListings.description, tool: devToListListings, scope: 'read' },
+    { name: 'devToListListingsByCategory', description: devToListListingsByCategory.description, tool: devToListListingsByCategory, scope: 'read' },
+    { name: 'devToUpdateListing', description: devToUpdateListing.description, tool: devToUpdateListing, requiredAuth: authed, scope: 'write' },
+];
+//# sourceMappingURL=index.js.map

package/dist/toolkits/dev-to/tools/listings.d.ts

@@ -0,0 +1,26 @@
+export declare const devToGetListing: import("ai").Tool<{
+    id: number;
+    devToApiKey?: string | undefined;
+}, any>;
+export declare const devToListListings: import("ai").Tool<{
+    perPage?: number | undefined;
+    page?: number | undefined;
+    category?: "events" | "cfp" | "education" | "jobs" | "mentors" | "products" | "mentees" | "forsale" | "collabs" | "misc" | undefined;
+    devToApiKey?: string | undefined;
+}, any>;
+export declare const devToListListingsByCategory: import("ai").Tool<{
+    category: "events" | "cfp" | "education" | "jobs" | "mentors" | "products" | "mentees" | "forsale" | "collabs" | "misc";
+    perPage?: number | undefined;
+    page?: number | undefined;
+    devToApiKey?: string | undefined;
+}, any>;
+export declare const devToUpdateListing: import("ai").Tool<{
+    id: number;
+    title?: string | undefined;
+    action?: string | undefined;
+    tags?: string[] | undefined;
+    category?: string | undefined;
+    devToApiKey?: string | undefined;
+    bodyMarkdown?: string | undefined;
+}, any>;
+//# sourceMappingURL=listings.d.ts.map

package/dist/toolkits/dev-to/tools/listings.js

@@ -0,0 +1,92 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { devToRequest, toDevToError, requireApiKey } from './client.js';
+const apiKeyField = z.string().optional().describe('Injected by system; do not provide');
+const listingCategory = z
+    .enum(['cfp', 'education', 'jobs', 'mentors', 'products', 'mentees', 'forsale', 'events', 'collabs', 'misc'])
+    .describe('Listing category');
+export const devToGetListing = tool({
+    description: 'Get a single classified listing by ID, including title, body, category, and poster info.',
+    inputSchema: z.object({
+        devToApiKey: apiKeyField,
+        id: z.number().int().describe('The ID of the listing'),
+    }),
+    execute: async ({ devToApiKey, id }) => {
+        try {
+            return await devToRequest(devToApiKey, 'GET', `/listings/${id}`);
+        }
+        catch (error) {
+            return toDevToError(error, 'Failed to get listing');
+        }
+    },
+});
+export const devToListListings = tool({
+    description: 'List classified listings (jobs, mentors, products, events, etc.), optionally filtered by category.',
+    inputSchema: z.object({
+        devToApiKey: apiKeyField,
+        category: listingCategory.optional().describe('Filter by category'),
+        page: z.number().int().min(1).optional().describe('Page number for pagination'),
+        perPage: z.number().int().min(1).max(100).optional().describe('Items per page (default 30, max 100)'),
+    }),
+    execute: async ({ devToApiKey, perPage, ...rest }) => {
+        try {
+            const query = { ...rest };
+            if (perPage !== undefined)
+                query.per_page = perPage;
+            return await devToRequest(devToApiKey, 'GET', '/listings', { query });
+        }
+        catch (error) {
+            return toDevToError(error, 'Failed to list listings');
+        }
+    },
+});
+export const devToListListingsByCategory = tool({
+    description: 'List classified listings for one specific category (jobs, mentors, products, events, etc.).',
+    inputSchema: z.object({
+        devToApiKey: apiKeyField,
+        category: listingCategory,
+        page: z.number().int().min(1).optional().describe('Page number for pagination'),
+        perPage: z.number().int().min(1).max(100).optional().describe('Items per page (default 30, max 100)'),
+    }),
+    execute: async ({ devToApiKey, category, perPage, ...rest }) => {
+        try {
+            const query = { ...rest };
+            if (perPage !== undefined)
+                query.per_page = perPage;
+            return await devToRequest(devToApiKey, 'GET', `/listings/category/${encodeURIComponent(category)}`, {
+                query,
+            });
+        }
+        catch (error) {
+            return toDevToError(error, 'Failed to list listings by category');
+        }
+    },
+});
+export const devToUpdateListing = tool({
+    description: "Update your classified listing. Use action 'bump' to refresh its timestamp, 'publish'/'unpublish' to change status, or provide title/body/category/tags to edit content.",
+    inputSchema: z.object({
+        devToApiKey: apiKeyField,
+        id: z.number().int().describe('The ID of the listing to update'),
+        title: z.string().optional().describe('Updated title'),
+        bodyMarkdown: z.string().optional().describe('Updated body in Markdown'),
+        category: z.string().optional().describe('Updated category (must be valid)'),
+        tags: z.array(z.string()).optional().describe('Updated tags'),
+        action: z.string().optional().describe("'bump', 'publish', or 'unpublish'"),
+    }),
+    execute: async ({ devToApiKey, id, bodyMarkdown, ...rest }) => {
+        const missing = requireApiKey(devToApiKey);
+        if (missing)
+            return missing;
+        try {
+            const listing = { ...rest };
+            if (bodyMarkdown !== undefined)
+                listing.body_markdown = bodyMarkdown;
+            return await devToRequest(devToApiKey, 'PUT', `/listings/${id}`, { body: { listing } });
+        }
+        catch (error) {
+            return toDevToError(error, 'Failed to update listing');
+        }
+    },
+});
+//# sourceMappingURL=listings.js.map

package/dist/toolkits/discord/tools/applications.d.ts

@@ -1,23 +1,23 @@
 export declare const discordEditCommandPermissions: import("ai").Tool<{
-    guildId: string;
-    applicationId: string;
-    commandId: string;
     permissions: {
         type: number;
         id: string;
         permission: boolean;
     }[];
+    applicationId: string;
+    guildId: string;
+    commandId: string;
     discordToken?: string | undefined;
 }, any>;
 export declare const discordGetCommandPermissions: import("ai").Tool<{
-    guildId: string;
     applicationId: string;
+    guildId: string;
     commandId: string;
     discordToken?: string | undefined;
 }, any>;
 export declare const discordGetBatchCommandPermissions: import("ai").Tool<{
-    guildId: string;
     applicationId: string;
+    guildId: string;
     discordToken?: string | undefined;
 }, {
     error: string;

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

@@ -99,14 +99,14 @@ export declare const discordTools: ({
     name: string;
     description: string;
     tool: import("ai").Tool<{
-        guildId: string;
-        applicationId: string;
-        commandId: string;
         permissions: {
             type: number;
             id: string;
             permission: boolean;
         }[];
+        applicationId: string;
+        guildId: string;
+        commandId: string;
         discordToken?: string | undefined;
     }, any>;
     requiredAuth: "discordToken";
@@ -115,8 +115,8 @@ export declare const discordTools: ({
     name: string;
     description: string;
     tool: import("ai").Tool<{
-        guildId: string;
         applicationId: string;
+        guildId: string;
         commandId: string;
         discordToken?: string | undefined;
     }, any>;
@@ -126,8 +126,8 @@ export declare const discordTools: ({
     name: string;
     description: string;
     tool: import("ai").Tool<{
-        guildId: string;
         applicationId: string;
+        guildId: string;
         discordToken?: string | undefined;
     }, {
         error: string;