@automate.ax/catalog 0.62.1 → 0.64.0

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export { airtableService, anthropicService, apolloService, asanaService, brevoService, cerebrasService, cloudflareService, cohereService, deepinfraService, deepseekService, firecrawlService, fireworksService, getIntegrationService, githubService, googleGenaiService, googleService, groqService, huggingfaceService, integrationCatalog, linearService, microsoftService, millionverifierService, mistralService, openaiService, openrouterService, perplexityService, postgresService, resendService, scrapflyService, slackService, tidycalService, togetheraiService, trelloService, vercelAiGatewayService, vercelService, whatsappService, xaiService, type IntegrationServiceId, } from "./catalog.js";
 export { defineIntegrationCatalog, defineIntegrationService, integrationScope, type IntegrationAccountConnectionOption, type IntegrationAccountRequirement, type IntegrationConnectionDefinition, type IntegrationFormField, type IntegrationScopeRequirement, type IntegrationServiceDefinition, type ScopeRequirementGroup, type TriggerDefinition, type TriggerPresentation, type TriggerPresentationContext, type TriggerPresentationDetail, type TriggerScopePresentation, type TriggerPresentationValue, } from "./types.js";
-export { getHttpTriggerEndpoint, getHttpTriggerEndpointKey, getTriggerDefinition, getTriggerName, getTriggerPresentation, isTriggerVisible, triggerCatalog, triggerDefinitions, type HttpTriggerEndpointOptions, type HttpTriggerScope, type TriggerType, } from "./triggers/index.js";
+export { getDashboardRunEndpoint, getDashboardRunEndpointKey, getHttpTriggerEndpoint, getHttpTriggerEndpointKey, getMailhookAddress, getMailhookAddressKey, DASHBOARD_RUN_CONFIG_SCHEMA, getTriggerDefinition, getTriggerName, getTriggerPresentation, isTriggerVisible, PLATFORM_EMAIL_DOMAIN, triggerCatalog, triggerDefinitions, type DashboardRunConfig, type DashboardRunEndpointOptions, type DashboardRunField, type HttpTriggerEndpointOptions, type HttpTriggerScope, type MailhookAddressOptions, type MailhookScope, type TriggerType, } from "./triggers/index.js";

package/dist/index.js

@@ -1,3 +1,3 @@
 export { airtableService, anthropicService, apolloService, asanaService, brevoService, cerebrasService, cloudflareService, cohereService, deepinfraService, deepseekService, firecrawlService, fireworksService, getIntegrationService, githubService, googleGenaiService, googleService, groqService, huggingfaceService, integrationCatalog, linearService, microsoftService, millionverifierService, mistralService, openaiService, openrouterService, perplexityService, postgresService, resendService, scrapflyService, slackService, tidycalService, togetheraiService, trelloService, vercelAiGatewayService, vercelService, whatsappService, xaiService, } from "./catalog.js";
 export { defineIntegrationCatalog, defineIntegrationService, integrationScope, } from "./types.js";
-export { getHttpTriggerEndpoint, getHttpTriggerEndpointKey, getTriggerDefinition, getTriggerName, getTriggerPresentation, isTriggerVisible, triggerCatalog, triggerDefinitions, } from "./triggers/index.js";
+export { getDashboardRunEndpoint, getDashboardRunEndpointKey, getHttpTriggerEndpoint, getHttpTriggerEndpointKey, getMailhookAddress, getMailhookAddressKey, DASHBOARD_RUN_CONFIG_SCHEMA, getTriggerDefinition, getTriggerName, getTriggerPresentation, isTriggerVisible, PLATFORM_EMAIL_DOMAIN, triggerCatalog, triggerDefinitions, } from "./triggers/index.js";

package/dist/triggers/core.d.ts

@@ -1,3 +1,47 @@
+import * as z from "zod/mini";
+export declare const DASHBOARD_RUN_CONFIG_SCHEMA: z.ZodMiniObject<{
+    description: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    fields: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniDiscriminatedUnion<[z.ZodMiniObject<{
+        maxLength: z.ZodMiniOptional<z.ZodMiniNumberFormat>;
+        minLength: z.ZodMiniOptional<z.ZodMiniNumberFormat>;
+        placeholder: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        type: z.ZodMiniEnum<{
+            email: "email";
+            text: "text";
+            url: "url";
+            textarea: "textarea";
+        }>;
+        description: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        label: z.ZodMiniString<string>;
+        required: z.ZodMiniPrefault<z.ZodMiniBoolean<boolean>>;
+    }, z.core.$strip>, z.ZodMiniObject<{
+        max: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+        min: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+        placeholder: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        step: z.ZodMiniPrefault<z.ZodMiniNumber<number>>;
+        type: z.ZodMiniLiteral<"number">;
+        description: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        label: z.ZodMiniString<string>;
+        required: z.ZodMiniPrefault<z.ZodMiniBoolean<boolean>>;
+    }, z.core.$strip>, z.ZodMiniObject<{
+        options: z.ZodMiniArray<z.ZodMiniObject<{
+            label: z.ZodMiniString<string>;
+            value: z.ZodMiniString<string>;
+        }, z.core.$strip>>;
+        placeholder: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        type: z.ZodMiniLiteral<"select">;
+        description: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        label: z.ZodMiniString<string>;
+        required: z.ZodMiniPrefault<z.ZodMiniBoolean<boolean>>;
+    }, z.core.$strip>, z.ZodMiniObject<{
+        type: z.ZodMiniLiteral<"checkbox">;
+        description: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        label: z.ZodMiniString<string>;
+        required: z.ZodMiniPrefault<z.ZodMiniBoolean<boolean>>;
+    }, z.core.$strip>], "type">>;
+    submitLabel: z.ZodMiniPrefault<z.ZodMiniString<string>>;
+    title: z.ZodMiniString<string>;
+}, z.core.$strip>;
 export declare const coreTriggerDefinitions: {
     readonly automationInvoked: {
         readonly getDetails: ({ config }: import("..").TriggerPresentationContext) => {
@@ -26,8 +70,74 @@ export declare const coreTriggerDefinitions: {
         readonly name: "HTTP request";
         readonly type: "http.request";
     };
+    readonly mailhookEmailReceived: {
+        readonly getPrimary: ({ automationId, config, hookSlot, projectId, scopePath }: import("..").TriggerPresentationContext) => {
+            copyable: true;
+            value: string;
+        };
+        readonly icon: "webhook";
+        readonly name: "Mailhook";
+        readonly type: "mailhook.email.received";
+    };
+    readonly dashboardRun: {
+        readonly getDetails: ({ config }: import("..").TriggerPresentationContext) => {
+            label: string;
+            value: string;
+        }[];
+        readonly icon: "automation";
+        readonly name: "Dashboard run";
+        readonly type: "dashboard.run";
+    };
 };
+interface DashboardRunFieldBase {
+    /** Supporting text shown below the field. */
+    description?: string;
+    /** Visible field label. */
+    label: string;
+    /** Whether the form must contain a value. Defaults to true. */
+    required?: boolean;
+}
+export type DashboardRunField = (DashboardRunFieldBase & {
+    maxLength?: number;
+    minLength?: number;
+    placeholder?: string;
+    type: "email" | "text" | "textarea" | "url";
+}) | (DashboardRunFieldBase & {
+    max?: number;
+    min?: number;
+    placeholder?: string;
+    /** Increment used by the number input. Defaults to 1. */
+    step?: number;
+    type: "number";
+}) | (DashboardRunFieldBase & {
+    options: readonly {
+        label: string;
+        value: string;
+    }[];
+    placeholder?: string;
+    type: "select";
+}) | (DashboardRunFieldBase & {
+    type: "checkbox";
+});
+export interface DashboardRunConfig<TFields extends Record<string, DashboardRunField> = Record<string, DashboardRunField>> {
+    /** Supporting text shown below the form title. */
+    description?: string;
+    /** Named fields rendered in declaration order. */
+    fields: TFields;
+    /** Submit button text. Defaults to "Run". */
+    submitLabel?: string;
+    /** Form heading. */
+    title: string;
+}
+export interface DashboardRunEndpointOptions {
+    appOrigin: string;
+    automationId: string;
+    hookSlot: number;
+    scopePath?: readonly number[];
+}
 export type HttpTriggerScope = "trigger" | "automation" | "project";
+export type MailhookScope = HttpTriggerScope;
+export declare const PLATFORM_EMAIL_DOMAIN = "automations.automate.ax";
 export interface HttpTriggerEndpointOptions {
     appOrigin: string;
     automationId: string;
@@ -36,6 +146,14 @@ export interface HttpTriggerEndpointOptions {
     scope: HttpTriggerScope;
     scopePath?: readonly number[];
 }
+export interface MailhookAddressOptions {
+    automationId: string;
+    hookSlot: number;
+    plusPath?: string;
+    projectId: string;
+    scope: MailhookScope;
+    scopePath?: readonly number[];
+}
 /**
  * Returns the public URL for one deployed HTTP trigger.
  *
@@ -48,3 +166,32 @@ export declare function getHttpTriggerEndpoint(options: HttpTriggerEndpointOptio
  * @param options - Trigger and owning resource identity.
  */
 export declare function getHttpTriggerEndpointKey(options: Omit<HttpTriggerEndpointOptions, "appOrigin">): string;
+/**
+ * Returns the unique inbound address for one deployed mailhook.
+ *
+ * Add `+suffix` before the `@` to carry a routing value into the event.
+ *
+ * @param options - Mailhook identity and sharing scope.
+ * @throws When the generated local part exceeds the email size limit.
+ */
+export declare function getMailhookAddress(options: MailhookAddressOptions): string;
+/**
+ * Returns the local-part router key for one configured mailhook scope.
+ *
+ * @param options - Mailhook identity and sharing scope.
+ */
+export declare function getMailhookAddressKey(options: MailhookAddressOptions): string;
+/**
+ * Returns the organization-authenticated submission endpoint for one dashboard
+ * run.
+ *
+ * @param options - Public origin and trigger identity.
+ */
+export declare function getDashboardRunEndpoint(options: DashboardRunEndpointOptions): string;
+/**
+ * Returns the durable endpoint identity for one dashboard run trigger.
+ *
+ * @param options - Trigger and owning automation identity.
+ */
+export declare function getDashboardRunEndpointKey(options: Omit<DashboardRunEndpointOptions, "appOrigin">): string;
+export {};

package/dist/triggers/core.js

@@ -1,4 +1,6 @@
 import * as z from "zod/mini";
+const MAX_EMAIL_LOCAL_PART_BYTES = 64;
+const EMAIL_SCHEMA = z.email();
 const CRON_PRESENTATION_CONFIG_SCHEMA = z.object({
     schedule: z.string(),
     timeZone: z.prefault(z.string(), "UTC"),
@@ -6,9 +8,66 @@ const CRON_PRESENTATION_CONFIG_SCHEMA = z.object({
 const HTTP_PRESENTATION_CONFIG_SCHEMA = z.object({
     scope: z.prefault(z.enum(["trigger", "automation", "project"]), "trigger"),
 });
+const MAILHOOK_PRESENTATION_CONFIG_SCHEMA = z.object({
+    scope: z.prefault(z.enum(["trigger", "automation", "project"]), "trigger"),
+});
 const INVOCATION_PRESENTATION_CONFIG_SCHEMA = z.object({
     entrypoint: z.string(),
 });
+const FIELD_NAME_SCHEMA = z
+    .string()
+    .check(z.trim(), z.minLength(1), z.maxLength(100));
+const FIELD_LABEL_SCHEMA = z
+    .string()
+    .check(z.trim(), z.minLength(1), z.maxLength(255));
+const FIELD_DESCRIPTION_SCHEMA = z.string().check(z.maxLength(2_000));
+const FIELD_LENGTH_SCHEMA = z.int().check(z.nonnegative());
+const DASHBOARD_RUN_FIELD_BASE_SCHEMA = {
+    description: z.optional(FIELD_DESCRIPTION_SCHEMA),
+    label: FIELD_LABEL_SCHEMA,
+    required: z.prefault(z.boolean(), true),
+};
+const DASHBOARD_RUN_TEXT_FIELD_SCHEMA = z.object({
+    ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+    maxLength: z.optional(FIELD_LENGTH_SCHEMA),
+    minLength: z.optional(FIELD_LENGTH_SCHEMA),
+    placeholder: z.optional(z.string()),
+    type: z.enum(["email", "text", "textarea", "url"]),
+});
+const DASHBOARD_RUN_NUMBER_FIELD_SCHEMA = z.object({
+    ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+    max: z.optional(z.number()),
+    min: z.optional(z.number()),
+    placeholder: z.optional(z.string()),
+    step: z.prefault(z.number().check(z.positive()), 1),
+    type: z.literal("number"),
+});
+const DASHBOARD_RUN_SELECT_FIELD_SCHEMA = z.object({
+    ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+    options: z
+        .array(z.object({
+        label: FIELD_LABEL_SCHEMA,
+        value: FIELD_NAME_SCHEMA,
+    }))
+        .check(z.minLength(1)),
+    placeholder: z.optional(z.string()),
+    type: z.literal("select"),
+});
+const DASHBOARD_RUN_CHECKBOX_FIELD_SCHEMA = z.object({
+    ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+    type: z.literal("checkbox"),
+});
+export const DASHBOARD_RUN_CONFIG_SCHEMA = z.object({
+    description: z.optional(FIELD_DESCRIPTION_SCHEMA),
+    fields: z.record(FIELD_NAME_SCHEMA, z.discriminatedUnion("type", [
+        DASHBOARD_RUN_TEXT_FIELD_SCHEMA,
+        DASHBOARD_RUN_NUMBER_FIELD_SCHEMA,
+        DASHBOARD_RUN_SELECT_FIELD_SCHEMA,
+        DASHBOARD_RUN_CHECKBOX_FIELD_SCHEMA,
+    ])),
+    submitLabel: z.prefault(z.string().check(z.trim(), z.minLength(1), z.maxLength(100)), "Run"),
+    title: z.string().check(z.trim(), z.minLength(1), z.maxLength(255)),
+});
 export const coreTriggerDefinitions = {
     automationInvoked: {
         getDetails: ({ config }) => [
@@ -49,7 +108,34 @@ export const coreTriggerDefinitions = {
         name: "HTTP request",
         type: "http.request",
     },
+    mailhookEmailReceived: {
+        getPrimary: ({ automationId, config, hookSlot, projectId, scopePath }) => ({
+            copyable: true,
+            value: getMailhookAddress({
+                automationId,
+                hookSlot,
+                projectId,
+                scope: MAILHOOK_PRESENTATION_CONFIG_SCHEMA.parse(config).scope,
+                scopePath,
+            }),
+        }),
+        icon: "webhook",
+        name: "Mailhook",
+        type: "mailhook.email.received",
+    },
+    dashboardRun: {
+        getDetails: ({ config }) => [
+            {
+                label: "Run form",
+                value: DASHBOARD_RUN_CONFIG_SCHEMA.parse(config).title,
+            },
+        ],
+        icon: "automation",
+        name: "Dashboard run",
+        type: "dashboard.run",
+    },
 };
+export const PLATFORM_EMAIL_DOMAIN = "automations.automate.ax";
 /**
  * Returns the public URL for one deployed HTTP trigger.
  *
@@ -73,3 +159,64 @@ export function getHttpTriggerEndpointKey(options) {
         options.hookSlot,
     ].join(".")}`;
 }
+/**
+ * Returns the unique inbound address for one deployed mailhook.
+ *
+ * Add `+suffix` before the `@` to carry a routing value into the event.
+ *
+ * @param options - Mailhook identity and sharing scope.
+ * @throws When the generated local part exceeds the email size limit.
+ */
+export function getMailhookAddress(options) {
+    const localPart = `${getMailhookAddressKey(options)}${options.plusPath ? `+${options.plusPath}` : ""}`;
+    if (new TextEncoder().encode(localPart).length > MAX_EMAIL_LOCAL_PART_BYTES) {
+        throw new RangeError("Mailhook address local part exceeds 64 bytes.");
+    }
+    return EMAIL_SCHEMA.parse(`${localPart}@${PLATFORM_EMAIL_DOMAIN}`);
+}
+/**
+ * Returns the local-part router key for one configured mailhook scope.
+ *
+ * @param options - Mailhook identity and sharing scope.
+ */
+export function getMailhookAddressKey(options) {
+    if (options.scope === "project")
+        return `p${typeIdSuffix(options.projectId)}`;
+    if (options.scope === "automation") {
+        return `a${typeIdSuffix(options.automationId)}`;
+    }
+    return `a${typeIdSuffix(options.automationId)}.${[
+        ...(options.scopePath ?? []),
+        options.hookSlot,
+    ]
+        .map((segment) => segment.toString(36))
+        .join(".")}`;
+}
+/**
+ * Returns the organization-authenticated submission endpoint for one dashboard
+ * run.
+ *
+ * @param options - Public origin and trigger identity.
+ */
+export function getDashboardRunEndpoint(options) {
+    return new URL(`/api/dashboard-runs/${getDashboardRunEndpointKey(options)}`, options.appOrigin).toString();
+}
+/**
+ * Returns the durable endpoint identity for one dashboard run trigger.
+ *
+ * @param options - Trigger and owning automation identity.
+ */
+export function getDashboardRunEndpointKey(options) {
+    return `${options.automationId}:${[
+        ...(options.scopePath ?? []),
+        options.hookSlot,
+    ].join(".")}`;
+}
+/**
+ * Removes the redundant TypeID prefix from an address router.
+ *
+ * @param id - Project or automation TypeID.
+ */
+function typeIdSuffix(id) {
+    return id.includes("_") ? id.slice(id.indexOf("_") + 1) : id;
+}

package/dist/triggers/index.d.ts

@@ -1,5 +1,5 @@
 import type { TriggerDefinition, TriggerPresentation, TriggerPresentationContext, TriggerScopePresentation } from "../types.js";
-export { getHttpTriggerEndpoint, getHttpTriggerEndpointKey, type HttpTriggerEndpointOptions, type HttpTriggerScope, } from "./core.js";
+export { getDashboardRunEndpoint, getDashboardRunEndpointKey, getHttpTriggerEndpoint, getHttpTriggerEndpointKey, getMailhookAddress, getMailhookAddressKey, PLATFORM_EMAIL_DOMAIN, DASHBOARD_RUN_CONFIG_SCHEMA, type DashboardRunConfig, type DashboardRunEndpointOptions, type DashboardRunField, type HttpTriggerEndpointOptions, type HttpTriggerScope, type MailhookAddressOptions, type MailhookScope, } from "./core.js";
 /** Plain shared definitions for every public trigger type. */
 export declare const triggerDefinitions: {
     readonly whatsappMessageDelivered: {
@@ -1075,6 +1075,24 @@ export declare const triggerDefinitions: {
         readonly name: "HTTP request";
         readonly type: "http.request";
     };
+    readonly mailhookEmailReceived: {
+        readonly getPrimary: ({ automationId, config, hookSlot, projectId, scopePath }: TriggerPresentationContext) => {
+            copyable: true;
+            value: string;
+        };
+        readonly icon: "webhook";
+        readonly name: "Mailhook";
+        readonly type: "mailhook.email.received";
+    };
+    readonly dashboardRun: {
+        readonly getDetails: ({ config }: TriggerPresentationContext) => {
+            label: string;
+            value: string;
+        }[];
+        readonly icon: "automation";
+        readonly name: "Dashboard run";
+        readonly type: "dashboard.run";
+    };
     readonly brevoTransactionalBlocked: {
         readonly account: {
             readonly connectionOptions: readonly [{
@@ -1555,6 +1573,22 @@ export declare const triggerCatalog: ({
     };
     icon: "webhook";
     type: "http.request";
+} | {
+    name: string;
+    getPrimary: ({ automationId, config, hookSlot, projectId, scopePath }: TriggerPresentationContext) => {
+        copyable: true;
+        value: string;
+    };
+    icon: "webhook";
+    type: "mailhook.email.received";
+} | {
+    name: string;
+    getDetails: ({ config }: TriggerPresentationContext) => {
+        label: string;
+        value: string;
+    }[];
+    icon: "automation";
+    type: "dashboard.run";
 } | {
     name: string;
     account: {

package/dist/triggers/index.js

@@ -12,7 +12,7 @@ import { trelloTriggerDefinitions } from "./trello.js";
 import { vercelTriggerDefinitions } from "./vercel.js";
 import { whatsappTriggerDefinitions } from "./whatsapp.js";
 import { getIntegrationService } from "../catalog.js";
-export { getHttpTriggerEndpoint, getHttpTriggerEndpointKey, } from "./core.js";
+export { getDashboardRunEndpoint, getDashboardRunEndpointKey, getHttpTriggerEndpoint, getHttpTriggerEndpointKey, getMailhookAddress, getMailhookAddressKey, PLATFORM_EMAIL_DOMAIN, DASHBOARD_RUN_CONFIG_SCHEMA, } from "./core.js";
 /** Plain shared definitions for every public trigger type. */
 export const triggerDefinitions = {
     ...airtableTriggerDefinitions,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/catalog",
-  "version": "0.62.1",
+  "version": "0.64.0",
   "description": "Shared integration service and trigger definitions for Automate.ax.",
   "license": "MIT",
   "repository": {

package/src/index.ts

@@ -57,15 +57,26 @@ export {
   type TriggerPresentationValue,
 } from "./types"
 export {
+  getDashboardRunEndpoint,
+  getDashboardRunEndpointKey,
   getHttpTriggerEndpoint,
   getHttpTriggerEndpointKey,
+  getMailhookAddress,
+  getMailhookAddressKey,
+  DASHBOARD_RUN_CONFIG_SCHEMA,
   getTriggerDefinition,
   getTriggerName,
   getTriggerPresentation,
   isTriggerVisible,
+  PLATFORM_EMAIL_DOMAIN,
   triggerCatalog,
   triggerDefinitions,
+  type DashboardRunConfig,
+  type DashboardRunEndpointOptions,
+  type DashboardRunField,
   type HttpTriggerEndpointOptions,
   type HttpTriggerScope,
+  type MailhookAddressOptions,
+  type MailhookScope,
   type TriggerType,
 } from "./triggers"

package/src/triggers/core.ts

@@ -1,6 +1,8 @@
 import type { TriggerDefinition } from "../types"
 import * as z from "zod/mini"
 
+const MAX_EMAIL_LOCAL_PART_BYTES = 64
+const EMAIL_SCHEMA = z.email()
 const CRON_PRESENTATION_CONFIG_SCHEMA = z.object({
   schedule: z.string(),
   timeZone: z.prefault(z.string(), "UTC"),
@@ -8,9 +10,75 @@ const CRON_PRESENTATION_CONFIG_SCHEMA = z.object({
 const HTTP_PRESENTATION_CONFIG_SCHEMA = z.object({
   scope: z.prefault(z.enum(["trigger", "automation", "project"]), "trigger"),
 })
+const MAILHOOK_PRESENTATION_CONFIG_SCHEMA = z.object({
+  scope: z.prefault(z.enum(["trigger", "automation", "project"]), "trigger"),
+})
 const INVOCATION_PRESENTATION_CONFIG_SCHEMA = z.object({
   entrypoint: z.string(),
 })
+const FIELD_NAME_SCHEMA = z
+  .string()
+  .check(z.trim(), z.minLength(1), z.maxLength(100))
+const FIELD_LABEL_SCHEMA = z
+  .string()
+  .check(z.trim(), z.minLength(1), z.maxLength(255))
+const FIELD_DESCRIPTION_SCHEMA = z.string().check(z.maxLength(2_000))
+const FIELD_LENGTH_SCHEMA = z.int().check(z.nonnegative())
+const DASHBOARD_RUN_FIELD_BASE_SCHEMA = {
+  description: z.optional(FIELD_DESCRIPTION_SCHEMA),
+  label: FIELD_LABEL_SCHEMA,
+  required: z.prefault(z.boolean(), true),
+}
+const DASHBOARD_RUN_TEXT_FIELD_SCHEMA = z.object({
+  ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+  maxLength: z.optional(FIELD_LENGTH_SCHEMA),
+  minLength: z.optional(FIELD_LENGTH_SCHEMA),
+  placeholder: z.optional(z.string()),
+  type: z.enum(["email", "text", "textarea", "url"]),
+})
+const DASHBOARD_RUN_NUMBER_FIELD_SCHEMA = z.object({
+  ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+  max: z.optional(z.number()),
+  min: z.optional(z.number()),
+  placeholder: z.optional(z.string()),
+  step: z.prefault(z.number().check(z.positive()), 1),
+  type: z.literal("number"),
+})
+const DASHBOARD_RUN_SELECT_FIELD_SCHEMA = z.object({
+  ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+  options: z
+    .array(
+      z.object({
+        label: FIELD_LABEL_SCHEMA,
+        value: FIELD_NAME_SCHEMA,
+      }),
+    )
+    .check(z.minLength(1)),
+  placeholder: z.optional(z.string()),
+  type: z.literal("select"),
+})
+const DASHBOARD_RUN_CHECKBOX_FIELD_SCHEMA = z.object({
+  ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+  type: z.literal("checkbox"),
+})
+
+export const DASHBOARD_RUN_CONFIG_SCHEMA = z.object({
+  description: z.optional(FIELD_DESCRIPTION_SCHEMA),
+  fields: z.record(
+    FIELD_NAME_SCHEMA,
+    z.discriminatedUnion("type", [
+      DASHBOARD_RUN_TEXT_FIELD_SCHEMA,
+      DASHBOARD_RUN_NUMBER_FIELD_SCHEMA,
+      DASHBOARD_RUN_SELECT_FIELD_SCHEMA,
+      DASHBOARD_RUN_CHECKBOX_FIELD_SCHEMA,
+    ]),
+  ),
+  submitLabel: z.prefault(
+    z.string().check(z.trim(), z.minLength(1), z.maxLength(100)),
+    "Run",
+  ),
+  title: z.string().check(z.trim(), z.minLength(1), z.maxLength(255)),
+})
 
 export const coreTriggerDefinitions = {
   automationInvoked: {
@@ -60,9 +128,100 @@ export const coreTriggerDefinitions = {
     name: "HTTP request",
     type: "http.request",
   },
+  mailhookEmailReceived: {
+    getPrimary: ({ automationId, config, hookSlot, projectId, scopePath }) => ({
+      copyable: true,
+      value: getMailhookAddress({
+        automationId,
+        hookSlot,
+        projectId,
+        scope: MAILHOOK_PRESENTATION_CONFIG_SCHEMA.parse(config).scope,
+        scopePath,
+      }),
+    }),
+    icon: "webhook",
+    name: "Mailhook",
+    type: "mailhook.email.received",
+  },
+  dashboardRun: {
+    getDetails: ({ config }) => [
+      {
+        label: "Run form",
+        value: DASHBOARD_RUN_CONFIG_SCHEMA.parse(config).title,
+      },
+    ],
+    icon: "automation",
+    name: "Dashboard run",
+    type: "dashboard.run",
+  },
 } as const satisfies Record<string, TriggerDefinition>
 
+interface DashboardRunFieldBase {
+  /** Supporting text shown below the field. */
+  description?: string
+
+  /** Visible field label. */
+  label: string
+
+  /** Whether the form must contain a value. Defaults to true. */
+  required?: boolean
+}
+
+export type DashboardRunField =
+  | (DashboardRunFieldBase & {
+      maxLength?: number
+      minLength?: number
+      placeholder?: string
+      type: "email" | "text" | "textarea" | "url"
+    })
+  | (DashboardRunFieldBase & {
+      max?: number
+      min?: number
+      placeholder?: string
+
+      /** Increment used by the number input. Defaults to 1. */
+      step?: number
+      type: "number"
+    })
+  | (DashboardRunFieldBase & {
+      options: readonly { label: string; value: string }[]
+      placeholder?: string
+      type: "select"
+    })
+  | (DashboardRunFieldBase & {
+      type: "checkbox"
+    })
+
+export interface DashboardRunConfig<
+  TFields extends Record<string, DashboardRunField> = Record<
+    string,
+    DashboardRunField
+  >,
+> {
+  /** Supporting text shown below the form title. */
+  description?: string
+
+  /** Named fields rendered in declaration order. */
+  fields: TFields
+
+  /** Submit button text. Defaults to "Run". */
+  submitLabel?: string
+
+  /** Form heading. */
+  title: string
+}
+
+export interface DashboardRunEndpointOptions {
+  appOrigin: string
+  automationId: string
+  hookSlot: number
+  scopePath?: readonly number[]
+}
+
 export type HttpTriggerScope = "trigger" | "automation" | "project"
+export type MailhookScope = HttpTriggerScope
+
+export const PLATFORM_EMAIL_DOMAIN = "automations.automate.ax"
 
 export interface HttpTriggerEndpointOptions {
   appOrigin: string
@@ -73,6 +232,15 @@ export interface HttpTriggerEndpointOptions {
   scopePath?: readonly number[]
 }
 
+export interface MailhookAddressOptions {
+  automationId: string
+  hookSlot: number
+  plusPath?: string
+  projectId: string
+  scope: MailhookScope
+  scopePath?: readonly number[]
+}
+
 /**
  * Returns the public URL for one deployed HTTP trigger.
  *
@@ -100,3 +268,75 @@ export function getHttpTriggerEndpointKey(
     options.hookSlot,
   ].join(".")}`
 }
+
+/**
+ * Returns the unique inbound address for one deployed mailhook.
+ *
+ * Add `+suffix` before the `@` to carry a routing value into the event.
+ *
+ * @param options - Mailhook identity and sharing scope.
+ * @throws When the generated local part exceeds the email size limit.
+ */
+export function getMailhookAddress(options: MailhookAddressOptions) {
+  const localPart = `${getMailhookAddressKey(options)}${options.plusPath ? `+${options.plusPath}` : ""}`
+  if (new TextEncoder().encode(localPart).length > MAX_EMAIL_LOCAL_PART_BYTES) {
+    throw new RangeError("Mailhook address local part exceeds 64 bytes.")
+  }
+
+  return EMAIL_SCHEMA.parse(`${localPart}@${PLATFORM_EMAIL_DOMAIN}`)
+}
+
+/**
+ * Returns the local-part router key for one configured mailhook scope.
+ *
+ * @param options - Mailhook identity and sharing scope.
+ */
+export function getMailhookAddressKey(options: MailhookAddressOptions) {
+  if (options.scope === "project") return `p${typeIdSuffix(options.projectId)}`
+  if (options.scope === "automation") {
+    return `a${typeIdSuffix(options.automationId)}`
+  }
+
+  return `a${typeIdSuffix(options.automationId)}.${[
+    ...(options.scopePath ?? []),
+    options.hookSlot,
+  ]
+    .map((segment) => segment.toString(36))
+    .join(".")}`
+}
+
+/**
+ * Returns the organization-authenticated submission endpoint for one dashboard
+ * run.
+ *
+ * @param options - Public origin and trigger identity.
+ */
+export function getDashboardRunEndpoint(options: DashboardRunEndpointOptions) {
+  return new URL(
+    `/api/dashboard-runs/${getDashboardRunEndpointKey(options)}`,
+    options.appOrigin,
+  ).toString()
+}
+
+/**
+ * Returns the durable endpoint identity for one dashboard run trigger.
+ *
+ * @param options - Trigger and owning automation identity.
+ */
+export function getDashboardRunEndpointKey(
+  options: Omit<DashboardRunEndpointOptions, "appOrigin">,
+) {
+  return `${options.automationId}:${[
+    ...(options.scopePath ?? []),
+    options.hookSlot,
+  ].join(".")}`
+}
+
+/**
+ * Removes the redundant TypeID prefix from an address router.
+ *
+ * @param id - Project or automation TypeID.
+ */
+function typeIdSuffix(id: string) {
+  return id.includes("_") ? id.slice(id.indexOf("_") + 1) : id
+}

package/src/triggers/index.ts

@@ -20,10 +20,21 @@ import type {
 } from "../types"
 
 export {
+  getDashboardRunEndpoint,
+  getDashboardRunEndpointKey,
   getHttpTriggerEndpoint,
   getHttpTriggerEndpointKey,
+  getMailhookAddress,
+  getMailhookAddressKey,
+  PLATFORM_EMAIL_DOMAIN,
+  DASHBOARD_RUN_CONFIG_SCHEMA,
+  type DashboardRunConfig,
+  type DashboardRunEndpointOptions,
+  type DashboardRunField,
   type HttpTriggerEndpointOptions,
   type HttpTriggerScope,
+  type MailhookAddressOptions,
+  type MailhookScope,
 } from "./core"
 
 /** Plain shared definitions for every public trigger type. */