automate.ax 0.3.1 → 0.4.0

package/README.md

@@ -6,7 +6,6 @@ Happy-path Automate.ax package for automation authors. It provides the `automate
 
 ```bash
 bun add automate.ax
-bun add @automate.ax/components-core
 ```
 
 ## CLI
@@ -47,8 +46,7 @@ deployment.
 ## Automation
 
 ```ts
-import { log, onHttpRequest } from "@automate.ax/components-core"
-import { automation, transform } from "automate.ax"
+import { automation, log, onHttpRequest, transform } from "automate.ax"
 
 export default automation("When a request is received", () => {
   const request = onHttpRequest({ scope: "automation" })
@@ -113,9 +111,63 @@ idempotent. Outputs do not enter the trigger event bus.
 
 ## Package Role
 
-Use `automate.ax` for app projects, automation and component authoring,
-deploy-time subscriptions, and the `automate` CLI. Install component packages
-such as `@automate.ax/components-core` for platform-provided actions and triggers.
+Use `automate.ax` for app projects, automation and integration authoring,
+deploy-time subscriptions, core actions and triggers, and the `automate` CLI.
 HTTP triggers return `202` immediately unless configured with
 `waitForResponse: true`; responding automations use the platform-provided
 `respondToHttpRequest` action.
+
+Gmail actions are available directly from the SDK:
+
+```ts
+import { sendEmail } from "automate.ax/gmail"
+
+sendEmail({
+  from: {
+    address: "updates@example.com",
+    name: "Status Bot",
+  },
+  html: "<strong>The automation completed.</strong>",
+  replyTo: "support@example.com",
+  subject: "Status update",
+  to: {
+    address: "person@example.com",
+    name: "Alex",
+  },
+})
+```
+
+They use the default connected Google account unless the action receives an
+`account` binding or account reference. The Gmail subpath includes rich message
+composition, send-as aliases, named recipients, custom headers, priority,
+inline attachments, drafts, replies, forwards, complete MIME parsing, threads,
+raw messages, paginated search, profiles, labels, message state, archive, Spam,
+and Trash actions.
+
+`onNewEmail` subscribes to newly received inbox messages and emits that same
+fully parsed message shape:
+
+```ts
+import { automation } from "automate.ax"
+import { markAsRead, onNewEmail } from "automate.ax/gmail"
+
+export default automation("Read incoming mail", () => {
+  const email = onNewEmail()
+  markAsRead({ messageIds: email.messageId })
+})
+```
+
+Pass `account` to both calls to select a named Google account binding. Gmail
+watches are shared by stable Google account identity and renewed by the
+platform.
+
+Search pagination is handled internally and returns stable message/thread or
+draft identities. Batch-friendly mutations accept one message ID or up to 1,000
+IDs and return the modified IDs for action chaining. Trash, untrash, and
+multi-message reads bound request concurrency automatically.
+
+Body-taking actions accept `text`, `html`, or both; when plain text is absent,
+Automate.ax derives it from HTML for sent and received messages. Parsed messages
+include structured addresses, duplicate-preserving headers, Gmail and RFC 5322
+identities, labels, timestamps, snippets, bodies, and File-backed attachments.
+Action inputs and outputs are inferred directly from documented schemas.

package/dist/automation/account-planning.d.ts

@@ -0,0 +1,17 @@
+import { type IntegrationScopeRequirement } from "./integrations.js";
+/**
+ * Records one integration account use and returns its planned selection.
+ *
+ * @param value - Static or signal-backed account selection.
+ * @param serviceId - Integration service required by the caller.
+ * @param requiredScopes - Provider scopes contributed by this use.
+ * @throws When the account selection does not match the required service.
+ */
+export declare function planIntegrationAccountUse(value: unknown, serviceId: string, requiredScopes: IntegrationScopeRequirement[]): {
+    readonly dynamic: true;
+    readonly binding?: undefined;
+} | {
+    readonly binding: string;
+    readonly dynamic: false;
+};
+//# sourceMappingURL=account-planning.d.ts.map

package/dist/automation/account-planning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-planning.d.ts","sourceRoot":"","sources":["../../src/automation/account-planning.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,2BAA2B,EACjC,0BAAsB;AAGvB;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,2BAA2B,EAAE;;;;;;EAW9C"}

package/dist/automation/account-planning.js

@@ -0,0 +1,48 @@
+import { DEFAULT_ACCOUNT_BINDING, isIntegrationAccountReference, serializedIntegrationAccountDefinition, } from "./integrations.js";
+import { isSignal } from "./signal.js";
+/**
+ * Records one integration account use and returns its planned selection.
+ *
+ * @param value - Static or signal-backed account selection.
+ * @param serviceId - Integration service required by the caller.
+ * @param requiredScopes - Provider scopes contributed by this use.
+ * @throws When the account selection does not match the required service.
+ */
+export function planIntegrationAccountUse(value, serviceId, requiredScopes) {
+    const selection = getPlannedAccountSelection(value, serviceId);
+    globalThis.__AUTOMATION_PLANNING_CONTEXT__?.accountUses.push({
+        ...selection,
+        requiredScopes,
+        serviceId,
+    });
+    return selection;
+}
+/**
+ * Classifies an account input without evaluating signal transforms.
+ *
+ * @param value - Account selection supplied by an action or event function.
+ * @param serviceId - Integration service required by the caller.
+ * @throws When the account selection does not match the required service.
+ */
+function getPlannedAccountSelection(value, serviceId) {
+    if (isSignal(value)) {
+        return { dynamic: true };
+    }
+    if (value === undefined || typeof value === "string") {
+        return {
+            binding: value ?? DEFAULT_ACCOUNT_BINDING,
+            dynamic: false,
+        };
+    }
+    if (!isIntegrationAccountReference(value)) {
+        throw new Error("Integration account input is not a named account binding.");
+    }
+    const definition = value[serializedIntegrationAccountDefinition];
+    if (definition.serviceId !== serviceId) {
+        throw new Error(`Expected a ${serviceId} account, but received a ${definition.serviceId} account.`);
+    }
+    return {
+        binding: definition.binding,
+        dynamic: false,
+    };
+}

package/dist/automation/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/automation/actions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/automation/actions.ts"],"names":[],"mappings":"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"}

package/dist/automation/actions.js

@@ -2,6 +2,7 @@ import { mapValues } from "@zachsents/zippy";
 import { omit, pick } from "remeda";
 import { z } from "zod";
 import { actionAccountRequirementDefinition, DEFAULT_ACCOUNT_BINDING, isIntegrationAccountReference, serializedIntegrationAccountDefinition, } from "./integrations.js";
+import { planIntegrationAccountUse } from "./account-planning.js";
 import { actionProvenance, createActionSignal, isSignal, signalTransform, signalValueType, subscriptionProvenance, transform, } from "./signal.js";
 import { consumeHookSlot } from "./runtime.js";
 const DEFAULT_ACTION_INPUT_SCHEMA = z.record(z.string(), z.never());
@@ -74,13 +75,8 @@ function invokeAction(options, input) {
     const slot = consumeHookSlot();
     const accountInput = options.account && "account" in input ? input.account : undefined;
     const schemaInput = options.account ? omit(input, ["account"]) : input;
-    const planningContext = globalThis.__AUTOMATION_PLANNING_CONTEXT__;
-    if (planningContext && options.account) {
-        planningContext.accountUses.push({
-            ...getPlannedAccountSelection(accountInput, options.account.serviceId),
-            requiredScopes: options.account.requiredScopes,
-            serviceId: options.account.serviceId,
-        });
+    if (globalThis.__AUTOMATION_PLANNING_CONTEXT__ && options.account) {
+        planIntegrationAccountUse(accountInput, options.account.serviceId, options.account.requiredScopes);
     }
     const state = globalThis.__AUTOMATION_RUNTIME_STATE__;
     if (state?.phase === "orchestrate") {
@@ -157,35 +153,6 @@ async function resolveActionAccount(value, requirement, resolveAccountInput) {
         serviceId: requirement.serviceId,
     });
 }
-/**
- * Classifies an action account input without evaluating signal transforms.
- *
- * @param value - Account selection supplied to the action.
- * @param serviceId - Integration service required by the action.
- * @throws When the input is not a compatible account selection.
- */
-function getPlannedAccountSelection(value, serviceId) {
-    if (isSignal(value)) {
-        return { dynamic: true };
-    }
-    if (value === undefined || typeof value === "string") {
-        return {
-            binding: value ?? DEFAULT_ACCOUNT_BINDING,
-            dynamic: false,
-        };
-    }
-    if (!isIntegrationAccountReference(value)) {
-        throw new Error("Action account input is not a named integration account binding.");
-    }
-    const definition = value[serializedIntegrationAccountDefinition];
-    if (definition.serviceId !== serviceId) {
-        throw new Error(`Action requires a ${serviceId} account, but received a ${definition.serviceId} account.`);
-    }
-    return {
-        binding: definition.binding,
-        dynamic: false,
-    };
-}
 /**
  * Creates a string signal by interpolating in-memory values and signals.
  *

package/dist/cli/usage.d.ts

@@ -1,6 +1,7 @@
 import type { RunMainOptions } from "citty";
 /**
- * Prints CLI help with Automate.ax's own accent color and grouped root commands.
+ * Prints CLI help with Automate.ax's own accent color and grouped root
+ * commands.
  *
  * @param cmd - Command definition to render.
  * @param parent - Parent definition for a nested command.

package/dist/cli/usage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/cli/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAMV,cAAc,EAEf,MAAM,OAAO,CAAA;AA8Bd;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,WAAW,CAAC,cAAc,CAAC,WAAW,CAAC,CAO9D,CAAA"}
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/cli/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAMV,cAAc,EAEf,MAAM,OAAO,CAAA;AA8Bd;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,EAAE,WAAW,CAAC,cAAc,CAAC,WAAW,CAAC,CAO9D,CAAA"}

package/dist/cli/usage.js

@@ -26,7 +26,8 @@ const COMMAND_GROUPS = [
     },
 ];
 /**
- * Prints CLI help with Automate.ax's own accent color and grouped root commands.
+ * Prints CLI help with Automate.ax's own accent color and grouped root
+ * commands.
  *
  * @param cmd - Command definition to render.
  * @param parent - Parent definition for a nested command.

package/dist/components/core/actions.d.ts

@@ -0,0 +1,29 @@
+import { z } from "zod";
+export declare const log: import("../..").DefinedAction<z.ZodObject<{
+    value: z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>;
+}, z.core.$strip>, z.ZodVoid, never>;
+export declare const add: import("../..").DefinedAction<z.ZodObject<{
+    a: z.ZodNumber;
+    b: z.ZodNumber;
+}, z.core.$strip>, z.ZodNumber, never>;
+export declare const multiply: import("../..").DefinedAction<z.ZodObject<{
+    a: z.ZodNumber;
+    b: z.ZodNumber;
+}, z.core.$strip>, z.ZodNumber, never>;
+export declare const subtract: import("../..").DefinedAction<z.ZodObject<{
+    a: z.ZodNumber;
+    b: z.ZodNumber;
+}, z.core.$strip>, z.ZodNumber, never>;
+export declare const sendEmail: import("../..").DefinedAction<z.ZodObject<{
+    subject: z.ZodString;
+    text: z.ZodString;
+    to: z.ZodEmail;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, never>;
+export declare const respondToHttpRequest: import("../..").DefinedAction<z.ZodObject<{
+    body: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodCustom<Blob, Blob>]>>>;
+    headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    status: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodVoid, never>;
+//# sourceMappingURL=actions.d.ts.map

package/dist/components/core/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/components/core/actions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB,eAAO,MAAM,GAAG;;oCAOmC,CAAA;AAEnD,eAAO,MAAM,GAAG;;;sCAQ4B,CAAA;AAE5C,eAAO,MAAM,QAAQ;;;sCAQuB,CAAA;AAE5C,eAAO,MAAM,QAAQ;;;sCAQuB,CAAA;AAE5C,eAAO,MAAM,SAAS;;;;;;yBAakD,CAAA;AAExE,eAAO,MAAM,oBAAoB;;;;oCAiB7B,CAAA"}

package/dist/components/core/actions.js

@@ -0,0 +1,57 @@
+import { encodableSchema } from "@automate.ax/codec";
+import { z } from "zod";
+import { defineAction } from "../../automation/actions.js";
+const HTTP_RESPONSE_OUTPUT_TYPE = "http.request.response";
+export const log = defineAction("Log")
+    .input(z.object({
+    value: encodableSchema,
+}))
+    .output(z.void())
+    .handler(({ input }) => console.log(input.value));
+export const add = defineAction("Add")
+    .input(z.object({
+    a: z.number(),
+    b: z.number(),
+}))
+    .output(z.number())
+    .handler(({ input }) => input.a + input.b);
+export const multiply = defineAction("Multiply")
+    .input(z.object({
+    a: z.number(),
+    b: z.number(),
+}))
+    .output(z.number())
+    .handler(({ input }) => input.a * input.b);
+export const subtract = defineAction("Subtract")
+    .input(z.object({
+    a: z.number(),
+    b: z.number(),
+}))
+    .output(z.number())
+    .handler(({ input }) => input.a - input.b);
+export const sendEmail = defineAction("Send email")
+    .input(z.object({
+    subject: z.string(),
+    text: z.string(),
+    to: z.email(),
+}))
+    .output(z.object({
+    id: z.string().nullable(),
+}))
+    .handler(async ({ input, runtime }) => await runtime.sendEmail(input));
+export const respondToHttpRequest = defineAction("Respond to HTTP request")
+    .input(z.object({
+    body: z
+        .union([z.string(), z.instanceof(Blob)])
+        .nullable()
+        .optional(),
+    headers: z.record(z.string(), z.string()).default({}),
+    status: z.number().int().min(100).max(599).default(200),
+}))
+    .output(z.void())
+    .handler(async ({ input, runtime }) => {
+    await runtime.sendOutput({
+        data: input,
+        type: HTTP_RESPONSE_OUTPUT_TYPE,
+    });
+});

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

@@ -0,0 +1,3 @@
+export * from "./actions.js";
+export * from "./triggers.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/core/index.ts"],"names":[],"mappings":"AAAA,6BAAyB;AACzB,8BAA0B"}

package/dist/components/core/index.js

@@ -0,0 +1,2 @@
+export * from "./actions.js";
+export * from "./triggers.js";

package/dist/components/core/triggers.d.ts

@@ -0,0 +1,21 @@
+import type { Encodable } from "@automate.ax/codec";
+export type HttpRequestMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+export interface HttpRequestConfig {
+    scope: "project" | "automation";
+    waitForResponse?: boolean;
+}
+export type HttpRequestEvent = {
+    body: Encodable;
+    headers: Record<string, string>;
+    method: HttpRequestMethod;
+    path: string;
+    query: Record<string, string>;
+    url: string;
+};
+/**
+ * Subscribes the current automation to HTTP requests.
+ *
+ * @param config - Scope at which HTTP requests should be received.
+ */
+export declare function onHttpRequest(config: HttpRequestConfig): import("../..").Signal<HttpRequestEvent>;
+//# sourceMappingURL=triggers.d.ts.map

package/dist/components/core/triggers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.d.ts","sourceRoot":"","sources":["../../../src/components/core/triggers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAGnD,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAA;AAE3E,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,SAAS,GAAG,YAAY,CAAA;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,SAAS,CAAA;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,MAAM,EAAE,iBAAiB,CAAA;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,iBAAiB,4CAEtD"}

package/dist/components/core/triggers.js

@@ -0,0 +1,9 @@
+import { subscribe } from "../../automation/subscribe.js";
+/**
+ * Subscribes the current automation to HTTP requests.
+ *
+ * @param config - Scope at which HTTP requests should be received.
+ */
+export function onHttpRequest(config) {
+    return subscribe("http.request", config);
+}

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

@@ -0,0 +1,12 @@
+import { z } from "zod";
+/**
+ * Adds one Gmail label to 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 addLabel: 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=add-label.d.ts.map

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

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

package/dist/components/gmail/actions/add-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";
+/**
+ * Adds one Gmail label to one or many messages.
+ *
+ * Accepts a label display name or immutable label ID and returns the modified
+ * message IDs for action chaining.
+ */
+export const addLabel = defineAction("Add Gmail label")
+    .describe("Adds a Gmail label to 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: {
+            addLabelIds: [await findLabelId(gmailApi, input.label)],
+            ids: messageIds,
+        },
+        userId: "me",
+    });
+    return messageIds;
+});

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

@@ -0,0 +1,9 @@
+/**
+ * Archives one or many Gmail messages.
+ *
+ * The returned IDs can be passed directly to another batch-friendly action.
+ */
+export declare const archive: 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=archive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../../../src/components/gmail/actions/archive.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,OAAO;;4FAInB,CAAA"}

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

@@ -0,0 +1,7 @@
+import { defineMessageLabelMutation } from "../lib/action-factories.js";
+/**
+ * Archives one or many Gmail messages.
+ *
+ * The returned IDs can be passed directly to another batch-friendly action.
+ */
+export const archive = defineMessageLabelMutation("Archive Gmail messages", "Archives Gmail messages by removing them from the inbox.", { removeLabelIds: ["INBOX"] });

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

@@ -0,0 +1,43 @@
+import { z } from "zod";
+/** Creates a user-owned Gmail label and returns its complete metadata. */
+export declare const createLabel: import("../../..").DefinedAction<z.ZodObject<{
+    color: z.ZodOptional<z.ZodObject<{
+        backgroundColor: z.ZodString;
+        textColor: z.ZodString;
+    }, z.core.$strip>>;
+    labelListVisibility: z.ZodOptional<z.ZodEnum<{
+        labelHide: "labelHide";
+        labelShow: "labelShow";
+        labelShowIfUnread: "labelShowIfUnread";
+    }>>;
+    messageListVisibility: z.ZodOptional<z.ZodEnum<{
+        hide: "hide";
+        show: "show";
+    }>>;
+    name: 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=create-label.d.ts.map

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

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

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

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { defineAction } from "../../../automation/actions.js";
+import { 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";
+/** Creates a user-owned Gmail label and returns its complete metadata. */
+export const createLabel = defineAction("Create Gmail label")
+    .describe("Creates a user-owned Gmail label.")
+    .account("google", GMAIL_MODIFY_REQUIREMENT)
+    .input(z.object({
+    /** Optional supported Gmail label color. */
+    color: LABEL_COLOR_SCHEMA.optional(),
+    /** 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(),
+    /** Human-readable label name. */
+    name: z.string().min(1),
+}))
+    .output(LABEL_SCHEMA)
+    .handler(async ({ account, input }) => {
+    const { data: label } = await getGmailApi(account.secret).users.labels.create({
+        requestBody: input,
+        userId: "me",
+    });
+    return toGmailLabel(label);
+});

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

@@ -0,0 +1,6 @@
+import { z } from "zod";
+/** Permanently deletes a Gmail draft and returns the deleted draft ID. */
+export declare const deleteDraft: import("../../..").DefinedAction<z.ZodObject<{
+    draftId: z.ZodString;
+}, z.core.$strip>, z.ZodString, "google">;
+//# sourceMappingURL=delete-draft.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete-draft.d.ts","sourceRoot":"","sources":["../../../../src/components/gmail/actions/delete-draft.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB,0EAA0E;AAC1E,eAAO,MAAM,WAAW;;yCAgBpB,CAAA"}

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

@@ -0,0 +1,20 @@
+import { z } from "zod";
+import { defineAction } from "../../../automation/actions.js";
+import { getGmailApi } from "../lib/gmail.js";
+import { GMAIL_COMPOSE_REQUIREMENT } from "../lib/scopes.js";
+/** Permanently deletes a Gmail draft and returns the deleted draft ID. */
+export const deleteDraft = defineAction("Delete Gmail draft")
+    .describe("Permanently deletes a Gmail draft.")
+    .account("google", GMAIL_COMPOSE_REQUIREMENT)
+    .input(z.object({
+    /** Immutable Gmail draft ID to delete permanently. */
+    draftId: z.string().min(1),
+}))
+    .output(z.string())
+    .handler(async ({ account, input }) => {
+    await getGmailApi(account.secret).users.drafts.delete({
+        id: input.draftId,
+        userId: "me",
+    });
+    return input.draftId;
+});

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

@@ -0,0 +1,6 @@
+import { z } from "zod";
+/** Permanently deletes a user-owned Gmail label and returns its label ID. */
+export declare const deleteLabel: import("../../..").DefinedAction<z.ZodObject<{
+    label: z.ZodString;
+}, z.core.$strip>, z.ZodString, "google">;
+//# sourceMappingURL=delete-label.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete-label.d.ts","sourceRoot":"","sources":["../../../../src/components/gmail/actions/delete-label.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB,6EAA6E;AAC7E,eAAO,MAAM,WAAW;;yCAkBpB,CAAA"}

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

@@ -0,0 +1,22 @@
+import { z } from "zod";
+import { defineAction } from "../../../automation/actions.js";
+import { findLabelId, getGmailApi } from "../lib/gmail.js";
+import { GMAIL_MODIFY_REQUIREMENT } from "../lib/scopes.js";
+/** Permanently deletes a user-owned Gmail label and returns its label ID. */
+export const deleteLabel = defineAction("Delete Gmail label")
+    .describe("Permanently deletes a user-owned Gmail label.")
+    .account("google", GMAIL_MODIFY_REQUIREMENT)
+    .input(z.object({
+    /** Gmail label display name or immutable ID to delete. */
+    label: z.string().min(1),
+}))
+    .output(z.string())
+    .handler(async ({ account, input }) => {
+    const gmailApi = getGmailApi(account.secret);
+    const labelId = await findLabelId(gmailApi, input.label);
+    await gmailApi.users.labels.delete({
+        id: labelId,
+        userId: "me",
+    });
+    return labelId;
+});