@whooshbang/contracts 2.5.0 → 3.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whooshbang/contracts",
-  "version": "2.5.0",
+  "version": "3.0.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.5.0",
+  "x-contract-version": "3.0.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.5.0",
+  "x-contract-version": "3.0.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.5.0",
+  "x-contract-version": "3.0.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.5.0",
+  "x-contract-version": "3.0.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.5.0",
+  "x-contract-version": "3.0.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.5.0",
+  "x-contract-version": "3.0.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.5.0",
+  "x-contract-version": "3.0.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.5.0",
+  "x-contract-version": "3.0.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.5.0",
+  "x-contract-version": "3.0.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.5.0",
+  "x-contract-version": "3.0.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.5.0",
+  "x-contract-version": "3.0.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.5.0",
+  "x-contract-version": "3.0.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.5.0",
+  "x-contract-version": "3.0.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.5.0",
+  "x-contract-version": "3.0.0",
   "title": "InteractionV1ContractDocument",
   "description": "Provider-neutral confirm, single-select, input, lifecycle, callback-token, and authenticated answer-event contracts.",
   "$defs": {
@@ -19,7 +19,7 @@
     },
     "InteractionCorrelationId": {
       "type": "string",
-      "minLength": 8,
+      "minLength": 1,
       "maxLength": 128,
       "pattern": "^[^\\u0000-\\u001F\\u007F]+$",
       "description": "Caller-owned opaque correlation returned as data, never treated as execution authority."
@@ -475,7 +475,7 @@
     },
     "ConfirmInteractionSendRequest": {
       "type": "object",
-      "required": ["type", "prompt"],
+      "required": ["prompt"],
       "properties": {
         "type": {
           "const": "confirm"
@@ -516,7 +516,7 @@
       }
     },
     "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.",
+      "description": "Options infer select; otherwise confirm. Typed replies require type: input. Omit expiry for 24 hours.",
       "oneOf": [
         {
           "$ref": "#/$defs/ConfirmInteractionSendRequest"
@@ -530,6 +530,135 @@
       ]
     },
     "SelectInteractionSendRequest": {
+      "type": "object",
+      "required": ["prompt", "options"],
+      "properties": {
+        "type": {
+          "const": "select"
+        },
+        "prompt": {
+          "$ref": "#/$defs/InteractionPrompt"
+        },
+        "options": {
+          "type": "array",
+          "minItems": 2,
+          "maxItems": 6,
+          "items": {
+            "$ref": "#/$defs/InteractionOptionInput"
+          },
+          "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": {}
+        }
+      }
+    },
+    "CanonicalInteractionSendRequest": {
+      "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/CanonicalConfirmInteractionSendRequest"
+        },
+        {
+          "$ref": "#/$defs/CanonicalSelectInteractionSendRequest"
+        },
+        {
+          "$ref": "#/$defs/CanonicalInputInteractionSendRequest"
+        }
+      ]
+    },
+    "CanonicalConfirmInteractionSendRequest": {
+      "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": {}
+        }
+      }
+    },
+    "CanonicalSelectInteractionSendRequest": {
       "type": "object",
       "required": ["type", "prompt", "options"],
       "properties": {
@@ -570,7 +699,7 @@
         }
       }
     },
-    "InputInteractionSendRequest": {
+    "CanonicalInputInteractionSendRequest": {
       "type": "object",
       "required": ["type", "prompt"],
       "properties": {
@@ -601,6 +730,61 @@
           "expires_in_seconds": {}
         }
       }
+    },
+    "InteractionOptionInput": {
+      "oneOf": [
+        {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 120,
+          "pattern": "^[^\\u0000-\\u001F\\u007F]+$"
+        },
+        {
+          "type": "object",
+          "required": ["label"],
+          "properties": {
+            "value": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 128,
+              "pattern": "^[^\\u0000-\\u001F\\u007F]+$",
+              "description": "Defaults to label. Opaque customer data, never a command."
+            },
+            "label": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 120
+            },
+            "intent": {
+              "type": "string",
+              "enum": ["accept", "destructive", "informational", "neutral"],
+              "default": "neutral",
+              "description": "What choosing this option does, so a channel can present it accordingly. Describes consequence rather than appearance: a channel renders `accept` green where it can, `destructive` red, `informational` prominent, and `neutral` plainly. A channel that cannot colour a control ignores this and the option still renders. Omitted means `neutral`."
+            }
+          },
+          "additionalProperties": false,
+          "allOf": [
+            {
+              "if": {
+                "properties": {
+                  "value": {}
+                },
+                "required": ["value"]
+              },
+              "else": {
+                "properties": {
+                  "label": {
+                    "pattern": "^[^\\u0000-\\u001F\\u007F]+$",
+                    "type": "string"
+                  }
+                }
+              }
+            }
+          ],
+          "$comment": "The conditional constraint applies only when the label is used as the value. Keep the TypeScript input shape explicit because the generator omits object properties for conditional schemas.",
+          "x-typescript-type": "{ label: string; value?: string; intent?: \"accept\" | \"destructive\" | \"informational\" | \"neutral\" }"
+        }
+      ]
     }
   },
   "anyOf": [
@@ -618,6 +802,9 @@
     },
     {
       "$ref": "#/$defs/InteractionSendRequest"
+    },
+    {
+      "$ref": "#/$defs/CanonicalInteractionSendRequest"
     }
   ]
 }

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.5.0",
+  "x-contract-version": "3.0.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.5.0",
+  "x-contract-version": "3.0.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.5.0",
+  "x-contract-version": "3.0.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.5.0",
+  "x-contract-version": "3.0.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",