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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (247) hide show
  1. adcp/ADCP_VERSION +1 -1
  2. adcp/__init__.py +6 -14
  3. adcp/__main__.py +94 -51
  4. adcp/adagents.py +91 -19
  5. adcp/client.py +865 -0
  6. adcp/protocols/a2a.py +84 -0
  7. adcp/protocols/base.py +101 -0
  8. adcp/protocols/mcp.py +84 -0
  9. adcp/server/__init__.py +49 -0
  10. adcp/server/base.py +368 -0
  11. adcp/server/content_standards.py +561 -0
  12. adcp/server/governance.py +491 -0
  13. adcp/server/mcp_tools.py +471 -0
  14. adcp/server/proposal.py +334 -0
  15. adcp/server/sponsored_intelligence.py +444 -0
  16. adcp/types/__init__.py +111 -23
  17. adcp/types/_ergonomic.py +35 -14
  18. adcp/types/_generated.py +346 -52
  19. adcp/types/aliases.py +13 -20
  20. adcp/types/base.py +1 -1
  21. adcp/types/generated_poc/adagents.py +196 -189
  22. adcp/types/generated_poc/content_standards/__init__.py +3 -0
  23. adcp/types/generated_poc/content_standards/artifact.py +208 -0
  24. adcp/types/generated_poc/content_standards/artifact_webhook_payload.py +64 -0
  25. adcp/types/generated_poc/content_standards/calibrate_content_request.py +17 -0
  26. adcp/types/generated_poc/content_standards/calibrate_content_response.py +74 -0
  27. adcp/types/generated_poc/content_standards/content_standards.py +66 -0
  28. adcp/types/generated_poc/content_standards/create_content_standards_request.py +97 -0
  29. adcp/types/generated_poc/content_standards/create_content_standards_response.py +52 -0
  30. adcp/types/generated_poc/content_standards/get_content_standards_request.py +21 -0
  31. adcp/types/generated_poc/content_standards/get_content_standards_response.py +43 -0
  32. adcp/types/generated_poc/content_standards/get_media_buy_artifacts_request.py +64 -0
  33. adcp/types/generated_poc/content_standards/get_media_buy_artifacts_response.py +117 -0
  34. adcp/types/generated_poc/content_standards/list_content_standards_request.py +31 -0
  35. adcp/types/generated_poc/content_standards/list_content_standards_response.py +48 -0
  36. adcp/types/generated_poc/content_standards/update_content_standards_request.py +101 -0
  37. adcp/types/generated_poc/content_standards/update_content_standards_response.py +34 -0
  38. adcp/types/generated_poc/content_standards/validate_content_delivery_request.py +59 -0
  39. adcp/types/generated_poc/content_standards/validate_content_delivery_response.py +85 -0
  40. adcp/types/generated_poc/core/activation_key.py +9 -9
  41. adcp/types/generated_poc/core/assets/audio_asset.py +6 -6
  42. adcp/types/generated_poc/core/assets/css_asset.py +3 -3
  43. adcp/types/generated_poc/core/assets/daast_asset.py +19 -19
  44. adcp/types/generated_poc/core/assets/html_asset.py +3 -3
  45. adcp/types/generated_poc/core/assets/image_asset.py +7 -7
  46. adcp/types/generated_poc/core/assets/javascript_asset.py +4 -4
  47. adcp/types/generated_poc/core/assets/text_asset.py +3 -3
  48. adcp/types/generated_poc/core/assets/url_asset.py +4 -4
  49. adcp/types/generated_poc/core/assets/vast_asset.py +19 -19
  50. adcp/types/generated_poc/core/assets/video_asset.py +8 -8
  51. adcp/types/generated_poc/core/assets/webhook_asset.py +10 -10
  52. adcp/types/generated_poc/core/async_response_data.py +3 -3
  53. adcp/types/generated_poc/core/brand_manifest.py +122 -59
  54. adcp/types/generated_poc/core/brand_manifest_ref.py +10 -10
  55. adcp/types/generated_poc/core/context.py +2 -2
  56. adcp/types/generated_poc/core/creative_asset.py +20 -19
  57. adcp/types/generated_poc/core/creative_assignment.py +4 -4
  58. adcp/types/generated_poc/core/creative_filters.py +18 -28
  59. adcp/types/generated_poc/core/creative_manifest.py +3 -3
  60. adcp/types/generated_poc/core/creative_policy.py +5 -5
  61. adcp/types/generated_poc/core/delivery_metrics.py +33 -33
  62. adcp/types/generated_poc/core/deployment.py +21 -21
  63. adcp/types/generated_poc/core/destination.py +12 -12
  64. adcp/types/generated_poc/core/error.py +7 -7
  65. adcp/types/generated_poc/core/ext.py +2 -2
  66. adcp/types/generated_poc/core/format.py +66 -66
  67. adcp/types/generated_poc/core/format_id.py +6 -6
  68. adcp/types/generated_poc/core/frequency_cap.py +3 -3
  69. adcp/types/generated_poc/core/identifier.py +3 -3
  70. adcp/types/generated_poc/core/mcp_webhook_payload.py +11 -11
  71. adcp/types/generated_poc/core/measurement.py +9 -9
  72. adcp/types/generated_poc/core/media_buy.py +8 -8
  73. adcp/types/generated_poc/core/media_buy_features.py +29 -0
  74. adcp/types/generated_poc/core/offering.py +80 -0
  75. adcp/types/generated_poc/core/package.py +9 -9
  76. adcp/types/generated_poc/core/performance_feedback.py +19 -19
  77. adcp/types/generated_poc/core/placement.py +5 -5
  78. adcp/types/generated_poc/core/pricing_option.py +9 -15
  79. adcp/types/generated_poc/core/product.py +21 -21
  80. adcp/types/generated_poc/core/product_allocation.py +48 -0
  81. adcp/types/generated_poc/core/product_filters.py +89 -24
  82. adcp/types/generated_poc/core/promoted_offerings.py +29 -38
  83. adcp/types/generated_poc/core/promoted_products.py +3 -3
  84. adcp/types/generated_poc/core/property.py +10 -10
  85. adcp/types/generated_poc/core/property_id.py +5 -5
  86. adcp/types/generated_poc/core/property_list_ref.py +5 -5
  87. adcp/types/generated_poc/core/property_tag.py +5 -5
  88. adcp/types/generated_poc/core/proposal.py +64 -0
  89. adcp/types/generated_poc/core/protocol_envelope.py +9 -9
  90. adcp/types/generated_poc/core/publisher_property_selector.py +14 -14
  91. adcp/types/generated_poc/core/push_notification_config.py +6 -6
  92. adcp/types/generated_poc/core/reporting_capabilities.py +9 -9
  93. adcp/types/generated_poc/core/reporting_webhook.py +70 -0
  94. adcp/types/generated_poc/core/response.py +5 -5
  95. adcp/types/generated_poc/core/signal_filters.py +6 -6
  96. adcp/types/generated_poc/core/start_timing.py +4 -4
  97. adcp/types/generated_poc/core/sub_asset.py +15 -15
  98. adcp/types/generated_poc/core/targeting.py +59 -18
  99. adcp/types/generated_poc/creative/list_creative_formats_request.py +21 -21
  100. adcp/types/generated_poc/creative/list_creative_formats_response.py +6 -6
  101. adcp/types/generated_poc/creative/preview_creative_request.py +25 -25
  102. adcp/types/generated_poc/creative/preview_creative_response.py +29 -29
  103. adcp/types/generated_poc/creative/preview_render.py +26 -26
  104. adcp/types/generated_poc/enums/adcp_domain.py +5 -5
  105. adcp/types/generated_poc/enums/asset_content_type.py +14 -14
  106. adcp/types/generated_poc/enums/auth_scheme.py +3 -3
  107. adcp/types/generated_poc/enums/available_metric.py +10 -10
  108. adcp/types/generated_poc/enums/channels.py +21 -11
  109. adcp/types/generated_poc/enums/co_branding_requirement.py +4 -4
  110. adcp/types/generated_poc/enums/creative_action.py +6 -6
  111. adcp/types/generated_poc/enums/creative_agent_capability.py +5 -5
  112. adcp/types/generated_poc/enums/creative_sort_field.py +7 -7
  113. adcp/types/generated_poc/enums/creative_status.py +6 -5
  114. adcp/types/generated_poc/enums/daast_tracking_event.py +12 -12
  115. adcp/types/generated_poc/enums/daast_version.py +3 -3
  116. adcp/types/generated_poc/enums/delivery_type.py +3 -3
  117. adcp/types/generated_poc/enums/dimension_unit.py +5 -5
  118. adcp/types/generated_poc/enums/feed_format.py +4 -4
  119. adcp/types/generated_poc/enums/feedback_source.py +5 -5
  120. adcp/types/generated_poc/enums/format_category.py +8 -8
  121. adcp/types/generated_poc/enums/format_id_parameter.py +3 -3
  122. adcp/types/generated_poc/enums/frequency_cap_scope.py +4 -4
  123. adcp/types/generated_poc/enums/geo_level.py +14 -0
  124. adcp/types/generated_poc/enums/history_entry_type.py +3 -3
  125. adcp/types/generated_poc/enums/http_method.py +3 -3
  126. adcp/types/generated_poc/enums/identifier_types.py +20 -20
  127. adcp/types/generated_poc/enums/javascript_module_type.py +4 -4
  128. adcp/types/generated_poc/enums/landing_page_requirement.py +4 -4
  129. adcp/types/generated_poc/enums/markdown_flavor.py +3 -3
  130. adcp/types/generated_poc/enums/media_buy_status.py +5 -5
  131. adcp/types/generated_poc/enums/metric_type.py +9 -9
  132. adcp/types/generated_poc/enums/metro_system.py +15 -0
  133. adcp/types/generated_poc/enums/notification_type.py +5 -5
  134. adcp/types/generated_poc/enums/pacing.py +4 -4
  135. adcp/types/generated_poc/enums/postal_system.py +19 -0
  136. adcp/types/generated_poc/enums/preview_output_format.py +3 -3
  137. adcp/types/generated_poc/enums/pricing_model.py +8 -8
  138. adcp/types/generated_poc/enums/property_type.py +9 -8
  139. adcp/types/generated_poc/enums/publisher_identifier_types.py +6 -6
  140. adcp/types/generated_poc/enums/reporting_frequency.py +4 -4
  141. adcp/types/generated_poc/enums/signal_catalog_type.py +4 -4
  142. adcp/types/generated_poc/enums/sort_direction.py +3 -3
  143. adcp/types/generated_poc/enums/task_status.py +10 -10
  144. adcp/types/generated_poc/enums/task_type.py +12 -12
  145. adcp/types/generated_poc/enums/update_frequency.py +5 -5
  146. adcp/types/generated_poc/enums/url_asset_type.py +4 -4
  147. adcp/types/generated_poc/enums/validation_mode.py +3 -3
  148. adcp/types/generated_poc/enums/vast_tracking_event.py +17 -17
  149. adcp/types/generated_poc/enums/vast_version.py +6 -6
  150. adcp/types/generated_poc/enums/webhook_response_type.py +5 -5
  151. adcp/types/generated_poc/enums/webhook_security_method.py +4 -4
  152. adcp/types/generated_poc/extensions/extension_meta.py +20 -12
  153. adcp/types/generated_poc/media_buy/build_creative_request.py +5 -5
  154. adcp/types/generated_poc/media_buy/build_creative_response.py +7 -7
  155. adcp/types/generated_poc/media_buy/create_media_buy_async_response_input_required.py +6 -6
  156. adcp/types/generated_poc/media_buy/create_media_buy_async_response_submitted.py +2 -2
  157. adcp/types/generated_poc/media_buy/create_media_buy_async_response_working.py +6 -6
  158. adcp/types/generated_poc/media_buy/create_media_buy_request.py +65 -37
  159. adcp/types/generated_poc/media_buy/create_media_buy_response.py +8 -8
  160. adcp/types/generated_poc/media_buy/get_media_buy_delivery_request.py +9 -9
  161. adcp/types/generated_poc/media_buy/get_media_buy_delivery_response.py +52 -52
  162. adcp/types/generated_poc/media_buy/get_products_async_response_input_required.py +7 -7
  163. adcp/types/generated_poc/media_buy/get_products_async_response_submitted.py +3 -3
  164. adcp/types/generated_poc/media_buy/get_products_async_response_working.py +5 -5
  165. adcp/types/generated_poc/media_buy/get_products_request.py +14 -5
  166. adcp/types/generated_poc/media_buy/get_products_response.py +12 -6
  167. adcp/types/generated_poc/media_buy/list_authorized_properties_request.py +4 -4
  168. adcp/types/generated_poc/media_buy/list_authorized_properties_response.py +9 -9
  169. adcp/types/generated_poc/media_buy/list_creative_formats_request.py +10 -10
  170. adcp/types/generated_poc/media_buy/list_creative_formats_response.py +6 -6
  171. adcp/types/generated_poc/media_buy/list_creatives_request.py +24 -24
  172. adcp/types/generated_poc/media_buy/list_creatives_response.py +54 -57
  173. adcp/types/generated_poc/media_buy/package_request.py +12 -12
  174. adcp/types/generated_poc/media_buy/package_update.py +119 -0
  175. adcp/types/generated_poc/media_buy/provide_performance_feedback_request.py +20 -20
  176. adcp/types/generated_poc/media_buy/provide_performance_feedback_response.py +7 -7
  177. adcp/types/generated_poc/media_buy/sync_creatives_async_response_input_required.py +6 -6
  178. adcp/types/generated_poc/media_buy/sync_creatives_async_response_submitted.py +2 -2
  179. adcp/types/generated_poc/media_buy/sync_creatives_async_response_working.py +8 -8
  180. adcp/types/generated_poc/media_buy/sync_creatives_request.py +8 -8
  181. adcp/types/generated_poc/media_buy/sync_creatives_response.py +16 -16
  182. adcp/types/generated_poc/media_buy/update_media_buy_async_response_input_required.py +5 -5
  183. adcp/types/generated_poc/media_buy/update_media_buy_async_response_submitted.py +2 -2
  184. adcp/types/generated_poc/media_buy/update_media_buy_async_response_working.py +6 -6
  185. adcp/types/generated_poc/media_buy/update_media_buy_request.py +28 -124
  186. adcp/types/generated_poc/media_buy/update_media_buy_response.py +8 -8
  187. adcp/types/generated_poc/pricing_options/cpc_option.py +40 -15
  188. adcp/types/generated_poc/pricing_options/cpcv_option.py +41 -16
  189. adcp/types/generated_poc/pricing_options/cpm_option.py +62 -0
  190. adcp/types/generated_poc/pricing_options/cpp_option.py +46 -23
  191. adcp/types/generated_poc/pricing_options/cpv_option.py +45 -26
  192. adcp/types/generated_poc/pricing_options/flat_rate_option.py +53 -47
  193. adcp/types/generated_poc/pricing_options/vcpm_option.py +70 -0
  194. adcp/types/generated_poc/property/base_property_source.py +16 -16
  195. adcp/types/generated_poc/property/create_property_list_request.py +5 -5
  196. adcp/types/generated_poc/property/create_property_list_response.py +4 -4
  197. adcp/types/generated_poc/property/delete_property_list_request.py +3 -3
  198. adcp/types/generated_poc/property/delete_property_list_response.py +4 -4
  199. adcp/types/generated_poc/property/feature_requirement.py +8 -8
  200. adcp/types/generated_poc/property/get_property_list_request.py +6 -6
  201. adcp/types/generated_poc/property/get_property_list_response.py +12 -12
  202. adcp/types/generated_poc/property/list_property_lists_request.py +6 -6
  203. adcp/types/generated_poc/property/list_property_lists_response.py +9 -9
  204. adcp/types/generated_poc/property/property_error.py +11 -11
  205. adcp/types/generated_poc/property/property_feature.py +5 -5
  206. adcp/types/generated_poc/property/property_feature_definition.py +19 -19
  207. adcp/types/generated_poc/property/property_list.py +12 -12
  208. adcp/types/generated_poc/property/property_list_changed_webhook.py +12 -12
  209. adcp/types/generated_poc/property/property_list_filters.py +9 -9
  210. adcp/types/generated_poc/property/update_property_list_request.py +9 -9
  211. adcp/types/generated_poc/property/update_property_list_response.py +3 -3
  212. adcp/types/generated_poc/protocol/__init__.py +3 -0
  213. adcp/types/generated_poc/protocol/get_adcp_capabilities_request.py +34 -0
  214. adcp/types/generated_poc/protocol/get_adcp_capabilities_response.py +353 -0
  215. adcp/types/generated_poc/protocols/adcp_extension.py +14 -17
  216. adcp/types/generated_poc/signals/activate_signal_request.py +4 -4
  217. adcp/types/generated_poc/signals/activate_signal_response.py +7 -7
  218. adcp/types/generated_poc/signals/get_signals_request.py +9 -9
  219. adcp/types/generated_poc/signals/get_signals_response.py +16 -16
  220. adcp/types/generated_poc/sponsored_intelligence/__init__.py +3 -0
  221. adcp/types/generated_poc/sponsored_intelligence/si_capabilities.py +102 -0
  222. adcp/types/generated_poc/sponsored_intelligence/si_get_offering_request.py +34 -0
  223. adcp/types/generated_poc/sponsored_intelligence/si_get_offering_response.py +100 -0
  224. adcp/types/generated_poc/sponsored_intelligence/si_identity.py +78 -0
  225. adcp/types/generated_poc/sponsored_intelligence/si_initiate_session_request.py +46 -0
  226. adcp/types/generated_poc/sponsored_intelligence/si_initiate_session_response.py +44 -0
  227. adcp/types/generated_poc/sponsored_intelligence/si_send_message_request.py +58 -0
  228. adcp/types/generated_poc/sponsored_intelligence/si_send_message_response.py +101 -0
  229. adcp/types/generated_poc/sponsored_intelligence/si_terminate_session_request.py +60 -0
  230. adcp/types/generated_poc/sponsored_intelligence/si_terminate_session_response.py +54 -0
  231. adcp/types/generated_poc/sponsored_intelligence/si_ui_element.py +30 -0
  232. adcp/utils/format_assets.py +5 -5
  233. adcp/utils/preview_cache.py +2 -2
  234. {adcp-2.19.0.dist-info → adcp-3.0.0.dist-info}/METADATA +1 -1
  235. adcp-3.0.0.dist-info/RECORD +264 -0
  236. {adcp-2.19.0.dist-info → adcp-3.0.0.dist-info}/WHEEL +1 -1
  237. adcp/types/generated_poc/enums/standard_format_ids.py +0 -45
  238. adcp/types/generated_poc/pricing_options/cpm_auction_option.py +0 -58
  239. adcp/types/generated_poc/pricing_options/cpm_fixed_option.py +0 -43
  240. adcp/types/generated_poc/pricing_options/vcpm_auction_option.py +0 -61
  241. adcp/types/generated_poc/pricing_options/vcpm_fixed_option.py +0 -47
  242. adcp/types/generated_poc/property/list_property_features_request.py +0 -25
  243. adcp/types/generated_poc/property/list_property_features_response.py +0 -24
  244. adcp-2.19.0.dist-info/RECORD +0 -220
  245. {adcp-2.19.0.dist-info → adcp-3.0.0.dist-info}/entry_points.txt +0 -0
  246. {adcp-2.19.0.dist-info → adcp-3.0.0.dist-info}/licenses/LICENSE +0 -0
  247. {adcp-2.19.0.dist-info → adcp-3.0.0.dist-info}/top_level.txt +0 -0
@@ -1,6 +1,6 @@
1
1
  # generated by datamodel-codegen:
2
2
  # filename: media_buy/create_media_buy_request.json
3
- # timestamp: 2026-01-08T19:25:24+00:00
3
+ # timestamp: 2026-01-25T21:17:54+00:00
4
4
 
5
5
  from __future__ import annotations
6
6
 
@@ -13,6 +13,7 @@ from pydantic import AnyUrl, AwareDatetime, ConfigDict, Field
13
13
  from ..core import brand_manifest_ref
14
14
  from ..core import context as context_1
15
15
  from ..core import ext as ext_1
16
+ from ..core import reporting_webhook as reporting_webhook_1
16
17
  from ..core import start_timing
17
18
  from ..enums import auth_scheme
18
19
  from . import package_request
@@ -20,12 +21,12 @@ from . import package_request
20
21
 
21
22
  class Authentication(AdCPBaseModel):
22
23
  model_config = ConfigDict(
23
- extra="forbid",
24
+ extra='forbid',
24
25
  )
25
26
  credentials: Annotated[
26
27
  str,
27
28
  Field(
28
- description="Credentials for authentication. For Bearer: token sent in Authorization header. For HMAC-SHA256: shared secret used to generate signature. Minimum 32 characters. Exchanged out-of-band during onboarding.",
29
+ description='Credentials for authentication. For Bearer: token sent in Authorization header. For HMAC-SHA256: shared secret used to generate signature. Minimum 32 characters. Exchanged out-of-band during onboarding.',
29
30
  min_length=32,
30
31
  ),
31
32
  ]
@@ -39,78 +40,105 @@ class Authentication(AdCPBaseModel):
39
40
  ]
40
41
 
41
42
 
42
- class ReportingFrequency(Enum):
43
- hourly = "hourly"
44
- daily = "daily"
45
- monthly = "monthly"
43
+ class BatchFrequency(Enum):
44
+ hourly = 'hourly'
45
+ daily = 'daily'
46
46
 
47
47
 
48
- class RequestedMetric(Enum):
49
- impressions = "impressions"
50
- spend = "spend"
51
- clicks = "clicks"
52
- ctr = "ctr"
53
- video_completions = "video_completions"
54
- completion_rate = "completion_rate"
55
- conversions = "conversions"
56
- viewability = "viewability"
57
- engagement_rate = "engagement_rate"
48
+ class DeliveryMode(Enum):
49
+ realtime = 'realtime'
50
+ batched = 'batched'
58
51
 
59
52
 
60
- class ReportingWebhook(AdCPBaseModel):
53
+ class ArtifactWebhook(AdCPBaseModel):
61
54
  model_config = ConfigDict(
62
- extra="allow",
55
+ extra='allow',
63
56
  )
64
57
  authentication: Annotated[
65
58
  Authentication,
66
- Field(description="Authentication configuration for webhook delivery (A2A-compatible)"),
59
+ Field(description='Authentication configuration for webhook delivery (A2A-compatible)'),
67
60
  ]
68
- reporting_frequency: Annotated[
69
- ReportingFrequency,
61
+ batch_frequency: Annotated[
62
+ BatchFrequency | None,
70
63
  Field(
71
- description="Frequency for automated reporting delivery. Must be supported by all products in the media buy."
64
+ description="For batched delivery, how often to push artifacts. Required when delivery_mode is 'batched'."
65
+ ),
66
+ ] = None
67
+ delivery_mode: Annotated[
68
+ DeliveryMode,
69
+ Field(
70
+ description="How artifacts are delivered. 'realtime' pushes artifacts as impressions occur. 'batched' aggregates artifacts and pushes periodically (see batch_frequency)."
72
71
  ),
73
72
  ]
74
- requested_metrics: Annotated[
75
- list[RequestedMetric] | None,
73
+ sampling_rate: Annotated[
74
+ float | None,
76
75
  Field(
77
- description="Optional list of metrics to include in webhook notifications. If omitted, all available metrics are included. Must be subset of product's available_metrics."
76
+ description='Fraction of impressions to include (0-1). 1.0 = all impressions, 0.1 = 10% sample. Default: 1.0',
77
+ ge=0.0,
78
+ le=1.0,
78
79
  ),
79
80
  ] = None
80
81
  token: Annotated[
81
82
  str | None,
82
83
  Field(
83
- description="Optional client-provided token for webhook validation. Echoed back in webhook payload to validate request authenticity.",
84
+ description='Optional client-provided token for webhook validation. Echoed back in webhook payload to validate request authenticity.',
84
85
  min_length=16,
85
86
  ),
86
87
  ] = None
87
- url: Annotated[AnyUrl, Field(description="Webhook endpoint URL for reporting notifications")]
88
+ url: Annotated[AnyUrl, Field(description='Webhook endpoint URL for artifact delivery')]
89
+
90
+
91
+ class TotalBudget(AdCPBaseModel):
92
+ model_config = ConfigDict(
93
+ extra='forbid',
94
+ )
95
+ amount: Annotated[float, Field(description='Total budget amount', ge=0.0)]
96
+ currency: Annotated[str, Field(description='ISO 4217 currency code')]
88
97
 
89
98
 
90
99
  class CreateMediaBuyRequest(AdCPBaseModel):
91
100
  model_config = ConfigDict(
92
- extra="allow",
101
+ extra='allow',
93
102
  )
103
+ artifact_webhook: Annotated[
104
+ ArtifactWebhook | None,
105
+ Field(
106
+ description='Optional webhook configuration for content artifact delivery. Used by governance agents to validate content adjacency. Seller pushes artifacts to this endpoint; orchestrator forwards to governance agent for validation.'
107
+ ),
108
+ ] = None
94
109
  brand_manifest: Annotated[
95
110
  brand_manifest_ref.BrandManifestReference,
96
111
  Field(
97
- description="Brand information manifest serving as the namespace and identity for this media buy. Provides brand context, assets, and product catalog. Can be provided inline or as a URL reference to a hosted manifest. Can be cached and reused across multiple requests."
112
+ description='Brand information manifest serving as the namespace and identity for this media buy. Provides brand context, assets, and product catalog. Can be provided inline or as a URL reference to a hosted manifest. Can be cached and reused across multiple requests.'
98
113
  ),
99
114
  ]
100
115
  buyer_ref: Annotated[str, Field(description="Buyer's reference identifier for this media buy")]
101
116
  context: context_1.ContextObject | None = None
102
117
  end_time: Annotated[
103
- AwareDatetime, Field(description="Campaign end date/time in ISO 8601 format")
118
+ AwareDatetime, Field(description='Campaign end date/time in ISO 8601 format')
104
119
  ]
105
120
  ext: ext_1.ExtensionObject | None = None
106
121
  packages: Annotated[
107
- list[package_request.PackageRequest], Field(description="Array of package configurations")
108
- ]
109
- po_number: Annotated[str | None, Field(description="Purchase order number for tracking")] = None
110
- reporting_webhook: Annotated[
111
- ReportingWebhook | None,
122
+ list[package_request.PackageRequest] | None,
123
+ Field(
124
+ description="Array of package configurations. Required when not using proposal_id. When executing a proposal, this can be omitted and packages will be derived from the proposal's allocations."
125
+ ),
126
+ ] = None
127
+ po_number: Annotated[str | None, Field(description='Purchase order number for tracking')] = None
128
+ proposal_id: Annotated[
129
+ str | None,
112
130
  Field(
113
- description="Optional webhook configuration for automated reporting delivery. Combines push_notification_config structure with reporting-specific fields."
131
+ description="ID of a proposal from get_products to execute. When provided with total_budget, the publisher converts the proposal's allocation percentages into packages automatically. Alternative to providing packages array."
114
132
  ),
115
133
  ] = None
134
+ reporting_webhook: Annotated[
135
+ reporting_webhook_1.ReportingWebhook | None,
136
+ Field(description='Optional webhook configuration for automated reporting delivery'),
137
+ ] = None
116
138
  start_time: start_timing.StartTiming
139
+ total_budget: Annotated[
140
+ TotalBudget | None,
141
+ Field(
142
+ description="Total budget for the media buy when executing a proposal. The publisher applies the proposal's allocation percentages to this amount to derive package budgets."
143
+ ),
144
+ ] = None
@@ -1,6 +1,6 @@
1
1
  # generated by datamodel-codegen:
2
2
  # filename: media_buy/create_media_buy_response.json
3
- # timestamp: 2026-01-08T19:25:24+00:00
3
+ # timestamp: 2026-01-25T21:17:54+00:00
4
4
 
5
5
  from __future__ import annotations
6
6
 
@@ -17,24 +17,24 @@ from ..core import package
17
17
 
18
18
  class CreateMediaBuyResponse2(AdCPBaseModel):
19
19
  model_config = ConfigDict(
20
- extra="allow",
20
+ extra='allow',
21
21
  )
22
22
  context: context_1.ContextObject | None = None
23
23
  errors: Annotated[
24
24
  list[error.Error],
25
- Field(description="Array of errors explaining why the operation failed", min_length=1),
25
+ Field(description='Array of errors explaining why the operation failed', min_length=1),
26
26
  ]
27
27
  ext: ext_1.ExtensionObject | None = None
28
28
 
29
29
 
30
30
  class CreateMediaBuyResponse1(AdCPBaseModel):
31
31
  model_config = ConfigDict(
32
- extra="allow",
32
+ extra='allow',
33
33
  )
34
34
  buyer_ref: Annotated[str, Field(description="Buyer's reference identifier for this media buy")]
35
35
  context: context_1.ContextObject | None = None
36
36
  creative_deadline: Annotated[
37
- AwareDatetime | None, Field(description="ISO 8601 timestamp for creative upload deadline")
37
+ AwareDatetime | None, Field(description='ISO 8601 timestamp for creative upload deadline')
38
38
  ] = None
39
39
  ext: ext_1.ExtensionObject | None = None
40
40
  media_buy_id: Annotated[
@@ -42,7 +42,7 @@ class CreateMediaBuyResponse1(AdCPBaseModel):
42
42
  ]
43
43
  packages: Annotated[
44
44
  list[package.Package],
45
- Field(description="Array of created packages with complete state information"),
45
+ Field(description='Array of created packages with complete state information'),
46
46
  ]
47
47
 
48
48
 
@@ -50,7 +50,7 @@ class CreateMediaBuyResponse(RootModel[CreateMediaBuyResponse1 | CreateMediaBuyR
50
50
  root: Annotated[
51
51
  CreateMediaBuyResponse1 | CreateMediaBuyResponse2,
52
52
  Field(
53
- description="Response payload for create_media_buy task. Returns either complete success data OR error information, never both. This enforces atomic operation semantics - the media buy is either fully created or not created at all.",
54
- title="Create Media Buy Response",
53
+ description='Response payload for create_media_buy task. Returns either complete success data OR error information, never both. This enforces atomic operation semantics - the media buy is either fully created or not created at all.',
54
+ title='Create Media Buy Response',
55
55
  ),
56
56
  ]
@@ -1,6 +1,6 @@
1
1
  # generated by datamodel-codegen:
2
2
  # filename: media_buy/get_media_buy_delivery_request.json
3
- # timestamp: 2026-01-08T19:25:24+00:00
3
+ # timestamp: 2026-01-25T21:17:54+00:00
4
4
 
5
5
  from __future__ import annotations
6
6
 
@@ -16,32 +16,32 @@ from ..enums import media_buy_status
16
16
 
17
17
  class GetMediaBuyDeliveryRequest(AdCPBaseModel):
18
18
  model_config = ConfigDict(
19
- extra="allow",
19
+ extra='allow',
20
20
  )
21
21
  buyer_refs: Annotated[
22
- list[str] | None, Field(description="Array of buyer reference IDs to get delivery data for")
22
+ list[str] | None, Field(description='Array of buyer reference IDs to get delivery data for')
23
23
  ] = None
24
24
  context: context_1.ContextObject | None = None
25
25
  end_date: Annotated[
26
26
  str | None,
27
27
  Field(
28
- description="End date for reporting period (YYYY-MM-DD)",
29
- pattern="^\\d{4}-\\d{2}-\\d{2}$",
28
+ description='End date for reporting period (YYYY-MM-DD)',
29
+ pattern='^\\d{4}-\\d{2}-\\d{2}$',
30
30
  ),
31
31
  ] = None
32
32
  ext: ext_1.ExtensionObject | None = None
33
33
  media_buy_ids: Annotated[
34
34
  list[str] | None,
35
- Field(description="Array of publisher media buy IDs to get delivery data for"),
35
+ Field(description='Array of publisher media buy IDs to get delivery data for'),
36
36
  ] = None
37
37
  start_date: Annotated[
38
38
  str | None,
39
39
  Field(
40
- description="Start date for reporting period (YYYY-MM-DD)",
41
- pattern="^\\d{4}-\\d{2}-\\d{2}$",
40
+ description='Start date for reporting period (YYYY-MM-DD)',
41
+ pattern='^\\d{4}-\\d{2}-\\d{2}$',
42
42
  ),
43
43
  ] = None
44
44
  status_filter: Annotated[
45
45
  media_buy_status.MediaBuyStatus | list[media_buy_status.MediaBuyStatus] | None,
46
- Field(description="Filter by status. Can be a single status or array of statuses"),
46
+ Field(description='Filter by status. Can be a single status or array of statuses'),
47
47
  ] = None
@@ -1,6 +1,6 @@
1
1
  # generated by datamodel-codegen:
2
2
  # filename: media_buy/get_media_buy_delivery_response.json
3
- # timestamp: 2026-01-08T19:25:24+00:00
3
+ # timestamp: 2026-01-25T21:17:54+00:00
4
4
 
5
5
  from __future__ import annotations
6
6
 
@@ -19,49 +19,49 @@ from ..enums import pricing_model as pricing_model_1
19
19
 
20
20
  class AggregatedTotals(AdCPBaseModel):
21
21
  model_config = ConfigDict(
22
- extra="allow",
22
+ extra='allow',
23
23
  )
24
24
  clicks: Annotated[
25
25
  float | None,
26
- Field(description="Total clicks across all media buys (if applicable)", ge=0.0),
26
+ Field(description='Total clicks across all media buys (if applicable)', ge=0.0),
27
27
  ] = None
28
28
  impressions: Annotated[
29
- float, Field(description="Total impressions delivered across all media buys", ge=0.0)
29
+ float, Field(description='Total impressions delivered across all media buys', ge=0.0)
30
30
  ]
31
31
  media_buy_count: Annotated[
32
- int, Field(description="Number of media buys included in the response", ge=0)
32
+ int, Field(description='Number of media buys included in the response', ge=0)
33
33
  ]
34
- spend: Annotated[float, Field(description="Total amount spent across all media buys", ge=0.0)]
34
+ spend: Annotated[float, Field(description='Total amount spent across all media buys', ge=0.0)]
35
35
  video_completions: Annotated[
36
36
  float | None,
37
- Field(description="Total video completions across all media buys (if applicable)", ge=0.0),
37
+ Field(description='Total video completions across all media buys (if applicable)', ge=0.0),
38
38
  ] = None
39
39
 
40
40
 
41
41
  class DeliveryStatus(Enum):
42
- delivering = "delivering"
43
- completed = "completed"
44
- budget_exhausted = "budget_exhausted"
45
- flight_ended = "flight_ended"
46
- goal_met = "goal_met"
42
+ delivering = 'delivering'
43
+ completed = 'completed'
44
+ budget_exhausted = 'budget_exhausted'
45
+ flight_ended = 'flight_ended'
46
+ goal_met = 'goal_met'
47
47
 
48
48
 
49
49
  class DailyBreakdownItem(AdCPBaseModel):
50
50
  model_config = ConfigDict(
51
- extra="allow",
51
+ extra='allow',
52
52
  )
53
- date: Annotated[str, Field(description="Date (YYYY-MM-DD)", pattern="^\\d{4}-\\d{2}-\\d{2}$")]
54
- impressions: Annotated[float, Field(description="Daily impressions", ge=0.0)]
55
- spend: Annotated[float, Field(description="Daily spend", ge=0.0)]
53
+ date: Annotated[str, Field(description='Date (YYYY-MM-DD)', pattern='^\\d{4}-\\d{2}-\\d{2}$')]
54
+ impressions: Annotated[float, Field(description='Daily impressions', ge=0.0)]
55
+ spend: Annotated[float, Field(description='Daily spend', ge=0.0)]
56
56
 
57
57
 
58
58
  class Status(Enum):
59
- pending = "pending"
60
- active = "active"
61
- paused = "paused"
62
- completed = "completed"
63
- failed = "failed"
64
- reporting_delayed = "reporting_delayed"
59
+ pending = 'pending'
60
+ active = 'active'
61
+ paused = 'paused'
62
+ completed = 'completed'
63
+ failed = 'failed'
64
+ reporting_delayed = 'reporting_delayed'
65
65
 
66
66
 
67
67
  class Totals(DeliveryMetrics):
@@ -76,23 +76,23 @@ class Totals(DeliveryMetrics):
76
76
 
77
77
 
78
78
  class NotificationType(Enum):
79
- scheduled = "scheduled"
80
- final = "final"
81
- delayed = "delayed"
82
- adjusted = "adjusted"
79
+ scheduled = 'scheduled'
80
+ final = 'final'
81
+ delayed = 'delayed'
82
+ adjusted = 'adjusted'
83
83
 
84
84
 
85
85
  class ReportingPeriod(AdCPBaseModel):
86
86
  model_config = ConfigDict(
87
- extra="allow",
87
+ extra='allow',
88
88
  )
89
89
  end: Annotated[
90
90
  AwareDatetime,
91
- Field(description="ISO 8601 end timestamp in UTC (e.g., 2024-02-05T23:59:59Z)"),
91
+ Field(description='ISO 8601 end timestamp in UTC (e.g., 2024-02-05T23:59:59Z)'),
92
92
  ]
93
93
  start: Annotated[
94
94
  AwareDatetime,
95
- Field(description="ISO 8601 start timestamp in UTC (e.g., 2024-02-05T00:00:00Z)"),
95
+ Field(description='ISO 8601 start timestamp in UTC (e.g., 2024-02-05T00:00:00Z)'),
96
96
  ]
97
97
 
98
98
 
@@ -104,33 +104,33 @@ class ByPackageItem(DeliveryMetrics):
104
104
  str,
105
105
  Field(
106
106
  description="ISO 4217 currency code (e.g., USD, EUR, GBP) for this package's pricing. Indicates the currency in which the rate and spend values are denominated. Different packages can use different currencies when supported by the publisher.",
107
- pattern="^[A-Z]{3}$",
107
+ pattern='^[A-Z]{3}$',
108
108
  ),
109
109
  ]
110
110
  delivery_status: Annotated[
111
111
  DeliveryStatus | None,
112
112
  Field(
113
- description="System-reported operational state of this package. Reflects actual delivery state independent of buyer pause control."
113
+ description='System-reported operational state of this package. Reflects actual delivery state independent of buyer pause control.'
114
114
  ),
115
115
  ] = None
116
116
  pacing_index: Annotated[
117
117
  float | None,
118
- Field(description="Delivery pace (1.0 = on track, <1.0 = behind, >1.0 = ahead)", ge=0.0),
118
+ Field(description='Delivery pace (1.0 = on track, <1.0 = behind, >1.0 = ahead)', ge=0.0),
119
119
  ] = None
120
120
  package_id: Annotated[str, Field(description="Publisher's package identifier")]
121
121
  paused: Annotated[
122
- bool | None, Field(description="Whether this package is currently paused by the buyer")
122
+ bool | None, Field(description='Whether this package is currently paused by the buyer')
123
123
  ] = None
124
124
  pricing_model: Annotated[
125
125
  pricing_model_1.PricingModel,
126
126
  Field(
127
- description="The pricing model used for this package (e.g., cpm, cpcv, cpp). Indicates how the package is billed and which metrics are most relevant for optimization."
127
+ description='The pricing model used for this package (e.g., cpm, cpcv, cpp). Indicates how the package is billed and which metrics are most relevant for optimization.'
128
128
  ),
129
129
  ]
130
130
  rate: Annotated[
131
131
  float,
132
132
  Field(
133
- description="The pricing rate for this package in the specified currency. For fixed-rate pricing, this is the agreed rate (e.g., CPM rate of 12.50 means $12.50 per 1,000 impressions). For auction-based pricing, this represents the effective rate based on actual delivery.",
133
+ description='The pricing rate for this package in the specified currency. For fixed-rate pricing, this is the agreed rate (e.g., CPM rate of 12.50 means $12.50 per 1,000 impressions). For auction-based pricing, this represents the effective rate based on actual delivery.',
134
134
  ge=0.0,
135
135
  ),
136
136
  ]
@@ -139,36 +139,36 @@ class ByPackageItem(DeliveryMetrics):
139
139
 
140
140
  class MediaBuyDelivery(AdCPBaseModel):
141
141
  model_config = ConfigDict(
142
- extra="allow",
142
+ extra='allow',
143
143
  )
144
144
  buyer_ref: Annotated[
145
145
  str | None, Field(description="Buyer's reference identifier for this media buy")
146
146
  ] = None
147
- by_package: Annotated[list[ByPackageItem], Field(description="Metrics broken down by package")]
147
+ by_package: Annotated[list[ByPackageItem], Field(description='Metrics broken down by package')]
148
148
  daily_breakdown: Annotated[
149
- list[DailyBreakdownItem] | None, Field(description="Day-by-day delivery")
149
+ list[DailyBreakdownItem] | None, Field(description='Day-by-day delivery')
150
150
  ] = None
151
151
  expected_availability: Annotated[
152
152
  AwareDatetime | None,
153
153
  Field(
154
- description="When delayed data is expected to be available (only present when status is reporting_delayed)"
154
+ description='When delayed data is expected to be available (only present when status is reporting_delayed)'
155
155
  ),
156
156
  ] = None
157
157
  is_adjusted: Annotated[
158
158
  bool | None,
159
159
  Field(
160
- description="Indicates this delivery contains updated data for a previously reported period. Buyer should replace previous period data with these totals."
160
+ description='Indicates this delivery contains updated data for a previously reported period. Buyer should replace previous period data with these totals.'
161
161
  ),
162
162
  ] = None
163
163
  media_buy_id: Annotated[str, Field(description="Publisher's media buy identifier")]
164
164
  pricing_model: Annotated[
165
165
  pricing_model_1.PricingModel | None,
166
- Field(description="Pricing model used for this media buy"),
166
+ Field(description='Pricing model used for this media buy'),
167
167
  ] = None
168
168
  status: Annotated[
169
169
  Status,
170
170
  Field(
171
- description="Current media buy status. In webhook context, reporting_delayed indicates data temporarily unavailable."
171
+ description='Current media buy status. In webhook context, reporting_delayed indicates data temporarily unavailable.'
172
172
  ),
173
173
  ]
174
174
  totals: Totals
@@ -176,27 +176,27 @@ class MediaBuyDelivery(AdCPBaseModel):
176
176
 
177
177
  class GetMediaBuyDeliveryResponse(AdCPBaseModel):
178
178
  model_config = ConfigDict(
179
- extra="allow",
179
+ extra='allow',
180
180
  )
181
181
  aggregated_totals: Annotated[
182
182
  AggregatedTotals | None,
183
183
  Field(
184
- description="Combined metrics across all returned media buys. Only included in API responses (get_media_buy_delivery), not in webhook notifications."
184
+ description='Combined metrics across all returned media buys. Only included in API responses (get_media_buy_delivery), not in webhook notifications.'
185
185
  ),
186
186
  ] = None
187
187
  context: context_1.ContextObject | None = None
188
- currency: Annotated[str, Field(description="ISO 4217 currency code", pattern="^[A-Z]{3}$")]
188
+ currency: Annotated[str, Field(description='ISO 4217 currency code', pattern='^[A-Z]{3}$')]
189
189
  errors: Annotated[
190
190
  list[error.Error] | None,
191
191
  Field(
192
- description="Task-specific errors and warnings (e.g., missing delivery data, reporting platform issues)"
192
+ description='Task-specific errors and warnings (e.g., missing delivery data, reporting platform issues)'
193
193
  ),
194
194
  ] = None
195
195
  ext: ext_1.ExtensionObject | None = None
196
196
  media_buy_deliveries: Annotated[
197
197
  list[MediaBuyDelivery],
198
198
  Field(
199
- description="Array of delivery data for media buys. When used in webhook notifications, may contain multiple media buys aggregated by publisher. When used in get_media_buy_delivery API responses, typically contains requested media buys."
199
+ description='Array of delivery data for media buys. When used in webhook notifications, may contain multiple media buys aggregated by publisher. When used in get_media_buy_delivery API responses, typically contains requested media buys.'
200
200
  ),
201
201
  ]
202
202
  next_expected_at: Annotated[
@@ -208,30 +208,30 @@ class GetMediaBuyDeliveryResponse(AdCPBaseModel):
208
208
  notification_type: Annotated[
209
209
  NotificationType | None,
210
210
  Field(
211
- description="Type of webhook notification (only present in webhook deliveries): scheduled = regular periodic update, final = campaign completed, delayed = data not yet available, adjusted = resending period with updated data"
211
+ description='Type of webhook notification (only present in webhook deliveries): scheduled = regular periodic update, final = campaign completed, delayed = data not yet available, adjusted = resending period with updated data'
212
212
  ),
213
213
  ] = None
214
214
  partial_data: Annotated[
215
215
  bool | None,
216
216
  Field(
217
- description="Indicates if any media buys in this webhook have missing/delayed data (only present in webhook deliveries)"
217
+ description='Indicates if any media buys in this webhook have missing/delayed data (only present in webhook deliveries)'
218
218
  ),
219
219
  ] = None
220
220
  reporting_period: Annotated[
221
221
  ReportingPeriod,
222
- Field(description="Date range for the report. All periods use UTC timezone."),
222
+ Field(description='Date range for the report. All periods use UTC timezone.'),
223
223
  ]
224
224
  sequence_number: Annotated[
225
225
  int | None,
226
226
  Field(
227
- description="Sequential notification number (only present in webhook deliveries, starts at 1)",
227
+ description='Sequential notification number (only present in webhook deliveries, starts at 1)',
228
228
  ge=1,
229
229
  ),
230
230
  ] = None
231
231
  unavailable_count: Annotated[
232
232
  int | None,
233
233
  Field(
234
- description="Number of media buys with reporting_delayed or failed status (only present in webhook deliveries when partial_data is true)",
234
+ description='Number of media buys with reporting_delayed or failed status (only present in webhook deliveries when partial_data is true)',
235
235
  ge=0,
236
236
  ),
237
237
  ] = None
@@ -1,6 +1,6 @@
1
1
  # generated by datamodel-codegen:
2
2
  # filename: media_buy/get_products_async_response_input_required.json
3
- # timestamp: 2026-01-08T19:25:24+00:00
3
+ # timestamp: 2026-01-25T21:17:54+00:00
4
4
 
5
5
  from __future__ import annotations
6
6
 
@@ -16,23 +16,23 @@ from ..core import product
16
16
 
17
17
 
18
18
  class Reason(Enum):
19
- CLARIFICATION_NEEDED = "CLARIFICATION_NEEDED"
20
- BUDGET_REQUIRED = "BUDGET_REQUIRED"
19
+ CLARIFICATION_NEEDED = 'CLARIFICATION_NEEDED'
20
+ BUDGET_REQUIRED = 'BUDGET_REQUIRED'
21
21
 
22
22
 
23
23
  class GetProductsInputRequired(AdCPBaseModel):
24
24
  model_config = ConfigDict(
25
- extra="allow",
25
+ extra='allow',
26
26
  )
27
27
  context: context_1.ContextObject | None = None
28
28
  ext: ext_1.ExtensionObject | None = None
29
29
  partial_results: Annotated[
30
30
  list[product.Product] | None,
31
- Field(description="Partial product results that may help inform the clarification"),
31
+ Field(description='Partial product results that may help inform the clarification'),
32
32
  ] = None
33
33
  reason: Annotated[
34
- Reason | None, Field(description="Reason code indicating why input is needed")
34
+ Reason | None, Field(description='Reason code indicating why input is needed')
35
35
  ] = None
36
36
  suggestions: Annotated[
37
- list[str] | None, Field(description="Suggested values or options for the required input")
37
+ list[str] | None, Field(description='Suggested values or options for the required input')
38
38
  ] = None
@@ -1,6 +1,6 @@
1
1
  # generated by datamodel-codegen:
2
2
  # filename: media_buy/get_products_async_response_submitted.json
3
- # timestamp: 2026-01-08T19:25:24+00:00
3
+ # timestamp: 2026-01-25T21:17:54+00:00
4
4
 
5
5
  from __future__ import annotations
6
6
 
@@ -15,10 +15,10 @@ from ..core import ext as ext_1
15
15
 
16
16
  class GetProductsSubmitted(AdCPBaseModel):
17
17
  model_config = ConfigDict(
18
- extra="allow",
18
+ extra='allow',
19
19
  )
20
20
  context: context_1.ContextObject | None = None
21
21
  estimated_completion: Annotated[
22
- AwareDatetime | None, Field(description="Estimated completion time for the search")
22
+ AwareDatetime | None, Field(description='Estimated completion time for the search')
23
23
  ] = None
24
24
  ext: ext_1.ExtensionObject | None = None
@@ -1,6 +1,6 @@
1
1
  # generated by datamodel-codegen:
2
2
  # filename: media_buy/get_products_async_response_working.json
3
- # timestamp: 2026-01-08T19:25:24+00:00
3
+ # timestamp: 2026-01-25T21:17:54+00:00
4
4
 
5
5
  from __future__ import annotations
6
6
 
@@ -15,7 +15,7 @@ from ..core import ext as ext_1
15
15
 
16
16
  class GetProductsWorking(AdCPBaseModel):
17
17
  model_config = ConfigDict(
18
- extra="allow",
18
+ extra='allow',
19
19
  )
20
20
  context: context_1.ContextObject | None = None
21
21
  current_step: Annotated[
@@ -27,9 +27,9 @@ class GetProductsWorking(AdCPBaseModel):
27
27
  ext: ext_1.ExtensionObject | None = None
28
28
  percentage: Annotated[
29
29
  float | None,
30
- Field(description="Progress percentage of the search operation", ge=0.0, le=100.0),
30
+ Field(description='Progress percentage of the search operation', ge=0.0, le=100.0),
31
31
  ] = None
32
- step_number: Annotated[int | None, Field(description="Current step number (1-indexed)")] = None
32
+ step_number: Annotated[int | None, Field(description='Current step number (1-indexed)')] = None
33
33
  total_steps: Annotated[
34
- int | None, Field(description="Total number of steps in the search process")
34
+ int | None, Field(description='Total number of steps in the search process')
35
35
  ] = None