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

adcp/types/generated_poc/property/property_error.py

@@ -0,0 +1,33 @@
+# generated by datamodel-codegen:
+#   filename:  property/property_error.json
+#   timestamp: 2026-01-14T17:08:13+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-14T17:08:13+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-14T17:08:13+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-14T17:08:13+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-14T17:08:13+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-14T17:08:13+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.AdvertisingChannels],
+        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-14T17:08:13+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-14T17:08:13+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/protocols/adcp_extension.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  protocols/adcp_extension.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-14T17:08:13+00:00
 
 from __future__ import annotations
 
@@ -8,30 +8,46 @@ from enum import Enum
 from typing import Annotated
 
 from adcp.types.base import AdCPBaseModel
-from pydantic import ConfigDict, Field
+from pydantic import ConfigDict, Field, RootModel
+
+
+class ExtensionsSupportedItem(RootModel[str]):
+    root: Annotated[
+        str,
+        Field(
+            description="Extension namespace (e.g., 'sustainability'). Must be lowercase alphanumeric with underscores.",
+            pattern="^[a-z][a-z0-9_]*$",
+        ),
+    ]
 
 
 class ProtocolsSupportedEnum(Enum):
-    media_buy = 'media_buy'
-    creative = 'creative'
-    signals = 'signals'
+    media_buy = "media_buy"
+    creative = "creative"
+    signals = "signals"
 
 
-class AdcpAgentCardExtension(AdCPBaseModel):
+class AdcpAgentCardExtensionParams(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     adcp_version: Annotated[
         str,
         Field(
-            description="Semantic version of the AdCP specification this agent implements (e.g., '2.4.0')",
-            pattern='^\\d+\\.\\d+\\.\\d+$',
+            description="Semantic version of the AdCP specification this agent implements (e.g., '2.5.0'). Extension schemas are versioned along with the AdCP spec.",
+            pattern="^\\d+\\.\\d+\\.\\d+$",
         ),
     ]
+    extensions_supported: Annotated[
+        list[ExtensionsSupportedItem] | None,
+        Field(
+            description="Typed extensions this agent supports. Each extension has a formal schema in /schemas/extensions/. Extension version is determined by adcp_version."
+        ),
+    ] = None
     protocols_supported: Annotated[
         list[ProtocolsSupportedEnum],
         Field(
-            description='AdCP protocol domains supported by this agent. At least one must be specified.',
+            description="AdCP protocol domains supported by this agent. At least one must be specified.",
             min_length=1,
         ),
     ]

adcp/types/generated_poc/signals/activate_signal_request.py

@@ -16,17 +16,17 @@ from ..core import ext as ext_1
 
 class ActivateSignalRequest(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     context: context_1.ContextObject | None = None
     deployments: Annotated[
         list[destination.Destination],
         Field(
-            description='Target deployment(s) for activation. If the authenticated caller matches one of these deployment targets, activation keys will be included in the response.',
+            description="Target deployment(s) for activation. If the authenticated caller matches one of these deployment targets, activation keys will be included in the response.",
             min_length=1,
         ),
     ]
     ext: ext_1.ExtensionObject | None = None
     signal_agent_segment_id: Annotated[
-        str, Field(description='The universal identifier for the signal to activate')
+        str, Field(description="The universal identifier for the signal to activate")
     ]

adcp/types/generated_poc/signals/activate_signal_response.py

@@ -16,25 +16,25 @@ from ..core import ext as ext_1
 
 class ActivateSignalResponse1(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     context: context_1.ContextObject | None = None
     deployments: Annotated[
         list[deployment.Deployment],
-        Field(description='Array of deployment results for each deployment target'),
+        Field(description="Array of deployment results for each deployment target"),
     ]
     ext: ext_1.ExtensionObject | None = None
 
 
 class ActivateSignalResponse2(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     context: context_1.ContextObject | None = None
     errors: Annotated[
         list[error.Error],
         Field(
-            description='Array of errors explaining why activation failed (e.g., platform connectivity issues, signal definition problems, authentication failures)',
+            description="Array of errors explaining why activation failed (e.g., platform connectivity issues, signal definition problems, authentication failures)",
             min_length=1,
         ),
     ]
@@ -45,7 +45,7 @@ class ActivateSignalResponse(RootModel[ActivateSignalResponse1 | ActivateSignalR
     root: Annotated[
         ActivateSignalResponse1 | ActivateSignalResponse2,
         Field(
-            description='Response payload for activate_signal task. Returns either complete success data OR error information, never both. This enforces atomic operation semantics - the signal is either fully activated or not activated at all.',
-            title='Activate Signal Response',
+            description="Response payload for activate_signal task. Returns either complete success data OR error information, never both. This enforces atomic operation semantics - the signal is either fully activated or not activated at all.",
+            title="Activate Signal Response",
         ),
     ]

adcp/types/generated_poc/signals/get_signals_request.py

@@ -16,20 +16,20 @@ from ..core import signal_filters
 
 
 class Country(RootModel[str]):
-    root: Annotated[str, Field(pattern='^[A-Z]{2}$')]
+    root: Annotated[str, Field(pattern="^[A-Z]{2}$")]
 
 
 class DeliverTo(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     countries: Annotated[
-        list[Country], Field(description='Countries where signals will be used (ISO codes)')
+        list[Country], Field(description="Countries where signals will be used (ISO codes)")
     ]
     deployments: Annotated[
         list[destination.Destination],
         Field(
-            description='List of deployment targets (DSPs, sales agents, etc.). If the authenticated caller matches one of these deployment targets, activation keys will be included in the response.',
+            description="List of deployment targets (DSPs, sales agents, etc.). If the authenticated caller matches one of these deployment targets, activation keys will be included in the response.",
             min_length=1,
         ),
     ]
@@ -37,17 +37,17 @@ class DeliverTo(AdCPBaseModel):
 
 class GetSignalsRequest(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     context: context_1.ContextObject | None = None
     deliver_to: Annotated[
-        DeliverTo, Field(description='Deployment targets where signals need to be activated')
+        DeliverTo, Field(description="Deployment targets where signals need to be activated")
     ]
     ext: ext_1.ExtensionObject | None = None
     filters: signal_filters.SignalFilters | None = None
     max_results: Annotated[
-        int | None, Field(description='Maximum number of results to return', ge=1)
+        int | None, Field(description="Maximum number of results to return", ge=1)
     ] = None
     signal_spec: Annotated[
-        str, Field(description='Natural language description of the desired signals')
+        str, Field(description="Natural language description of the desired signals")
     ]

adcp/types/generated_poc/signals/get_signals_response.py

@@ -17,42 +17,42 @@ from ..enums import signal_catalog_type
 
 class Pricing(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
-    cpm: Annotated[float, Field(description='Cost per thousand impressions', ge=0.0)]
-    currency: Annotated[str, Field(description='Currency code', pattern='^[A-Z]{3}$')]
+    cpm: Annotated[float, Field(description="Cost per thousand impressions", ge=0.0)]
+    currency: Annotated[str, Field(description="Currency code", pattern="^[A-Z]{3}$")]
 
 
 class Signal(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     coverage_percentage: Annotated[
-        float, Field(description='Percentage of audience coverage', ge=0.0, le=100.0)
+        float, Field(description="Percentage of audience coverage", ge=0.0, le=100.0)
     ]
-    data_provider: Annotated[str, Field(description='Name of the data provider')]
+    data_provider: Annotated[str, Field(description="Name of the data provider")]
     deployments: Annotated[
-        list[deployment.Deployment], Field(description='Array of deployment targets')
+        list[deployment.Deployment], Field(description="Array of deployment targets")
     ]
-    description: Annotated[str, Field(description='Detailed signal description')]
-    name: Annotated[str, Field(description='Human-readable signal name')]
-    pricing: Annotated[Pricing, Field(description='Pricing information')]
-    signal_agent_segment_id: Annotated[str, Field(description='Unique identifier for the signal')]
+    description: Annotated[str, Field(description="Detailed signal description")]
+    name: Annotated[str, Field(description="Human-readable signal name")]
+    pricing: Annotated[Pricing, Field(description="Pricing information")]
+    signal_agent_segment_id: Annotated[str, Field(description="Unique identifier for the signal")]
     signal_type: Annotated[
-        signal_catalog_type.SignalCatalogType, Field(description='Type of signal')
+        signal_catalog_type.SignalCatalogType, Field(description="Type of signal")
     ]
 
 
 class GetSignalsResponse(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     context: context_1.ContextObject | None = None
     errors: Annotated[
         list[error.Error] | None,
         Field(
-            description='Task-specific errors and warnings (e.g., signal discovery or pricing issues)'
+            description="Task-specific errors and warnings (e.g., signal discovery or pricing issues)"
         ),
     ] = None
     ext: ext_1.ExtensionObject | None = None
-    signals: Annotated[list[Signal], Field(description='Array of matching signals')]
+    signals: Annotated[list[Signal], Field(description="Array of matching signals")]

{adcp-2.18.0.dist-info → adcp-2.19.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: adcp
-Version: 2.18.0
+Version: 2.19.0
 Summary: Official Python client for the Ad Context Protocol (AdCP)
 Author-email: AdCP Community <maintainers@adcontextprotocol.org>
 License: Apache-2.0