adcp 2.18.0__py3-none-any.whl → 3.0.0__py3-none-any.whl

adcp/types/generated_poc/property/get_property_list_response.py

@@ -0,0 +1,61 @@
+# generated by datamodel-codegen:
+#   filename:  property/get_property_list_response.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import AwareDatetime, ConfigDict, Field
+
+from ..core import ext as ext_1
+from ..core import identifier
+from . import property_list
+
+
+class Pagination(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    cursor: Annotated[str | None, Field(description='Cursor for next page')] = None
+    has_more: Annotated[bool | None, Field(description='Whether more results are available')] = None
+
+
+class GetPropertyListResponse(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    cache_valid_until: Annotated[
+        AwareDatetime | None,
+        Field(
+            description='Cache expiration timestamp. Re-fetch the list after this time to get updated identifiers.'
+        ),
+    ] = None
+    coverage_gaps: Annotated[
+        dict[str, list[identifier.Identifier]] | None,
+        Field(
+            description="Properties included in the list despite missing feature data. Only present when a feature_requirement has if_not_covered='include'. Maps feature_id to list of identifiers not covered for that feature."
+        ),
+    ] = None
+    ext: ext_1.ExtensionObject | None = None
+    identifiers: Annotated[
+        list[identifier.Identifier] | None,
+        Field(
+            description='Resolved identifiers that passed filters (if resolve=true). Cache these locally for real-time use.'
+        ),
+    ] = None
+    list: Annotated[
+        property_list.PropertyList,
+        Field(description='The property list metadata (always returned)'),
+    ]
+    pagination: Annotated[Pagination | None, Field(description='Pagination information')] = None
+    resolved_at: Annotated[
+        AwareDatetime | None, Field(description='When the list was resolved')
+    ] = None
+    returned_count: Annotated[
+        int | None, Field(description='Number of identifiers returned in this response')
+    ] = None
+    total_count: Annotated[
+        int | None, Field(description='Total number of identifiers in resolved list')
+    ] = None

adcp/types/generated_poc/property/list_property_lists_request.py

@@ -0,0 +1,29 @@
+# generated by datamodel-codegen:
+#   filename:  property/list_property_lists_request.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import ConfigDict, Field
+
+from ..core import context as context_1
+from ..core import ext as ext_1
+
+
+class ListPropertyListsRequest(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    context: context_1.ContextObject | None = None
+    cursor: Annotated[str | None, Field(description='Pagination cursor')] = None
+    ext: ext_1.ExtensionObject | None = None
+    max_results: Annotated[int | None, Field(description='Maximum lists to return', ge=1)] = 100
+    name_contains: Annotated[
+        str | None, Field(description='Filter to lists whose name contains this string')
+    ] = None
+    principal: Annotated[
+        str | None, Field(description='Filter to lists owned by this principal')
+    ] = None

adcp/types/generated_poc/property/list_property_lists_response.py

@@ -0,0 +1,39 @@
+# generated by datamodel-codegen:
+#   filename:  property/list_property_lists_response.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import ConfigDict, Field
+
+from ..core import ext as ext_1
+from . import property_list
+
+
+class Pagination(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    cursor: Annotated[str | None, Field(description='Cursor for next page')] = None
+    has_more: Annotated[bool | None, Field(description='Whether more results are available')] = None
+
+
+class ListPropertyListsResponse(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    ext: ext_1.ExtensionObject | None = None
+    lists: Annotated[
+        list[property_list.PropertyList],
+        Field(description='Array of property lists (metadata only, not resolved properties)'),
+    ]
+    pagination: Annotated[Pagination | None, Field(description='Pagination information')] = None
+    returned_count: Annotated[
+        int | None, Field(description='Number of lists returned in this response')
+    ] = None
+    total_count: Annotated[
+        int | None, Field(description='Total number of lists matching criteria')
+    ] = None

adcp/types/generated_poc/property/property_error.py

@@ -0,0 +1,33 @@
+# generated by datamodel-codegen:
+#   filename:  property/property_error.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from enum import Enum
+from typing import Annotated
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import ConfigDict, Field
+
+from ..core import property as property_1
+
+
+class Code(Enum):
+    PROPERTY_NOT_FOUND = 'PROPERTY_NOT_FOUND'
+    PROPERTY_NOT_MONITORED = 'PROPERTY_NOT_MONITORED'
+    LIST_NOT_FOUND = 'LIST_NOT_FOUND'
+    LIST_ACCESS_DENIED = 'LIST_ACCESS_DENIED'
+    METHODOLOGY_NOT_SUPPORTED = 'METHODOLOGY_NOT_SUPPORTED'
+    JURISDICTION_NOT_SUPPORTED = 'JURISDICTION_NOT_SUPPORTED'
+
+
+class PropertyError(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    code: Annotated[Code, Field(description='Error code')]
+    message: Annotated[str, Field(description='Human-readable error message')]
+    property: Annotated[
+        property_1.Property | None, Field(description='The property that caused the error')
+    ] = None

adcp/types/generated_poc/property/property_feature.py

@@ -0,0 +1,22 @@
+# generated by datamodel-codegen:
+#   filename:  property/property_feature.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import ConfigDict, Field
+
+
+class PropertyFeature(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    feature_id: Annotated[str, Field(description='Identifier for the feature being assessed')]
+    source: Annotated[
+        str | None,
+        Field(description='Source of the feature data (e.g., app_store_privacy_label, tcf_string)'),
+    ] = None
+    value: Annotated[str, Field(description='The feature value')]

adcp/types/generated_poc/property/property_feature_definition.py

@@ -0,0 +1,80 @@
+# generated by datamodel-codegen:
+#   filename:  property/property_feature_definition.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from enum import Enum
+from typing import Annotated
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import AnyUrl, ConfigDict, Field
+
+from ..core import ext as ext_1
+
+
+class Coverage(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    countries: Annotated[
+        list[str] | None, Field(description='Countries where this feature is available')
+    ] = None
+    property_types: Annotated[
+        list[str] | None, Field(description='Property types this feature applies to')
+    ] = None
+
+
+class Range(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    max: Annotated[float, Field(description='Maximum value')]
+    min: Annotated[float, Field(description='Minimum value')]
+
+
+class Type(Enum):
+    binary = 'binary'
+    quantitative = 'quantitative'
+    categorical = 'categorical'
+
+
+class PropertyFeatureDefinition(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    allowed_values: Annotated[
+        list[str] | None, Field(description='For categorical features, the set of valid values')
+    ] = None
+    coverage: Annotated[
+        Coverage | None, Field(description='What this feature covers (empty arrays = all)')
+    ] = None
+    description: Annotated[
+        str | None, Field(description='Description of what this feature measures or represents')
+    ] = None
+    ext: ext_1.ExtensionObject | None = None
+    feature_id: Annotated[
+        str,
+        Field(
+            description="Unique identifier for this feature (e.g., 'consent_quality', 'carbon_score', 'coppa_certified')"
+        ),
+    ]
+    methodology_url: Annotated[
+        AnyUrl,
+        Field(
+            description='URL to documentation explaining how this feature is calculated/measured'
+        ),
+    ]
+    methodology_version: Annotated[
+        str | None, Field(description='Version identifier for the methodology (for audit trails)')
+    ] = None
+    name: Annotated[str, Field(description='Human-readable name for the feature')]
+    range: Annotated[
+        Range | None, Field(description='For quantitative features, the valid range of values')
+    ] = None
+    type: Annotated[
+        Type,
+        Field(
+            description='The type of values this feature produces: binary (true/false), quantitative (numeric range), categorical (enumerated values)'
+        ),
+    ]

adcp/types/generated_poc/property/property_list.py

@@ -0,0 +1,62 @@
+# generated by datamodel-codegen:
+#   filename:  property/property_list.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import AnyUrl, AwareDatetime, ConfigDict, Field
+
+from ..core import brand_manifest as brand_manifest_1
+from . import base_property_source, property_list_filters
+
+
+class PropertyList(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    base_properties: Annotated[
+        list[base_property_source.BasePropertySource] | None,
+        Field(
+            description="Array of property sources to evaluate. Each entry is a discriminated union: publisher_tags (publisher_domain + tags), publisher_ids (publisher_domain + property_ids), or identifiers (direct identifiers). If omitted, queries the agent's entire property database."
+        ),
+    ] = None
+    brand_manifest: Annotated[
+        brand_manifest_1.BrandManifest | None,
+        Field(description='Brand identity used to automatically apply appropriate rules'),
+    ] = None
+    cache_duration_hours: Annotated[
+        int | None,
+        Field(
+            description='Recommended cache duration for resolved list. Consumers should re-fetch after this period.',
+            ge=1,
+        ),
+    ] = 24
+    created_at: Annotated[AwareDatetime | None, Field(description='When the list was created')] = (
+        None
+    )
+    description: Annotated[str | None, Field(description="Description of the list's purpose")] = (
+        None
+    )
+    filters: Annotated[
+        property_list_filters.PropertyListFilters | None,
+        Field(description='Dynamic filters applied when resolving the list'),
+    ] = None
+    list_id: Annotated[str, Field(description='Unique identifier for this property list')]
+    name: Annotated[str, Field(description='Human-readable name for the list')]
+    principal: Annotated[
+        str | None, Field(description='Principal identity that owns this list')
+    ] = None
+    property_count: Annotated[
+        int | None,
+        Field(description='Number of properties in the resolved list (at time of last resolution)'),
+    ] = None
+    updated_at: Annotated[
+        AwareDatetime | None, Field(description='When the list was last modified')
+    ] = None
+    webhook_url: Annotated[
+        AnyUrl | None,
+        Field(description='URL to receive notifications when the resolved list changes'),
+    ] = None

adcp/types/generated_poc/property/property_list_changed_webhook.py

@@ -0,0 +1,51 @@
+# generated by datamodel-codegen:
+#   filename:  property/property_list_changed_webhook.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from typing import Annotated, Literal
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import AwareDatetime, ConfigDict, Field
+
+from ..core import ext as ext_1
+
+
+class ChangeSummary(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    properties_added: Annotated[
+        int | None, Field(description='Number of properties added since last resolution')
+    ] = None
+    properties_removed: Annotated[
+        int | None, Field(description='Number of properties removed since last resolution')
+    ] = None
+    total_properties: Annotated[
+        int | None, Field(description='Total properties in the resolved list')
+    ] = None
+
+
+class PropertyListChangedWebhook(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    cache_valid_until: Annotated[
+        AwareDatetime | None,
+        Field(description='When the consumer should refresh from the governance agent'),
+    ] = None
+    change_summary: Annotated[
+        ChangeSummary | None, Field(description='Summary of changes to the resolved list')
+    ] = None
+    event: Annotated[Literal['property_list_changed'], Field(description='The event type')]
+    ext: ext_1.ExtensionObject | None = None
+    list_id: Annotated[str, Field(description='ID of the property list that changed')]
+    list_name: Annotated[str | None, Field(description='Name of the property list')] = None
+    resolved_at: Annotated[AwareDatetime, Field(description='When the list was re-resolved')]
+    signature: Annotated[
+        str,
+        Field(
+            description="Cryptographic signature of the webhook payload, signed with the agent's private key. Recipients MUST verify this signature."
+        ),
+    ]

adcp/types/generated_poc/property/property_list_filters.py

@@ -0,0 +1,47 @@
+# generated by datamodel-codegen:
+#   filename:  property/property_list_filters.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import ConfigDict, Field, RootModel
+
+from ..core import identifier
+from ..enums import channels, property_type
+from . import feature_requirement
+
+
+class CountriesAllItem(RootModel[str]):
+    root: Annotated[str, Field(pattern='^[A-Z]{2}$')]
+
+
+class PropertyListFilters(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    channels_any: Annotated[
+        list[channels.MediaChannel],
+        Field(description='Property must support ANY of the listed channels. Required.'),
+    ]
+    countries_all: Annotated[
+        list[CountriesAllItem],
+        Field(
+            description='Property must have feature data for ALL listed countries (ISO codes). Required.'
+        ),
+    ]
+    exclude_identifiers: Annotated[
+        list[identifier.Identifier] | None,
+        Field(description='Identifiers to always exclude from results'),
+    ] = None
+    feature_requirements: Annotated[
+        list[feature_requirement.FeatureRequirement] | None,
+        Field(
+            description='Feature-based requirements. Property must pass ALL requirements (AND logic).'
+        ),
+    ] = None
+    property_types: Annotated[
+        list[property_type.PropertyType] | None, Field(description='Filter to these property types')
+    ] = None

adcp/types/generated_poc/property/update_property_list_request.py

@@ -0,0 +1,46 @@
+# generated by datamodel-codegen:
+#   filename:  property/update_property_list_request.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import AnyUrl, ConfigDict, Field
+
+from ..core import brand_manifest as brand_manifest_1
+from ..core import context as context_1
+from ..core import ext as ext_1
+from . import base_property_source, property_list_filters
+
+
+class UpdatePropertyListRequest(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    base_properties: Annotated[
+        list[base_property_source.BasePropertySource] | None,
+        Field(
+            description='Complete replacement for the base properties list (not a patch). Each entry is a discriminated union: publisher_tags (publisher_domain + tags), publisher_ids (publisher_domain + property_ids), or identifiers (direct identifiers).'
+        ),
+    ] = None
+    brand_manifest: Annotated[
+        brand_manifest_1.BrandManifest | None,
+        Field(description='Update brand identity and requirements'),
+    ] = None
+    context: context_1.ContextObject | None = None
+    description: Annotated[str | None, Field(description='New description')] = None
+    ext: ext_1.ExtensionObject | None = None
+    filters: Annotated[
+        property_list_filters.PropertyListFilters | None,
+        Field(description='Complete replacement for the filters (not a patch)'),
+    ] = None
+    list_id: Annotated[str, Field(description='ID of the property list to update')]
+    name: Annotated[str | None, Field(description='New name for the list')] = None
+    webhook_url: Annotated[
+        AnyUrl | None,
+        Field(
+            description='Update the webhook URL for list change notifications (set to empty string to remove)'
+        ),
+    ] = None

adcp/types/generated_poc/property/update_property_list_response.py

@@ -0,0 +1,21 @@
+# generated by datamodel-codegen:
+#   filename:  property/update_property_list_response.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import ConfigDict, Field
+
+from ..core import ext as ext_1
+from . import property_list
+
+
+class UpdatePropertyListResponse(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    ext: ext_1.ExtensionObject | None = None
+    list: Annotated[property_list.PropertyList, Field(description='The updated property list')]

adcp/types/generated_poc/protocol/__init__.py

@@ -0,0 +1,3 @@
+# generated by datamodel-codegen:
+#   filename:  .schema_temp
+#   timestamp: 2026-01-25T21:17:54+00:00

adcp/types/generated_poc/protocol/get_adcp_capabilities_request.py

@@ -0,0 +1,34 @@
+# generated by datamodel-codegen:
+#   filename:  protocol/get_adcp_capabilities_request.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from enum import Enum
+from typing import Annotated
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import ConfigDict, Field
+
+from ..core import context as context_1
+from ..core import ext as ext_1
+
+
+class Protocol(Enum):
+    media_buy = 'media_buy'
+    signals = 'signals'
+    sponsored_intelligence = 'sponsored_intelligence'
+
+
+class GetAdcpCapabilitiesRequest(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    context: context_1.ContextObject | None = None
+    ext: ext_1.ExtensionObject | None = None
+    protocols: Annotated[
+        list[Protocol] | None,
+        Field(
+            description='Specific protocols to query capabilities for. If omitted, returns capabilities for all supported protocols.'
+        ),
+    ] = None