@rnsk/toolkits 0.0.7 → 0.0.8

package/dist/toolkits/figma/tools/get-projects-in-a-team.js

@@ -0,0 +1,26 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { figmaRequest, figmaTokenField } from './client.js';
+export const getProjectsInATeam = tool({
+    description: 'Lists projects in a team visible to you. Find team_id in the team page URL (.../team/TEAM_ID/...).',
+    inputSchema: z.object({
+        figmaToken: figmaTokenField,
+        teamId: z.string().describe('Team ID from the team page URL'),
+    }),
+    execute: async ({ figmaToken, teamId }) => {
+        try {
+            const result = await figmaRequest(figmaToken, `/v1/teams/${teamId}/projects`);
+            if (!result.ok)
+                return { error: 'Failed to get team projects', details: result.error };
+            return result.data;
+        }
+        catch (error) {
+            return {
+                error: 'Error getting team projects',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=get-projects-in-a-team.js.map

package/dist/toolkits/figma/tools/get-published-variables.d.ts

@@ -0,0 +1,5 @@
+export declare const getPublishedVariables: import("ai").Tool<{
+    figmaToken: string;
+    fileKey: string;
+}, any>;
+//# sourceMappingURL=get-published-variables.d.ts.map

package/dist/toolkits/figma/tools/get-published-variables.js

@@ -0,0 +1,26 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { figmaRequest, figmaTokenField } from './client.js';
+export const getPublishedVariables = tool({
+    description: 'Gets published variables from a main library file (Enterprise members only). Omits mode-specific values — use getLocalVariables for those.',
+    inputSchema: z.object({
+        figmaToken: figmaTokenField,
+        fileKey: z.string().describe('Main file key (branches not supported)'),
+    }),
+    execute: async ({ figmaToken, fileKey }) => {
+        try {
+            const result = await figmaRequest(figmaToken, `/v1/files/${fileKey}/variables/published`);
+            if (!result.ok)
+                return { error: 'Failed to get published variables', details: result.error };
+            return result.data;
+        }
+        catch (error) {
+            return {
+                error: 'Error getting published variables',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=get-published-variables.js.map

package/dist/toolkits/figma/tools/get-reactions-for-a-comment.d.ts

@@ -0,0 +1,7 @@
+export declare const getReactionsForAComment: import("ai").Tool<{
+    commentId: string;
+    figmaToken: string;
+    fileKey: string;
+    cursor?: string | undefined;
+}, any>;
+//# sourceMappingURL=get-reactions-for-a-comment.d.ts.map

package/dist/toolkits/figma/tools/get-reactions-for-a-comment.js

@@ -0,0 +1,30 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { figmaRequest, figmaTokenField } from './client.js';
+export const getReactionsForAComment = tool({
+    description: 'Lists reactions on a comment with pagination. Use the cursor from a previous response for the next page.',
+    inputSchema: z.object({
+        figmaToken: figmaTokenField,
+        fileKey: z.string().describe('File or branch key from the file URL'),
+        commentId: z.string().describe('Comment ID to list reactions for'),
+        cursor: z.string().optional().describe('Pagination cursor; omit for the first page'),
+    }),
+    execute: async ({ figmaToken, fileKey, commentId, cursor }) => {
+        try {
+            const result = await figmaRequest(figmaToken, `/v1/files/${fileKey}/comments/${commentId}/reactions`, {
+                query: { cursor },
+            });
+            if (!result.ok)
+                return { error: 'Failed to get reactions', details: result.error };
+            return result.data;
+        }
+        catch (error) {
+            return {
+                error: 'Error getting reactions',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=get-reactions-for-a-comment.js.map

package/dist/toolkits/figma/tools/get-scim-service-provider-config.d.ts

@@ -0,0 +1,4 @@
+export declare const getScimServiceProviderConfig: import("ai").Tool<{
+    figmaToken: string;
+}, any>;
+//# sourceMappingURL=get-scim-service-provider-config.d.ts.map

package/dist/toolkits/figma/tools/get-scim-service-provider-config.js

@@ -0,0 +1,27 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { FIGMA_SCIM_BASE, figmaRequest, figmaTokenField } from './client.js';
+export const getScimServiceProviderConfig = tool({
+    description: 'Returns SCIM capabilities (patch, bulk, filter, sort, auth schemes) for account provisioning. No parameters needed.',
+    inputSchema: z.object({
+        figmaToken: figmaTokenField,
+    }),
+    execute: async ({ figmaToken }) => {
+        try {
+            const result = await figmaRequest(figmaToken, '/ServiceProviderConfig', {
+                base: FIGMA_SCIM_BASE,
+            });
+            if (!result.ok)
+                return { error: 'Failed to get SCIM config', details: result.error };
+            return result.data;
+        }
+        catch (error) {
+            return {
+                error: 'Error getting SCIM config',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=get-scim-service-provider-config.js.map

package/dist/toolkits/figma/tools/get-style.d.ts

@@ -0,0 +1,5 @@
+export declare const getStyle: import("ai").Tool<{
+    key: string;
+    figmaToken: string;
+}, any>;
+//# sourceMappingURL=get-style.d.ts.map

package/dist/toolkits/figma/tools/get-style.js

@@ -0,0 +1,26 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { figmaRequest, figmaTokenField } from './client.js';
+export const getStyle = tool({
+    description: 'Fetches metadata for a published team-library style by its 40-char hex key (from file/team style listings).',
+    inputSchema: z.object({
+        figmaToken: figmaTokenField,
+        key: z.string().describe('Unique style key'),
+    }),
+    execute: async ({ figmaToken, key }) => {
+        try {
+            const result = await figmaRequest(figmaToken, `/v1/styles/${key}`);
+            if (!result.ok)
+                return { error: 'Failed to get style', details: result.error };
+            return result.data;
+        }
+        catch (error) {
+            return {
+                error: 'Error getting style',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=get-style.js.map

package/dist/toolkits/figma/tools/get-team-component-sets.d.ts

@@ -0,0 +1,8 @@
+export declare const getTeamComponentSets: import("ai").Tool<{
+    teamId: string;
+    figmaToken: string;
+    before?: number | undefined;
+    after?: number | undefined;
+    pageSize?: number | undefined;
+}, any>;
+//# sourceMappingURL=get-team-component-sets.d.ts.map

package/dist/toolkits/figma/tools/get-team-component-sets.js

@@ -0,0 +1,33 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { figmaRequest, figmaTokenField } from './client.js';
+export const getTeamComponentSets = tool({
+    description: 'Lists published component sets in a team library with pagination.',
+    inputSchema: z.object({
+        figmaToken: figmaTokenField,
+        teamId: z.string().describe('Team ID from the team page URL'),
+        pageSize: z.number().optional().describe('Sets per page (default 30)'),
+        after: z.number().optional().describe('Cursor for next page (exclusive with before)'),
+        before: z.number().optional().describe('Cursor for previous page (exclusive with after)'),
+    }),
+    execute: async ({ figmaToken, teamId, pageSize, after, before }) => {
+        try {
+            if (after !== undefined && before !== undefined)
+                return { error: 'after and before are mutually exclusive' };
+            const result = await figmaRequest(figmaToken, `/v1/teams/${teamId}/component_sets`, {
+                query: { page_size: pageSize, after, before },
+            });
+            if (!result.ok)
+                return { error: 'Failed to get team component sets', details: result.error };
+            return result.data;
+        }
+        catch (error) {
+            return {
+                error: 'Error getting team component sets',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=get-team-component-sets.js.map

package/dist/toolkits/figma/tools/get-team-components.d.ts

@@ -0,0 +1,8 @@
+export declare const getTeamComponents: import("ai").Tool<{
+    teamId: string;
+    figmaToken: string;
+    before?: number | undefined;
+    after?: number | undefined;
+    pageSize?: number | undefined;
+}, any>;
+//# sourceMappingURL=get-team-components.d.ts.map

package/dist/toolkits/figma/tools/get-team-components.js

@@ -0,0 +1,33 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { figmaRequest, figmaTokenField } from './client.js';
+export const getTeamComponents = tool({
+    description: 'Lists published components in a team library with pagination. Find team_id in the team page URL (.../team/TEAM_ID/...).',
+    inputSchema: z.object({
+        figmaToken: figmaTokenField,
+        teamId: z.string().describe('Team ID from the team page URL'),
+        pageSize: z.number().optional().describe('Components per page (max 1000, default 30)'),
+        after: z.number().optional().describe('Cursor for next page (exclusive with before)'),
+        before: z.number().optional().describe('Cursor for previous page (exclusive with after)'),
+    }),
+    execute: async ({ figmaToken, teamId, pageSize, after, before }) => {
+        try {
+            if (after !== undefined && before !== undefined)
+                return { error: 'after and before are mutually exclusive' };
+            const result = await figmaRequest(figmaToken, `/v1/teams/${teamId}/components`, {
+                query: { page_size: pageSize, after, before },
+            });
+            if (!result.ok)
+                return { error: 'Failed to get team components', details: result.error };
+            return result.data;
+        }
+        catch (error) {
+            return {
+                error: 'Error getting team components',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=get-team-components.js.map

package/dist/toolkits/figma/tools/get-team-styles.d.ts

@@ -0,0 +1,8 @@
+export declare const getTeamStyles: import("ai").Tool<{
+    teamId: string;
+    figmaToken: string;
+    before?: number | undefined;
+    after?: number | undefined;
+    pageSize?: number | undefined;
+}, any>;
+//# sourceMappingURL=get-team-styles.d.ts.map

package/dist/toolkits/figma/tools/get-team-styles.js

@@ -0,0 +1,33 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { figmaRequest, figmaTokenField } from './client.js';
+export const getTeamStyles = tool({
+    description: 'Lists published styles (fills, text, effects, grids) in a team library with pagination. Empty list means nothing published.',
+    inputSchema: z.object({
+        figmaToken: figmaTokenField,
+        teamId: z.string().describe('Team ID from the team page URL'),
+        pageSize: z.number().optional().describe('Styles per page (max 100, default 30)'),
+        after: z.number().optional().describe('Cursor for next page (exclusive with before)'),
+        before: z.number().optional().describe('Cursor for previous page (exclusive with after)'),
+    }),
+    execute: async ({ figmaToken, teamId, pageSize, after, before }) => {
+        try {
+            if (after !== undefined && before !== undefined)
+                return { error: 'after and before are mutually exclusive' };
+            const result = await figmaRequest(figmaToken, `/v1/teams/${teamId}/styles`, {
+                query: { page_size: pageSize, after, before },
+            });
+            if (!result.ok)
+                return { error: 'Failed to get team styles', details: result.error };
+            return result.data;
+        }
+        catch (error) {
+            return {
+                error: 'Error getting team styles',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=get-team-styles.js.map

package/dist/toolkits/figma/tools/get-team-webhooks.d.ts

@@ -0,0 +1,6 @@
+export declare const getTeamWebhooks: import("ai").Tool<{
+    figmaToken: string;
+    contextId: string;
+    context?: "team" | "file" | "project" | undefined;
+}, any>;
+//# sourceMappingURL=get-team-webhooks.d.ts.map

package/dist/toolkits/figma/tools/get-team-webhooks.js

@@ -0,0 +1,29 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { figmaRequest, figmaTokenField } from './client.js';
+export const getTeamWebhooks = tool({
+    description: 'Lists webhooks for a team, project, or file context (V2 API). Extract context IDs from Figma URLs or discoverFigmaResources.',
+    inputSchema: z.object({
+        figmaToken: figmaTokenField,
+        contextId: z.string().describe('Team, project, or file ID to query'),
+        context: z.enum(['team', 'project', 'file']).optional().describe('Context type (default team)'),
+    }),
+    execute: async ({ figmaToken, contextId, context }) => {
+        try {
+            const result = await figmaRequest(figmaToken, '/v2/webhooks', {
+                query: { context: context ?? 'team', context_id: contextId },
+            });
+            if (!result.ok)
+                return { error: 'Failed to get webhooks', details: result.error };
+            return result.data;
+        }
+        catch (error) {
+            return {
+                error: 'Error getting webhooks',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=get-team-webhooks.js.map

package/dist/toolkits/figma/tools/get-versions-of-a-file.d.ts

@@ -0,0 +1,8 @@
+export declare const getVersionsOfAFile: import("ai").Tool<{
+    figmaToken: string;
+    fileKey: string;
+    before?: number | undefined;
+    after?: number | undefined;
+    pageSize?: number | undefined;
+}, any>;
+//# sourceMappingURL=get-versions-of-a-file.d.ts.map

package/dist/toolkits/figma/tools/get-versions-of-a-file.js

@@ -0,0 +1,31 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { figmaRequest, figmaTokenField } from './client.js';
+export const getVersionsOfAFile = tool({
+    description: 'Retrieves version history for a file or branch. Use before/after cursors and pageSize for pagination.',
+    inputSchema: z.object({
+        figmaToken: figmaTokenField,
+        fileKey: z.string().describe('File or branch key from the file URL'),
+        pageSize: z.number().optional().describe('Versions per page (default 30)'),
+        before: z.number().optional().describe('Return versions created strictly before this version ID'),
+        after: z.number().optional().describe('Return versions created strictly after this version ID'),
+    }),
+    execute: async ({ figmaToken, fileKey, pageSize, before, after }) => {
+        try {
+            const result = await figmaRequest(figmaToken, `/v1/files/${fileKey}/versions`, {
+                query: { page_size: pageSize, before, after },
+            });
+            if (!result.ok)
+                return { error: 'Failed to get file versions', details: result.error };
+            return result.data;
+        }
+        catch (error) {
+            return {
+                error: 'Error getting file versions',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=get-versions-of-a-file.js.map

package/dist/toolkits/figma/tools/get-webhook-requests.d.ts

@@ -0,0 +1,5 @@
+export declare const getWebhookRequests: import("ai").Tool<{
+    figmaToken: string;
+    webhookId: string;
+}, any>;
+//# sourceMappingURL=get-webhook-requests.d.ts.map

package/dist/toolkits/figma/tools/get-webhook-requests.js

@@ -0,0 +1,26 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { figmaRequest, figmaTokenField } from './client.js';
+export const getWebhookRequests = tool({
+    description: 'Shows delivery history for a webhook from the last seven days, with endpoint responses.',
+    inputSchema: z.object({
+        figmaToken: figmaTokenField,
+        webhookId: z.string().describe('Webhook subscription ID'),
+    }),
+    execute: async ({ figmaToken, webhookId }) => {
+        try {
+            const result = await figmaRequest(figmaToken, `/v2/webhooks/${webhookId}/requests`);
+            if (!result.ok)
+                return { error: 'Failed to get webhook requests', details: result.error };
+            return result.data;
+        }
+        catch (error) {
+            return {
+                error: 'Error getting webhook requests',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=get-webhook-requests.js.map