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

adcp/types/generated_poc/pricing_options/cpp_option.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  pricing_options/cpp_option.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-26T11:40:01+00:00
 
 from __future__ import annotations
 
@@ -17,13 +17,25 @@ class Parameters(AdCPBaseModel):
     demographic: Annotated[
         str,
         Field(
-            description='Target demographic in Nielsen format: P/M/W/A/C + age range. Examples: P18-49 (Persons 18-49), M25-54 (Men 25-54), W35+ (Women 35+), A18-34 (Adults 18-34), C2-11 (Children 2-11)',
+            description='Target demographic in Nielsen format (P18-49, M25-54, W35+, etc.)',
             pattern='^[PMWAC][0-9]{2}(-[0-9]{2}|\\+)$',
         ),
     ]
-    min_points: Annotated[
-        float | None,
-        Field(description='Minimum GRPs/TRPs required for this pricing option', ge=0.0),
+    min_points: Annotated[float | None, Field(description='Minimum GRPs/TRPs required', ge=0.0)] = (
+        None
+    )
+
+
+class PriceGuidance(AdCPBaseModel):
+    p25: Annotated[
+        float | None, Field(description='25th percentile of recent winning bids', ge=0.0)
+    ] = None
+    p50: Annotated[float | None, Field(description='Median of recent winning bids', ge=0.0)] = None
+    p75: Annotated[
+        float | None, Field(description='75th percentile of recent winning bids', ge=0.0)
+    ] = None
+    p90: Annotated[
+        float | None, Field(description='90th percentile of recent winning bids', ge=0.0)
     ] = None
 
 
@@ -39,10 +51,20 @@ class CppPricingOption(AdCPBaseModel):
             pattern='^[A-Z]{3}$',
         ),
     ]
-    is_fixed: Annotated[
-        Literal[True],
-        Field(description='Whether this is a fixed rate (true) or auction-based (false)'),
-    ]
+    fixed_price: Annotated[
+        float | None,
+        Field(
+            description='Fixed price per rating point. If present, this is fixed pricing. If absent, auction-based.',
+            ge=0.0,
+        ),
+    ] = None
+    floor_price: Annotated[
+        float | None,
+        Field(
+            description='Minimum acceptable bid for auction pricing (mutually exclusive with fixed_price). Bids below this value will be rejected.',
+            ge=0.0,
+        ),
+    ] = None
     min_spend_per_package: Annotated[
         float | None,
         Field(
@@ -51,14 +73,15 @@ class CppPricingOption(AdCPBaseModel):
         ),
     ] = None
     parameters: Annotated[
-        Parameters,
-        Field(description='CPP-specific parameters for demographic targeting and GRP requirements'),
+        Parameters, Field(description='CPP-specific parameters for demographic targeting')
     ]
-    pricing_model: Annotated[Literal['cpp'], Field(description='Cost per Gross Rating Point')]
-    pricing_option_id: Annotated[
-        str,
+    price_guidance: Annotated[
+        PriceGuidance | None,
         Field(
-            description="Unique identifier for this pricing option within the product (e.g., 'cpp_usd_p18-49')"
+            description='Optional pricing guidance for auction-based bidding. Helps buyers calibrate bids with historical percentiles.'
         ),
+    ] = None
+    pricing_model: Annotated[Literal['cpp'], Field(description='Cost per Gross Rating Point')]
+    pricing_option_id: Annotated[
+        str, Field(description='Unique identifier for this pricing option within the product')
     ]
-    rate: Annotated[float, Field(description='Fixed CPP rate (cost per rating point)', ge=0.0)]

adcp/types/generated_poc/pricing_options/cpv_option.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  pricing_options/cpv_option.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-26T11:40:01+00:00
 
 from __future__ import annotations
 
@@ -14,7 +14,7 @@ class ViewThreshold(RootModel[float]):
     root: Annotated[
         float,
         Field(
-            description='Percentage completion threshold for CPV pricing (0.0 to 1.0, e.g., 0.5 = 50% completion)',
+            description='Percentage completion threshold (0.0 to 1.0, e.g., 0.5 = 50%)',
             ge=0.0,
             le=1.0,
         ),
@@ -25,13 +25,7 @@ class ViewThreshold1(AdCPBaseModel):
     model_config = ConfigDict(
         extra='allow',
     )
-    duration_seconds: Annotated[
-        int,
-        Field(
-            description="Seconds of viewing required (e.g., 30 for YouTube-style '30 seconds = view')",
-            ge=1,
-        ),
-    ]
+    duration_seconds: Annotated[int, Field(description='Seconds of viewing required', ge=1)]
 
 
 class Parameters(AdCPBaseModel):
@@ -41,6 +35,19 @@ class Parameters(AdCPBaseModel):
     view_threshold: ViewThreshold | ViewThreshold1
 
 
+class PriceGuidance(AdCPBaseModel):
+    p25: Annotated[
+        float | None, Field(description='25th percentile of recent winning bids', ge=0.0)
+    ] = None
+    p50: Annotated[float | None, Field(description='Median of recent winning bids', ge=0.0)] = None
+    p75: Annotated[
+        float | None, Field(description='75th percentile of recent winning bids', ge=0.0)
+    ] = None
+    p90: Annotated[
+        float | None, Field(description='90th percentile of recent winning bids', ge=0.0)
+    ] = None
+
+
 class CpvPricingOption(AdCPBaseModel):
     model_config = ConfigDict(
         extra='allow',
@@ -53,10 +60,20 @@ class CpvPricingOption(AdCPBaseModel):
             pattern='^[A-Z]{3}$',
         ),
     ]
-    is_fixed: Annotated[
-        Literal[True],
-        Field(description='Whether this is a fixed rate (true) or auction-based (false)'),
-    ]
+    fixed_price: Annotated[
+        float | None,
+        Field(
+            description='Fixed price per view. If present, this is fixed pricing. If absent, auction-based.',
+            ge=0.0,
+        ),
+    ] = None
+    floor_price: Annotated[
+        float | None,
+        Field(
+            description='Minimum acceptable bid for auction pricing (mutually exclusive with fixed_price). Bids below this value will be rejected.',
+            ge=0.0,
+        ),
+    ] = None
     min_spend_per_package: Annotated[
         float | None,
         Field(
@@ -67,11 +84,13 @@ class CpvPricingOption(AdCPBaseModel):
     parameters: Annotated[
         Parameters, Field(description='CPV-specific parameters defining the view threshold')
     ]
-    pricing_model: Annotated[Literal['cpv'], Field(description='Cost per view at threshold')]
-    pricing_option_id: Annotated[
-        str,
+    price_guidance: Annotated[
+        PriceGuidance | None,
         Field(
-            description="Unique identifier for this pricing option within the product (e.g., 'cpv_usd_50pct')"
+            description='Optional pricing guidance for auction-based bidding. Helps buyers calibrate bids with historical percentiles.'
         ),
+    ] = None
+    pricing_model: Annotated[Literal['cpv'], Field(description='Cost per view at threshold')]
+    pricing_option_id: Annotated[
+        str, Field(description='Unique identifier for this pricing option within the product')
     ]
-    rate: Annotated[float, Field(description='Fixed CPV rate (cost per view)', ge=0.0)]

adcp/types/generated_poc/pricing_options/flat_rate_option.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  pricing_options/flat_rate_option.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-26T11:40:01+00:00
 
 from __future__ import annotations
 
@@ -14,43 +14,37 @@ class Parameters(AdCPBaseModel):
     model_config = ConfigDict(
         extra='allow',
     )
-    daypart: Annotated[
-        str | None,
-        Field(
-            description="Specific daypart for time-based pricing (e.g., 'morning_commute', 'evening_prime', 'overnight')"
-        ),
-    ] = None
+    daypart: Annotated[str | None, Field(description='Specific daypart for time-based pricing')] = (
+        None
+    )
     duration_hours: Annotated[
-        float | None,
-        Field(description='Duration in hours for time-based flat rate pricing (DOOH)', ge=0.0),
+        float | None, Field(description='Duration in hours for time-based pricing', ge=0.0)
     ] = None
     estimated_impressions: Annotated[
-        int | None,
-        Field(
-            description='Estimated impressions for this flat rate option (informational, commonly used with SOV or time-based DOOH)',
-            ge=0,
-        ),
+        int | None, Field(description='Estimated impressions (informational)', ge=0)
     ] = None
     loop_duration_seconds: Annotated[
-        int | None, Field(description='Duration of ad loop rotation in seconds (DOOH)', ge=1)
-    ] = None
-    min_plays_per_hour: Annotated[
-        int | None,
-        Field(
-            description='Minimum number of times ad plays per hour (DOOH frequency guarantee)', ge=0
-        ),
+        int | None, Field(description='Duration of ad loop rotation in seconds', ge=1)
     ] = None
+    min_plays_per_hour: Annotated[int | None, Field(description='Minimum plays per hour', ge=0)] = (
+        None
+    )
     sov_percentage: Annotated[
-        float | None,
-        Field(
-            description='Guaranteed share of voice as percentage (DOOH, 0-100)', ge=0.0, le=100.0
-        ),
+        float | None, Field(description='Guaranteed share of voice (0-100)', ge=0.0, le=100.0)
     ] = None
-    venue_package: Annotated[
-        str | None,
-        Field(
-            description="Named venue package identifier for DOOH (e.g., 'times_square_network', 'airport_terminals')"
-        ),
+    venue_package: Annotated[str | None, Field(description='Named venue package identifier')] = None
+
+
+class PriceGuidance(AdCPBaseModel):
+    p25: Annotated[
+        float | None, Field(description='25th percentile of recent winning bids', ge=0.0)
+    ] = None
+    p50: Annotated[float | None, Field(description='Median of recent winning bids', ge=0.0)] = None
+    p75: Annotated[
+        float | None, Field(description='75th percentile of recent winning bids', ge=0.0)
+    ] = None
+    p90: Annotated[
+        float | None, Field(description='90th percentile of recent winning bids', ge=0.0)
     ] = None
 
 
@@ -66,10 +60,20 @@ class FlatRatePricingOption(AdCPBaseModel):
             pattern='^[A-Z]{3}$',
         ),
     ]
-    is_fixed: Annotated[
-        Literal[True],
-        Field(description='Whether this is a fixed rate (true) or auction-based (false)'),
-    ]
+    fixed_price: Annotated[
+        float | None,
+        Field(
+            description='Flat rate cost. If present, this is fixed pricing. If absent, auction-based.',
+            ge=0.0,
+        ),
+    ] = None
+    floor_price: Annotated[
+        float | None,
+        Field(
+            description='Minimum acceptable bid for auction pricing (mutually exclusive with fixed_price). Bids below this value will be rejected.',
+            ge=0.0,
+        ),
+    ] = None
     min_spend_per_package: Annotated[
         float | None,
         Field(
@@ -81,13 +85,15 @@ class FlatRatePricingOption(AdCPBaseModel):
         Parameters | None,
         Field(description='Flat rate parameters for DOOH and time-based campaigns'),
     ] = None
+    price_guidance: Annotated[
+        PriceGuidance | None,
+        Field(
+            description='Optional pricing guidance for auction-based bidding. Helps buyers calibrate bids with historical percentiles.'
+        ),
+    ] = None
     pricing_model: Annotated[
         Literal['flat_rate'], Field(description='Fixed cost regardless of delivery volume')
     ]
     pricing_option_id: Annotated[
-        str,
-        Field(
-            description="Unique identifier for this pricing option within the product (e.g., 'flat_rate_usd_24h_takeover')"
-        ),
+        str, Field(description='Unique identifier for this pricing option within the product')
     ]
-    rate: Annotated[float, Field(description='Flat rate cost', ge=0.0)]

adcp/types/generated_poc/pricing_options/{vcpm_auction_option.py → vcpm_option.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  pricing_options/vcpm_auction_option.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   filename:  pricing_options/vcpm_option.json
+#   timestamp: 2026-01-26T11:40:01+00:00
 
 from __future__ import annotations
 
@@ -11,7 +11,6 @@ from pydantic import ConfigDict, Field
 
 
 class PriceGuidance(AdCPBaseModel):
-    floor: Annotated[float, Field(description='Minimum acceptable bid price', ge=0.0)]
     p25: Annotated[
         float | None, Field(description='25th percentile of recent winning bids', ge=0.0)
     ] = None
@@ -24,7 +23,7 @@ class PriceGuidance(AdCPBaseModel):
     ] = None
 
 
-class VcpmAuctionPricingOption(AdCPBaseModel):
+class VcpmPricingOption(AdCPBaseModel):
     model_config = ConfigDict(
         extra='allow',
     )
@@ -36,10 +35,20 @@ class VcpmAuctionPricingOption(AdCPBaseModel):
             pattern='^[A-Z]{3}$',
         ),
     ]
-    is_fixed: Annotated[
-        Literal[False],
-        Field(description='Whether this is a fixed rate (true) or auction-based (false)'),
-    ]
+    fixed_price: Annotated[
+        float | None,
+        Field(
+            description='Fixed price per unit. If present, this is fixed pricing. If absent, auction-based.',
+            ge=0.0,
+        ),
+    ] = None
+    floor_price: Annotated[
+        float | None,
+        Field(
+            description='Minimum acceptable bid for auction pricing (mutually exclusive with fixed_price). Bids below this value will be rejected.',
+            ge=0.0,
+        ),
+    ] = None
     min_spend_per_package: Annotated[
         float | None,
         Field(
@@ -48,14 +57,14 @@ class VcpmAuctionPricingOption(AdCPBaseModel):
         ),
     ] = None
     price_guidance: Annotated[
-        PriceGuidance, Field(description='Statistical guidance for auction pricing')
-    ]
+        PriceGuidance | None,
+        Field(
+            description='Optional pricing guidance for auction-based bidding. Helps buyers calibrate bids with historical percentiles.'
+        ),
+    ] = None
     pricing_model: Annotated[
         Literal['vcpm'], Field(description='Cost per 1,000 viewable impressions (MRC standard)')
     ]
     pricing_option_id: Annotated[
-        str,
-        Field(
-            description="Unique identifier for this pricing option within the product (e.g., 'vcpm_usd_auction')"
-        ),
+        str, Field(description='Unique identifier for this pricing option within the product')
     ]

adcp/types/generated_poc/property/__init__.py

@@ -0,0 +1,3 @@
+# generated by datamodel-codegen:
+#   filename:  .schema_temp
+#   timestamp: 2026-01-14T17:08:13+00:00

adcp/types/generated_poc/property/base_property_source.py

@@ -0,0 +1,86 @@
+# generated by datamodel-codegen:
+#   filename:  property/base_property_source.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 ConfigDict, Field, RootModel
+
+from ..core import identifier, property_id, property_tag
+
+
+class BasePropertySource1(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    publisher_domain: Annotated[
+        str,
+        Field(
+            description="Domain where publisher's adagents.json is hosted (e.g., 'raptive.com')",
+            pattern='^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$',
+        ),
+    ]
+    selection_type: Annotated[
+        Literal['publisher_tags'],
+        Field(description='Discriminator indicating selection by property tags within a publisher'),
+    ]
+    tags: Annotated[
+        list[property_tag.PropertyTag],
+        Field(
+            description="Property tags from the publisher's adagents.json. Selects all properties with these tags.",
+            min_length=1,
+        ),
+    ]
+
+
+class BasePropertySource2(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    property_ids: Annotated[
+        list[property_id.PropertyId],
+        Field(description="Specific property IDs from the publisher's adagents.json", min_length=1),
+    ]
+    publisher_domain: Annotated[
+        str,
+        Field(
+            description="Domain where publisher's adagents.json is hosted (e.g., 'raptive.com')",
+            pattern='^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$',
+        ),
+    ]
+    selection_type: Annotated[
+        Literal['publisher_ids'],
+        Field(
+            description='Discriminator indicating selection by specific property IDs within a publisher'
+        ),
+    ]
+
+
+class BasePropertySource3(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    identifiers: Annotated[
+        list[identifier.Identifier],
+        Field(description='Direct property identifiers (domains, app IDs, etc.)', min_length=1),
+    ]
+    selection_type: Annotated[
+        Literal['identifiers'],
+        Field(description='Discriminator indicating selection by direct identifiers'),
+    ]
+
+
+class BasePropertySource(
+    RootModel[BasePropertySource1 | BasePropertySource2 | BasePropertySource3]
+):
+    root: Annotated[
+        BasePropertySource1 | BasePropertySource2 | BasePropertySource3,
+        Field(
+            description='A source of properties for a property list. Supports three selection patterns: publisher with tags, publisher with property IDs, or direct identifiers.',
+            discriminator='selection_type',
+            title='Base Property Source',
+        ),
+    ]

adcp/types/generated_poc/property/create_property_list_request.py

@@ -0,0 +1,43 @@
+# generated by datamodel-codegen:
+#   filename:  property/create_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 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 CreatePropertyListRequest(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 and requirements. When provided, the agent automatically applies appropriate rules based on brand characteristics (industry, target_audience, etc.).'
+        ),
+    ] = None
+    context: context_1.ContextObject | None = None
+    description: Annotated[str | None, Field(description="Description of the list's purpose")] = (
+        None
+    )
+    ext: ext_1.ExtensionObject | None = None
+    filters: Annotated[
+        property_list_filters.PropertyListFilters | None,
+        Field(description='Dynamic filters to apply when resolving the list'),
+    ] = None
+    name: Annotated[str, Field(description='Human-readable name for the list')]

adcp/types/generated_poc/property/create_property_list_response.py

@@ -0,0 +1,27 @@
+# generated by datamodel-codegen:
+#   filename:  property/create_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 CreatePropertyListResponse(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    auth_token: Annotated[
+        str,
+        Field(
+            description='Token that can be shared with sellers to authorize fetching this list. Store this - it is only returned at creation time.'
+        ),
+    ]
+    ext: ext_1.ExtensionObject | None = None
+    list: Annotated[property_list.PropertyList, Field(description='The created property list')]

adcp/types/generated_poc/property/delete_property_list_request.py

@@ -0,0 +1,22 @@
+# generated by datamodel-codegen:
+#   filename:  property/delete_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 ConfigDict, Field
+
+from ..core import context as context_1
+from ..core import ext as ext_1
+
+
+class DeletePropertyListRequest(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    context: context_1.ContextObject | None = None
+    ext: ext_1.ExtensionObject | None = None
+    list_id: Annotated[str, Field(description='ID of the property list to delete')]

adcp/types/generated_poc/property/delete_property_list_response.py

@@ -0,0 +1,21 @@
+# generated by datamodel-codegen:
+#   filename:  property/delete_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
+
+
+class DeletePropertyListResponse(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    deleted: Annotated[bool, Field(description='Whether the list was successfully deleted')]
+    ext: ext_1.ExtensionObject | None = None
+    list_id: Annotated[str, Field(description='ID of the deleted list')]

adcp/types/generated_poc/property/feature_requirement.py

@@ -0,0 +1,42 @@
+# generated by datamodel-codegen:
+#   filename:  property/feature_requirement.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from enum import Enum
+from typing import Annotated, Any
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import ConfigDict, Field
+
+
+class IfNotCovered(Enum):
+    exclude = 'exclude'
+    include = 'include'
+
+
+class FeatureRequirement(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    allowed_values: Annotated[
+        list[Any] | None,
+        Field(description='Values that pass the requirement (for binary/categorical features)'),
+    ] = None
+    feature_id: Annotated[
+        str, Field(description='Feature to evaluate (discovered via list_property_features)')
+    ]
+    if_not_covered: Annotated[
+        IfNotCovered | None,
+        Field(
+            description="How to handle properties where this feature is not covered. 'exclude' (default): property is removed from the list. 'include': property passes this requirement (fail-open)."
+        ),
+    ] = IfNotCovered.exclude
+    max_value: Annotated[
+        float | None, Field(description='Maximum numeric value allowed (for quantitative features)')
+    ] = None
+    min_value: Annotated[
+        float | None,
+        Field(description='Minimum numeric value required (for quantitative features)'),
+    ] = None

adcp/types/generated_poc/property/get_property_list_request.py

@@ -0,0 +1,34 @@
+# generated by datamodel-codegen:
+#   filename:  property/get_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 ConfigDict, Field
+
+from ..core import context as context_1
+from ..core import ext as ext_1
+
+
+class GetPropertyListRequest(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    context: context_1.ContextObject | None = None
+    cursor: Annotated[str | None, Field(description='Pagination cursor for large result sets')] = (
+        None
+    )
+    ext: ext_1.ExtensionObject | None = None
+    list_id: Annotated[str, Field(description='ID of the property list to retrieve')]
+    max_results: Annotated[
+        int | None, Field(description='Maximum identifiers to return (for large lists)', ge=1)
+    ] = None
+    resolve: Annotated[
+        bool | None,
+        Field(
+            description='Whether to apply filters and return resolved identifiers (default: true)'
+        ),
+    ] = True