@whooshbang/contracts 2.2.0 → 2.3.0

package/dist/generated/artifact-index.js

@@ -5,115 +5,115 @@
 export const contractManifest = {
     schema: "flowxo.contract-manifest.v1",
     artifact: "@whooshbang/contracts",
-    version: "2.2.0",
+    version: "2.3.0",
     openapi: [
         {
             id: "whooshbang-rest-v1",
-            version: "2.2.0",
+            version: "2.3.0",
             path: "openapi/whooshbang-v1.yaml",
         },
     ],
     schemas: [
         {
             id: "whooshbang-v1",
-            version: "2.2.0",
+            version: "2.3.0",
             path: "schemas/whooshbang-v1.schema.json",
         },
         {
             id: "interaction-v1",
-            version: "2.2.0",
+            version: "2.3.0",
             path: "schemas/interaction-v1.schema.json",
         },
         {
             id: "machine-v1",
-            version: "2.2.0",
+            version: "2.3.0",
             path: "schemas/machine-v1.schema.json",
         },
         {
             id: "provider-capabilities-v1",
-            version: "2.2.0",
+            version: "2.3.0",
             path: "schemas/provider-capabilities-v1.schema.json",
         },
         {
             id: "whooshbang-event-v1",
-            version: "2.2.0",
+            version: "2.3.0",
             path: "schemas/events/whooshbang-event-v1.schema.json",
         },
         {
             id: "subscription-activated-event-v1",
-            version: "2.2.0",
+            version: "2.3.0",
             path: "schemas/events/subscription-activated-v1.schema.json",
         },
         {
             id: "subscription-revoked-event-v1",
-            version: "2.2.0",
+            version: "2.3.0",
             path: "schemas/events/subscription-revoked-v1.schema.json",
         },
         {
             id: "message-provider-accepted-event-v1",
-            version: "2.2.0",
+            version: "2.3.0",
             path: "schemas/events/message-provider-accepted-v1.schema.json",
         },
         {
             id: "message-delivered-event-v1",
-            version: "2.2.0",
+            version: "2.3.0",
             path: "schemas/events/message-delivered-v1.schema.json",
         },
         {
             id: "message-failed-event-v1",
-            version: "2.2.0",
+            version: "2.3.0",
             path: "schemas/events/message-failed-v1.schema.json",
         },
         {
             id: "message-expired-event-v1",
-            version: "2.2.0",
+            version: "2.3.0",
             path: "schemas/events/message-expired-v1.schema.json",
         },
         {
             id: "interaction-received-event-v1",
-            version: "2.2.0",
+            version: "2.3.0",
             path: "schemas/events/interaction-received-v1.schema.json",
         },
         {
             id: "interaction-expired-event-v1",
-            version: "2.2.0",
+            version: "2.3.0",
             path: "schemas/events/interaction-expired-v1.schema.json",
         },
         {
             id: "agent-binding-degraded-event-v1",
-            version: "2.2.0",
+            version: "2.3.0",
             path: "schemas/events/agent-binding-degraded-v1.schema.json",
         },
         {
             id: "webhook-signing-vector-v1",
-            version: "2.2.0",
+            version: "2.3.0",
             path: "schemas/webhooks/webhook-signing-vector-v1.schema.json",
         },
         {
             id: "webhook-delivery-case-v1",
-            version: "2.2.0",
+            version: "2.3.0",
             path: "schemas/webhooks/webhook-delivery-case-v1.schema.json",
         },
         {
             id: "interaction-machine-scenario",
-            version: "2.2.0",
+            version: "2.3.0",
             path: "schemas/interaction-machine-scenario.schema.json",
         },
         {
             id: "core-contract-scenario",
-            version: "2.2.0",
+            version: "2.3.0",
             path: "schemas/core-scenario.schema.json",
         },
         {
             id: "core-fixture-index",
-            version: "2.2.0",
+            version: "2.3.0",
             path: "schemas/fixture-index.schema.json",
         },
     ],
     fixture_sets: [
         {
             id: "core-api-bodies",
-            version: "2.2.0",
+            version: "2.3.0",
             schema: "schemas/whooshbang-v1.schema.json",
             fixtures: [
                 "fixtures/core-v1/requests/create-project.json",
@@ -306,7 +306,7 @@ export const contractManifest = {
         },
         {
             id: "core-semantic-scenarios",
-            version: "2.2.0",
+            version: "2.3.0",
             schema: "schemas/core-scenario.schema.json",
             fixtures: [
                 "fixtures/core-v1/scenarios/project-create-equivalent-replay.json",
@@ -338,7 +338,7 @@ export const contractManifest = {
         },
         {
             id: "interaction-message-api-bodies",
-            version: "2.2.0",
+            version: "2.3.0",
             schema: "schemas/whooshbang-v1.schema.json",
             fixtures: [
                 "fixtures/interaction-machine-v1/requests/create-message-confirm.json",
@@ -350,7 +350,7 @@ export const contractManifest = {
         },
         {
             id: "interaction-contract-bodies",
-            version: "2.2.0",
+            version: "2.3.0",
             schema: "schemas/interaction-v1.schema.json",
             fixtures: [
                 "fixtures/interaction-machine-v1/success/interaction-open.json",
@@ -367,7 +367,7 @@ export const contractManifest = {
         },
         {
             id: "machine-api-bodies",
-            version: "2.2.0",
+            version: "2.3.0",
             schema: "schemas/machine-v1.schema.json",
             fixtures: [
                 "fixtures/interaction-machine-v1/requests/create-machine-client.json",
@@ -388,13 +388,13 @@ export const contractManifest = {
         },
         {
             id: "provider-capability-bodies",
-            version: "2.2.0",
+            version: "2.3.0",
             schema: "schemas/provider-capabilities-v1.schema.json",
             fixtures: ["fixtures/interaction-machine-v1/capabilities/telegram.json"],
         },
         {
             id: "interaction-machine-semantic-scenarios",
-            version: "2.2.0",
+            version: "2.3.0",
             schema: "schemas/interaction-machine-scenario.schema.json",
             fixtures: [
                 "fixtures/interaction-machine-v1/scenarios/interaction-duplicate.json",
@@ -431,7 +431,7 @@ export const contractManifest = {
         },
         {
             id: "customer-event-bodies",
-            version: "2.2.0",
+            version: "2.3.0",
             schema: "schemas/events/whooshbang-event-v1.schema.json",
             fixtures: [
                 "fixtures/whooshbang-events-v1/events/subscription-activated.json",
@@ -449,19 +449,19 @@ export const contractManifest = {
         },
         {
             id: "webhook-signing-vectors",
-            version: "2.2.0",
+            version: "2.3.0",
             schema: "schemas/webhooks/webhook-signing-vector-v1.schema.json",
             fixtures: ["fixtures/whooshbang-events-v1/signing/vectors.json"],
         },
         {
             id: "webhook-delivery-cases",
-            version: "2.2.0",
+            version: "2.3.0",
             schema: "schemas/webhooks/webhook-delivery-case-v1.schema.json",
             fixtures: ["fixtures/whooshbang-events-v1/delivery/cases.json"],
         },
         {
             id: "core-fixture-index",
-            version: "2.2.0",
+            version: "2.3.0",
             schema: "schemas/fixture-index.schema.json",
             fixtures: ["fixtures/core-v1/fixture-index.json"],
         },

package/dist/generated/interaction-v1.d.ts

@@ -5,7 +5,7 @@
 /**
  * Provider-neutral confirm, single-select, input, lifecycle, callback-token, and authenticated answer-event contracts.
  */
-export type InteractionV1ContractDocument = InteractionRequest | InteractionSummary | InteractionEvent | ProviderCallbackToken;
+export type InteractionV1ContractDocument = InteractionRequest | InteractionSummary | InteractionEvent | ProviderCallbackToken | InteractionSendRequest;
 /**
  * A required-type tagged union. C0 supports confirm, single-select, and input only.
  */
@@ -73,13 +73,17 @@ export type TrimmedInputAnswer = string;
  * An opaque single-purpose reference containing exactly 128 random bits and no trusted identity, answer, command, or business data.
  */
 export type ProviderCallbackToken = string;
+/**
+ * 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.
+ */
+export type InteractionSendRequest = ConfirmInteractionSendRequest | SelectInteractionSendRequest | InputInteractionSendRequest;
 export interface ConfirmInteractionRequest {
     type: "confirm";
     prompt: InteractionPrompt;
     confirm_label?: string;
     deny_label?: string;
     /**
-     * Must be 30 seconds through 24 hours after server acceptance.
+     * 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.
      */
     expires_at: string;
     correlation_id?: InteractionCorrelationId;
@@ -111,7 +115,7 @@ export interface SelectInteractionRequest {
         InteractionOption
     ];
     /**
-     * Must be 30 seconds through 24 hours after server acceptance.
+     * 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.
      */
     expires_at: string;
     correlation_id?: InteractionCorrelationId;
@@ -131,7 +135,7 @@ export interface InputInteractionRequest {
     type: "input";
     prompt: InteractionPrompt;
     /**
-     * Must be 30 seconds through 24 hours after server acceptance.
+     * 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.
      */
     expires_at: string;
     correlation_id?: InteractionCorrelationId;
@@ -157,3 +161,67 @@ export interface SafeChannelContext {
     conversation_kind: "private_chat" | "thread" | "group";
     display_name?: string;
 }
+export interface ConfirmInteractionSendRequest {
+    type: "confirm";
+    prompt: InteractionPrompt;
+    confirm_label?: string;
+    deny_label?: string;
+    /**
+     * 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.
+     */
+    expires_at?: string;
+    correlation_id?: InteractionCorrelationId;
+    /**
+     * 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).
+     */
+    expires_in_seconds?: number;
+}
+export interface SelectInteractionSendRequest {
+    type: "select";
+    prompt: InteractionPrompt;
+    /**
+     * @minItems 2
+     * @maxItems 6
+     */
+    options: [InteractionOption, InteractionOption] | [InteractionOption, InteractionOption, InteractionOption] | [
+        InteractionOption,
+        InteractionOption,
+        InteractionOption,
+        InteractionOption
+    ] | [
+        InteractionOption,
+        InteractionOption,
+        InteractionOption,
+        InteractionOption,
+        InteractionOption
+    ] | [
+        InteractionOption,
+        InteractionOption,
+        InteractionOption,
+        InteractionOption,
+        InteractionOption,
+        InteractionOption
+    ];
+    /**
+     * 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.
+     */
+    expires_at?: string;
+    correlation_id?: InteractionCorrelationId;
+    /**
+     * 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).
+     */
+    expires_in_seconds?: number;
+}
+export interface InputInteractionSendRequest {
+    type: "input";
+    prompt: InteractionPrompt;
+    /**
+     * 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.
+     */
+    expires_at?: string;
+    correlation_id?: InteractionCorrelationId;
+    /**
+     * 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).
+     */
+    expires_in_seconds?: number;
+}