@rnsk/toolkits 0.0.6 → 0.0.8

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

@@ -0,0 +1,110 @@
+// @ts-nocheck
+import { addCommentToAFile } from './add-comment-to-a-file.js';
+import { addReactionToAComment } from './add-reaction-to-a-comment.js';
+import { createAWebhook } from './create-a-webhook.js';
+import { createDevResources } from './create-dev-resources.js';
+import { createModifyDeleteVariables } from './create-modify-delete-variables.js';
+import { deleteAComment } from './delete-a-comment.js';
+import { deleteAReaction } from './delete-a-reaction.js';
+import { deleteAWebhook } from './delete-a-webhook.js';
+import { deleteDevResource } from './delete-dev-resource.js';
+import { designTokensToTailwind } from './design-tokens-to-tailwind.js';
+import { detectBackground } from './detect-background.js';
+import { discoverFigmaResources } from './discover-figma-resources.js';
+import { downloadFigmaImages } from './download-figma-images.js';
+import { extractDesignTokens } from './extract-design-tokens.js';
+import { extractPrototypeInteractions } from './extract-prototype-interactions.js';
+import { getActivityLogs } from './get-activity-logs.js';
+import { getAWebhook } from './get-a-webhook.js';
+import { getCommentsInAFile } from './get-comments-in-a-file.js';
+import { getComponent2 } from './get-component2.js';
+import { getComponentSet } from './get-component-set.js';
+import { getCurrentUser } from './get-current-user.js';
+import { getDevResources } from './get-dev-resources.js';
+import { getFileComponentSets } from './get-file-component-sets.js';
+import { getFileComponents } from './get-file-components.js';
+import { getFileJson } from './get-file-json.js';
+import { getFileMetadata } from './get-file-metadata.js';
+import { getFileNodes } from './get-file-nodes.js';
+import { getFileStyles } from './get-file-styles.js';
+import { getFilesInAProject } from './get-files-in-a-project.js';
+import { getImageFills } from './get-image-fills.js';
+import { getLibraryAnalyticsComponentActionData } from './get-library-analytics-component-action-data.js';
+import { getLibraryAnalyticsComponentUsageData } from './get-library-analytics-component-usage-data.js';
+import { getLibraryAnalyticsStyleActionData } from './get-library-analytics-style-action-data.js';
+import { getLibraryAnalyticsStyleUsageData } from './get-library-analytics-style-usage-data.js';
+import { getLibraryAnalyticsVariableActionData } from './get-library-analytics-variable-action-data.js';
+import { getLibraryAnalyticsVariableUsageData } from './get-library-analytics-variable-usage-data.js';
+import { getLocalVariables } from './get-local-variables.js';
+import { getPayments } from './get-payments.js';
+import { getProjectsInATeam } from './get-projects-in-a-team.js';
+import { getPublishedVariables } from './get-published-variables.js';
+import { getReactionsForAComment } from './get-reactions-for-a-comment.js';
+import { getScimServiceProviderConfig } from './get-scim-service-provider-config.js';
+import { getStyle } from './get-style.js';
+import { getTeamComponentSets } from './get-team-component-sets.js';
+import { getTeamComponents } from './get-team-components.js';
+import { getTeamStyles } from './get-team-styles.js';
+import { getTeamWebhooks } from './get-team-webhooks.js';
+import { getVersionsOfAFile } from './get-versions-of-a-file.js';
+import { getWebhookRequests } from './get-webhook-requests.js';
+import { renderImagesOfFileNodes } from './render-images-of-file-nodes.js';
+import { updateAWebhook } from './update-a-webhook.js';
+import { updateDevResources } from './update-dev-resources.js';
+export { addCommentToAFile, addReactionToAComment, createAWebhook, createDevResources, createModifyDeleteVariables, deleteAComment, deleteAReaction, deleteAWebhook, deleteDevResource, designTokensToTailwind, detectBackground, discoverFigmaResources, downloadFigmaImages, extractDesignTokens, extractPrototypeInteractions, getActivityLogs, getAWebhook, getCommentsInAFile, getComponent2, getComponentSet, getCurrentUser, getDevResources, getFileComponentSets, getFileComponents, getFileJson, getFileMetadata, getFileNodes, getFileStyles, getFilesInAProject, getImageFills, getLibraryAnalyticsComponentActionData, getLibraryAnalyticsComponentUsageData, getLibraryAnalyticsStyleActionData, getLibraryAnalyticsStyleUsageData, getLibraryAnalyticsVariableActionData, getLibraryAnalyticsVariableUsageData, getLocalVariables, getPayments, getProjectsInATeam, getPublishedVariables, getReactionsForAComment, getScimServiceProviderConfig, getStyle, getTeamComponentSets, getTeamComponents, getTeamStyles, getTeamWebhooks, getVersionsOfAFile, getWebhookRequests, renderImagesOfFileNodes, updateAWebhook, updateDevResources, };
+const auth = 'figmaToken';
+export const figmaTools = [
+    { name: 'figmaAddCommentToAFile', description: 'Posts a comment to a file or branch, optionally replying to a root comment.', tool: addCommentToAFile, requiredAuth: auth, scope: 'write' },
+    { name: 'figmaAddReactionToAComment', description: 'Posts an emoji reaction to a comment.', tool: addReactionToAComment, requiredAuth: auth, scope: 'write' },
+    { name: 'figmaCreateAWebhook', description: 'Creates a team/project/file webhook for Figma events.', tool: createAWebhook, requiredAuth: auth, scope: 'write' },
+    { name: 'figmaCreateDevResources', description: 'Attaches dev resources (Jira, GitHub, docs) to file nodes.', tool: createDevResources, requiredAuth: auth, scope: 'write' },
+    { name: 'figmaCreateModifyDeleteVariables', description: 'Batch creates, updates, or deletes variables, collections, modes, and values.', tool: createModifyDeleteVariables, requiredAuth: auth, scope: 'write' },
+    { name: 'figmaDeleteAComment', description: 'Deletes your comment from a file or branch.', tool: deleteAComment, requiredAuth: auth, scope: 'delete' },
+    { name: 'figmaDeleteAReaction', description: 'Removes your emoji reaction from a comment.', tool: deleteAReaction, requiredAuth: auth, scope: 'delete' },
+    { name: 'figmaDeleteAWebhook', description: 'Permanently deletes a webhook. Irreversible.', tool: deleteAWebhook, requiredAuth: auth, scope: 'delete' },
+    { name: 'figmaDeleteDevResource', description: 'Deletes a dev resource from a main file.', tool: deleteDevResource, requiredAuth: auth, scope: 'delete' },
+    { name: 'figmaDesignTokensToTailwind', description: 'Converts extracted design tokens into a Tailwind config plus font CSS. No auth needed.', tool: designTokensToTailwind, scope: 'read' },
+    { name: 'figmaDetectBackground', description: 'Finds background candidates behind target nodes with confidence scores.', tool: detectBackground, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaDiscoverFigmaResources', description: 'Extracts IDs from any Figma URL and traverses team → projects → files → nodes.', tool: discoverFigmaResources, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaDownloadFigmaImages', description: 'Renders nodes and downloads image bytes (base64) in PNG/SVG/JPG/PDF.', tool: downloadFigmaImages, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaExtractDesignTokens', description: 'Extracts colors, typography, spacing, radii, and shadows from a file.', tool: extractDesignTokens, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaExtractPrototypeInteractions', description: 'Extracts prototype flows, interactions, animations, and variant states.', tool: extractPrototypeInteractions, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetActivityLogs', description: 'Retrieves org activity log events with filters and pagination.', tool: getActivityLogs, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetAWebhook', description: 'Retrieves a webhook by ID.', tool: getAWebhook, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetCommentsInAFile', description: 'Retrieves all comments from a file or branch.', tool: getCommentsInAFile, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetComponent2', description: 'Fetches published component metadata by component key.', tool: getComponent2, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetComponentSet', description: 'Fetches published component set metadata by set key.', tool: getComponentSet, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetCurrentUser', description: 'Returns the authenticated user details.', tool: getCurrentUser, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetDevResources', description: 'Lists dev resources on a main file, optionally filtered to nodes.', tool: getDevResources, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetFileComponentSets', description: 'Lists published component sets from a main library file.', tool: getFileComponentSets, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetFileComponents', description: 'Lists published components from a main library file.', tool: getFileComponents, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetFileJson', description: 'Gets a Design file document tree, optionally scoped to nodes and depth.', tool: getFileJson, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetFileMetadata', description: 'Gets file overview without the document tree.', tool: getFileMetadata, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetFileNodes', description: 'Fetches JSON for known node IDs without full-file payloads.', tool: getFileNodes, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetFileStyles', description: 'Lists published styles from a main library file.', tool: getFileStyles, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetFilesInAProject', description: 'Lists files in a project, optionally with branch metadata.', tool: getFilesInAProject, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetImageFills', description: 'Returns temporary download URLs for all image fills in a file.', tool: getImageFills, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetLibraryAnalyticsComponentActionData', description: 'Weekly component insertions/detachments for a library.', tool: getLibraryAnalyticsComponentActionData, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetLibraryAnalyticsComponentUsageData', description: 'Component usage totals for a library.', tool: getLibraryAnalyticsComponentUsageData, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetLibraryAnalyticsStyleActionData', description: 'Weekly style insertions/detachments for a library.', tool: getLibraryAnalyticsStyleActionData, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetLibraryAnalyticsStyleUsageData', description: 'Style usage totals for a library.', tool: getLibraryAnalyticsStyleUsageData, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetLibraryAnalyticsVariableActionData', description: 'Weekly variable insertions/detachments for a library.', tool: getLibraryAnalyticsVariableActionData, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetLibraryAnalyticsVariableUsageData', description: 'Variable usage totals for a library.', tool: getLibraryAnalyticsVariableUsageData, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetLocalVariables', description: 'Gets all local/remote variables with mode-specific values.', tool: getLocalVariables, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetPayments', description: 'Checks a user payment status for your plugin, widget, or Community file.', tool: getPayments, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetProjectsInATeam', description: 'Lists projects in a team.', tool: getProjectsInATeam, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetPublishedVariables', description: 'Gets published variables from a main library file.', tool: getPublishedVariables, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetReactionsForAComment', description: 'Lists reactions on a comment with pagination.', tool: getReactionsForAComment, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetScimServiceProviderConfig', description: 'Returns SCIM capabilities for account provisioning.', tool: getScimServiceProviderConfig, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetStyle', description: 'Fetches published style metadata by style key.', tool: getStyle, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetTeamComponentSets', description: 'Lists published component sets in a team library.', tool: getTeamComponentSets, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetTeamComponents', description: 'Lists published components in a team library.', tool: getTeamComponents, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetTeamStyles', description: 'Lists published styles in a team library.', tool: getTeamStyles, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetTeamWebhooks', description: 'Lists webhooks for a team, project, or file context.', tool: getTeamWebhooks, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetVersionsOfAFile', description: 'Retrieves version history for a file or branch.', tool: getVersionsOfAFile, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaGetWebhookRequests', description: 'Shows 7-day delivery history for a webhook.', tool: getWebhookRequests, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaRenderImagesOfFileNodes', description: 'Renders nodes as images and returns temporary URLs.', tool: renderImagesOfFileNodes, requiredAuth: auth, scope: 'read' },
+    { name: 'figmaUpdateAWebhook', description: 'Updates a webhook event type, endpoint, passcode, status, or description.', tool: updateAWebhook, requiredAuth: auth, scope: 'write' },
+    { name: 'figmaUpdateDevResources', description: 'Updates dev resource names and URLs by ID.', tool: updateDevResources, requiredAuth: auth, scope: 'write' },
+];
+//# sourceMappingURL=index.js.map

package/dist/toolkits/figma/tools/library-analytics-shared.d.ts

@@ -0,0 +1,4 @@
+export declare function libraryAnalyticsTool(label: string, resource: 'component' | 'style' | 'variable', metric: 'actions' | 'usages', groupBy: string[], withDates: boolean): import("ai").Tool<{
+    [x: string]: any;
+}, any>;
+//# sourceMappingURL=library-analytics-shared.d.ts.map

package/dist/toolkits/figma/tools/library-analytics-shared.js

@@ -0,0 +1,40 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { figmaRequest, figmaTokenField } from './client.js';
+export function libraryAnalyticsTool(label, resource, metric, groupBy, withDates) {
+    const schema = {
+        figmaToken: figmaTokenField,
+        fileKey: z.string().describe('Published Enterprise library file key'),
+        groupBy: z.enum(groupBy).describe('Grouping dimension; shapes the rows'),
+        cursor: z.string().optional().describe('Pagination cursor; omit for first page'),
+    };
+    if (withDates) {
+        schema.startDate = z.string().optional().describe('Range start YYYY-MM-DD (defaults to one year prior)');
+        schema.endDate = z.string().optional().describe('Range end YYYY-MM-DD (defaults to latest week)');
+    }
+    return tool({
+        description: `${label} for an Enterprise library. Requires library_analytics:read.`,
+        inputSchema: z.object(schema),
+        execute: async ({ figmaToken, fileKey, groupBy, cursor, startDate, endDate }) => {
+            try {
+                if (startDate && endDate && endDate < startDate) {
+                    return { error: 'endDate must not be before startDate' };
+                }
+                const result = await figmaRequest(figmaToken, `/v1/files/${fileKey}/analytics/${resource}/${metric}`, {
+                    query: { group_by: groupBy, cursor, start_date: startDate, end_date: endDate },
+                });
+                if (!result.ok)
+                    return { error: `Failed to get ${label}`, details: result.error };
+                return result.data;
+            }
+            catch (error) {
+                return {
+                    error: `Error getting ${label}`,
+                    message: error instanceof Error ? error.message : 'Unknown error',
+                };
+            }
+        },
+    });
+}
+//# sourceMappingURL=library-analytics-shared.js.map

package/dist/toolkits/figma/tools/render-images-of-file-nodes.d.ts

@@ -0,0 +1,15 @@
+export declare const renderImagesOfFileNodes: import("ai").Tool<{
+    figmaToken: string;
+    fileKey: string;
+    ids: string;
+    version?: string | undefined;
+    format?: "svg" | "png" | "jpg" | "pdf" | undefined;
+    scale?: number | undefined;
+    svgIncludeId?: boolean | undefined;
+    svgOutlineText?: boolean | undefined;
+    svgSimplifyStroke?: boolean | undefined;
+    contentsOnly?: boolean | undefined;
+    useAbsoluteBounds?: boolean | undefined;
+    svgIncludeNodeId?: boolean | undefined;
+}, any>;
+//# sourceMappingURL=render-images-of-file-nodes.d.ts.map

package/dist/toolkits/figma/tools/render-images-of-file-nodes.js

@@ -0,0 +1,49 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { figmaRequest, figmaTokenField } from './client.js';
+export const renderImagesOfFileNodes = tool({
+    description: 'Renders nodes as PNG/JPG/SVG/PDF and returns temporary (30-day) image URLs keyed by node ID. Null means that node failed (bad ID, invisible, 0% opacity). Capped at 32MP — lower scale for large nodes.',
+    inputSchema: z.object({
+        figmaToken: figmaTokenField,
+        fileKey: z.string().describe('File or branch key from the file URL'),
+        ids: z.string().describe("Comma-separated node IDs, e.g. '1:2,1:3'"),
+        format: z.enum(['jpg', 'pdf', 'png', 'svg']).optional().describe('Output format (default png)'),
+        scale: z.number().min(0.01).max(4).optional().describe('PNG/JPG scale 0.01-4 (ignored for SVG/PDF)'),
+        version: z.string().optional().describe('Version ID; omit for current'),
+        contentsOnly: z.boolean().optional().describe('Exclude overlapping content (default true)'),
+        useAbsoluteBounds: z.boolean().optional().describe('Full node dimensions, avoids text cropping'),
+        svgIncludeId: z.boolean().optional(),
+        svgOutlineText: z.boolean().optional(),
+        svgIncludeNodeId: z.boolean().optional(),
+        svgSimplifyStroke: z.boolean().optional(),
+    }),
+    execute: async ({ figmaToken, fileKey, ids, format, scale, version, contentsOnly, useAbsoluteBounds, svgIncludeId, svgOutlineText, svgIncludeNodeId, svgSimplifyStroke }) => {
+        try {
+            const result = await figmaRequest(figmaToken, `/v1/files/${fileKey}/images`, {
+                query: {
+                    ids,
+                    format,
+                    scale,
+                    version,
+                    contents_only: contentsOnly,
+                    use_absolute_bounds: useAbsoluteBounds,
+                    svg_include_id: svgIncludeId,
+                    svg_outline_text: svgOutlineText,
+                    svg_include_node_id: svgIncludeNodeId,
+                    svg_simplify_stroke: svgSimplifyStroke,
+                },
+            });
+            if (!result.ok)
+                return { error: 'Failed to render node images', details: result.error };
+            return result.data;
+        }
+        catch (error) {
+            return {
+                error: 'Error rendering node images',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=render-images-of-file-nodes.js.map

package/dist/toolkits/figma/tools/update-a-webhook.d.ts

@@ -0,0 +1,10 @@
+export declare const updateAWebhook: import("ai").Tool<{
+    figmaToken: string;
+    webhookId: string;
+    status?: "ACTIVE" | "PAUSED" | undefined;
+    description?: string | undefined;
+    eventType?: "FILE_COMMENT" | "FILE_DELETE" | "FILE_UPDATE" | "FILE_VERSION_UPDATE" | "LIBRARY_PUBLISH" | "PING" | undefined;
+    endpoint?: string | undefined;
+    passcode?: string | undefined;
+}, any>;
+//# sourceMappingURL=update-a-webhook.d.ts.map

package/dist/toolkits/figma/tools/update-a-webhook.js

@@ -0,0 +1,45 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { figmaRequest, figmaTokenField } from './client.js';
+export const updateAWebhook = tool({
+    description: 'Updates a webhook event type, endpoint, passcode, status, or description. Only provided fields change.',
+    inputSchema: z.object({
+        figmaToken: figmaTokenField,
+        webhookId: z.string().describe('Webhook ID to update'),
+        eventType: z.enum(['FILE_COMMENT', 'FILE_DELETE', 'FILE_UPDATE', 'FILE_VERSION_UPDATE', 'LIBRARY_PUBLISH', 'PING']).optional(),
+        endpoint: z.string().optional().describe('New HTTPS endpoint (max 2048 chars)'),
+        passcode: z.string().optional().describe('New secret (max 100 chars)'),
+        status: z.enum(['ACTIVE', 'PAUSED']).optional(),
+        description: z.string().optional().describe('New description (max 140 chars; empty string removes)'),
+    }),
+    execute: async ({ figmaToken, webhookId, eventType, endpoint, passcode, status, description }) => {
+        try {
+            const body = {};
+            if (eventType)
+                body.event_type = eventType;
+            if (endpoint)
+                body.endpoint = endpoint;
+            if (passcode)
+                body.passcode = passcode;
+            if (status)
+                body.status = status;
+            if (description !== undefined)
+                body.description = description;
+            const result = await figmaRequest(figmaToken, `/v2/webhooks/${webhookId}`, {
+                method: 'PUT',
+                body,
+            });
+            if (!result.ok)
+                return { error: 'Failed to update webhook', details: result.error };
+            return result.data;
+        }
+        catch (error) {
+            return {
+                error: 'Error updating webhook',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=update-a-webhook.js.map

package/dist/toolkits/figma/tools/update-dev-resources.d.ts

@@ -0,0 +1,10 @@
+export declare const updateDevResources: import("ai").Tool<{
+    figmaToken: string;
+    fileKey: string;
+    devResources: {
+        id: string;
+        url?: string | undefined;
+        name?: string | undefined;
+    }[];
+}, any>;
+//# sourceMappingURL=update-dev-resources.d.ts.map

package/dist/toolkits/figma/tools/update-dev-resources.js

@@ -0,0 +1,34 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { figmaRequest, figmaTokenField } from './client.js';
+export const updateDevResources = tool({
+    description: 'Updates the name and/or URL of dev resources by ID. Omitted fields are retained.',
+    inputSchema: z.object({
+        figmaToken: figmaTokenField,
+        fileKey: z.string().describe('Main file key containing the resources'),
+        devResources: z.array(z.object({
+            id: z.string().describe('Dev resource ID to update'),
+            name: z.string().optional().describe('New name'),
+            url: z.string().optional().describe('New URL'),
+        })).min(1),
+    }),
+    execute: async ({ figmaToken, fileKey, devResources }) => {
+        try {
+            const result = await figmaRequest(figmaToken, `/v1/files/${fileKey}/dev_resources`, {
+                method: 'PUT',
+                body: { dev_resources: devResources },
+            });
+            if (!result.ok)
+                return { error: 'Failed to update dev resources', details: result.error };
+            return result.data;
+        }
+        catch (error) {
+            return {
+                error: 'Error updating dev resources',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=update-dev-resources.js.map

package/dist/toolkits/github/tools/Git/create-blob.d.ts

@@ -2,8 +2,8 @@ export declare const createBlob: import("ai").Tool<{
     repo: string;
     content: string;
     owner: string;
-    githubToken?: string | undefined;
     encoding?: "utf-8" | "base64" | undefined;
+    githubToken?: string | undefined;
 }, {
     error: string;
     sha?: undefined;

package/dist/toolkits/github/tools/Issues/remove-issue-label.d.ts

@@ -1,8 +1,8 @@
 export declare const removeIssueLabel: import("ai").Tool<{
+    label: string;
     repo: string;
     owner: string;
     issueNumber: number;
-    label: string;
     githubToken?: string | undefined;
 }, {
     error: string;

package/dist/toolkits/github/tools/Repos/star-repo.d.ts

@@ -1,7 +1,7 @@
 export declare const starRepo: import("ai").Tool<{
+    action: "star" | "unstar";
     repo: string;
     owner: string;
-    action: "star" | "unstar";
     githubToken?: string | undefined;
 }, {
     error: string;

package/dist/toolkits/github/tools/Users/follow-user.d.ts

@@ -1,6 +1,6 @@
 export declare const followUser: import("ai").Tool<{
-    username: string;
     action: "follow" | "unfollow";
+    username: string;
     githubToken?: string | undefined;
 }, {
     error: string;

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

@@ -641,9 +641,9 @@ export declare const githubTools: ({
     name: string;
     description: string;
     tool: import("ai").Tool<{
+        action: "star" | "unstar";
         repo: string;
         owner: string;
-        action: "star" | "unstar";
         githubToken?: string | undefined;
     }, {
         error: string;
@@ -1210,10 +1210,10 @@ export declare const githubTools: ({
     name: string;
     description: string;
     tool: import("ai").Tool<{
+        label: string;
         repo: string;
         owner: string;
         issueNumber: number;
-        label: string;
         githubToken?: string | undefined;
     }, {
         error: string;
@@ -1735,8 +1735,8 @@ export declare const githubTools: ({
     name: string;
     description: string;
     tool: import("ai").Tool<{
-        username: string;
         action: "follow" | "unfollow";
+        username: string;
         githubToken?: string | undefined;
     }, {
         error: string;
@@ -3028,8 +3028,8 @@ export declare const githubTools: ({
         repo: string;
         content: string;
         owner: string;
-        githubToken?: string | undefined;
         encoding?: "utf-8" | "base64" | undefined;
+        githubToken?: string | undefined;
     }, {
         error: string;
         sha?: undefined;

package/dist/toolkits/gmail/manifest.js

@@ -1,6 +1,6 @@
 import { defineToolkit, defineTool } from '../../core/define.js';
 import { GMAIL_ICON } from './icon.js';
-import { listMessages, getMessage, sendMessage, createDraft, listDrafts, getDraft, sendDraft, deleteDraft, listThreads, getThread, replyToThread, listLabels, modifyMessageLabels, trashMessage, untrashMessage, } from './tools/index.js';
+import { listMessages, getMessage, sendMessage, createDraft, listDrafts, getDraft, sendDraft, deleteDraft, listThreads, getThread, replyToThread, listLabels, modifyMessageLabels, trashMessage, untrashMessage, batchDeleteMessages, batchModifyMessages, createFilter, createLabel, deleteFilter, deleteLabel, deleteMessage, deleteThread, forwardMessage, getAttachment, getAutoForwarding, getContacts, getFilter, } from './tools/index.js';
 export default defineToolkit({
     id: 'gmail',
     displayName: 'Gmail',
@@ -21,6 +21,8 @@ export default defineToolkit({
                 'https://www.googleapis.com/auth/gmail.compose',
                 'https://www.googleapis.com/auth/gmail.modify',
                 'https://www.googleapis.com/auth/gmail.labels',
+                'https://www.googleapis.com/auth/gmail.settings.basic',
+                'https://www.googleapis.com/auth/contacts.readonly',
             ],
             exchangeStyle: 'form',
             extraAuthParams: { access_type: 'offline', prompt: 'consent' },
@@ -29,7 +31,7 @@ export default defineToolkit({
             stateCookie: 'google_oauth_state',
         },
     },
-    allowedHosts: ['gmail.googleapis.com', 'www.googleapis.com'],
+    allowedHosts: ['gmail.googleapis.com', 'www.googleapis.com', 'people.googleapis.com'],
     tools: [
         defineTool({
             name: 'gmailListMessages',
@@ -121,6 +123,84 @@ export default defineToolkit({
             requiredAuth: 'gmailToken',
             scope: 'write',
         }),
+        defineTool({
+            name: 'gmailBatchDeleteMessages',
+            tool: batchDeleteMessages,
+            requiredAuth: 'gmailToken',
+            scope: 'delete',
+        }),
+        defineTool({
+            name: 'gmailBatchModifyMessages',
+            tool: batchModifyMessages,
+            requiredAuth: 'gmailToken',
+            scope: 'write',
+        }),
+        defineTool({
+            name: 'gmailCreateFilter',
+            tool: createFilter,
+            requiredAuth: 'gmailToken',
+            scope: 'write',
+        }),
+        defineTool({
+            name: 'gmailCreateLabel',
+            tool: createLabel,
+            requiredAuth: 'gmailToken',
+            scope: 'write',
+        }),
+        defineTool({
+            name: 'gmailDeleteFilter',
+            tool: deleteFilter,
+            requiredAuth: 'gmailToken',
+            scope: 'delete',
+        }),
+        defineTool({
+            name: 'gmailDeleteLabel',
+            tool: deleteLabel,
+            requiredAuth: 'gmailToken',
+            scope: 'delete',
+        }),
+        defineTool({
+            name: 'gmailDeleteMessage',
+            tool: deleteMessage,
+            requiredAuth: 'gmailToken',
+            scope: 'delete',
+        }),
+        defineTool({
+            name: 'gmailDeleteThread',
+            tool: deleteThread,
+            requiredAuth: 'gmailToken',
+            scope: 'delete',
+        }),
+        defineTool({
+            name: 'gmailForwardMessage',
+            tool: forwardMessage,
+            requiredAuth: 'gmailToken',
+            scope: 'write',
+        }),
+        defineTool({
+            name: 'gmailGetAttachment',
+            tool: getAttachment,
+            requiredAuth: 'gmailToken',
+            scope: 'read',
+        }),
+        defineTool({
+            name: 'gmailGetAutoForwarding',
+            tool: getAutoForwarding,
+            requiredAuth: 'gmailToken',
+            scope: 'read',
+        }),
+        defineTool({
+            name: 'gmailGetContacts',
+            tool: getContacts,
+            requiredAuth: 'gmailToken',
+            scope: 'read',
+        }),
+        defineTool({
+            name: 'gmailGetFilter',
+            tool: getFilter,
+            requiredAuth: 'gmailToken',
+            scope: 'read',
+        }),
     ],
     meta: { since: '0.0.1' },
 });

package/dist/toolkits/gmail/tools/batch-delete-messages.d.ts

@@ -0,0 +1,26 @@
+export declare const batchDeleteMessages: import("ai").Tool<{
+    messageIds: string[];
+    gmailToken?: string | undefined;
+}, {
+    error: string;
+    details: any;
+    success?: undefined;
+    deletedCount?: undefined;
+    messageIds?: undefined;
+    message?: undefined;
+} | {
+    success: boolean;
+    deletedCount: number;
+    messageIds: string[];
+    error?: undefined;
+    details?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    details?: undefined;
+    success?: undefined;
+    deletedCount?: undefined;
+    messageIds?: undefined;
+}>;
+//# sourceMappingURL=batch-delete-messages.d.ts.map

package/dist/toolkits/gmail/tools/batch-delete-messages.js

@@ -0,0 +1,33 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+export const batchDeleteMessages = tool({
+    description: 'Permanently delete multiple Gmail messages in one request. This bypasses Trash and cannot be undone.',
+    inputSchema: z.object({
+        gmailToken: z.string().optional().describe('Injected by system; do not provide'),
+        messageIds: z.array(z.string()).min(1).max(1000).describe('Message IDs to permanently delete'),
+    }),
+    execute: async ({ gmailToken, messageIds }) => {
+        try {
+            const response = await fetch('https://gmail.googleapis.com/gmail/v1/users/me/messages/batchDelete', {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${gmailToken}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({ ids: messageIds }),
+            });
+            if (!response.ok) {
+                const error = await response.json();
+                return { error: 'Failed to batch delete messages', details: error };
+            }
+            return { success: true, deletedCount: messageIds.length, messageIds };
+        }
+        catch (error) {
+            return {
+                error: 'Error batch deleting messages',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=batch-delete-messages.js.map

package/dist/toolkits/gmail/tools/batch-modify-messages.d.ts

@@ -0,0 +1,34 @@
+export declare const batchModifyMessages: import("ai").Tool<{
+    messageIds: string[];
+    gmailToken?: string | undefined;
+    addLabelIds?: string[] | undefined;
+    removeLabelIds?: string[] | undefined;
+}, {
+    error: string;
+    details: any;
+    success?: undefined;
+    modifiedCount?: undefined;
+    messageIds?: undefined;
+    addLabelIds?: undefined;
+    removeLabelIds?: undefined;
+    message?: undefined;
+} | {
+    success: boolean;
+    modifiedCount: number;
+    messageIds: string[];
+    addLabelIds: string[];
+    removeLabelIds: string[];
+    error?: undefined;
+    details?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    details?: undefined;
+    success?: undefined;
+    modifiedCount?: undefined;
+    messageIds?: undefined;
+    addLabelIds?: undefined;
+    removeLabelIds?: undefined;
+}>;
+//# sourceMappingURL=batch-modify-messages.d.ts.map