@invect/core 0.0.1

package/dist/actions/gmail/list-messages.cjs

@@ -0,0 +1,195 @@
+require("../../_virtual/_rolldown/runtime.cjs");
+const require_define_action = require("../define-action.cjs");
+const require_providers = require("../providers.cjs");
+let zod_v4 = require("zod/v4");
+//#region src/actions/gmail/list-messages.ts
+/**
+* gmail.list_messages — List / search Gmail messages
+*
+* Searches and retrieves email metadata from Gmail via the Gmail API.
+* Requires a Google Gmail OAuth2 credential.
+*/
+const GMAIL_API_BASE = "https://gmail.googleapis.com/gmail/v1/users/me";
+function getHeader(headers, name) {
+	return headers?.find((h) => h.name.toLowerCase() === name.toLowerCase())?.value;
+}
+function parseMessage(msg) {
+	const headers = msg.payload?.headers;
+	return {
+		id: msg.id,
+		threadId: msg.threadId,
+		from: getHeader(headers, "From"),
+		to: getHeader(headers, "To"),
+		subject: getHeader(headers, "Subject"),
+		date: getHeader(headers, "Date"),
+		snippet: msg.snippet,
+		labels: msg.labelIds,
+		isUnread: msg.labelIds?.includes("UNREAD"),
+		isStarred: msg.labelIds?.includes("STARRED")
+	};
+}
+const paramsSchema = zod_v4.z.object({
+	credentialId: zod_v4.z.string().min(1, "Gmail credential is required"),
+	maxResults: zod_v4.z.number().int().min(1).max(100).optional().default(10),
+	query: zod_v4.z.string().optional().default(""),
+	labelIds: zod_v4.z.array(zod_v4.z.string()).optional().default([]),
+	includeSpamTrash: zod_v4.z.boolean().optional().default(false)
+});
+const gmailListMessagesAction = require_define_action.defineAction({
+	id: "gmail.list_messages",
+	name: "List Emails",
+	description: "Search and list emails from Gmail inbox. Use this when the user asks to check their email, find specific emails, or search their inbox.",
+	provider: require_providers.GMAIL_PROVIDER,
+	actionCategory: "read",
+	tags: [
+		"gmail",
+		"google",
+		"email",
+		"mail",
+		"inbox",
+		"list",
+		"search",
+		"messages",
+		"read",
+		"oauth2"
+	],
+	credential: {
+		required: true,
+		type: "oauth2",
+		oauth2Provider: "google_gmail",
+		description: "Gmail OAuth2 credential for authentication"
+	},
+	params: {
+		schema: paramsSchema,
+		fields: [
+			{
+				name: "credentialId",
+				label: "Gmail Credential",
+				type: "text",
+				required: true,
+				description: "Gmail OAuth2 credential for authentication",
+				aiProvided: false
+			},
+			{
+				name: "maxResults",
+				label: "Max Results",
+				type: "number",
+				defaultValue: 10,
+				description: "Maximum number of emails to return (1–100)",
+				aiProvided: true
+			},
+			{
+				name: "query",
+				label: "Search Query",
+				type: "text",
+				placeholder: "is:unread from:someone@example.com",
+				description: "Gmail search query. Examples: 'from:user@example.com', 'subject:meeting', 'is:unread', 'has:attachment'",
+				aiProvided: true
+			},
+			{
+				name: "labelIds",
+				label: "Label Filter",
+				type: "json",
+				defaultValue: [],
+				description: "Filter by label IDs (JSON array). Common: [\"INBOX\"], [\"UNREAD\"], [\"STARRED\"]",
+				extended: true,
+				aiProvided: true
+			},
+			{
+				name: "includeSpamTrash",
+				label: "Include Spam/Trash",
+				type: "boolean",
+				defaultValue: false,
+				description: "Include messages from SPAM and TRASH folders",
+				extended: true
+			}
+		]
+	},
+	async execute(params, context) {
+		const { credentialId, maxResults, query, labelIds, includeSpamTrash } = params;
+		let credential = context.credential;
+		if (!credential && context.functions?.getCredential) credential = await context.functions.getCredential(credentialId);
+		if (!credential) return {
+			success: false,
+			error: `Credential not found: ${credentialId}. Please create a Gmail OAuth2 credential.`
+		};
+		if (credential.authType !== "oauth2") return {
+			success: false,
+			error: `Invalid credential type: ${credential.authType}. Gmail requires an OAuth2 credential.`
+		};
+		const accessToken = credential.config?.accessToken;
+		if (!accessToken) return {
+			success: false,
+			error: "No valid access token in credential. Please re-authorize the Gmail credential."
+		};
+		context.logger.debug("Executing Gmail list messages", {
+			maxResults,
+			hasQuery: !!query,
+			labelIds
+		});
+		try {
+			const url = new URL(`${GMAIL_API_BASE}/messages`);
+			url.searchParams.set("maxResults", String(Math.min(Math.max(1, maxResults), 100)));
+			if (query?.trim()) url.searchParams.set("q", query);
+			if (labelIds && labelIds.length > 0) for (const labelId of labelIds) url.searchParams.append("labelIds", labelId);
+			if (includeSpamTrash) url.searchParams.set("includeSpamTrash", "true");
+			const listResponse = await fetch(url.toString(), { headers: {
+				Authorization: `Bearer ${accessToken}`,
+				Accept: "application/json"
+			} });
+			if (!listResponse.ok) {
+				const errorText = await listResponse.text();
+				return {
+					success: false,
+					error: `Gmail API error: ${listResponse.status} ${listResponse.statusText} - ${errorText}`
+				};
+			}
+			const listData = await listResponse.json();
+			if (!listData.messages || listData.messages.length === 0) return {
+				success: true,
+				output: {
+					messages: [],
+					totalEstimate: listData.resultSizeEstimate || 0,
+					query: query || null,
+					hasMore: false
+				}
+			};
+			const parsedMessages = (await Promise.all(listData.messages.map(async (msg) => {
+				const msgUrl = new URL(`${GMAIL_API_BASE}/messages/${msg.id}`);
+				msgUrl.searchParams.set("format", "metadata");
+				msgUrl.searchParams.set("metadataHeaders", "From");
+				msgUrl.searchParams.append("metadataHeaders", "To");
+				msgUrl.searchParams.append("metadataHeaders", "Subject");
+				msgUrl.searchParams.append("metadataHeaders", "Date");
+				const resp = await fetch(msgUrl.toString(), { headers: {
+					Authorization: `Bearer ${accessToken}`,
+					Accept: "application/json"
+				} });
+				return resp.ok ? await resp.json() : null;
+			}))).filter((msg) => msg !== null).map(parseMessage);
+			return {
+				success: true,
+				output: {
+					messages: parsedMessages,
+					totalEstimate: listData.resultSizeEstimate || parsedMessages.length,
+					query: query || null,
+					hasMore: !!listData.nextPageToken
+				},
+				metadata: {
+					messageCount: parsedMessages.length,
+					totalEstimate: listData.resultSizeEstimate,
+					hasMore: !!listData.nextPageToken
+				}
+			};
+		} catch (error) {
+			return {
+				success: false,
+				error: `Gmail operation failed: ${error instanceof Error ? error.message : String(error)}`
+			};
+		}
+	}
+});
+//#endregion
+exports.gmailListMessagesAction = gmailListMessagesAction;
+
+//# sourceMappingURL=list-messages.cjs.map

package/dist/actions/gmail/list-messages.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-messages.cjs","names":["z","defineAction","GMAIL_PROVIDER"],"sources":["../../../src/actions/gmail/list-messages.ts"],"sourcesContent":["/**\n * gmail.list_messages — List / search Gmail messages\n *\n * Searches and retrieves email metadata from Gmail via the Gmail API.\n * Requires a Google Gmail OAuth2 credential.\n */\n\nimport { defineAction } from '../define-action';\nimport { GMAIL_PROVIDER } from '../providers';\nimport { z } from 'zod/v4';\n\nconst GMAIL_API_BASE = 'https://gmail.googleapis.com/gmail/v1/users/me';\n\ninterface GmailListResponse {\n  messages?: Array<{ id: string; threadId: string }>;\n  nextPageToken?: string;\n  resultSizeEstimate?: number;\n}\n\ninterface GmailMessageResponse {\n  id: string;\n  threadId: string;\n  labelIds?: string[];\n  snippet?: string;\n  payload?: {\n    headers?: Array<{ name: string; value: string }>;\n  };\n}\n\ninterface ParsedEmail {\n  id: string;\n  threadId: string;\n  from?: string;\n  to?: string;\n  subject?: string;\n  date?: string;\n  snippet?: string;\n  labels?: string[];\n  isUnread?: boolean;\n  isStarred?: boolean;\n}\n\nfunction getHeader(\n  headers: Array<{ name: string; value: string }> | undefined,\n  name: string,\n): string | undefined {\n  return headers?.find((h) => h.name.toLowerCase() === name.toLowerCase())?.value;\n}\n\nfunction parseMessage(msg: GmailMessageResponse): ParsedEmail {\n  const headers = msg.payload?.headers;\n  return {\n    id: msg.id,\n    threadId: msg.threadId,\n    from: getHeader(headers, 'From'),\n    to: getHeader(headers, 'To'),\n    subject: getHeader(headers, 'Subject'),\n    date: getHeader(headers, 'Date'),\n    snippet: msg.snippet,\n    labels: msg.labelIds,\n    isUnread: msg.labelIds?.includes('UNREAD'),\n    isStarred: msg.labelIds?.includes('STARRED'),\n  };\n}\n\nconst paramsSchema = z.object({\n  credentialId: z.string().min(1, 'Gmail credential is required'),\n  maxResults: z.number().int().min(1).max(100).optional().default(10),\n  query: z.string().optional().default(''),\n  labelIds: z.array(z.string()).optional().default([]),\n  includeSpamTrash: z.boolean().optional().default(false),\n});\n\nexport const gmailListMessagesAction = defineAction({\n  id: 'gmail.list_messages',\n  name: 'List Emails',\n  description:\n    'Search and list emails from Gmail inbox. Use this when the user asks to check their email, find specific emails, or search their inbox.',\n  provider: GMAIL_PROVIDER,\n  actionCategory: 'read',\n  tags: [\n    'gmail',\n    'google',\n    'email',\n    'mail',\n    'inbox',\n    'list',\n    'search',\n    'messages',\n    'read',\n    'oauth2',\n  ],\n\n  credential: {\n    required: true,\n    type: 'oauth2',\n    oauth2Provider: 'google_gmail',\n    description: 'Gmail OAuth2 credential for authentication',\n  },\n\n  params: {\n    schema: paramsSchema,\n    fields: [\n      {\n        name: 'credentialId',\n        label: 'Gmail Credential',\n        type: 'text',\n        required: true,\n        description: 'Gmail OAuth2 credential for authentication',\n        aiProvided: false,\n      },\n      {\n        name: 'maxResults',\n        label: 'Max Results',\n        type: 'number',\n        defaultValue: 10,\n        description: 'Maximum number of emails to return (1–100)',\n        aiProvided: true,\n      },\n      {\n        name: 'query',\n        label: 'Search Query',\n        type: 'text',\n        placeholder: 'is:unread from:someone@example.com',\n        description:\n          \"Gmail search query. Examples: 'from:user@example.com', 'subject:meeting', 'is:unread', 'has:attachment'\",\n        aiProvided: true,\n      },\n      {\n        name: 'labelIds',\n        label: 'Label Filter',\n        type: 'json',\n        defaultValue: [],\n        description: 'Filter by label IDs (JSON array). Common: [\"INBOX\"], [\"UNREAD\"], [\"STARRED\"]',\n        extended: true,\n        aiProvided: true,\n      },\n      {\n        name: 'includeSpamTrash',\n        label: 'Include Spam/Trash',\n        type: 'boolean',\n        defaultValue: false,\n        description: 'Include messages from SPAM and TRASH folders',\n        extended: true,\n      },\n    ],\n  },\n\n  async execute(params, context) {\n    const { credentialId, maxResults, query, labelIds, includeSpamTrash } = params;\n\n    // Resolve credential\n    let credential = context.credential;\n    if (!credential && context.functions?.getCredential) {\n      credential = await context.functions.getCredential(credentialId);\n    }\n    if (!credential) {\n      return {\n        success: false,\n        error: `Credential not found: ${credentialId}. Please create a Gmail OAuth2 credential.`,\n      };\n    }\n    if (credential.authType !== 'oauth2') {\n      return {\n        success: false,\n        error: `Invalid credential type: ${credential.authType}. Gmail requires an OAuth2 credential.`,\n      };\n    }\n\n    const accessToken = credential.config?.accessToken as string;\n    if (!accessToken) {\n      return {\n        success: false,\n        error: 'No valid access token in credential. Please re-authorize the Gmail credential.',\n      };\n    }\n\n    context.logger.debug('Executing Gmail list messages', {\n      maxResults,\n      hasQuery: !!query,\n      labelIds,\n    });\n\n    try {\n      // Build list URL\n      const url = new URL(`${GMAIL_API_BASE}/messages`);\n      url.searchParams.set('maxResults', String(Math.min(Math.max(1, maxResults), 100)));\n\n      if (query?.trim()) {\n        url.searchParams.set('q', query);\n      }\n\n      if (labelIds && labelIds.length > 0) {\n        for (const labelId of labelIds) {\n          url.searchParams.append('labelIds', labelId);\n        }\n      }\n\n      if (includeSpamTrash) {\n        url.searchParams.set('includeSpamTrash', 'true');\n      }\n\n      const listResponse = await fetch(url.toString(), {\n        headers: {\n          Authorization: `Bearer ${accessToken}`,\n          Accept: 'application/json',\n        },\n      });\n\n      if (!listResponse.ok) {\n        const errorText = await listResponse.text();\n        return {\n          success: false,\n          error: `Gmail API error: ${listResponse.status} ${listResponse.statusText} - ${errorText}`,\n        };\n      }\n\n      const listData = (await listResponse.json()) as GmailListResponse;\n\n      if (!listData.messages || listData.messages.length === 0) {\n        return {\n          success: true,\n          output: {\n            messages: [],\n            totalEstimate: listData.resultSizeEstimate || 0,\n            query: query || null,\n            hasMore: false,\n          },\n        };\n      }\n\n      // Fetch metadata for each message\n      const messageDetails = await Promise.all(\n        listData.messages.map(async (msg) => {\n          const msgUrl = new URL(`${GMAIL_API_BASE}/messages/${msg.id}`);\n          msgUrl.searchParams.set('format', 'metadata');\n          msgUrl.searchParams.set('metadataHeaders', 'From');\n          msgUrl.searchParams.append('metadataHeaders', 'To');\n          msgUrl.searchParams.append('metadataHeaders', 'Subject');\n          msgUrl.searchParams.append('metadataHeaders', 'Date');\n\n          const resp = await fetch(msgUrl.toString(), {\n            headers: {\n              Authorization: `Bearer ${accessToken}`,\n              Accept: 'application/json',\n            },\n          });\n\n          return resp.ok ? ((await resp.json()) as GmailMessageResponse) : null;\n        }),\n      );\n\n      const parsedMessages = messageDetails\n        .filter((msg): msg is GmailMessageResponse => msg !== null)\n        .map(parseMessage);\n\n      return {\n        success: true,\n        output: {\n          messages: parsedMessages,\n          totalEstimate: listData.resultSizeEstimate || parsedMessages.length,\n          query: query || null,\n          hasMore: !!listData.nextPageToken,\n        },\n        metadata: {\n          messageCount: parsedMessages.length,\n          totalEstimate: listData.resultSizeEstimate,\n          hasMore: !!listData.nextPageToken,\n        },\n      };\n    } catch (error) {\n      const msg = error instanceof Error ? error.message : String(error);\n      return { success: false, error: `Gmail operation failed: ${msg}` };\n    }\n  },\n});\n"],"mappings":"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"}

package/dist/actions/gmail/list-messages.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/actions/gmail/list-messages.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/actions/gmail/list-messages.js

@@ -0,0 +1,193 @@
+import { defineAction } from "../define-action.js";
+import { GMAIL_PROVIDER } from "../providers.js";
+import { z } from "zod/v4";
+//#region src/actions/gmail/list-messages.ts
+/**
+* gmail.list_messages — List / search Gmail messages
+*
+* Searches and retrieves email metadata from Gmail via the Gmail API.
+* Requires a Google Gmail OAuth2 credential.
+*/
+const GMAIL_API_BASE = "https://gmail.googleapis.com/gmail/v1/users/me";
+function getHeader(headers, name) {
+	return headers?.find((h) => h.name.toLowerCase() === name.toLowerCase())?.value;
+}
+function parseMessage(msg) {
+	const headers = msg.payload?.headers;
+	return {
+		id: msg.id,
+		threadId: msg.threadId,
+		from: getHeader(headers, "From"),
+		to: getHeader(headers, "To"),
+		subject: getHeader(headers, "Subject"),
+		date: getHeader(headers, "Date"),
+		snippet: msg.snippet,
+		labels: msg.labelIds,
+		isUnread: msg.labelIds?.includes("UNREAD"),
+		isStarred: msg.labelIds?.includes("STARRED")
+	};
+}
+const gmailListMessagesAction = defineAction({
+	id: "gmail.list_messages",
+	name: "List Emails",
+	description: "Search and list emails from Gmail inbox. Use this when the user asks to check their email, find specific emails, or search their inbox.",
+	provider: GMAIL_PROVIDER,
+	actionCategory: "read",
+	tags: [
+		"gmail",
+		"google",
+		"email",
+		"mail",
+		"inbox",
+		"list",
+		"search",
+		"messages",
+		"read",
+		"oauth2"
+	],
+	credential: {
+		required: true,
+		type: "oauth2",
+		oauth2Provider: "google_gmail",
+		description: "Gmail OAuth2 credential for authentication"
+	},
+	params: {
+		schema: z.object({
+			credentialId: z.string().min(1, "Gmail credential is required"),
+			maxResults: z.number().int().min(1).max(100).optional().default(10),
+			query: z.string().optional().default(""),
+			labelIds: z.array(z.string()).optional().default([]),
+			includeSpamTrash: z.boolean().optional().default(false)
+		}),
+		fields: [
+			{
+				name: "credentialId",
+				label: "Gmail Credential",
+				type: "text",
+				required: true,
+				description: "Gmail OAuth2 credential for authentication",
+				aiProvided: false
+			},
+			{
+				name: "maxResults",
+				label: "Max Results",
+				type: "number",
+				defaultValue: 10,
+				description: "Maximum number of emails to return (1–100)",
+				aiProvided: true
+			},
+			{
+				name: "query",
+				label: "Search Query",
+				type: "text",
+				placeholder: "is:unread from:someone@example.com",
+				description: "Gmail search query. Examples: 'from:user@example.com', 'subject:meeting', 'is:unread', 'has:attachment'",
+				aiProvided: true
+			},
+			{
+				name: "labelIds",
+				label: "Label Filter",
+				type: "json",
+				defaultValue: [],
+				description: "Filter by label IDs (JSON array). Common: [\"INBOX\"], [\"UNREAD\"], [\"STARRED\"]",
+				extended: true,
+				aiProvided: true
+			},
+			{
+				name: "includeSpamTrash",
+				label: "Include Spam/Trash",
+				type: "boolean",
+				defaultValue: false,
+				description: "Include messages from SPAM and TRASH folders",
+				extended: true
+			}
+		]
+	},
+	async execute(params, context) {
+		const { credentialId, maxResults, query, labelIds, includeSpamTrash } = params;
+		let credential = context.credential;
+		if (!credential && context.functions?.getCredential) credential = await context.functions.getCredential(credentialId);
+		if (!credential) return {
+			success: false,
+			error: `Credential not found: ${credentialId}. Please create a Gmail OAuth2 credential.`
+		};
+		if (credential.authType !== "oauth2") return {
+			success: false,
+			error: `Invalid credential type: ${credential.authType}. Gmail requires an OAuth2 credential.`
+		};
+		const accessToken = credential.config?.accessToken;
+		if (!accessToken) return {
+			success: false,
+			error: "No valid access token in credential. Please re-authorize the Gmail credential."
+		};
+		context.logger.debug("Executing Gmail list messages", {
+			maxResults,
+			hasQuery: !!query,
+			labelIds
+		});
+		try {
+			const url = new URL(`${GMAIL_API_BASE}/messages`);
+			url.searchParams.set("maxResults", String(Math.min(Math.max(1, maxResults), 100)));
+			if (query?.trim()) url.searchParams.set("q", query);
+			if (labelIds && labelIds.length > 0) for (const labelId of labelIds) url.searchParams.append("labelIds", labelId);
+			if (includeSpamTrash) url.searchParams.set("includeSpamTrash", "true");
+			const listResponse = await fetch(url.toString(), { headers: {
+				Authorization: `Bearer ${accessToken}`,
+				Accept: "application/json"
+			} });
+			if (!listResponse.ok) {
+				const errorText = await listResponse.text();
+				return {
+					success: false,
+					error: `Gmail API error: ${listResponse.status} ${listResponse.statusText} - ${errorText}`
+				};
+			}
+			const listData = await listResponse.json();
+			if (!listData.messages || listData.messages.length === 0) return {
+				success: true,
+				output: {
+					messages: [],
+					totalEstimate: listData.resultSizeEstimate || 0,
+					query: query || null,
+					hasMore: false
+				}
+			};
+			const parsedMessages = (await Promise.all(listData.messages.map(async (msg) => {
+				const msgUrl = new URL(`${GMAIL_API_BASE}/messages/${msg.id}`);
+				msgUrl.searchParams.set("format", "metadata");
+				msgUrl.searchParams.set("metadataHeaders", "From");
+				msgUrl.searchParams.append("metadataHeaders", "To");
+				msgUrl.searchParams.append("metadataHeaders", "Subject");
+				msgUrl.searchParams.append("metadataHeaders", "Date");
+				const resp = await fetch(msgUrl.toString(), { headers: {
+					Authorization: `Bearer ${accessToken}`,
+					Accept: "application/json"
+				} });
+				return resp.ok ? await resp.json() : null;
+			}))).filter((msg) => msg !== null).map(parseMessage);
+			return {
+				success: true,
+				output: {
+					messages: parsedMessages,
+					totalEstimate: listData.resultSizeEstimate || parsedMessages.length,
+					query: query || null,
+					hasMore: !!listData.nextPageToken
+				},
+				metadata: {
+					messageCount: parsedMessages.length,
+					totalEstimate: listData.resultSizeEstimate,
+					hasMore: !!listData.nextPageToken
+				}
+			};
+		} catch (error) {
+			return {
+				success: false,
+				error: `Gmail operation failed: ${error instanceof Error ? error.message : String(error)}`
+			};
+		}
+	}
+});
+//#endregion
+export { gmailListMessagesAction };
+
+//# sourceMappingURL=list-messages.js.map

package/dist/actions/gmail/list-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-messages.js","names":[],"sources":["../../../src/actions/gmail/list-messages.ts"],"sourcesContent":["/**\n * gmail.list_messages — List / search Gmail messages\n *\n * Searches and retrieves email metadata from Gmail via the Gmail API.\n * Requires a Google Gmail OAuth2 credential.\n */\n\nimport { defineAction } from '../define-action';\nimport { GMAIL_PROVIDER } from '../providers';\nimport { z } from 'zod/v4';\n\nconst GMAIL_API_BASE = 'https://gmail.googleapis.com/gmail/v1/users/me';\n\ninterface GmailListResponse {\n  messages?: Array<{ id: string; threadId: string }>;\n  nextPageToken?: string;\n  resultSizeEstimate?: number;\n}\n\ninterface GmailMessageResponse {\n  id: string;\n  threadId: string;\n  labelIds?: string[];\n  snippet?: string;\n  payload?: {\n    headers?: Array<{ name: string; value: string }>;\n  };\n}\n\ninterface ParsedEmail {\n  id: string;\n  threadId: string;\n  from?: string;\n  to?: string;\n  subject?: string;\n  date?: string;\n  snippet?: string;\n  labels?: string[];\n  isUnread?: boolean;\n  isStarred?: boolean;\n}\n\nfunction getHeader(\n  headers: Array<{ name: string; value: string }> | undefined,\n  name: string,\n): string | undefined {\n  return headers?.find((h) => h.name.toLowerCase() === name.toLowerCase())?.value;\n}\n\nfunction parseMessage(msg: GmailMessageResponse): ParsedEmail {\n  const headers = msg.payload?.headers;\n  return {\n    id: msg.id,\n    threadId: msg.threadId,\n    from: getHeader(headers, 'From'),\n    to: getHeader(headers, 'To'),\n    subject: getHeader(headers, 'Subject'),\n    date: getHeader(headers, 'Date'),\n    snippet: msg.snippet,\n    labels: msg.labelIds,\n    isUnread: msg.labelIds?.includes('UNREAD'),\n    isStarred: msg.labelIds?.includes('STARRED'),\n  };\n}\n\nconst paramsSchema = z.object({\n  credentialId: z.string().min(1, 'Gmail credential is required'),\n  maxResults: z.number().int().min(1).max(100).optional().default(10),\n  query: z.string().optional().default(''),\n  labelIds: z.array(z.string()).optional().default([]),\n  includeSpamTrash: z.boolean().optional().default(false),\n});\n\nexport const gmailListMessagesAction = defineAction({\n  id: 'gmail.list_messages',\n  name: 'List Emails',\n  description:\n    'Search and list emails from Gmail inbox. Use this when the user asks to check their email, find specific emails, or search their inbox.',\n  provider: GMAIL_PROVIDER,\n  actionCategory: 'read',\n  tags: [\n    'gmail',\n    'google',\n    'email',\n    'mail',\n    'inbox',\n    'list',\n    'search',\n    'messages',\n    'read',\n    'oauth2',\n  ],\n\n  credential: {\n    required: true,\n    type: 'oauth2',\n    oauth2Provider: 'google_gmail',\n    description: 'Gmail OAuth2 credential for authentication',\n  },\n\n  params: {\n    schema: paramsSchema,\n    fields: [\n      {\n        name: 'credentialId',\n        label: 'Gmail Credential',\n        type: 'text',\n        required: true,\n        description: 'Gmail OAuth2 credential for authentication',\n        aiProvided: false,\n      },\n      {\n        name: 'maxResults',\n        label: 'Max Results',\n        type: 'number',\n        defaultValue: 10,\n        description: 'Maximum number of emails to return (1–100)',\n        aiProvided: true,\n      },\n      {\n        name: 'query',\n        label: 'Search Query',\n        type: 'text',\n        placeholder: 'is:unread from:someone@example.com',\n        description:\n          \"Gmail search query. Examples: 'from:user@example.com', 'subject:meeting', 'is:unread', 'has:attachment'\",\n        aiProvided: true,\n      },\n      {\n        name: 'labelIds',\n        label: 'Label Filter',\n        type: 'json',\n        defaultValue: [],\n        description: 'Filter by label IDs (JSON array). Common: [\"INBOX\"], [\"UNREAD\"], [\"STARRED\"]',\n        extended: true,\n        aiProvided: true,\n      },\n      {\n        name: 'includeSpamTrash',\n        label: 'Include Spam/Trash',\n        type: 'boolean',\n        defaultValue: false,\n        description: 'Include messages from SPAM and TRASH folders',\n        extended: true,\n      },\n    ],\n  },\n\n  async execute(params, context) {\n    const { credentialId, maxResults, query, labelIds, includeSpamTrash } = params;\n\n    // Resolve credential\n    let credential = context.credential;\n    if (!credential && context.functions?.getCredential) {\n      credential = await context.functions.getCredential(credentialId);\n    }\n    if (!credential) {\n      return {\n        success: false,\n        error: `Credential not found: ${credentialId}. Please create a Gmail OAuth2 credential.`,\n      };\n    }\n    if (credential.authType !== 'oauth2') {\n      return {\n        success: false,\n        error: `Invalid credential type: ${credential.authType}. Gmail requires an OAuth2 credential.`,\n      };\n    }\n\n    const accessToken = credential.config?.accessToken as string;\n    if (!accessToken) {\n      return {\n        success: false,\n        error: 'No valid access token in credential. Please re-authorize the Gmail credential.',\n      };\n    }\n\n    context.logger.debug('Executing Gmail list messages', {\n      maxResults,\n      hasQuery: !!query,\n      labelIds,\n    });\n\n    try {\n      // Build list URL\n      const url = new URL(`${GMAIL_API_BASE}/messages`);\n      url.searchParams.set('maxResults', String(Math.min(Math.max(1, maxResults), 100)));\n\n      if (query?.trim()) {\n        url.searchParams.set('q', query);\n      }\n\n      if (labelIds && labelIds.length > 0) {\n        for (const labelId of labelIds) {\n          url.searchParams.append('labelIds', labelId);\n        }\n      }\n\n      if (includeSpamTrash) {\n        url.searchParams.set('includeSpamTrash', 'true');\n      }\n\n      const listResponse = await fetch(url.toString(), {\n        headers: {\n          Authorization: `Bearer ${accessToken}`,\n          Accept: 'application/json',\n        },\n      });\n\n      if (!listResponse.ok) {\n        const errorText = await listResponse.text();\n        return {\n          success: false,\n          error: `Gmail API error: ${listResponse.status} ${listResponse.statusText} - ${errorText}`,\n        };\n      }\n\n      const listData = (await listResponse.json()) as GmailListResponse;\n\n      if (!listData.messages || listData.messages.length === 0) {\n        return {\n          success: true,\n          output: {\n            messages: [],\n            totalEstimate: listData.resultSizeEstimate || 0,\n            query: query || null,\n            hasMore: false,\n          },\n        };\n      }\n\n      // Fetch metadata for each message\n      const messageDetails = await Promise.all(\n        listData.messages.map(async (msg) => {\n          const msgUrl = new URL(`${GMAIL_API_BASE}/messages/${msg.id}`);\n          msgUrl.searchParams.set('format', 'metadata');\n          msgUrl.searchParams.set('metadataHeaders', 'From');\n          msgUrl.searchParams.append('metadataHeaders', 'To');\n          msgUrl.searchParams.append('metadataHeaders', 'Subject');\n          msgUrl.searchParams.append('metadataHeaders', 'Date');\n\n          const resp = await fetch(msgUrl.toString(), {\n            headers: {\n              Authorization: `Bearer ${accessToken}`,\n              Accept: 'application/json',\n            },\n          });\n\n          return resp.ok ? ((await resp.json()) as GmailMessageResponse) : null;\n        }),\n      );\n\n      const parsedMessages = messageDetails\n        .filter((msg): msg is GmailMessageResponse => msg !== null)\n        .map(parseMessage);\n\n      return {\n        success: true,\n        output: {\n          messages: parsedMessages,\n          totalEstimate: listData.resultSizeEstimate || parsedMessages.length,\n          query: query || null,\n          hasMore: !!listData.nextPageToken,\n        },\n        metadata: {\n          messageCount: parsedMessages.length,\n          totalEstimate: listData.resultSizeEstimate,\n          hasMore: !!listData.nextPageToken,\n        },\n      };\n    } catch (error) {\n      const msg = error instanceof Error ? error.message : String(error);\n      return { success: false, error: `Gmail operation failed: ${msg}` };\n    }\n  },\n});\n"],"mappings":"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"}

package/dist/actions/gmail/modify-labels.cjs

@@ -0,0 +1,163 @@
+require("../../_virtual/_rolldown/runtime.cjs");
+const require_define_action = require("../define-action.cjs");
+const require_providers = require("../providers.cjs");
+let zod_v4 = require("zod/v4");
+//#region src/actions/gmail/modify-labels.ts
+/**
+* gmail.modify_labels — Add or remove labels on a Gmail message
+*
+* Modifies the label set on a single message. Common uses:
+*   - Mark as read/unread (add/remove UNREAD label)
+*   - Star/unstar (add/remove STARRED label)
+*   - Archive (remove INBOX label)
+*   - Move to trash (add TRASH label)
+*   - Apply custom labels
+*
+* Requires a Google Gmail OAuth2 credential.
+*/
+const GMAIL_API_BASE = "https://gmail.googleapis.com/gmail/v1/users/me";
+const paramsSchema = zod_v4.z.object({
+	credentialId: zod_v4.z.string().min(1, "Gmail credential is required"),
+	messageId: zod_v4.z.string().min(1, "Message ID is required"),
+	addLabelIds: zod_v4.z.array(zod_v4.z.string()).optional().default([]),
+	removeLabelIds: zod_v4.z.array(zod_v4.z.string()).optional().default([])
+});
+const gmailModifyLabelsAction = require_define_action.defineAction({
+	id: "gmail.modify_labels",
+	name: "Modify Labels",
+	description: "Add or remove labels on a Gmail message. Use to mark as read/unread, star/unstar, archive, trash, or apply custom labels.",
+	provider: require_providers.GMAIL_PROVIDER,
+	actionCategory: "manage",
+	tags: [
+		"gmail",
+		"google",
+		"email",
+		"mail",
+		"labels",
+		"tag",
+		"organize",
+		"archive",
+		"read",
+		"unread",
+		"star",
+		"oauth2"
+	],
+	credential: {
+		required: true,
+		type: "oauth2",
+		oauth2Provider: "google_gmail",
+		description: "Gmail OAuth2 credential with modify permissions"
+	},
+	params: {
+		schema: paramsSchema,
+		fields: [
+			{
+				name: "credentialId",
+				label: "Gmail Credential",
+				type: "text",
+				required: true,
+				description: "Gmail OAuth2 credential for authentication",
+				aiProvided: false
+			},
+			{
+				name: "messageId",
+				label: "Message ID",
+				type: "text",
+				required: true,
+				placeholder: "18e1a2b3c4d5e6f7",
+				description: "The Gmail message ID to modify",
+				aiProvided: true
+			},
+			{
+				name: "addLabelIds",
+				label: "Add Labels",
+				type: "json",
+				defaultValue: [],
+				description: "Label IDs to add (JSON array). Common: \"STARRED\", \"IMPORTANT\", \"UNREAD\", \"TRASH\"",
+				aiProvided: true
+			},
+			{
+				name: "removeLabelIds",
+				label: "Remove Labels",
+				type: "json",
+				defaultValue: [],
+				description: "Label IDs to remove (JSON array). Common: \"UNREAD\" (mark read), \"INBOX\" (archive), \"STARRED\"",
+				aiProvided: true
+			}
+		]
+	},
+	async execute(params, context) {
+		const { credentialId, messageId, addLabelIds, removeLabelIds } = params;
+		if (addLabelIds.length === 0 && removeLabelIds.length === 0) return {
+			success: false,
+			error: "At least one label must be added or removed."
+		};
+		let credential = context.credential;
+		if (!credential && context.functions?.getCredential) credential = await context.functions.getCredential(credentialId);
+		if (!credential) return {
+			success: false,
+			error: `Credential not found: ${credentialId}. Please create a Gmail OAuth2 credential.`
+		};
+		if (credential.authType !== "oauth2") return {
+			success: false,
+			error: `Invalid credential type: ${credential.authType}. Gmail requires an OAuth2 credential.`
+		};
+		const accessToken = credential.config?.accessToken;
+		if (!accessToken) return {
+			success: false,
+			error: "No valid access token in credential. Please re-authorize the Gmail credential."
+		};
+		context.logger.debug("Modifying Gmail message labels", {
+			messageId,
+			addLabelIds,
+			removeLabelIds
+		});
+		try {
+			const url = `${GMAIL_API_BASE}/messages/${encodeURIComponent(messageId)}/modify`;
+			const response = await fetch(url, {
+				method: "POST",
+				headers: {
+					Authorization: `Bearer ${accessToken}`,
+					"Content-Type": "application/json"
+				},
+				body: JSON.stringify({
+					addLabelIds,
+					removeLabelIds
+				})
+			});
+			if (!response.ok) {
+				const errorText = await response.text();
+				return {
+					success: false,
+					error: `Gmail modify labels failed: ${response.status} ${response.statusText} - ${errorText}`
+				};
+			}
+			const result = await response.json();
+			return {
+				success: true,
+				output: {
+					messageId: result.id,
+					threadId: result.threadId,
+					currentLabels: result.labelIds,
+					added: addLabelIds,
+					removed: removeLabelIds
+				},
+				metadata: {
+					messageId: result.id,
+					labelsAdded: addLabelIds,
+					labelsRemoved: removeLabelIds,
+					resultingLabels: result.labelIds
+				}
+			};
+		} catch (error) {
+			return {
+				success: false,
+				error: `Gmail modify labels failed: ${error instanceof Error ? error.message : String(error)}`
+			};
+		}
+	}
+});
+//#endregion
+exports.gmailModifyLabelsAction = gmailModifyLabelsAction;
+
+//# sourceMappingURL=modify-labels.cjs.map

package/dist/actions/gmail/modify-labels.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"modify-labels.cjs","names":["z","defineAction","GMAIL_PROVIDER"],"sources":["../../../src/actions/gmail/modify-labels.ts"],"sourcesContent":["/**\n * gmail.modify_labels — Add or remove labels on a Gmail message\n *\n * Modifies the label set on a single message. Common uses:\n *   - Mark as read/unread (add/remove UNREAD label)\n *   - Star/unstar (add/remove STARRED label)\n *   - Archive (remove INBOX label)\n *   - Move to trash (add TRASH label)\n *   - Apply custom labels\n *\n * Requires a Google Gmail OAuth2 credential.\n */\n\nimport { defineAction } from '../define-action';\nimport { GMAIL_PROVIDER } from '../providers';\nimport { z } from 'zod/v4';\n\nconst GMAIL_API_BASE = 'https://gmail.googleapis.com/gmail/v1/users/me';\n\nconst paramsSchema = z.object({\n  credentialId: z.string().min(1, 'Gmail credential is required'),\n  messageId: z.string().min(1, 'Message ID is required'),\n  addLabelIds: z.array(z.string()).optional().default([]),\n  removeLabelIds: z.array(z.string()).optional().default([]),\n});\n\nexport const gmailModifyLabelsAction = defineAction({\n  id: 'gmail.modify_labels',\n  name: 'Modify Labels',\n  description:\n    'Add or remove labels on a Gmail message. Use to mark as read/unread, star/unstar, archive, trash, or apply custom labels.',\n  provider: GMAIL_PROVIDER,\n  actionCategory: 'manage',\n  tags: [\n    'gmail',\n    'google',\n    'email',\n    'mail',\n    'labels',\n    'tag',\n    'organize',\n    'archive',\n    'read',\n    'unread',\n    'star',\n    'oauth2',\n  ],\n\n  credential: {\n    required: true,\n    type: 'oauth2',\n    oauth2Provider: 'google_gmail',\n    description: 'Gmail OAuth2 credential with modify permissions',\n  },\n\n  params: {\n    schema: paramsSchema,\n    fields: [\n      {\n        name: 'credentialId',\n        label: 'Gmail Credential',\n        type: 'text',\n        required: true,\n        description: 'Gmail OAuth2 credential for authentication',\n        aiProvided: false,\n      },\n      {\n        name: 'messageId',\n        label: 'Message ID',\n        type: 'text',\n        required: true,\n        placeholder: '18e1a2b3c4d5e6f7',\n        description: 'The Gmail message ID to modify',\n        aiProvided: true,\n      },\n      {\n        name: 'addLabelIds',\n        label: 'Add Labels',\n        type: 'json',\n        defaultValue: [],\n        description:\n          'Label IDs to add (JSON array). Common: \"STARRED\", \"IMPORTANT\", \"UNREAD\", \"TRASH\"',\n        aiProvided: true,\n      },\n      {\n        name: 'removeLabelIds',\n        label: 'Remove Labels',\n        type: 'json',\n        defaultValue: [],\n        description:\n          'Label IDs to remove (JSON array). Common: \"UNREAD\" (mark read), \"INBOX\" (archive), \"STARRED\"',\n        aiProvided: true,\n      },\n    ],\n  },\n\n  async execute(params, context) {\n    const { credentialId, messageId, addLabelIds, removeLabelIds } = params;\n\n    if (addLabelIds.length === 0 && removeLabelIds.length === 0) {\n      return {\n        success: false,\n        error: 'At least one label must be added or removed.',\n      };\n    }\n\n    // Resolve credential\n    let credential = context.credential;\n    if (!credential && context.functions?.getCredential) {\n      credential = await context.functions.getCredential(credentialId);\n    }\n    if (!credential) {\n      return {\n        success: false,\n        error: `Credential not found: ${credentialId}. Please create a Gmail OAuth2 credential.`,\n      };\n    }\n    if (credential.authType !== 'oauth2') {\n      return {\n        success: false,\n        error: `Invalid credential type: ${credential.authType}. Gmail requires an OAuth2 credential.`,\n      };\n    }\n\n    const accessToken = credential.config?.accessToken as string;\n    if (!accessToken) {\n      return {\n        success: false,\n        error: 'No valid access token in credential. Please re-authorize the Gmail credential.',\n      };\n    }\n\n    context.logger.debug('Modifying Gmail message labels', {\n      messageId,\n      addLabelIds,\n      removeLabelIds,\n    });\n\n    try {\n      const url = `${GMAIL_API_BASE}/messages/${encodeURIComponent(messageId)}/modify`;\n\n      const response = await fetch(url, {\n        method: 'POST',\n        headers: {\n          Authorization: `Bearer ${accessToken}`,\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify({\n          addLabelIds,\n          removeLabelIds,\n        }),\n      });\n\n      if (!response.ok) {\n        const errorText = await response.text();\n        return {\n          success: false,\n          error: `Gmail modify labels failed: ${response.status} ${response.statusText} - ${errorText}`,\n        };\n      }\n\n      const result = (await response.json()) as {\n        id: string;\n        threadId: string;\n        labelIds: string[];\n      };\n\n      return {\n        success: true,\n        output: {\n          messageId: result.id,\n          threadId: result.threadId,\n          currentLabels: result.labelIds,\n          added: addLabelIds,\n          removed: removeLabelIds,\n        },\n        metadata: {\n          messageId: result.id,\n          labelsAdded: addLabelIds,\n          labelsRemoved: removeLabelIds,\n          resultingLabels: result.labelIds,\n        },\n      };\n    } catch (error) {\n      const msg = error instanceof Error ? error.message : String(error);\n      return { success: false, error: `Gmail modify labels failed: ${msg}` };\n    }\n  },\n});\n"],"mappings":"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"}

package/dist/actions/gmail/modify-labels.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/actions/gmail/modify-labels.d.ts

@@ -0,0 +1 @@
+export { };