Register API-406 backend carrier contracts

Author: Brad-Edwards

changelog.d/200.added.md

@@ -0,0 +1,5 @@
+### Added
+
+- Made the API-406 participant lifecycle-event, observation-envelope, and
+  shared-state record contracts required by the full remote control-plane
+  backend profile and registered their conformance model validators.

contracts/profiles/backend/full-remote-control-plane.json

@@ -15,6 +15,9 @@
     "evaluation-history-event-stream-v1",
     "participant-episode-state-envelope-v1",
     "participant-episode-history-event-stream-v1",
-    "participant-behavior-history-event-stream-v1"
+    "participant-behavior-history-event-stream-v1",
+    "participant-lifecycle-event-v1",
+    "participant-observation-envelope-v1",
+    "participant-shared-state-record-v1"
   ]
 }

implementations/python/packages/aces_conformance/conformance.py

@@ -31,6 +31,9 @@
     ParticipantEpisodeStateModel,
     ParticipantImplementationManifestModel,
     ParticipantImplementationProvenanceModel,
+    ParticipantLifecycleEventModel,
+    ParticipantObservationEnvelopeModel,
+    ParticipantSharedStateRecordModel,
     ProvisioningPlanModel,
     RuntimeSnapshotEnvelopeModel,
     WorkflowExecutionStateModel,
@@ -162,6 +165,9 @@ class BackendConformanceReport:
     "workflow-result-envelope-v1": WorkflowExecutionStateModel.model_validate,
     "evaluation-result-envelope-v1": EvaluationResultStateModel.model_validate,
     "participant-episode-state-envelope-v1": ParticipantEpisodeStateModel.model_validate,
+    "participant-lifecycle-event-v1": ParticipantLifecycleEventModel.model_validate,
+    "participant-observation-envelope-v1": ParticipantObservationEnvelopeModel.model_validate,
+    "participant-shared-state-record-v1": ParticipantSharedStateRecordModel.model_validate,
 }
 
 

implementations/python/tests/test_runtime_conformance.py

@@ -19,6 +19,12 @@
 )
 from aces.core.runtime.registry import RuntimeTarget
 
+API_406_CARRIER_CONTRACTS = {
+    "participant-lifecycle-event-v1",
+    "participant-observation-envelope-v1",
+    "participant-shared-state-record-v1",
+}
+
 
 def test_fixture_suite_passes_for_orchestration_evaluation_profile():
     report = run_fixture_suite(profile=BackendCapabilityProfile.ORCHESTRATION_EVALUATION)
@@ -61,6 +67,46 @@ def test_target_conformance_passes_for_stub_target():
             )
 
 
+def test_full_remote_control_plane_profile_requires_api_406_carriers():
+    contracts = required_contracts(BackendCapabilityProfile.FULL_REMOTE_CONTROL_PLANE)
+
+    assert contracts >= API_406_CARRIER_CONTRACTS
+    assert {
+        "runtime-snapshot-v1",
+        "participant-episode-state-envelope-v1",
+        "participant-episode-history-event-stream-v1",
+        "participant-behavior-history-event-stream-v1",
+    } <= contracts
+
+
+def test_fixture_suite_validates_api_406_carrier_fixtures(tmp_path: Path):
+    backend_dir = tmp_path / "backend"
+    backend_dir.mkdir()
+    (backend_dir / "provisioning-only.json").write_text(
+        json.dumps(
+            {
+                "schema_version": "backend-profile/v1",
+                "profile": "provisioning-only",
+                "required_contracts": sorted(API_406_CARRIER_CONTRACTS),
+            }
+        )
+        + "\n",
+        encoding="utf-8",
+    )
+
+    report = run_fixture_suite(
+        profile=BackendCapabilityProfile.PROVISIONING_ONLY,
+        profiles_root=backend_dir,
+    )
+
+    assert report.passed is True
+    assert {case.contract_name for case in report.cases} == API_406_CARRIER_CONTRACTS
+    assert any(case.valid is False for case in report.cases)
+    assert all(
+        diagnostic.code != "conformance.contract-unknown" for case in report.cases for diagnostic in case.diagnostics
+    )
+
+
 def test_profile_is_inferred_as_full_when_manifest_declares_participant_runtime():
     """RUN-311 — finding 3: a manifest that declares orchestrator,
     evaluator, and participant_runtime must infer the
@@ -701,6 +747,9 @@ def test_target_conformance_fails_when_declared_contracts_do_not_cover_profile_r
         "participant-behavior-history-event-stream-v1",
         "participant-episode-history-event-stream-v1",
         "participant-episode-state-envelope-v1",
+        "participant-lifecycle-event-v1",
+        "participant-observation-envelope-v1",
+        "participant-shared-state-record-v1",
         "provisioning-plan-v1",
         "runtime-snapshot-v1",
         "workflow-history-event-stream-v1",