@whooshbang/contracts 1.0.0-rc.13

package/fixtures/core-v1/scenarios/subscription-activation-replay.json

@@ -0,0 +1,18 @@
+{
+  "contract_version": "1.0.0-rc.13",
+  "id": "subscription-activation-replay",
+  "category": "subscription_replay",
+  "given": {
+    "link_id": "slink_synthetic_001",
+    "link_project_id": "project_synthetic",
+    "link_environment": "test",
+    "link_status": "activated",
+    "existing_binding_id": "binding_synthetic_001",
+    "repeated_provider_update": true
+  },
+  "expected": {
+    "status": "activated",
+    "binding_id": "binding_synthetic_001",
+    "bindings_created": 0
+  }
+}

package/fixtures/core-v1/scenarios/subscription-expired-replay.json

@@ -0,0 +1,16 @@
+{
+  "contract_version": "1.0.0-rc.13",
+  "id": "subscription-expired-replay",
+  "category": "subscription_replay",
+  "given": {
+    "link_id": "slink_synthetic_expired",
+    "link_project_id": "project_synthetic",
+    "link_environment": "test",
+    "link_status": "expired",
+    "repeated_provider_update": true
+  },
+  "expected": {
+    "status": "expired",
+    "bindings_created": 0
+  }
+}

package/fixtures/core-v1/success/account-projection.json

@@ -0,0 +1,11 @@
+{
+  "id": "account_synthetic_001",
+  "name": "Synthetic Organization",
+  "status": "active",
+  "membership": {
+    "role": "admin"
+  },
+  "created_at": "2026-07-28T12:00:00Z",
+  "updated_at": "2026-07-28T12:00:00Z",
+  "diagnostic_id": "diag_account_synthetic_001"
+}

package/fixtures/core-v1/success/api-credential-collection.json

@@ -0,0 +1,22 @@
+{
+  "items": [
+    {
+      "id": "pcred_AAAAAAAAAAAAAAAAAAAAAA",
+      "project_id": "project_synthetic_001",
+      "environment_id": "environment_live_synthetic_001",
+      "environment": "live",
+      "prefix": "wb_pc1.pcred_AAAAAAAA",
+      "label": "Synthetic production integration",
+      "scopes": [
+        "messages:write",
+        "messages:read",
+        "subscriptions:write",
+        "subscriptions:read"
+      ],
+      "created_by": "member_synthetic_001",
+      "created_at": "2026-07-25T17:45:00Z",
+      "last_used_at": "2026-07-25T17:50:00Z",
+      "status": "active"
+    }
+  ]
+}

package/fixtures/core-v1/success/api-credential-created.json

@@ -0,0 +1,20 @@
+{
+  "credential": {
+    "id": "pcred_AAAAAAAAAAAAAAAAAAAAAA",
+    "project_id": "project_synthetic_001",
+    "environment_id": "environment_live_synthetic_001",
+    "environment": "live",
+    "prefix": "wb_pc1.pcred_AAAAAAAA",
+    "label": "Synthetic production integration",
+    "scopes": [
+      "messages:write",
+      "messages:read",
+      "subscriptions:write",
+      "subscriptions:read"
+    ],
+    "created_by": "member_synthetic_001",
+    "created_at": "2026-07-25T17:45:00Z",
+    "status": "active"
+  },
+  "secret": "wb_pc1.pcred_AAAAAAAAAAAAAAAAAAAAAA.AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
+}

package/fixtures/core-v1/success/api-credential-revoked.json

@@ -0,0 +1,19 @@
+{
+  "id": "pcred_AAAAAAAAAAAAAAAAAAAAAA",
+  "project_id": "project_synthetic_001",
+  "environment_id": "environment_live_synthetic_001",
+  "environment": "live",
+  "prefix": "wb_pc1.pcred_AAAAAAAA",
+  "label": "Synthetic production integration",
+  "scopes": [
+    "messages:write",
+    "messages:read",
+    "subscriptions:write",
+    "subscriptions:read"
+  ],
+  "created_by": "member_synthetic_001",
+  "created_at": "2026-07-25T17:45:00Z",
+  "last_used_at": "2026-07-25T17:50:00Z",
+  "status": "revoked",
+  "revoked_at": "2026-07-25T17:55:00Z"
+}

package/fixtures/core-v1/success/api-credential-rotated.json

@@ -0,0 +1,41 @@
+{
+  "credential": {
+    "credential": {
+      "id": "pcred_BBBBBBBBBBBBBBBBBBBBBA",
+      "project_id": "project_synthetic_001",
+      "environment_id": "environment_live_synthetic_001",
+      "environment": "live",
+      "prefix": "wb_pc1.pcred_BBBBBBBB",
+      "label": "Synthetic production integration",
+      "scopes": [
+        "messages:write",
+        "messages:read",
+        "subscriptions:write",
+        "subscriptions:read"
+      ],
+      "created_by": "member_synthetic_001",
+      "created_at": "2026-07-25T17:45:00Z",
+      "status": "active"
+    },
+    "secret": "wb_pc1.pcred_BBBBBBBBBBBBBBBBBBBBBA.BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBA"
+  },
+  "replaced_credential": {
+    "id": "pcred_AAAAAAAAAAAAAAAAAAAAAA",
+    "project_id": "project_synthetic_001",
+    "environment_id": "environment_live_synthetic_001",
+    "environment": "live",
+    "prefix": "wb_pc1.pcred_AAAAAAAA",
+    "label": "Synthetic production integration",
+    "scopes": [
+      "messages:write",
+      "messages:read",
+      "subscriptions:write",
+      "subscriptions:read"
+    ],
+    "created_by": "member_synthetic_001",
+    "created_at": "2026-07-25T17:45:00Z",
+    "last_used_at": "2026-07-25T17:50:00Z",
+    "scheduled_revocation_at": "2026-07-25T18:45:00Z",
+    "status": "active"
+  }
+}

package/fixtures/core-v1/success/customer-endpoint-attempts.json

@@ -0,0 +1,15 @@
+{
+  "endpoint_id": "endpoint_11111111111111111111111111111111",
+  "attempts": [
+    {
+      "id": "ceattempt_11111111111111111111111111111111",
+      "event_id": "evt_interaction_received_synthetic",
+      "attempt": 1,
+      "status": "terminal_failed",
+      "diagnostic_code": "network_failure",
+      "started_at": "2026-08-06T14:00:00.000Z",
+      "completed_at": "2026-08-06T14:00:01.000Z",
+      "created_at": "2026-08-06T14:00:00.000Z"
+    }
+  ]
+}

package/fixtures/core-v1/success/customer-endpoint-collection.json

@@ -0,0 +1,26 @@
+{
+  "items": [
+    {
+      "id": "endpoint_11111111111111111111111111111111",
+      "project_id": "project_synthetic_alpha",
+      "environment_id": "environment_test_synthetic_alpha",
+      "environment": "test",
+      "status": "active",
+      "verification_status": "verified",
+      "event_types": ["interaction.received", "message.delivered"],
+      "secret_version": 2,
+      "health": "failing",
+      "created_at": "2026-08-06T12:00:00.000Z",
+      "updated_at": "2026-08-06T14:00:00.000Z",
+      "verification_attempted_at": "2026-08-06T12:05:00.000Z",
+      "verified_at": "2026-08-06T12:05:00.000Z",
+      "rotated_at": "2026-08-06T13:00:00.000Z",
+      "last_success_at": "2026-08-06T13:30:00.000Z",
+      "last_failure": {
+        "at": "2026-08-06T14:00:00.000Z",
+        "category": "network_failure"
+      },
+      "diagnostic_id": "diag_endpoint_list_001"
+    }
+  ]
+}

package/fixtures/core-v1/success/customer-endpoint-create-replayed.json

@@ -0,0 +1,16 @@
+{
+  "endpoint": {
+    "id": "endpoint_11111111111111111111111111111111",
+    "project_id": "project_synthetic_alpha",
+    "environment_id": "environment_test_synthetic_alpha",
+    "environment": "test",
+    "status": "unverified",
+    "verification_status": "pending",
+    "event_types": ["interaction.received", "message.delivered"],
+    "secret_version": 1,
+    "health": "never_delivered",
+    "created_at": "2026-08-06T12:00:00.000Z",
+    "updated_at": "2026-08-06T12:00:00.000Z",
+    "diagnostic_id": "diag_endpoint_replay_001"
+  }
+}

package/fixtures/core-v1/success/customer-endpoint-created.json

@@ -0,0 +1,17 @@
+{
+  "endpoint": {
+    "id": "endpoint_11111111111111111111111111111111",
+    "project_id": "project_synthetic_alpha",
+    "environment_id": "environment_test_synthetic_alpha",
+    "environment": "test",
+    "status": "unverified",
+    "verification_status": "pending",
+    "event_types": ["interaction.received", "message.delivered"],
+    "secret_version": 1,
+    "health": "never_delivered",
+    "created_at": "2026-08-06T12:00:00.000Z",
+    "updated_at": "2026-08-06T12:00:00.000Z",
+    "diagnostic_id": "diag_endpoint_create_001"
+  },
+  "secret": "whsec_AAECAwQFBgcICQoLDA0ODxAREhMUFRYXGBkaGxwdHh8="
+}

package/fixtures/core-v1/success/customer-endpoint-rotated.json

@@ -0,0 +1,21 @@
+{
+  "endpoint": {
+    "id": "endpoint_11111111111111111111111111111111",
+    "project_id": "project_synthetic_alpha",
+    "environment_id": "environment_test_synthetic_alpha",
+    "environment": "test",
+    "status": "active",
+    "verification_status": "verified",
+    "event_types": ["interaction.received", "message.delivered"],
+    "secret_version": 2,
+    "health": "healthy",
+    "created_at": "2026-08-06T12:00:00.000Z",
+    "updated_at": "2026-08-06T13:00:00.000Z",
+    "verification_attempted_at": "2026-08-06T12:05:00.000Z",
+    "verified_at": "2026-08-06T12:05:00.000Z",
+    "rotated_at": "2026-08-06T13:00:00.000Z",
+    "last_success_at": "2026-08-06T12:30:00.000Z",
+    "diagnostic_id": "diag_endpoint_rotate_001"
+  },
+  "secret": "whsec_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA="
+}

package/fixtures/core-v1/success/message-accepted.json

@@ -0,0 +1,30 @@
+{
+  "id": "msg_synthetic_001",
+  "project_id": "project_synthetic",
+  "environment": "test",
+  "subscriber_id": "customer_123",
+  "notifier_id": "default",
+  "binding": {
+    "id": "binding_synthetic_001",
+    "project_id": "project_synthetic",
+    "environment": "test",
+    "subscriber_id": "customer_123",
+    "notifier_id": "default",
+    "channel": "telegram",
+    "status": "active"
+  },
+  "state": "accepted",
+  "accepted_at": "2026-07-25T17:45:00Z",
+  "updated_at": "2026-07-25T17:45:00Z",
+  "expires_at": "2026-07-26T17:45:00Z",
+  "delivery": {
+    "attempt_count": 0,
+    "highest_proven_provider_state": "none",
+    "retry_scheduled": false
+  },
+  "diagnostic_id": "diag_message_accept_001",
+  "correlation_id": "export_987",
+  "metadata": {
+    "job": "export_987"
+  }
+}

package/fixtures/core-v1/success/message-cancellation-too-late.json

@@ -0,0 +1,27 @@
+{
+  "id": "msg_synthetic_004",
+  "project_id": "project_synthetic",
+  "environment": "test",
+  "subscriber_id": "customer_999",
+  "notifier_id": "default",
+  "binding": {
+    "id": "binding_synthetic_004",
+    "project_id": "project_synthetic",
+    "environment": "test",
+    "subscriber_id": "customer_999",
+    "notifier_id": "default",
+    "channel": "telegram",
+    "status": "active"
+  },
+  "state": "sending",
+  "accepted_at": "2026-07-25T17:45:00Z",
+  "updated_at": "2026-07-25T17:45:02Z",
+  "expires_at": "2026-07-26T17:45:00Z",
+  "delivery": {
+    "attempt_count": 1,
+    "highest_proven_provider_state": "none",
+    "retry_scheduled": false
+  },
+  "diagnostic_id": "diag_message_race_001",
+  "cancellation_effective": false
+}

package/fixtures/core-v1/success/message-cancelled.json

@@ -0,0 +1,27 @@
+{
+  "id": "msg_synthetic_003",
+  "project_id": "project_synthetic",
+  "environment": "test",
+  "subscriber_id": "customer_789",
+  "notifier_id": "default",
+  "binding": {
+    "id": "binding_synthetic_003",
+    "project_id": "project_synthetic",
+    "environment": "test",
+    "subscriber_id": "customer_789",
+    "notifier_id": "default",
+    "channel": "telegram",
+    "status": "active"
+  },
+  "state": "cancelled",
+  "accepted_at": "2026-07-25T17:45:00Z",
+  "updated_at": "2026-07-25T17:45:01Z",
+  "expires_at": "2026-07-26T17:45:00Z",
+  "delivery": {
+    "attempt_count": 0,
+    "highest_proven_provider_state": "none",
+    "retry_scheduled": false
+  },
+  "diagnostic_id": "diag_message_cancel_001",
+  "cancellation_effective": true
+}

package/fixtures/core-v1/success/message-outcome-unknown.json

@@ -0,0 +1,33 @@
+{
+  "id": "msg_synthetic_002",
+  "project_id": "project_synthetic",
+  "environment": "test",
+  "subscriber_id": "customer_456",
+  "notifier_id": "default",
+  "binding": {
+    "id": "binding_synthetic_002",
+    "project_id": "project_synthetic",
+    "environment": "test",
+    "subscriber_id": "customer_456",
+    "notifier_id": "default",
+    "channel": "telegram",
+    "status": "active"
+  },
+  "state": "outcome_unknown",
+  "accepted_at": "2026-07-25T17:45:00Z",
+  "updated_at": "2026-07-25T17:45:03Z",
+  "expires_at": "2026-07-26T17:45:00Z",
+  "delivery": {
+    "attempt_count": 1,
+    "highest_proven_provider_state": "none",
+    "retry_scheduled": false,
+    "classified_error": {
+      "code": "provider_outcome_unknown",
+      "retryable": false,
+      "detail": "The provider may have accepted the request, but no trustworthy result is available.",
+      "diagnostic_id": "diag_provider_unknown_001"
+    }
+  },
+  "diagnostic_id": "diag_message_unknown_001",
+  "outcome_guidance": "Delivery may have been accepted by the provider. No automatic retry is scheduled; create a new message explicitly if another attempt is appropriate."
+}

package/fixtures/core-v1/success/message-provider-accepted.json

@@ -0,0 +1,30 @@
+{
+  "id": "msg_synthetic_001",
+  "project_id": "project_synthetic",
+  "environment": "test",
+  "subscriber_id": "customer_123",
+  "notifier_id": "default",
+  "binding": {
+    "id": "binding_synthetic_001",
+    "project_id": "project_synthetic",
+    "environment": "test",
+    "subscriber_id": "customer_123",
+    "notifier_id": "default",
+    "channel": "telegram",
+    "status": "active"
+  },
+  "state": "provider_accepted",
+  "accepted_at": "2026-07-25T17:45:00Z",
+  "updated_at": "2026-07-25T17:45:02Z",
+  "expires_at": "2026-07-26T17:45:00Z",
+  "delivery": {
+    "attempt_count": 1,
+    "highest_proven_provider_state": "provider_accepted",
+    "retry_scheduled": false
+  },
+  "diagnostic_id": "diag_message_provider_001",
+  "correlation_id": "export_987",
+  "metadata": {
+    "job": "export_987"
+  }
+}

package/fixtures/core-v1/success/project-collection.json

@@ -0,0 +1,42 @@
+{
+  "items": [
+    {
+      "id": "project_synthetic_001",
+      "account_id": "account_synthetic_001",
+      "name": "Synthetic Alerts",
+      "slug": "synthetic-alerts",
+      "status": "active",
+      "environments": [
+        {
+          "id": "environment_synthetic_test_001",
+          "project_id": "project_synthetic_001",
+          "kind": "test",
+          "status": "active",
+          "default_notifier": {
+            "id": "notifier_synthetic_test_default_001",
+            "environment_id": "environment_synthetic_test_001",
+            "display_name": "Default",
+            "status": "active",
+            "is_default": true
+          }
+        },
+        {
+          "id": "environment_synthetic_live_001",
+          "project_id": "project_synthetic_001",
+          "kind": "live",
+          "status": "active",
+          "default_notifier": {
+            "id": "notifier_synthetic_live_default_001",
+            "environment_id": "environment_synthetic_live_001",
+            "display_name": "Default",
+            "status": "active",
+            "is_default": true
+          }
+        }
+      ],
+      "created_at": "2026-07-28T12:05:00Z",
+      "updated_at": "2026-07-28T12:05:00Z",
+      "diagnostic_id": "diag_project_synthetic_001"
+    }
+  ]
+}

package/fixtures/core-v1/success/project-created.json

@@ -0,0 +1,38 @@
+{
+  "id": "project_synthetic_001",
+  "account_id": "account_synthetic_001",
+  "name": "Synthetic Alerts",
+  "slug": "synthetic-alerts",
+  "status": "active",
+  "environments": [
+    {
+      "id": "environment_synthetic_test_001",
+      "project_id": "project_synthetic_001",
+      "kind": "test",
+      "status": "active",
+      "default_notifier": {
+        "id": "notifier_synthetic_test_default_001",
+        "environment_id": "environment_synthetic_test_001",
+        "display_name": "Default",
+        "status": "active",
+        "is_default": true
+      }
+    },
+    {
+      "id": "environment_synthetic_live_001",
+      "project_id": "project_synthetic_001",
+      "kind": "live",
+      "status": "active",
+      "default_notifier": {
+        "id": "notifier_synthetic_live_default_001",
+        "environment_id": "environment_synthetic_live_001",
+        "display_name": "Default",
+        "status": "active",
+        "is_default": true
+      }
+    }
+  ],
+  "created_at": "2026-07-28T12:05:00Z",
+  "updated_at": "2026-07-28T12:05:00Z",
+  "diagnostic_id": "diag_project_synthetic_001"
+}

package/fixtures/core-v1/success/subscription-link-activated.json

@@ -0,0 +1,22 @@
+{
+  "id": "slink_synthetic_001",
+  "project_id": "project_synthetic",
+  "environment": "test",
+  "subscriber_id": "customer_123",
+  "notifier_id": "default",
+  "channels": ["telegram"],
+  "status": "activated",
+  "binding": {
+    "id": "binding_synthetic_001",
+    "project_id": "project_synthetic",
+    "environment": "test",
+    "subscriber_id": "customer_123",
+    "notifier_id": "default",
+    "channel": "telegram",
+    "status": "active"
+  },
+  "created_at": "2026-07-25T17:45:00Z",
+  "updated_at": "2026-07-25T17:47:00Z",
+  "expires_at": "2026-07-25T18:00:00Z",
+  "diagnostic_id": "diag_link_active_001"
+}

package/fixtures/core-v1/success/subscription-link-cancelled.json

@@ -0,0 +1,14 @@
+{
+  "id": "slink_synthetic_002",
+  "project_id": "project_synthetic",
+  "environment": "test",
+  "subscriber_id": "customer_456",
+  "notifier_id": "default",
+  "channels": ["telegram"],
+  "status": "cancelled",
+  "created_at": "2026-07-25T17:45:00Z",
+  "updated_at": "2026-07-25T17:46:00Z",
+  "expires_at": "2026-07-25T18:00:00Z",
+  "diagnostic_id": "diag_link_cancel_001",
+  "cancellation_effective": true
+}

package/fixtures/core-v1/success/subscription-link-paused.json

@@ -0,0 +1,22 @@
+{
+  "id": "slink_synthetic_paused_001",
+  "project_id": "project_synthetic",
+  "environment": "live",
+  "subscriber_id": "customer_paused_123",
+  "notifier_id": "default",
+  "channels": ["telegram"],
+  "status": "activated",
+  "binding": {
+    "id": "binding_synthetic_paused_001",
+    "project_id": "project_synthetic",
+    "environment": "live",
+    "subscriber_id": "customer_paused_123",
+    "notifier_id": "default",
+    "channel": "telegram",
+    "status": "paused"
+  },
+  "created_at": "2026-07-30T14:00:00Z",
+  "updated_at": "2026-07-30T14:05:00Z",
+  "expires_at": "2026-07-30T14:15:00Z",
+  "diagnostic_id": "diag_link_paused_001"
+}

package/fixtures/core-v1/success/subscription-link-pending.json

@@ -0,0 +1,14 @@
+{
+  "id": "slink_synthetic_001",
+  "project_id": "project_synthetic",
+  "environment": "test",
+  "subscriber_id": "customer_123",
+  "notifier_id": "default",
+  "channels": ["telegram"],
+  "status": "pending",
+  "authorization_url": "https://subscribe.whooshbang.test/s/synthetic-link-token",
+  "created_at": "2026-07-25T17:45:00Z",
+  "updated_at": "2026-07-25T17:45:00Z",
+  "expires_at": "2026-07-25T18:00:00Z",
+  "diagnostic_id": "diag_link_pending_001"
+}

package/fixtures/core-v1/success/subscription-link-revoked.json

@@ -0,0 +1,22 @@
+{
+  "id": "slink_synthetic_revoked_001",
+  "project_id": "project_synthetic",
+  "environment": "live",
+  "subscriber_id": "customer_revoked_123",
+  "notifier_id": "default",
+  "channels": ["telegram"],
+  "status": "revoked",
+  "binding": {
+    "id": "binding_synthetic_revoked_001",
+    "project_id": "project_synthetic",
+    "environment": "live",
+    "subscriber_id": "customer_revoked_123",
+    "notifier_id": "default",
+    "channel": "telegram",
+    "status": "revoked"
+  },
+  "created_at": "2026-07-30T14:00:00Z",
+  "updated_at": "2026-07-30T14:10:00Z",
+  "expires_at": "2026-07-30T14:15:00Z",
+  "diagnostic_id": "diag_link_revoked_001"
+}

package/fixtures/interaction-machine-v1/capabilities/providers.json

@@ -0,0 +1,57 @@
+{
+  "schema": "whooshbang.provider-capabilities-collection.v1",
+  "providers": [
+    {
+      "schema": "whooshbang.provider-capabilities.v1",
+      "provider": "telegram",
+      "text": {
+        "supported": true,
+        "maximum_bytes": 8192
+      },
+      "interaction": {
+        "confirm": {
+          "mode": "native"
+        },
+        "select": {
+          "mode": "native"
+        },
+        "input": {
+          "mode": "conditional",
+          "explanation": "Input requires an exact provider reply context."
+        }
+      },
+      "streaming": {
+        "mode": "edit",
+        "explanation": "Progressive content uses bounded message edits."
+      },
+      "edit": {
+        "supported": true
+      },
+      "receipts": {
+        "provider_accepted": true,
+        "delivered": false,
+        "read": false
+      },
+      "contexts": {
+        "private_chat": {
+          "mode": "supported"
+        },
+        "thread": {
+          "mode": "conditional",
+          "explanation": "Thread support depends on the bound Telegram chat context."
+        },
+        "group": {
+          "mode": "conditional",
+          "explanation": "Group use requires an authenticated subscriber binding and exact reply context."
+        }
+      },
+      "rate_limit": {
+        "strategy": "provider_retry_after",
+        "explanation": "Safe provider retry timing is honored when available."
+      },
+      "degradation": {
+        "active": false
+      }
+    }
+  ]
+}