@automate.ax/catalog 0.75.0 → 0.77.0

package/src/catalog.ts

@@ -9,7 +9,7 @@ const API_KEY_FIELD = {
 } as const
 
 export const airtableService = defineIntegrationService({
-  connectionMethods: [{ id: "default", name: "OAuth", type: "redirect" }],
+  connectionMethods: [{ id: "oauth", name: "OAuth", type: "redirect" }],
   description: "Connect an Airtable account.",
   id: "airtable",
   name: "Airtable",
@@ -39,7 +39,7 @@ export const apolloService = defineIntegrationService({
 })
 
 export const asanaService = defineIntegrationService({
-  connectionMethods: [{ id: "default", name: "OAuth", type: "redirect" }],
+  connectionMethods: [{ id: "oauth", name: "OAuth", type: "redirect" }],
   description: "Connect an Asana account.",
   id: "asana",
   name: "Asana",
@@ -82,6 +82,52 @@ export const cloudflareService = defineIntegrationService({
   preferredConnectionMethodId: "oauth",
 })
 
+export const chatgptService = defineIntegrationService({
+  connectionMethods: [
+    {
+      fields: [
+        {
+          input: "password",
+          label: "Workspace Agent access token",
+          name: "apiKey",
+          placeholder: "Paste your ChatGPT access token",
+          required: true,
+        },
+      ],
+      id: "access-token",
+      name: "Access token",
+      type: "form",
+    },
+  ],
+  description: "Connect a Workspace Agent access token.",
+  icon: "openai",
+  id: "chatgpt",
+  name: "ChatGPT",
+})
+
+export const codexService = defineIntegrationService({
+  connectionMethods: [
+    {
+      fields: [
+        {
+          input: "password",
+          label: "Codex access token",
+          name: "apiKey",
+          placeholder: "Paste your Codex access token",
+          required: true,
+        },
+      ],
+      id: "access-token",
+      name: "Access token",
+      type: "form",
+    },
+  ],
+  description: "Connect a Codex workspace access token.",
+  icon: "openai",
+  id: "codex",
+  name: "Codex",
+})
+
 export const cohereService = defineApiKeyService({
   description: "Connect a Cohere API key.",
   id: "cohere",
@@ -114,14 +160,16 @@ export const fireworksService = defineApiKeyService({
 })
 
 export const githubService = defineIntegrationService({
-  connectionMethods: [{ id: "default", name: "GitHub App", type: "redirect" }],
+  connectionMethods: [
+    { id: "github-app", name: "GitHub App", type: "redirect" },
+  ],
   description: "Install Automate.ax on a GitHub account or organization.",
   id: "github",
   name: "GitHub",
 })
 
 export const googleService = defineIntegrationService({
-  connectionMethods: [{ id: "default", name: "OAuth", type: "redirect" }],
+  connectionMethods: [{ id: "oauth", name: "OAuth", type: "redirect" }],
   connectionNotice: {
     action: {
       href: "mailto:hello@automate.ax?subject=Google%20integration%20access",
@@ -149,22 +197,35 @@ export const groqService = defineApiKeyService({
   name: "Groq",
 })
 
-export const huggingfaceService = defineApiKeyService({
+export const huggingfaceService = defineIntegrationService({
+  connectionMethods: [
+    {
+      fields: [
+        {
+          ...API_KEY_FIELD,
+          label: "Access token",
+          placeholder: "hf_...",
+        },
+      ],
+      id: "access-token",
+      name: "Access token",
+      type: "form",
+    },
+  ],
   description: "Connect a Hugging Face access token.",
   id: "huggingface",
   name: "Hugging Face",
-  placeholder: "hf_...",
 })
 
 export const linearService = defineIntegrationService({
-  connectionMethods: [{ id: "default", name: "OAuth", type: "redirect" }],
+  connectionMethods: [{ id: "oauth", name: "OAuth", type: "redirect" }],
   description: "Connect a Linear workspace.",
   id: "linear",
   name: "Linear",
 })
 
 export const microsoftService = defineIntegrationService({
-  connectionMethods: [{ id: "default", name: "OAuth", type: "redirect" }],
+  connectionMethods: [{ id: "oauth", name: "OAuth", type: "redirect" }],
   description: "Connect a Microsoft account.",
   id: "microsoft",
   name: "Microsoft",
@@ -217,7 +278,7 @@ export const postgresService = defineIntegrationService({
           required: true,
         },
       ],
-      id: "default",
+      id: "credentials",
       name: "Credentials",
       type: "form",
     },
@@ -251,14 +312,14 @@ export const scrapflyService = defineApiKeyService({
 })
 
 export const slackService = defineIntegrationService({
-  connectionMethods: [{ id: "default", name: "OAuth", type: "redirect" }],
+  connectionMethods: [{ id: "oauth", name: "OAuth", type: "redirect" }],
   description: "Install the Automate.ax bot in a Slack workspace.",
   id: "slack",
   name: "Slack",
 })
 
 export const tidycalService = defineIntegrationService({
-  connectionMethods: [{ id: "default", name: "OAuth", type: "redirect" }],
+  connectionMethods: [{ id: "oauth", name: "OAuth", type: "redirect" }],
   description: "Connect a TidyCal account.",
   id: "tidycal",
   name: "TidyCal",
@@ -271,7 +332,7 @@ export const togetheraiService = defineApiKeyService({
 })
 
 export const trelloService = defineIntegrationService({
-  connectionMethods: [{ id: "default", name: "OAuth", type: "redirect" }],
+  connectionMethods: [{ id: "oauth", name: "OAuth", type: "redirect" }],
   description: "Connect a Trello account.",
   id: "trello",
   name: "Trello",
@@ -331,7 +392,9 @@ export const integrationCatalog = defineIntegrationCatalog([
   asanaService,
   brevoService,
   cerebrasService,
+  chatgptService,
   cloudflareService,
+  codexService,
   cohereService,
   deepinfraService,
   deepseekService,
@@ -399,7 +462,7 @@ function defineApiKeyService<const TId extends string>(
             placeholder: service.placeholder ?? "API key",
           },
         ],
-        id: "default",
+        id: "api-key",
         name: "API key",
         type: "form",
       },

package/src/index.ts

@@ -5,7 +5,9 @@ export {
   asanaService,
   brevoService,
   cerebrasService,
+  chatgptService,
   cloudflareService,
+  codexService,
   cohereService,
   deepinfraService,
   deepseekService,

package/src/triggers/airtable.ts

@@ -1,4 +1,3 @@
-import { airtableService } from "../catalog"
 import type { IntegrationAccountRequirement, TriggerDefinition } from "../types"
 
 const AIRTABLE_ACCOUNT = {
@@ -12,7 +11,7 @@ const AIRTABLE_ACCOUNT = {
       ],
     },
   ],
-  serviceId: airtableService.id,
+  serviceId: "airtable",
 } as const satisfies IntegrationAccountRequirement
 
 export const airtableTriggerDefinitions = {

package/src/triggers/asana.ts

@@ -1,4 +1,3 @@
-import { asanaService } from "../catalog"
 import type { IntegrationAccountRequirement, TriggerDefinition } from "../types"
 
 const ASANA_ACCOUNT = {
@@ -7,7 +6,7 @@ const ASANA_ACCOUNT = {
       requiredScopes: [],
     },
   ],
-  serviceId: asanaService.id,
+  serviceId: "asana",
 } as const satisfies IntegrationAccountRequirement
 
 export const asanaTriggerDefinitions = {

package/src/triggers/brevo.ts

@@ -1,4 +1,3 @@
-import { brevoService } from "../catalog"
 import type { IntegrationAccountRequirement, TriggerDefinition } from "../types"
 
 const BREVO_ACCOUNT = {
@@ -7,7 +6,7 @@ const BREVO_ACCOUNT = {
       requiredScopes: [],
     },
   ],
-  serviceId: brevoService.id,
+  serviceId: "brevo",
 } as const satisfies IntegrationAccountRequirement
 
 export const brevoTriggerDefinitions = {

package/src/triggers/core-dashboard.ts

@@ -0,0 +1,361 @@
+import type { TriggerDefinition } from "../types"
+import { sentenceCase } from "./name"
+import * as z from "zod/mini"
+
+const EMAIL_SCHEMA = z.email()
+const URL_SCHEMA = z.url()
+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: z.optional(FIELD_LABEL_SCHEMA),
+  name: FIELD_NAME_SCHEMA,
+}
+const DASHBOARD_RUN_TEXT_FIELD_SCHEMA = z.object({
+  ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+  defaultValue: z.optional(z.string()),
+  maxLength: z.optional(FIELD_LENGTH_SCHEMA),
+  minLength: z.optional(FIELD_LENGTH_SCHEMA),
+  placeholder: z.optional(z.string()),
+  required: z.prefault(z.boolean(), true),
+  type: z.enum(["email", "phone", "text", "textarea", "url"]),
+})
+const DASHBOARD_RUN_NUMBER_FIELD_SCHEMA = z.object({
+  ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+  defaultValue: z.optional(z.number()),
+  max: z.optional(z.number()),
+  min: z.optional(z.number()),
+  placeholder: z.optional(z.string()),
+  required: z.prefault(z.boolean(), true),
+  step: z.prefault(z.number().check(z.positive()), 1),
+  type: z.literal("number"),
+})
+const DASHBOARD_RUN_DATE_FIELD_SCHEMA = z.object({
+  ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+  defaultValue: z.optional(z.iso.date()),
+  max: z.optional(z.iso.date()),
+  min: z.optional(z.iso.date()),
+  required: z.prefault(z.boolean(), true),
+  step: z.prefault(z.int().check(z.positive()), 1),
+  type: z.literal("date"),
+})
+const DASHBOARD_RUN_DATETIME_FIELD_SCHEMA = z.object({
+  ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+  defaultValue: z.optional(z.iso.datetime({ local: true })),
+  max: z.optional(z.iso.datetime({ local: true })),
+  min: z.optional(z.iso.datetime({ local: true })),
+  required: z.prefault(z.boolean(), true),
+  step: z.prefault(z.number().check(z.positive()), 60),
+  type: z.literal("datetime"),
+})
+const DASHBOARD_RUN_CHOICE_FIELD_SCHEMA = {
+  ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+  defaultValue: z.optional(FIELD_NAME_SCHEMA),
+  options: z
+    .array(
+      z.object({
+        label: FIELD_LABEL_SCHEMA,
+        value: FIELD_NAME_SCHEMA,
+      }),
+    )
+    .check(z.minLength(1)),
+  placeholder: z.optional(z.string()),
+  required: z.prefault(z.boolean(), true),
+}
+const DASHBOARD_RUN_SELECT_FIELD_SCHEMA = z.object({
+  ...DASHBOARD_RUN_CHOICE_FIELD_SCHEMA,
+  type: z.literal("select"),
+})
+const DASHBOARD_RUN_RADIO_FIELD_SCHEMA = z.object({
+  ...DASHBOARD_RUN_CHOICE_FIELD_SCHEMA,
+  type: z.literal("radio"),
+})
+const DASHBOARD_RUN_MULTI_SELECT_FIELD_SCHEMA = z.object({
+  ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+  defaultValue: z.optional(z.array(FIELD_NAME_SCHEMA)),
+  options: z
+    .array(
+      z.object({
+        label: FIELD_LABEL_SCHEMA,
+        value: FIELD_NAME_SCHEMA,
+      }),
+    )
+    .check(z.minLength(1)),
+  placeholder: z.optional(z.string()),
+  required: z.prefault(z.boolean(), true),
+  type: z.literal("multi-select"),
+})
+const DASHBOARD_RUN_CHECKBOX_FIELD_SCHEMA = z.object({
+  ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+  defaultValue: z.prefault(z.boolean(), false),
+  required: z.prefault(z.boolean(), false),
+  type: z.literal("checkbox"),
+})
+const DASHBOARD_RUN_FIELD_SCHEMA = z.pipe(
+  z.discriminatedUnion("type", [
+    DASHBOARD_RUN_TEXT_FIELD_SCHEMA,
+    DASHBOARD_RUN_NUMBER_FIELD_SCHEMA,
+    DASHBOARD_RUN_DATE_FIELD_SCHEMA,
+    DASHBOARD_RUN_DATETIME_FIELD_SCHEMA,
+    DASHBOARD_RUN_SELECT_FIELD_SCHEMA,
+    DASHBOARD_RUN_RADIO_FIELD_SCHEMA,
+    DASHBOARD_RUN_MULTI_SELECT_FIELD_SCHEMA,
+    DASHBOARD_RUN_CHECKBOX_FIELD_SCHEMA,
+  ]),
+  z.transform((field) => ({
+    ...field,
+    label:
+      field.label ??
+      `${sentenceCase(field.name)}${field.type === "checkbox" ? "?" : ""}`,
+  })),
+)
+const DASHBOARD_RUN_FIELDS_SCHEMA = z.array(DASHBOARD_RUN_FIELD_SCHEMA).check(
+  z.refine(
+    (fields) =>
+      new Set(fields.map((field) => field.name)).size === fields.length,
+    "Dashboard run field names must be unique.",
+  ),
+  z.refine(
+    (fields) => fields.every(isDashboardRunFieldDefaultValid),
+    "Dashboard run field defaults must satisfy their field constraints.",
+  ),
+)
+
+export const DASHBOARD_RUN_CONFIG_SCHEMA = z.object({
+  description: z.optional(FIELD_DESCRIPTION_SCHEMA),
+  fields: z.prefault(DASHBOARD_RUN_FIELDS_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 dashboardRunTriggerDefinition = {
+  getDetails: ({ config }) => [
+    {
+      label: "Run form",
+      value: DASHBOARD_RUN_CONFIG_SCHEMA.parse(config).title,
+    },
+  ],
+  icon: "automation",
+  name: "Dashboard run",
+  type: "dashboard.run",
+} as const satisfies TriggerDefinition
+
+interface DashboardRunFieldBase {
+  /** Supporting text shown below the field. */
+  description?: string
+
+  /** Visible field label. Inferred from `name` when omitted. */
+  label?: string
+
+  /** Property name used in submitted trigger data. */
+  name: string
+
+  /** Whether the form must contain a value. Defaults to true. */
+  required?: boolean
+}
+
+export type DashboardRunField =
+  | (DashboardRunFieldBase & {
+      defaultValue?: string
+      maxLength?: number
+      minLength?: number
+      placeholder?: string
+      type: "email" | "phone" | "text" | "textarea" | "url"
+    })
+  | (DashboardRunFieldBase & {
+      defaultValue?: number
+      max?: number
+      min?: number
+      placeholder?: string
+
+      /** Increment used by the number input. Defaults to 1. */
+      step?: number
+      type: "number"
+    })
+  | (DashboardRunFieldBase & {
+      /** Initial local date in `YYYY-MM-DD` format. */
+      defaultValue?: string
+      max?: string
+      min?: string
+
+      /** Allowed increment in days. Defaults to 1. */
+      step?: number
+      type: "date"
+    })
+  | (DashboardRunFieldBase & {
+      /** Initial local date and time in `YYYY-MM-DDTHH:mm` format. */
+      defaultValue?: string
+      max?: string
+      min?: string
+
+      /** Allowed increment in seconds. Defaults to 60. */
+      step?: number
+      type: "datetime"
+    })
+  | (DashboardRunFieldBase & {
+      defaultValue?: string
+      options: readonly { label: string; value: string }[]
+      placeholder?: string
+      type: "select"
+    })
+  | (DashboardRunFieldBase & {
+      defaultValue?: string
+      options: readonly { label: string; value: string }[]
+      type: "radio"
+    })
+  | (DashboardRunFieldBase & {
+      defaultValue?: readonly string[]
+      options: readonly { label: string; value: string }[]
+      placeholder?: string
+      type: "multi-select"
+    })
+  | (DashboardRunFieldBase & {
+      /** Initial checked state. Defaults to false. */
+      defaultValue?: boolean
+
+      /** Whether the checkbox must be checked. Defaults to false. */
+      required?: boolean
+      type: "checkbox"
+    })
+
+export interface DashboardRunConfig<
+  TFields extends readonly DashboardRunField[] = readonly DashboardRunField[],
+> {
+  /** Supporting text shown below the form title. */
+  description?: string
+
+  /** Ordered fields. Omit to run immediately. */
+  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[]
+}
+
+/**
+ * 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(".")}`
+}
+
+/**
+ * Checks a configured default against the same constraints as submitted data.
+ *
+ * @param field - Field definition to validate.
+ */
+function isDashboardRunFieldDefaultValid(field: DashboardRunField) {
+  if (field.type === "checkbox" || field.defaultValue === undefined) return true
+
+  if (field.type === "multi-select") {
+    if (field.required !== false && field.defaultValue.length === 0)
+      return false
+    return field.defaultValue.every((value) =>
+      field.options.some((option) => option.value === value),
+    )
+  }
+
+  if (field.type === "radio" || field.type === "select") {
+    return field.options.some((option) => option.value === field.defaultValue)
+  }
+
+  if (field.type === "number") {
+    return (
+      (field.min === undefined || field.defaultValue >= field.min) &&
+      (field.max === undefined || field.defaultValue <= field.max) &&
+      !isDashboardRunStepMismatch(
+        field.defaultValue,
+        field.min ?? field.defaultValue,
+        field.step ?? 1,
+      )
+    )
+  }
+
+  if (field.type === "date" || field.type === "datetime") {
+    const defaultValue = parseDashboardRunDateValue(
+      field.type,
+      field.defaultValue,
+    )
+    return (
+      (field.min === undefined ||
+        defaultValue >= parseDashboardRunDateValue(field.type, field.min)) &&
+      (field.max === undefined ||
+        defaultValue <= parseDashboardRunDateValue(field.type, field.max)) &&
+      !isDashboardRunStepMismatch(
+        defaultValue,
+        parseDashboardRunDateValue(field.type, field.min ?? field.defaultValue),
+        (field.step ?? (field.type === "date" ? 1 : 60)) *
+          (field.type === "date" ? 86_400_000 : 1_000),
+      )
+    )
+  }
+
+  const defaultValue = field.defaultValue.trim()
+  return (
+    (defaultValue.length > 0 || field.required === false) &&
+    (field.minLength === undefined || defaultValue.length >= field.minLength) &&
+    (field.maxLength === undefined || defaultValue.length <= field.maxLength) &&
+    (field.type !== "email" || EMAIL_SCHEMA.safeParse(defaultValue).success) &&
+    (field.type !== "url" || URL_SCHEMA.safeParse(defaultValue).success)
+  )
+}
+
+/**
+ * Checks whether a value falls outside an allowed step interval.
+ *
+ * @param value - Configured default value.
+ * @param base - Value from which step intervals begin.
+ * @param step - Allowed interval size.
+ */
+function isDashboardRunStepMismatch(value: number, base: number, step: number) {
+  const intervals = (value - base) / step
+  return Math.abs(intervals - Math.round(intervals)) > 1e-9
+}
+
+/**
+ * Converts a validated local date or date-time string to a UTC number.
+ *
+ * @param type - Temporal field type.
+ * @param value - Local ISO value to convert.
+ */
+function parseDashboardRunDateValue(type: "date" | "datetime", value: string) {
+  return Date.parse(type === "date" ? `${value}T00:00:00Z` : `${value}Z`)
+}

package/src/triggers/core-http.ts

@@ -0,0 +1,69 @@
+import type { TriggerDefinition } from "../types"
+import * as z from "zod/mini"
+
+const HTTP_PRESENTATION_CONFIG_SCHEMA = z.object({
+  scope: z.prefault(z.enum(["trigger", "automation", "project"]), "trigger"),
+})
+
+export const httpRequestTriggerDefinition = {
+  getPrimary: ({
+    appOrigin,
+    automationId,
+    config,
+    hookSlot,
+    projectId,
+    scopePath,
+  }) => ({
+    copyable: true,
+    value: getHttpTriggerEndpoint({
+      appOrigin,
+      automationId,
+      hookSlot,
+      projectId,
+      scope: HTTP_PRESENTATION_CONFIG_SCHEMA.parse(config).scope,
+      scopePath,
+    }),
+  }),
+  icon: "webhook",
+  name: "HTTP request",
+  type: "http.request",
+} as const satisfies TriggerDefinition
+
+export type HttpTriggerScope = "trigger" | "automation" | "project"
+
+export interface HttpTriggerEndpointOptions {
+  appOrigin: string
+  automationId: string
+  hookSlot: number
+  projectId: string
+  scope: HttpTriggerScope
+  scopePath?: readonly number[]
+}
+
+/**
+ * Returns the public URL for one deployed HTTP trigger.
+ *
+ * @param options - Public origin and trigger identity.
+ */
+export function getHttpTriggerEndpoint(options: HttpTriggerEndpointOptions) {
+  return new URL(
+    `/x/${getHttpTriggerEndpointKey(options)}/`,
+    options.appOrigin,
+  ).toString()
+}
+
+/**
+ * Returns the durable endpoint identity for one configured HTTP scope.
+ *
+ * @param options - Trigger and owning resource identity.
+ */
+export function getHttpTriggerEndpointKey(
+  options: Omit<HttpTriggerEndpointOptions, "appOrigin">,
+) {
+  if (options.scope === "project") return options.projectId
+  if (options.scope === "automation") return options.automationId
+  return `${options.automationId}:${[
+    ...(options.scopePath ?? []),
+    options.hookSlot,
+  ].join(".")}`
+}

package/src/triggers/core-invocation.ts

@@ -0,0 +1,18 @@
+import type { TriggerDefinition } from "../types"
+import * as z from "zod/mini"
+
+const INVOCATION_PRESENTATION_CONFIG_SCHEMA = z.object({
+  entrypoint: z.string(),
+})
+
+export const automationInvokedTriggerDefinition = {
+  getDetails: ({ config }) => [
+    {
+      label: "Entrypoint",
+      value: INVOCATION_PRESENTATION_CONFIG_SCHEMA.parse(config).entrypoint,
+    },
+  ],
+  icon: "automation",
+  name: "Invocation",
+  type: "automation.invoked",
+} as const satisfies TriggerDefinition