@epilot/sdk 2.20.32 → 2.20.34

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

@@ -92,6 +92,35 @@ declare namespace Components {
              */
             ConditionStatement[];
         }
+        /**
+         * Internal. Run-time inputs for the actions of this execution, keyed by
+         * action type. An action reads the entry for its own type and treats it
+         * as replacing the matching configured values; an action whose type has
+         * no entry runs entirely from its configuration.
+         *
+         * Only the workflows service may set this field, on behalf of the person
+         * running a semi-automated flow task: it forwards what that person chose
+         * after checking their permission to run the task. A request carrying
+         * `action_inputs` under any other token is refused with 403 and nothing
+         * is stored.
+         *
+         * This is deliberately NOT stored on `actions[].config`. Retrying a step
+         * refreshes that action's config from the live flow (see `startAction`),
+         * which would silently drop an override and re-run the action with the
+         * configured values — sending the wrong email, or cancelling a flow
+         * under the wrong reason. Keeping the inputs on the execution row means a
+         * retry replays what the person actually chose.
+         *
+         */
+        export interface ActionInputs {
+            "cancel-flow-execution"?: /* The cancellation reasons a person chose when running a semi-automated cancel step, replacing `selected_reasons` from the action's configuration. */ FlowExecutionCancelInputs;
+            "send-email"?: /**
+             * Adjustments a person made to an email before sending it, replacing the rendered values the template produced. The template itself is untouched.
+             *
+             * `attachment_entity_ids` is a request, not an instruction: the worker keeps only the ids that are genuinely files of the entity this execution runs on, so a caller cannot attach an arbitrary file.
+             */
+            SendEmailInputs;
+        }
         export interface ActionSchedule {
             /**
              * Schedule Id
@@ -1393,6 +1422,27 @@ declare namespace Components {
             conditions?: ActionCondition[];
             schedules?: ActionSchedule[];
             actions: AnyAction[];
+            action_inputs?: /**
+             * Internal. Run-time inputs for the actions of this execution, keyed by
+             * action type. An action reads the entry for its own type and treats it
+             * as replacing the matching configured values; an action whose type has
+             * no entry runs entirely from its configuration.
+             *
+             * Only the workflows service may set this field, on behalf of the person
+             * running a semi-automated flow task: it forwards what that person chose
+             * after checking their permission to run the task. A request carrying
+             * `action_inputs` under any other token is refused with 403 and nothing
+             * is stored.
+             *
+             * This is deliberately NOT stored on `actions[].config`. Retrying a step
+             * refreshes that action's config from the live flow (see `startAction`),
+             * which would silently drop an override and re-run the action with the
+             * configured values — sending the wrong email, or cancelling a flow
+             * under the wrong reason. Keeping the inputs on the execution row means a
+             * retry replays what the person actually chose.
+             *
+             */
+            ActionInputs;
             resume_token?: /**
              * A unique token to resume a paused automation execution
              * example:
@@ -1420,7 +1470,7 @@ declare namespace Components {
             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.
+             * Correlation stamped when the triggering submission entity carried workflow wait claims from a journey link. Consumed by svc-workflows to resume a task waiting on this journey submission.
              *
              */
             WorkflowWaitContext;
@@ -2908,7 +2958,7 @@ declare namespace Components {
             AutomationActionId;
             name?: string;
             type?: "cancel-flow-execution";
-            config?: /* Configuration for cancelling a flow execution with selected reasons */ FlowExecutionCancelConfig;
+            config?: /* Configuration for cancelling a flow execution. The selected reasons are optional; a semi-automated step lets the person running it choose them when the execution starts. */ FlowExecutionCancelConfig;
             /**
              * Whether to stop execution in a failed state if this action fails
              */
@@ -3000,7 +3050,7 @@ declare namespace Components {
             AutomationActionId;
             name?: string;
             type?: "cancel-flow-execution";
-            config?: /* Configuration for cancelling a flow execution with selected reasons */ FlowExecutionCancelConfig;
+            config?: /* Configuration for cancelling a flow execution. The selected reasons are optional; a semi-automated step lets the person running it choose them when the execution starts. */ FlowExecutionCancelConfig;
             /**
              * Whether to stop execution in a failed state if this action fails
              */
@@ -3042,7 +3092,7 @@ declare namespace Components {
             loop_id?: string;
         }
         /**
-         * Configuration for cancelling a flow execution with selected reasons
+         * Configuration for cancelling a flow execution. The selected reasons are optional; a semi-automated step lets the person running it choose them when the execution starts.
          */
         export interface FlowExecutionCancelConfig {
             /**
@@ -3056,6 +3106,16 @@ declare namespace Components {
              */
             extra_description?: string;
         }
+        /**
+         * The cancellation reasons a person chose when running a semi-automated cancel step, replacing `selected_reasons` from the action's configuration.
+         */
+        export interface FlowExecutionCancelInputs {
+            selected_reasons: /* A reason for cancelling a flow execution */ CancellationReason[];
+            /**
+             * A note the person added with their choice, replacing the one fixed in the action's configuration.
+             */
+            extra_description?: string;
+        }
         export interface FlowsTrigger {
             /**
              * example:
@@ -3233,6 +3293,13 @@ declare namespace Components {
              * Prefix to add to the original email subject
              */
             subject_prefix?: string;
+            /**
+             * Language of the "Forwarded message" attribution header
+             * (From / Date / To / Subject) prepended to the forwarded email.
+             * Defaults to German.
+             *
+             */
+            language_code?: "de" | "en";
             /**
              * When enabled, the email thread will be automatically marked as done after this action completes.
              */
@@ -3524,6 +3591,54 @@ declare namespace Components {
          * 8c086140-f33e-4bb7-a993-50c0f2402c7b
          */
         export type JobId = string;
+        export interface JourneyContextUsage {
+            kind: "automation";
+            resource: {
+                type: "automation_flow";
+                id: string;
+                name?: string;
+            };
+            location?: {
+                action_id?: string;
+                action_type?: string;
+            };
+            matched_as: {
+                dialect: "name";
+                token: string;
+                at: string;
+            };
+            link_hint: {
+                route: "automation-flow";
+                params: {
+                    [name: string]: string;
+                };
+            };
+        }
+        export interface JourneyContextUsagesReq {
+            journey_id: string; // uuid
+            /**
+             * Context parameter keys to look for, as plain strings.
+             */
+            param_keys: string[];
+            /**
+             * Accepted and ignored. This service stores context references by name only; the field keeps one request shape across every adapter.
+             *
+             */
+            param_ids?: string[];
+        }
+        export interface JourneyContextUsagesResp {
+            usages: JourneyContextUsage[];
+            /**
+             * partial means the row cap (MAX_USAGES) was reached mid-scan and the scan was aborted: entire flows after the one that tripped the cap may have gone unscanned, not just that some rows were dropped from the one flow being scanned when it tripped.
+             *
+             */
+            status: "ok" | "partial";
+            /**
+             * Number of flows actually entered by the scan, including the one flow the scan was aborted part-way through when the row cap tripped. Not a total: when status is partial, flows after the aborted one were never visited and are not counted here.
+             *
+             */
+            scanned: number;
+        }
         export interface JourneySubmitTrigger {
             /**
              * example:
@@ -4484,7 +4599,7 @@ declare namespace Components {
             /**
              * Only relevant when this action runs from a workflow automation task. After the email is sent,
              * the workflow task waits for the journey referenced in the email template to be submitted and
-             * its submission automation to complete (AL-2521).
+             * its submission automation to complete.
              *
              * The email template should contain a journey link created with the generateJourneyLink variable.
              *
@@ -4540,6 +4655,22 @@ declare namespace Components {
                      * .*
                      */
                     filename_regex?: string;
+                    /**
+                     * Match by exact filename
+                     * example:
+                     * Datenblatt_PV.pdf
+                     */
+                    filename?: string;
+                    /**
+                     * Match by a filename pattern that may contain template variables. Each
+                     * `{{variable}}` placeholder matches any text, so a pattern written the way a
+                     * generated document is named picks up every document produced from that
+                     * template, whatever the variables resolved to.
+                     *
+                     * example:
+                     * {{system.date}}_Summary_{{contact._title}}.docx
+                     */
+                    filename_pattern?: string;
                     /**
                      * Filter by a specific relation attribute on the main entity
                      * example:
@@ -4571,6 +4702,16 @@ declare namespace Components {
              */
             conditions?: SendEmailCondition[];
         }
+        /**
+         * Adjustments a person made to an email before sending it, replacing the rendered values the template produced. The template itself is untouched.
+         *
+         * `attachment_entity_ids` is a request, not an instruction: the worker keeps only the ids that are genuinely files of the entity this execution runs on, so a caller cannot attach an arbitrary file.
+         */
+        export interface SendEmailInputs {
+            subject?: string;
+            body?: string;
+            attachment_entity_ids?: string[];
+        }
         export interface SetValueMapper {
             mode: /**
              * - copy_if_exists - it replaces the target attribute with the source value - append_if_exists - it currently replaces target attribute with array like values. Useful when you have multiple values to be added into one attribute. - set_value - it sets a value to a predefined value. Must be used together with value property.
@@ -4608,6 +4749,27 @@ declare namespace Components {
              * Use workflow_context.workflow_exec_task_id instead
              */
             flow_automation_task_id?: string;
+            action_inputs?: /**
+             * Internal. Run-time inputs for the actions of this execution, keyed by
+             * action type. An action reads the entry for its own type and treats it
+             * as replacing the matching configured values; an action whose type has
+             * no entry runs entirely from its configuration.
+             *
+             * Only the workflows service may set this field, on behalf of the person
+             * running a semi-automated flow task: it forwards what that person chose
+             * after checking their permission to run the task. A request carrying
+             * `action_inputs` under any other token is refused with 403 and nothing
+             * is stored.
+             *
+             * This is deliberately NOT stored on `actions[].config`. Retrying a step
+             * refreshes that action's config from the live flow (see `startAction`),
+             * which would silently drop an override and re-run the action with the
+             * configured values — sending the wrong email, or cancelling a flow
+             * under the wrong reason. Keeping the inputs on the execution row means a
+             * retry replays what the person actually chose.
+             *
+             */
+            ActionInputs;
         }
         export interface SuffixCondition {
             suffix?: string;
@@ -5477,7 +5639,7 @@ declare namespace Components {
             trigger_user_id?: string;
         }
         /**
-         * 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.
+         * Correlation stamped when the triggering submission entity carried workflow wait claims from a journey link. Consumed by svc-workflows to resume a task waiting on this journey submission.
          *
          */
         export interface WorkflowWaitContext {
@@ -6359,6 +6521,7 @@ type Client = OpenAPIClient<OperationMethods, PathsDictionary>
 
 
 type ActionCondition = Components.Schemas.ActionCondition;
+type ActionInputs = Components.Schemas.ActionInputs;
 type ActionSchedule = Components.Schemas.ActionSchedule;
 type ActionScheduleSource = Components.Schemas.ActionScheduleSource;
 type ActivityId = Components.Schemas.ActivityId;
@@ -6427,6 +6590,7 @@ type FilterConditionOnEvent = Components.Schemas.FilterConditionOnEvent;
 type FlowExecutionCancelAction = Components.Schemas.FlowExecutionCancelAction;
 type FlowExecutionCancelActionConfig = Components.Schemas.FlowExecutionCancelActionConfig;
 type FlowExecutionCancelConfig = Components.Schemas.FlowExecutionCancelConfig;
+type FlowExecutionCancelInputs = Components.Schemas.FlowExecutionCancelInputs;
 type FlowsTrigger = Components.Schemas.FlowsTrigger;
 type ForwardEmailAction = Components.Schemas.ForwardEmailAction;
 type ForwardEmailActionConfig = Components.Schemas.ForwardEmailActionConfig;
@@ -6443,6 +6607,9 @@ type InformERPAction = Components.Schemas.InformERPAction;
 type InformERPActionConfig = Components.Schemas.InformERPActionConfig;
 type InformERPConfig = Components.Schemas.InformERPConfig;
 type JobId = Components.Schemas.JobId;
+type JourneyContextUsage = Components.Schemas.JourneyContextUsage;
+type JourneyContextUsagesReq = Components.Schemas.JourneyContextUsagesReq;
+type JourneyContextUsagesResp = Components.Schemas.JourneyContextUsagesResp;
 type JourneySubmitTrigger = Components.Schemas.JourneySubmitTrigger;
 type MapEntityAction = Components.Schemas.MapEntityAction;
 type MapEntityActionConfig = Components.Schemas.MapEntityActionConfig;
@@ -6480,6 +6647,7 @@ type SendEmailAction = Components.Schemas.SendEmailAction;
 type SendEmailActionConfig = Components.Schemas.SendEmailActionConfig;
 type SendEmailCondition = Components.Schemas.SendEmailCondition;
 type SendEmailConfig = Components.Schemas.SendEmailConfig;
+type SendEmailInputs = Components.Schemas.SendEmailInputs;
 type SetValueMapper = Components.Schemas.SetValueMapper;
 type StartExecutionRequest = Components.Schemas.StartExecutionRequest;
 type SuffixCondition = Components.Schemas.SuffixCondition;
@@ -6510,4 +6678,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 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 };
+export { type EntityId as $, type ActionCondition as A, type AutomationExecutionId as B, type Client as C, type AutomationFlow as D, type AutomationFlowId as E, type AutomationLoop as F, type AutomationLoopState as G, type AutomationTrigger as H, type BulkTriggerJob as I, type BulkTriggerRequest as J, type CancellationReason as K, type CartCheckoutAction as L, type CartCheckoutActionConfig as M, type CartCheckoutConfig as N, type OperationMethods as O, Paths as P, type Comparison as Q, type ConditionStatement as R, type CopyValueMapper as S, type CreateDocumentAction as T, type CreateDocumentActionConfig as U, type CreateDocumentConfig as V, type CustomAction as W, type DiffAdded as X, type DiffDeleted as Y, type DiffUpdated as Z, type EntityAssignee as _, Components as a, type ReplyEmailAction as a$, type EntityItemSnapshot as a0, type EntityManualTrigger as a1, type EntityOperation as a2, type EntityOperationTrigger as a3, type EntityRef as a4, type EntitySearchFilter as a5, type EntitySearchFilterValue as a6, type EqualsIgnoreCaseCondition as a7, type ErrorCode as a8, type ErrorDetail as a9, type InformERPConfig as aA, type JobId as aB, type JourneyContextUsage as aC, type JourneyContextUsagesReq as aD, type JourneyContextUsagesResp as aE, type JourneySubmitTrigger as aF, type MapEntityAction as aG, type MapEntityActionConfig as aH, type MapEntityConfig as aI, type MappingAttribute as aJ, type MappingAttributeMode as aK, type MappingAttributeV2 as aL, type MappingConfigRef as aM, type MoveThreadAction as aN, type MoveThreadConfig as aO, type NewEmailThreadTrigger as aP, type NumericCondition as aQ, type OperationNode as aR, type OperationObjectNode as aS, type OrCondition as aT, type OrConditionForDiff as aU, type OrganizationId as aV, type PatchBulkJobRequest as aW, type PrefixCondition as aX, type PrimitiveJSONValue as aY, type ReceivedEmailTrigger as aZ, type RelationAttribute as a_, type ErrorObject as aa, type ErrorOutput as ab, type EventCatalogTrigger as ac, type ExecItem as ad, type ExecutionChain as ae, type ExecutionStatus as af, type ExistsCondition as ag, type FilterConditionOnEvent as ah, type FlowExecutionCancelAction as ai, type FlowExecutionCancelActionConfig as aj, type FlowExecutionCancelConfig as ak, type FlowExecutionCancelInputs as al, type FlowsTrigger as am, type ForwardEmailAction as an, type ForwardEmailActionConfig as ao, type ForwardEmailConfig as ap, type FrontendSubmitTrigger as aq, type GetExecutionsResp as ar, type GraphContextEntry as as, type GraphDefinition as at, type GraphEdge as au, type GraphNode as av, type GraphNodeFilter as aw, type GraphSeed as ax, type InformERPAction as ay, type InformERPActionConfig as az, type PathsDictionary as b, type ReplyEmailActionConfig as b0, type ReplyEmailConfig as b1, type ResumeReq as b2, type ResumeResp as b3, type ResumeToken as b4, type RetryReq as b5, type RetryStrategy as b6, type SearchAutomationsResp as b7, type SearchExecutionsReq as b8, type SearchExecutionsResp as b9, type TriggerWorkflowAction as bA, type TriggerWorkflowActionConfig as bB, type TriggerWorkflowCondition as bC, type TriggerWorkflowConfig as bD, type WildcardCondition as bE, type WorkflowContextRole as bF, type WorkflowExecutionContext as bG, type WorkflowWaitContext as bH, type SendEmailAction as ba, type SendEmailActionConfig as bb, type SendEmailCondition as bc, type SendEmailConfig as bd, type SendEmailInputs as be, type SetValueMapper as bf, type StartExecutionRequest as bg, type SuffixCondition as bh, type TriggerCondition as bi, type TriggerContext as bj, type TriggerEventAction as bk, type TriggerEventActionConfig as bl, type TriggerEventConfig as bm, type TriggerEventEntityActivity as bn, type TriggerEventEntityOperation as bo, type TriggerEventEventCatalog as bp, type TriggerEventFlowAutomationTask as bq, type TriggerEventManual as br, type TriggerEventMessaging as bs, type TriggerEventPayloadRef as bt, type TriggerShareEntityAction as bu, type TriggerShareEntityActionConfig as bv, type TriggerShareEntityConfig as bw, type TriggerWebhookAction as bx, type TriggerWebhookActionConfig as by, type TriggerWebhookConfig as bz, type ActionInputs as c, type ActionSchedule as d, type ActionScheduleSource as e, type ActivityId as f, type ActivityTrigger as g, type AnyAction as h, type AnyActionConfig as i, type AnyTrigger as j, type AnythingButCondition as k, type ApiCallerContext as l, type ApiSubmissionTrigger as m, type AppendValueMapper as n, type AssignEntityAction as o, type AssignEntityActionConfig as p, type AssignEntityConfig as q, type AssignThreadAction as r, type AssignThreadConfig as s, type AssignUsersToStep as t, type AutomationAction as u, type AutomationActionConfig as v, type AutomationActionExecutionState as w, type AutomationActionId as x, type AutomationActionIteration as y, type AutomationExecution as z };

package/dist/chunk-M6G3GHCU.js

@@ -0,0 +1,14 @@
+import {
+  __commonJS
+} from "./chunk-YPSWSI3M.js";
+
+// src/definitions/event-catalog-runtime.json
+var require_event_catalog_runtime = __commonJS({
+  "src/definitions/event-catalog-runtime.json"(exports, module) {
+    module.exports = { s: "https://event-catalog.sls.epilot.io", o: [["listEvents", "get", "/v1/events"], ["createCustomEvent", "post", "/v1/events", null, 1], ["getEvent", "get", "/v1/events/{event_name}", [["event_name", "p", true]]], ["patchEvent", "patch", "/v1/events/{event_name}", [["event_name", "p", true]], 1], ["replaceCustomEventDraft", "put", "/v1/events/{event_name}", [["event_name", "p", true]], 1], ["deprecateCustomEvent", "delete", "/v1/events/{event_name}", [["event_name", "p", true]]], ["previewCustomEvent", "post", "/v1/events/{event_name}:preview", [["event_name", "p", true]], 1], ["publishCustomEventDefinition", "post", "/v1/events/{event_name}:publish", [["event_name", "p", true]], 1], ["getCustomEventVersionDraft", "get", "/v1/events/{event_name}/version_draft", [["event_name", "p", true]]], ["putCustomEventVersionDraft", "put", "/v1/events/{event_name}/version_draft", [["event_name", "p", true]], 1], ["deleteCustomEventVersionDraft", "delete", "/v1/events/{event_name}/version_draft", [["event_name", "p", true]]], ["publishCustomEventVersion", "post", "/v1/events/{event_name}/version_draft:publish", [["event_name", "p", true]], 1], ["getEventJSONSchema", "get", "/v1/events/{event_name}/json_schema", [["event_name", "p", true], ["Epilot-Event-Version", "h"]]], ["getEventExample", "get", "/v1/events/{event_name}/example", [["event_name", "p", true], ["Epilot-Event-Version", "h"]]], ["listEventVersions", "get", "/v1/events/{event_name}/versions", [["event_name", "p", true]]], ["searchEventHistory", "post", "/v1/events/{event_name}:history", [["event_name", "p", true]], 1], ["searchEventHistoryV2", "post", "/v2/events/{event_name}:history", [["event_name", "p", true]], 1], ["getHistoricalEvent", "get", "/v2/events/{event_name}/history/{event_id}", [["event_name", "p", true], ["event_id", "p", true]]], ["triggerEvent", "post", "/v1/events/{event_name}:trigger", [["event_name", "p", true]], 1]], v: "3.0.0" };
+  }
+});
+
+export {
+  require_event_catalog_runtime
+};

package/dist/{chunk-E7DJRTMC.js → chunk-RJVNG46W.js}

@@ -35,7 +35,7 @@ var globImport_docs = __glob({
   "./docs/ai-agents.json": () => import("./ai-agents-MY4QE4CP.js"),
   "./docs/app.json": () => import("./app-B3TAEVS4.js"),
   "./docs/audit-logs.json": () => import("./audit-logs-5VXHOQ7S.js"),
-  "./docs/automation.json": () => import("./automation-XFMSH7Y3.js"),
+  "./docs/automation.json": () => import("./automation-UPTNUOYO.js"),
   "./docs/billing.json": () => import("./billing-UJ6I7FPG.js"),
   "./docs/blueprint-manifest.json": () => import("./blueprint-manifest-YU2UZLHV.js"),
   "./docs/calendar.json": () => import("./calendar-2H4RGMV3.js"),
@@ -54,14 +54,14 @@ var globImport_docs = __glob({
   "./docs/entity.json": () => import("./entity-UEP5OY55.js"),
   "./docs/environments.json": () => import("./environments-OYCH6VUD.js"),
   "./docs/erp-integration.json": () => import("./erp-integration-SBQJ6HEG.js"),
-  "./docs/event-catalog.json": () => import("./event-catalog-S4OYTDIB.js"),
+  "./docs/event-catalog.json": () => import("./event-catalog-5HHAS7NI.js"),
   "./docs/file.json": () => import("./file-N3SGGI6E.js"),
   "./docs/iban.json": () => import("./iban-LDKYDVQV.js"),
   "./docs/integration-toolkit.json": () => import("./integration-toolkit-PUA7B6YT.js"),
   "./docs/journey.json": () => import("./journey-IVIBYU5V.js"),
   "./docs/kanban.json": () => import("./kanban-F22JXYCG.js"),
   "./docs/message.json": () => import("./message-SSTVRGEF.js"),
-  "./docs/metering.json": () => import("./metering-COO4BTOC.js"),
+  "./docs/metering.json": () => import("./metering-SHNCUA4O.js"),
   "./docs/notes.json": () => import("./notes-6JESMRLW.js"),
   "./docs/notification.json": () => import("./notification-PLIRHBNF.js"),
   "./docs/organization.json": () => import("./organization-ZERPH2IH.js"),
@@ -148,7 +148,7 @@ var globImport_definitions_json = __glob({
   "./definitions/environments.json": () => import("./environments-VCREW73K.js"),
   "./definitions/erp-integration-runtime.json": () => import("./erp-integration-runtime-JGVGQ22V.js"),
   "./definitions/erp-integration.json": () => import("./erp-integration-735KQ73W.js"),
-  "./definitions/event-catalog-runtime.json": () => import("./event-catalog-runtime-Z6OMHQBD.js"),
+  "./definitions/event-catalog-runtime.json": () => import("./event-catalog-runtime-5IXAZVIB.js"),
   "./definitions/event-catalog.json": () => import("./event-catalog-ZUFXLY7B.js"),
   "./definitions/file-runtime.json": () => import("./file-runtime-RS4DX5LB.js"),
   "./definitions/file.json": () => import("./file-EJJBQEQI.js"),

package/dist/chunk-ULV6ZQQR.cjs

@@ -0,0 +1,14 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkNJK5F5TFcjs = require('./chunk-NJK5F5TF.cjs');
+
+// src/definitions/event-catalog-runtime.json
+var require_event_catalog_runtime = _chunkNJK5F5TFcjs.__commonJS.call(void 0, {
+  "src/definitions/event-catalog-runtime.json"(exports, module) {
+    module.exports = { s: "https://event-catalog.sls.epilot.io", o: [["listEvents", "get", "/v1/events"], ["createCustomEvent", "post", "/v1/events", null, 1], ["getEvent", "get", "/v1/events/{event_name}", [["event_name", "p", true]]], ["patchEvent", "patch", "/v1/events/{event_name}", [["event_name", "p", true]], 1], ["replaceCustomEventDraft", "put", "/v1/events/{event_name}", [["event_name", "p", true]], 1], ["deprecateCustomEvent", "delete", "/v1/events/{event_name}", [["event_name", "p", true]]], ["previewCustomEvent", "post", "/v1/events/{event_name}:preview", [["event_name", "p", true]], 1], ["publishCustomEventDefinition", "post", "/v1/events/{event_name}:publish", [["event_name", "p", true]], 1], ["getCustomEventVersionDraft", "get", "/v1/events/{event_name}/version_draft", [["event_name", "p", true]]], ["putCustomEventVersionDraft", "put", "/v1/events/{event_name}/version_draft", [["event_name", "p", true]], 1], ["deleteCustomEventVersionDraft", "delete", "/v1/events/{event_name}/version_draft", [["event_name", "p", true]]], ["publishCustomEventVersion", "post", "/v1/events/{event_name}/version_draft:publish", [["event_name", "p", true]], 1], ["getEventJSONSchema", "get", "/v1/events/{event_name}/json_schema", [["event_name", "p", true], ["Epilot-Event-Version", "h"]]], ["getEventExample", "get", "/v1/events/{event_name}/example", [["event_name", "p", true], ["Epilot-Event-Version", "h"]]], ["listEventVersions", "get", "/v1/events/{event_name}/versions", [["event_name", "p", true]]], ["searchEventHistory", "post", "/v1/events/{event_name}:history", [["event_name", "p", true]], 1], ["searchEventHistoryV2", "post", "/v2/events/{event_name}:history", [["event_name", "p", true]], 1], ["getHistoricalEvent", "get", "/v2/events/{event_name}/history/{event_id}", [["event_name", "p", true], ["event_id", "p", true]]], ["triggerEvent", "post", "/v1/events/{event_name}:trigger", [["event_name", "p", true]], 1]], v: "3.0.0" };
+  }
+});
+
+
+
+exports.require_event_catalog_runtime = require_event_catalog_runtime;

package/dist/{chunk-A6FO6QAZ.cjs → chunk-XFBOYWIP.cjs}

@@ -35,7 +35,7 @@ var globImport_docs = _chunkNJK5F5TFcjs.__glob.call(void 0, {
   "./docs/ai-agents.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./ai-agents-ME5VRKMY.cjs"))),
   "./docs/app.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./app-C5H6RLZ5.cjs"))),
   "./docs/audit-logs.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./audit-logs-D2LFUA2R.cjs"))),
-  "./docs/automation.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./automation-CDMOEYVP.cjs"))),
+  "./docs/automation.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./automation-G2CKAQNB.cjs"))),
   "./docs/billing.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./billing-CKCFSK6K.cjs"))),
   "./docs/blueprint-manifest.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./blueprint-manifest-SXG3M6B4.cjs"))),
   "./docs/calendar.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./calendar-UADWQX7G.cjs"))),
@@ -54,14 +54,14 @@ var globImport_docs = _chunkNJK5F5TFcjs.__glob.call(void 0, {
   "./docs/entity.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./entity-3XUHHKA4.cjs"))),
   "./docs/environments.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./environments-S3O6ASTY.cjs"))),
   "./docs/erp-integration.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./erp-integration-PAVHSUDM.cjs"))),
-  "./docs/event-catalog.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./event-catalog-Z6BO4L2G.cjs"))),
+  "./docs/event-catalog.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./event-catalog-SAH4ZEOO.cjs"))),
   "./docs/file.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./file-2KT6MMMG.cjs"))),
   "./docs/iban.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./iban-24GHLFDB.cjs"))),
   "./docs/integration-toolkit.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./integration-toolkit-FM53LFD7.cjs"))),
   "./docs/journey.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./journey-ZN46FFPM.cjs"))),
   "./docs/kanban.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./kanban-FSATKIGH.cjs"))),
   "./docs/message.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./message-LJ32JH6Z.cjs"))),
-  "./docs/metering.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./metering-FJI2AU7Q.cjs"))),
+  "./docs/metering.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./metering-WAVFLJZD.cjs"))),
   "./docs/notes.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./notes-SLEUSNP4.cjs"))),
   "./docs/notification.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./notification-R2XBHFEW.cjs"))),
   "./docs/organization.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./organization-RARYYG2E.cjs"))),
@@ -148,7 +148,7 @@ var globImport_definitions_json = _chunkNJK5F5TFcjs.__glob.call(void 0, {
   "./definitions/environments.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./environments-5IS2ZJYQ.cjs"))),
   "./definitions/erp-integration-runtime.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./erp-integration-runtime-OZ4YSTQX.cjs"))),
   "./definitions/erp-integration.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./erp-integration-W7FZDJOB.cjs"))),
-  "./definitions/event-catalog-runtime.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./event-catalog-runtime-XWSYNUGQ.cjs"))),
+  "./definitions/event-catalog-runtime.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./event-catalog-runtime-2ACQMB22.cjs"))),
   "./definitions/event-catalog.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./event-catalog-MZYFJ23V.cjs"))),
   "./definitions/file-runtime.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./file-runtime-JL2IZ2CE.cjs"))),
   "./definitions/file.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./file-637CTR4Y.cjs"))),

package/dist/event-catalog-5HHAS7NI.js

@@ -0,0 +1,7 @@
+import "./chunk-YPSWSI3M.js";
+
+// src/docs/event-catalog.json
+var event_catalog_default = '# Event Catalog API\n\n- **Base URL:** `https://event-catalog.sls.epilot.io`\n- **Full API Docs:** [https://docs.epilot.io/api/event-catalog](https://docs.epilot.io/api/event-catalog)\n\n## Usage\n\n```ts\nimport { epilot } from \'@epilot/sdk\'\n\nepilot.authorize(() => \'<token>\')\nconst { data } = await epilot.eventCatalog.listEvents(...)\n```\n\n### Tree-shakeable import\n\n```ts\nimport { getClient, authorize } from \'@epilot/sdk/event-catalog\'\n\nconst eventCatalogClient = getClient()\nauthorize(eventCatalogClient, () => \'<token>\')\nconst { data } = await eventCatalogClient.listEvents(...)\n```\n\n## Operations\n\n**Event Catalog**\n- [`listEvents`](#listevents)\n- [`createCustomEvent`](#createcustomevent)\n- [`getEvent`](#getevent)\n- [`patchEvent`](#patchevent)\n- [`replaceCustomEventDraft`](#replacecustomeventdraft)\n- [`deprecateCustomEvent`](#deprecatecustomevent)\n- [`previewCustomEvent`](#previewcustomevent)\n- [`publishCustomEventDefinition`](#publishcustomeventdefinition)\n- [`getCustomEventVersionDraft`](#getcustomeventversiondraft)\n- [`putCustomEventVersionDraft`](#putcustomeventversiondraft)\n- [`deleteCustomEventVersionDraft`](#deletecustomeventversiondraft)\n- [`publishCustomEventVersion`](#publishcustomeventversion)\n- [`getEventJSONSchema`](#geteventjsonschema)\n- [`getEventExample`](#geteventexample)\n- [`listEventVersions`](#listeventversions)\n- [`searchEventHistory`](#searcheventhistory)\n- [`searchEventHistoryV2`](#searcheventhistoryv2)\n- [`getHistoricalEvent`](#gethistoricalevent)\n- [`triggerEvent`](#triggerevent)\n\n**Schemas**\n- [`EventConfigBase`](#eventconfigbase)\n- [`EventConfig`](#eventconfig)\n- [`CreateCustomEventPayload`](#createcustomeventpayload)\n- [`EventMapping`](#eventmapping)\n- [`CustomEventLineage`](#customeventlineage)\n- [`PurposeFilterSnapshot`](#purposefiltersnapshot)\n- [`PublishCustomEventPayload`](#publishcustomeventpayload)\n- [`CustomEventVersionDraft`](#customeventversiondraft)\n- [`PublishCustomEventVersionPayload`](#publishcustomeventversionpayload)\n- [`ValidationIssue`](#validationissue)\n- [`PreviewEventResponse`](#previeweventresponse)\n- [`UpdateEventPayload`](#updateeventpayload)\n- [`PrimitiveField`](#primitivefield)\n- [`ContextEntity`](#contextentity)\n- [`AttachmentField`](#attachmentfield)\n- [`CustomSchemaField`](#customschemafield)\n- [`SchemaField`](#schemafield)\n- [`SuccessCriterion`](#successcriterion)\n- [`CommonEventMetadata`](#commoneventmetadata)\n- [`EventJsonSchema`](#eventjsonschema)\n- [`InlineDowngradeStep`](#inlinedowngradestep)\n- [`Event`](#event)\n- [`EventSummary`](#eventsummary)\n- [`GraphDefinition`](#graphdefinition)\n- [`GraphNode`](#graphnode)\n- [`GraphEdge`](#graphedge)\n- [`EntityOperationTrigger`](#entityoperationtrigger)\n- [`SearchOptions`](#searchoptions)\n- [`SearchOptionsV2`](#searchoptionsv2)\n- [`FieldsParam`](#fieldsparam)\n- [`TriggerEventPayload`](#triggereventpayload)\n- [`TriggerEventResponse`](#triggereventresponse)\n- [`EventAttachment`](#eventattachment)\n- [`FieldChange`](#fieldchange)\n- [`VersionMeta`](#versionmeta)\n- [`EventVersionRegistrySummary`](#eventversionregistrysummary)\n\n### `listEvents`\n\nRetrieve list of available business events\n\n`GET /v1/events`\n\n```ts\nconst { data } = await client.listEvents()\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "results": [\n    {\n      "event_name": "AddMeterReading",\n      "event_title": "Add Meter Reading",\n      "event_description": "Triggered when a new meter reading is added",\n      "event_version": "1.0",\n      "event_status": "active",\n      "event_tags": ["builtin", "metering", "erp"],\n      "schema_fields": {},\n      "entity_graph": {\n        "nodes": [\n          {\n            "id": "contact",\n            "schema": "contact",\n            "cardinality": "one",\n            "fields": ["_id", "_title", "first_name", "account", "!account.*._files", "**._product"]\n          }\n        ],\n        "edges": [\n          {\n            "from": "contact",\n            "to": "billing_account"\n          }\n        ]\n      },\n      "entity_operation": {\n        "operation": ["createEntity", "updateEntity"],\n        "schema": ["contact", "contract", "order"],\n        "attribute": ["email", "phone", "status"],\n        "purpose": ["K\xFCndigung", "Umzug/Auszug"],\n        "purpose_filters": [\n          {\n            "id": "string",\n            "display_name": "string"\n          }\n        ]\n      },\n      "enabled": true,\n      "auto_trigger": true,\n      "automation_trigger": true,\n      "api_trigger": true,\n      "automation_trigger_only": true,\n      "automation_trigger_seed_node": "ticket",\n      "event_origin": "builtin",\n      "mapping": {\n        "mode": "guided",\n        "jsonata": "string"\n      },\n      "lineage": {\n        "base_event_name": "string",\n        "base_event_version": "string"\n      },\n      "success_criteria": [\n        {\n          "entity_schema": "contract",\n          "attribute": "installment_amount"\n        },\n        {\n          "entity_schema": "billing_account",\n          "attribute": "due_date"\n        }\n      ]\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `createCustomEvent`\n\nReserve an org-scoped custom event name and persist its immutable v1.0 draft definition. Custom events are always projected from an entity graph: entity_graph is required and, in guided mapping mode, \n\n`POST /v1/events`\n\n```ts\nconst { data } = await client.createCustomEvent(\n  null,\n  {\n    event_name: \'string\',\n    event_title: \'string\',\n    event_description: \'string\',\n    event_tags: [\'string\'],\n    schema_fields: {},\n    entity_graph: {\n      nodes: [\n        {\n          id: \'contact\',\n          schema: \'contact\',\n          cardinality: \'one\',\n          fields: [\'_id\', \'_title\', \'first_name\', \'account\', \'!account.*._files\', \'**._product\']\n        }\n      ],\n      edges: [\n        {\n          from: \'contact\',\n          to: \'billing_account\'\n        }\n      ]\n    },\n    entity_operation: {\n      operation: [\'createEntity\', \'updateEntity\'],\n      schema: [\'contact\', \'contract\', \'order\'],\n      attribute: [\'email\', \'phone\', \'status\'],\n      purpose: [\'K\xFCndigung\', \'Umzug/Auszug\'],\n      purpose_filters: [\n        {\n          id: \'string\',\n          display_name: \'string\'\n        }\n      ]\n    },\n    automation_trigger: true,\n    api_trigger: true,\n    automation_trigger_only: false,\n    automation_trigger_seed_node: \'string\',\n    mapping: {\n      mode: \'guided\',\n      jsonata: \'string\'\n    },\n    lineage: {\n      base_event_name: \'string\',\n      base_event_version: \'string\'\n    },\n    example: {}\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "event_name": "AddMeterReading",\n  "event_title": "Add Meter Reading",\n  "event_description": "Triggered when a new meter reading is added",\n  "event_version": "1.0",\n  "event_status": "active",\n  "event_tags": ["builtin", "metering", "erp"],\n  "schema_fields": {},\n  "entity_graph": {\n    "nodes": [\n      {\n        "id": "contact",\n        "schema": "contact",\n        "cardinality": "one",\n        "fields": ["_id", "_title", "first_name", "account", "!account.*._files", "**._product"]\n      }\n    ],\n    "edges": [\n      {\n        "from": "contact",\n        "to": "billing_account"\n      }\n    ]\n  },\n  "entity_operation": {\n    "operation": ["createEntity", "updateEntity"],\n    "schema": ["contact", "contract", "order"],\n    "attribute": ["email", "phone", "status"],\n    "purpose": ["K\xFCndigung", "Umzug/Auszug"],\n    "purpose_filters": [\n      {\n        "id": "string",\n        "display_name": "string"\n      }\n    ]\n  },\n  "enabled": true,\n  "auto_trigger": true,\n  "automation_trigger": true,\n  "api_trigger": true,\n  "automation_trigger_only": true,\n  "automation_trigger_seed_node": "ticket",\n  "event_origin": "builtin",\n  "mapping": {\n    "mode": "guided",\n    "jsonata": "string"\n  },\n  "lineage": {\n    "base_event_name": "string",\n    "base_event_version": "string"\n  },\n  "success_criteria": [\n    {\n      "entity_schema": "contract",\n      "attribute": "installment_amount"\n    },\n    {\n      "entity_schema": "billing_account",\n      "attribute": "due_date"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `getEvent`\n\nRetrieve the configuration of a specific business event\n\n`GET /v1/events/{event_name}`\n\n```ts\nconst { data } = await client.getEvent({\n  event_name: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "event_name": "AddMeterReading",\n  "event_title": "Add Meter Reading",\n  "event_description": "Triggered when a new meter reading is added",\n  "event_version": "1.0",\n  "event_status": "active",\n  "event_tags": ["builtin", "metering", "erp"],\n  "schema_fields": {},\n  "entity_graph": {\n    "nodes": [\n      {\n        "id": "contact",\n        "schema": "contact",\n        "cardinality": "one",\n        "fields": ["_id", "_title", "first_name", "account", "!account.*._files", "**._product"]\n      }\n    ],\n    "edges": [\n      {\n        "from": "contact",\n        "to": "billing_account"\n      }\n    ]\n  },\n  "entity_operation": {\n    "operation": ["createEntity", "updateEntity"],\n    "schema": ["contact", "contract", "order"],\n    "attribute": ["email", "phone", "status"],\n    "purpose": ["K\xFCndigung", "Umzug/Auszug"],\n    "purpose_filters": [\n      {\n        "id": "string",\n        "display_name": "string"\n      }\n    ]\n  },\n  "enabled": true,\n  "auto_trigger": true,\n  "automation_trigger": true,\n  "api_trigger": true,\n  "automation_trigger_only": true,\n  "automation_trigger_seed_node": "ticket",\n  "event_origin": "builtin",\n  "mapping": {\n    "mode": "guided",\n    "jsonata": "string"\n  },\n  "lineage": {\n    "base_event_name": "string",\n    "base_event_version": "string"\n  },\n  "success_criteria": [\n    {\n      "entity_schema": "contract",\n      "attribute": "installment_amount"\n    },\n    {\n      "entity_schema": "billing_account",\n      "attribute": "due_date"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `patchEvent`\n\nUpdate the configuration of a specific business event for the organization\n\n`PATCH /v1/events/{event_name}`\n\n```ts\nconst { data } = await client.patchEvent(\n  {\n    event_name: \'example\',\n  },\n  {\n    enabled: true,\n    auto_trigger: true,\n    success_criteria: [\n      {\n        entity_schema: \'contract\',\n        attribute: \'installment_amount\'\n      }\n    ]\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "event_name": "AddMeterReading",\n  "event_title": "Add Meter Reading",\n  "event_description": "Triggered when a new meter reading is added",\n  "event_version": "1.0",\n  "event_status": "active",\n  "event_tags": ["builtin", "metering", "erp"],\n  "schema_fields": {},\n  "entity_graph": {\n    "nodes": [\n      {\n        "id": "contact",\n        "schema": "contact",\n        "cardinality": "one",\n        "fields": ["_id", "_title", "first_name", "account", "!account.*._files", "**._product"]\n      }\n    ],\n    "edges": [\n      {\n        "from": "contact",\n        "to": "billing_account"\n      }\n    ]\n  },\n  "entity_operation": {\n    "operation": ["createEntity", "updateEntity"],\n    "schema": ["contact", "contract", "order"],\n    "attribute": ["email", "phone", "status"],\n    "purpose": ["K\xFCndigung", "Umzug/Auszug"],\n    "purpose_filters": [\n      {\n        "id": "string",\n        "display_name": "string"\n      }\n    ]\n  },\n  "enabled": true,\n  "auto_trigger": true,\n  "automation_trigger": true,\n  "api_trigger": true,\n  "automation_trigger_only": true,\n  "automation_trigger_seed_node": "ticket",\n  "event_origin": "builtin",\n  "mapping": {\n    "mode": "guided",\n    "jsonata": "string"\n  },\n  "lineage": {\n    "base_event_name": "string",\n    "base_event_version": "string"\n  },\n  "success_criteria": [\n    {\n      "entity_schema": "contract",\n      "attribute": "installment_amount"\n    },\n    {\n      "entity_schema": "billing_account",\n      "attribute": "due_date"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `replaceCustomEventDraft`\n\nReplace the complete v1.0 definition of an org-scoped custom event while it is still an\nunpublished draft. Drafts have no consumers, so their definition is not yet immutable;\nthe event name is the ide\n\n`PUT /v1/events/{event_name}`\n\n```ts\nconst { data } = await client.replaceCustomEventDraft(\n  {\n    event_name: \'example\',\n  },\n  {\n    event_name: \'string\',\n    event_title: \'string\',\n    event_description: \'string\',\n    event_tags: [\'string\'],\n    schema_fields: {},\n    entity_graph: {\n      nodes: [\n        {\n          id: \'contact\',\n          schema: \'contact\',\n          cardinality: \'one\',\n          fields: [\'_id\', \'_title\', \'first_name\', \'account\', \'!account.*._files\', \'**._product\']\n        }\n      ],\n      edges: [\n        {\n          from: \'contact\',\n          to: \'billing_account\'\n        }\n      ]\n    },\n    entity_operation: {\n      operation: [\'createEntity\', \'updateEntity\'],\n      schema: [\'contact\', \'contract\', \'order\'],\n      attribute: [\'email\', \'phone\', \'status\'],\n      purpose: [\'K\xFCndigung\', \'Umzug/Auszug\'],\n      purpose_filters: [\n        {\n          id: \'string\',\n          display_name: \'string\'\n        }\n      ]\n    },\n    automation_trigger: true,\n    api_trigger: true,\n    automation_trigger_only: false,\n    automation_trigger_seed_node: \'string\',\n    mapping: {\n      mode: \'guided\',\n      jsonata: \'string\'\n    },\n    lineage: {\n      base_event_name: \'string\',\n      base_event_version: \'string\'\n    },\n    example: {}\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "event_name": "AddMeterReading",\n  "event_title": "Add Meter Reading",\n  "event_description": "Triggered when a new meter reading is added",\n  "event_version": "1.0",\n  "event_status": "active",\n  "event_tags": ["builtin", "metering", "erp"],\n  "schema_fields": {},\n  "entity_graph": {\n    "nodes": [\n      {\n        "id": "contact",\n        "schema": "contact",\n        "cardinality": "one",\n        "fields": ["_id", "_title", "first_name", "account", "!account.*._files", "**._product"]\n      }\n    ],\n    "edges": [\n      {\n        "from": "contact",\n        "to": "billing_account"\n      }\n    ]\n  },\n  "entity_operation": {\n    "operation": ["createEntity", "updateEntity"],\n    "schema": ["contact", "contract", "order"],\n    "attribute": ["email", "phone", "status"],\n    "purpose": ["K\xFCndigung", "Umzug/Auszug"],\n    "purpose_filters": [\n      {\n        "id": "string",\n        "display_name": "string"\n      }\n    ]\n  },\n  "enabled": true,\n  "auto_trigger": true,\n  "automation_trigger": true,\n  "api_trigger": true,\n  "automation_trigger_only": true,\n  "automation_trigger_seed_node": "ticket",\n  "event_origin": "builtin",\n  "mapping": {\n    "mode": "guided",\n    "jsonata": "string"\n  },\n  "lineage": {\n    "base_event_name": "string",\n    "base_event_version": "string"\n  },\n  "success_criteria": [\n    {\n      "entity_schema": "contract",\n      "attribute": "installment_amount"\n    },\n    {\n      "entity_schema": "billing_account",\n      "attribute": "due_date"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `deprecateCustomEvent`\n\nSoft-deprecate an org-scoped custom event. Definitions and v1.0 history remain readable.\n\n`DELETE /v1/events/{event_name}`\n\n```ts\nconst { data } = await client.deprecateCustomEvent({\n  event_name: \'example\',\n})\n```\n\n---\n\n### `previewCustomEvent`\n\nAssemble and fully validate a persisted custom-event draft without publishing it.\n\n`POST /v1/events/{event_name}:preview`\n\n```ts\nconst { data } = await client.previewCustomEvent(\n  {\n    event_name: \'example\',\n  },\n  {\n    seed: {\n      entity_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n      node_id: \'ticket\'\n    },\n    _trigger_source_type: \'automation\',\n    _trigger_source: \'execution-id/action-id\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "payload": {},\n  "errors": [\n    {\n      "path": "string",\n      "message": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `publishCustomEventDefinition`\n\nConditionally activate an immutable custom-event v1.0 definition.\n\n`POST /v1/events/{event_name}:publish`\n\n```ts\nconst { data } = await client.publishCustomEventDefinition(\n  {\n    event_name: \'example\',\n  },\n  {\n    enabled: true,\n    auto_trigger: true,\n    base_auto_trigger_enabled: true\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "event_name": "AddMeterReading",\n  "event_title": "Add Meter Reading",\n  "event_description": "Triggered when a new meter reading is added",\n  "event_version": "1.0",\n  "event_status": "active",\n  "event_tags": ["builtin", "metering", "erp"],\n  "schema_fields": {},\n  "entity_graph": {\n    "nodes": [\n      {\n        "id": "contact",\n        "schema": "contact",\n        "cardinality": "one",\n        "fields": ["_id", "_title", "first_name", "account", "!account.*._files", "**._product"]\n      }\n    ],\n    "edges": [\n      {\n        "from": "contact",\n        "to": "billing_account"\n      }\n    ]\n  },\n  "entity_operation": {\n    "operation": ["createEntity", "updateEntity"],\n    "schema": ["contact", "contract", "order"],\n    "attribute": ["email", "phone", "status"],\n    "purpose": ["K\xFCndigung", "Umzug/Auszug"],\n    "purpose_filters": [\n      {\n        "id": "string",\n        "display_name": "string"\n      }\n    ]\n  },\n  "enabled": true,\n  "auto_trigger": true,\n  "automation_trigger": true,\n  "api_trigger": true,\n  "automation_trigger_only": true,\n  "automation_trigger_seed_node": "ticket",\n  "event_origin": "builtin",\n  "mapping": {\n    "mode": "guided",\n    "jsonata": "string"\n  },\n  "lineage": {\n    "base_event_name": "string",\n    "base_event_version": "string"\n  },\n  "success_criteria": [\n    {\n      "entity_schema": "contract",\n      "attribute": "installment_amount"\n    },\n    {\n      "entity_schema": "billing_account",\n      "attribute": "due_date"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `getCustomEventVersionDraft`\n\nRead the in-progress successor of a published custom event, together with the version it\nwould be published as. The live version keeps firing while the successor is authored.\n\n`GET /v1/events/{event_name}/version_draft`\n\n```ts\nconst { data } = await client.getCustomEventVersionDraft({\n  event_name: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "config": {\n    "event_name": "AddMeterReading",\n    "event_title": "Add Meter Reading",\n    "event_description": "Triggered when a new meter reading is added",\n    "event_version": "1.0",\n    "event_status": "active",\n    "event_tags": ["builtin", "metering", "erp"],\n    "schema_fields": {},\n    "entity_graph": {\n      "nodes": [\n        {\n          "id": "contact",\n          "schema": "contact",\n          "cardinality": "one",\n          "fields": ["_id", "_title", "first_name", "account", "!account.*._files", "**._product"]\n        }\n      ],\n      "edges": [\n        {\n          "from": "contact",\n          "to": "billing_account"\n        }\n      ]\n    },\n    "entity_operation": {\n      "operation": ["createEntity", "updateEntity"],\n      "schema": ["contact", "contract", "order"],\n      "attribute": ["email", "phone", "status"],\n      "purpose": ["K\xFCndigung", "Umzug/Auszug"],\n      "purpose_filters": [\n        {\n          "id": "string",\n          "display_name": "string"\n        }\n      ]\n    },\n    "enabled": true,\n    "auto_trigger": true,\n    "automation_trigger": true,\n    "api_trigger": true,\n    "automation_trigger_only": true,\n    "automation_trigger_seed_node": "ticket",\n    "event_origin": "builtin",\n    "mapping": {\n      "mode": "guided",\n      "jsonata": "string"\n    },\n    "lineage": {\n      "base_event_name": "string",\n      "base_event_version": "string"\n    },\n    "success_criteria": [\n      {\n        "entity_schema": "contract",\n        "attribute": "installment_amount"\n      },\n      {\n        "entity_schema": "billing_account",\n        "attribute": "due_date"\n      }\n    ]\n  },\n  "change_class": "none",\n  "next_version": "1.1",\n  "changes": [\n    {\n      "field": "reading",\n      "op": "added",\n      "type_old": "string",\n      "type_new": "string"\n    }\n  ],\n  "remapped_fields": ["string"],\n  "added_nodes": ["string"],\n  "blocked_reason": "string"\n}\n```\n\n</details>\n\n---\n\n### `putCustomEventVersionDraft`\n\nCreate or replace the successor of a published custom event. The published definition stays\nimmutable and keeps firing; only publishing the draft promotes it.\n\n`PUT /v1/events/{event_name}/version_draft`\n\n```ts\nconst { data } = await client.putCustomEventVersionDraft(\n  {\n    event_name: \'example\',\n  },\n  {\n    event_name: \'string\',\n    event_title: \'string\',\n    event_description: \'string\',\n    event_tags: [\'string\'],\n    schema_fields: {},\n    entity_graph: {\n      nodes: [\n        {\n          id: \'contact\',\n          schema: \'contact\',\n          cardinality: \'one\',\n          fields: [\'_id\', \'_title\', \'first_name\', \'account\', \'!account.*._files\', \'**._product\']\n        }\n      ],\n      edges: [\n        {\n          from: \'contact\',\n          to: \'billing_account\'\n        }\n      ]\n    },\n    entity_operation: {\n      operation: [\'createEntity\', \'updateEntity\'],\n      schema: [\'contact\', \'contract\', \'order\'],\n      attribute: [\'email\', \'phone\', \'status\'],\n      purpose: [\'K\xFCndigung\', \'Umzug/Auszug\'],\n      purpose_filters: [\n        {\n          id: \'string\',\n          display_name: \'string\'\n        }\n      ]\n    },\n    automation_trigger: true,\n    api_trigger: true,\n    automation_trigger_only: false,\n    automation_trigger_seed_node: \'string\',\n    mapping: {\n      mode: \'guided\',\n      jsonata: \'string\'\n    },\n    lineage: {\n      base_event_name: \'string\',\n      base_event_version: \'string\'\n    },\n    example: {}\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "config": {\n    "event_name": "AddMeterReading",\n    "event_title": "Add Meter Reading",\n    "event_description": "Triggered when a new meter reading is added",\n    "event_version": "1.0",\n    "event_status": "active",\n    "event_tags": ["builtin", "metering", "erp"],\n    "schema_fields": {},\n    "entity_graph": {\n      "nodes": [\n        {\n          "id": "contact",\n          "schema": "contact",\n          "cardinality": "one",\n          "fields": ["_id", "_title", "first_name", "account", "!account.*._files", "**._product"]\n        }\n      ],\n      "edges": [\n        {\n          "from": "contact",\n          "to": "billing_account"\n        }\n      ]\n    },\n    "entity_operation": {\n      "operation": ["createEntity", "updateEntity"],\n      "schema": ["contact", "contract", "order"],\n      "attribute": ["email", "phone", "status"],\n      "purpose": ["K\xFCndigung", "Umzug/Auszug"],\n      "purpose_filters": [\n        {\n          "id": "string",\n          "display_name": "string"\n        }\n      ]\n    },\n    "enabled": true,\n    "auto_trigger": true,\n    "automation_trigger": true,\n    "api_trigger": true,\n    "automation_trigger_only": true,\n    "automation_trigger_seed_node": "ticket",\n    "event_origin": "builtin",\n    "mapping": {\n      "mode": "guided",\n      "jsonata": "string"\n    },\n    "lineage": {\n      "base_event_name": "string",\n      "base_event_version": "string"\n    },\n    "success_criteria": [\n      {\n        "entity_schema": "contract",\n        "attribute": "installment_amount"\n      },\n      {\n        "entity_schema": "billing_account",\n        "attribute": "due_date"\n      }\n    ]\n  },\n  "change_class": "none",\n  "next_version": "1.1",\n  "changes": [\n    {\n      "field": "reading",\n      "op": "added",\n      "type_old": "string",\n      "type_new": "string"\n    }\n  ],\n  "remapped_fields": ["string"],\n  "added_nodes": ["string"],\n  "blocked_reason": "string"\n}\n```\n\n</details>\n\n---\n\n### `deleteCustomEventVersionDraft`\n\nDiscard the next-version draft. The published version is untouched.\n\n`DELETE /v1/events/{event_name}/version_draft`\n\n```ts\nconst { data } = await client.deleteCustomEventVersionDraft({\n  event_name: \'example\',\n})\n```\n\n---\n\n### `publishCustomEventVersion`\n\nPublish the next-version draft as the event\'s new live version.\n\n`POST /v1/events/{event_name}/version_draft:publish`\n\n```ts\nconst { data } = await client.publishCustomEventVersion(\n  {\n    event_name: \'example\',\n  },\n  {\n    change_summary: \'string\',\n    change_notes: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "event_name": "AddMeterReading",\n  "event_title": "Add Meter Reading",\n  "event_description": "Triggered when a new meter reading is added",\n  "event_version": "1.0",\n  "event_status": "active",\n  "event_tags": ["builtin", "metering", "erp"],\n  "schema_fields": {},\n  "entity_graph": {\n    "nodes": [\n      {\n        "id": "contact",\n        "schema": "contact",\n        "cardinality": "one",\n        "fields": ["_id", "_title", "first_name", "account", "!account.*._files", "**._product"]\n      }\n    ],\n    "edges": [\n      {\n        "from": "contact",\n        "to": "billing_account"\n      }\n    ]\n  },\n  "entity_operation": {\n    "operation": ["createEntity", "updateEntity"],\n    "schema": ["contact", "contract", "order"],\n    "attribute": ["email", "phone", "status"],\n    "purpose": ["K\xFCndigung", "Umzug/Auszug"],\n    "purpose_filters": [\n      {\n        "id": "string",\n        "display_name": "string"\n      }\n    ]\n  },\n  "enabled": true,\n  "auto_trigger": true,\n  "automation_trigger": true,\n  "api_trigger": true,\n  "automation_trigger_only": true,\n  "automation_trigger_seed_node": "ticket",\n  "event_origin": "builtin",\n  "mapping": {\n    "mode": "guided",\n    "jsonata": "string"\n  },\n  "lineage": {\n    "base_event_name": "string",\n    "base_event_version": "string"\n  },\n  "success_criteria": [\n    {\n      "entity_schema": "contract",\n      "attribute": "installment_amount"\n    },\n    {\n      "entity_schema": "billing_account",\n      "attribute": "due_date"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `getEventJSONSchema`\n\nRetrieve the JSON Schema of a specific business event. Pass an optional\n`Epilot-Event-Version` header to retrieve a specific version\'s schema;\nwhen omitted, the event\'s latest version is returned.\n\n`GET /v1/events/{event_name}/json_schema`\n\n```ts\nconst { data } = await client.getEventJSONSchema({\n  event_name: \'example\',\n  Epilot-Event-Version: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "type": "object",\n  "properties": {\n    "_org_id": {\n      "type": "string",\n      "description": "epilot tenant/organization ID"\n    },\n    "_event_time": {\n      "type": "string",\n      "format": "date-time",\n      "description": "ISO 8601 timestamp when event occurred"\n    },\n    "_event_id": {\n      "type": "string",\n      "description": "Unique event identifier (ULID)"\n    },\n    "_event_name": {\n      "type": "string",\n      "description": "Event name from catalog"\n    },\n    "_event_version": {\n      "type": "string",\n      "description": "Event payload version (MAJOR.MINOR)"\n    },\n    "_event_source": {\n      "type": "string",\n      "description": "Source that triggered the event"\n    },\n    "reading_value": {\n      "type": "number",\n      "description": "The meter reading value"\n    },\n    "reading_date": {\n      "type": "string",\n      "format": "date-time",\n      "description": "ISO 8601 timestamp when reading was taken"\n    },\n    "read_by": {\n      "type": "string",\n      "description": "Name or identifier of who submitted the reading"\n    },\n    "reason": {\n      "type": "string",\n      "enum": ["regular", "move-in", "move-out", "supplier-change", "correction", "final"],\n      "description": "Reason for the meter reading"\n    },\n    "direction": {\n      "type": "string",\n      "enum": ["feed-in", "feed-out"],\n      "description": "Direction of energy flow"\n    },\n    "source": {\n      "type": "string",\n      "enum": ["portal", "360", "api", "automation"],\n      "description": "Source system where reading was submitted"\n    },\n    "meter_id": {\n      "type": "string",\n      "format": "uuid",\n      "description": "Entity ID of the meter"\n    },\n    "counter_id": {\n      "type": "string",\n      "format": "uuid",\n      "description": "Entity ID of the meter counter"\n    },\n    "meter_number": {\n      "type": "string",\n      "description": "Human-readable meter number"\n    },\n    "obis_number": {\n      "type": "string",\n      "description": "OBIS code of the counter"\n    },\n    "unit": {\n      "type": "string",\n      "description": "Unit of measurement (e.g., kWh, m3)"\n    },\n    "customer_id": {\n      "type": "string",\n      "format": "uuid",\n      "description": "Entity ID of the customer"\n    },\n    "contract_id": {\n      "type": "string",\n      "format": "uuid",\n      "description": "Entity ID of the contract"\n    },\n    "user_id": {\n      "type": "string",\n      "description": "ID of the user who submitted the reading"\n    },\n    "user_email": {\n      "type": "string",\n      "format": "email",\n      "description": "Email of the user who submitted the reading"\n    }\n  },\n  "required": ["_org_id", "_event_time", "_event_id", "_event_name", "_event_version", "_event_source", "reading_value", "reading_date", "read_by", "reason", "direction", "source", "meter_id", "counter_id", "meter_number", "obis_number", "unit", "customer_id", "contract_id"]\n}\n```\n\n</details>\n\n---\n\n### `getEventExample`\n\nGenerate a sample event payload based on the event\'s JSON Schema. Pass an\noptional `Epilot-Event-Version` header to generate the example for a\nspecific version; when omitted, the event\'s latest versio\n\n`GET /v1/events/{event_name}/example`\n\n```ts\nconst { data } = await client.getEventExample({\n  event_name: \'example\',\n  Epilot-Event-Version: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{}\n```\n\n</details>\n\n---\n\n### `listEventVersions`\n\nList every known version of an event, along with the `latest`\nand the set of currently `active` versions. See \xA73.2 of the\nEvent Payload Versioning RFC.\n\n`GET /v1/events/{event_name}/versions`\n\n```ts\nconst { data } = await client.listEventVersions({\n  event_name: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "event_name": "MeterReadingAdded",\n  "latest": "1.0",\n  "versions": [\n    {\n      "version": "1.0",\n      "released_at": "2025-11-15",\n      "change_summary": "string",\n      "change_notes": "string",\n      "changes": [\n        {\n          "field": "reading",\n          "op": "added",\n          "type_old": "string",\n          "type_new": "string"\n        }\n      ]\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `searchEventHistory`\n\nPaginated history of events\n\n`POST /v1/events/{event_name}:history`\n\n```ts\nconst { data } = await client.searchEventHistory(\n  {\n    event_name: \'example\',\n  },\n  {\n    limit: 10,\n    cursor: {\n      event_time: \'2025-10-31 12:34:56\',\n      event_id: \'evt_1234567890abcdef\'\n    },\n    timestamp: {\n      from: \'2025-10-01T00:00:00Z\',\n      to: \'2025-10-31T23:59:59Z\'\n    },\n    event_id: \'evt_1234567890abcdef\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "results": [\n    {\n      "_org_id": "org_123456",\n      "_event_time": "2024-01-01T12:00:00Z",\n      "_event_id": "01FZ4Z5FZ5FZ5FZ5FZ5FZ5FZ5F",\n      "_event_name": "MeterReading",\n      "_event_version": "1.0",\n      "_event_source": "api",\n      "_trigger_source_type": "api",\n      "_trigger_source": "user_123456",\n      "reading_value": 123.45,\n      "reading_date": "2024-01-01T11:59:00Z",\n      "read_by": "John Doe",\n      "reason": "regular",\n      "direction": "feed-out",\n      "source": "portal",\n      "meter_id": "550e8400-e29b-41d4-a716-446655440000",\n      "counter_id": "660e8400-e29b-41d4-a716-446655440000",\n      "meter_number": "MT123456789",\n      "obis_number": "1-0:1.8.0",\n      "unit": "kWh",\n      "customer_id": "770e8400-e29b-41d4-a716-446655440000",\n      "contract_id": "880e8400-e29b-41d4-a716-446655440000"\n    }\n  ],\n  "next_cursor": {\n    "event_time": "2025-10-31T12:34:56Z",\n    "event_id": "evt_1234567890abcdef"\n  }\n}\n```\n\n</details>\n\n---\n\n### `searchEventHistoryV2`\n\nPaginated history of events with projected/lightweight payload (v2).\n\n`POST /v2/events/{event_name}:history`\n\n```ts\nconst { data } = await client.searchEventHistoryV2(\n  {\n    event_name: \'example\',\n  },\n  {\n    limit: 10,\n    cursor: {\n      event_time: \'2025-10-31 12:34:56\',\n      event_id: \'evt_1234567890abcdef\'\n    },\n    timestamp: {\n      from: \'2025-10-01T00:00:00Z\',\n      to: \'2025-10-31T23:59:59Z\'\n    },\n    event_id: \'evt_1234567890abcdef\',\n    fields: [\'_id\', \'_title\', \'first_name\', \'account\', \'!account.*._files\', \'**._product\']\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "results": [\n    {\n      "_org_id": "string",\n      "_event_time": "1970-01-01T00:00:00.000Z",\n      "_event_id": "string",\n      "_event_name": "string",\n      "_event_version": "1.0",\n      "_event_source": "string",\n      "_trigger_source_type": "api",\n      "_trigger_source": "string",\n      "_ack_id": "string"\n    }\n  ],\n  "next_cursor": {\n    "event_time": "2025-10-31T12:34:56Z",\n    "event_id": "evt_1234567890abcdef"\n  }\n}\n```\n\n</details>\n\n---\n\n### `getHistoricalEvent`\n\nFetch a single historical event by id with full hydration\n\n`GET /v2/events/{event_name}/history/{event_id}`\n\n```ts\nconst { data } = await client.getHistoricalEvent({\n  event_name: \'example\',\n  event_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "_org_id": "org_123456",\n  "_event_time": "2024-01-01T12:00:00Z",\n  "_event_id": "01FZ4Z5FZ5FZ5FZ5FZ5FZ5FZ5F",\n  "_event_name": "MeterReading",\n  "_event_version": "1.0",\n  "_event_source": "api",\n  "_trigger_source_type": "api",\n  "_trigger_source": "user_123456",\n  "reading_value": 123.45,\n  "reading_date": "2024-01-01T11:59:00Z",\n  "read_by": "John Doe",\n  "reason": "regular",\n  "direction": "feed-out",\n  "source": "portal",\n  "meter_id": "550e8400-e29b-41d4-a716-446655440000",\n  "counter_id": "660e8400-e29b-41d4-a716-446655440000",\n  "meter_number": "MT123456789",\n  "obis_number": "1-0:1.8.0",\n  "unit": "kWh",\n  "customer_id": "770e8400-e29b-41d4-a716-446655440000",\n  "contract_id": "880e8400-e29b-41d4-a716-446655440000"\n}\n```\n\n</details>\n\n---\n\n### `triggerEvent`\n\nExplicitly 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`POST /v1/events/{event_name}:trigger`\n\n```ts\nconst { data } = await client.triggerEvent(\n  {\n    event_name: \'example\',\n  },\n  {\n    seed: {\n      entity_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n      node_id: \'ticket\'\n    },\n    _trigger_source_type: \'automation\',\n    _trigger_source: \'execution-id/action-id\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "success": true,\n  "event_id": "string",\n  "event_bridge_event_id": "string"\n}\n```\n\n</details>\n\n---\n\n## Schemas\n\n### `EventConfigBase`\n\nBase properties shared between EventConfig and UpdateEventPayload\n\n```ts\ntype EventConfigBase = {\n  event_name?: string\n  event_title?: string\n  event_description?: string\n  event_version?: string\n  event_status?: "active" | "deprecated" | "draft" | "disabled"\n  event_tags?: string[]\n  schema_fields?: Record<string, {\n    json_schema: object\n    required?: boolean\n    graph_source?: string\n  } | {\n    entity_schema: string\n    required?: boolean\n  } | {\n    items: {\n      entity_id: { ... }\n      filename?: { ... }\n      mime_type?: { ... }\n      size_bytes?: { ... }\n      s3ref?: { ... }\n      version_index: { ... }\n      readable_size?: { ... }\n    }\n    required?: boolean\n  }>\n  entity_graph?: {\n    nodes: Array<{\n      id: { ... }\n      schema: { ... }\n      cardinality?: { ... }\n      fields?: { ... }\n    }>\n    edges: Array<{\n      from: { ... }\n      to: { ... }\n    }>\n  }\n  entity_operation?: {\n    operation: "createEntity" | "updateEntity" | "deleteEntity"[]\n    schema: string[]\n    attribute?: string[]\n    purpose?: string[]\n    purpose_filters?: Array<{\n      id: { ... }\n      display_name: { ... }\n    }>\n  }\n  enabled?: boolean\n  auto_trigger?: boolean\n  automation_trigger?: boolean\n  api_trigger?: boolean\n  automation_trigger_only?: boolean\n  automation_trigger_seed_node?: string\n  event_origin?: "builtin" | "custom"\n  mapping?: {\n    mode: "guided" | "jsonata"\n    jsonata?: string\n  }\n  lineage?: {\n    base_event_name: string\n    base_event_version: string\n  }\n  success_criteria?: Array<{\n    entity_schema: string\n    attribute: string\n  }>\n}\n```\n\n### `EventConfig`\n\nEvent configuration with required fields\n\n```ts\ntype EventConfig = {\n  event_name: string\n  event_title?: string\n  event_description?: string\n  event_version: string\n  event_status?: "active" | "deprecated" | "draft" | "disabled"\n  event_tags?: string[]\n  schema_fields: Record<string, {\n    json_schema: object\n    required?: boolean\n    graph_source?: string\n  } | {\n    entity_schema: string\n    required?: boolean\n  } | {\n    items: {\n      entity_id: { ... }\n      filename?: { ... }\n      mime_type?: { ... }\n      size_bytes?: { ... }\n      s3ref?: { ... }\n      version_index: { ... }\n      readable_size?: { ... }\n    }\n    required?: boolean\n  }>\n  entity_graph?: {\n    nodes: Array<{\n      id: { ... }\n      schema: { ... }\n      cardinality?: { ... }\n      fields?: { ... }\n    }>\n    edges: Array<{\n      from: { ... }\n      to: { ... }\n    }>\n  }\n  entity_operation?: {\n    operation: "createEntity" | "updateEntity" | "deleteEntity"[]\n    schema: string[]\n    attribute?: string[]\n    purpose?: string[]\n    purpose_filters?: Array<{\n      id: { ... }\n      display_name: { ... }\n    }>\n  }\n  enabled?: boolean\n  auto_trigger?: boolean\n  automation_trigger?: boolean\n  api_trigger?: boolean\n  automation_trigger_only?: boolean\n  automation_trigger_seed_node?: string\n  event_origin?: "builtin" | "custom"\n  mapping?: {\n    mode: "guided" | "jsonata"\n    jsonata?: string\n  }\n  lineage?: {\n    base_event_name: string\n    base_event_version: string\n  }\n  success_criteria?: Array<{\n    entity_schema: string\n    attribute: string\n  }>\n}\n```\n\n### `CreateCustomEventPayload`\n\nComplete immutable custom-event v1.0 definition projected from a required entity graph. Publication is a separate conditional action.\n\n```ts\ntype CreateCustomEventPayload = {\n  event_name: string\n  event_title: string\n  event_description?: string\n  event_tags?: string[]\n  schema_fields: Record<string, {\n    json_schema: object\n    required?: boolean\n    graph_source?: string\n  } | {\n    entity_schema: string\n    required?: boolean\n  }>\n  entity_graph: {\n    nodes: Array<{\n      id: { ... }\n      schema: { ... }\n      cardinality?: { ... }\n      fields?: { ... }\n    }>\n    edges: Array<{\n      from: { ... }\n      to: { ... }\n    }>\n  }\n  entity_operation?: {\n    operation: "createEntity" | "updateEntity" | "deleteEntity"[]\n    schema: string[]\n    attribute?: string[]\n    purpose?: string[]\n    purpose_filters?: Array<{\n      id: { ... }\n      display_name: { ... }\n    }>\n  }\n  automation_trigger?: boolean\n  api_trigger?: boolean\n  automation_trigger_only?: boolean\n  automation_trigger_seed_node?: string\n  mapping?: {\n    mode: "guided" | "jsonata"\n    jsonata?: string\n  }\n  lineage?: {\n    base_event_name: string\n    base_event_version: string\n  }\n  example?: Record<string, unknown>\n}\n```\n\n### `EventMapping`\n\nGuided mappings use schema_fields graph_source expressions; raw mode evaluates one JSONata object transform.\n\n```ts\ntype EventMapping = {\n  mode: "guided" | "jsonata"\n  jsonata?: string\n}\n```\n\n### `CustomEventLineage`\n\nOptional catalog lineage to a separately named base event. Built-in inheritance is validated against this exact registered version; its trigger restrictions cannot be removed or replaced. It does not replace the base event.\n\n```ts\ntype CustomEventLineage = {\n  base_event_name: string\n  base_event_version: string\n}\n```\n\n### `PurposeFilterSnapshot`\n\n```ts\ntype PurposeFilterSnapshot = {\n  id: string\n  display_name: string\n}\n```\n\n### `PublishCustomEventPayload`\n\n```ts\ntype PublishCustomEventPayload = {\n  enabled?: boolean\n  auto_trigger?: boolean\n  base_auto_trigger_enabled?: boolean\n}\n```\n\n### `CustomEventVersionDraft`\n\nA pending successor to a published custom event, with the version it would become.\n\n\n```ts\ntype CustomEventVersionDraft = {\n  config: {\n    event_name: string\n    event_title?: string\n    event_description?: string\n    event_version: string\n    event_status?: "active" | "deprecated" | "draft" | "disabled"\n    event_tags?: string[]\n    schema_fields: Record<string, {\n      json_schema: { ... }\n      required?: { ... }\n      graph_source?: { ... }\n    } | {\n      entity_schema: { ... }\n      required?: { ... }\n    } | {\n      items: { ... }\n      required?: { ... }\n    }>\n    entity_graph?: {\n      nodes: { ... }\n      edges: { ... }\n    }\n    entity_operation?: {\n      operation: { ... }\n      schema: { ... }\n      attribute?: { ... }\n      purpose?: { ... }\n      purpose_filters?: { ... }\n    }\n    enabled?: boolean\n    auto_trigger?: boolean\n    automation_trigger?: boolean\n    api_trigger?: boolean\n    automation_trigger_only?: boolean\n    automation_trigger_seed_node?: string\n    event_origin?: "builtin" | "custom"\n    mapping?: {\n      mode: { ... }\n      jsonata?: { ... }\n    }\n    lineage?: {\n      base_event_name: { ... }\n      base_event_version: { ... }\n    }\n    success_criteria?: Array<{\n      entity_schema: { ... }\n      attribute: { ... }\n    }>\n  }\n  change_class: "none" | "minor" | "major" | "blocked"\n  next_version?: string\n  changes: Array<{\n    field: string\n    op: "added" | "removed" | "type-changed"\n    type_old?: string\n    type_new?: string\n  }>\n  remapped_fields: string[]\n  added_nodes: string[]\n  blocked_reason?: string\n}\n```\n\n### `PublishCustomEventVersionPayload`\n\n```ts\ntype PublishCustomEventVersionPayload = {\n  change_summary?: string\n  change_notes?: string\n}\n```\n\n### `ValidationIssue`\n\n```ts\ntype ValidationIssue = {\n  path: string\n  message: string\n}\n```\n\n### `PreviewEventResponse`\n\n```ts\ntype PreviewEventResponse = {\n  payload: Record<string, unknown>\n  errors: Array<{\n    path: string\n    message: string\n  }>\n}\n```\n\n### `UpdateEventPayload`\n\nMutable org activation overlay. Immutable event definition fields are not accepted.\n\n```ts\ntype UpdateEventPayload = {\n  enabled?: boolean\n  auto_trigger?: boolean\n  success_criteria?: Array<{\n    entity_schema: string\n    attribute: string\n  }>\n}\n```\n\n### `PrimitiveField`\n\nA primitive JSON Schema field definition\n\n```ts\ntype PrimitiveField = {\n  json_schema: object\n  required?: boolean\n  graph_source?: string\n}\n```\n\n### `ContextEntity`\n\n```ts\ntype ContextEntity = {\n  entity_schema: string\n  required?: boolean\n}\n```\n\n### `AttachmentField`\n\nA schema field representing file attachments associated with the event.\nPresent in schema_fields for events tagged with "attachment".\n\n\n```ts\ntype AttachmentField = {\n  items: {\n    entity_id: string // uuid\n    filename?: string\n    mime_type?: string\n    size_bytes?: number\n    s3ref?: {\n      bucket: { ... }\n      key: { ... }\n    }\n    version_index: number\n    readable_size?: string\n  }\n  required?: boolean\n}\n```\n\n### `CustomSchemaField`\n\nCustom v1 fields support graph-projected JSON Schema values and context entities; attachment semantics are built-in-only.\n\n```ts\ntype CustomSchemaField = {\n  json_schema: object\n  required?: boolean\n  graph_source?: string\n} | {\n  entity_schema: string\n  required?: boolean\n}\n```\n\n### `SchemaField`\n\n```ts\ntype SchemaField = {\n  json_schema: object\n  required?: boolean\n  graph_source?: string\n} | {\n  entity_schema: string\n  required?: boolean\n} | {\n  items: {\n    entity_id: string // uuid\n    filename?: string\n    mime_type?: string\n    size_bytes?: number\n    s3ref?: {\n      bucket: { ... }\n      key: { ... }\n    }\n    version_index: number\n    readable_size?: string\n  }\n  required?: boolean\n}\n```\n\n### `SuccessCriterion`\n\nA single org-defined success criterion: an entity attribute that must be captured\nfor this event\'s change request to be considered complete.\n\nIdentity is the entity schema plus the attribute name \u2014 mirroring the\nEntityOperationTrigger `schema`/`attribute` vocabulary. On write (PATCH), both\n`attribut\n\n```ts\ntype SuccessCriterion = {\n  entity_schema: string\n  attribute: string\n}\n```\n\n### `CommonEventMetadata`\n\nCommon metadata fields present in all event payloads\n\n```ts\ntype CommonEventMetadata = object\n```\n\n### `EventJsonSchema`\n\nJSON Schema declaring the event payload structure\n\n```ts\ntype EventJsonSchema = object\n```\n\n### `InlineDowngradeStep`\n\nOne step of an event\'s inline `_downgrades` chain. Maps the current-version payload to the previous version via a JSONata expression. Stamped by Event Catalog at publish time; executed by consumers during walk-back, never by EC itself.\n\n```ts\ntype InlineDowngradeStep = {\n  to: string\n  jsonata: string\n}\n```\n\n### `Event`\n\nAn event instance in the event history\n\n```ts\ntype Event = {\n  _org_id: string\n  _event_time: string // date-time\n  _event_id: string\n  _event_name: string\n  _event_version: string\n  _event_source: string\n  _trigger_source_type?: string\n  _trigger_source?: string\n  _ack_id?: string\n  _downgrades?: Array<{\n    to: string\n    jsonata: string\n  }>\n  _automation_chain?: string[]\n}\n```\n\n### `EventSummary`\n\nA lightweight event summary returned by the v2 history endpoint.\n\nIncludes the standard `_*` metadata fields plus a projected subset of the\nevent payload. Hydrated entity objects (values carrying `_schema` or `_id`)\n\u2014 and arrays of such objects \u2014 are reduced to reference stubs\n`{_schema, _id, _title\n\n```ts\ntype EventSummary = {\n  _org_id: string\n  _event_time: string // date-time\n  _event_id: string\n  _event_name: string\n  _event_version: string\n  _event_source: string\n  _trigger_source_type?: string\n  _trigger_source?: string\n  _ack_id?: string\n}\n```\n\n### `GraphDefinition`\n\nEntity graph definition for resolving related entities\n\n```ts\ntype GraphDefinition = {\n  nodes: Array<{\n    id: string\n    schema: string\n    cardinality?: "one" | "many"\n    fields?: object\n  }>\n  edges: Array<{\n    from: string\n    to: string\n  }>\n}\n```\n\n### `GraphNode`\n\nA node in the entity graph\n\n```ts\ntype GraphNode = {\n  id: string\n  schema: string\n  cardinality?: "one" | "many"\n  fields?: object\n}\n```\n\n### `GraphEdge`\n\nAn edge connecting two nodes in the graph\n\n```ts\ntype GraphEdge = {\n  from: string\n  to: string\n}\n```\n\n### `EntityOperationTrigger`\n\nConfiguration for triggering an event based on entity operations.\n\nWhen an entity operation matches the configured criteria, the event will be triggered.\n- On createEntity: the attribute must be present in the entity payload\n- On updateEntity: the attribute must be in diff.added, diff.updated, or di\n\n```ts\ntype EntityOperationTrigger = {\n  operation: "createEntity" | "updateEntity" | "deleteEntity"[]\n  schema: string[]\n  attribute?: string[]\n  purpose?: string[]\n  purpose_filters?: Array<{\n    id: string\n    display_name: string\n  }>\n}\n```\n\n### `SearchOptions`\n\n```ts\ntype SearchOptions = {\n  limit?: number\n  cursor?: {\n    event_time?: string\n    event_id?: string\n  }\n  timestamp?: {\n    from?: string // date-time\n    to?: string // date-time\n  }\n  event_id?: string\n}\n```\n\n### `SearchOptionsV2`\n\nSearch options for the v2 history endpoint.\n\nExtends `SearchOptions` with an optional `fields` projection. When `fields`\nis omitted, the response includes all `_*` metadata plus all scalar payload\nfields (and primitive arrays / empty objects/arrays) after entity stripping.\nWhen `fields` is provided,\n\n```ts\ntype SearchOptionsV2 = {\n  limit?: number\n  cursor?: {\n    event_time?: string\n    event_id?: string\n  }\n  timestamp?: {\n    from?: string // date-time\n    to?: string // date-time\n  }\n  event_id?: string\n  fields?: string[]\n}\n```\n\n### `FieldsParam`\n\nList of entity fields to include or exclude in the response\n\nUse ! to exclude fields, e.g. `!_id` to exclude the `_id` field.\n\nGlobbing and globstart (**) is supported for nested fields.\n\n\n```ts\ntype FieldsParam = string[]\n```\n\n### `TriggerEventPayload`\n\nPayload for explicitly triggering an event via API\n\n```ts\ntype TriggerEventPayload = {\n  seed?: {\n    entity_id: string // uuid\n    node_id: string\n  }\n  fields?: Record<string, unknown>\n  skip_hydration?: string[]\n  _trigger_source_type?: string\n  _trigger_source?: string\n  _automation_chain?: string[]\n}\n```\n\n### `TriggerEventResponse`\n\nResponse from triggering an event\n\n```ts\ntype TriggerEventResponse = {\n  success: boolean\n  event_id: string\n  event_bridge_event_id?: string\n}\n```\n\n### `EventAttachment`\n\nA file attachment associated with an event\n\n```ts\ntype EventAttachment = {\n  entity_id: string // uuid\n  filename?: string\n  mime_type?: string\n  size_bytes?: number\n  s3ref?: {\n    bucket: string\n    key: string\n  }\n  version_index: number\n  readable_size?: string\n}\n```\n\n### `FieldChange`\n\nA field-level change descriptor. Powers the declarative half of the\nversion DSL.\n\n\n```ts\ntype FieldChange = {\n  field: string\n  op: "added" | "removed" | "type-changed"\n  type_old?: string\n  type_new?: string\n}\n```\n\n### `VersionMeta`\n\nOne entry of an event\'s version timeline.\n\n```ts\ntype VersionMeta = {\n  version: string\n  released_at: string\n  change_summary: string\n  change_notes?: string\n  changes: Array<{\n    field: string\n    op: "added" | "removed" | "type-changed"\n    type_old?: string\n    type_new?: string\n  }>\n}\n```\n\n### `EventVersionRegistrySummary`\n\nSummary of an event\'s version timeline returned by\n`GET /v1/events/{event_name}/versions`.\n\n\n```ts\ntype EventVersionRegistrySummary = {\n  event_name: string\n  latest: string\n  versions: Array<{\n    version: string\n    released_at: string\n    change_summary: string\n    change_notes?: string\n    changes: Array<{\n      field: { ... }\n      op: { ... }\n      type_old?: { ... }\n      type_new?: { ... }\n    }>\n  }>\n}\n```\n';
+export {
+  event_catalog_default as default
+};