automate.ax 0.3.1 → 0.4.0

package/dist/components/gmail/actions/send-email.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { defineAction } from "../../../automation/actions.js";
+import { buildRawMessage, getGmailApi, toMessageMetadata } from "../lib/gmail.js";
+import { GMAIL_SEND_REQUIREMENT } from "../lib/scopes.js";
+import { COMPOSE_OPTIONS_SCHEMA, MESSAGE_METADATA_SCHEMA, RECIPIENTS_SCHEMA, } from "../lib/schemas.js";
+/**
+ * Sends a new Gmail message.
+ *
+ * Supports named recipients, send-as aliases, custom headers, priority, inline
+ * attachments, and automatic plain text derived from HTML.
+ */
+export const sendEmail = defineAction("Send Gmail email")
+    .describe("Sends a richly formatted Gmail message.")
+    .account("google", GMAIL_SEND_REQUIREMENT)
+    .input(COMPOSE_OPTIONS_SCHEMA.extend({
+    /**
+     * HTML message body.
+     *
+     * Plain text is derived automatically when `text` is omitted.
+     */
+    html: z.string().optional(),
+    /** Message subject line. */
+    subject: z.string(),
+    /** Optional plain-text message body. */
+    text: z.string().optional(),
+    /** One or more primary recipients. */
+    to: RECIPIENTS_SCHEMA,
+}).refine(({ html, text }) => html !== undefined || text !== undefined, "At least one message body must be provided."))
+    .output(MESSAGE_METADATA_SCHEMA)
+    .handler(async ({ account, input }) => toMessageMetadata((await getGmailApi(account.secret).users.messages.send({
+    requestBody: {
+        raw: await buildRawMessage(input),
+    },
+    userId: "me",
+})).data, "sent message"));

package/dist/components/gmail/actions/star.d.ts

@@ -0,0 +1,5 @@
+/** Stars one or many Gmail messages. */
+export declare const star: import("../../..").DefinedAction<import("zod").ZodObject<{
+    messageIds: import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodArray<import("zod").ZodString>]>;
+}, import("zod/v4/core").$strip>, import("zod").ZodArray<import("zod").ZodString>, "google">;
+//# sourceMappingURL=star.d.ts.map

package/dist/components/gmail/actions/star.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"star.d.ts","sourceRoot":"","sources":["../../../../src/components/gmail/actions/star.ts"],"names":[],"mappings":"AAEA,wCAAwC;AACxC,eAAO,MAAM,IAAI;;4FAIhB,CAAA"}

package/dist/components/gmail/actions/star.js

@@ -0,0 +1,3 @@
+import { defineMessageLabelMutation } from "../lib/action-factories.js";
+/** Stars one or many Gmail messages. */
+export const star = defineMessageLabelMutation("Star Gmail messages", "Stars Gmail messages.", { addLabelIds: ["STARRED"] });

package/dist/components/gmail/actions/trash.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+/**
+ * Moves one or many Gmail messages to Trash.
+ *
+ * Returns Gmail's updated metadata for every message.
+ */
+export declare const trash: import("../../..").DefinedAction<z.ZodObject<{
+    messageIds: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+}, z.core.$strip>, z.ZodArray<z.ZodObject<{
+    messageId: z.ZodString;
+    threadId: z.ZodString;
+    historyId: z.ZodOptional<z.ZodString>;
+    labelIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>>, "google">;
+//# sourceMappingURL=trash.d.ts.map

package/dist/components/gmail/actions/trash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trash.d.ts","sourceRoot":"","sources":["../../../../src/components/gmail/actions/trash.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAUvB;;;;GAIG;AACH,eAAO,MAAM,KAAK;;;;;;;6BA0Bd,CAAA"}

package/dist/components/gmail/actions/trash.js

@@ -0,0 +1,26 @@
+import pMap from "p-map";
+import { z } from "zod";
+import { defineAction } from "../../../automation/actions.js";
+import { getGmailApi, normalizeMessageIds, toMessageMetadata, } from "../lib/gmail.js";
+import { GMAIL_MODIFY_REQUIREMENT } from "../lib/scopes.js";
+import { MESSAGE_IDS_SCHEMA, MESSAGE_METADATA_SCHEMA } from "../lib/schemas.js";
+/**
+ * Moves one or many Gmail messages to Trash.
+ *
+ * Returns Gmail's updated metadata for every message.
+ */
+export const trash = defineAction("Trash Gmail messages")
+    .describe("Moves one or many Gmail messages to Trash.")
+    .account("google", GMAIL_MODIFY_REQUIREMENT)
+    .input(z.object({
+    /** One ID or up to 1,000 immutable Gmail message IDs. */
+    messageIds: MESSAGE_IDS_SCHEMA,
+}))
+    .output(MESSAGE_METADATA_SCHEMA.array())
+    .handler(async ({ account, input }) => {
+    const gmailApi = getGmailApi(account.secret);
+    return await pMap(normalizeMessageIds(input.messageIds), async (messageId) => toMessageMetadata((await gmailApi.users.messages.trash({
+        id: messageId,
+        userId: "me",
+    })).data, "trashed message"), { concurrency: 20 });
+});

package/dist/components/gmail/actions/unmark-as-important.d.ts

@@ -0,0 +1,5 @@
+/** Removes Gmail's Important marker from one or many messages. */
+export declare const unmarkAsImportant: import("../../..").DefinedAction<import("zod").ZodObject<{
+    messageIds: import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodArray<import("zod").ZodString>]>;
+}, import("zod/v4/core").$strip>, import("zod").ZodArray<import("zod").ZodString>, "google">;
+//# sourceMappingURL=unmark-as-important.d.ts.map

package/dist/components/gmail/actions/unmark-as-important.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unmark-as-important.d.ts","sourceRoot":"","sources":["../../../../src/components/gmail/actions/unmark-as-important.ts"],"names":[],"mappings":"AAEA,kEAAkE;AAClE,eAAO,MAAM,iBAAiB;;4FAI7B,CAAA"}

package/dist/components/gmail/actions/unmark-as-important.js

@@ -0,0 +1,3 @@
+import { defineMessageLabelMutation } from "../lib/action-factories.js";
+/** Removes Gmail's Important marker from one or many messages. */
+export const unmarkAsImportant = defineMessageLabelMutation("Unmark Gmail messages as important", "Removes Gmail's Important marker from messages.", { removeLabelIds: ["IMPORTANT"] });

package/dist/components/gmail/actions/unstar.d.ts

@@ -0,0 +1,5 @@
+/** Removes the star from one or many Gmail messages. */
+export declare const unstar: import("../../..").DefinedAction<import("zod").ZodObject<{
+    messageIds: import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodArray<import("zod").ZodString>]>;
+}, import("zod/v4/core").$strip>, import("zod").ZodArray<import("zod").ZodString>, "google">;
+//# sourceMappingURL=unstar.d.ts.map

package/dist/components/gmail/actions/unstar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unstar.d.ts","sourceRoot":"","sources":["../../../../src/components/gmail/actions/unstar.ts"],"names":[],"mappings":"AAEA,wDAAwD;AACxD,eAAO,MAAM,MAAM;;4FAIlB,CAAA"}

package/dist/components/gmail/actions/unstar.js

@@ -0,0 +1,3 @@
+import { defineMessageLabelMutation } from "../lib/action-factories.js";
+/** Removes the star from one or many Gmail messages. */
+export const unstar = defineMessageLabelMutation("Unstar Gmail messages", "Removes the star from Gmail messages.", { removeLabelIds: ["STARRED"] });

package/dist/components/gmail/actions/untrash.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+/**
+ * Restores one or many Gmail messages from Trash.
+ *
+ * Returns Gmail's updated metadata for every message.
+ */
+export declare const untrash: import("../../..").DefinedAction<z.ZodObject<{
+    messageIds: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+}, z.core.$strip>, z.ZodArray<z.ZodObject<{
+    messageId: z.ZodString;
+    threadId: z.ZodString;
+    historyId: z.ZodOptional<z.ZodString>;
+    labelIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>>, "google">;
+//# sourceMappingURL=untrash.d.ts.map

package/dist/components/gmail/actions/untrash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"untrash.d.ts","sourceRoot":"","sources":["../../../../src/components/gmail/actions/untrash.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAUvB;;;;GAIG;AACH,eAAO,MAAM,OAAO;;;;;;;6BA0BhB,CAAA"}

package/dist/components/gmail/actions/untrash.js

@@ -0,0 +1,26 @@
+import pMap from "p-map";
+import { z } from "zod";
+import { defineAction } from "../../../automation/actions.js";
+import { getGmailApi, normalizeMessageIds, toMessageMetadata, } from "../lib/gmail.js";
+import { GMAIL_MODIFY_REQUIREMENT } from "../lib/scopes.js";
+import { MESSAGE_IDS_SCHEMA, MESSAGE_METADATA_SCHEMA } from "../lib/schemas.js";
+/**
+ * Restores one or many Gmail messages from Trash.
+ *
+ * Returns Gmail's updated metadata for every message.
+ */
+export const untrash = defineAction("Untrash Gmail messages")
+    .describe("Restores one or many Gmail messages from Trash.")
+    .account("google", GMAIL_MODIFY_REQUIREMENT)
+    .input(z.object({
+    /** One ID or up to 1,000 immutable Gmail message IDs. */
+    messageIds: MESSAGE_IDS_SCHEMA,
+}))
+    .output(MESSAGE_METADATA_SCHEMA.array())
+    .handler(async ({ account, input }) => {
+    const gmailApi = getGmailApi(account.secret);
+    return await pMap(normalizeMessageIds(input.messageIds), async (messageId) => toMessageMetadata((await gmailApi.users.messages.untrash({
+        id: messageId,
+        userId: "me",
+    })).data, "restored message"), { concurrency: 20 });
+});

package/dist/components/gmail/actions/update-draft.d.ts

@@ -0,0 +1,67 @@
+import { z } from "zod";
+/**
+ * Updates a Gmail draft while preserving fields omitted by the caller.
+ *
+ * Supplying either body representation replaces the existing body pair; missing
+ * plain text is then derived from replacement HTML.
+ */
+export declare const updateDraft: import("../../..").DefinedAction<z.ZodObject<{
+    attachments: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodObject<{
+        contentId: z.ZodOptional<z.ZodString>;
+        disposition: z.ZodOptional<z.ZodEnum<{
+            attachment: "attachment";
+            inline: "inline";
+        }>>;
+        file: z.ZodCustom<File, File>;
+        filename: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>>;
+    bcc: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+        address: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+        address: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>]>>;
+    cc: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+        address: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+        address: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>]>>;
+    from: z.ZodOptional<z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+        address: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    priority: z.ZodOptional<z.ZodEnum<{
+        high: "high";
+        normal: "normal";
+        low: "low";
+    }>>;
+    replyTo: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+        address: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+        address: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>]>>;
+    subject: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+        address: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+        address: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>]>>;
+    draftId: z.ZodString;
+    html: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    messageId: z.ZodString;
+    threadId: z.ZodString;
+    historyId: z.ZodOptional<z.ZodString>;
+    labelIds: z.ZodArray<z.ZodString>;
+    draftId: z.ZodString;
+}, z.core.$strip>, "google">;
+//# sourceMappingURL=update-draft.d.ts.map

package/dist/components/gmail/actions/update-draft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-draft.d.ts","sourceRoot":"","sources":["../../../../src/components/gmail/actions/update-draft.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAWvB;;;;;GAKG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BA8DpB,CAAA"}

package/dist/components/gmail/actions/update-draft.js

@@ -0,0 +1,67 @@
+import { z } from "zod";
+import { defineAction } from "../../../automation/actions.js";
+import { buildRawMessage, getGmailApi, getGmailMessage, toDraftIdentifier, } from "../lib/gmail.js";
+import { GMAIL_COMPOSE_AND_READ_REQUIREMENT } from "../lib/scopes.js";
+import { COMPOSE_OPTIONS_SCHEMA, DRAFT_IDENTIFIER_SCHEMA } from "../lib/schemas.js";
+/**
+ * Updates a Gmail draft while preserving fields omitted by the caller.
+ *
+ * Supplying either body representation replaces the existing body pair; missing
+ * plain text is then derived from replacement HTML.
+ */
+export const updateDraft = defineAction("Update Gmail draft")
+    .describe("Updates selected fields on an existing Gmail draft.")
+    .account("google", GMAIL_COMPOSE_AND_READ_REQUIREMENT)
+    .input(COMPOSE_OPTIONS_SCHEMA.extend({
+    /** Immutable Gmail draft ID to replace. */
+    draftId: z.string().min(1),
+    /** Optional HTML draft body. */
+    html: z.string().optional(),
+    /** Optional plain-text draft body. */
+    text: z.string().optional(),
+}))
+    .output(DRAFT_IDENTIFIER_SCHEMA)
+    .handler(async ({ account, input }) => {
+    const gmailApi = getGmailApi(account.secret);
+    const { data: existingDraft } = await gmailApi.users.drafts.get({
+        format: "raw",
+        id: input.draftId,
+        userId: "me",
+    });
+    if (!existingDraft.message) {
+        throw new Error("Gmail returned an incomplete draft.");
+    }
+    const existing = await getGmailMessage(existingDraft.message);
+    const bodyChanged = input.html !== undefined || input.text !== undefined;
+    const { data: updatedDraft } = await gmailApi.users.drafts.update({
+        id: input.draftId,
+        requestBody: {
+            message: {
+                raw: await buildRawMessage({
+                    attachments: input.attachments ??
+                        existing.attachments.map(({ contentId, disposition, file, filename }) => ({
+                            contentId,
+                            disposition,
+                            file,
+                            filename,
+                        })),
+                    bcc: input.bcc ?? existing.bcc,
+                    cc: input.cc ?? existing.cc,
+                    from: input.from ?? existing.from,
+                    headers: input.headers,
+                    html: bodyChanged ? input.html : existing.html,
+                    inReplyTo: existing.inReplyTo,
+                    priority: input.priority,
+                    references: existing.references,
+                    replyTo: input.replyTo ?? existing.replyTo,
+                    subject: input.subject ?? existing.subject,
+                    text: bodyChanged ? input.text : existing.text,
+                    to: input.to ?? existing.to,
+                }),
+                threadId: existing.threadId,
+            },
+        },
+        userId: "me",
+    });
+    return toDraftIdentifier(updatedDraft, "updated draft");
+});

package/dist/components/gmail/actions/update-label.d.ts

@@ -0,0 +1,44 @@
+import { z } from "zod";
+/** Updates selected metadata on a user-owned Gmail label. */
+export declare const updateLabel: import("../../..").DefinedAction<z.ZodObject<{
+    color: z.ZodOptional<z.ZodObject<{
+        backgroundColor: z.ZodString;
+        textColor: z.ZodString;
+    }, z.core.$strip>>;
+    label: z.ZodString;
+    labelListVisibility: z.ZodOptional<z.ZodEnum<{
+        labelHide: "labelHide";
+        labelShow: "labelShow";
+        labelShowIfUnread: "labelShowIfUnread";
+    }>>;
+    messageListVisibility: z.ZodOptional<z.ZodEnum<{
+        hide: "hide";
+        show: "show";
+    }>>;
+    name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    color: z.ZodOptional<z.ZodObject<{
+        backgroundColor: z.ZodString;
+        textColor: z.ZodString;
+    }, z.core.$strip>>;
+    labelId: z.ZodString;
+    labelListVisibility: z.ZodOptional<z.ZodEnum<{
+        labelHide: "labelHide";
+        labelShow: "labelShow";
+        labelShowIfUnread: "labelShowIfUnread";
+    }>>;
+    messageListVisibility: z.ZodOptional<z.ZodEnum<{
+        hide: "hide";
+        show: "show";
+    }>>;
+    messagesTotal: z.ZodOptional<z.ZodNumber>;
+    messagesUnread: z.ZodOptional<z.ZodNumber>;
+    name: z.ZodString;
+    threadsTotal: z.ZodOptional<z.ZodNumber>;
+    threadsUnread: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodOptional<z.ZodEnum<{
+        system: "system";
+        user: "user";
+    }>>;
+}, z.core.$strip>, "google">;
+//# sourceMappingURL=update-label.d.ts.map

package/dist/components/gmail/actions/update-label.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-label.d.ts","sourceRoot":"","sources":["../../../../src/components/gmail/actions/update-label.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAWvB,6DAA6D;AAC7D,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BA2CpB,CAAA"}

package/dist/components/gmail/actions/update-label.js

@@ -0,0 +1,38 @@
+import { z } from "zod";
+import { defineAction } from "../../../automation/actions.js";
+import { findLabelId, getGmailApi, toGmailLabel } from "../lib/gmail.js";
+import { GMAIL_MODIFY_REQUIREMENT } from "../lib/scopes.js";
+import { LABEL_COLOR_SCHEMA, LABEL_LIST_VISIBILITY_SCHEMA, LABEL_SCHEMA, MESSAGE_LIST_VISIBILITY_SCHEMA, } from "../lib/schemas.js";
+/** Updates selected metadata on a user-owned Gmail label. */
+export const updateLabel = defineAction("Update Gmail label")
+    .describe("Updates a user-owned Gmail label.")
+    .account("google", GMAIL_MODIFY_REQUIREMENT)
+    .input(z
+    .object({
+    /** Optional supported Gmail label color. */
+    color: LABEL_COLOR_SCHEMA.optional(),
+    /** Gmail label display name or immutable ID to update. */
+    label: z.string().min(1),
+    /** Visibility in Gmail's label list. */
+    labelListVisibility: LABEL_LIST_VISIBILITY_SCHEMA.optional(),
+    /** Visibility beside messages in Gmail's message list. */
+    messageListVisibility: MESSAGE_LIST_VISIBILITY_SCHEMA.optional(),
+    /** Optional replacement label name. */
+    name: z.string().min(1).optional(),
+})
+    .refine(({ color, labelListVisibility, messageListVisibility, name }) => Boolean(color || labelListVisibility || messageListVisibility || name), "At least one label property must be updated."))
+    .output(LABEL_SCHEMA)
+    .handler(async ({ account, input }) => {
+    const gmailApi = getGmailApi(account.secret);
+    const { data: label } = await gmailApi.users.labels.patch({
+        id: await findLabelId(gmailApi, input.label),
+        requestBody: {
+            color: input.color,
+            labelListVisibility: input.labelListVisibility,
+            messageListVisibility: input.messageListVisibility,
+            name: input.name,
+        },
+        userId: "me",
+    });
+    return toGmailLabel(label);
+});

package/dist/components/gmail/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./actions/index.js";
+export * from "./triggers/index.js";
+export { getGmailApi, getGmailMessage } from "./lib/gmail.js";
+export { MESSAGE_SCHEMA } from "./lib/schemas.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/gmail/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/gmail/index.ts"],"names":[],"mappings":"AAAA,mCAAyB;AACzB,oCAA0B;AAC1B,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,uBAAmB;AAC1D,OAAO,EAAE,cAAc,EAAE,yBAAqB"}

package/dist/components/gmail/index.js

@@ -0,0 +1,4 @@
+export * from "./actions/index.js";
+export * from "./triggers/index.js";
+export { getGmailApi, getGmailMessage } from "./lib/gmail.js";
+export { MESSAGE_SCHEMA } from "./lib/schemas.js";

package/dist/components/gmail/lib/action-factories.d.ts

@@ -0,0 +1,27 @@
+import { z } from "zod";
+/**
+ * Defines one fixed-label Gmail batch mutation.
+ *
+ * @param name - Action display name.
+ * @param description - Action description.
+ * @param labels - Fixed label mutation.
+ * @param labels.addLabelIds - Label IDs to add.
+ * @param labels.removeLabelIds - Label IDs to remove.
+ */
+export declare function defineMessageLabelMutation(name: string, description: string, labels: {
+    addLabelIds?: string[];
+    removeLabelIds?: string[];
+}): import("../../..").DefinedAction<z.ZodObject<{
+    messageIds: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+}, z.core.$strip>, z.ZodArray<z.ZodString>, "google">;
+/**
+ * Defines one fixed-label Gmail predicate.
+ *
+ * @param name - Action display name.
+ * @param description - Action description.
+ * @param labelId - Gmail system label ID.
+ */
+export declare function defineMessageLabelPredicate(name: string, description: string, labelId: string): import("../../..").DefinedAction<z.ZodObject<{
+    messageId: z.ZodString;
+}, z.core.$strip>, z.ZodBoolean, "google">;
+//# sourceMappingURL=action-factories.d.ts.map

package/dist/components/gmail/lib/action-factories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-factories.d.ts","sourceRoot":"","sources":["../../../../src/components/gmail/lib/action-factories.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE;IACN,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAC1B;;sDAuBF;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM;;2CAmBhB"}

package/dist/components/gmail/lib/action-factories.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { defineAction } from "../../../automation/actions.js";
+import { getGmailApi, getMessageMetadata, normalizeMessageIds } from "./gmail.js";
+import { GMAIL_METADATA_REQUIREMENT, GMAIL_MODIFY_REQUIREMENT } from "./scopes.js";
+import { MESSAGE_IDS_SCHEMA } from "./schemas.js";
+/**
+ * Defines one fixed-label Gmail batch mutation.
+ *
+ * @param name - Action display name.
+ * @param description - Action description.
+ * @param labels - Fixed label mutation.
+ * @param labels.addLabelIds - Label IDs to add.
+ * @param labels.removeLabelIds - Label IDs to remove.
+ */
+export function defineMessageLabelMutation(name, description, labels) {
+    return defineAction(name)
+        .describe(description)
+        .account("google", GMAIL_MODIFY_REQUIREMENT)
+        .input(z.object({
+        /** One ID or up to 1,000 immutable Gmail message IDs. */
+        messageIds: MESSAGE_IDS_SCHEMA,
+    }))
+        .output(z.string().array())
+        .handler(async ({ account, input }) => {
+        const messageIds = normalizeMessageIds(input.messageIds);
+        await getGmailApi(account.secret).users.messages.batchModify({
+            requestBody: {
+                ids: messageIds,
+                ...labels,
+            },
+            userId: "me",
+        });
+        return messageIds;
+    });
+}
+/**
+ * Defines one fixed-label Gmail predicate.
+ *
+ * @param name - Action display name.
+ * @param description - Action description.
+ * @param labelId - Gmail system label ID.
+ */
+export function defineMessageLabelPredicate(name, description, labelId) {
+    return defineAction(name)
+        .describe(description)
+        .account("google", GMAIL_METADATA_REQUIREMENT)
+        .input(z.object({
+        /** Immutable Gmail message ID. */
+        messageId: z.string().min(1),
+    }))
+        .output(z.boolean())
+        .handler(async ({ account, input }) => {
+        return ((await getMessageMetadata(getGmailApi(account.secret), input.messageId)).labelIds?.includes(labelId) ?? false);
+    });
+}