feat(reporting): prototype reliable ledger reconciliation

SCHEMA_DELTAS.md

@@ -1,6 +1,37 @@
 # Generated-types delta
 
+## Files added
+
+- `core/agent_configuration_state.py` — AgentConfigurationState
+- `core/agent_notification_config_state.py` — AgentNotificationConfigState, Authentication
+- `core/agent_reporting_destination.py` — AcceptedFormat, AgentReportingDestination, AgentReportingDestination1, AgentReportingDestination2, AgentReportingDestination3, Pattern
+- `core/agent_reporting_destination_state.py` — Action, AgentReportingDestinationState, Setup, State
+- `core/delivery_provider.py` — DeliveryProvider
+- `core/delivery_recipient.py` — Cloud, DeliveryRecipient
+- `core/reporting_verification_profile_set.py` — ReportingVerificationProfileSet, ReportingVerificationProfileSetEnum
+- `protocol/sync_agent_configuration_request.py` — Configuration, SyncAgentConfigurationRequest
+- `protocol/sync_agent_configuration_response.py` — Action, Action26, Result, Result11, Result9, SyncAgentConfigurationResponse
+
 ## Field changes
 
-- `core/reporting_webhook.py`
-  - `ReportingWebhook`: `+operation_id`
+- `a2ui/si_catalog.py`
+  - **classes added**: Action21
+  - **classes removed**: Action20
+- `bundled/protocol/get_adcp_capabilities_response.py`
+  - **classes added**: Authentication5
+  - **classes removed**: Authentication4
+- `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`
+- `enums/task_type.py`
+  - `TaskType`: `+sync_agent_configuration`
+- `media_buy/get_products_request.py`
+  - **classes added**: Action8
+  - **classes removed**: Action7
+- `media_buy/product_refinement.py`
+  - **classes added**: Action10
+  - **classes removed**: Action9
+- `protocol/get_adcp_capabilities_response.py`
+  - **classes added**: AgentConfiguration, RegistrationTask, SupportedSection
+  - `Adcp`: `+agent_configuration`

schemas/cache/3.2.0-beta.9/account/sync-accounts-response.json

@@ -1,14 +1,15 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/schemas/account/sync-accounts-response.json",
   "title": "Sync Accounts Response",
   "description": "Response from account sync operation. Returns per-account results with status and billing, or operation-level errors on complete failure.",
   "type": "object",
   "allOf": [
     {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.9/core/version-envelope.json"
+      "$ref": "/schemas/core/version-envelope.json"
     },
     {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.9/core/protocol-envelope.json"
+      "$ref": "/schemas/core/protocol-envelope.json"
     }
   ],
   "oneOf": [
@@ -33,15 +34,15 @@
                 "x-entity": "account"
               },
               "brand": {
-                "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.9/core/brand-ref.json",
+                "$ref": "/schemas/core/brand-ref.json",
                 "description": "Current canonical brand reference for the account."
               },
               "operator": {
                 "type": "string",
                 "description": "Current canonical operator domain. When an identity change is pending or rejected, this remains the current value rather than echoing the requested value."
               },
               "operator_unit": {
-                "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.9/core/operator-unit.json",
+                "$ref": "/schemas/core/operator-unit.json",
                 "description": "Current canonical operator-owned business unit, agency seat, or platform account. The stable id participates in the natural key; name is mutable display metadata. This is distinct from the seller/storefront account_id. When an identity change is pending or rejected, this remains the current value rather than echoing the requested value."
               },
               "revision": {
@@ -50,11 +51,11 @@
                 "description": "Current account revision after this operation. Incremented by each persisted settings change, identity-change request, or identity-change disposition; not incremented by dry runs, validation failures, or exact idempotency replays. Pass this value in the next settings-update entry to prevent lost updates."
               },
               "identity_change": {
-                "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.9/core/account-identity-change.json",
+                "$ref": "/schemas/core/account-identity-change.json",
                 "description": "Pending or rejected desired operator identity. The top-level operator and operator_unit remain canonical until an approved change is applied."
               },
               "identity_change_preview": {
-                "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.9/core/account-identity-change-preview.json",
+                "$ref": "/schemas/core/account-identity-change-preview.json",
                 "description": "Dry-run-only preview of whether the requested identity would apply, require approval, or be blocked, plus evaluated resource impacts. This value is not persisted; canonical fields and revision remain current."
               },
               "currency": {
@@ -94,19 +95,19 @@
                 "description": "Account status. active: ready for use. pending_approval: seller reviewing (credit, legal). rejected: seller declined the account request. payment_required: credit limit reached or funds depleted. suspended: was active, now paused. closed: was active, now terminated."
               },
               "billing": {
-                "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.9/enums/billing-party.json",
+                "$ref": "/schemas/enums/billing-party.json",
                 "description": "Who is invoiced on this account. Matches the requested billing model."
               },
               "billing_entity": {
-                "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.9/core/business-entity.json",
+                "$ref": "/schemas/core/business-entity.json",
                 "description": "Current canonical business entity for the party responsible for payment. Sellers MAY add verified fields, but MUST NOT return data from a different entity. During an operator-domain handoff this remains the current entity until approval applies atomically; destination_billing_entity is staged and write-only. Bank details are omitted (write-only)."
               },
               "destination_billing_entity": {
                 "description": "Request-only staging field. It MUST NOT appear in sync_accounts responses.",
                 "not": {}
               },
               "account_scope": {
-                "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.9/enums/account-scope.json"
+                "$ref": "/schemas/enums/account-scope.json"
               },
               "setup": {
                 "type": "object",
@@ -137,7 +138,7 @@
                 "description": "Rate card applied to this account"
               },
               "payment_terms": {
-                "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.9/enums/payment-terms.json",
+                "$ref": "/schemas/enums/payment-terms.json",
                 "description": "Payment terms agreed for this account. When the account is active, these are the binding terms for all invoices on this account."
               },
               "credit_limit": {
@@ -161,7 +162,7 @@
                 "type": "array",
                 "description": "Per-account errors (only present when action is 'failed')",
                 "items": {
-                  "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.9/core/error.json"
+                  "$ref": "/schemas/core/error.json"
                 }
               },
               "warnings": {
@@ -179,13 +180,22 @@
                 "type": "array",
                 "description": "Applied notification subscribers for this account after declarative replacement and activation-proof checks. Present on `created`, `updated`, and `unchanged` results when the buyer included `notification_configs` in the request or any persisted entries exist on the account. Entries are keyed by account-scoped `subscriber_id`; re-sending an existing `subscriber_id` replaces that subscriber's config rather than creating a duplicate. Only configs that the seller has persisted are echoed. `authentication.credentials` is omitted on every entry (write-only).",
                 "items": {
-                  "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.9/core/notification-config.json"
+                  "$ref": "/schemas/core/notification-config.json"
+                },
+                "maxItems": 16
+              },
+              "reporting_delivery_configs": {
+                "type": "array",
+                "x-status": "experimental",
+                "description": "Resolved caller-owned durable reporting delivery configurations after declarative replacement. Each item echoes desired state and reports validation/setup state plus the seller-issued destination_ref when resolved. A setup action may direct an authenticated user to complete a provider grant or Open Sharing activation, but MUST NOT carry credentials or a bearer URL.",
+                "items": {
+                  "$ref": "/schemas/core/reporting-delivery-config-state.json"
                 },
                 "maxItems": 16
               },
               "authorization": {
-                "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.9/core/account-authorization.json",
-                "description": "Optional. The caller's scope grant against this account after the sync operation. Vendor agents of any type (media-buy, signals, governance, creative, brand) that support scope introspection SHOULD populate this so callers can preempt RBAC errors rather than discovering scope by trial and error. Media-buy sales agents claiming the `attestation_verifier` standard scope MUST populate it. Present on `created`, `updated`, and `unchanged` results; omitted on `failed` results (where the account did not reach a usable state). Absence means the vendor agent does not advertise introspectable scope \u2014 callers MUST NOT infer access from absence."
+                "$ref": "/schemas/core/account-authorization.json",
+                "description": "Optional. The caller's scope grant against this account after the sync operation. Vendor agents of any type (media-buy, signals, governance, creative, brand) that support scope introspection SHOULD populate this so callers can preempt RBAC errors rather than discovering scope by trial and error. Media-buy sales agents claiming the `attestation_verifier` standard scope MUST populate it. Present on `created`, `updated`, and `unchanged` results; omitted on `failed` results (where the account did not reach a usable state). Absence means the vendor agent does not advertise introspectable scope — callers MUST NOT infer access from absence."
               }
             },
             "required": [
@@ -211,10 +221,10 @@
           }
         },
         "context": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.9/core/context.json"
+          "$ref": "/schemas/core/context.json"
         },
         "ext": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.9/core/ext.json"
+          "$ref": "/schemas/core/ext.json"
         }
       },
       "required": [
@@ -276,15 +286,15 @@
           "type": "array",
           "description": "Operation-level errors (e.g., authentication failure, service unavailable)",
           "items": {
-            "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.9/core/error.json"
+            "$ref": "/schemas/core/error.json"
           },
           "minItems": 1
         },
         "context": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.9/core/context.json"
+          "$ref": "/schemas/core/context.json"
         },
         "ext": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.9/core/ext.json"
+          "$ref": "/schemas/core/ext.json"
         }
       },
       "required": [
@@ -309,7 +319,7 @@
   ],
   "examples": [
     {
-      "description": "Mixed results \u2014 one active, one pending approval",
+      "description": "Mixed results — one active, one pending approval",
       "data": {
         "status": "completed",
         "accounts": [
@@ -318,10 +328,7 @@
             "brand": {
               "domain": "nova-brands.com",
               "brand_id": "spark",
-              "countries": [
-                "DE",
-                "NL"
-              ]
+              "countries": ["DE", "NL"]
             },
             "operator": "pinnacle-media.com",
             "operator_unit": {
@@ -357,7 +364,7 @@
       }
     },
     {
-      "description": "Rejected account \u2014 no account_id assigned",
+      "description": "Rejected account — no account_id assigned",
       "data": {
         "status": "completed",
         "accounts": [
@@ -377,7 +384,7 @@
       }
     },
     {
-      "description": "Unsupported billing \u2014 seller rejects the request",
+      "description": "Unsupported billing — seller rejects the request",
       "data": {
         "status": "completed",
         "accounts": [
@@ -438,7 +445,7 @@
       }
     },
     {
-      "description": "Unsupported payment terms \u2014 seller rejects the request",
+      "description": "Unsupported payment terms — seller rejects the request",
       "data": {
         "status": "completed",
         "accounts": [
@@ -461,4 +468,4 @@
     }
   ],
   "properties": {}
-}
+}