@whooshbang/contracts 2.3.0 → 2.4.0

package/fixtures/interaction-machine-v1/scenarios/poll-uncommitted-cursor-rejected.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "2.3.0",
+  "contract_version": "2.4.0",
   "id": "poll-uncommitted-cursor-rejected",
   "category": "machine_poll",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/project-credential-machine-endpoint-denied.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "2.3.0",
+  "contract_version": "2.4.0",
   "id": "project-credential-machine-endpoint-denied",
   "category": "machine_authorization",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/quarantine-integrity-rejected.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "2.3.0",
+  "contract_version": "2.4.0",
   "id": "quarantine-integrity-rejected",
   "category": "quarantine",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/quarantine-signature-rejected.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "2.3.0",
+  "contract_version": "2.4.0",
   "id": "quarantine-signature-rejected",
   "category": "quarantine",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/quarantine-valid.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "2.3.0",
+  "contract_version": "2.4.0",
   "id": "quarantine-valid",
   "category": "quarantine",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/revoked-machine-credential.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "2.3.0",
+  "contract_version": "2.4.0",
   "id": "revoked-machine-credential",
   "category": "machine_authorization",
   "given": {

package/fixtures/recipient-experience-v1/scenarios/membership-broadcast-snapshot.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "2.3.0",
+  "contract_version": "2.4.0",
   "id": "membership-broadcast-snapshot",
   "category": "membership_broadcast",
   "given": {

package/fixtures/recipient-experience-v1/scenarios/preferred-binding-resolution.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "2.3.0",
+  "contract_version": "2.4.0",
   "id": "preferred-binding-resolution",
   "category": "preference_resolution",
   "given": {

package/fixtures/recipient-experience-v1/scenarios/recipient-session-security.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "2.3.0",
+  "contract_version": "2.4.0",
   "id": "recipient-session-security",
   "category": "recipient_security",
   "given": {

package/fixtures/recipient-experience-v1/scenarios/subscriber-initial-groups-transaction.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "2.3.0",
+  "contract_version": "2.4.0",
   "id": "subscriber-initial-groups-transaction",
   "category": "subscriber_groups",
   "given": {

package/openapi/generated/whooshbang-v1.bundle.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.1",
   "info": {
     "title": "WhooshBang API",
-    "version": "2.3.0",
+    "version": "2.4.0",
     "description": "The V1 contract for human organization/project administration, project-scoped\nsubscription links, and asynchronous text messages. A Clerk session selects\none organization for administration. A project credential selects one organization,\nproject, and `test` or `live` environment for product operations; request\nbodies cannot override either authenticated scope.\n\nA person's OAuth grant selects one organization and carries scopes, but no\nproject. It names the project and environment it acts in through the URL\npath, on the environment-scoped form of each operation; the service checks\nthat path against the granting person's membership on every call. The flat\nforms remain credential-only and are unchanged.\n\nResource identifiers are opaque and are not authorization. Reads outside the\ncredential scope return the same `404` shape as absent resources. Provider\ncredentials, raw Telegram identity, and protected provider responses are\nnever part of this API.\n",
     "termsOfService": "https://flowxo.com/terms",
     "contact": {
@@ -97,6 +97,7 @@
     "/v1/projects/{project_id}/environments/{environment_id}/whoami": {
       "get": {
         "operationId": "whoAmI",
+        "x-notification-scopes": ["notifications:self", "notifications:team"],
         "summary": "Identify the authenticated caller",
         "description": "Personal login identifies me without a recipient question. Shared or service credentials report their actual principal and require an explicit recipient. No account owner or credential creator is inferred.",
         "tags": ["Operators"],
@@ -105,6 +106,8 @@
           { "bearerCredential": [] },
           { "bearerOrganizationCredential": [] },
           { "bearerGrant": ["messages:read"] },
+          { "bearerGrant": ["notifications:self"] },
+          { "bearerGrant": ["notifications:team"] },
           { "machineCredential": [] }
         ],
         "x-required-scopes": ["messages:read"],
@@ -129,13 +132,15 @@
     "/v1/projects/{project_id}/environments/{environment_id}/operators": {
       "get": {
         "operationId": "listOperators",
+        "x-notification-scopes": ["notifications:team"],
         "summary": "listOperators",
         "description": "Membership-derived operator messaging. Only the authenticated human can manage personal preferences.",
         "tags": ["Operators"],
         "security": [
           { "clerkSession": [] },
           { "bearerCredential": [] },
-          { "bearerGrant": ["messages:read"] }
+          { "bearerGrant": ["messages:read"] },
+          { "bearerGrant": ["notifications:team"] }
         ],
         "x-required-scopes": ["messages:read"],
         "parameters": [
@@ -162,13 +167,15 @@
     "/v1/projects/{project_id}/environments/{environment_id}/operators/resolve": {
       "get": {
         "operationId": "resolveOperator",
+        "x-notification-scopes": ["notifications:team"],
         "summary": "resolveOperator",
         "description": "Membership-derived operator messaging. Only the authenticated human can manage personal preferences.",
         "tags": ["Operators"],
         "security": [
           { "clerkSession": [] },
           { "bearerCredential": [] },
-          { "bearerGrant": ["messages:read"] }
+          { "bearerGrant": ["messages:read"] },
+          { "bearerGrant": ["notifications:team"] }
         ],
         "x-required-scopes": ["messages:read"],
         "parameters": [
@@ -198,6 +205,7 @@
     "/v1/projects/{project_id}/environments/{environment_id}/operator-messages": {
       "post": {
         "operationId": "sendOperatorMessage",
+        "x-notification-scopes": ["notifications:self", "notifications:team"],
         "summary": "sendOperatorMessage",
         "description": "Message a current teammate by name or operator ID. Personal callers may omit recipient or use me. Shared credentials must name a recipient. Runtime machine credentials report recipient_required for omitted or me; named operator sends are forbidden because runtime authority remains subscriber-bound.",
         "tags": ["Operators"],
@@ -206,7 +214,9 @@
           { "bearerCredential": [] },
           { "bearerOrganizationCredential": [] },
           { "machineCredential": [] },
-          { "bearerGrant": ["messages:write"] }
+          { "bearerGrant": ["messages:write"] },
+          { "bearerGrant": ["notifications:self"] },
+          { "bearerGrant": ["notifications:team"] }
         ],
         "x-required-scopes": ["messages:write"],
         "parameters": [
@@ -243,13 +253,15 @@
     "/v1/projects/{project_id}/environments/{environment_id}/operators/broadcasts": {
       "post": {
         "operationId": "broadcastOperators",
+        "x-notification-scopes": ["notifications:team"],
         "summary": "broadcastOperators",
         "description": "Membership-derived operator messaging. Only the authenticated human can manage personal preferences.",
         "tags": ["Operators"],
         "security": [
           { "clerkSession": [] },
           { "bearerCredential": [] },
-          { "bearerGrant": ["messages:write"] }
+          { "bearerGrant": ["messages:write"] },
+          { "bearerGrant": ["notifications:team"] }
         ],
         "x-required-scopes": ["messages:write"],
         "parameters": [
@@ -284,13 +296,15 @@
     "/v1/projects/{project_id}/environments/{environment_id}/operators/broadcasts/{broadcast_id}": {
       "get": {
         "operationId": "getOperatorBroadcast",
+        "x-notification-scopes": ["notifications:team"],
         "summary": "getOperatorBroadcast",
         "description": "Membership-derived operator messaging. Only the authenticated human can manage personal preferences.",
         "tags": ["Operators"],
         "security": [
           { "clerkSession": [] },
           { "bearerCredential": [] },
-          { "bearerGrant": ["messages:read"] }
+          { "bearerGrant": ["messages:read"] },
+          { "bearerGrant": ["notifications:team"] }
         ],
         "x-required-scopes": ["messages:read"],
         "parameters": [
@@ -320,13 +334,16 @@
     "/v1/projects/{project_id}/environments/{environment_id}/notification-preferences": {
       "get": {
         "operationId": "getOperatorPreferences",
+        "x-notification-scopes": ["notifications:self", "notifications:team"],
         "summary": "getOperatorPreferences",
         "description": "Membership-derived operator messaging. Only the authenticated human can manage personal preferences.",
         "tags": ["Operators"],
         "security": [
           { "clerkSession": [] },
           { "bearerCredential": [] },
-          { "bearerGrant": ["messages:read"] }
+          { "bearerGrant": ["messages:read"] },
+          { "bearerGrant": ["notifications:self"] },
+          { "bearerGrant": ["notifications:team"] }
         ],
         "x-required-scopes": ["messages:read"],
         "parameters": [
@@ -350,13 +367,16 @@
     "/v1/projects/{project_id}/environments/{environment_id}/notification-preferences/preferred-binding": {
       "put": {
         "operationId": "setOperatorPreferredBinding",
+        "x-notification-scopes": ["notifications:self", "notifications:team"],
         "summary": "setOperatorPreferredBinding",
         "description": "Membership-derived operator messaging. Only the authenticated human can manage personal preferences.",
         "tags": ["Operators"],
         "security": [
           { "clerkSession": [] },
           { "bearerCredential": [] },
-          { "bearerGrant": ["messages:write"] }
+          { "bearerGrant": ["messages:write"] },
+          { "bearerGrant": ["notifications:self"] },
+          { "bearerGrant": ["notifications:team"] }
         ],
         "x-required-scopes": ["messages:write"],
         "parameters": [
@@ -390,13 +410,16 @@
     "/v1/projects/{project_id}/environments/{environment_id}/notification-preferences/connect": {
       "post": {
         "operationId": "connectOperatorChannel",
+        "x-notification-scopes": ["notifications:self", "notifications:team"],
         "summary": "connectOperatorChannel",
         "description": "Membership-derived operator messaging. Only the authenticated human can manage personal preferences.",
         "tags": ["Operators"],
         "security": [
           { "clerkSession": [] },
           { "bearerCredential": [] },
-          { "bearerGrant": ["messages:write"] }
+          { "bearerGrant": ["messages:write"] },
+          { "bearerGrant": ["notifications:self"] },
+          { "bearerGrant": ["notifications:team"] }
         ],
         "x-required-scopes": ["messages:write"],
         "parameters": [
@@ -2190,12 +2213,15 @@
     "/v1/projects": {
       "get": {
         "operationId": "listProjects",
+        "x-notification-scopes": ["notifications:self", "notifications:team"],
         "summary": "List projects in the current organization",
         "description": "Returns only projects owned by the organization selected by the verified\nClerk organization session. Every project includes its complete test/live\nenvironment and default-notifier bootstrap.\n",
         "tags": ["Projects"],
         "security": [
           { "clerkSession": [] },
           { "bearerGrant": [] },
+          { "bearerGrant": ["notifications:self"] },
+          { "bearerGrant": ["notifications:team"] },
           { "bearerOrganizationCredential": [] }
         ],
         "x-required-scopes": ["projects:read"],
@@ -2379,12 +2405,15 @@
       "parameters": [{ "$ref": "#/components/parameters/ProjectId" }],
       "get": {
         "operationId": "getProject",
+        "x-notification-scopes": ["notifications:self", "notifications:team"],
         "summary": "Read one project in the current organization",
         "description": "Returns the complete project bootstrap. An absent project and a project\noutside the authenticated organization use the same non-enumerating `404`.\n",
         "tags": ["Projects"],
         "security": [
           { "clerkSession": [] },
           { "bearerGrant": [] },
+          { "bearerGrant": ["notifications:self"] },
+          { "bearerGrant": ["notifications:team"] },
           { "bearerOrganizationCredential": [] }
         ],
         "x-required-scopes": ["projects:read"],
@@ -20387,7 +20416,7 @@
       "provider-capabilities-v1.schema": {
         "$schema": "https://json-schema.org/draft/2020-12/schema",
         "$id": "https://whooshbang.flowxo.com/schemas/provider-capabilities-v1.schema.json",
-        "x-contract-version": "2.3.0",
+        "x-contract-version": "2.4.0",
         "title": "ProviderCapabilitiesV1",
         "description": "Provider-neutral, renderer-facing delivery and interaction capabilities with explicit degradation.",
         "type": "object",
@@ -21168,5 +21197,5 @@
       }
     }
   },
-  "x-contract-version": "2.3.0"
+  "x-contract-version": "2.4.0"
 }

package/openapi/whooshbang-v1.yaml

@@ -1,10 +1,10 @@
 openapi: 3.1.1
 jsonSchemaDialect: https://json-schema.org/draft/2020-12/schema
 # whooshbang:public-origin production api https://api.whooshbang.com
-x-contract-version: 2.3.0
+x-contract-version: 2.4.0
 info:
   title: WhooshBang API
-  version: 2.3.0
+  version: 2.4.0
   description: |
     The V1 contract for human organization/project administration, project-scoped
     subscription links, and asynchronous text messages. A Clerk session selects
@@ -75,6 +75,7 @@ paths:
   /v1/projects/{project_id}/environments/{environment_id}/whoami:
     get:
       operationId: whoAmI
+      x-notification-scopes: [notifications:self, notifications:team]
       summary: Identify the authenticated caller
       description: Personal login identifies me without a recipient question. Shared or service credentials report their actual principal and require an explicit recipient. No account owner or credential creator is inferred.
       tags: [Operators]
@@ -83,6 +84,8 @@ paths:
         - bearerCredential: []
         - bearerOrganizationCredential: []
         - bearerGrant: [messages:read]
+        - bearerGrant: [notifications:self]
+        - bearerGrant: [notifications:team]
         - machineCredential: []
       x-required-scopes: [messages:read]
       parameters:
@@ -102,6 +105,7 @@ paths:
   /v1/projects/{project_id}/environments/{environment_id}/operators:
     get:
       operationId: listOperators
+      x-notification-scopes: [notifications:team]
       summary: listOperators
       description: Membership-derived operator messaging. Only the authenticated human can manage personal preferences.
       tags: [Operators]
@@ -109,6 +113,7 @@ paths:
         - clerkSession: []
         - bearerCredential: []
         - bearerGrant: [messages:read]
+        - bearerGrant: [notifications:team]
       x-required-scopes: [messages:read]
       parameters:
         - $ref: "#/components/parameters/ProjectId"
@@ -130,6 +135,7 @@ paths:
   /v1/projects/{project_id}/environments/{environment_id}/operators/resolve:
     get:
       operationId: resolveOperator
+      x-notification-scopes: [notifications:team]
       summary: resolveOperator
       description: Membership-derived operator messaging. Only the authenticated human can manage personal preferences.
       tags: [Operators]
@@ -137,6 +143,7 @@ paths:
         - clerkSession: []
         - bearerCredential: []
         - bearerGrant: [messages:read]
+        - bearerGrant: [notifications:team]
       x-required-scopes: [messages:read]
       parameters:
         - $ref: "#/components/parameters/ProjectId"
@@ -159,6 +166,7 @@ paths:
   /v1/projects/{project_id}/environments/{environment_id}/operator-messages:
     post:
       operationId: sendOperatorMessage
+      x-notification-scopes: [notifications:self, notifications:team]
       summary: sendOperatorMessage
       description: Message a current teammate by name or operator ID. Personal callers may omit recipient or use me. Shared credentials must name a recipient. Runtime machine credentials report recipient_required for omitted or me; named operator sends are forbidden because runtime authority remains subscriber-bound.
       tags: [Operators]
@@ -168,6 +176,8 @@ paths:
         - bearerOrganizationCredential: []
         - machineCredential: []
         - bearerGrant: [messages:write]
+        - bearerGrant: [notifications:self]
+        - bearerGrant: [notifications:team]
       x-required-scopes: [messages:write]
       parameters:
         - $ref: "#/components/parameters/ProjectId"
@@ -193,6 +203,7 @@ paths:
   /v1/projects/{project_id}/environments/{environment_id}/operators/broadcasts:
     post:
       operationId: broadcastOperators
+      x-notification-scopes: [notifications:team]
       summary: broadcastOperators
       description: Membership-derived operator messaging. Only the authenticated human can manage personal preferences.
       tags: [Operators]
@@ -200,6 +211,7 @@ paths:
         - clerkSession: []
         - bearerCredential: []
         - bearerGrant: [messages:write]
+        - bearerGrant: [notifications:team]
       x-required-scopes: [messages:write]
       parameters:
         - $ref: "#/components/parameters/ProjectId"
@@ -225,6 +237,7 @@ paths:
   /v1/projects/{project_id}/environments/{environment_id}/operators/broadcasts/{broadcast_id}:
     get:
       operationId: getOperatorBroadcast
+      x-notification-scopes: [notifications:team]
       summary: getOperatorBroadcast
       description: Membership-derived operator messaging. Only the authenticated human can manage personal preferences.
       tags: [Operators]
@@ -232,6 +245,7 @@ paths:
         - clerkSession: []
         - bearerCredential: []
         - bearerGrant: [messages:read]
+        - bearerGrant: [notifications:team]
       x-required-scopes: [messages:read]
       parameters:
         - $ref: "#/components/parameters/ProjectId"
@@ -254,6 +268,7 @@ paths:
   /v1/projects/{project_id}/environments/{environment_id}/notification-preferences:
     get:
       operationId: getOperatorPreferences
+      x-notification-scopes: [notifications:self, notifications:team]
       summary: getOperatorPreferences
       description: Membership-derived operator messaging. Only the authenticated human can manage personal preferences.
       tags: [Operators]
@@ -261,6 +276,8 @@ paths:
         - clerkSession: []
         - bearerCredential: []
         - bearerGrant: [messages:read]
+        - bearerGrant: [notifications:self]
+        - bearerGrant: [notifications:team]
       x-required-scopes: [messages:read]
       parameters:
         - $ref: "#/components/parameters/ProjectId"
@@ -279,6 +296,7 @@ paths:
   /v1/projects/{project_id}/environments/{environment_id}/notification-preferences/preferred-binding:
     put:
       operationId: setOperatorPreferredBinding
+      x-notification-scopes: [notifications:self, notifications:team]
       summary: setOperatorPreferredBinding
       description: Membership-derived operator messaging. Only the authenticated human can manage personal preferences.
       tags: [Operators]
@@ -286,6 +304,8 @@ paths:
         - clerkSession: []
         - bearerCredential: []
         - bearerGrant: [messages:write]
+        - bearerGrant: [notifications:self]
+        - bearerGrant: [notifications:team]
       x-required-scopes: [messages:write]
       parameters:
         - $ref: "#/components/parameters/ProjectId"
@@ -310,6 +330,7 @@ paths:
   /v1/projects/{project_id}/environments/{environment_id}/notification-preferences/connect:
     post:
       operationId: connectOperatorChannel
+      x-notification-scopes: [notifications:self, notifications:team]
       summary: connectOperatorChannel
       description: Membership-derived operator messaging. Only the authenticated human can manage personal preferences.
       tags: [Operators]
@@ -317,6 +338,8 @@ paths:
         - clerkSession: []
         - bearerCredential: []
         - bearerGrant: [messages:write]
+        - bearerGrant: [notifications:self]
+        - bearerGrant: [notifications:team]
       x-required-scopes: [messages:write]
       parameters:
         - $ref: "#/components/parameters/ProjectId"
@@ -1961,6 +1984,7 @@ paths:
   /v1/projects:
     get:
       operationId: listProjects
+      x-notification-scopes: [notifications:self, notifications:team]
       summary: List projects in the current organization
       description: |
         Returns only projects owned by the organization selected by the verified
@@ -1971,6 +1995,8 @@ paths:
       security:
         - clerkSession: []
         - bearerGrant: []
+        - bearerGrant: [notifications:self]
+        - bearerGrant: [notifications:team]
         - bearerOrganizationCredential: []
       x-required-scopes:
         - projects:read
@@ -2064,6 +2090,7 @@ paths:
       - $ref: "#/components/parameters/ProjectId"
     get:
       operationId: getProject
+      x-notification-scopes: [notifications:self, notifications:team]
       summary: Read one project in the current organization
       description: |
         Returns the complete project bootstrap. An absent project and a project
@@ -2073,6 +2100,8 @@ paths:
       security:
         - clerkSession: []
         - bearerGrant: []
+        - bearerGrant: [notifications:self]
+        - bearerGrant: [notifications:team]
         - bearerOrganizationCredential: []
       x-required-scopes:
         - projects:read

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whooshbang/contracts",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "description": "Versioned public contracts for WhooshBang",
   "private": false,
   "license": "MIT",

package/schemas/core-scenario.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://whooshbang.flowxo.com/schemas/core-scenario.schema.json",
-  "x-contract-version": "2.3.0",
+  "x-contract-version": "2.4.0",
   "title": "CoreContractScenario",
   "description": "A deterministic C0-02 semantic, state, idempotency, or isolation scenario.",
   "type": "object",

package/schemas/events/agent-binding-degraded-v1.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://whooshbang.flowxo.com/schemas/events/agent-binding-degraded-v1.schema.json",
-  "x-contract-version": "2.3.0",
+  "x-contract-version": "2.4.0",
   "title": "AgentBindingDegradedEventV1",
   "description": "An agent binding entered a provider-neutral degraded state.",
   "$ref": "whooshbang-event-v1.schema.json#/$defs/AgentBindingDegradedEvent"

package/schemas/events/interaction-expired-v1.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://whooshbang.flowxo.com/schemas/events/interaction-expired-v1.schema.json",
-  "x-contract-version": "2.3.0",
+  "x-contract-version": "2.4.0",
   "title": "InteractionExpiredEventV1",
   "description": "An interaction reached its terminal expiry without a valid answer.",
   "$ref": "whooshbang-event-v1.schema.json#/$defs/InteractionExpiredEvent"

package/schemas/events/interaction-received-v1.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://whooshbang.flowxo.com/schemas/events/interaction-received-v1.schema.json",
-  "x-contract-version": "2.3.0",
+  "x-contract-version": "2.4.0",
   "title": "InteractionReceivedEventV1",
   "description": "One authenticated, provider-neutral interaction answer was received.",
   "$ref": "whooshbang-event-v1.schema.json#/$defs/InteractionReceivedEvent"

package/schemas/events/message-delivered-v1.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://whooshbang.flowxo.com/schemas/events/message-delivered-v1.schema.json",
-  "x-contract-version": "2.3.0",
+  "x-contract-version": "2.4.0",
   "title": "MessageDeliveredEventV1",
   "description": "A provider supplied trustworthy evidence that a message was delivered.",
   "$ref": "whooshbang-event-v1.schema.json#/$defs/MessageDeliveredEvent"

package/schemas/events/message-expired-v1.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://whooshbang.flowxo.com/schemas/events/message-expired-v1.schema.json",
-  "x-contract-version": "2.3.0",
+  "x-contract-version": "2.4.0",
   "title": "MessageExpiredEventV1",
   "description": "A message expired before reaching a later delivery state.",
   "$ref": "whooshbang-event-v1.schema.json#/$defs/MessageExpiredEvent"

package/schemas/events/message-failed-v1.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://whooshbang.flowxo.com/schemas/events/message-failed-v1.schema.json",
-  "x-contract-version": "2.3.0",
+  "x-contract-version": "2.4.0",
   "title": "MessageFailedEventV1",
   "description": "A message reached a classified terminal failure.",
   "$ref": "whooshbang-event-v1.schema.json#/$defs/MessageFailedEvent"

package/schemas/events/message-provider-accepted-v1.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://whooshbang.flowxo.com/schemas/events/message-provider-accepted-v1.schema.json",
-  "x-contract-version": "2.3.0",
+  "x-contract-version": "2.4.0",
   "title": "MessageProviderAcceptedEventV1",
   "description": "The provider accepted a message without implying delivery.",
   "$ref": "whooshbang-event-v1.schema.json#/$defs/MessageProviderAcceptedEvent"

package/schemas/events/subscription-activated-v1.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://whooshbang.flowxo.com/schemas/events/subscription-activated-v1.schema.json",
-  "x-contract-version": "2.3.0",
+  "x-contract-version": "2.4.0",
   "title": "SubscriptionActivatedEventV1",
   "description": "A subscription became active with a safe public channel binding.",
   "$ref": "whooshbang-event-v1.schema.json#/$defs/SubscriptionActivatedEvent"

package/schemas/events/subscription-revoked-v1.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://whooshbang.flowxo.com/schemas/events/subscription-revoked-v1.schema.json",
-  "x-contract-version": "2.3.0",
+  "x-contract-version": "2.4.0",
   "title": "SubscriptionRevokedEventV1",
   "description": "A subscription and its safe public channel binding were revoked.",
   "$ref": "whooshbang-event-v1.schema.json#/$defs/SubscriptionRevokedEvent"

package/schemas/events/whooshbang-event-v1.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://whooshbang.flowxo.com/schemas/events/whooshbang-event-v1.schema.json",
-  "x-contract-version": "2.3.0",
+  "x-contract-version": "2.4.0",
   "title": "WhooshBangEventV1ContractDocument",
   "description": "Strict public customer-event envelope and initial WhooshBang event union.",
   "oneOf": [

package/schemas/fixture-index.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://whooshbang.flowxo.com/schemas/fixture-index.schema.json",
-  "x-contract-version": "2.3.0",
+  "x-contract-version": "2.4.0",
   "title": "CoreFixtureIndex",
   "description": "The machine-readable index of deterministic C0-02 through C0-04 golden fixtures.",
   "type": "object",

package/schemas/interaction-machine-scenario.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://whooshbang.flowxo.com/schemas/interaction-machine-scenario.schema.json",
-  "x-contract-version": "2.3.0",
+  "x-contract-version": "2.4.0",
   "title": "InteractionMachineScenario",
   "description": "A deterministic C0-03 interaction, credential, authorization, polling, acknowledgement, or quarantine scenario.",
   "type": "object",

package/schemas/interaction-v1.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://whooshbang.flowxo.com/schemas/interaction-v1.schema.json",
-  "x-contract-version": "2.3.0",
+  "x-contract-version": "2.4.0",
   "title": "InteractionV1ContractDocument",
   "description": "Provider-neutral confirm, single-select, input, lifecycle, callback-token, and authenticated answer-event contracts.",
   "$defs": {