@automagik/omni 2.260908.2 → 2.260908.4

package/dist/sdk/types.generated.d.ts

@@ -1634,7 +1634,7 @@ export interface paths {
         put?: never;
         /**
          * Register or revise an event schema
-         * @description Register a JSON Schema for an event type. Once registered, the webhook ingress and automation emit_event validate payloads of this type before publishing; invalid payloads are dead-lettered with reason schema_validation_failed. Revising an existing registration must be additive-optional (the evolution rule) — an incompatible change is refused with 409 and must ship as a new versioned event type (e.g. custom.github.push.v2).
+         * @description Register a JSON Schema for an event type. Once registered, the webhook ingress and automation emit_event validate payloads of this type before publishing; invalid payloads are dead-lettered with reason schema_validation_failed. Unregistered types pass through unless the emitter is strict (webhook_sources.strictSchemas, or OMNI_STRICT_EMIT_EVENT_SCHEMAS for emit_event), in which case they are dead-lettered with reason schema_not_registered. Revising an existing registration must be additive-optional (the evolution rule) — an incompatible change is refused with 409 and must ship as a new versioned event type (e.g. custom.github.push.v2).
          */
         post: operations["registerEventSchema"];
         delete?: never;
@@ -4177,12 +4177,20 @@ export interface components {
         };
         WebhookEventTypeMapping: {
             /**
-             * @description Where the semantic event name is read from (only headers for now)
+             * @description Read the semantic event name from a request header
              * @enum {string}
              */
             source: "header";
             /** @description Header carrying the semantic event name (e.g. X-GitHub-Event). 1-200 characters */
             header: string;
+        } | {
+            /**
+             * @description Read the semantic event name from the JSON body (body-first providers like ClickUp, #984)
+             * @enum {string}
+             */
+            source: "body";
+            /** @description Dot-path to the event name in the payload (e.g. "event"); numeric segments index arrays. 1-200 characters */
+            path: string;
         };
         WebhookSource: {
             /**
@@ -4213,19 +4221,29 @@ export interface components {
             /** @description Semantic event-type extraction: a mapped source emits custom.{source}.{event} instead of the collapsed custom.webhook.{source} */
             eventTypeMapping: {
                 /**
-                 * @description Where the semantic event name is read from (only headers for now)
+                 * @description Read the semantic event name from a request header
                  * @enum {string}
                  */
                 source: "header";
                 /** @description Header carrying the semantic event name (e.g. X-GitHub-Event). 1-200 characters */
                 header: string;
-            } | null;
+            } | {
+                /**
+                 * @description Read the semantic event name from the JSON body (body-first providers like ClickUp, #984)
+                 * @enum {string}
+                 */
+                source: "body";
+                /** @description Dot-path to the event name in the payload (e.g. "event"); numeric segments index arrays. 1-200 characters */
+                path: string;
+            } | unknown;
             /** @description Whether a signature secret is stored (secret is write-only) */
             hasSignatureSecret: boolean;
             /** @description Idempotency key derivation template */
             idempotencyKeyTemplate: string;
             /** @description Redeliveries acked without creating a second event */
             totalDuplicates: number;
+            /** @description Strict schema mode: deliveries resolving to an event type with no enabled registered schema are refused and dead-lettered with reason schema_not_registered */
+            strictSchemas: boolean;
             /** @description Whether enabled */
             enabled: boolean;
             /**
@@ -4305,16 +4323,26 @@ export interface components {
             signatureSecret?: string | null;
             /** @description How the delivery-identity idempotency key is derived for this source. Placeholders: {source}, {sha256(body)}, {headers.<name>}, {payload.<dot.path>}. A delivery whose key is already journaled is acked (200, duplicate: true) without creating a second event. Defaults to "{source}:{sha256(body)}". This dedupes provider REDELIVERY, not semantic identity. */
             idempotencyKeyTemplate?: string;
+            /** @description Strict schema mode (RFC #925 G1 policy switch): when true, a delivery resolving to an event type with no enabled registered schema is refused and dead-lettered with reason schema_not_registered (manual retry only) instead of passing through. Defaults to false (opt-in pass-through). Recommended true for NEW sources — they have no legacy emitters to grandfather. */
+            strictSchemas?: boolean;
             /** @description Semantic event-type extraction (e.g. header X-GitHub-Event: push emits custom.{source}.push). Null or absent keeps the legacy collapsed custom.webhook.{source} type for every delivery. */
             eventTypeMapping?: {
                 /**
-                 * @description Where the semantic event name is read from (only headers for now)
+                 * @description Read the semantic event name from a request header
                  * @enum {string}
                  */
                 source: "header";
                 /** @description Header carrying the semantic event name (e.g. X-GitHub-Event). 1-200 characters */
                 header: string;
-            } | null;
+            } | {
+                /**
+                 * @description Read the semantic event name from the JSON body (body-first providers like ClickUp, #984)
+                 * @enum {string}
+                 */
+                source: "body";
+                /** @description Dot-path to the event name in the payload (e.g. "event"); numeric segments index arrays. 1-200 characters */
+                path: string;
+            } | unknown;
             /**
              * @description Whether enabled
              * @default true
@@ -11467,19 +11495,29 @@ export interface operations {
                             /** @description Semantic event-type extraction: a mapped source emits custom.{source}.{event} instead of the collapsed custom.webhook.{source} */
                             eventTypeMapping: {
                                 /**
-                                 * @description Where the semantic event name is read from (only headers for now)
+                                 * @description Read the semantic event name from a request header
                                  * @enum {string}
                                  */
                                 source: "header";
                                 /** @description Header carrying the semantic event name (e.g. X-GitHub-Event). 1-200 characters */
                                 header: string;
-                            } | null;
+                            } | {
+                                /**
+                                 * @description Read the semantic event name from the JSON body (body-first providers like ClickUp, #984)
+                                 * @enum {string}
+                                 */
+                                source: "body";
+                                /** @description Dot-path to the event name in the payload (e.g. "event"); numeric segments index arrays. 1-200 characters */
+                                path: string;
+                            } | unknown;
                             /** @description Whether a signature secret is stored (secret is write-only) */
                             hasSignatureSecret: boolean;
                             /** @description Idempotency key derivation template */
                             idempotencyKeyTemplate: string;
                             /** @description Redeliveries acked without creating a second event */
                             totalDuplicates: number;
+                            /** @description Strict schema mode: deliveries resolving to an event type with no enabled registered schema are refused and dead-lettered with reason schema_not_registered */
+                            strictSchemas: boolean;
                             /** @description Whether enabled */
                             enabled: boolean;
                             /**
@@ -11573,16 +11611,26 @@ export interface operations {
                     signatureSecret?: string | null;
                     /** @description How the delivery-identity idempotency key is derived for this source. Placeholders: {source}, {sha256(body)}, {headers.<name>}, {payload.<dot.path>}. A delivery whose key is already journaled is acked (200, duplicate: true) without creating a second event. Defaults to "{source}:{sha256(body)}". This dedupes provider REDELIVERY, not semantic identity. */
                     idempotencyKeyTemplate?: string;
+                    /** @description Strict schema mode (RFC #925 G1 policy switch): when true, a delivery resolving to an event type with no enabled registered schema is refused and dead-lettered with reason schema_not_registered (manual retry only) instead of passing through. Defaults to false (opt-in pass-through). Recommended true for NEW sources — they have no legacy emitters to grandfather. */
+                    strictSchemas?: boolean;
                     /** @description Semantic event-type extraction (e.g. header X-GitHub-Event: push emits custom.{source}.push). Null or absent keeps the legacy collapsed custom.webhook.{source} type for every delivery. */
                     eventTypeMapping?: {
                         /**
-                         * @description Where the semantic event name is read from (only headers for now)
+                         * @description Read the semantic event name from a request header
                          * @enum {string}
                          */
                         source: "header";
                         /** @description Header carrying the semantic event name (e.g. X-GitHub-Event). 1-200 characters */
                         header: string;
-                    } | null;
+                    } | {
+                        /**
+                         * @description Read the semantic event name from the JSON body (body-first providers like ClickUp, #984)
+                         * @enum {string}
+                         */
+                        source: "body";
+                        /** @description Dot-path to the event name in the payload (e.g. "event"); numeric segments index arrays. 1-200 characters */
+                        path: string;
+                    } | unknown;
                     /**
                      * @description Whether enabled
                      * @default true
@@ -11640,19 +11688,29 @@ export interface operations {
                             /** @description Semantic event-type extraction: a mapped source emits custom.{source}.{event} instead of the collapsed custom.webhook.{source} */
                             eventTypeMapping: {
                                 /**
-                                 * @description Where the semantic event name is read from (only headers for now)
+                                 * @description Read the semantic event name from a request header
                                  * @enum {string}
                                  */
                                 source: "header";
                                 /** @description Header carrying the semantic event name (e.g. X-GitHub-Event). 1-200 characters */
                                 header: string;
-                            } | null;
+                            } | {
+                                /**
+                                 * @description Read the semantic event name from the JSON body (body-first providers like ClickUp, #984)
+                                 * @enum {string}
+                                 */
+                                source: "body";
+                                /** @description Dot-path to the event name in the payload (e.g. "event"); numeric segments index arrays. 1-200 characters */
+                                path: string;
+                            } | unknown;
                             /** @description Whether a signature secret is stored (secret is write-only) */
                             hasSignatureSecret: boolean;
                             /** @description Idempotency key derivation template */
                             idempotencyKeyTemplate: string;
                             /** @description Redeliveries acked without creating a second event */
                             totalDuplicates: number;
+                            /** @description Strict schema mode: deliveries resolving to an event type with no enabled registered schema are refused and dead-lettered with reason schema_not_registered */
+                            strictSchemas: boolean;
                             /** @description Whether enabled */
                             enabled: boolean;
                             /**
@@ -11780,19 +11838,29 @@ export interface operations {
                             /** @description Semantic event-type extraction: a mapped source emits custom.{source}.{event} instead of the collapsed custom.webhook.{source} */
                             eventTypeMapping: {
                                 /**
-                                 * @description Where the semantic event name is read from (only headers for now)
+                                 * @description Read the semantic event name from a request header
                                  * @enum {string}
                                  */
                                 source: "header";
                                 /** @description Header carrying the semantic event name (e.g. X-GitHub-Event). 1-200 characters */
                                 header: string;
-                            } | null;
+                            } | {
+                                /**
+                                 * @description Read the semantic event name from the JSON body (body-first providers like ClickUp, #984)
+                                 * @enum {string}
+                                 */
+                                source: "body";
+                                /** @description Dot-path to the event name in the payload (e.g. "event"); numeric segments index arrays. 1-200 characters */
+                                path: string;
+                            } | unknown;
                             /** @description Whether a signature secret is stored (secret is write-only) */
                             hasSignatureSecret: boolean;
                             /** @description Idempotency key derivation template */
                             idempotencyKeyTemplate: string;
                             /** @description Redeliveries acked without creating a second event */
                             totalDuplicates: number;
+                            /** @description Strict schema mode: deliveries resolving to an event type with no enabled registered schema are refused and dead-lettered with reason schema_not_registered */
+                            strictSchemas: boolean;
                             /** @description Whether enabled */
                             enabled: boolean;
                             /**
@@ -11957,16 +12025,26 @@ export interface operations {
                     signatureSecret?: string | null;
                     /** @description How the delivery-identity idempotency key is derived for this source. Placeholders: {source}, {sha256(body)}, {headers.<name>}, {payload.<dot.path>}. A delivery whose key is already journaled is acked (200, duplicate: true) without creating a second event. Defaults to "{source}:{sha256(body)}". This dedupes provider REDELIVERY, not semantic identity. */
                     idempotencyKeyTemplate?: string;
+                    /** @description Strict schema mode (RFC #925 G1 policy switch): when true, a delivery resolving to an event type with no enabled registered schema is refused and dead-lettered with reason schema_not_registered (manual retry only) instead of passing through. Defaults to false (opt-in pass-through). Recommended true for NEW sources — they have no legacy emitters to grandfather. */
+                    strictSchemas?: boolean;
                     /** @description Semantic event-type extraction (e.g. header X-GitHub-Event: push emits custom.{source}.push). Null or absent keeps the legacy collapsed custom.webhook.{source} type for every delivery. */
                     eventTypeMapping?: {
                         /**
-                         * @description Where the semantic event name is read from (only headers for now)
+                         * @description Read the semantic event name from a request header
                          * @enum {string}
                          */
                         source: "header";
                         /** @description Header carrying the semantic event name (e.g. X-GitHub-Event). 1-200 characters */
                         header: string;
-                    } | null;
+                    } | {
+                        /**
+                         * @description Read the semantic event name from the JSON body (body-first providers like ClickUp, #984)
+                         * @enum {string}
+                         */
+                        source: "body";
+                        /** @description Dot-path to the event name in the payload (e.g. "event"); numeric segments index arrays. 1-200 characters */
+                        path: string;
+                    } | unknown;
                     /**
                      * @description Whether enabled
                      * @default true
@@ -12024,19 +12102,29 @@ export interface operations {
                             /** @description Semantic event-type extraction: a mapped source emits custom.{source}.{event} instead of the collapsed custom.webhook.{source} */
                             eventTypeMapping: {
                                 /**
-                                 * @description Where the semantic event name is read from (only headers for now)
+                                 * @description Read the semantic event name from a request header
                                  * @enum {string}
                                  */
                                 source: "header";
                                 /** @description Header carrying the semantic event name (e.g. X-GitHub-Event). 1-200 characters */
                                 header: string;
-                            } | null;
+                            } | {
+                                /**
+                                 * @description Read the semantic event name from the JSON body (body-first providers like ClickUp, #984)
+                                 * @enum {string}
+                                 */
+                                source: "body";
+                                /** @description Dot-path to the event name in the payload (e.g. "event"); numeric segments index arrays. 1-200 characters */
+                                path: string;
+                            } | unknown;
                             /** @description Whether a signature secret is stored (secret is write-only) */
                             hasSignatureSecret: boolean;
                             /** @description Idempotency key derivation template */
                             idempotencyKeyTemplate: string;
                             /** @description Redeliveries acked without creating a second event */
                             totalDuplicates: number;
+                            /** @description Strict schema mode: deliveries resolving to an event type with no enabled registered schema are refused and dead-lettered with reason schema_not_registered */
+                            strictSchemas: boolean;
                             /** @description Whether enabled */
                             enabled: boolean;
                             /**