@whooshbang/contracts 2.2.0 → 2.4.0

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.2.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.2.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.2.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.2.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.2.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.2.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.2.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.2.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.2.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.2.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.2.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.2.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.2.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,23 +1,9 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://whooshbang.flowxo.com/schemas/interaction-v1.schema.json",
-  "x-contract-version": "2.2.0",
+  "x-contract-version": "2.4.0",
   "title": "InteractionV1ContractDocument",
   "description": "Provider-neutral confirm, single-select, input, lifecycle, callback-token, and authenticated answer-event contracts.",
-  "oneOf": [
-    {
-      "$ref": "#/$defs/InteractionRequest"
-    },
-    {
-      "$ref": "#/$defs/InteractionSummary"
-    },
-    {
-      "$ref": "#/$defs/InteractionEvent"
-    },
-    {
-      "$ref": "#/$defs/ProviderCallbackToken"
-    }
-  ],
   "$defs": {
     "OpaqueIdentifier": {
       "type": "string",
@@ -90,7 +76,7 @@
         },
         "expires_at": {
           "$ref": "#/$defs/Timestamp",
-          "description": "Must be 30 seconds through 24 hours after server acceptance."
+          "description": "At least 30 seconds after server acceptance; no fixed maximum. A resolved RFC3339 deadline with millisecond precision, no later than 9999-12-31T23:59:59.999Z."
         },
         "correlation_id": {
           "$ref": "#/$defs/InteractionCorrelationId"
@@ -119,7 +105,7 @@
         },
         "expires_at": {
           "$ref": "#/$defs/Timestamp",
-          "description": "Must be 30 seconds through 24 hours after server acceptance."
+          "description": "At least 30 seconds after server acceptance; no fixed maximum. A resolved RFC3339 deadline with millisecond precision, no later than 9999-12-31T23:59:59.999Z."
         },
         "correlation_id": {
           "$ref": "#/$defs/InteractionCorrelationId"
@@ -139,7 +125,7 @@
         },
         "expires_at": {
           "$ref": "#/$defs/Timestamp",
-          "description": "Must be 30 seconds through 24 hours after server acceptance."
+          "description": "At least 30 seconds after server acceptance; no fixed maximum. A resolved RFC3339 deadline with millisecond precision, no later than 9999-12-31T23:59:59.999Z."
         },
         "correlation_id": {
           "$ref": "#/$defs/InteractionCorrelationId"
@@ -486,6 +472,152 @@
       "type": "string",
       "pattern": "^itok_[A-Za-z0-9_-]{21}[AQgw]$",
       "description": "An opaque single-purpose reference containing exactly 128 random bits and no trusted identity, answer, command, or business data."
+    },
+    "ConfirmInteractionSendRequest": {
+      "type": "object",
+      "required": ["type", "prompt"],
+      "properties": {
+        "type": {
+          "const": "confirm"
+        },
+        "prompt": {
+          "$ref": "#/$defs/InteractionPrompt"
+        },
+        "confirm_label": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 40
+        },
+        "deny_label": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 40
+        },
+        "expires_at": {
+          "$ref": "#/$defs/Timestamp",
+          "description": "Absolute RFC3339 deadline with an explicit timezone and at most millisecond precision. At least 30 seconds after server acceptance. Mutually exclusive with expires_in_seconds."
+        },
+        "correlation_id": {
+          "$ref": "#/$defs/InteractionCorrelationId"
+        },
+        "expires_in_seconds": {
+          "type": "integer",
+          "minimum": 30,
+          "description": "Whole seconds from server acceptance. No fixed maximum; the resolved timestamp must be representable through year 9999. Mutually exclusive with expires_at. Omit both for 86400 seconds (24 hours)."
+        }
+      },
+      "additionalProperties": false,
+      "not": {
+        "required": ["expires_at", "expires_in_seconds"],
+        "properties": {
+          "expires_at": {},
+          "expires_in_seconds": {}
+        }
+      }
+    },
+    "InteractionSendRequest": {
+      "description": "Send-time interaction. Choose expires_in_seconds or expires_at; omit both for 24 hours from server acceptance. Idempotent replays retain the original resolved deadline.",
+      "oneOf": [
+        {
+          "$ref": "#/$defs/ConfirmInteractionSendRequest"
+        },
+        {
+          "$ref": "#/$defs/SelectInteractionSendRequest"
+        },
+        {
+          "$ref": "#/$defs/InputInteractionSendRequest"
+        }
+      ]
+    },
+    "SelectInteractionSendRequest": {
+      "type": "object",
+      "required": ["type", "prompt", "options"],
+      "properties": {
+        "type": {
+          "const": "select"
+        },
+        "prompt": {
+          "$ref": "#/$defs/InteractionPrompt"
+        },
+        "options": {
+          "type": "array",
+          "minItems": 2,
+          "maxItems": 6,
+          "items": {
+            "$ref": "#/$defs/InteractionOption"
+          },
+          "x-unique-property": "value"
+        },
+        "expires_at": {
+          "$ref": "#/$defs/Timestamp",
+          "description": "Absolute RFC3339 deadline with an explicit timezone and at most millisecond precision. At least 30 seconds after server acceptance. Mutually exclusive with expires_in_seconds."
+        },
+        "correlation_id": {
+          "$ref": "#/$defs/InteractionCorrelationId"
+        },
+        "expires_in_seconds": {
+          "type": "integer",
+          "minimum": 30,
+          "description": "Whole seconds from server acceptance. No fixed maximum; the resolved timestamp must be representable through year 9999. Mutually exclusive with expires_at. Omit both for 86400 seconds (24 hours)."
+        }
+      },
+      "additionalProperties": false,
+      "not": {
+        "required": ["expires_at", "expires_in_seconds"],
+        "properties": {
+          "expires_at": {},
+          "expires_in_seconds": {}
+        }
+      }
+    },
+    "InputInteractionSendRequest": {
+      "type": "object",
+      "required": ["type", "prompt"],
+      "properties": {
+        "type": {
+          "const": "input"
+        },
+        "prompt": {
+          "$ref": "#/$defs/InteractionPrompt"
+        },
+        "expires_at": {
+          "$ref": "#/$defs/Timestamp",
+          "description": "Absolute RFC3339 deadline with an explicit timezone and at most millisecond precision. At least 30 seconds after server acceptance. Mutually exclusive with expires_in_seconds."
+        },
+        "correlation_id": {
+          "$ref": "#/$defs/InteractionCorrelationId"
+        },
+        "expires_in_seconds": {
+          "type": "integer",
+          "minimum": 30,
+          "description": "Whole seconds from server acceptance. No fixed maximum; the resolved timestamp must be representable through year 9999. Mutually exclusive with expires_at. Omit both for 86400 seconds (24 hours)."
+        }
+      },
+      "additionalProperties": false,
+      "not": {
+        "required": ["expires_at", "expires_in_seconds"],
+        "properties": {
+          "expires_at": {},
+          "expires_in_seconds": {}
+        }
+      }
+    }
+  },
+  "anyOf": [
+    {
+      "$ref": "#/$defs/InteractionRequest"
+    },
+    {
+      "$ref": "#/$defs/InteractionSummary"
+    },
+    {
+      "$ref": "#/$defs/InteractionEvent"
+    },
+    {
+      "$ref": "#/$defs/ProviderCallbackToken"
+    },
+    {
+      "$ref": "#/$defs/InteractionSendRequest"
     }
-  }
+  ]
 }

package/schemas/machine-v1.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://whooshbang.flowxo.com/schemas/machine-v1.schema.json",
-  "x-contract-version": "2.2.0",
+  "x-contract-version": "2.4.0",
   "title": "MachineV1ContractDocument",
   "description": "Machine-client administration, locally generated credential metadata, durable long-poll, and contiguous acknowledgement contracts.",
   "oneOf": [

package/schemas/provider-capabilities-v1.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://whooshbang.flowxo.com/schemas/provider-capabilities-v1.schema.json",
-  "x-contract-version": "2.2.0",
+  "x-contract-version": "2.4.0",
   "title": "ProviderCapabilitiesV1",
   "description": "Provider-neutral, renderer-facing delivery and interaction capabilities with explicit degradation.",
   "type": "object",

package/schemas/webhooks/webhook-delivery-case-v1.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://whooshbang.flowxo.com/schemas/webhooks/webhook-delivery-case-v1.schema.json",
-  "x-contract-version": "2.2.0",
+  "x-contract-version": "2.4.0",
   "title": "WebhookDeliveryCaseSetV1",
   "description": "Deterministic customer webhook response classification, Retry-After, and delivery-bound cases.",
   "type": "object",

package/schemas/webhooks/webhook-signing-vector-v1.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://whooshbang.flowxo.com/schemas/webhooks/webhook-signing-vector-v1.schema.json",
-  "x-contract-version": "2.2.0",
+  "x-contract-version": "2.4.0",
   "title": "WebhookSigningVectorSetV1",
   "description": "Language-neutral deterministic Standard Webhooks V1 verification vectors. All key material is public synthetic test data and must never be used outside fixtures.",
   "type": "object",