@rnsk/toolkits 0.0.2 → 0.0.4

package/dist/toolkits/gmail/icon.js

@@ -4,22 +4,22 @@ const SVG = `<svg width="800" height="636.36322" fill="none" viewBox="0 0 800 63
   <path fill="url(#b)" d="M 141.93685,20.255746 C 105.42331,-10.435083 50.946177,-5.7169131 20.255349,30.796627 -10.435479,67.305622 -5.7173098,121.78275 30.79623,152.47813 l 345.80818,290.6765 a 36.36354,36.36354 0 0 0 46.79533,0 L 769.20792,152.47358 C 805.71691,121.78275 810.43508,67.305622 779.74426,30.792081 749.05343,-5.7169131 694.5763,-10.435083 658.0673,20.255746 L 399.9998,237.18245 Z" id="path3" style="fill:url(#b);stroke-width:4.54544"/>
   <defs id="defs16">
     <linearGradient id="a" x1="165" x2="165" y1="44" y2="166" gradientUnits="userSpaceOnUse" gradientTransform="matrix(4.5454426,0,0,4.5454426,-36.362684,-118.18025)">
-      <stop stopColor="#60d673" id="stop3"/>
-      <stop offset=".17" stopColor="#42c868" id="stop4"/>
-      <stop offset=".39" stopColor="#0ebc5f" id="stop5"/>
-      <stop offset=".62" stopColor="#00a9bb" id="stop6"/>
-      <stop offset=".86" stopColor="#3c90ff" id="stop7"/>
-      <stop offset="1" stopColor="#3186ff" id="stop8"/>
+      <stop stop-color="#60d673" id="stop3"/>
+      <stop offset=".17" stop-color="#42c868" id="stop4"/>
+      <stop offset=".39" stop-color="#0ebc5f" id="stop5"/>
+      <stop offset=".62" stop-color="#00a9bb" id="stop6"/>
+      <stop offset=".86" stop-color="#3c90ff" id="stop7"/>
+      <stop offset="1" stop-color="#3186ff" id="stop8"/>
     </linearGradient>
     <linearGradient id="b" x1="8" x2="184" y1="46.130001" y2="46.130001" gradientUnits="userSpaceOnUse" gradientTransform="matrix(4.5454426,0,0,4.5454426,-36.362684,-118.18025)">
-      <stop offset=".08" stopColor="#ff63a0" id="stop9"/>
-      <stop offset=".3" stopColor="#fc413d" id="stop10"/>
-      <stop offset=".5" stopColor="#fc413d" id="stop11"/>
-      <stop offset=".65" stopColor="#fc413d" id="stop12"/>
-      <stop offset=".72" stopColor="#fc5c30" id="stop13"/>
-      <stop offset=".86" stopColor="#feb10c" id="stop14"/>
-      <stop offset=".91" stopColor="#fec700" id="stop15"/>
-      <stop offset=".96" stopColor="#ffdb0f" id="stop16"/>
+      <stop offset=".08" stop-color="#ff63a0" id="stop9"/>
+      <stop offset=".3" stop-color="#fc413d" id="stop10"/>
+      <stop offset=".5" stop-color="#fc413d" id="stop11"/>
+      <stop offset=".65" stop-color="#fc413d" id="stop12"/>
+      <stop offset=".72" stop-color="#fc5c30" id="stop13"/>
+      <stop offset=".86" stop-color="#feb10c" id="stop14"/>
+      <stop offset=".91" stop-color="#fec700" id="stop15"/>
+      <stop offset=".96" stop-color="#ffdb0f" id="stop16"/>
     </linearGradient>
   </defs>
 </svg>`;

package/dist/toolkits/gmail/manifest.js

@@ -1,12 +1,10 @@
 import { defineToolkit, defineTool } from '../../core/define.js';
 import { GMAIL_ICON } from './icon.js';
-import { listMessages } from './tools/list-messages.js';
-import { getMessage } from './tools/get-message.js';
-import { sendMessage } from './tools/send-message.js';
+import { listMessages, getMessage, sendMessage, createDraft, listDrafts, getDraft, sendDraft, deleteDraft, listThreads, getThread, replyToThread, listLabels, modifyMessageLabels, trashMessage, untrashMessage, } from './tools/index.js';
 export default defineToolkit({
     id: 'gmail',
     displayName: 'Gmail',
-    shortDescription: 'List, read, and send emails.',
+    shortDescription: 'Read, search, draft, send, and organize emails and threads.',
     category: 'Collaboration & Communication',
     icon: GMAIL_ICON,
     auth: {
@@ -20,10 +18,13 @@ export default defineToolkit({
             scopes: [
                 'https://www.googleapis.com/auth/gmail.readonly',
                 'https://www.googleapis.com/auth/gmail.send',
+                'https://www.googleapis.com/auth/gmail.compose',
+                'https://www.googleapis.com/auth/gmail.modify',
+                'https://www.googleapis.com/auth/gmail.labels',
             ],
             exchangeStyle: 'form',
             extraAuthParams: { access_type: 'offline', prompt: 'consent' },
-            connectDescription: 'Connect Gmail to read, draft, and send emails with AI-driven summarization.',
+            connectDescription: 'Connect Gmail to read, draft, send, search, and organize emails and conversation threads.',
             callbackPath: '/api/auth/gmail/callback',
             stateCookie: 'google_oauth_state',
         },
@@ -48,6 +49,78 @@ export default defineToolkit({
             requiredAuth: 'gmailToken',
             scope: 'write',
         }),
+        defineTool({
+            name: 'gmailCreateDraft',
+            tool: createDraft,
+            requiredAuth: 'gmailToken',
+            scope: 'write',
+        }),
+        defineTool({
+            name: 'gmailListDrafts',
+            tool: listDrafts,
+            requiredAuth: 'gmailToken',
+            scope: 'read',
+        }),
+        defineTool({
+            name: 'gmailGetDraft',
+            tool: getDraft,
+            requiredAuth: 'gmailToken',
+            scope: 'read',
+        }),
+        defineTool({
+            name: 'gmailSendDraft',
+            tool: sendDraft,
+            requiredAuth: 'gmailToken',
+            scope: 'write',
+        }),
+        defineTool({
+            name: 'gmailDeleteDraft',
+            tool: deleteDraft,
+            requiredAuth: 'gmailToken',
+            scope: 'delete',
+        }),
+        defineTool({
+            name: 'gmailListThreads',
+            tool: listThreads,
+            requiredAuth: 'gmailToken',
+            scope: 'read',
+        }),
+        defineTool({
+            name: 'gmailGetThread',
+            tool: getThread,
+            requiredAuth: 'gmailToken',
+            scope: 'read',
+        }),
+        defineTool({
+            name: 'gmailReplyToThread',
+            tool: replyToThread,
+            requiredAuth: 'gmailToken',
+            scope: 'write',
+        }),
+        defineTool({
+            name: 'gmailListLabels',
+            tool: listLabels,
+            requiredAuth: 'gmailToken',
+            scope: 'read',
+        }),
+        defineTool({
+            name: 'gmailModifyMessageLabels',
+            tool: modifyMessageLabels,
+            requiredAuth: 'gmailToken',
+            scope: 'write',
+        }),
+        defineTool({
+            name: 'gmailTrashMessage',
+            tool: trashMessage,
+            requiredAuth: 'gmailToken',
+            scope: 'delete',
+        }),
+        defineTool({
+            name: 'gmailUntrashMessage',
+            tool: untrashMessage,
+            requiredAuth: 'gmailToken',
+            scope: 'write',
+        }),
     ],
     meta: { since: '0.0.1' },
 });

package/dist/toolkits/gmail/tools/create-draft.d.ts

@@ -0,0 +1,34 @@
+export declare const createDraft: import("ai").Tool<{
+    body: string;
+    subject: string;
+    to: string;
+    gmailToken?: string | undefined;
+    threadId?: string | undefined;
+    cc?: string | undefined;
+    bcc?: string | undefined;
+}, {
+    error: string;
+    details: any;
+    success?: undefined;
+    draftId?: undefined;
+    messageId?: undefined;
+    threadId?: undefined;
+    message?: undefined;
+} | {
+    success: boolean;
+    draftId: any;
+    messageId: any;
+    threadId: any;
+    error?: undefined;
+    details?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    details?: undefined;
+    success?: undefined;
+    draftId?: undefined;
+    messageId?: undefined;
+    threadId?: undefined;
+}>;
+//# sourceMappingURL=create-draft.d.ts.map

package/dist/toolkits/gmail/tools/create-draft.js

@@ -0,0 +1,60 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+import { encodeRFC822Message } from './utils.js';
+export const createDraft = tool({
+    description: 'Create a draft email in Gmail without sending it immediately. Highly recommended for human-in-the-loop review.',
+    inputSchema: z.object({
+        gmailToken: z.string().optional().describe('Injected by system; do not provide'),
+        to: z.string().describe('Recipient email address'),
+        subject: z.string().describe('Email subject'),
+        body: z.string().describe('Email body (plain text)'),
+        cc: z.string().optional().describe('Optional CC recipient email address(es), comma-separated'),
+        bcc: z.string().optional().describe('Optional BCC recipient email address(es), comma-separated'),
+        threadId: z.string().optional().describe('Optional thread ID to associate the draft with an existing conversation thread'),
+    }),
+    execute: async ({ gmailToken, to, subject, body, cc, bcc, threadId }) => {
+        try {
+            const encodedMessage = encodeRFC822Message({
+                to,
+                subject,
+                body,
+                cc,
+                bcc,
+            });
+            const messagePayload = {
+                raw: encodedMessage,
+            };
+            if (threadId) {
+                messagePayload.threadId = threadId;
+            }
+            const response = await fetch('https://gmail.googleapis.com/gmail/v1/users/me/drafts', {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${gmailToken}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    message: messagePayload,
+                }),
+            });
+            if (!response.ok) {
+                const error = await response.json();
+                return { error: 'Failed to create draft', details: error };
+            }
+            const data = await response.json();
+            return {
+                success: true,
+                draftId: data.id,
+                messageId: data.message?.id,
+                threadId: data.message?.threadId,
+            };
+        }
+        catch (error) {
+            return {
+                error: 'Error creating draft',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=create-draft.js.map

package/dist/toolkits/gmail/tools/delete-draft.d.ts

@@ -0,0 +1,23 @@
+export declare const deleteDraft: import("ai").Tool<{
+    id: string;
+    gmailToken?: string | undefined;
+}, {
+    error: string;
+    details: any;
+    success?: undefined;
+    draftId?: undefined;
+    message?: undefined;
+} | {
+    success: boolean;
+    draftId: string;
+    error?: undefined;
+    details?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    details?: undefined;
+    success?: undefined;
+    draftId?: undefined;
+}>;
+//# sourceMappingURL=delete-draft.d.ts.map

package/dist/toolkits/gmail/tools/delete-draft.js

@@ -0,0 +1,34 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+export const deleteDraft = tool({
+    description: 'Permanently delete an existing Gmail draft by its draft ID.',
+    inputSchema: z.object({
+        gmailToken: z.string().optional().describe('Injected by system; do not provide'),
+        id: z.string().describe('The ID of the draft to delete'),
+    }),
+    execute: async ({ gmailToken, id }) => {
+        try {
+            const response = await fetch(`https://gmail.googleapis.com/gmail/v1/users/me/drafts/${id}`, {
+                method: 'DELETE',
+                headers: {
+                    Authorization: `Bearer ${gmailToken}`,
+                },
+            });
+            if (!response.ok && response.status !== 204) {
+                const error = await response.json().catch(() => ({ status: response.status }));
+                return { error: 'Failed to delete draft', details: error };
+            }
+            return {
+                success: true,
+                draftId: id,
+            };
+        }
+        catch (error) {
+            return {
+                error: 'Error deleting draft',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=delete-draft.js.map

package/dist/toolkits/gmail/tools/get-draft.d.ts

@@ -0,0 +1,32 @@
+export declare const getDraft: import("ai").Tool<{
+    id: string;
+    gmailToken?: string | undefined;
+}, {
+    error: string;
+    details: any;
+    id?: undefined;
+    message?: undefined;
+} | {
+    id: any;
+    message: {
+        id: any;
+        threadId: any;
+        labelIds: any;
+        snippet: any;
+        subject: any;
+        from: any;
+        to: any;
+        cc: any;
+        date: any;
+        messageIdHeader: any;
+        body: string;
+    } | null;
+    error?: undefined;
+    details?: undefined;
+} | {
+    error: string;
+    message: string;
+    details?: undefined;
+    id?: undefined;
+}>;
+//# sourceMappingURL=get-draft.d.ts.map

package/dist/toolkits/gmail/tools/get-draft.js

@@ -0,0 +1,36 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+import { extractMessageDetails } from './utils.js';
+export const getDraft = tool({
+    description: 'Get details, headers, and content of a specific Gmail draft by draft ID.',
+    inputSchema: z.object({
+        gmailToken: z.string().optional().describe('Injected by system; do not provide'),
+        id: z.string().describe('The ID of the draft to retrieve'),
+    }),
+    execute: async ({ gmailToken, id }) => {
+        try {
+            const response = await fetch(`https://gmail.googleapis.com/gmail/v1/users/me/drafts/${id}`, {
+                headers: {
+                    Authorization: `Bearer ${gmailToken}`,
+                },
+            });
+            if (!response.ok) {
+                const error = await response.json();
+                return { error: 'Failed to get draft', details: error };
+            }
+            const data = await response.json();
+            const messageDetails = data.message ? extractMessageDetails(data.message) : null;
+            return {
+                id: data.id,
+                message: messageDetails,
+            };
+        }
+        catch (error) {
+            return {
+                error: 'Error getting draft',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=get-draft.js.map

package/dist/toolkits/gmail/tools/get-message.d.ts

@@ -2,24 +2,28 @@ export declare const getMessage: import("ai").Tool<{
     id: string;
     gmailToken?: string | undefined;
 }, {
+    id: any;
+    threadId: any;
+    labelIds: any;
+    snippet: any;
+    subject: any;
+    from: any;
+    to: any;
+    cc: any;
+    date: any;
+    messageIdHeader: any;
+    body: string;
+} | {
     error: string;
     details: any;
     id?: undefined;
     threadId?: undefined;
     snippet?: undefined;
-    subject?: undefined;
-    from?: undefined;
-    date?: undefined;
-    body?: undefined;
     message?: undefined;
 } | {
     id: any;
     threadId: any;
     snippet: any;
-    subject: any;
-    from: any;
-    date: any;
-    body: string;
     error?: undefined;
     details?: undefined;
     message?: undefined;
@@ -30,9 +34,5 @@ export declare const getMessage: import("ai").Tool<{
     id?: undefined;
     threadId?: undefined;
     snippet?: undefined;
-    subject?: undefined;
-    from?: undefined;
-    date?: undefined;
-    body?: undefined;
 }>;
 //# sourceMappingURL=get-message.d.ts.map

package/dist/toolkits/gmail/tools/get-message.js

@@ -1,5 +1,6 @@
 import { tool } from 'ai';
 import { z } from 'zod';
+import { extractMessageDetails } from './utils.js';
 export const getMessage = tool({
     description: 'Get details of a specific Gmail message by ID.',
     inputSchema: z.object({
@@ -18,30 +19,8 @@ export const getMessage = tool({
                 return { error: 'Failed to get message', details: error };
             }
             const data = await response.json();
-            // Extract basic info
-            const headers = data.payload?.headers || [];
-            const subject = headers.find((h) => h.name.toLowerCase() === 'subject')?.value;
-            const from = headers.find((h) => h.name.toLowerCase() === 'from')?.value;
-            const date = headers.find((h) => h.name.toLowerCase() === 'date')?.value;
-            let body = '';
-            if (data.payload?.parts) {
-                const textPart = data.payload.parts.find((p) => p.mimeType === 'text/plain');
-                if (textPart?.body?.data) {
-                    body = Buffer.from(textPart.body.data, 'base64').toString();
-                }
-            }
-            else if (data.payload?.body?.data) {
-                body = Buffer.from(data.payload.body.data, 'base64').toString();
-            }
-            return {
-                id: data.id,
-                threadId: data.threadId,
-                snippet: data.snippet,
-                subject,
-                from,
-                date,
-                body: body.substring(0, 2000), // Limit body size
-            };
+            const details = extractMessageDetails(data);
+            return details || { id: data.id, threadId: data.threadId, snippet: data.snippet };
         }
         catch (error) {
             return {

package/dist/toolkits/gmail/tools/get-thread.d.ts

@@ -0,0 +1,29 @@
+export declare const getThread: import("ai").Tool<{
+    id: string;
+    gmailToken?: string | undefined;
+}, {
+    error: string;
+    details: any;
+    id?: undefined;
+    historyId?: undefined;
+    messageCount?: undefined;
+    messages?: undefined;
+    message?: undefined;
+} | {
+    id: any;
+    historyId: any;
+    messageCount: any;
+    messages: any;
+    error?: undefined;
+    details?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    details?: undefined;
+    id?: undefined;
+    historyId?: undefined;
+    messageCount?: undefined;
+    messages?: undefined;
+}>;
+//# sourceMappingURL=get-thread.d.ts.map

package/dist/toolkits/gmail/tools/get-thread.js

@@ -0,0 +1,39 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+import { extractMessageDetails } from './utils.js';
+export const getThread = tool({
+    description: 'Get details and all messages in a specific Gmail conversation thread by thread ID.',
+    inputSchema: z.object({
+        gmailToken: z.string().optional().describe('Injected by system; do not provide'),
+        id: z.string().describe('The ID of the conversation thread to retrieve'),
+    }),
+    execute: async ({ gmailToken, id }) => {
+        try {
+            const response = await fetch(`https://gmail.googleapis.com/gmail/v1/users/me/threads/${id}`, {
+                headers: {
+                    Authorization: `Bearer ${gmailToken}`,
+                },
+            });
+            if (!response.ok) {
+                const error = await response.json();
+                return { error: 'Failed to get thread', details: error };
+            }
+            const data = await response.json();
+            const rawMessages = data.messages || [];
+            const messages = rawMessages.map((msg) => extractMessageDetails(msg));
+            return {
+                id: data.id,
+                historyId: data.historyId,
+                messageCount: messages.length,
+                messages,
+            };
+        }
+        catch (error) {
+            return {
+                error: 'Error getting thread',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=get-thread.js.map

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

@@ -0,0 +1,17 @@
+export * from './utils.js';
+export * from './list-messages.js';
+export * from './get-message.js';
+export * from './send-message.js';
+export * from './create-draft.js';
+export * from './list-drafts.js';
+export * from './get-draft.js';
+export * from './send-draft.js';
+export * from './delete-draft.js';
+export * from './list-threads.js';
+export * from './get-thread.js';
+export * from './reply-to-thread.js';
+export * from './list-labels.js';
+export * from './modify-message-labels.js';
+export * from './trash-message.js';
+export * from './untrash-message.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,17 @@
+export * from './utils.js';
+export * from './list-messages.js';
+export * from './get-message.js';
+export * from './send-message.js';
+export * from './create-draft.js';
+export * from './list-drafts.js';
+export * from './get-draft.js';
+export * from './send-draft.js';
+export * from './delete-draft.js';
+export * from './list-threads.js';
+export * from './get-thread.js';
+export * from './reply-to-thread.js';
+export * from './list-labels.js';
+export * from './modify-message-labels.js';
+export * from './trash-message.js';
+export * from './untrash-message.js';
+//# sourceMappingURL=index.js.map

package/dist/toolkits/gmail/tools/list-drafts.d.ts

@@ -0,0 +1,28 @@
+export declare const listDrafts: import("ai").Tool<{
+    maxResults: number;
+    gmailToken?: string | undefined;
+    q?: string | undefined;
+    pageToken?: string | undefined;
+}, {
+    error: string;
+    details: any;
+    drafts?: undefined;
+    resultSizeEstimate?: undefined;
+    nextPageToken?: undefined;
+    message?: undefined;
+} | {
+    drafts: any;
+    resultSizeEstimate: any;
+    nextPageToken: any;
+    error?: undefined;
+    details?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    details?: undefined;
+    drafts?: undefined;
+    resultSizeEstimate?: undefined;
+    nextPageToken?: undefined;
+}>;
+//# sourceMappingURL=list-drafts.d.ts.map

package/dist/toolkits/gmail/tools/list-drafts.js

@@ -0,0 +1,43 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+export const listDrafts = tool({
+    description: 'List drafts in the Gmail mailbox. Optionally filter drafts with a search query.',
+    inputSchema: z.object({
+        gmailToken: z.string().optional().describe('Injected by system; do not provide'),
+        q: z.string().optional().describe('Search query (same format as Gmail search box)'),
+        maxResults: z.number().optional().default(10).describe('Maximum number of drafts to return'),
+        pageToken: z.string().optional().describe('Token for retrieving the next page of drafts'),
+    }),
+    execute: async ({ gmailToken, q, maxResults, pageToken }) => {
+        try {
+            const url = new URL('https://gmail.googleapis.com/gmail/v1/users/me/drafts');
+            if (q)
+                url.searchParams.append('q', q);
+            url.searchParams.append('maxResults', maxResults.toString());
+            if (pageToken)
+                url.searchParams.append('pageToken', pageToken);
+            const response = await fetch(url.toString(), {
+                headers: {
+                    Authorization: `Bearer ${gmailToken}`,
+                },
+            });
+            if (!response.ok) {
+                const error = await response.json();
+                return { error: 'Failed to list drafts', details: error };
+            }
+            const data = await response.json();
+            return {
+                drafts: data.drafts || [],
+                resultSizeEstimate: data.resultSizeEstimate,
+                nextPageToken: data.nextPageToken,
+            };
+        }
+        catch (error) {
+            return {
+                error: 'Error listing drafts',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=list-drafts.js.map

package/dist/toolkits/gmail/tools/list-labels.d.ts

@@ -0,0 +1,20 @@
+export declare const listLabels: import("ai").Tool<{
+    type: "all" | "system" | "user";
+    gmailToken?: string | undefined;
+}, {
+    error: string;
+    details: any;
+    labels?: undefined;
+    message?: undefined;
+} | {
+    labels: any;
+    error?: undefined;
+    details?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    details?: undefined;
+    labels?: undefined;
+}>;
+//# sourceMappingURL=list-labels.d.ts.map