@automate.ax/catalog 0.56.0 → 0.57.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, scope, type IntegrationAccountConnectionOption, type IntegrationAccountRequirement, type IntegrationConnectionDefinition, type IntegrationFormField, type IntegrationScopeRequirement, type IntegrationServiceDefinition, type ScopeRequirementGroup, type TriggerDefinition, type TriggerPresentation, type TriggerPresentationContext, type TriggerPresentationDetail, } from "./types.js";
-export { getHttpTriggerEndpoint, getHttpTriggerEndpointKey, getTriggerDefinition, getTriggerName, getTriggerPresentation, triggerCatalog, triggerDefinitions, type HttpTriggerEndpointOptions, type HttpTriggerScope, type TriggerType, } from "./triggers/index.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";

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, scope, } from "./types.js";
-export { getHttpTriggerEndpoint, getHttpTriggerEndpointKey, getTriggerDefinition, getTriggerName, getTriggerPresentation, triggerCatalog, triggerDefinitions, } from "./triggers/index.js";
+export { defineIntegrationCatalog, defineIntegrationService, integrationScope, } from "./types.js";
+export { getHttpTriggerEndpoint, getHttpTriggerEndpointKey, getTriggerDefinition, getTriggerName, getTriggerPresentation, isTriggerVisible, triggerCatalog, triggerDefinitions, } from "./triggers/index.js";

package/dist/triggers/core.d.ts

@@ -18,11 +18,10 @@ export declare const coreTriggerDefinitions: {
         readonly type: "cron.tick";
     };
     readonly httpRequest: {
-        readonly getDetails: ({ appOrigin, automationId, config, hookSlot, projectId }: import("..").TriggerPresentationContext) => {
+        readonly getPrimary: ({ appOrigin, automationId, config, hookSlot, projectId, scopePath, }: import("..").TriggerPresentationContext) => {
             copyable: true;
-            label: string;
             value: string;
-        }[];
+        };
         readonly icon: "webhook";
         readonly name: "HTTP request";
         readonly type: "http.request";
@@ -35,6 +34,7 @@ export interface HttpTriggerEndpointOptions {
     hookSlot: number;
     projectId: string;
     scope: HttpTriggerScope;
+    scopePath?: readonly number[];
 }
 /**
  * Returns the public URL for one deployed HTTP trigger.

package/dist/triggers/core.js

@@ -34,19 +34,17 @@ export const coreTriggerDefinitions = {
         type: "cron.tick",
     },
     httpRequest: {
-        getDetails: ({ appOrigin, automationId, config, hookSlot, projectId }) => [
-            {
-                copyable: true,
-                label: "URL",
-                value: getHttpTriggerEndpoint({
-                    appOrigin,
-                    automationId,
-                    hookSlot,
-                    projectId,
-                    scope: HTTP_PRESENTATION_CONFIG_SCHEMA.parse(config).scope,
-                }),
-            },
-        ],
+        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",
@@ -70,5 +68,8 @@ export function getHttpTriggerEndpointKey(options) {
         return options.projectId;
     if (options.scope === "automation")
         return options.automationId;
-    return `${options.automationId}:${options.hookSlot}`;
+    return `${options.automationId}:${[
+        ...(options.scopePath ?? []),
+        options.hookSlot,
+    ].join(".")}`;
 }

package/dist/triggers/google.d.ts

@@ -9,6 +9,7 @@ export declare const googleTriggerDefinitions: {
             }];
             readonly serviceId: "google";
         };
+        readonly icon: "gmail";
         readonly type: "gmail.label.added";
     };
     readonly gmailLabelRemoved: {
@@ -21,6 +22,7 @@ export declare const googleTriggerDefinitions: {
             }];
             readonly serviceId: "google";
         };
+        readonly icon: "gmail";
         readonly type: "gmail.label.removed";
     };
     readonly gmailMessageReceived: {
@@ -33,6 +35,7 @@ export declare const googleTriggerDefinitions: {
             }];
             readonly serviceId: "google";
         };
+        readonly icon: "gmail";
         readonly name: "Gmail email received";
         readonly type: "gmail.message.received";
     };
@@ -46,6 +49,7 @@ export declare const googleTriggerDefinitions: {
             }];
             readonly serviceId: "google";
         };
+        readonly icon: "gmail";
         readonly name: "Gmail email sent";
         readonly type: "gmail.message.sent";
     };
@@ -59,6 +63,7 @@ export declare const googleTriggerDefinitions: {
             }];
             readonly serviceId: "google";
         };
+        readonly icon: "google-calendar";
         readonly name: "Google Calendar event created";
         readonly type: "googleCalendar.event.created";
     };
@@ -72,6 +77,7 @@ export declare const googleTriggerDefinitions: {
             }];
             readonly serviceId: "google";
         };
+        readonly icon: "google-calendar";
         readonly name: "Google Calendar event deleted";
         readonly type: "googleCalendar.event.deleted";
     };
@@ -85,6 +91,7 @@ export declare const googleTriggerDefinitions: {
             }];
             readonly serviceId: "google";
         };
+        readonly icon: "google-calendar";
         readonly name: "Google Calendar event updated";
         readonly type: "googleCalendar.event.updated";
     };
@@ -98,6 +105,7 @@ export declare const googleTriggerDefinitions: {
             }];
             readonly serviceId: "google";
         };
+        readonly icon: "google-forms";
         readonly name: "Google Form changed";
         readonly type: "googleForms.form.changed";
     };
@@ -120,6 +128,7 @@ export declare const googleTriggerDefinitions: {
             }];
             readonly serviceId: "google";
         };
+        readonly icon: "google-forms";
         readonly name: "Google Form response submitted";
         readonly type: "googleForms.response.submitted";
     };

package/dist/triggers/google.js

@@ -99,44 +99,53 @@ const GOOGLE_FORM_RESPONSES_ACCOUNT = {
 export const googleTriggerDefinitions = {
     gmailLabelAdded: {
         account: GMAIL_ACCOUNT,
+        icon: "gmail",
         type: "gmail.label.added",
     },
     gmailLabelRemoved: {
         account: GMAIL_ACCOUNT,
+        icon: "gmail",
         type: "gmail.label.removed",
     },
     gmailMessageReceived: {
         account: GMAIL_ACCOUNT,
+        icon: "gmail",
         name: "Gmail email received",
         type: "gmail.message.received",
     },
     gmailMessageSent: {
         account: GMAIL_ACCOUNT,
+        icon: "gmail",
         name: "Gmail email sent",
         type: "gmail.message.sent",
     },
     googleCalendarEventCreated: {
         account: GOOGLE_CALENDAR_ACCOUNT,
+        icon: "google-calendar",
         name: "Google Calendar event created",
         type: "googleCalendar.event.created",
     },
     googleCalendarEventDeleted: {
         account: GOOGLE_CALENDAR_ACCOUNT,
+        icon: "google-calendar",
         name: "Google Calendar event deleted",
         type: "googleCalendar.event.deleted",
     },
     googleCalendarEventUpdated: {
         account: GOOGLE_CALENDAR_ACCOUNT,
+        icon: "google-calendar",
         name: "Google Calendar event updated",
         type: "googleCalendar.event.updated",
     },
     googleFormsFormChanged: {
         account: GOOGLE_FORMS_ACCOUNT,
+        icon: "google-forms",
         name: "Google Form changed",
         type: "googleForms.form.changed",
     },
     googleFormsResponseSubmitted: {
         account: GOOGLE_FORM_RESPONSES_ACCOUNT,
+        icon: "google-forms",
         name: "Google Form response submitted",
         type: "googleForms.response.submitted",
     },

package/dist/triggers/index.d.ts

@@ -1,4 +1,4 @@
-import type { TriggerDefinition, TriggerPresentation, TriggerPresentationContext } from "../types.js";
+import type { TriggerDefinition, TriggerPresentation, TriggerPresentationContext, TriggerScopePresentation } from "../types.js";
 export { getHttpTriggerEndpoint, getHttpTriggerEndpointKey, type HttpTriggerEndpointOptions, type HttpTriggerScope, } from "./core.js";
 /** Plain shared definitions for every public trigger type. */
 export declare const triggerDefinitions: {
@@ -699,6 +699,7 @@ export declare const triggerDefinitions: {
             }];
             readonly serviceId: "google";
         };
+        readonly icon: "gmail";
         readonly type: "gmail.label.added";
     };
     readonly gmailLabelRemoved: {
@@ -711,6 +712,7 @@ export declare const triggerDefinitions: {
             }];
             readonly serviceId: "google";
         };
+        readonly icon: "gmail";
         readonly type: "gmail.label.removed";
     };
     readonly gmailMessageReceived: {
@@ -723,6 +725,7 @@ export declare const triggerDefinitions: {
             }];
             readonly serviceId: "google";
         };
+        readonly icon: "gmail";
         readonly name: "Gmail email received";
         readonly type: "gmail.message.received";
     };
@@ -736,6 +739,7 @@ export declare const triggerDefinitions: {
             }];
             readonly serviceId: "google";
         };
+        readonly icon: "gmail";
         readonly name: "Gmail email sent";
         readonly type: "gmail.message.sent";
     };
@@ -749,6 +753,7 @@ export declare const triggerDefinitions: {
             }];
             readonly serviceId: "google";
         };
+        readonly icon: "google-calendar";
         readonly name: "Google Calendar event created";
         readonly type: "googleCalendar.event.created";
     };
@@ -762,6 +767,7 @@ export declare const triggerDefinitions: {
             }];
             readonly serviceId: "google";
         };
+        readonly icon: "google-calendar";
         readonly name: "Google Calendar event deleted";
         readonly type: "googleCalendar.event.deleted";
     };
@@ -775,6 +781,7 @@ export declare const triggerDefinitions: {
             }];
             readonly serviceId: "google";
         };
+        readonly icon: "google-calendar";
         readonly name: "Google Calendar event updated";
         readonly type: "googleCalendar.event.updated";
     };
@@ -788,6 +795,7 @@ export declare const triggerDefinitions: {
             }];
             readonly serviceId: "google";
         };
+        readonly icon: "google-forms";
         readonly name: "Google Form changed";
         readonly type: "googleForms.form.changed";
     };
@@ -810,6 +818,7 @@ export declare const triggerDefinitions: {
             }];
             readonly serviceId: "google";
         };
+        readonly icon: "google-forms";
         readonly name: "Google Form response submitted";
         readonly type: "googleForms.response.submitted";
     };
@@ -1058,11 +1067,10 @@ export declare const triggerDefinitions: {
         readonly type: "cron.tick";
     };
     readonly httpRequest: {
-        readonly getDetails: ({ appOrigin, automationId, config, hookSlot, projectId }: TriggerPresentationContext) => {
+        readonly getPrimary: ({ appOrigin, automationId, config, hookSlot, projectId, scopePath, }: TriggerPresentationContext) => {
             copyable: true;
-            label: string;
             value: string;
-        }[];
+        };
         readonly icon: "webhook";
         readonly name: "HTTP request";
         readonly type: "http.request";
@@ -1541,11 +1549,10 @@ export declare const triggerCatalog: ({
     type: "cron.tick";
 } | {
     name: string;
-    getDetails: ({ appOrigin, automationId, config, hookSlot, projectId }: TriggerPresentationContext) => {
+    getPrimary: ({ appOrigin, automationId, config, hookSlot, projectId, scopePath, }: TriggerPresentationContext) => {
         copyable: true;
-        label: string;
         value: string;
-    }[];
+    };
     icon: "webhook";
     type: "http.request";
 } | {
@@ -1784,6 +1791,7 @@ export declare const triggerCatalog: ({
         }];
         readonly serviceId: "google";
     };
+    icon: "gmail";
     type: "gmail.label.added";
 } | {
     name: string;
@@ -1796,6 +1804,7 @@ export declare const triggerCatalog: ({
         }];
         readonly serviceId: "google";
     };
+    icon: "gmail";
     type: "gmail.label.removed";
 } | {
     name: string;
@@ -1808,6 +1817,7 @@ export declare const triggerCatalog: ({
         }];
         readonly serviceId: "google";
     };
+    icon: "gmail";
     type: "gmail.message.received";
 } | {
     name: string;
@@ -1820,6 +1830,7 @@ export declare const triggerCatalog: ({
         }];
         readonly serviceId: "google";
     };
+    icon: "gmail";
     type: "gmail.message.sent";
 } | {
     name: string;
@@ -1832,6 +1843,7 @@ export declare const triggerCatalog: ({
         }];
         readonly serviceId: "google";
     };
+    icon: "google-calendar";
     type: "googleCalendar.event.created";
 } | {
     name: string;
@@ -1844,6 +1856,7 @@ export declare const triggerCatalog: ({
         }];
         readonly serviceId: "google";
     };
+    icon: "google-calendar";
     type: "googleCalendar.event.deleted";
 } | {
     name: string;
@@ -1856,6 +1869,7 @@ export declare const triggerCatalog: ({
         }];
         readonly serviceId: "google";
     };
+    icon: "google-calendar";
     type: "googleCalendar.event.updated";
 } | {
     name: string;
@@ -1868,6 +1882,7 @@ export declare const triggerCatalog: ({
         }];
         readonly serviceId: "google";
     };
+    icon: "google-forms";
     type: "googleForms.form.changed";
 } | {
     name: string;
@@ -1889,6 +1904,7 @@ export declare const triggerCatalog: ({
         }];
         readonly serviceId: "google";
     };
+    icon: "google-forms";
     type: "googleForms.response.submitted";
 } | {
     name: string;
@@ -2596,3 +2612,10 @@ export declare function getTriggerName(type: string): string;
 export declare function getTriggerPresentation(context: TriggerPresentationContext & {
     eventType: string;
 }): TriggerPresentation;
+/**
+ * Returns whether a trigger should be shown outside its enclosing scopes.
+ *
+ * @param scopePath - The trigger's enclosing scope path.
+ * @param scopes - The automation's planned scope presentation.
+ */
+export declare function isTriggerVisible(scopePath: readonly number[], scopes: readonly TriggerScopePresentation[]): boolean;

package/dist/triggers/index.js

@@ -62,12 +62,28 @@ export function getTriggerName(type) {
  */
 export function getTriggerPresentation(context) {
     const definition = getTriggerDefinition(context.eventType);
+    const primary = definition?.getPrimary?.(context) ??
+        (definition?.account && context.accountLabel
+            ? { value: context.accountLabel }
+            : undefined);
     return {
         details: definition?.getDetails?.(context) ?? [],
         name: definition?.name ?? getTriggerName(context.eventType),
+        ...(primary ? { primary } : {}),
         type: context.eventType,
     };
 }
+/**
+ * Returns whether a trigger should be shown outside its enclosing scopes.
+ *
+ * @param scopePath - The trigger's enclosing scope path.
+ * @param scopes - The automation's planned scope presentation.
+ */
+export function isTriggerVisible(scopePath, scopes) {
+    return !scopes.some((scope) => scope.presentation !== "expanded" &&
+        scope.path.length <= scopePath.length &&
+        scope.path.every((segment, index) => scopePath[index] === segment));
+}
 /**
  * Infers presentation copy from a trigger's stable event type.
  *

package/dist/types.d.ts

@@ -50,7 +50,7 @@ export interface ScopeRequirementGroup {
     type: "and" | "or";
 }
 /** Combinators for declaring recursive integration scope requirements. */
-export declare const scope: {
+export declare const integrationScope: {
     /**
      * Requires every scope or nested group.
      *
@@ -80,8 +80,10 @@ export interface IntegrationAccountRequirement<TServiceId extends string = strin
 export interface TriggerDefinition<TType extends string = string, TServiceId extends string = string> {
     account?: IntegrationAccountRequirement<TServiceId>;
     description?: string;
-    /** Adds configuration-specific details to this trigger's presentation. */
+    /** Adds labeled secondary details to this trigger's presentation. */
     getDetails?(context: TriggerPresentationContext): TriggerPresentationDetail[];
+    /** Adds an unlabeled primary value to this trigger's presentation. */
+    getPrimary?(context: TriggerPresentationContext): TriggerPresentationValue;
     /**
      * Overrides the connected service icon.
      *
@@ -99,22 +101,33 @@ export interface TriggerDefinition<TType extends string = string, TServiceId ext
 }
 /** Runtime-neutral context used to describe one configured trigger. */
 export interface TriggerPresentationContext {
+    accountLabel?: string;
     appOrigin: string;
     automationId: string;
     config: unknown;
     hookSlot: number;
     projectId: string;
+    scopePath?: readonly number[];
 }
-/** One user-facing property of a configured trigger. */
-export interface TriggerPresentationDetail {
+/** Presentation metadata for one nested automation scope. */
+export interface TriggerScopePresentation {
+    path: readonly number[];
+    presentation: "collapsed" | "expanded" | "hidden";
+}
+/** One user-facing value in a configured trigger's presentation. */
+export interface TriggerPresentationValue {
     copyable?: boolean;
-    label: string;
     value: string;
 }
+/** One labeled secondary property of a configured trigger. */
+export interface TriggerPresentationDetail extends TriggerPresentationValue {
+    label: string;
+}
 /** Client-safe presentation of one configured trigger. */
 export interface TriggerPresentation {
     details: TriggerPresentationDetail[];
     name: string;
+    primary?: TriggerPresentationValue;
     type: string;
 }
 /**

package/dist/types.js

@@ -1,5 +1,5 @@
 /** Combinators for declaring recursive integration scope requirements. */
-export const scope = {
+export const integrationScope = {
     /**
      * Requires every scope or nested group.
      *

package/package.json

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

package/src/index.ts

@@ -41,7 +41,7 @@ export {
 export {
   defineIntegrationCatalog,
   defineIntegrationService,
-  scope,
+  integrationScope,
   type IntegrationAccountConnectionOption,
   type IntegrationAccountRequirement,
   type IntegrationConnectionDefinition,
@@ -53,6 +53,8 @@ export {
   type TriggerPresentation,
   type TriggerPresentationContext,
   type TriggerPresentationDetail,
+  type TriggerScopePresentation,
+  type TriggerPresentationValue,
 } from "./types"
 export {
   getHttpTriggerEndpoint,
@@ -60,6 +62,7 @@ export {
   getTriggerDefinition,
   getTriggerName,
   getTriggerPresentation,
+  isTriggerVisible,
   triggerCatalog,
   triggerDefinitions,
   type HttpTriggerEndpointOptions,

package/src/triggers/core.ts

@@ -38,19 +38,24 @@ export const coreTriggerDefinitions = {
     type: "cron.tick",
   },
   httpRequest: {
-    getDetails: ({ appOrigin, automationId, config, hookSlot, projectId }) => [
-      {
-        copyable: true,
-        label: "URL",
-        value: getHttpTriggerEndpoint({
-          appOrigin,
-          automationId,
-          hookSlot,
-          projectId,
-          scope: HTTP_PRESENTATION_CONFIG_SCHEMA.parse(config).scope,
-        }),
-      },
-    ],
+    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",
@@ -65,6 +70,7 @@ export interface HttpTriggerEndpointOptions {
   hookSlot: number
   projectId: string
   scope: HttpTriggerScope
+  scopePath?: readonly number[]
 }
 
 /**
@@ -89,5 +95,8 @@ export function getHttpTriggerEndpointKey(
 ) {
   if (options.scope === "project") return options.projectId
   if (options.scope === "automation") return options.automationId
-  return `${options.automationId}:${options.hookSlot}`
+  return `${options.automationId}:${[
+    ...(options.scopePath ?? []),
+    options.hookSlot,
+  ].join(".")}`
 }

package/src/triggers/google.ts

@@ -105,44 +105,53 @@ const GOOGLE_FORM_RESPONSES_ACCOUNT = {
 export const googleTriggerDefinitions = {
   gmailLabelAdded: {
     account: GMAIL_ACCOUNT,
+    icon: "gmail",
     type: "gmail.label.added",
   },
   gmailLabelRemoved: {
     account: GMAIL_ACCOUNT,
+    icon: "gmail",
     type: "gmail.label.removed",
   },
   gmailMessageReceived: {
     account: GMAIL_ACCOUNT,
+    icon: "gmail",
     name: "Gmail email received",
     type: "gmail.message.received",
   },
   gmailMessageSent: {
     account: GMAIL_ACCOUNT,
+    icon: "gmail",
     name: "Gmail email sent",
     type: "gmail.message.sent",
   },
   googleCalendarEventCreated: {
     account: GOOGLE_CALENDAR_ACCOUNT,
+    icon: "google-calendar",
     name: "Google Calendar event created",
     type: "googleCalendar.event.created",
   },
   googleCalendarEventDeleted: {
     account: GOOGLE_CALENDAR_ACCOUNT,
+    icon: "google-calendar",
     name: "Google Calendar event deleted",
     type: "googleCalendar.event.deleted",
   },
   googleCalendarEventUpdated: {
     account: GOOGLE_CALENDAR_ACCOUNT,
+    icon: "google-calendar",
     name: "Google Calendar event updated",
     type: "googleCalendar.event.updated",
   },
   googleFormsFormChanged: {
     account: GOOGLE_FORMS_ACCOUNT,
+    icon: "google-forms",
     name: "Google Form changed",
     type: "googleForms.form.changed",
   },
   googleFormsResponseSubmitted: {
     account: GOOGLE_FORM_RESPONSES_ACCOUNT,
+    icon: "google-forms",
     name: "Google Form response submitted",
     type: "googleForms.response.submitted",
   },

package/src/triggers/index.ts

@@ -16,6 +16,7 @@ import type {
   TriggerDefinition,
   TriggerPresentation,
   TriggerPresentationContext,
+  TriggerScopePresentation,
 } from "../types"
 
 export {
@@ -87,14 +88,38 @@ export function getTriggerPresentation(
   context: TriggerPresentationContext & { eventType: string },
 ): TriggerPresentation {
   const definition = getTriggerDefinition(context.eventType)
+  const primary =
+    definition?.getPrimary?.(context) ??
+    (definition?.account && context.accountLabel
+      ? { value: context.accountLabel }
+      : undefined)
 
   return {
     details: definition?.getDetails?.(context) ?? [],
     name: definition?.name ?? getTriggerName(context.eventType),
+    ...(primary ? { primary } : {}),
     type: context.eventType,
   }
 }
 
+/**
+ * Returns whether a trigger should be shown outside its enclosing scopes.
+ *
+ * @param scopePath - The trigger's enclosing scope path.
+ * @param scopes - The automation's planned scope presentation.
+ */
+export function isTriggerVisible(
+  scopePath: readonly number[],
+  scopes: readonly TriggerScopePresentation[],
+) {
+  return !scopes.some(
+    (scope) =>
+      scope.presentation !== "expanded" &&
+      scope.path.length <= scopePath.length &&
+      scope.path.every((segment, index) => scopePath[index] === segment),
+  )
+}
+
 /**
  * Infers presentation copy from a trigger's stable event type.
  *

package/src/types.ts

@@ -64,7 +64,7 @@ export interface ScopeRequirementGroup {
 }
 
 /** Combinators for declaring recursive integration scope requirements. */
-export const scope = {
+export const integrationScope = {
   /**
    * Requires every scope or nested group.
    *
@@ -108,9 +108,12 @@ export interface TriggerDefinition<
   account?: IntegrationAccountRequirement<TServiceId>
   description?: string
 
-  /** Adds configuration-specific details to this trigger's presentation. */
+  /** Adds labeled secondary details to this trigger's presentation. */
   getDetails?(context: TriggerPresentationContext): TriggerPresentationDetail[]
 
+  /** Adds an unlabeled primary value to this trigger's presentation. */
+  getPrimary?(context: TriggerPresentationContext): TriggerPresentationValue
+
   /**
    * Overrides the connected service icon.
    *
@@ -130,24 +133,37 @@ export interface TriggerDefinition<
 
 /** Runtime-neutral context used to describe one configured trigger. */
 export interface TriggerPresentationContext {
+  accountLabel?: string
   appOrigin: string
   automationId: string
   config: unknown
   hookSlot: number
   projectId: string
+  scopePath?: readonly number[]
+}
+
+/** Presentation metadata for one nested automation scope. */
+export interface TriggerScopePresentation {
+  path: readonly number[]
+  presentation: "collapsed" | "expanded" | "hidden"
 }
 
-/** One user-facing property of a configured trigger. */
-export interface TriggerPresentationDetail {
+/** One user-facing value in a configured trigger's presentation. */
+export interface TriggerPresentationValue {
   copyable?: boolean
-  label: string
   value: string
 }
 
+/** One labeled secondary property of a configured trigger. */
+export interface TriggerPresentationDetail extends TriggerPresentationValue {
+  label: string
+}
+
 /** Client-safe presentation of one configured trigger. */
 export interface TriggerPresentation {
   details: TriggerPresentationDetail[]
   name: string
+  primary?: TriggerPresentationValue
   type: string
 }