automate.ax 0.3.0 → 0.4.0

package/dist/components/gmail/actions/modify-labels.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+import { defineAction } from "../../../automation/actions.js";
+import { findLabelIds, getGmailApi, normalizeMessageIds } from "../lib/gmail.js";
+import { GMAIL_MODIFY_REQUIREMENT } from "../lib/scopes.js";
+import { MESSAGE_IDS_SCHEMA } from "../lib/schemas.js";
+/**
+ * Adds and removes multiple Gmail labels in one batch request.
+ *
+ * Label display names and immutable IDs may be mixed in either list.
+ */
+export const modifyLabels = defineAction("Modify Gmail labels")
+    .describe("Adds and removes Gmail labels in one batch request.")
+    .account("google", GMAIL_MODIFY_REQUIREMENT)
+    .input(z
+    .object({
+    /** Label names or IDs to add. */
+    add: z.string().min(1).array().optional(),
+    /** One ID or up to 1,000 immutable Gmail message IDs. */
+    messageIds: MESSAGE_IDS_SCHEMA,
+    /** Label names or IDs to remove. */
+    remove: z.string().min(1).array().optional(),
+})
+    .refine((input) => Boolean(input.add?.length || input.remove?.length), "At least one label must be added or removed."))
+    .output(z.string().array())
+    .handler(async ({ account, input }) => {
+    const gmailApi = getGmailApi(account.secret);
+    const labelIds = await findLabelIds(gmailApi, [
+        ...(input.add ?? []),
+        ...(input.remove ?? []),
+    ]);
+    const messageIds = normalizeMessageIds(input.messageIds);
+    await gmailApi.users.messages.batchModify({
+        requestBody: {
+            addLabelIds: labelIds.slice(0, input.add?.length ?? 0),
+            ids: messageIds,
+            removeLabelIds: labelIds.slice(input.add?.length ?? 0),
+        },
+        userId: "me",
+    });
+    return messageIds;
+});

package/dist/components/gmail/actions/move-to-inbox.d.ts

@@ -0,0 +1,5 @@
+/** Moves one or many Gmail messages into the inbox. */
+export declare const moveToInbox: 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=move-to-inbox.d.ts.map

package/dist/components/gmail/actions/move-to-inbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"move-to-inbox.d.ts","sourceRoot":"","sources":["../../../../src/components/gmail/actions/move-to-inbox.ts"],"names":[],"mappings":"AAEA,uDAAuD;AACvD,eAAO,MAAM,WAAW;;4FAIvB,CAAA"}

package/dist/components/gmail/actions/move-to-inbox.js

@@ -0,0 +1,3 @@
+import { defineMessageLabelMutation } from "../lib/action-factories.js";
+/** Moves one or many Gmail messages into the inbox. */
+export const moveToInbox = defineMessageLabelMutation("Move Gmail messages to inbox", "Adds Gmail's Inbox label to messages.", { addLabelIds: ["INBOX"] });

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

@@ -0,0 +1,12 @@
+import { z } from "zod";
+/**
+ * Removes one Gmail label from one or many messages.
+ *
+ * Accepts a label display name or immutable label ID and returns the modified
+ * message IDs for action chaining.
+ */
+export declare const removeLabel: import("../../..").DefinedAction<z.ZodObject<{
+    label: z.ZodString;
+    messageIds: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+}, z.core.$strip>, z.ZodArray<z.ZodString>, "google">;
+//# sourceMappingURL=remove-label.d.ts.map

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

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

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

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { defineAction } from "../../../automation/actions.js";
+import { findLabelId, getGmailApi, normalizeMessageIds } from "../lib/gmail.js";
+import { GMAIL_MODIFY_REQUIREMENT } from "../lib/scopes.js";
+import { MESSAGE_IDS_SCHEMA } from "../lib/schemas.js";
+/**
+ * Removes one Gmail label from one or many messages.
+ *
+ * Accepts a label display name or immutable label ID and returns the modified
+ * message IDs for action chaining.
+ */
+export const removeLabel = defineAction("Remove Gmail label")
+    .describe("Removes a Gmail label from one or many messages.")
+    .account("google", GMAIL_MODIFY_REQUIREMENT)
+    .input(z.object({
+    /** Gmail label display name or immutable ID. */
+    label: z.string().min(1),
+    /** One ID or up to 1,000 immutable Gmail message IDs. */
+    messageIds: MESSAGE_IDS_SCHEMA,
+}))
+    .output(z.string().array())
+    .handler(async ({ account, input }) => {
+    const gmailApi = getGmailApi(account.secret);
+    const messageIds = normalizeMessageIds(input.messageIds);
+    await gmailApi.users.messages.batchModify({
+        requestBody: {
+            ids: messageIds,
+            removeLabelIds: [await findLabelId(gmailApi, input.label)],
+        },
+        userId: "me",
+    });
+    return messageIds;
+});

package/dist/components/gmail/actions/reply-thread.d.ts

@@ -0,0 +1,65 @@
+import { z } from "zod";
+/**
+ * Replies to the latest received message in a Gmail thread.
+ *
+ * Sent messages are ignored, so archived conversations remain replyable.
+ */
+export declare const replyThread: 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>>;
+    html: z.ZodOptional<z.ZodString>;
+    priority: z.ZodOptional<z.ZodEnum<{
+        high: "high";
+        normal: "normal";
+        low: "low";
+    }>>;
+    replyAll: z.ZodOptional<z.ZodBoolean>;
+    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>]>>]>>;
+    text: 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>]>>]>>;
+    threadId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    messageId: z.ZodString;
+    threadId: z.ZodString;
+    historyId: z.ZodOptional<z.ZodString>;
+    labelIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, "google">;
+//# sourceMappingURL=reply-thread.d.ts.map

package/dist/components/gmail/actions/reply-thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reply-thread.d.ts","sourceRoot":"","sources":["../../../../src/components/gmail/actions/reply-thread.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BA+BpB,CAAA"}

package/dist/components/gmail/actions/reply-thread.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { defineAction } from "../../../automation/actions.js";
+import { getGmailApi, sendReply } from "../lib/gmail.js";
+import { GMAIL_SEND_AND_METADATA_REQUIREMENT } from "../lib/scopes.js";
+import { MESSAGE_METADATA_SCHEMA, REPLY_OPTIONS_SCHEMA } from "../lib/schemas.js";
+/**
+ * Replies to the latest received message in a Gmail thread.
+ *
+ * Sent messages are ignored, so archived conversations remain replyable.
+ */
+export const replyThread = defineAction("Reply to Gmail thread")
+    .describe("Replies to the latest received message in a Gmail thread.")
+    .account("google", GMAIL_SEND_AND_METADATA_REQUIREMENT)
+    .input(REPLY_OPTIONS_SCHEMA.extend({
+    /** Immutable Gmail thread ID receiving the reply. */
+    threadId: z.string().min(1),
+}))
+    .output(MESSAGE_METADATA_SCHEMA)
+    .handler(async ({ account, input }) => {
+    const gmailApi = getGmailApi(account.secret);
+    const latestReceivedMessage = [
+        ...((await gmailApi.users.threads.get({
+            format: "metadata",
+            id: input.threadId,
+            userId: "me",
+        })).data.messages ?? []),
+    ]
+        .filter((message) => !message.labelIds?.includes("SENT"))
+        .toSorted((a, b) => Number(b.internalDate ?? "0") - Number(a.internalDate ?? "0"))
+        .at(0);
+    if (!latestReceivedMessage) {
+        throw new Error("Gmail thread has no received messages to reply to.");
+    }
+    return await sendReply(gmailApi, latestReceivedMessage, input);
+});

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

@@ -0,0 +1,66 @@
+import { z } from "zod";
+/**
+ * Replies to one Gmail message.
+ *
+ * Gmail derives the conversation headers and primary recipient. Optional To,
+ * Cc, and Bcc values add recipients to the outgoing reply.
+ */
+export declare const reply: 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>>;
+    html: z.ZodOptional<z.ZodString>;
+    priority: z.ZodOptional<z.ZodEnum<{
+        high: "high";
+        normal: "normal";
+        low: "low";
+    }>>;
+    replyAll: z.ZodOptional<z.ZodBoolean>;
+    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>]>>]>>;
+    text: 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>]>>]>>;
+    messageId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    messageId: z.ZodString;
+    threadId: z.ZodString;
+    historyId: z.ZodOptional<z.ZodString>;
+    labelIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, "google">;
+//# sourceMappingURL=reply.d.ts.map

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

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

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

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { defineAction } from "../../../automation/actions.js";
+import { getGmailApi, getMessageMetadata, sendReply } from "../lib/gmail.js";
+import { GMAIL_SEND_AND_METADATA_REQUIREMENT } from "../lib/scopes.js";
+import { MESSAGE_METADATA_SCHEMA, REPLY_OPTIONS_SCHEMA } from "../lib/schemas.js";
+/**
+ * Replies to one Gmail message.
+ *
+ * Gmail derives the conversation headers and primary recipient. Optional To,
+ * Cc, and Bcc values add recipients to the outgoing reply.
+ */
+export const reply = defineAction("Reply to Gmail message")
+    .describe("Replies to a Gmail message with optional additional recipients.")
+    .account("google", GMAIL_SEND_AND_METADATA_REQUIREMENT)
+    .input(REPLY_OPTIONS_SCHEMA.extend({
+    /** Immutable Gmail message ID receiving the reply. */
+    messageId: z.string().min(1),
+}))
+    .output(MESSAGE_METADATA_SCHEMA)
+    .handler(async ({ account, input }) => {
+    const gmailApi = getGmailApi(account.secret);
+    return await sendReply(gmailApi, await getMessageMetadata(gmailApi, input.messageId), input);
+});

package/dist/components/gmail/actions/search-drafts.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+/**
+ * Searches Gmail drafts using Gmail's standard query syntax.
+ *
+ * Pagination is handled internally until the requested total limit is reached.
+ */
+export declare const searchDrafts: import("../../..").DefinedAction<z.ZodObject<{
+    includeSpamTrash: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    query: z.ZodOptional<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>;
+    draftId: z.ZodString;
+}, z.core.$strip>>, "google">;
+//# sourceMappingURL=search-drafts.d.ts.map

package/dist/components/gmail/actions/search-drafts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-drafts.d.ts","sourceRoot":"","sources":["../../../../src/components/gmail/actions/search-drafts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;6BAiDrB,CAAA"}

package/dist/components/gmail/actions/search-drafts.js

@@ -0,0 +1,50 @@
+import { z } from "zod";
+import { defineAction } from "../../../automation/actions.js";
+import { getGmailApi } from "../lib/gmail.js";
+import { GMAIL_READ_REQUIREMENT } from "../lib/scopes.js";
+import { DRAFT_IDENTIFIER_SCHEMA } from "../lib/schemas.js";
+/**
+ * Searches Gmail drafts using Gmail's standard query syntax.
+ *
+ * Pagination is handled internally until the requested total limit is reached.
+ */
+export const searchDrafts = defineAction("Search Gmail drafts")
+    .describe("Searches Gmail drafts and returns their stable identities.")
+    .account("google", GMAIL_READ_REQUIREMENT)
+    .input(z.object({
+    /** Whether drafts in Spam and Trash may match. */
+    includeSpamTrash: z.boolean().optional(),
+    /** Maximum total results returned across internally fetched pages. */
+    limit: z.number().int().min(1).max(10_000).optional(),
+    /** Standard Gmail search-box query. */
+    query: z.string().optional(),
+}))
+    .output(DRAFT_IDENTIFIER_SCHEMA.array())
+    .handler(async ({ account, input }) => {
+    const gmailApi = getGmailApi(account.secret);
+    const limit = input.limit ?? 100;
+    const drafts = [];
+    let pageToken;
+    do {
+        const { data } = await gmailApi.users.drafts.list({
+            includeSpamTrash: input.includeSpamTrash ?? false,
+            maxResults: Math.min(500, limit - drafts.length),
+            pageToken,
+            q: input.query,
+            userId: "me",
+        });
+        drafts.push(...(data.drafts ?? []).flatMap((draft) => draft.id && draft.message?.id && draft.message.threadId
+            ? [
+                {
+                    draftId: draft.id,
+                    historyId: draft.message.historyId ?? undefined,
+                    labelIds: draft.message.labelIds ?? [],
+                    messageId: draft.message.id,
+                    threadId: draft.message.threadId,
+                },
+            ]
+            : []));
+        pageToken = data.nextPageToken ?? undefined;
+    } while (pageToken && drafts.length < limit);
+    return drafts.slice(0, limit);
+});

package/dist/components/gmail/actions/search-messages.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+/**
+ * Searches Gmail messages using Gmail's standard query syntax.
+ *
+ * Pagination is handled internally until the requested total limit is reached.
+ */
+export declare const searchMessages: import("../../..").DefinedAction<z.ZodObject<{
+    includeSpamTrash: z.ZodOptional<z.ZodBoolean>;
+    labelIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    query: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodArray<z.ZodObject<{
+    messageId: z.ZodString;
+    threadId: z.ZodString;
+}, z.core.$strip>>, "google">;
+//# sourceMappingURL=search-messages.d.ts.map

package/dist/components/gmail/actions/search-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-messages.d.ts","sourceRoot":"","sources":["../../../../src/components/gmail/actions/search-messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;;;6BA6CvB,CAAA"}

package/dist/components/gmail/actions/search-messages.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+import { defineAction } from "../../../automation/actions.js";
+import { getGmailApi } from "../lib/gmail.js";
+import { GMAIL_READ_REQUIREMENT } from "../lib/scopes.js";
+import { MESSAGE_IDENTIFIER_SCHEMA } from "../lib/schemas.js";
+/**
+ * Searches Gmail messages using Gmail's standard query syntax.
+ *
+ * Pagination is handled internally until the requested total limit is reached.
+ */
+export const searchMessages = defineAction("Search Gmail messages")
+    .describe("Searches Gmail and returns matching message and thread IDs.")
+    .account("google", GMAIL_READ_REQUIREMENT)
+    .input(z.object({
+    /** Whether messages in Spam and Trash may match. */
+    includeSpamTrash: z.boolean().optional(),
+    /** Label IDs that every returned message must carry. */
+    labelIds: z.string().min(1).array().optional(),
+    /** Maximum total results returned across internally fetched pages. */
+    limit: z.number().int().min(1).max(10_000).optional(),
+    /** Standard Gmail search-box query. */
+    query: z.string().optional(),
+}))
+    .output(MESSAGE_IDENTIFIER_SCHEMA.array())
+    .handler(async ({ account, input }) => {
+    const gmailApi = getGmailApi(account.secret);
+    const limit = input.limit ?? 100;
+    const messages = [];
+    let pageToken;
+    do {
+        const { data } = await gmailApi.users.messages.list({
+            includeSpamTrash: input.includeSpamTrash ?? false,
+            labelIds: input.labelIds,
+            maxResults: Math.min(500, limit - messages.length),
+            pageToken,
+            q: input.query,
+            userId: "me",
+        });
+        messages.push(...(data.messages ?? []).flatMap((message) => message.id && message.threadId
+            ? [{ messageId: message.id, threadId: message.threadId }]
+            : []));
+        pageToken = data.nextPageToken ?? undefined;
+    } while (pageToken && messages.length < limit);
+    return messages.slice(0, limit);
+});

package/dist/components/gmail/actions/search-threads.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+/**
+ * Searches Gmail threads using Gmail's standard query syntax.
+ *
+ * Pagination is handled internally until the requested total limit is reached.
+ */
+export declare const searchThreads: import("../../..").DefinedAction<z.ZodObject<{
+    includeSpamTrash: z.ZodOptional<z.ZodBoolean>;
+    labelIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    query: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodArray<z.ZodObject<{
+    threadId: z.ZodString;
+}, z.core.$strip>>, "google">;
+//# sourceMappingURL=search-threads.d.ts.map

package/dist/components/gmail/actions/search-threads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-threads.d.ts","sourceRoot":"","sources":["../../../../src/components/gmail/actions/search-threads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;;;;;6BA2CtB,CAAA"}

package/dist/components/gmail/actions/search-threads.js

@@ -0,0 +1,43 @@
+import { z } from "zod";
+import { defineAction } from "../../../automation/actions.js";
+import { getGmailApi } from "../lib/gmail.js";
+import { GMAIL_READ_REQUIREMENT } from "../lib/scopes.js";
+import { THREAD_IDENTIFIER_SCHEMA } from "../lib/schemas.js";
+/**
+ * Searches Gmail threads using Gmail's standard query syntax.
+ *
+ * Pagination is handled internally until the requested total limit is reached.
+ */
+export const searchThreads = defineAction("Search Gmail threads")
+    .describe("Searches Gmail and returns matching thread IDs.")
+    .account("google", GMAIL_READ_REQUIREMENT)
+    .input(z.object({
+    /** Whether threads in Spam and Trash may match. */
+    includeSpamTrash: z.boolean().optional(),
+    /** Label IDs that every returned thread must carry. */
+    labelIds: z.string().min(1).array().optional(),
+    /** Maximum total results returned across internally fetched pages. */
+    limit: z.number().int().min(1).max(10_000).optional(),
+    /** Standard Gmail search-box query. */
+    query: z.string().optional(),
+}))
+    .output(THREAD_IDENTIFIER_SCHEMA.array())
+    .handler(async ({ account, input }) => {
+    const gmailApi = getGmailApi(account.secret);
+    const limit = input.limit ?? 100;
+    const threads = [];
+    let pageToken;
+    do {
+        const { data } = await gmailApi.users.threads.list({
+            includeSpamTrash: input.includeSpamTrash ?? false,
+            labelIds: input.labelIds,
+            maxResults: Math.min(500, limit - threads.length),
+            pageToken,
+            q: input.query,
+            userId: "me",
+        });
+        threads.push(...(data.threads ?? []).flatMap((thread) => thread.id ? [{ threadId: thread.id }] : []));
+        pageToken = data.nextPageToken ?? undefined;
+    } while (pageToken && threads.length < limit);
+    return threads.slice(0, limit);
+});

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

@@ -0,0 +1,11 @@
+import { z } from "zod";
+/** Sends an existing Gmail draft and returns the sent message metadata. */
+export declare const sendDraft: import("../../..").DefinedAction<z.ZodObject<{
+    draftId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    messageId: z.ZodString;
+    threadId: z.ZodString;
+    historyId: z.ZodOptional<z.ZodString>;
+    labelIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, "google">;
+//# sourceMappingURL=send-draft.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"send-draft.d.ts","sourceRoot":"","sources":["../../../../src/components/gmail/actions/send-draft.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB,2EAA2E;AAC3E,eAAO,MAAM,SAAS;;;;;;;4BAoBnB,CAAA"}

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

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import { defineAction } from "../../../automation/actions.js";
+import { getGmailApi, toMessageMetadata } from "../lib/gmail.js";
+import { GMAIL_SEND_REQUIREMENT } from "../lib/scopes.js";
+import { MESSAGE_METADATA_SCHEMA } from "../lib/schemas.js";
+/** Sends an existing Gmail draft and returns the sent message metadata. */
+export const sendDraft = defineAction("Send Gmail draft")
+    .describe("Sends an existing Gmail draft.")
+    .account("google", GMAIL_SEND_REQUIREMENT)
+    .input(z.object({
+    /** Immutable Gmail draft ID to send. */
+    draftId: z.string().min(1),
+}))
+    .output(MESSAGE_METADATA_SCHEMA)
+    .handler(async ({ account, input }) => toMessageMetadata((await getGmailApi(account.secret).users.drafts.send({
+    requestBody: { id: input.draftId },
+    userId: "me",
+})).data, "sent draft"));

package/dist/components/gmail/actions/send-email.d.ts

@@ -0,0 +1,65 @@
+import { z } from "zod";
+/**
+ * Sends a new Gmail message.
+ *
+ * Supports named recipients, send-as aliases, custom headers, priority, inline
+ * attachments, and automatic plain text derived from HTML.
+ */
+export declare const sendEmail: 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>]>>]>>;
+    html: z.ZodOptional<z.ZodString>;
+    subject: z.ZodString;
+    text: z.ZodOptional<z.ZodString>;
+    to: 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>]>>]>;
+}, z.core.$strip>, z.ZodObject<{
+    messageId: z.ZodString;
+    threadId: z.ZodString;
+    historyId: z.ZodOptional<z.ZodString>;
+    labelIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, "google">;
+//# sourceMappingURL=send-email.d.ts.map

package/dist/components/gmail/actions/send-email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-email.d.ts","sourceRoot":"","sources":["../../../../src/components/gmail/actions/send-email.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAUvB;;;;;GAKG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAsCnB,CAAA"}