feat(protocol): adopt AdCP 3.2 beta.11 (#1114)

* feat(protocol): adopt AdCP 3.2 beta.11

* test(protocol): track current beta schema coverage

Author: bokelley

MANIFEST.in

@@ -10,7 +10,7 @@ recursive-include src/adcp py.typed
 recursive-include src/adcp/_schemas/2.5 *.json
 recursive-include src/adcp/_schemas/3.0 *.json
 recursive-include src/adcp/_schemas/3.1 *.json
-recursive-include src/adcp/_schemas/3.2.0-beta.10 *.json
+recursive-include src/adcp/_schemas/3.2.0-beta.11 *.json
 prune src/adcp/_schemas/3.1.0-*
 # A clean VCS source tree has no ignored ``src/adcp/_schemas`` directory.
 # Keep the tracked inputs needed by the build_py hook in source distributions

SCHEMA_DELTAS.md

@@ -1,165 +1,3 @@
 # Generated-types delta
 
-## Files added
-
-- `core/agent_notification_config_state.py` — AgentNotificationConfigState, Authentication
-- `core/agent_reporting_destination.py` — AcceptedFormat, AgentReportingDestination, AgentReportingDestination1, AgentReportingDestination2, AgentReportingDestination3
-- `core/agent_reporting_destination_state.py` — Action, AgentReportingDestinationState, PriorDestinationRef, Setup
-- `core/collection_selection.py` — CollectionSelection, CollectionSelection1, CollectionSelection2
-- `core/delivery_provider.py` — DeliveryProvider
-- `core/delivery_recipient.py` — DeliveryRecipient
-- `core/experimental_feature_id.py` — ExperimentalFeatureId
-- `core/principal_changed_webhook.py` — PrincipalChangedWebhook, Reason
-- `core/principal_declarations.py` — AgentDeclarations, AsyncAdcpVersion, WebhookSigningAlgorithm
-- `core/principal_declarations_state.py` — Axis, Exclusion, PrincipalDeclarationsState
-- `core/principal_state.py` — DestinationRef, PrincipalState, RetiredDestination
-- `core/reporting_canonical_content_digest.py` — ReportingCanonicalContentDigest
-- `core/reporting_canonicalization_contract.py` — AdditionalItem, EmptyReport, GoldenVectors, OrderingEncoding, ReportingCanonicalizationContract, ReportingPrimaryKey
-- `core/reporting_control_total.py` — ReportingControlTotal, ReportingControlTotal1, ReportingControlTotal2
-- `core/reporting_coverage.py` — Limitation, Reason, ReportingCoverage, ReportingMediaBuyId, ReportingPackageId, Status
-- `core/reporting_dataset_share_destination.py` — Provider, Recipient, ReportingCloud, ReportingDatasetShareDestination, ReportingDatasetShareDestination1, ReportingDatasetShareDestination2
-- `core/reporting_delivery_capabilities.py` — ReportingDeliveryCapabilities
-- `core/reporting_delivery_config.py` — CoverageRequirement, ReportingDeliveryConfiguration, Scope
-- `core/reporting_delivery_config_state.py` — Action, ReportingDeliveryConfigLifecycleState, ReportingDeliveryConfigurationState, Setup
-- `core/reporting_delivery_method.py` — Format, ReportingDeliveryMethod, ReportingDeliveryMethod1, ReportingDeliveryMethod2, ReportingDeliveryMethod3, ReportingOrchestration
-- `core/reporting_delivery_offering.py` — DestinationMode, Format, Method, ProducerIdentity, Provider, ReportingDeliveryOffering, ReportingDeliveryPattern, ReportingFeedPurpose, ReportingProfile
-- `core/reporting_delivery_ready_webhook.py` — Readiness, ReportingDeliveryReadyWebhook
-- `core/reporting_file_compression.py` — ReportingFileCompression
-- `core/reporting_file_entry.py` — ReportingFileEntry
-- `core/reporting_file_manifest.py` — Format, Period, ReportingFileManifest
-- `core/reporting_materialization.py` — Method, ReportingMaterialization, Status
-- `core/reporting_obligation.py` — Period, ProductionStatus, ReconciliationStatus, ReportingObligation
-- `core/reporting_receipt.py` — RejectionCode, ReportingReceipt, Status
-- `core/reporting_reconciliation_mode.py` — ReportingReconciliationMode
-- `core/reporting_report_definition.py` — Aggregation, Calendar, Dimension, FinalityPolicies, FinalityPolicies1, FinalityPolicies2, Metric, Provider, ReportCalendarTimezoneBasis, ReportingReportDefinition, RestatementPolicy, Source
-- `core/reporting_resource.py` — Immutability, Kind, ReportingReaderCompatibilityItem, ReportingResource
-- `core/reporting_revision.py` — DataThroughPrecision, FinalityBasis, Period, ReportingRevision
-- `core/reporting_schedule.py` — ReportingSchedule, ReportingScheduleAlignment
-- `core/reporting_schedule_offering.py` — PeriodAnchorPolicy, ReportingScheduleOffering
-- `core/reporting_status_changed_webhook.py` — IssueId, ReportingStatusChangedWebhook
-- `core/reporting_status_issue.py` — Code, RecommendedAction, ReportingStatusIssue, ReportingStatusSeverity, ResponsibleParty
-- `core/reporting_verification.py` — NativeCommitEvidence, ObservedThrough, PhysicalChecksums, PhysicalChecksums1, ReportingVerification, VerificationPath
-- `core/reporting_verification_profile.py` — ReportingVerificationProfile
-- `core/reporting_verification_profile_set.py` — ReportingVerificationProfileSet, ReportingVerificationProfileSetEnum
-- `core/reporting_write_destination.py` — Provider, ReportingWriteDestination, ReportingWriteDestination1, ReportingWriteDestination2
-- `enums/delivery_recipient_cloud.py` — DeliveryRecipientCloud
-- `enums/dooh_motion_type.py` — DoohMotionType
-- `enums/principal_kind.py` — PrincipalKind
-- `enums/reporting_destination_setup_state.py` — ReportingDestinationSetupState
-- `enums/reporting_finality.py` — ReportingFinality
-- `enums/reporting_health.py` — ReportingHealth
-- `formats/canonical/audio_vast.py` — CanonicalFormatVastAudio, DurationMsRangeItem
-- `media_buy/get_reporting_status_request.py` — DeliveryConfigId, GetReportingStatusRequest, Period, ReportingStatusView
-- `media_buy/get_reporting_status_response.py` — DeliveryConfigGeneration, GetReportingStatusResponse, ObligationCounts, Scope
-- `media_buy/sync_reporting_receipts_request.py` — SyncReportingReceiptsRequest
-- `media_buy/sync_reporting_receipts_response.py` — Results, Results18, Results19, SyncReportingReceiptsResponse
-- `protocol/get_principal_request.py` — GetPrincipalRequest
-- `protocol/get_principal_response.py` — GetPrincipalResponse, Result, Result6, Result7, Result9
-- `protocol/sync_principal_request.py` — Configuration, SyncPrincipalRequest
-- `protocol/sync_principal_response.py` — Action, Action29, Result, Result17, Result19, SyncPrincipalResponse
-
-## Field changes
-
-- `a2ui/si_catalog.py`
-  - **classes added**: Action22
-  - **classes removed**: Action19
-- `account/sync_accounts_request.py`
-  - `Accounts`: `+reporting_delivery_configs`
-  - `Accounts1`: `+reporting_delivery_configs`
-- `account/sync_accounts_response.py`
-  - `Account`: `+reporting_delivery_configs`
-- `bundled/protocol/get_adcp_capabilities_response.py`
-  - **classes added**: Alignment, Authentication5, BudgetCappingTimezoneBasis, BuyerReason, CapabilityReportingDeliveryMethod, DestinationMode, Format5, Method, Offering, Orchestration, Pattern, PeriodAnchorPolicy, PrimaryKey, Principal, ProducerIdentity, Provider, ReaderCompatibilityItem, ReconciliationMode, RegistrationTask, ReportingDelivery, ReportingDeliveryPattern, ReportingDestinationOffering, ReportingFeedPurpose, ReportingProfile, Schedule, SupportedFinalityEnum, SupportedSection, Transport3, VerificationProfile
-  - **classes removed**: Authentication4, ReportingDeliveryMethod, TimezoneBasis
-  - `Adcp`: `+principal`
-  - `AdcpError`: `+buyer_reason`
-  - `Error`: `+buyer_reason`
-  - `Format`: `+avro`, `+csv`, `+jsonl`, `+orc`, `+parquet` `-applies_to_channels`, `-canonical_formats_only`, `-display_name`, `-experimental`, `-format_kind`, `-format_option_id`, `-format_schema`, `-format_shape`, `-locale_policy`, `-macro_resolution_capabilities`, `-params`, `-publisher_domain`, `-sample_render_url`, `-seller_preference`, `-technical_requirements_complete`, `-v1_format_ref`
-  - `FormatKind`: `+audio_vast`
-  - `MediaBuy`: `+reporting_delivery`
-  - `Specialism`: `+sales_dooh`
-  - `Transport`: `+root` `-type`, `-url`
-- `collection/get_collection_list_response.py`
-  - `Collection`: `+collection_id`, `+publisher_domain`
-- `compliance/comply_test_controller_request.py`
-  - `Params`: `+dooh_metrics`, `+plays`
-- `core/account.py`
-  - `Account`: `+reporting_delivery_configs`
-- `core/agent_notification_config.py`
-  - `AgentNotificationConfig`: `+all_authorized_accounts`, `+include_future_event_types`
-- `core/canonical_format_kind.py`
-  - `CanonicalFormatKind`: `+audio_vast`
-- `core/canonical_format_option.py`
-  - `FormatKind`: `+audio_vast`
-- `core/canonical_media_buy_action.py`
-  - **classes added**: Action4
-  - **classes removed**: Action2
-  - `Action3`: `+add_packages`, `+cancel`, `+decrease_budget`, `+extend_flight`, `+increase_budget`, `+reallocate_budget`, `+remove_packages`, `+shorten_flight`, `+update_bidding`, `+update_budget_allocation`, `+update_flight_dates`, `+update_frequency_caps`, `+update_pacing`, `+update_targeting` `-remove_creative`, `-replace_creative`, `-update_creative_assignments`
-- `core/canonical_placement.py`
-  - **classes added**: CanonicalDoohPlacementAttributes, CanonicalDoohScreenResolution, Identifier
-  - `CanonicalProductPlacement1`: `+dooh_placement_attributes`, `+identifiers`
-  - `CanonicalProductPlacement2`: `+dooh_placement_attributes`, `+identifiers`
-- `core/collection_distribution.py`
-  - `CollectionDistribution`: `+property_ids`
-- `core/delivery_metrics.py`
-  - **classes added**: DoohMetrics1
-  - **classes removed**: DoohMetrics
-- `core/error.py`
-  - **classes added**: BuyerReason
-  - `Error`: `+buyer_reason`
-- `core/format.py`
-  - **classes added**: CanonicalParameters16
-- `core/notification_config.py`
-  - `EventType`: `+reporting_delivery_ready`, `+reporting_status_changed`
-- `core/package_format_snapshot.py`
-  - **classes added**: PackageFormatSnapshot32, PackageFormatSnapshot33
-  - `PackageFormatSnapshot16`: `+applies_to_channels`, `+canonical_formats_only`, `+display_name`, `+experimental`, `+format_kind`, `+format_option_id`, `+format_schema`, `+format_shape`, `+locale_policy`, `+macro_resolution_capabilities`, `+params`, `+publisher_domain`, `+sample_render_url`, `+seller_preference`, `+technical_requirements_complete`, `+tracker_execution_contract`, `+v1_format_ref` `-execution_daast_version`, `-execution_vast_version`, `-placement_refs`, `-product_id`, `-product_snapshot_digest`, `-tracker_execution_contract_digest`
-  - `PackageFormatSnapshot17`: `-format_kind`, `-params`
-- `core/placement.py`
-  - **classes added**: Identifier, ProductDoohPlacementAttributes, ProductDoohScreenResolution
-  - `Placement`: `+dooh_placement_attributes`, `+identifiers`
-- `core/placement_definition.py`
-  - **classes added**: Identifier, PublisherDoohPlacementAttributes, PublisherDoohScreenResolution
-  - `PlacementDefinition`: `+dooh_placement_attributes`, `+identifiers`
-- `core/reporting_capabilities.py`
-  - **classes added**: ReportingDeliveryOfferingId
-  - `ReportingCapabilities`: `+reporting_delivery_offering_ids`
-- `core/targeting.py`
-  - `TargetingOverlay`: `+collection_selection`
-- `core/transformer.py`
-  - **classes added**: InputFormat16, InputFormat34
-  - **classes removed**: InputFormat32
-- `core/x_entity_types.py`
-  - `XEntityTypes`: `+reporting_definition`, `+reporting_delivery_config`, `+reporting_destination`, `+reporting_materialization`, `+reporting_obligation`, `+reporting_offering`, `+reporting_receipt`, `+reporting_resource`, `+reporting_revision`
-- `enums/collection_kind.py`
-  - `CollectionKind`: `+channel`
-- `enums/distribution_identifier_type.py`
-  - `DistributionIdentifierType`: `+platform_channel_id`
-- `enums/error_code.py`
-  - `ErrorCode`: `+CREATIVE_MISSING_CLICK_URL`, `+CREATIVE_SIZE_MISMATCH`, `+CREATIVE_VALIDATION_FAILED_GENERIC`
-- `enums/notification_type.py`
-  - `NotificationType`: `+principal_changed`, `+reporting_delivery_ready`, `+reporting_status_changed`
-- `enums/specialism.py`
-  - `AdcpSpecialism`: `+sales_dooh`
-- `enums/task_type.py`
-  - `TaskType`: `+get_principal`, `+sync_principal`, `+sync_reporting_receipts`
-- `governance/sync_plans_response.py`
-  - **classes added**: Status44
-  - **classes removed**: Status40
-- `media_buy/get_media_buy_delivery_response.py`
-  - `BySpotItem`: `+creative_id`
-- `media_buy/get_products_request.py`
-  - **classes added**: Action9
-  - **classes removed**: Action7
-- `media_buy/product_refinement.py`
-  - **classes added**: Action11
-  - **classes removed**: Action9
-- `protocol/get_adcp_capabilities_response.py`
-  - **classes added**: BudgetCappingTimezoneBasis, CapabilityReportingDeliveryMethod, Format, Pattern, Principal, RegistrationTask, ReportingDestinationOffering, SupportedSection, Transport1
-  - **classes removed**: ExperimentalFeature, ReportingDeliveryMethod, TimezoneBasis
-  - `Adcp`: `+principal`
-  - `MediaBuy`: `+reporting_delivery`
-  - `Transport`: `+root` `-type`, `-url`
-- `sponsored_intelligence/si_sponsored_context_receipt.py`
-  - **classes added**: Status41
-  - **classes removed**: Status37
+_No field-shape changes detected._

pyproject.toml

@@ -193,7 +193,7 @@ adcp = [
     "_schemas/2.5/**/*.json",
     "_schemas/3.0/**/*.json",
     "_schemas/3.1/**/*.json",
-    "_schemas/3.2.0-beta.10/**/*.json",
+    "_schemas/3.2.0-beta.11/**/*.json",
     # Vendored canonical-formats reference fixtures (14 v2 products +
     # 50-entry v1 catalog) so :mod:`adcp.canonical_formats.fixtures`
     # can serve them to adopter test suites without forcing each

schemas/cache/3.2.0-beta.11/a2ui/bound-value.json

@@ -0,0 +1,80 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "A2UI Bound Value",
+  "description": "A value that can be a literal or bound to a path in the data model",
+  "oneOf": [
+    {
+      "type": "object",
+      "description": "Literal string value",
+      "properties": {
+        "literalString": {
+          "type": "string",
+          "description": "Static string value"
+        }
+      },
+      "required": [
+        "literalString"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "description": "Literal number value",
+      "properties": {
+        "literalNumber": {
+          "type": "number",
+          "description": "Static number value"
+        }
+      },
+      "required": [
+        "literalNumber"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "description": "Literal boolean value",
+      "properties": {
+        "literalBoolean": {
+          "type": "boolean",
+          "description": "Static boolean value"
+        }
+      },
+      "required": [
+        "literalBoolean"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "description": "Path to data model value",
+      "properties": {
+        "path": {
+          "type": "string",
+          "description": "JSON pointer path to value in data model (e.g., '/products/0/title')"
+        }
+      },
+      "required": [
+        "path"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "description": "Literal with path binding (sets default and binds)",
+      "properties": {
+        "literalString": {
+          "type": "string"
+        },
+        "path": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "literalString",
+        "path"
+      ],
+      "additionalProperties": false
+    }
+  ]
+}

schemas/cache/3.2.0-beta.11/a2ui/component.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "A2UI Component",
+  "description": "A component in an A2UI surface",
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "description": "Unique identifier for this component within the surface"
+    },
+    "parentId": {
+      "type": "string",
+      "description": "ID of the parent component (null for root)"
+    },
+    "component": {
+      "type": "object",
+      "description": "Component definition (keyed by component type)",
+      "minProperties": 1,
+      "maxProperties": 1,
+      "additionalProperties": {
+        "type": "object",
+        "description": "Component properties"
+      }
+    }
+  },
+  "required": [
+    "id",
+    "component"
+  ],
+  "additionalProperties": true
+}