@invect/core 0.0.1

package/dist/actions/gmail/create-draft.cjs

@@ -0,0 +1,228 @@
+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/create-draft.ts
+/**
+* gmail.create_draft — Create a draft email in Gmail
+*
+* Creates a draft email that can be reviewed before sending.
+* Supports plain text and HTML bodies, CC/BCC, and reply threading.
+* Requires a Google Gmail OAuth2 credential.
+*/
+const GMAIL_API_BASE = "https://gmail.googleapis.com/gmail/v1/users/me";
+/**
+* Build an RFC 2822 compliant email and base64url-encode it for the Gmail API.
+*/
+function buildRawEmail(options) {
+	const mimeType = options.isHtml ? "text/html" : "text/plain";
+	const lines = [
+		`To: ${options.to}`,
+		`Subject: ${options.subject}`,
+		`MIME-Version: 1.0`
+	];
+	if (options.cc) lines.push(`Cc: ${options.cc}`);
+	if (options.bcc) lines.push(`Bcc: ${options.bcc}`);
+	if (options.inReplyTo) {
+		lines.push(`In-Reply-To: ${options.inReplyTo}`);
+		lines.push(`References: ${options.inReplyTo}`);
+	}
+	lines.push(`Content-Type: ${mimeType}; charset="UTF-8"`);
+	lines.push("");
+	lines.push(options.body);
+	const raw = lines.join("\r\n");
+	return Buffer.from(raw).toString("base64").replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+const paramsSchema = zod_v4.z.object({
+	credentialId: zod_v4.z.string().min(1, "Gmail credential is required"),
+	to: zod_v4.z.string().min(1, "Recipient address is required"),
+	subject: zod_v4.z.string().min(1, "Subject is required"),
+	body: zod_v4.z.string().default(""),
+	cc: zod_v4.z.string().optional().default(""),
+	bcc: zod_v4.z.string().optional().default(""),
+	isHtml: zod_v4.z.boolean().optional().default(false),
+	threadId: zod_v4.z.string().optional().default(""),
+	inReplyTo: zod_v4.z.string().optional().default("")
+});
+const gmailCreateDraftAction = require_define_action.defineAction({
+	id: "gmail.create_draft",
+	name: "Create Draft",
+	description: "Create a draft email in Gmail for review before sending. Supports plain text, HTML, CC/BCC, and reply threading.",
+	provider: require_providers.GMAIL_PROVIDER,
+	actionCategory: "write",
+	tags: [
+		"gmail",
+		"google",
+		"email",
+		"mail",
+		"draft",
+		"compose",
+		"write",
+		"prepare",
+		"oauth2"
+	],
+	credential: {
+		required: true,
+		type: "oauth2",
+		oauth2Provider: "google_gmail",
+		description: "Gmail OAuth2 credential with compose permissions"
+	},
+	params: {
+		schema: paramsSchema,
+		fields: [
+			{
+				name: "credentialId",
+				label: "Gmail Credential",
+				type: "text",
+				required: true,
+				description: "Gmail OAuth2 credential for authentication",
+				aiProvided: false
+			},
+			{
+				name: "to",
+				label: "To",
+				type: "text",
+				required: true,
+				placeholder: "recipient@example.com",
+				description: "Recipient email address(es). Comma-separate for multiple.",
+				aiProvided: true
+			},
+			{
+				name: "subject",
+				label: "Subject",
+				type: "text",
+				required: true,
+				placeholder: "Draft subject",
+				description: "Email subject line",
+				aiProvided: true
+			},
+			{
+				name: "body",
+				label: "Body",
+				type: "textarea",
+				placeholder: "Draft body...",
+				description: "Email body content. Supports {{ expression }} templating.",
+				aiProvided: true
+			},
+			{
+				name: "cc",
+				label: "CC",
+				type: "text",
+				placeholder: "cc@example.com",
+				description: "CC recipients (comma-separated)",
+				extended: true,
+				aiProvided: true
+			},
+			{
+				name: "bcc",
+				label: "BCC",
+				type: "text",
+				placeholder: "bcc@example.com",
+				description: "BCC recipients (comma-separated)",
+				extended: true,
+				aiProvided: true
+			},
+			{
+				name: "isHtml",
+				label: "HTML Body",
+				type: "boolean",
+				defaultValue: false,
+				description: "Whether the body is HTML formatted",
+				extended: true
+			},
+			{
+				name: "threadId",
+				label: "Thread ID",
+				type: "text",
+				description: "Gmail thread ID to place draft within (for threaded replies)",
+				extended: true,
+				aiProvided: true
+			},
+			{
+				name: "inReplyTo",
+				label: "In-Reply-To",
+				type: "text",
+				description: "Message-ID header of the email being replied to",
+				extended: true,
+				aiProvided: true
+			}
+		]
+	},
+	async execute(params, context) {
+		const { credentialId, to, subject, body, cc, bcc, isHtml, threadId, inReplyTo } = 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("Creating Gmail draft", {
+			to,
+			subject,
+			hasThread: !!threadId
+		});
+		try {
+			const draftBody = { message: { raw: buildRawEmail({
+				to,
+				subject,
+				body,
+				cc: cc || void 0,
+				bcc: bcc || void 0,
+				isHtml,
+				inReplyTo: inReplyTo || void 0
+			}) } };
+			if (threadId) draftBody.message.threadId = threadId;
+			const response = await fetch(`${GMAIL_API_BASE}/drafts`, {
+				method: "POST",
+				headers: {
+					Authorization: `Bearer ${accessToken}`,
+					"Content-Type": "application/json"
+				},
+				body: JSON.stringify(draftBody)
+			});
+			if (!response.ok) {
+				const errorText = await response.text();
+				return {
+					success: false,
+					error: `Gmail draft creation failed: ${response.status} ${response.statusText} - ${errorText}`
+				};
+			}
+			const result = await response.json();
+			return {
+				success: true,
+				output: {
+					draftId: result.id,
+					messageId: result.message.id,
+					threadId: result.message.threadId,
+					to,
+					subject
+				},
+				metadata: {
+					draftId: result.id,
+					messageId: result.message.id,
+					to,
+					subject,
+					createdAt: (/* @__PURE__ */ new Date()).toISOString()
+				}
+			};
+		} catch (error) {
+			return {
+				success: false,
+				error: `Gmail draft creation failed: ${error instanceof Error ? error.message : String(error)}`
+			};
+		}
+	}
+});
+//#endregion
+exports.gmailCreateDraftAction = gmailCreateDraftAction;
+
+//# sourceMappingURL=create-draft.cjs.map

package/dist/actions/gmail/create-draft.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-draft.cjs","names":["z","defineAction","GMAIL_PROVIDER"],"sources":["../../../src/actions/gmail/create-draft.ts"],"sourcesContent":["/**\n * gmail.create_draft — Create a draft email in Gmail\n *\n * Creates a draft email that can be reviewed before sending.\n * Supports plain text and HTML bodies, CC/BCC, and reply threading.\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\n/**\n * Build an RFC 2822 compliant email and base64url-encode it for the Gmail API.\n */\nfunction buildRawEmail(options: {\n  to: string;\n  subject: string;\n  body: string;\n  cc?: string;\n  bcc?: string;\n  isHtml?: boolean;\n  inReplyTo?: string;\n}): string {\n  const mimeType = options.isHtml ? 'text/html' : 'text/plain';\n\n  const lines: string[] = [`To: ${options.to}`, `Subject: ${options.subject}`, `MIME-Version: 1.0`];\n\n  if (options.cc) {\n    lines.push(`Cc: ${options.cc}`);\n  }\n  if (options.bcc) {\n    lines.push(`Bcc: ${options.bcc}`);\n  }\n  if (options.inReplyTo) {\n    lines.push(`In-Reply-To: ${options.inReplyTo}`);\n    lines.push(`References: ${options.inReplyTo}`);\n  }\n\n  lines.push(`Content-Type: ${mimeType}; charset=\"UTF-8\"`);\n  lines.push('');\n  lines.push(options.body);\n\n  const raw = lines.join('\\r\\n');\n  return Buffer.from(raw)\n    .toString('base64')\n    .replace(/\\+/g, '-')\n    .replace(/\\//g, '_')\n    .replace(/=+$/, '');\n}\n\nconst paramsSchema = z.object({\n  credentialId: z.string().min(1, 'Gmail credential is required'),\n  to: z.string().min(1, 'Recipient address is required'),\n  subject: z.string().min(1, 'Subject is required'),\n  body: z.string().default(''),\n  cc: z.string().optional().default(''),\n  bcc: z.string().optional().default(''),\n  isHtml: z.boolean().optional().default(false),\n  threadId: z.string().optional().default(''),\n  inReplyTo: z.string().optional().default(''),\n});\n\nexport const gmailCreateDraftAction = defineAction({\n  id: 'gmail.create_draft',\n  name: 'Create Draft',\n  description:\n    'Create a draft email in Gmail for review before sending. Supports plain text, HTML, CC/BCC, and reply threading.',\n  provider: GMAIL_PROVIDER,\n  actionCategory: 'write',\n  tags: ['gmail', 'google', 'email', 'mail', 'draft', 'compose', 'write', 'prepare', 'oauth2'],\n\n  credential: {\n    required: true,\n    type: 'oauth2',\n    oauth2Provider: 'google_gmail',\n    description: 'Gmail OAuth2 credential with compose 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: 'to',\n        label: 'To',\n        type: 'text',\n        required: true,\n        placeholder: 'recipient@example.com',\n        description: 'Recipient email address(es). Comma-separate for multiple.',\n        aiProvided: true,\n      },\n      {\n        name: 'subject',\n        label: 'Subject',\n        type: 'text',\n        required: true,\n        placeholder: 'Draft subject',\n        description: 'Email subject line',\n        aiProvided: true,\n      },\n      {\n        name: 'body',\n        label: 'Body',\n        type: 'textarea',\n        placeholder: 'Draft body...',\n        description: 'Email body content. Supports {{ expression }} templating.',\n        aiProvided: true,\n      },\n      {\n        name: 'cc',\n        label: 'CC',\n        type: 'text',\n        placeholder: 'cc@example.com',\n        description: 'CC recipients (comma-separated)',\n        extended: true,\n        aiProvided: true,\n      },\n      {\n        name: 'bcc',\n        label: 'BCC',\n        type: 'text',\n        placeholder: 'bcc@example.com',\n        description: 'BCC recipients (comma-separated)',\n        extended: true,\n        aiProvided: true,\n      },\n      {\n        name: 'isHtml',\n        label: 'HTML Body',\n        type: 'boolean',\n        defaultValue: false,\n        description: 'Whether the body is HTML formatted',\n        extended: true,\n      },\n      {\n        name: 'threadId',\n        label: 'Thread ID',\n        type: 'text',\n        description: 'Gmail thread ID to place draft within (for threaded replies)',\n        extended: true,\n        aiProvided: true,\n      },\n      {\n        name: 'inReplyTo',\n        label: 'In-Reply-To',\n        type: 'text',\n        description: 'Message-ID header of the email being replied to',\n        extended: true,\n        aiProvided: true,\n      },\n    ],\n  },\n\n  async execute(params, context) {\n    const { credentialId, to, subject, body, cc, bcc, isHtml, threadId, inReplyTo } = 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('Creating Gmail draft', { to, subject, hasThread: !!threadId });\n\n    try {\n      const raw = buildRawEmail({\n        to,\n        subject,\n        body,\n        cc: cc || undefined,\n        bcc: bcc || undefined,\n        isHtml,\n        inReplyTo: inReplyTo || undefined,\n      });\n\n      const draftBody: { message: Record<string, string> } = {\n        message: { raw },\n      };\n      if (threadId) {\n        draftBody.message.threadId = threadId;\n      }\n\n      const response = await fetch(`${GMAIL_API_BASE}/drafts`, {\n        method: 'POST',\n        headers: {\n          Authorization: `Bearer ${accessToken}`,\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(draftBody),\n      });\n\n      if (!response.ok) {\n        const errorText = await response.text();\n        return {\n          success: false,\n          error: `Gmail draft creation failed: ${response.status} ${response.statusText} - ${errorText}`,\n        };\n      }\n\n      const result = (await response.json()) as {\n        id: string;\n        message: { id: string; threadId: string; labelIds: string[] };\n      };\n\n      return {\n        success: true,\n        output: {\n          draftId: result.id,\n          messageId: result.message.id,\n          threadId: result.message.threadId,\n          to,\n          subject,\n        },\n        metadata: {\n          draftId: result.id,\n          messageId: result.message.id,\n          to,\n          subject,\n          createdAt: new Date().toISOString(),\n        },\n      };\n    } catch (error) {\n      const msg = error instanceof Error ? error.message : String(error);\n      return { success: false, error: `Gmail draft creation failed: ${msg}` };\n    }\n  },\n});\n"],"mappings":"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"}

package/dist/actions/gmail/create-draft.d.cts

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

package/dist/actions/gmail/create-draft.d.ts

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

package/dist/actions/gmail/create-draft.js

@@ -0,0 +1,226 @@
+import { defineAction } from "../define-action.js";
+import { GMAIL_PROVIDER } from "../providers.js";
+import { z } from "zod/v4";
+//#region src/actions/gmail/create-draft.ts
+/**
+* gmail.create_draft — Create a draft email in Gmail
+*
+* Creates a draft email that can be reviewed before sending.
+* Supports plain text and HTML bodies, CC/BCC, and reply threading.
+* Requires a Google Gmail OAuth2 credential.
+*/
+const GMAIL_API_BASE = "https://gmail.googleapis.com/gmail/v1/users/me";
+/**
+* Build an RFC 2822 compliant email and base64url-encode it for the Gmail API.
+*/
+function buildRawEmail(options) {
+	const mimeType = options.isHtml ? "text/html" : "text/plain";
+	const lines = [
+		`To: ${options.to}`,
+		`Subject: ${options.subject}`,
+		`MIME-Version: 1.0`
+	];
+	if (options.cc) lines.push(`Cc: ${options.cc}`);
+	if (options.bcc) lines.push(`Bcc: ${options.bcc}`);
+	if (options.inReplyTo) {
+		lines.push(`In-Reply-To: ${options.inReplyTo}`);
+		lines.push(`References: ${options.inReplyTo}`);
+	}
+	lines.push(`Content-Type: ${mimeType}; charset="UTF-8"`);
+	lines.push("");
+	lines.push(options.body);
+	const raw = lines.join("\r\n");
+	return Buffer.from(raw).toString("base64").replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+const gmailCreateDraftAction = defineAction({
+	id: "gmail.create_draft",
+	name: "Create Draft",
+	description: "Create a draft email in Gmail for review before sending. Supports plain text, HTML, CC/BCC, and reply threading.",
+	provider: GMAIL_PROVIDER,
+	actionCategory: "write",
+	tags: [
+		"gmail",
+		"google",
+		"email",
+		"mail",
+		"draft",
+		"compose",
+		"write",
+		"prepare",
+		"oauth2"
+	],
+	credential: {
+		required: true,
+		type: "oauth2",
+		oauth2Provider: "google_gmail",
+		description: "Gmail OAuth2 credential with compose permissions"
+	},
+	params: {
+		schema: z.object({
+			credentialId: z.string().min(1, "Gmail credential is required"),
+			to: z.string().min(1, "Recipient address is required"),
+			subject: z.string().min(1, "Subject is required"),
+			body: z.string().default(""),
+			cc: z.string().optional().default(""),
+			bcc: z.string().optional().default(""),
+			isHtml: z.boolean().optional().default(false),
+			threadId: z.string().optional().default(""),
+			inReplyTo: z.string().optional().default("")
+		}),
+		fields: [
+			{
+				name: "credentialId",
+				label: "Gmail Credential",
+				type: "text",
+				required: true,
+				description: "Gmail OAuth2 credential for authentication",
+				aiProvided: false
+			},
+			{
+				name: "to",
+				label: "To",
+				type: "text",
+				required: true,
+				placeholder: "recipient@example.com",
+				description: "Recipient email address(es). Comma-separate for multiple.",
+				aiProvided: true
+			},
+			{
+				name: "subject",
+				label: "Subject",
+				type: "text",
+				required: true,
+				placeholder: "Draft subject",
+				description: "Email subject line",
+				aiProvided: true
+			},
+			{
+				name: "body",
+				label: "Body",
+				type: "textarea",
+				placeholder: "Draft body...",
+				description: "Email body content. Supports {{ expression }} templating.",
+				aiProvided: true
+			},
+			{
+				name: "cc",
+				label: "CC",
+				type: "text",
+				placeholder: "cc@example.com",
+				description: "CC recipients (comma-separated)",
+				extended: true,
+				aiProvided: true
+			},
+			{
+				name: "bcc",
+				label: "BCC",
+				type: "text",
+				placeholder: "bcc@example.com",
+				description: "BCC recipients (comma-separated)",
+				extended: true,
+				aiProvided: true
+			},
+			{
+				name: "isHtml",
+				label: "HTML Body",
+				type: "boolean",
+				defaultValue: false,
+				description: "Whether the body is HTML formatted",
+				extended: true
+			},
+			{
+				name: "threadId",
+				label: "Thread ID",
+				type: "text",
+				description: "Gmail thread ID to place draft within (for threaded replies)",
+				extended: true,
+				aiProvided: true
+			},
+			{
+				name: "inReplyTo",
+				label: "In-Reply-To",
+				type: "text",
+				description: "Message-ID header of the email being replied to",
+				extended: true,
+				aiProvided: true
+			}
+		]
+	},
+	async execute(params, context) {
+		const { credentialId, to, subject, body, cc, bcc, isHtml, threadId, inReplyTo } = 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("Creating Gmail draft", {
+			to,
+			subject,
+			hasThread: !!threadId
+		});
+		try {
+			const draftBody = { message: { raw: buildRawEmail({
+				to,
+				subject,
+				body,
+				cc: cc || void 0,
+				bcc: bcc || void 0,
+				isHtml,
+				inReplyTo: inReplyTo || void 0
+			}) } };
+			if (threadId) draftBody.message.threadId = threadId;
+			const response = await fetch(`${GMAIL_API_BASE}/drafts`, {
+				method: "POST",
+				headers: {
+					Authorization: `Bearer ${accessToken}`,
+					"Content-Type": "application/json"
+				},
+				body: JSON.stringify(draftBody)
+			});
+			if (!response.ok) {
+				const errorText = await response.text();
+				return {
+					success: false,
+					error: `Gmail draft creation failed: ${response.status} ${response.statusText} - ${errorText}`
+				};
+			}
+			const result = await response.json();
+			return {
+				success: true,
+				output: {
+					draftId: result.id,
+					messageId: result.message.id,
+					threadId: result.message.threadId,
+					to,
+					subject
+				},
+				metadata: {
+					draftId: result.id,
+					messageId: result.message.id,
+					to,
+					subject,
+					createdAt: (/* @__PURE__ */ new Date()).toISOString()
+				}
+			};
+		} catch (error) {
+			return {
+				success: false,
+				error: `Gmail draft creation failed: ${error instanceof Error ? error.message : String(error)}`
+			};
+		}
+	}
+});
+//#endregion
+export { gmailCreateDraftAction };
+
+//# sourceMappingURL=create-draft.js.map

package/dist/actions/gmail/create-draft.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-draft.js","names":[],"sources":["../../../src/actions/gmail/create-draft.ts"],"sourcesContent":["/**\n * gmail.create_draft — Create a draft email in Gmail\n *\n * Creates a draft email that can be reviewed before sending.\n * Supports plain text and HTML bodies, CC/BCC, and reply threading.\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\n/**\n * Build an RFC 2822 compliant email and base64url-encode it for the Gmail API.\n */\nfunction buildRawEmail(options: {\n  to: string;\n  subject: string;\n  body: string;\n  cc?: string;\n  bcc?: string;\n  isHtml?: boolean;\n  inReplyTo?: string;\n}): string {\n  const mimeType = options.isHtml ? 'text/html' : 'text/plain';\n\n  const lines: string[] = [`To: ${options.to}`, `Subject: ${options.subject}`, `MIME-Version: 1.0`];\n\n  if (options.cc) {\n    lines.push(`Cc: ${options.cc}`);\n  }\n  if (options.bcc) {\n    lines.push(`Bcc: ${options.bcc}`);\n  }\n  if (options.inReplyTo) {\n    lines.push(`In-Reply-To: ${options.inReplyTo}`);\n    lines.push(`References: ${options.inReplyTo}`);\n  }\n\n  lines.push(`Content-Type: ${mimeType}; charset=\"UTF-8\"`);\n  lines.push('');\n  lines.push(options.body);\n\n  const raw = lines.join('\\r\\n');\n  return Buffer.from(raw)\n    .toString('base64')\n    .replace(/\\+/g, '-')\n    .replace(/\\//g, '_')\n    .replace(/=+$/, '');\n}\n\nconst paramsSchema = z.object({\n  credentialId: z.string().min(1, 'Gmail credential is required'),\n  to: z.string().min(1, 'Recipient address is required'),\n  subject: z.string().min(1, 'Subject is required'),\n  body: z.string().default(''),\n  cc: z.string().optional().default(''),\n  bcc: z.string().optional().default(''),\n  isHtml: z.boolean().optional().default(false),\n  threadId: z.string().optional().default(''),\n  inReplyTo: z.string().optional().default(''),\n});\n\nexport const gmailCreateDraftAction = defineAction({\n  id: 'gmail.create_draft',\n  name: 'Create Draft',\n  description:\n    'Create a draft email in Gmail for review before sending. Supports plain text, HTML, CC/BCC, and reply threading.',\n  provider: GMAIL_PROVIDER,\n  actionCategory: 'write',\n  tags: ['gmail', 'google', 'email', 'mail', 'draft', 'compose', 'write', 'prepare', 'oauth2'],\n\n  credential: {\n    required: true,\n    type: 'oauth2',\n    oauth2Provider: 'google_gmail',\n    description: 'Gmail OAuth2 credential with compose 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: 'to',\n        label: 'To',\n        type: 'text',\n        required: true,\n        placeholder: 'recipient@example.com',\n        description: 'Recipient email address(es). Comma-separate for multiple.',\n        aiProvided: true,\n      },\n      {\n        name: 'subject',\n        label: 'Subject',\n        type: 'text',\n        required: true,\n        placeholder: 'Draft subject',\n        description: 'Email subject line',\n        aiProvided: true,\n      },\n      {\n        name: 'body',\n        label: 'Body',\n        type: 'textarea',\n        placeholder: 'Draft body...',\n        description: 'Email body content. Supports {{ expression }} templating.',\n        aiProvided: true,\n      },\n      {\n        name: 'cc',\n        label: 'CC',\n        type: 'text',\n        placeholder: 'cc@example.com',\n        description: 'CC recipients (comma-separated)',\n        extended: true,\n        aiProvided: true,\n      },\n      {\n        name: 'bcc',\n        label: 'BCC',\n        type: 'text',\n        placeholder: 'bcc@example.com',\n        description: 'BCC recipients (comma-separated)',\n        extended: true,\n        aiProvided: true,\n      },\n      {\n        name: 'isHtml',\n        label: 'HTML Body',\n        type: 'boolean',\n        defaultValue: false,\n        description: 'Whether the body is HTML formatted',\n        extended: true,\n      },\n      {\n        name: 'threadId',\n        label: 'Thread ID',\n        type: 'text',\n        description: 'Gmail thread ID to place draft within (for threaded replies)',\n        extended: true,\n        aiProvided: true,\n      },\n      {\n        name: 'inReplyTo',\n        label: 'In-Reply-To',\n        type: 'text',\n        description: 'Message-ID header of the email being replied to',\n        extended: true,\n        aiProvided: true,\n      },\n    ],\n  },\n\n  async execute(params, context) {\n    const { credentialId, to, subject, body, cc, bcc, isHtml, threadId, inReplyTo } = 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('Creating Gmail draft', { to, subject, hasThread: !!threadId });\n\n    try {\n      const raw = buildRawEmail({\n        to,\n        subject,\n        body,\n        cc: cc || undefined,\n        bcc: bcc || undefined,\n        isHtml,\n        inReplyTo: inReplyTo || undefined,\n      });\n\n      const draftBody: { message: Record<string, string> } = {\n        message: { raw },\n      };\n      if (threadId) {\n        draftBody.message.threadId = threadId;\n      }\n\n      const response = await fetch(`${GMAIL_API_BASE}/drafts`, {\n        method: 'POST',\n        headers: {\n          Authorization: `Bearer ${accessToken}`,\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(draftBody),\n      });\n\n      if (!response.ok) {\n        const errorText = await response.text();\n        return {\n          success: false,\n          error: `Gmail draft creation failed: ${response.status} ${response.statusText} - ${errorText}`,\n        };\n      }\n\n      const result = (await response.json()) as {\n        id: string;\n        message: { id: string; threadId: string; labelIds: string[] };\n      };\n\n      return {\n        success: true,\n        output: {\n          draftId: result.id,\n          messageId: result.message.id,\n          threadId: result.message.threadId,\n          to,\n          subject,\n        },\n        metadata: {\n          draftId: result.id,\n          messageId: result.message.id,\n          to,\n          subject,\n          createdAt: new Date().toISOString(),\n        },\n      };\n    } catch (error) {\n      const msg = error instanceof Error ? error.message : String(error);\n      return { success: false, error: `Gmail draft creation failed: ${msg}` };\n    }\n  },\n});\n"],"mappings":"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"}