@rnsk/toolkits 0.0.7 → 0.0.9

package/dist/toolkits/discord/tools/guilds.js

@@ -0,0 +1,123 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { discordApi, toDiscordError, requireToken } from './client.js';
+const tokenField = z.string().optional().describe('Injected by system; do not provide');
+export const discordListMyGuilds = tool({
+    description: 'List guilds the caller is in (partial objects with permissions and features). Use for server lists or membership checks. Needs the guilds scope.',
+    inputSchema: z.object({
+        discordToken: tokenField,
+        limit: z.number().min(1).max(200).optional().describe('Max guilds (1-200, default 200)'),
+        before: z.string().optional().describe('Guilds before this guild ID'),
+        after: z.string().optional().describe('Guilds after this guild ID'),
+        withCounts: z.boolean().optional().describe('Include approximate member/presence counts'),
+    }),
+    execute: async ({ discordToken, withCounts, ...rest }) => {
+        try {
+            const missing = requireToken(discordToken);
+            if (missing)
+                return missing;
+            const guilds = await discordApi(discordToken, 'GET', '/users/@me/guilds', {
+                query: { ...rest, with_counts: withCounts },
+            });
+            return { guilds };
+        }
+        catch (error) {
+            return toDiscordError(error, 'Failed to list guilds');
+        }
+    },
+});
+export const discordGetGuildTemplate = tool({
+    description: 'Get a guild template by code, including the serialized source guild (channels, roles). Use for server-creation blueprints.',
+    inputSchema: z.object({
+        discordToken: tokenField,
+        code: z.string().describe('Template code, e.g. asFz8FjydMJa'),
+    }),
+    execute: async ({ discordToken, code }) => {
+        try {
+            const missing = requireToken(discordToken);
+            if (missing)
+                return missing;
+            return await discordApi(discordToken, 'GET', `/guilds/templates/${code}`);
+        }
+        catch (error) {
+            return toDiscordError(error, 'Failed to get guild template');
+        }
+    },
+});
+export const discordGetGuildWidget = tool({
+    description: 'Get the public guild widget JSON (online members, voice channels, invite). The widget must be enabled in server settings.',
+    inputSchema: z.object({
+        discordToken: tokenField,
+        guildId: z.string().describe('Guild snowflake ID'),
+    }),
+    execute: async ({ discordToken, guildId }) => {
+        try {
+            const missing = requireToken(discordToken);
+            if (missing)
+                return missing;
+            return await discordApi(discordToken, 'GET', `/guilds/${guildId}/widget.json`);
+        }
+        catch (error) {
+            return toDiscordError(error, 'Failed to get guild widget');
+        }
+    },
+});
+export const discordGetGuildWidgetPng = tool({
+    description: 'Get a guild widget banner image URL (shield or banner1-4 style) for embedding on external sites. The widget must be enabled in server settings. Returns the public image URL (no auth needed to view).',
+    inputSchema: z.object({
+        discordToken: tokenField,
+        guildId: z.string().describe('Guild snowflake ID'),
+        style: z.enum(['shield', 'banner1', 'banner2', 'banner3', 'banner4']).optional().describe('Widget visual style'),
+    }),
+    execute: async ({ discordToken, guildId, style }) => {
+        try {
+            const missing = requireToken(discordToken);
+            if (missing)
+                return missing;
+            const url = `https://discord.com/api/v10/guilds/${guildId}/widget.png${style ? `?style=${style}` : ''}`;
+            const response = await fetch(url);
+            if (!response.ok) {
+                return { error: 'Failed to get guild widget image', details: { status: response.status } };
+            }
+            return {
+                name: `widget-${guildId}.png`,
+                mimetype: response.headers.get('content-type') ?? 'image/png',
+                url,
+                style: style ?? 'shield',
+            };
+        }
+        catch (error) {
+            return toDiscordError(error, 'Failed to get guild widget image');
+        }
+    },
+});
+export const discordResolveInvite = tool({
+    description: 'Resolve an invite code (bare code, vanity URL, or full discord.gg URL) to guild/channel/event details. Null or partial responses mean expired, revoked, or inaccessible invites — do not infer membership from them.',
+    inputSchema: z.object({
+        discordToken: tokenField,
+        code: z.string().describe('Invite code or URL, e.g. discord-api or https://discord.gg/abc123xyz'),
+        withCounts: z.boolean().optional().describe('Include approximate member/presence counts'),
+        withExpiration: z.boolean().optional().describe('Include expires_at (usually returned anyway)'),
+        guildScheduledEventId: z.string().optional().describe('Include this scheduled event in the response'),
+    }),
+    execute: async ({ discordToken, code, withCounts, withExpiration, guildScheduledEventId }) => {
+        try {
+            const missing = requireToken(discordToken);
+            if (missing)
+                return missing;
+            const clean = code.split('?')[0].split('/').filter(Boolean).pop() ?? code;
+            return await discordApi(discordToken, 'GET', `/invites/${clean}`, {
+                query: {
+                    with_counts: withCounts,
+                    with_expiration: withExpiration,
+                    guild_scheduled_event_id: guildScheduledEventId,
+                },
+            });
+        }
+        catch (error) {
+            return toDiscordError(error, 'Failed to resolve invite');
+        }
+    },
+});
+//# sourceMappingURL=guilds.js.map

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

@@ -0,0 +1,222 @@
+import { discordGetMyUser, discordGetUser, discordGetOpenIdUserinfo, discordGetMyOAuth2Authorization, discordGetPublicKeys, discordListMyConnections, discordGetMyGuildMember } from './users.js';
+import { discordListMyGuilds, discordGetGuildTemplate, discordGetGuildWidget, discordGetGuildWidgetPng, discordResolveInvite } from './guilds.js';
+import { discordEditCommandPermissions, discordGetCommandPermissions, discordGetBatchCommandPermissions, discordGetMyEntitlements, discordGetRoleConnection, discordUpdateRoleConnection, discordDeleteRoleConnection, discordGetSkuSubscription, discordListSkuSubscriptions } from './applications.js';
+import { discordGetGateway, discordListStickerPacks } from './misc.js';
+export { discordGetMyUser, discordGetUser, discordGetOpenIdUserinfo, discordGetMyOAuth2Authorization, discordGetPublicKeys, discordListMyConnections, discordGetMyGuildMember, discordListMyGuilds, discordGetGuildTemplate, discordGetGuildWidget, discordGetGuildWidgetPng, discordResolveInvite, discordEditCommandPermissions, discordGetCommandPermissions, discordGetBatchCommandPermissions, discordGetMyEntitlements, discordGetRoleConnection, discordUpdateRoleConnection, discordDeleteRoleConnection, discordGetSkuSubscription, discordListSkuSubscriptions, discordGetGateway, discordListStickerPacks, };
+export declare const discordTools: ({
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        discordToken?: string | undefined;
+    }, any>;
+    requiredAuth: "discordToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        userId: string;
+        discordToken?: string | undefined;
+    }, any>;
+    requiredAuth: "discordToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        discordToken?: string | undefined;
+    }, {
+        error: string;
+    } | {
+        connections: any;
+    }>;
+    requiredAuth: "discordToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        guildId: string;
+        discordToken?: string | undefined;
+    }, any>;
+    requiredAuth: "discordToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        limit?: number | undefined;
+        before?: string | undefined;
+        after?: string | undefined;
+        discordToken?: string | undefined;
+        withCounts?: boolean | undefined;
+    }, {
+        error: string;
+    } | {
+        guilds: any;
+    }>;
+    requiredAuth: "discordToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        code: string;
+        discordToken?: string | undefined;
+    }, any>;
+    requiredAuth: "discordToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        guildId: string;
+        style?: "shield" | "banner1" | "banner2" | "banner3" | "banner4" | undefined;
+        discordToken?: string | undefined;
+    }, {
+        error: string;
+    } | {
+        name: string;
+        mimetype: string;
+        url: string;
+        style: "shield" | "banner1" | "banner2" | "banner3" | "banner4";
+    }>;
+    requiredAuth: "discordToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        code: string;
+        discordToken?: string | undefined;
+        withCounts?: boolean | undefined;
+        withExpiration?: boolean | undefined;
+        guildScheduledEventId?: string | undefined;
+    }, any>;
+    requiredAuth: "discordToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        guildId: string;
+        applicationId: string;
+        commandId: string;
+        permissions: {
+            type: number;
+            id: string;
+            permission: boolean;
+        }[];
+        discordToken?: string | undefined;
+    }, any>;
+    requiredAuth: "discordToken";
+    scope: "write";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        guildId: string;
+        applicationId: string;
+        commandId: string;
+        discordToken?: string | undefined;
+    }, any>;
+    requiredAuth: "discordToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        guildId: string;
+        applicationId: string;
+        discordToken?: string | undefined;
+    }, {
+        error: string;
+    } | {
+        command_permissions: any;
+    }>;
+    requiredAuth: "discordToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        applicationId: string;
+        limit?: number | undefined;
+        before?: string | undefined;
+        after?: string | undefined;
+        discordToken?: string | undefined;
+        guildId?: string | undefined;
+        skuIds?: string[] | undefined;
+        excludeEnded?: boolean | undefined;
+        excludeDeleted?: boolean | undefined;
+    }, {
+        error: string;
+    } | {
+        entitlements: any[];
+    }>;
+    requiredAuth: "discordToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        applicationId: string;
+        discordToken?: string | undefined;
+    }, any>;
+    requiredAuth: "discordToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        applicationId: string;
+        metadata?: Record<string, string> | undefined;
+        discordToken?: string | undefined;
+        platformName?: string | undefined;
+        platformUsername?: string | undefined;
+    }, any>;
+    requiredAuth: "discordToken";
+    scope: "write";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        applicationId: string;
+        discordToken?: string | undefined;
+    }, {
+        error: string;
+    } | {
+        success: boolean;
+        application_id: string;
+    }>;
+    requiredAuth: "discordToken";
+    scope: "delete";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        subscriptionId: string;
+        skuId: string;
+        discordToken?: string | undefined;
+    }, any>;
+    requiredAuth: "discordToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        skuId: string;
+        limit?: number | undefined;
+        before?: string | undefined;
+        after?: string | undefined;
+        userId?: string | undefined;
+        discordToken?: string | undefined;
+    }, {
+        error: string;
+    } | {
+        subscriptions: any;
+    }>;
+    requiredAuth: "discordToken";
+    scope: "read";
+})[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,170 @@
+// @ts-nocheck
+import { discordGetMyUser, discordGetUser, discordGetOpenIdUserinfo, discordGetMyOAuth2Authorization, discordGetPublicKeys, discordListMyConnections, discordGetMyGuildMember, } from './users.js';
+import { discordListMyGuilds, discordGetGuildTemplate, discordGetGuildWidget, discordGetGuildWidgetPng, discordResolveInvite, } from './guilds.js';
+import { discordEditCommandPermissions, discordGetCommandPermissions, discordGetBatchCommandPermissions, discordGetMyEntitlements, discordGetRoleConnection, discordUpdateRoleConnection, discordDeleteRoleConnection, discordGetSkuSubscription, discordListSkuSubscriptions, } from './applications.js';
+import { discordGetGateway, discordListStickerPacks } from './misc.js';
+export { discordGetMyUser, discordGetUser, discordGetOpenIdUserinfo, discordGetMyOAuth2Authorization, discordGetPublicKeys, discordListMyConnections, discordGetMyGuildMember, discordListMyGuilds, discordGetGuildTemplate, discordGetGuildWidget, discordGetGuildWidgetPng, discordResolveInvite, discordEditCommandPermissions, discordGetCommandPermissions, discordGetBatchCommandPermissions, discordGetMyEntitlements, discordGetRoleConnection, discordUpdateRoleConnection, discordDeleteRoleConnection, discordGetSkuSubscription, discordListSkuSubscriptions, discordGetGateway, discordListStickerPacks, };
+export const discordTools = [
+    {
+        name: 'discordGetMyUser',
+        description: discordGetMyUser.description,
+        tool: discordGetMyUser,
+        requiredAuth: 'discordToken',
+        scope: 'read',
+    },
+    {
+        name: 'discordGetUser',
+        description: discordGetUser.description,
+        tool: discordGetUser,
+        requiredAuth: 'discordToken',
+        scope: 'read',
+    },
+    {
+        name: 'discordGetOpenIdUserinfo',
+        description: discordGetOpenIdUserinfo.description,
+        tool: discordGetOpenIdUserinfo,
+        requiredAuth: 'discordToken',
+        scope: 'read',
+    },
+    {
+        name: 'discordGetMyOAuth2Authorization',
+        description: discordGetMyOAuth2Authorization.description,
+        tool: discordGetMyOAuth2Authorization,
+        requiredAuth: 'discordToken',
+        scope: 'read',
+    },
+    {
+        name: 'discordGetPublicKeys',
+        description: discordGetPublicKeys.description,
+        tool: discordGetPublicKeys,
+        requiredAuth: 'discordToken',
+        scope: 'read',
+    },
+    {
+        name: 'discordListMyConnections',
+        description: discordListMyConnections.description,
+        tool: discordListMyConnections,
+        requiredAuth: 'discordToken',
+        scope: 'read',
+    },
+    {
+        name: 'discordGetMyGuildMember',
+        description: discordGetMyGuildMember.description,
+        tool: discordGetMyGuildMember,
+        requiredAuth: 'discordToken',
+        scope: 'read',
+    },
+    {
+        name: 'discordListMyGuilds',
+        description: discordListMyGuilds.description,
+        tool: discordListMyGuilds,
+        requiredAuth: 'discordToken',
+        scope: 'read',
+    },
+    {
+        name: 'discordGetGuildTemplate',
+        description: discordGetGuildTemplate.description,
+        tool: discordGetGuildTemplate,
+        requiredAuth: 'discordToken',
+        scope: 'read',
+    },
+    {
+        name: 'discordGetGuildWidget',
+        description: discordGetGuildWidget.description,
+        tool: discordGetGuildWidget,
+        requiredAuth: 'discordToken',
+        scope: 'read',
+    },
+    {
+        name: 'discordGetGuildWidgetPng',
+        description: discordGetGuildWidgetPng.description,
+        tool: discordGetGuildWidgetPng,
+        requiredAuth: 'discordToken',
+        scope: 'read',
+    },
+    {
+        name: 'discordResolveInvite',
+        description: discordResolveInvite.description,
+        tool: discordResolveInvite,
+        requiredAuth: 'discordToken',
+        scope: 'read',
+    },
+    {
+        name: 'discordEditCommandPermissions',
+        description: discordEditCommandPermissions.description,
+        tool: discordEditCommandPermissions,
+        requiredAuth: 'discordToken',
+        scope: 'write',
+    },
+    {
+        name: 'discordGetCommandPermissions',
+        description: discordGetCommandPermissions.description,
+        tool: discordGetCommandPermissions,
+        requiredAuth: 'discordToken',
+        scope: 'read',
+    },
+    {
+        name: 'discordGetBatchCommandPermissions',
+        description: discordGetBatchCommandPermissions.description,
+        tool: discordGetBatchCommandPermissions,
+        requiredAuth: 'discordToken',
+        scope: 'read',
+    },
+    {
+        name: 'discordGetMyEntitlements',
+        description: discordGetMyEntitlements.description,
+        tool: discordGetMyEntitlements,
+        requiredAuth: 'discordToken',
+        scope: 'read',
+    },
+    {
+        name: 'discordGetRoleConnection',
+        description: discordGetRoleConnection.description,
+        tool: discordGetRoleConnection,
+        requiredAuth: 'discordToken',
+        scope: 'read',
+    },
+    {
+        name: 'discordUpdateRoleConnection',
+        description: discordUpdateRoleConnection.description,
+        tool: discordUpdateRoleConnection,
+        requiredAuth: 'discordToken',
+        scope: 'write',
+    },
+    {
+        name: 'discordDeleteRoleConnection',
+        description: discordDeleteRoleConnection.description,
+        tool: discordDeleteRoleConnection,
+        requiredAuth: 'discordToken',
+        scope: 'delete',
+    },
+    {
+        name: 'discordGetSkuSubscription',
+        description: discordGetSkuSubscription.description,
+        tool: discordGetSkuSubscription,
+        requiredAuth: 'discordToken',
+        scope: 'read',
+    },
+    {
+        name: 'discordListSkuSubscriptions',
+        description: discordListSkuSubscriptions.description,
+        tool: discordListSkuSubscriptions,
+        requiredAuth: 'discordToken',
+        scope: 'read',
+    },
+    {
+        name: 'discordGetGateway',
+        description: discordGetGateway.description,
+        tool: discordGetGateway,
+        requiredAuth: 'discordToken',
+        scope: 'read',
+    },
+    {
+        name: 'discordListStickerPacks',
+        description: discordListStickerPacks.description,
+        tool: discordListStickerPacks,
+        requiredAuth: 'discordToken',
+        scope: 'read',
+    },
+];
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,7 @@
+export declare const discordGetGateway: import("ai").Tool<{
+    discordToken?: string | undefined;
+}, any>;
+export declare const discordListStickerPacks: import("ai").Tool<{
+    discordToken?: string | undefined;
+}, any>;
+//# sourceMappingURL=misc.d.ts.map

package/dist/toolkits/discord/tools/misc.js

@@ -0,0 +1,40 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { discordApi, toDiscordError, requireToken } from './client.js';
+const tokenField = z.string().optional().describe('Injected by system; do not provide');
+export const discordGetGateway = tool({
+    description: 'Get the Discord Gateway WebSocket URL (wss) for real-time event connections. Connect to the returned URL separately.',
+    inputSchema: z.object({
+        discordToken: tokenField,
+    }),
+    execute: async ({ discordToken }) => {
+        try {
+            const missing = requireToken(discordToken);
+            if (missing)
+                return missing;
+            return await discordApi(discordToken, 'GET', '/gateway');
+        }
+        catch (error) {
+            return toDiscordError(error, 'Failed to get gateway');
+        }
+    },
+});
+export const discordListStickerPacks = tool({
+    description: 'List official Discord Nitro sticker packs with their stickers. Use to browse available stickers.',
+    inputSchema: z.object({
+        discordToken: tokenField,
+    }),
+    execute: async ({ discordToken }) => {
+        try {
+            const missing = requireToken(discordToken);
+            if (missing)
+                return missing;
+            return await discordApi(discordToken, 'GET', '/sticker-packs');
+        }
+        catch (error) {
+            return toDiscordError(error, 'Failed to list sticker packs');
+        }
+    },
+});
+//# sourceMappingURL=misc.js.map

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

@@ -0,0 +1,28 @@
+export declare const discordGetMyUser: import("ai").Tool<{
+    discordToken?: string | undefined;
+}, any>;
+export declare const discordGetUser: import("ai").Tool<{
+    userId: string;
+    discordToken?: string | undefined;
+}, any>;
+export declare const discordGetOpenIdUserinfo: import("ai").Tool<{
+    discordToken?: string | undefined;
+}, any>;
+export declare const discordGetMyOAuth2Authorization: import("ai").Tool<{
+    discordToken?: string | undefined;
+}, any>;
+export declare const discordGetPublicKeys: import("ai").Tool<{
+    discordToken?: string | undefined;
+}, any>;
+export declare const discordListMyConnections: import("ai").Tool<{
+    discordToken?: string | undefined;
+}, {
+    error: string;
+} | {
+    connections: any;
+}>;
+export declare const discordGetMyGuildMember: import("ai").Tool<{
+    guildId: string;
+    discordToken?: string | undefined;
+}, any>;
+//# sourceMappingURL=users.d.ts.map