feat(sdk): add principal, reporting, and controller support (#1121)

* feat(sdk): complete principal reporting and test controller support

* fix(principal): avoid webhook import cycle

Author: bokelley

src/adcp/__init__.py

@@ -203,6 +203,24 @@ def _resolve_version() -> str:
         "discover_oauth_metadata",
         "start_oauth_authorization",
     ),
+    "adcp.principal": (
+        "DestinationSetupSnapshot",
+        "PrincipalClient",
+        "PrincipalConfigurationError",
+        "PrincipalManager",
+        "PrincipalSyncOutcome",
+        "sync_principal_configuration",
+    ),
+    "adcp.reporting_inspection": (
+        "ControlTotalCalculator",
+        "HttpsReportingResourceReader",
+        "ManifestReportingInspector",
+        "ReportingCredentialProvider",
+        "ReportingInspectionCode",
+        "ReportingInspectionError",
+        "ReportingResourceReader",
+        "ReportingTrustedOriginPolicy",
+    ),
     "adcp.exceptions": (
         "AdagentsAccessBlockedError",
         "AdagentsNotFoundError",
@@ -319,13 +337,32 @@ def _resolve_version() -> str:
         "SyncAgentNotificationConfigsResponse",
         "GetPrincipalRequest",
         "GetPrincipalResponse",
+        "PrincipalAppliedResult",
+        "PrincipalChangedWebhook",
+        "PrincipalConfiguration",
+        "PrincipalCurrentResult",
+        "PrincipalDeclarationsState",
+        "PrincipalKind",
+        "PrincipalReadFailedResult",
+        "PrincipalReadResult",
+        "PrincipalRecognizedResult",
+        "PrincipalState",
+        "PrincipalSyncFailedResult",
+        "PrincipalSyncResult",
+        "PrincipalUnconfiguredResult",
+        "PrincipalValidatedResult",
         "GetReportingStatusRequest",
         "GetReportingStatusResponse",
         "SyncPrincipalRequest",
         "SyncPrincipalResponse",
         "SyncReportingReceiptsRequest",
         "SyncReportingReceiptsResponse",
         "AccountAuthorization",
+        "AgentDeclarations",
+        "AgentNotificationConfig",
+        "AgentNotificationConfigState",
+        "AgentReportingDestination",
+        "AgentReportingDestinationState",
         "AccountReference",
         "AccountScope",
         "AccountWithAuthorization",
@@ -1117,6 +1154,11 @@ def get_adcp_version() -> str:
     "McpWebhookPayload",
     # Account operations
     "AccountAuthorization",
+    "AgentDeclarations",
+    "AgentNotificationConfig",
+    "AgentNotificationConfigState",
+    "AgentReportingDestination",
+    "AgentReportingDestinationState",
     "AccountReference",
     "AccountWithAuthorization",
     "GetAccountFinancialsRequest",
@@ -1229,6 +1271,34 @@ def get_adcp_version() -> str:
     "SyncAgentNotificationConfigsResponse",
     "GetPrincipalRequest",
     "GetPrincipalResponse",
+    "PrincipalAppliedResult",
+    "PrincipalChangedWebhook",
+    "PrincipalConfiguration",
+    "PrincipalCurrentResult",
+    "PrincipalDeclarationsState",
+    "PrincipalKind",
+    "PrincipalReadFailedResult",
+    "PrincipalReadResult",
+    "PrincipalRecognizedResult",
+    "PrincipalState",
+    "PrincipalSyncFailedResult",
+    "PrincipalSyncResult",
+    "PrincipalUnconfiguredResult",
+    "PrincipalValidatedResult",
+    "DestinationSetupSnapshot",
+    "PrincipalClient",
+    "PrincipalConfigurationError",
+    "PrincipalManager",
+    "PrincipalSyncOutcome",
+    "sync_principal_configuration",
+    "ControlTotalCalculator",
+    "HttpsReportingResourceReader",
+    "ManifestReportingInspector",
+    "ReportingCredentialProvider",
+    "ReportingInspectionCode",
+    "ReportingInspectionError",
+    "ReportingResourceReader",
+    "ReportingTrustedOriginPolicy",
     "GetReportingStatusRequest",
     "GetReportingStatusResponse",
     "SyncPrincipalRequest",
@@ -1798,6 +1868,14 @@ def get_adcp_version() -> str:
         start_oauth_authorization,
     )
     from adcp.observability import get_tracer, inject_trace_headers, is_tracing_available
+    from adcp.principal import (
+        DestinationSetupSnapshot,
+        PrincipalClient,
+        PrincipalConfigurationError,
+        PrincipalManager,
+        PrincipalSyncOutcome,
+        sync_principal_configuration,
+    )
     from adcp.property_registry import PropertyRegistry
     from adcp.registry import RegistryClient
     from adcp.registry_sync import (
@@ -1806,6 +1884,16 @@ def get_adcp_version() -> str:
         FileCursorStore,
         RegistrySync,
     )
+    from adcp.reporting_inspection import (
+        ControlTotalCalculator,
+        HttpsReportingResourceReader,
+        ManifestReportingInspector,
+        ReportingCredentialProvider,
+        ReportingInspectionCode,
+        ReportingInspectionError,
+        ReportingResourceReader,
+        ReportingTrustedOriginPolicy,
+    )
     from adcp.substitution import (
         MacroMapping,
         MacroMappingEntry,
@@ -1874,6 +1962,11 @@ def get_adcp_version() -> str:
         ActivateSignalRequest,
         ActivateSignalResponse,
         AdvertiserIndustry,
+        AgentDeclarations,
+        AgentNotificationConfig,
+        AgentNotificationConfigState,
+        AgentReportingDestination,
+        AgentReportingDestinationState,
         # Creative types
         ArtifactWebhookPayload,
         AssetContentType,
@@ -2096,6 +2189,20 @@ def get_adcp_version() -> str:
         PriceGuidance,
         PricingCurrency,
         PricingModel,
+        PrincipalAppliedResult,
+        PrincipalChangedWebhook,
+        PrincipalConfiguration,
+        PrincipalCurrentResult,
+        PrincipalDeclarationsState,
+        PrincipalKind,
+        PrincipalReadFailedResult,
+        PrincipalReadResult,
+        PrincipalRecognizedResult,
+        PrincipalState,
+        PrincipalSyncFailedResult,
+        PrincipalSyncResult,
+        PrincipalUnconfiguredResult,
+        PrincipalValidatedResult,
         Product,
         ProductAllowedAction,
         ProductFilters,