@whooshbang/contracts 2.2.0 → 2.3.0

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

@@ -2,7 +2,7 @@
   "openapi": "3.1.1",
   "info": {
     "title": "WhooshBang API",
-    "version": "2.2.0",
+    "version": "2.3.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": {
@@ -11203,7 +11203,9 @@
             "maxLength": 128
           },
           "metadata": { "$ref": "#/components/schemas/Metadata" },
-          "interaction": { "$ref": "#/components/schemas/InteractionRequest" },
+          "interaction": {
+            "$ref": "#/components/schemas/InteractionSendRequest"
+          },
           "purpose": {
             "enum": ["service", "marketing"],
             "default": "service",
@@ -12597,7 +12599,9 @@
             "description": "The words a `subscriber_message` test sends, as plain text."
           },
           "content": { "$ref": "#/components/schemas/MessageContent" },
-          "interaction": { "$ref": "#/components/schemas/InteractionRequest" }
+          "interaction": {
+            "$ref": "#/components/schemas/InteractionSendRequest"
+          }
         },
         "allOf": [
           {
@@ -15502,7 +15506,9 @@
             "maxLength": 128
           },
           "metadata": { "$ref": "#/components/schemas/Metadata" },
-          "interaction": { "$ref": "#/components/schemas/InteractionRequest" },
+          "interaction": {
+            "$ref": "#/components/schemas/InteractionSendRequest"
+          },
           "purpose": {
             "enum": ["service", "marketing"],
             "default": "service",
@@ -16363,6 +16369,14 @@
         ],
         "additionalProperties": false
       },
+      "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": "#/components/schemas/ConfirmInteractionSendRequest" },
+          { "$ref": "#/components/schemas/SelectInteractionSendRequest" },
+          { "$ref": "#/components/schemas/InputInteractionSendRequest" }
+        ]
+      },
       "InteractionRequest": {
         "description": "A required-type tagged union. C0 supports confirm, single-select, and input only.",
         "oneOf": [
@@ -18186,7 +18200,9 @@
             "maxLength": 128
           },
           "metadata": { "$ref": "#/components/schemas/Metadata" },
-          "interaction": { "$ref": "#/components/schemas/InteractionRequest" },
+          "interaction": {
+            "$ref": "#/components/schemas/InteractionSendRequest"
+          },
           "purpose": {
             "enum": ["service", "marketing"],
             "default": "service",
@@ -18231,7 +18247,11 @@
           "accepted_at": { "$ref": "#/components/schemas/Timestamp" },
           "updated_at": { "$ref": "#/components/schemas/Timestamp" },
           "expires_at": { "$ref": "#/components/schemas/Timestamp" },
-          "diagnostic_id": { "$ref": "#/components/schemas/DiagnosticId" }
+          "diagnostic_id": { "$ref": "#/components/schemas/DiagnosticId" },
+          "interaction_expires_at": {
+            "$ref": "#/components/schemas/Timestamp",
+            "description": "Authoritatively resolved answer deadline shared by this broadcast’s interactions, independent of delivery expires_at."
+          }
         },
         "additionalProperties": false
       },
@@ -18671,9 +18691,9 @@
         "pattern": "^[^\\u0000-\\u001F\\u007F]+$",
         "description": "Caller-owned opaque correlation returned as data, never treated as execution authority."
       },
-      "ConfirmInteractionRequest": {
+      "ConfirmInteractionSendRequest": {
         "type": "object",
-        "required": ["type", "prompt", "expires_at"],
+        "required": ["type", "prompt"],
         "properties": {
           "type": { "const": "confirm" },
           "prompt": { "$ref": "#/components/schemas/InteractionPrompt" },
@@ -18685,13 +18705,22 @@
           "deny_label": { "type": "string", "minLength": 1, "maxLength": 40 },
           "expires_at": {
             "$ref": "#/components/schemas/Timestamp-2",
-            "description": "Must be 30 seconds through 24 hours after server acceptance."
+            "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": "#/components/schemas/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
+        "additionalProperties": false,
+        "not": {
+          "required": ["expires_at", "expires_in_seconds"],
+          "properties": { "expires_at": {}, "expires_in_seconds": {} }
+        }
       },
       "InteractionOption": {
         "type": "object",
@@ -18714,9 +18743,9 @@
         },
         "additionalProperties": false
       },
-      "SelectInteractionRequest": {
+      "SelectInteractionSendRequest": {
         "type": "object",
-        "required": ["type", "prompt", "options", "expires_at"],
+        "required": ["type", "prompt", "options"],
         "properties": {
           "type": { "const": "select" },
           "prompt": { "$ref": "#/components/schemas/InteractionPrompt" },
@@ -18729,29 +18758,47 @@
           },
           "expires_at": {
             "$ref": "#/components/schemas/Timestamp-2",
-            "description": "Must be 30 seconds through 24 hours after server acceptance."
+            "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": "#/components/schemas/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
+        "additionalProperties": false,
+        "not": {
+          "required": ["expires_at", "expires_in_seconds"],
+          "properties": { "expires_at": {}, "expires_in_seconds": {} }
+        }
       },
-      "InputInteractionRequest": {
+      "InputInteractionSendRequest": {
         "type": "object",
-        "required": ["type", "prompt", "expires_at"],
+        "required": ["type", "prompt"],
         "properties": {
           "type": { "const": "input" },
           "prompt": { "$ref": "#/components/schemas/InteractionPrompt" },
           "expires_at": {
             "$ref": "#/components/schemas/Timestamp-2",
-            "description": "Must be 30 seconds through 24 hours after server acceptance."
+            "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": "#/components/schemas/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
+        "additionalProperties": false,
+        "not": {
+          "required": ["expires_at", "expires_in_seconds"],
+          "properties": { "expires_at": {}, "expires_in_seconds": {} }
+        }
       },
       "HighestProvenProviderState": {
         "type": "string",
@@ -20340,7 +20387,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.2.0",
+        "x-contract-version": "2.3.0",
         "title": "ProviderCapabilitiesV1",
         "description": "Provider-neutral, renderer-facing delivery and interaction capabilities with explicit degradation.",
         "type": "object",
@@ -20601,6 +20648,67 @@
         },
         "additionalProperties": false
       },
+      "ConfirmInteractionRequest": {
+        "type": "object",
+        "required": ["type", "prompt", "expires_at"],
+        "properties": {
+          "type": { "const": "confirm" },
+          "prompt": { "$ref": "#/components/schemas/InteractionPrompt" },
+          "confirm_label": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 40
+          },
+          "deny_label": { "type": "string", "minLength": 1, "maxLength": 40 },
+          "expires_at": {
+            "$ref": "#/components/schemas/Timestamp-2",
+            "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": "#/components/schemas/InteractionCorrelationId"
+          }
+        },
+        "additionalProperties": false
+      },
+      "SelectInteractionRequest": {
+        "type": "object",
+        "required": ["type", "prompt", "options", "expires_at"],
+        "properties": {
+          "type": { "const": "select" },
+          "prompt": { "$ref": "#/components/schemas/InteractionPrompt" },
+          "options": {
+            "type": "array",
+            "minItems": 2,
+            "maxItems": 6,
+            "items": { "$ref": "#/components/schemas/InteractionOption" },
+            "x-unique-property": "value"
+          },
+          "expires_at": {
+            "$ref": "#/components/schemas/Timestamp-2",
+            "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": "#/components/schemas/InteractionCorrelationId"
+          }
+        },
+        "additionalProperties": false
+      },
+      "InputInteractionRequest": {
+        "type": "object",
+        "required": ["type", "prompt", "expires_at"],
+        "properties": {
+          "type": { "const": "input" },
+          "prompt": { "$ref": "#/components/schemas/InteractionPrompt" },
+          "expires_at": {
+            "$ref": "#/components/schemas/Timestamp-2",
+            "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": "#/components/schemas/InteractionCorrelationId"
+          }
+        },
+        "additionalProperties": false
+      },
       "EmailBindingImportRow": {
         "type": "object",
         "required": ["subscriber_id", "notifier_id", "address", "consent"],
@@ -21060,5 +21168,5 @@
       }
     }
   },
-  "x-contract-version": "2.2.0"
+  "x-contract-version": "2.3.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.2.0
+x-contract-version: 2.3.0
 info:
   title: WhooshBang API
-  version: 2.2.0
+  version: 2.3.0
   description: |
     The V1 contract for human organization/project administration, project-scoped
     subscription links, and asynchronous text messages. A Clerk session selects
@@ -8849,6 +8849,8 @@ components:
       $ref: ../schemas/whooshbang-v1.schema.json#/$defs/Message
     Problem:
       $ref: ../schemas/whooshbang-v1.schema.json#/$defs/Problem
+    InteractionSendRequest:
+      $ref: ../schemas/interaction-v1.schema.json#/$defs/InteractionSendRequest
     InteractionRequest:
       $ref: ../schemas/interaction-v1.schema.json#/$defs/InteractionRequest
     InteractionSummary:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whooshbang/contracts",
-  "version": "2.2.0",
+  "version": "2.3.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.2.0",
+  "x-contract-version": "2.3.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.3.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.3.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.3.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.3.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.3.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.3.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.3.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.3.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.3.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.3.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.3.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.3.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.3.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.3.0",
   "title": "MachineV1ContractDocument",
   "description": "Machine-client administration, locally generated credential metadata, durable long-poll, and contiguous acknowledgement contracts.",
   "oneOf": [