@epilot/cli 0.1.144 → 0.1.145

package/README.md

@@ -29,7 +29,7 @@ npm install -g @epilot/cli
 
 <!-- usage-help -->
 ```
-epilot v0.1.144 — CLI for epilot APIs
+epilot v0.1.145 — CLI for epilot APIs
 
 USAGE
   epilot <api> <operationId> [params...] [flags]

package/definitions/automation.json

@@ -79,6 +79,15 @@
               "example": "wfABCDEFGH"
             }
           },
+          {
+            "name": "trigger_event_name",
+            "in": "query",
+            "description": "Filter by Event Catalog event name. Returns only automations that have an event_catalog trigger for this event.",
+            "schema": {
+              "type": "string",
+              "example": "CustomerRequestSubmitted"
+            }
+          },
           {
             "name": "include_flows",
             "in": "query",
@@ -1249,6 +1258,9 @@
           },
           {
             "$ref": "#/components/schemas/FlowsTrigger"
+          },
+          {
+            "$ref": "#/components/schemas/EventCatalogTrigger"
           }
         ]
       },
@@ -1900,12 +1912,168 @@
             "items": {
               "type": "string"
             }
+          },
+          "graph_context": {
+            "type": "array",
+            "description": "Multi-hop graph queries (executed via entity-api's `POST /v1/entity:graph`), each\nmerging every traversed node into the mapping's source context under its own node id,\nso `mapping_attributes` (e.g. `_copy` / `_template`) can reference it alongside the\nmain entity, e.g. `{ \"_copy\": \"order.line_items\" }`.\n\n`seed.entity_id` and any node `filter[].value` may contain `{{handlebars}}`\nplaceholders (e.g. `{{trigger.entity._id}}`) that are resolved at execution time\nagainst the mapping's source context. Resolution and graph execution happen in\nentity-mapping-api; this API only accepts, validates and passes through this field.\n",
+            "items": {
+              "$ref": "#/components/schemas/GraphContextEntry"
+            }
           }
         },
         "required": [
           "target_schema"
         ]
       },
+      "GraphContextEntry": {
+        "type": "object",
+        "description": "One multi-hop graph query to run against entity-api's `POST /v1/entity:graph`. Every node\nin `graph.nodes` is merged into the mapping's source context under its own `id`, so\nlisting multiple nodes here costs one entity-api call, not one per node. A node's value\noverwrites any existing source-context key of the same name (the source entity, a 1-hop\nrelation, or another graph node).\n",
+        "required": [
+          "seed",
+          "graph"
+        ],
+        "properties": {
+          "seed": {
+            "$ref": "#/components/schemas/GraphSeed"
+          },
+          "graph": {
+            "$ref": "#/components/schemas/GraphDefinition"
+          }
+        }
+      },
+      "GraphSeed": {
+        "type": "object",
+        "required": [
+          "entity_id",
+          "node_id"
+        ],
+        "properties": {
+          "entity_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "node_id": {
+            "type": "string",
+            "description": "The node ID in the graph definition that corresponds to the seed entity",
+            "example": "contact"
+          }
+        }
+      },
+      "GraphDefinition": {
+        "type": "object",
+        "required": [
+          "nodes",
+          "edges"
+        ],
+        "properties": {
+          "nodes": {
+            "type": "array",
+            "description": "List of node definitions in the graph",
+            "items": {
+              "$ref": "#/components/schemas/GraphNode"
+            }
+          },
+          "edges": {
+            "type": "array",
+            "description": "List of edge definitions connecting nodes",
+            "items": {
+              "$ref": "#/components/schemas/GraphEdge"
+            }
+          }
+        }
+      },
+      "GraphNode": {
+        "type": "object",
+        "required": [
+          "id",
+          "schema"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Unique identifier for this node in the graph definition",
+            "example": "contact"
+          },
+          "schema": {
+            "type": "string",
+            "description": "Entity schema slug for this node",
+            "example": "contact"
+          },
+          "cardinality": {
+            "type": "string",
+            "enum": [
+              "one",
+              "many"
+            ],
+            "description": "\"one\": this node resolves to a single entity. \"many\" (default if unset): this node\nresolves to an array of entities. The seed node always returns a single entity\nregardless of this setting.\n",
+            "example": "one"
+          },
+          "fields": {
+            "type": "array",
+            "description": "Optional entity fields to include in the hydrated response for this node.",
+            "items": {
+              "type": "string"
+            }
+          },
+          "filter": {
+            "type": "array",
+            "description": "Narrows this node's traversal results to entities matching every filter (AND\nsemantics). Useful for disambiguating among multiple entities reachable via the same\ngraph edge.\n",
+            "items": {
+              "$ref": "#/components/schemas/GraphNodeFilter"
+            }
+          }
+        }
+      },
+      "GraphNodeFilter": {
+        "type": "object",
+        "description": "Entities are included in this node's result only if `attribute` exactly equals the literal `value`.",
+        "required": [
+          "attribute",
+          "value"
+        ],
+        "properties": {
+          "attribute": {
+            "type": "string",
+            "description": "Entity attribute name to match against.",
+            "example": "order_number"
+          },
+          "value": {
+            "description": "Literal value the attribute must exactly equal for the entity to be included in this node's result. Supports `{{handlebars}}` placeholders resolved against sourceContext when given as a string.",
+            "oneOf": [
+              {
+                "type": "string",
+                "nullable": true
+              },
+              {
+                "type": "number"
+              },
+              {
+                "type": "boolean"
+              }
+            ],
+            "example": "OR-113"
+          }
+        }
+      },
+      "GraphEdge": {
+        "type": "object",
+        "required": [
+          "from",
+          "to"
+        ],
+        "properties": {
+          "from": {
+            "type": "string",
+            "description": "Source node ID",
+            "example": "contact"
+          },
+          "to": {
+            "type": "string",
+            "description": "Target node ID",
+            "example": "billing_account"
+          }
+        }
+      },
       "MappingConfigRef": {
         "type": "object",
         "properties": {
@@ -2663,10 +2831,7 @@
           "language_code": {
             "type": "string",
             "description": "Language code for the email template",
-            "enum": [
-              "de",
-              "en"
-            ]
+            "example": "de"
           },
           "reply_mode": {
             "type": "string",
@@ -2697,10 +2862,7 @@
           },
           "language_code": {
             "type": "string",
-            "enum": [
-              "de",
-              "en"
-            ]
+            "example": "de"
           },
           "notify_portal_user_only": {
             "type": "boolean",
@@ -3503,10 +3665,12 @@
               },
               "originType": {
                 "type": "string",
+                "description": "`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.\n",
                 "enum": [
                   "entity",
                   "workflow",
-                  "journey_block"
+                  "journey_block",
+                  "event"
                 ]
               },
               "schema": {
@@ -3796,6 +3960,9 @@
               },
               {
                 "$ref": "#/components/schemas/TriggerEventMessaging"
+              },
+              {
+                "$ref": "#/components/schemas/TriggerEventEventCatalog"
               }
             ]
           },
@@ -3855,7 +4022,6 @@
       },
       "WorkflowExecutionContext": {
         "type": "object",
-        "description": "Automation Executions triggered by workflow task automations will always carry information about the triggering workflow. This information is helpful in correlating workflow executions with all the triggered automation executions\n",
         "required": [
           "workflow_exec_id",
           "workflow_role"
@@ -3897,12 +4063,17 @@
                 }
               }
             }
+          },
+          "trigger_user_id": {
+            "type": "string",
+            "description": "Id of the user on whose behalf the workflow task triggered this automation — the caller of a user-initiated run, or the user whose task completion advanced the flow to the automation task. Action workers resolve it as the acting user for template variable resolution (user.*) and email thread assignment, matching the attribution of manually triggered executions. Absent when no human action led to the trigger (scheduler fires, journey-triggered flows).\n",
+            "example": "10006129"
           }
         }
       },
       "WorkflowWaitContext": {
         "type": "object",
-        "description": "Workflow automation tasks can be paused & waiting for journey automation executions to succeed. If such is the case, this context tracks the task_id of the workflow waiting for journey submission success This context is consumed by svc-workflows to resume a task waiting on this journey submission.\n",
+        "description": "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.\n",
         "required": [
           "workflow_execution_id",
           "workflow_task_id"
@@ -4088,6 +4259,92 @@
           "operation_type"
         ]
       },
+      "TriggerEventEventCatalog": {
+        "type": "object",
+        "description": "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.\n",
+        "properties": {
+          "type": {
+            "type": "string",
+            "enum": [
+              "event_catalog"
+            ]
+          },
+          "org_id": {
+            "type": "string",
+            "example": "123"
+          },
+          "entity_id": {
+            "$ref": "#/components/schemas/EntityId"
+          },
+          "entity_node_id": {
+            "type": "string",
+            "description": "Node id of the event's entity graph that was resolved to `entity_id`",
+            "example": "ticket"
+          },
+          "event_id": {
+            "type": "string",
+            "description": "Event Catalog event id (ULID) of the published event",
+            "example": "01K3ZK8QZ7Y7Q2M8W1V3N4X5P6"
+          },
+          "event_name": {
+            "type": "string",
+            "example": "CustomerRequestSubmitted"
+          },
+          "event_version": {
+            "type": "string",
+            "description": "Version the payload was delivered in (the version pinned on the trigger)",
+            "example": "1.1"
+          },
+          "published_version": {
+            "type": "string",
+            "description": "Version the event was originally published with, before downgrading to `event_version`",
+            "example": "1.2"
+          },
+          "event_time": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "trigger_source_type": {
+            "type": "string",
+            "description": "How the event was triggered in the catalog (api | automation | operation | portal_user)",
+            "example": "operation"
+          },
+          "trigger_source": {
+            "type": "string",
+            "description": "Opaque source reference from the catalog (e.g. activity id, automation execution id)"
+          },
+          "payload_ref": {
+            "$ref": "#/components/schemas/TriggerEventPayloadRef"
+          }
+        },
+        "required": [
+          "type",
+          "org_id",
+          "entity_id",
+          "entity_node_id",
+          "event_id",
+          "event_name",
+          "event_version"
+        ]
+      },
+      "TriggerEventPayloadRef": {
+        "type": "object",
+        "description": "S3 reference to the stored trigger event payload (`_downgrades` stripped, downgraded to the pinned version)",
+        "properties": {
+          "bucket": {
+            "type": "string",
+            "example": "automation-trigger-payloads-prod"
+          },
+          "key": {
+            "type": "string",
+            "example": "trigger-payloads/123/6c8e5d9a-7f1b-4c2e-9d3a-0b1c2d3e4f5a.json"
+          }
+        },
+        "required": [
+          "bucket",
+          "key"
+        ]
+      },
       "ApiCallerContext": {
         "type": "object",
         "additionalProperties": true,
@@ -4999,7 +5256,12 @@
           "updateEntity",
           "deleteEntity",
           "softDeleteEntity",
-          "restoreEntity"
+          "restoreEntity",
+          "relationsAdded",
+          "relationsRemoved",
+          "relationsSoftDeleted",
+          "relationsRestored",
+          "relationsDeleted"
         ]
       },
       "EntitySearchFilter": {
@@ -5205,6 +5467,76 @@
           }
         ]
       },
+      "EventCatalogTrigger": {
+        "description": "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.\n",
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/AutomationTrigger"
+          },
+          {
+            "type": "object",
+            "properties": {
+              "type": {
+                "type": "string",
+                "enum": [
+                  "event_catalog"
+                ]
+              },
+              "configuration": {
+                "type": "object",
+                "properties": {
+                  "event_name": {
+                    "type": "string",
+                    "description": "Name of the Event Catalog event that starts this flow",
+                    "example": "CustomerRequestSubmitted"
+                  },
+                  "event_version": {
+                    "type": "string",
+                    "description": "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.\n",
+                    "example": "1.1"
+                  },
+                  "entity_node_id": {
+                    "type": "string",
+                    "description": "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).\n",
+                    "example": "ticket"
+                  },
+                  "entity_schema": {
+                    "type": "string",
+                    "description": "Schema of the entity behind `entity_node_id`, denormalized from the event definition at configuration time",
+                    "example": "ticket"
+                  },
+                  "ignore_automation_triggered": {
+                    "type": "boolean",
+                    "default": true,
+                    "description": "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.\n"
+                  }
+                },
+                "required": [
+                  "event_name",
+                  "event_version",
+                  "entity_node_id",
+                  "entity_schema"
+                ]
+              }
+            },
+            "required": [
+              "type",
+              "configuration"
+            ]
+          }
+        ],
+        "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
+          }
+        }
+      },
       "TriggerCondition": {
         "type": "object",
         "properties": {

package/definitions/event-catalog.json

@@ -48,6 +48,39 @@
             }
           }
         }
+      },
+      "post": {
+        "operationId": "createCustomEvent",
+        "summary": "createCustomEvent",
+        "description": "Reserve an org-scoped custom event name and persist its immutable v1.0 draft definition.",
+        "tags": [
+          "Event Catalog"
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreateCustomEventPayload"
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "Custom event draft created",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/EventConfig"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "Name is reserved by a built-in or existing org event"
+          }
+        }
       }
     },
     "/v1/events/{event_name}": {
@@ -125,6 +158,127 @@
             "description": "Event not found"
           }
         }
+      },
+      "delete": {
+        "operationId": "deprecateCustomEvent",
+        "summary": "deprecateCustomEvent",
+        "description": "Soft-deprecate an org-scoped custom event. Definitions and v1.0 history remain readable.",
+        "tags": [
+          "Event Catalog"
+        ],
+        "parameters": [
+          {
+            "name": "event_name",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Custom event deprecated"
+          },
+          "404": {
+            "description": "Event not found"
+          },
+          "409": {
+            "description": "Built-ins cannot be deprecated or lifecycle cannot transition"
+          }
+        }
+      }
+    },
+    "/v1/events/{event_name}:preview": {
+      "post": {
+        "operationId": "previewCustomEvent",
+        "summary": "previewCustomEvent",
+        "description": "Assemble and fully validate a persisted custom-event draft without publishing it.",
+        "tags": [
+          "Event Catalog"
+        ],
+        "parameters": [
+          {
+            "name": "event_name",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/TriggerEventPayload"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Deterministic preview result",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PreviewEventResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Projection or schema validation failed"
+          },
+          "404": {
+            "description": "Custom event not found"
+          }
+        }
+      }
+    },
+    "/v1/events/{event_name}:publish": {
+      "post": {
+        "operationId": "publishCustomEventDefinition",
+        "summary": "publishCustomEventDefinition",
+        "description": "Conditionally activate an immutable custom-event v1.0 definition.",
+        "tags": [
+          "Event Catalog"
+        ],
+        "parameters": [
+          {
+            "name": "event_name",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PublishCustomEventPayload"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Published event configuration",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/EventConfig"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "Definition is not a draft or base publication choice is invalid"
+          }
+        }
       }
     },
     "/v1/events/{event_name}/json_schema": {
@@ -437,7 +591,7 @@
       "post": {
         "operationId": "triggerEvent",
         "summary": "triggerEvent",
-        "description": "Explicitly trigger an event by providing input field values and an optional entity seed\nfor graph hydration. The event must be enabled for the organization.\n\n- For events with an entity_graph, a seed (entity_id + node_id) is required\n- For events without an entity_graph, only fields are needed\n- Entity operation context fields (operation, trigger_entity, activity_id, activity_type)\n  are not included when triggering via API\n",
+        "description": "Explicitly trigger an event by providing input field values and an optional entity seed\nfor graph hydration. The event must be enabled for the organization.\n\n- For events with an entity_graph, a seed (entity_id + node_id) is required\n- For events without an entity_graph, only fields are needed\n- Entity operation context fields (operation, trigger_entity, activity_id, activity_type)\n  are not included when triggering via API\n- Events marked `automation_trigger_only` require `_trigger_source_type: automation` and a\n  stable execution/action ID in `_trigger_source`; retries with that ID return the same\n  logical event, including while durable delivery is pending\n",
         "tags": [
           "Event Catalog"
         ],
@@ -464,7 +618,7 @@
         },
         "responses": {
           "200": {
-            "description": "Event triggered successfully",
+            "description": "Event published successfully",
             "content": {
               "application/json": {
                 "schema": {
@@ -481,6 +635,33 @@
           },
           "404": {
             "description": "Event not found"
+          },
+          "409": {
+            "description": "The Automation trigger source was already used with different trigger input, including a different entity seed"
+          },
+          "425": {
+            "description": "The hydrated entity graph is not ready yet, another request currently owns the\nidempotency lease, or a durably queued event (including an already-requested redrive)\nis awaiting publication. Automation must retry with the same trigger source and may\nadvance only after a 200 response.\n",
+            "headers": {
+              "Retry-After": {
+                "description": "Seconds before the Automation action should retry",
+                "schema": {
+                  "type": "integer",
+                  "minimum": 1
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Durable delivery exhausted its bounded automatic redrives. The same logical event is\nretained and no new event is created. An API retry with the same trigger source\nrequests a redrive of the existing Standard workflow from its failed task checkpoint\nand receives this retryable response. Subsequent retries receive 425 while that\nredrive is pending or running.\n",
+            "headers": {
+              "Retry-After": {
+                "description": "Seconds before the Automation action should retry",
+                "schema": {
+                  "type": "integer",
+                  "minimum": 1
+                }
+              }
+            }
           }
         }
       }
@@ -594,6 +775,34 @@
             "default": false,
             "example": true
           },
+          "automation_trigger_only": {
+            "type": "boolean",
+            "readOnly": true,
+            "description": "Whether explicit triggering is restricted to Automation. When true, callers must pass\n`_trigger_source_type: automation` and a stable `_trigger_source`. The trigger uses\nstrict entity readiness validation and the durable Automation outbox.\nRequires `automation_trigger: true` and cannot be combined with `entity_operation`.\n",
+            "default": false,
+            "example": true
+          },
+          "automation_trigger_seed_node": {
+            "type": "string",
+            "readOnly": true,
+            "description": "Required entity-graph seed node for an Automation-only trigger. When configured, an\nexplicit trigger using any other node is rejected before hydration.\n",
+            "example": "ticket"
+          },
+          "event_origin": {
+            "type": "string",
+            "readOnly": true,
+            "enum": [
+              "builtin",
+              "custom"
+            ],
+            "description": "Definition ownership. Built-ins always win a name collision."
+          },
+          "mapping": {
+            "$ref": "#/components/schemas/EventMapping"
+          },
+          "lineage": {
+            "$ref": "#/components/schemas/CustomEventLineage"
+          },
           "success_criteria": {
             "type": "array",
             "description": "Org-defined success criteria for this event: the entity attributes that an\norganization considers must be captured for an event change request to be\ntreated as complete (e.g. for telephony / self-service flows).\n\nAdvisory metadata — event-catalog does NOT require an org to define any and\ndoes NOT enforce them when an event is triggered or published. The org may\ndefine none (empty array or omitted). When provided, each entry is validated\nfor well-formedness on write (see SuccessCriterion).\n",
@@ -629,17 +838,187 @@
           }
         ]
       },
-      "UpdateEventPayload": {
-        "description": "Payload for updating an event configuration.\nAccepts the same fields as EventConfig (all optional for PATCH).\nCurrently `enabled`, `auto_trigger` and `success_criteria` fields are processed.\n",
-        "allOf": [
-          {
-            "$ref": "#/components/schemas/EventConfigBase"
+      "CreateCustomEventPayload": {
+        "type": "object",
+        "description": "Complete immutable custom-event v1.0 definition. Publication is a separate conditional action.",
+        "properties": {
+          "event_name": {
+            "type": "string",
+            "pattern": "^[A-Z][A-Za-z0-9]{2,79}$"
           },
-          {
-            "type": "object"
+          "event_title": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 160
+          },
+          "event_description": {
+            "type": "string",
+            "maxLength": 2000
+          },
+          "event_tags": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "schema_fields": {
+            "type": "object",
+            "additionalProperties": {
+              "$ref": "#/components/schemas/CustomSchemaField"
+            }
+          },
+          "entity_graph": {
+            "$ref": "#/components/schemas/GraphDefinition"
+          },
+          "entity_operation": {
+            "$ref": "#/components/schemas/EntityOperationTrigger"
+          },
+          "automation_trigger": {
+            "type": "boolean",
+            "default": true
+          },
+          "mapping": {
+            "$ref": "#/components/schemas/EventMapping"
+          },
+          "lineage": {
+            "$ref": "#/components/schemas/CustomEventLineage"
+          },
+          "example": {
+            "type": "object",
+            "additionalProperties": true
+          }
+        },
+        "required": [
+          "event_name",
+          "event_title",
+          "schema_fields"
+        ]
+      },
+      "EventMapping": {
+        "type": "object",
+        "description": "Guided mappings use schema_fields graph_source expressions; raw mode evaluates one JSONata object transform.",
+        "properties": {
+          "mode": {
+            "type": "string",
+            "enum": [
+              "guided",
+              "jsonata"
+            ],
+            "default": "guided"
+          },
+          "jsonata": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 20000
           }
+        },
+        "required": [
+          "mode"
         ]
       },
+      "CustomEventLineage": {
+        "type": "object",
+        "description": "Optional catalog lineage to a separately named base event. It does not replace the base event.",
+        "properties": {
+          "base_event_name": {
+            "type": "string"
+          },
+          "base_event_version": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "base_event_name",
+          "base_event_version"
+        ]
+      },
+      "PurposeFilterSnapshot": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "display_name": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "id",
+          "display_name"
+        ]
+      },
+      "PublishCustomEventPayload": {
+        "type": "object",
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "default": true
+          },
+          "auto_trigger": {
+            "type": "boolean",
+            "default": true
+          },
+          "base_auto_trigger_enabled": {
+            "type": "boolean",
+            "description": "Optional publication choice. False disables only the named lineage base event's org auto-trigger overlay."
+          }
+        }
+      },
+      "ValidationIssue": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string"
+          },
+          "message": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "path",
+          "message"
+        ]
+      },
+      "PreviewEventResponse": {
+        "type": "object",
+        "properties": {
+          "payload": {
+            "type": "object",
+            "additionalProperties": true
+          },
+          "errors": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ValidationIssue"
+            }
+          }
+        },
+        "required": [
+          "payload",
+          "errors"
+        ]
+      },
+      "UpdateEventPayload": {
+        "type": "object",
+        "description": "Mutable org activation overlay. Immutable event definition fields are not accepted.",
+        "properties": {
+          "enabled": {
+            "type": "boolean"
+          },
+          "auto_trigger": {
+            "type": "boolean"
+          },
+          "success_criteria": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/SuccessCriterion"
+            }
+          }
+        },
+        "additionalProperties": false
+      },
       "PrimitiveField": {
         "type": "object",
         "description": "A primitive JSON Schema field definition",
@@ -700,6 +1079,17 @@
           "items"
         ]
       },
+      "CustomSchemaField": {
+        "description": "Custom v1 fields support JSON Schema values and context entities; attachment semantics are built-in-only.",
+        "oneOf": [
+          {
+            "$ref": "#/components/schemas/PrimitiveField"
+          },
+          {
+            "$ref": "#/components/schemas/ContextEntity"
+          }
+        ]
+      },
       "SchemaField": {
         "oneOf": [
           {
@@ -982,6 +1372,13 @@
             "items": {
               "$ref": "#/components/schemas/InlineDowngradeStep"
             }
+          },
+          "_automation_chain": {
+            "type": "array",
+            "description": "Ordered automation flow ids that caused this event (at most 100), propagated verbatim from the trigger input or the originating entity operation. Internal loop-prevention transport for automation-api; svc-webhooks strips it before delivery.",
+            "items": {
+              "type": "string"
+            }
           }
         },
         "required": [
@@ -1208,6 +1605,13 @@
               "Kündigung",
               "Umzug/Auszug"
             ]
+          },
+          "purpose_filters": {
+            "type": "array",
+            "description": "Stable purpose IDs plus immutable display-name snapshots for custom events.",
+            "items": {
+              "$ref": "#/components/schemas/PurposeFilterSnapshot"
+            }
           }
         },
         "required": [
@@ -1300,6 +1704,14 @@
       "TriggerEventPayload": {
         "type": "object",
         "description": "Payload for explicitly triggering an event via API",
+        "example": {
+          "seed": {
+            "entity_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
+            "node_id": "ticket"
+          },
+          "_trigger_source_type": "automation",
+          "_trigger_source": "execution-id/action-id"
+        },
         "properties": {
           "seed": {
             "type": "object",
@@ -1338,7 +1750,14 @@
           },
           "_trigger_source": {
             "type": "string",
-            "description": "Identifier of the specific trigger source.\nExamples: user ID, automation execution ID, activity ID, portal user email\nDefaults to the calling user ID if not specified.\n"
+            "description": "Identifier of the specific trigger source.\nExamples: user ID, automation execution ID, activity ID, portal user email\nDefaults to the calling user ID if not specified.\nRequired for events marked `automation_trigger_only` and must remain stable across\naction retries.\n"
+          },
+          "_automation_chain": {
+            "type": "array",
+            "description": "Ordered automation flow ids that caused this trigger (at most 100); propagated verbatim onto the published event for automation loop prevention.",
+            "items": {
+              "type": "string"
+            }
           }
         }
       },
@@ -1348,7 +1767,7 @@
         "properties": {
           "success": {
             "type": "boolean",
-            "description": "Whether the event was triggered successfully"
+            "description": "Whether the event was published successfully"
           },
           "event_id": {
             "type": "string",
@@ -1356,7 +1775,7 @@
           },
           "event_bridge_event_id": {
             "type": "string",
-            "description": "EventBridge event ID from publishing"
+            "description": "EventBridge event ID when synchronous delivery or a completed retry provides it"
           }
         },
         "required": [

package/dist/bin/epilot.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   API_LIST
-} from "../chunk-4EODPJ5A.js";
+} from "../chunk-GNZOIBKX.js";
 
 // bin/epilot.ts
 import { runMain } from "citty";
@@ -11,7 +11,7 @@ import { defineCommand } from "citty";
 var main = defineCommand({
   meta: {
     name: "epilot",
-    version: "0.1.144",
+    version: "0.1.145",
     description: "CLI for epilot APIs"
   },
   args: {
@@ -30,8 +30,8 @@ var main = defineCommand({
     auth: () => import("../auth-WMXFMPWE.js").then((m) => m.default),
     profile: () => import("../profile-OZJL5ZPT.js").then((m) => m.default),
     config: () => import("../config-DGZIMLZK.js").then((m) => m.default),
-    completion: () => import("../completion-HPDI7RNO.js").then((m) => m.default),
-    upgrade: () => import("../upgrade-4LGBIDMY.js").then((m) => m.default),
+    completion: () => import("../completion-RZ6CSKPV.js").then((m) => m.default),
+    upgrade: () => import("../upgrade-4DRMPNCM.js").then((m) => m.default),
     "access-token": () => import("../access-token-WWE6BDJH.js").then((m) => m.default),
     address: () => import("../address-EH3C4CVB.js").then((m) => m.default),
     "address-suggestions": () => import("../address-suggestions-RRSLOBFW.js").then((m) => m.default),
@@ -134,13 +134,13 @@ process.stderr.on("error", (err) => {
   if (err.code === "EPIPE") process.exit(0);
   throw err;
 });
-var VERSION = true ? "0.1.144" : (await null).default.version;
+var VERSION = true ? "0.1.145" : (await null).default.version;
 var reorderedArgv = hoistFlagsAfterSubcommand(process.argv.slice(2));
 process.argv = [process.argv[0], process.argv[1], ...reorderedArgv];
 var args = process.argv.slice(2);
 var completionsIdx = args.indexOf("--_completions");
 if (completionsIdx >= 0) {
-  const { handleCompletions } = await import("../completion-HPDI7RNO.js");
+  const { handleCompletions } = await import("../completion-RZ6CSKPV.js");
   handleCompletions(args[completionsIdx + 1], args[completionsIdx + 2]);
   process.exit(0);
 }

package/dist/{chunk-4EODPJ5A.js → chunk-GNZOIBKX.js}

@@ -810,11 +810,15 @@ var API_LIST = [
     kebabName: "event-catalog",
     title: "Event Catalog API",
     serverUrl: "https://event-catalog.sls.epilot.io",
-    operationCount: 10,
+    operationCount: 14,
     operationIds: [
       "listEvents",
+      "createCustomEvent",
       "getEvent",
       "patchEvent",
+      "deprecateCustomEvent",
+      "previewCustomEvent",
+      "publishCustomEventDefinition",
       "getEventJSONSchema",
       "getEventExample",
       "listEventVersions",

package/dist/{completion-HPDI7RNO.js → completion-RZ6CSKPV.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   API_LIST
-} from "./chunk-4EODPJ5A.js";
+} from "./chunk-GNZOIBKX.js";
 import {
   DIM,
   GREEN,

package/dist/{upgrade-4LGBIDMY.js → upgrade-4DRMPNCM.js}

@@ -72,7 +72,7 @@ ${GREEN}${BOLD}Upgraded to @epilot/cli@${latest}${RESET}
   }
 });
 var getCurrentVersion = () => {
-  if (true) return "0.1.144";
+  if (true) return "0.1.145";
   try {
     const output = execSync("npm ls -g @epilot/cli --depth=0 --json 2>/dev/null", {
       encoding: "utf-8",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/cli",
-  "version": "0.1.144",
+  "version": "0.1.145",
   "description": "CLI for epilot APIs",
   "type": "module",
   "bin": {