@epilot/sdk 2.20.22 → 2.20.23

package/dist/{automation.d-Bp45eKlU.d.cts → automation.d-2biAmiMc.d.cts}

@@ -557,7 +557,23 @@ declare namespace Components {
          *       ```
          *
          */
-        EntityOperationTrigger | ActivityTrigger | EntityManualTrigger | ReceivedEmailTrigger | NewEmailThreadTrigger | FlowsTrigger;
+        EntityOperationTrigger | ActivityTrigger | EntityManualTrigger | ReceivedEmailTrigger | NewEmailThreadTrigger | FlowsTrigger | /**
+         * Starts the flow when an Event Catalog event is published for the organization. The execution runs in the context of one entity from the event's entity graph (`entity_node_id`), and the event payload is available to conditions and actions as the `event` variable context.
+         *
+         * example:
+         * {
+         *   "id": "12d4f45a-1883-4841-a94c-5928cb338a94",
+         *   "type": "event_catalog",
+         *   "configuration": {
+         *     "event_name": "CustomerRequestSubmitted",
+         *     "event_version": "1.1",
+         *     "entity_node_id": "ticket",
+         *     "entity_schema": "ticket",
+         *     "ignore_automation_triggered": true
+         *   }
+         * }
+         */
+        EventCatalogTrigger;
         export interface AnythingButCondition {
             "anything-but"?: string[];
         }
@@ -912,6 +928,38 @@ declare namespace Components {
                  */
                 values?: string[];
             };
+            /**
+             * Candidate condition for `sequential` and `even_distribution`: when true,
+             * only assign to users whose skills (tags) match a label on the entity
+             * being assigned. Opt-in; defaults to false. An entity carrying no
+             * namespaced label matches nobody, so the fallback applies.
+             *
+             */
+            match_user_skills?: boolean;
+            /**
+             * Candidate condition (with match_user_skills): label families
+             * (taxonomy slugs) that must match. Only categories the entity actually
+             * carries a label in are scored: a user qualifies if it shares a label with
+             * the entity within each of those. A required category the entity has no
+             * label in is a free pass and gates nobody — so when the entity has no label
+             * in any required category, every candidate passes this filter. Note this
+             * is the opposite of an entity carrying no namespaced label at all, which
+             * matches nobody — see `match_user_skills`. Leave empty to match on any
+             * label (flat OR across all categories).
+             *
+             */
+            required_skill_categories?: string[];
+            /**
+             * How strictly required skill categories are matched (applies with
+             * match_user_skills and required skill categories set).
+             * - require_all: hard match (default) — a user must match every required
+             *   category the entity has a label in.
+             * - prefer: soft match — prefer the best-matching users, relaxing to
+             *   fewer categories only when no better match exists; a user matching
+             *   no category is never eligible (the fallback then applies).
+             *
+             */
+            skill_match_mode?: "require_all" | "prefer";
             /**
              * What to do when no assignable principal resolves, e.g. an empty or
              * fully ineligible `candidate_group`.
@@ -1365,7 +1413,11 @@ declare namespace Components {
              * 2
              */
             version?: number;
-            trigger_event?: TriggerEventManual | TriggerEventEntityActivity | TriggerEventEntityOperation | TriggerEventFlowAutomationTask | TriggerEventMessaging;
+            trigger_event?: TriggerEventManual | TriggerEventEntityActivity | TriggerEventEntityOperation | TriggerEventFlowAutomationTask | TriggerEventMessaging | /**
+             * Set on executions started by an Event Catalog event (see EventCatalogTrigger). The full event payload is not stored inline (it may be up to 256 KB) but by reference in `payload_ref`; automation workers hydrate it before every action.
+             *
+             */
+            TriggerEventEventCatalog;
             workflow_context?: WorkflowExecutionContext;
             workflow_wait_context?: /**
              * Correlation stamped when the triggering submission entity carried workflow wait claims from a journey link (AL-2521). Consumed by svc-workflows to resume a task waiting on this journey submission.
@@ -1537,10 +1589,19 @@ declare namespace Components {
              */
             source_path: string;
             /**
-             * How source_path is interpreted. 'journey-multi-select' is the v1 source type (journey card block with multi-select). Future source types (e.g. 'previous-action-outputs', 'entity-relation') will be added here.
+             * How source_path is interpreted. 'journey-multi-select' is the v1 source type (journey card block with multi-select). 'journey-file-upload' iterates the files uploaded in a journey file upload block: source_path points at the submission's `_files.$relation` array, `filter_tags` narrows it down to the block's files and every item is treated as a `file` entity reference. Future source types (e.g. 'previous-action-outputs', 'entity-relation') will be added here.
              *
              */
-            source_type?: "journey-multi-select" | "previous-action-outputs" | "entity-relation";
+            source_type?: "journey-multi-select" | "journey-file-upload" | "previous-action-outputs" | "entity-relation";
+            /**
+             * Only iterate items of the resolved array whose `_tags` contain every listed tag. Meant for relation arrays such as `submission._files.$relation`, where the journey tags each file relation with the upload block it came from.
+             *
+             * example:
+             * [
+             *   "_hidden_ 2a4b1c3d-0000-4000-8000-000000000000 - Dokumente"
+             * ]
+             */
+            filter_tags?: string[];
             /**
              * Maximum number of iterations. 0 / omitted = iterate the full resolved array.
              *
@@ -1959,7 +2020,11 @@ declare namespace Components {
                  */
                 id?: string;
                 origin?: "trigger" | "action";
-                originType?: "entity" | "workflow" | "journey_block";
+                /**
+                 * `event` reads the operand from the trigger's Event Catalog payload instead of an entity: `attribute` is then a dot path into the payload (e.g. `ticket.subject`). Only valid with `origin: trigger` on flows started by an EventCatalogTrigger.
+                 *
+                 */
+                originType?: "entity" | "workflow" | "journey_block" | "event";
                 schema?: string;
                 attribute?: string;
                 attributeType?: "string" | "text" | "number" | "boolean" | "date" | "datetime" | "tags" | "country" | "email" | "phone" | "product" | "price" | "status" | "relation" | "multiselect" | "select" | "radio" | "relation_user" | "purpose" | "label" | "payment" | "relation_payment_method";
@@ -2722,6 +2787,63 @@ declare namespace Components {
                 details?: ErrorDetail[];
             };
         }
+        /**
+         * Starts the flow when an Event Catalog event is published for the organization. The execution runs in the context of one entity from the event's entity graph (`entity_node_id`), and the event payload is available to conditions and actions as the `event` variable context.
+         *
+         * example:
+         * {
+         *   "id": "12d4f45a-1883-4841-a94c-5928cb338a94",
+         *   "type": "event_catalog",
+         *   "configuration": {
+         *     "event_name": "CustomerRequestSubmitted",
+         *     "event_version": "1.1",
+         *     "entity_node_id": "ticket",
+         *     "entity_schema": "ticket",
+         *     "ignore_automation_triggered": true
+         *   }
+         * }
+         */
+        export interface EventCatalogTrigger {
+            /**
+             * example:
+             * 12d4f45a-1883-4841-a94c-5928cb338a94
+             */
+            id?: string; // uuid
+            type: "event_catalog";
+            configuration: {
+                /**
+                 * Name of the Event Catalog event that starts this flow
+                 * example:
+                 * CustomerRequestSubmitted
+                 */
+                event_name: string;
+                /**
+                 * Event version (MAJOR.MINOR) this trigger is pinned to. Payloads published in a newer version are downgraded to this version before the flow runs, so field references in conditions and actions stay stable.
+                 *
+                 * example:
+                 * 1.1
+                 */
+                event_version: string;
+                /**
+                 * Id of the cardinality-one node in the event's entity graph whose entity becomes the execution's main entity (the entity actions operate on).
+                 *
+                 * example:
+                 * ticket
+                 */
+                entity_node_id: string;
+                /**
+                 * Schema of the entity behind `entity_node_id`, denormalized from the event definition at configuration time
+                 * example:
+                 * ticket
+                 */
+                entity_schema: string;
+                /**
+                 * When true (default), events that were emitted by an automation (`_trigger_source_type: automation`) do not start this flow. This prevents automation → event → automation chains unless explicitly enabled.
+                 *
+                 */
+                ignore_automation_triggered?: boolean;
+            };
+        }
         /**
          * Execution item for bulk trigger automation. It maps each entity to its automation execution id & status
          */
@@ -4704,6 +4826,64 @@ declare namespace Components {
             ActivityId;
             operation_type: EntityOperation;
         }
+        /**
+         * Set on executions started by an Event Catalog event (see EventCatalogTrigger). The full event payload is not stored inline (it may be up to 256 KB) but by reference in `payload_ref`; automation workers hydrate it before every action.
+         *
+         */
+        export interface TriggerEventEventCatalog {
+            type: "event_catalog";
+            /**
+             * example:
+             * 123
+             */
+            org_id: string;
+            entity_id: /**
+             * example:
+             * e3d3ebac-baab-4395-abf4-50b5bf1f8b74
+             */
+            EntityId;
+            /**
+             * Node id of the event's entity graph that was resolved to `entity_id`
+             * example:
+             * ticket
+             */
+            entity_node_id: string;
+            /**
+             * Event Catalog event id (ULID) of the published event
+             * example:
+             * 01K3ZK8QZ7Y7Q2M8W1V3N4X5P6
+             */
+            event_id: string;
+            /**
+             * example:
+             * CustomerRequestSubmitted
+             */
+            event_name: string;
+            /**
+             * Version the payload was delivered in (the version pinned on the trigger)
+             * example:
+             * 1.1
+             */
+            event_version: string;
+            /**
+             * Version the event was originally published with, before downgrading to `event_version`
+             * example:
+             * 1.2
+             */
+            published_version?: string;
+            event_time?: string; // date-time
+            /**
+             * How the event was triggered in the catalog (api | automation | operation | portal_user)
+             * example:
+             * operation
+             */
+            trigger_source_type?: string;
+            /**
+             * Opaque source reference from the catalog (e.g. activity id, automation execution id)
+             */
+            trigger_source?: string;
+            payload_ref?: /* S3 reference to the stored trigger event payload (`_downgrades` stripped, downgraded to the pinned version) */ TriggerEventPayloadRef;
+        }
         export interface TriggerEventFlowAutomationTask {
             type?: "flow_automation_task";
             /**
@@ -4757,6 +4937,21 @@ declare namespace Components {
              */
             EntityId;
         }
+        /**
+         * S3 reference to the stored trigger event payload (`_downgrades` stripped, downgraded to the pinned version)
+         */
+        export interface TriggerEventPayloadRef {
+            /**
+             * example:
+             * automation-trigger-payloads-prod
+             */
+            bucket: string;
+            /**
+             * example:
+             * trigger-payloads/123/6c8e5d9a-7f1b-4c2e-9d3a-0b1c2d3e4f5a.json
+             */
+            key: string;
+        }
         export interface TriggerShareEntityAction {
             id?: /**
              * example:
@@ -5717,6 +5912,11 @@ declare namespace Paths {
              * wfABCDEFGH
              */
             export type TargetWorkflow = string;
+            /**
+             * example:
+             * CustomerRequestSubmitted
+             */
+            export type TriggerEventName = string;
             /**
              * example:
              * 600945fe-212e-4b97-acf7-391d64648384
@@ -5741,6 +5941,11 @@ declare namespace Paths {
              * wfABCDEFGH
              */
             Parameters.TargetWorkflow;
+            trigger_event_name?: /**
+             * example:
+             * CustomerRequestSubmitted
+             */
+            Parameters.TriggerEventName;
             include_flows?: Parameters.IncludeFlows;
         }
         namespace Responses {
@@ -6213,6 +6418,7 @@ type ErrorCode = Components.Schemas.ErrorCode;
 type ErrorDetail = Components.Schemas.ErrorDetail;
 type ErrorObject = Components.Schemas.ErrorObject;
 type ErrorOutput = Components.Schemas.ErrorOutput;
+type EventCatalogTrigger = Components.Schemas.EventCatalogTrigger;
 type ExecItem = Components.Schemas.ExecItem;
 type ExecutionChain = Components.Schemas.ExecutionChain;
 type ExecutionStatus = Components.Schemas.ExecutionStatus;
@@ -6284,9 +6490,11 @@ type TriggerEventActionConfig = Components.Schemas.TriggerEventActionConfig;
 type TriggerEventConfig = Components.Schemas.TriggerEventConfig;
 type TriggerEventEntityActivity = Components.Schemas.TriggerEventEntityActivity;
 type TriggerEventEntityOperation = Components.Schemas.TriggerEventEntityOperation;
+type TriggerEventEventCatalog = Components.Schemas.TriggerEventEventCatalog;
 type TriggerEventFlowAutomationTask = Components.Schemas.TriggerEventFlowAutomationTask;
 type TriggerEventManual = Components.Schemas.TriggerEventManual;
 type TriggerEventMessaging = Components.Schemas.TriggerEventMessaging;
+type TriggerEventPayloadRef = Components.Schemas.TriggerEventPayloadRef;
 type TriggerShareEntityAction = Components.Schemas.TriggerShareEntityAction;
 type TriggerShareEntityActionConfig = Components.Schemas.TriggerShareEntityActionConfig;
 type TriggerShareEntityConfig = Components.Schemas.TriggerShareEntityConfig;
@@ -6302,4 +6510,4 @@ type WorkflowContextRole = Components.Schemas.WorkflowContextRole;
 type WorkflowExecutionContext = Components.Schemas.WorkflowExecutionContext;
 type WorkflowWaitContext = Components.Schemas.WorkflowWaitContext;
 
-export { type EntityItemSnapshot as $, type ActionCondition as A, type AutomationFlow as B, type Client as C, type AutomationFlowId as D, type AutomationLoop as E, type AutomationLoopState as F, type AutomationTrigger as G, type BulkTriggerJob as H, type BulkTriggerRequest as I, type CancellationReason as J, type CartCheckoutAction as K, type CartCheckoutActionConfig as L, type CartCheckoutConfig as M, type Comparison as N, type OperationMethods as O, Paths as P, type ConditionStatement as Q, type CopyValueMapper as R, type CreateDocumentAction as S, type CreateDocumentActionConfig as T, type CreateDocumentConfig as U, type CustomAction as V, type DiffAdded as W, type DiffDeleted as X, type DiffUpdated as Y, type EntityAssignee as Z, type EntityId as _, Components as a, type RetryReq as a$, type EntityManualTrigger as a0, type EntityOperation as a1, type EntityOperationTrigger as a2, type EntityRef as a3, type EntitySearchFilter as a4, type EntitySearchFilterValue as a5, type EqualsIgnoreCaseCondition as a6, type ErrorCode as a7, type ErrorDetail as a8, type ErrorObject as a9, type MapEntityAction as aA, type MapEntityActionConfig as aB, type MapEntityConfig as aC, type MappingAttribute as aD, type MappingAttributeMode as aE, type MappingAttributeV2 as aF, type MappingConfigRef as aG, type MoveThreadAction as aH, type MoveThreadConfig as aI, type NewEmailThreadTrigger as aJ, type NumericCondition as aK, type OperationNode as aL, type OperationObjectNode as aM, type OrCondition as aN, type OrConditionForDiff as aO, type OrganizationId as aP, type PatchBulkJobRequest as aQ, type PrefixCondition as aR, type PrimitiveJSONValue as aS, type ReceivedEmailTrigger as aT, type RelationAttribute as aU, type ReplyEmailAction as aV, type ReplyEmailActionConfig as aW, type ReplyEmailConfig as aX, type ResumeReq as aY, type ResumeResp as aZ, type ResumeToken as a_, type ErrorOutput as aa, type ExecItem as ab, type ExecutionChain as ac, type ExecutionStatus as ad, type ExistsCondition as ae, type FilterConditionOnEvent as af, type FlowExecutionCancelAction as ag, type FlowExecutionCancelActionConfig as ah, type FlowExecutionCancelConfig as ai, type FlowsTrigger as aj, type ForwardEmailAction as ak, type ForwardEmailActionConfig as al, type ForwardEmailConfig as am, type FrontendSubmitTrigger as an, type GetExecutionsResp as ao, type GraphContextEntry as ap, type GraphDefinition as aq, type GraphEdge as ar, type GraphNode as as, type GraphNodeFilter as at, type GraphSeed as au, type InformERPAction as av, type InformERPActionConfig as aw, type InformERPConfig as ax, type JobId as ay, type JourneySubmitTrigger as az, type PathsDictionary as b, type RetryStrategy as b0, type SearchAutomationsResp as b1, type SearchExecutionsReq as b2, type SearchExecutionsResp as b3, type SendEmailAction as b4, type SendEmailActionConfig as b5, type SendEmailCondition as b6, type SendEmailConfig as b7, type SetValueMapper as b8, type StartExecutionRequest as b9, type SuffixCondition as ba, type TriggerCondition as bb, type TriggerContext as bc, type TriggerEventAction as bd, type TriggerEventActionConfig as be, type TriggerEventConfig as bf, type TriggerEventEntityActivity as bg, type TriggerEventEntityOperation as bh, type TriggerEventFlowAutomationTask as bi, type TriggerEventManual as bj, type TriggerEventMessaging as bk, type TriggerShareEntityAction as bl, type TriggerShareEntityActionConfig as bm, type TriggerShareEntityConfig as bn, type TriggerWebhookAction as bo, type TriggerWebhookActionConfig as bp, type TriggerWebhookConfig as bq, type TriggerWorkflowAction as br, type TriggerWorkflowActionConfig as bs, type TriggerWorkflowCondition as bt, type TriggerWorkflowConfig as bu, type WildcardCondition as bv, type WorkflowContextRole as bw, type WorkflowExecutionContext as bx, type WorkflowWaitContext as by, type ActionSchedule as c, type ActionScheduleSource as d, type ActivityId as e, type ActivityTrigger as f, type AnyAction as g, type AnyActionConfig as h, type AnyTrigger as i, type AnythingButCondition as j, type ApiCallerContext as k, type ApiSubmissionTrigger as l, type AppendValueMapper as m, type AssignEntityAction as n, type AssignEntityActionConfig as o, type AssignEntityConfig as p, type AssignThreadAction as q, type AssignThreadConfig as r, type AssignUsersToStep as s, type AutomationAction as t, type AutomationActionConfig as u, type AutomationActionExecutionState as v, type AutomationActionId as w, type AutomationActionIteration as x, type AutomationExecution as y, type AutomationExecutionId as z };
+export { type EntityItemSnapshot as $, type ActionCondition as A, type AutomationFlow as B, type Client as C, type AutomationFlowId as D, type AutomationLoop as E, type AutomationLoopState as F, type AutomationTrigger as G, type BulkTriggerJob as H, type BulkTriggerRequest as I, type CancellationReason as J, type CartCheckoutAction as K, type CartCheckoutActionConfig as L, type CartCheckoutConfig as M, type Comparison as N, type OperationMethods as O, Paths as P, type ConditionStatement as Q, type CopyValueMapper as R, type CreateDocumentAction as S, type CreateDocumentActionConfig as T, type CreateDocumentConfig as U, type CustomAction as V, type DiffAdded as W, type DiffDeleted as X, type DiffUpdated as Y, type EntityAssignee as Z, type EntityId as _, Components as a, type ResumeToken as a$, type EntityManualTrigger as a0, type EntityOperation as a1, type EntityOperationTrigger as a2, type EntityRef as a3, type EntitySearchFilter as a4, type EntitySearchFilterValue as a5, type EqualsIgnoreCaseCondition as a6, type ErrorCode as a7, type ErrorDetail as a8, type ErrorObject as a9, type JourneySubmitTrigger as aA, type MapEntityAction as aB, type MapEntityActionConfig as aC, type MapEntityConfig as aD, type MappingAttribute as aE, type MappingAttributeMode as aF, type MappingAttributeV2 as aG, type MappingConfigRef as aH, type MoveThreadAction as aI, type MoveThreadConfig as aJ, type NewEmailThreadTrigger as aK, type NumericCondition as aL, type OperationNode as aM, type OperationObjectNode as aN, type OrCondition as aO, type OrConditionForDiff as aP, type OrganizationId as aQ, type PatchBulkJobRequest as aR, type PrefixCondition as aS, type PrimitiveJSONValue as aT, type ReceivedEmailTrigger as aU, type RelationAttribute as aV, type ReplyEmailAction as aW, type ReplyEmailActionConfig as aX, type ReplyEmailConfig as aY, type ResumeReq as aZ, type ResumeResp as a_, type ErrorOutput as aa, type EventCatalogTrigger as ab, type ExecItem as ac, type ExecutionChain as ad, type ExecutionStatus as ae, type ExistsCondition as af, type FilterConditionOnEvent as ag, type FlowExecutionCancelAction as ah, type FlowExecutionCancelActionConfig as ai, type FlowExecutionCancelConfig as aj, type FlowsTrigger as ak, type ForwardEmailAction as al, type ForwardEmailActionConfig as am, type ForwardEmailConfig as an, type FrontendSubmitTrigger as ao, type GetExecutionsResp as ap, type GraphContextEntry as aq, type GraphDefinition as ar, type GraphEdge as as, type GraphNode as at, type GraphNodeFilter as au, type GraphSeed as av, type InformERPAction as aw, type InformERPActionConfig as ax, type InformERPConfig as ay, type JobId as az, type PathsDictionary as b, type RetryReq as b0, type RetryStrategy as b1, type SearchAutomationsResp as b2, type SearchExecutionsReq as b3, type SearchExecutionsResp as b4, type SendEmailAction as b5, type SendEmailActionConfig as b6, type SendEmailCondition as b7, type SendEmailConfig as b8, type SetValueMapper as b9, type WorkflowExecutionContext as bA, type WorkflowWaitContext as bB, type StartExecutionRequest as ba, type SuffixCondition as bb, type TriggerCondition as bc, type TriggerContext as bd, type TriggerEventAction as be, type TriggerEventActionConfig as bf, type TriggerEventConfig as bg, type TriggerEventEntityActivity as bh, type TriggerEventEntityOperation as bi, type TriggerEventEventCatalog as bj, type TriggerEventFlowAutomationTask as bk, type TriggerEventManual as bl, type TriggerEventMessaging as bm, type TriggerEventPayloadRef as bn, type TriggerShareEntityAction as bo, type TriggerShareEntityActionConfig as bp, type TriggerShareEntityConfig as bq, type TriggerWebhookAction as br, type TriggerWebhookActionConfig as bs, type TriggerWebhookConfig as bt, type TriggerWorkflowAction as bu, type TriggerWorkflowActionConfig as bv, type TriggerWorkflowCondition as bw, type TriggerWorkflowConfig as bx, type WildcardCondition as by, type WorkflowContextRole as bz, type ActionSchedule as c, type ActionScheduleSource as d, type ActivityId as e, type ActivityTrigger as f, type AnyAction as g, type AnyActionConfig as h, type AnyTrigger as i, type AnythingButCondition as j, type ApiCallerContext as k, type ApiSubmissionTrigger as l, type AppendValueMapper as m, type AssignEntityAction as n, type AssignEntityActionConfig as o, type AssignEntityConfig as p, type AssignThreadAction as q, type AssignThreadConfig as r, type AssignUsersToStep as s, type AutomationAction as t, type AutomationActionConfig as u, type AutomationActionExecutionState as v, type AutomationActionId as w, type AutomationActionIteration as x, type AutomationExecution as y, type AutomationExecutionId as z };

package/dist/{automation.d-Bp45eKlU.d.ts → automation.d-2biAmiMc.d.ts}

@@ -557,7 +557,23 @@ declare namespace Components {
          *       ```
          *
          */
-        EntityOperationTrigger | ActivityTrigger | EntityManualTrigger | ReceivedEmailTrigger | NewEmailThreadTrigger | FlowsTrigger;
+        EntityOperationTrigger | ActivityTrigger | EntityManualTrigger | ReceivedEmailTrigger | NewEmailThreadTrigger | FlowsTrigger | /**
+         * Starts the flow when an Event Catalog event is published for the organization. The execution runs in the context of one entity from the event's entity graph (`entity_node_id`), and the event payload is available to conditions and actions as the `event` variable context.
+         *
+         * example:
+         * {
+         *   "id": "12d4f45a-1883-4841-a94c-5928cb338a94",
+         *   "type": "event_catalog",
+         *   "configuration": {
+         *     "event_name": "CustomerRequestSubmitted",
+         *     "event_version": "1.1",
+         *     "entity_node_id": "ticket",
+         *     "entity_schema": "ticket",
+         *     "ignore_automation_triggered": true
+         *   }
+         * }
+         */
+        EventCatalogTrigger;
         export interface AnythingButCondition {
             "anything-but"?: string[];
         }
@@ -912,6 +928,38 @@ declare namespace Components {
                  */
                 values?: string[];
             };
+            /**
+             * Candidate condition for `sequential` and `even_distribution`: when true,
+             * only assign to users whose skills (tags) match a label on the entity
+             * being assigned. Opt-in; defaults to false. An entity carrying no
+             * namespaced label matches nobody, so the fallback applies.
+             *
+             */
+            match_user_skills?: boolean;
+            /**
+             * Candidate condition (with match_user_skills): label families
+             * (taxonomy slugs) that must match. Only categories the entity actually
+             * carries a label in are scored: a user qualifies if it shares a label with
+             * the entity within each of those. A required category the entity has no
+             * label in is a free pass and gates nobody — so when the entity has no label
+             * in any required category, every candidate passes this filter. Note this
+             * is the opposite of an entity carrying no namespaced label at all, which
+             * matches nobody — see `match_user_skills`. Leave empty to match on any
+             * label (flat OR across all categories).
+             *
+             */
+            required_skill_categories?: string[];
+            /**
+             * How strictly required skill categories are matched (applies with
+             * match_user_skills and required skill categories set).
+             * - require_all: hard match (default) — a user must match every required
+             *   category the entity has a label in.
+             * - prefer: soft match — prefer the best-matching users, relaxing to
+             *   fewer categories only when no better match exists; a user matching
+             *   no category is never eligible (the fallback then applies).
+             *
+             */
+            skill_match_mode?: "require_all" | "prefer";
             /**
              * What to do when no assignable principal resolves, e.g. an empty or
              * fully ineligible `candidate_group`.
@@ -1365,7 +1413,11 @@ declare namespace Components {
              * 2
              */
             version?: number;
-            trigger_event?: TriggerEventManual | TriggerEventEntityActivity | TriggerEventEntityOperation | TriggerEventFlowAutomationTask | TriggerEventMessaging;
+            trigger_event?: TriggerEventManual | TriggerEventEntityActivity | TriggerEventEntityOperation | TriggerEventFlowAutomationTask | TriggerEventMessaging | /**
+             * Set on executions started by an Event Catalog event (see EventCatalogTrigger). The full event payload is not stored inline (it may be up to 256 KB) but by reference in `payload_ref`; automation workers hydrate it before every action.
+             *
+             */
+            TriggerEventEventCatalog;
             workflow_context?: WorkflowExecutionContext;
             workflow_wait_context?: /**
              * Correlation stamped when the triggering submission entity carried workflow wait claims from a journey link (AL-2521). Consumed by svc-workflows to resume a task waiting on this journey submission.
@@ -1537,10 +1589,19 @@ declare namespace Components {
              */
             source_path: string;
             /**
-             * How source_path is interpreted. 'journey-multi-select' is the v1 source type (journey card block with multi-select). Future source types (e.g. 'previous-action-outputs', 'entity-relation') will be added here.
+             * How source_path is interpreted. 'journey-multi-select' is the v1 source type (journey card block with multi-select). 'journey-file-upload' iterates the files uploaded in a journey file upload block: source_path points at the submission's `_files.$relation` array, `filter_tags` narrows it down to the block's files and every item is treated as a `file` entity reference. Future source types (e.g. 'previous-action-outputs', 'entity-relation') will be added here.
              *
              */
-            source_type?: "journey-multi-select" | "previous-action-outputs" | "entity-relation";
+            source_type?: "journey-multi-select" | "journey-file-upload" | "previous-action-outputs" | "entity-relation";
+            /**
+             * Only iterate items of the resolved array whose `_tags` contain every listed tag. Meant for relation arrays such as `submission._files.$relation`, where the journey tags each file relation with the upload block it came from.
+             *
+             * example:
+             * [
+             *   "_hidden_ 2a4b1c3d-0000-4000-8000-000000000000 - Dokumente"
+             * ]
+             */
+            filter_tags?: string[];
             /**
              * Maximum number of iterations. 0 / omitted = iterate the full resolved array.
              *
@@ -1959,7 +2020,11 @@ declare namespace Components {
                  */
                 id?: string;
                 origin?: "trigger" | "action";
-                originType?: "entity" | "workflow" | "journey_block";
+                /**
+                 * `event` reads the operand from the trigger's Event Catalog payload instead of an entity: `attribute` is then a dot path into the payload (e.g. `ticket.subject`). Only valid with `origin: trigger` on flows started by an EventCatalogTrigger.
+                 *
+                 */
+                originType?: "entity" | "workflow" | "journey_block" | "event";
                 schema?: string;
                 attribute?: string;
                 attributeType?: "string" | "text" | "number" | "boolean" | "date" | "datetime" | "tags" | "country" | "email" | "phone" | "product" | "price" | "status" | "relation" | "multiselect" | "select" | "radio" | "relation_user" | "purpose" | "label" | "payment" | "relation_payment_method";
@@ -2722,6 +2787,63 @@ declare namespace Components {
                 details?: ErrorDetail[];
             };
         }
+        /**
+         * Starts the flow when an Event Catalog event is published for the organization. The execution runs in the context of one entity from the event's entity graph (`entity_node_id`), and the event payload is available to conditions and actions as the `event` variable context.
+         *
+         * example:
+         * {
+         *   "id": "12d4f45a-1883-4841-a94c-5928cb338a94",
+         *   "type": "event_catalog",
+         *   "configuration": {
+         *     "event_name": "CustomerRequestSubmitted",
+         *     "event_version": "1.1",
+         *     "entity_node_id": "ticket",
+         *     "entity_schema": "ticket",
+         *     "ignore_automation_triggered": true
+         *   }
+         * }
+         */
+        export interface EventCatalogTrigger {
+            /**
+             * example:
+             * 12d4f45a-1883-4841-a94c-5928cb338a94
+             */
+            id?: string; // uuid
+            type: "event_catalog";
+            configuration: {
+                /**
+                 * Name of the Event Catalog event that starts this flow
+                 * example:
+                 * CustomerRequestSubmitted
+                 */
+                event_name: string;
+                /**
+                 * Event version (MAJOR.MINOR) this trigger is pinned to. Payloads published in a newer version are downgraded to this version before the flow runs, so field references in conditions and actions stay stable.
+                 *
+                 * example:
+                 * 1.1
+                 */
+                event_version: string;
+                /**
+                 * Id of the cardinality-one node in the event's entity graph whose entity becomes the execution's main entity (the entity actions operate on).
+                 *
+                 * example:
+                 * ticket
+                 */
+                entity_node_id: string;
+                /**
+                 * Schema of the entity behind `entity_node_id`, denormalized from the event definition at configuration time
+                 * example:
+                 * ticket
+                 */
+                entity_schema: string;
+                /**
+                 * When true (default), events that were emitted by an automation (`_trigger_source_type: automation`) do not start this flow. This prevents automation → event → automation chains unless explicitly enabled.
+                 *
+                 */
+                ignore_automation_triggered?: boolean;
+            };
+        }
         /**
          * Execution item for bulk trigger automation. It maps each entity to its automation execution id & status
          */
@@ -4704,6 +4826,64 @@ declare namespace Components {
             ActivityId;
             operation_type: EntityOperation;
         }
+        /**
+         * Set on executions started by an Event Catalog event (see EventCatalogTrigger). The full event payload is not stored inline (it may be up to 256 KB) but by reference in `payload_ref`; automation workers hydrate it before every action.
+         *
+         */
+        export interface TriggerEventEventCatalog {
+            type: "event_catalog";
+            /**
+             * example:
+             * 123
+             */
+            org_id: string;
+            entity_id: /**
+             * example:
+             * e3d3ebac-baab-4395-abf4-50b5bf1f8b74
+             */
+            EntityId;
+            /**
+             * Node id of the event's entity graph that was resolved to `entity_id`
+             * example:
+             * ticket
+             */
+            entity_node_id: string;
+            /**
+             * Event Catalog event id (ULID) of the published event
+             * example:
+             * 01K3ZK8QZ7Y7Q2M8W1V3N4X5P6
+             */
+            event_id: string;
+            /**
+             * example:
+             * CustomerRequestSubmitted
+             */
+            event_name: string;
+            /**
+             * Version the payload was delivered in (the version pinned on the trigger)
+             * example:
+             * 1.1
+             */
+            event_version: string;
+            /**
+             * Version the event was originally published with, before downgrading to `event_version`
+             * example:
+             * 1.2
+             */
+            published_version?: string;
+            event_time?: string; // date-time
+            /**
+             * How the event was triggered in the catalog (api | automation | operation | portal_user)
+             * example:
+             * operation
+             */
+            trigger_source_type?: string;
+            /**
+             * Opaque source reference from the catalog (e.g. activity id, automation execution id)
+             */
+            trigger_source?: string;
+            payload_ref?: /* S3 reference to the stored trigger event payload (`_downgrades` stripped, downgraded to the pinned version) */ TriggerEventPayloadRef;
+        }
         export interface TriggerEventFlowAutomationTask {
             type?: "flow_automation_task";
             /**
@@ -4757,6 +4937,21 @@ declare namespace Components {
              */
             EntityId;
         }
+        /**
+         * S3 reference to the stored trigger event payload (`_downgrades` stripped, downgraded to the pinned version)
+         */
+        export interface TriggerEventPayloadRef {
+            /**
+             * example:
+             * automation-trigger-payloads-prod
+             */
+            bucket: string;
+            /**
+             * example:
+             * trigger-payloads/123/6c8e5d9a-7f1b-4c2e-9d3a-0b1c2d3e4f5a.json
+             */
+            key: string;
+        }
         export interface TriggerShareEntityAction {
             id?: /**
              * example:
@@ -5717,6 +5912,11 @@ declare namespace Paths {
              * wfABCDEFGH
              */
             export type TargetWorkflow = string;
+            /**
+             * example:
+             * CustomerRequestSubmitted
+             */
+            export type TriggerEventName = string;
             /**
              * example:
              * 600945fe-212e-4b97-acf7-391d64648384
@@ -5741,6 +5941,11 @@ declare namespace Paths {
              * wfABCDEFGH
              */
             Parameters.TargetWorkflow;
+            trigger_event_name?: /**
+             * example:
+             * CustomerRequestSubmitted
+             */
+            Parameters.TriggerEventName;
             include_flows?: Parameters.IncludeFlows;
         }
         namespace Responses {
@@ -6213,6 +6418,7 @@ type ErrorCode = Components.Schemas.ErrorCode;
 type ErrorDetail = Components.Schemas.ErrorDetail;
 type ErrorObject = Components.Schemas.ErrorObject;
 type ErrorOutput = Components.Schemas.ErrorOutput;
+type EventCatalogTrigger = Components.Schemas.EventCatalogTrigger;
 type ExecItem = Components.Schemas.ExecItem;
 type ExecutionChain = Components.Schemas.ExecutionChain;
 type ExecutionStatus = Components.Schemas.ExecutionStatus;
@@ -6284,9 +6490,11 @@ type TriggerEventActionConfig = Components.Schemas.TriggerEventActionConfig;
 type TriggerEventConfig = Components.Schemas.TriggerEventConfig;
 type TriggerEventEntityActivity = Components.Schemas.TriggerEventEntityActivity;
 type TriggerEventEntityOperation = Components.Schemas.TriggerEventEntityOperation;
+type TriggerEventEventCatalog = Components.Schemas.TriggerEventEventCatalog;
 type TriggerEventFlowAutomationTask = Components.Schemas.TriggerEventFlowAutomationTask;
 type TriggerEventManual = Components.Schemas.TriggerEventManual;
 type TriggerEventMessaging = Components.Schemas.TriggerEventMessaging;
+type TriggerEventPayloadRef = Components.Schemas.TriggerEventPayloadRef;
 type TriggerShareEntityAction = Components.Schemas.TriggerShareEntityAction;
 type TriggerShareEntityActionConfig = Components.Schemas.TriggerShareEntityActionConfig;
 type TriggerShareEntityConfig = Components.Schemas.TriggerShareEntityConfig;
@@ -6302,4 +6510,4 @@ type WorkflowContextRole = Components.Schemas.WorkflowContextRole;
 type WorkflowExecutionContext = Components.Schemas.WorkflowExecutionContext;
 type WorkflowWaitContext = Components.Schemas.WorkflowWaitContext;
 
-export { type EntityItemSnapshot as $, type ActionCondition as A, type AutomationFlow as B, type Client as C, type AutomationFlowId as D, type AutomationLoop as E, type AutomationLoopState as F, type AutomationTrigger as G, type BulkTriggerJob as H, type BulkTriggerRequest as I, type CancellationReason as J, type CartCheckoutAction as K, type CartCheckoutActionConfig as L, type CartCheckoutConfig as M, type Comparison as N, type OperationMethods as O, Paths as P, type ConditionStatement as Q, type CopyValueMapper as R, type CreateDocumentAction as S, type CreateDocumentActionConfig as T, type CreateDocumentConfig as U, type CustomAction as V, type DiffAdded as W, type DiffDeleted as X, type DiffUpdated as Y, type EntityAssignee as Z, type EntityId as _, Components as a, type RetryReq as a$, type EntityManualTrigger as a0, type EntityOperation as a1, type EntityOperationTrigger as a2, type EntityRef as a3, type EntitySearchFilter as a4, type EntitySearchFilterValue as a5, type EqualsIgnoreCaseCondition as a6, type ErrorCode as a7, type ErrorDetail as a8, type ErrorObject as a9, type MapEntityAction as aA, type MapEntityActionConfig as aB, type MapEntityConfig as aC, type MappingAttribute as aD, type MappingAttributeMode as aE, type MappingAttributeV2 as aF, type MappingConfigRef as aG, type MoveThreadAction as aH, type MoveThreadConfig as aI, type NewEmailThreadTrigger as aJ, type NumericCondition as aK, type OperationNode as aL, type OperationObjectNode as aM, type OrCondition as aN, type OrConditionForDiff as aO, type OrganizationId as aP, type PatchBulkJobRequest as aQ, type PrefixCondition as aR, type PrimitiveJSONValue as aS, type ReceivedEmailTrigger as aT, type RelationAttribute as aU, type ReplyEmailAction as aV, type ReplyEmailActionConfig as aW, type ReplyEmailConfig as aX, type ResumeReq as aY, type ResumeResp as aZ, type ResumeToken as a_, type ErrorOutput as aa, type ExecItem as ab, type ExecutionChain as ac, type ExecutionStatus as ad, type ExistsCondition as ae, type FilterConditionOnEvent as af, type FlowExecutionCancelAction as ag, type FlowExecutionCancelActionConfig as ah, type FlowExecutionCancelConfig as ai, type FlowsTrigger as aj, type ForwardEmailAction as ak, type ForwardEmailActionConfig as al, type ForwardEmailConfig as am, type FrontendSubmitTrigger as an, type GetExecutionsResp as ao, type GraphContextEntry as ap, type GraphDefinition as aq, type GraphEdge as ar, type GraphNode as as, type GraphNodeFilter as at, type GraphSeed as au, type InformERPAction as av, type InformERPActionConfig as aw, type InformERPConfig as ax, type JobId as ay, type JourneySubmitTrigger as az, type PathsDictionary as b, type RetryStrategy as b0, type SearchAutomationsResp as b1, type SearchExecutionsReq as b2, type SearchExecutionsResp as b3, type SendEmailAction as b4, type SendEmailActionConfig as b5, type SendEmailCondition as b6, type SendEmailConfig as b7, type SetValueMapper as b8, type StartExecutionRequest as b9, type SuffixCondition as ba, type TriggerCondition as bb, type TriggerContext as bc, type TriggerEventAction as bd, type TriggerEventActionConfig as be, type TriggerEventConfig as bf, type TriggerEventEntityActivity as bg, type TriggerEventEntityOperation as bh, type TriggerEventFlowAutomationTask as bi, type TriggerEventManual as bj, type TriggerEventMessaging as bk, type TriggerShareEntityAction as bl, type TriggerShareEntityActionConfig as bm, type TriggerShareEntityConfig as bn, type TriggerWebhookAction as bo, type TriggerWebhookActionConfig as bp, type TriggerWebhookConfig as bq, type TriggerWorkflowAction as br, type TriggerWorkflowActionConfig as bs, type TriggerWorkflowCondition as bt, type TriggerWorkflowConfig as bu, type WildcardCondition as bv, type WorkflowContextRole as bw, type WorkflowExecutionContext as bx, type WorkflowWaitContext as by, type ActionSchedule as c, type ActionScheduleSource as d, type ActivityId as e, type ActivityTrigger as f, type AnyAction as g, type AnyActionConfig as h, type AnyTrigger as i, type AnythingButCondition as j, type ApiCallerContext as k, type ApiSubmissionTrigger as l, type AppendValueMapper as m, type AssignEntityAction as n, type AssignEntityActionConfig as o, type AssignEntityConfig as p, type AssignThreadAction as q, type AssignThreadConfig as r, type AssignUsersToStep as s, type AutomationAction as t, type AutomationActionConfig as u, type AutomationActionExecutionState as v, type AutomationActionId as w, type AutomationActionIteration as x, type AutomationExecution as y, type AutomationExecutionId as z };
+export { type EntityItemSnapshot as $, type ActionCondition as A, type AutomationFlow as B, type Client as C, type AutomationFlowId as D, type AutomationLoop as E, type AutomationLoopState as F, type AutomationTrigger as G, type BulkTriggerJob as H, type BulkTriggerRequest as I, type CancellationReason as J, type CartCheckoutAction as K, type CartCheckoutActionConfig as L, type CartCheckoutConfig as M, type Comparison as N, type OperationMethods as O, Paths as P, type ConditionStatement as Q, type CopyValueMapper as R, type CreateDocumentAction as S, type CreateDocumentActionConfig as T, type CreateDocumentConfig as U, type CustomAction as V, type DiffAdded as W, type DiffDeleted as X, type DiffUpdated as Y, type EntityAssignee as Z, type EntityId as _, Components as a, type ResumeToken as a$, type EntityManualTrigger as a0, type EntityOperation as a1, type EntityOperationTrigger as a2, type EntityRef as a3, type EntitySearchFilter as a4, type EntitySearchFilterValue as a5, type EqualsIgnoreCaseCondition as a6, type ErrorCode as a7, type ErrorDetail as a8, type ErrorObject as a9, type JourneySubmitTrigger as aA, type MapEntityAction as aB, type MapEntityActionConfig as aC, type MapEntityConfig as aD, type MappingAttribute as aE, type MappingAttributeMode as aF, type MappingAttributeV2 as aG, type MappingConfigRef as aH, type MoveThreadAction as aI, type MoveThreadConfig as aJ, type NewEmailThreadTrigger as aK, type NumericCondition as aL, type OperationNode as aM, type OperationObjectNode as aN, type OrCondition as aO, type OrConditionForDiff as aP, type OrganizationId as aQ, type PatchBulkJobRequest as aR, type PrefixCondition as aS, type PrimitiveJSONValue as aT, type ReceivedEmailTrigger as aU, type RelationAttribute as aV, type ReplyEmailAction as aW, type ReplyEmailActionConfig as aX, type ReplyEmailConfig as aY, type ResumeReq as aZ, type ResumeResp as a_, type ErrorOutput as aa, type EventCatalogTrigger as ab, type ExecItem as ac, type ExecutionChain as ad, type ExecutionStatus as ae, type ExistsCondition as af, type FilterConditionOnEvent as ag, type FlowExecutionCancelAction as ah, type FlowExecutionCancelActionConfig as ai, type FlowExecutionCancelConfig as aj, type FlowsTrigger as ak, type ForwardEmailAction as al, type ForwardEmailActionConfig as am, type ForwardEmailConfig as an, type FrontendSubmitTrigger as ao, type GetExecutionsResp as ap, type GraphContextEntry as aq, type GraphDefinition as ar, type GraphEdge as as, type GraphNode as at, type GraphNodeFilter as au, type GraphSeed as av, type InformERPAction as aw, type InformERPActionConfig as ax, type InformERPConfig as ay, type JobId as az, type PathsDictionary as b, type RetryReq as b0, type RetryStrategy as b1, type SearchAutomationsResp as b2, type SearchExecutionsReq as b3, type SearchExecutionsResp as b4, type SendEmailAction as b5, type SendEmailActionConfig as b6, type SendEmailCondition as b7, type SendEmailConfig as b8, type SetValueMapper as b9, type WorkflowExecutionContext as bA, type WorkflowWaitContext as bB, type StartExecutionRequest as ba, type SuffixCondition as bb, type TriggerCondition as bc, type TriggerContext as bd, type TriggerEventAction as be, type TriggerEventActionConfig as bf, type TriggerEventConfig as bg, type TriggerEventEntityActivity as bh, type TriggerEventEntityOperation as bi, type TriggerEventEventCatalog as bj, type TriggerEventFlowAutomationTask as bk, type TriggerEventManual as bl, type TriggerEventMessaging as bm, type TriggerEventPayloadRef as bn, type TriggerShareEntityAction as bo, type TriggerShareEntityActionConfig as bp, type TriggerShareEntityConfig as bq, type TriggerWebhookAction as br, type TriggerWebhookActionConfig as bs, type TriggerWebhookConfig as bt, type TriggerWorkflowAction as bu, type TriggerWorkflowActionConfig as bv, type TriggerWorkflowCondition as bw, type TriggerWorkflowConfig as bx, type WildcardCondition as by, type WorkflowContextRole as bz, type ActionSchedule as c, type ActionScheduleSource as d, type ActivityId as e, type ActivityTrigger as f, type AnyAction as g, type AnyActionConfig as h, type AnyTrigger as i, type AnythingButCondition as j, type ApiCallerContext as k, type ApiSubmissionTrigger as l, type AppendValueMapper as m, type AssignEntityAction as n, type AssignEntityActionConfig as o, type AssignEntityConfig as p, type AssignThreadAction as q, type AssignThreadConfig as r, type AssignUsersToStep as s, type AutomationAction as t, type AutomationActionConfig as u, type AutomationActionExecutionState as v, type AutomationActionId as w, type AutomationActionIteration as x, type AutomationExecution as y, type AutomationExecutionId as z };