@adcp/sdk 6.0.0 → 6.2.0

package/dist/lib/schemas-data/v2.5/media-buy/provide-performance-feedback-request.json

@@ -0,0 +1,88 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/schemas/media-buy/provide-performance-feedback-request.json",
+  "title": "Provide Performance Feedback Request",
+  "description": "Request payload for provide_performance_feedback task",
+  "type": "object",
+  "properties": {
+    "media_buy_id": {
+      "type": "string",
+      "description": "Publisher's media buy identifier",
+      "minLength": 1
+    },
+    "buyer_ref": {
+      "type": "string",
+      "description": "Buyer's reference for the media buy",
+      "minLength": 1
+    },
+    "measurement_period": {
+      "type": "object",
+      "description": "Time period for performance measurement",
+      "properties": {
+        "start": {
+          "type": "string",
+          "format": "date-time",
+          "description": "ISO 8601 start timestamp for measurement period"
+        },
+        "end": {
+          "type": "string",
+          "format": "date-time",
+          "description": "ISO 8601 end timestamp for measurement period"
+        }
+      },
+      "required": [
+        "start",
+        "end"
+      ],
+      "additionalProperties": true
+    },
+    "performance_index": {
+      "type": "number",
+      "description": "Normalized performance score (0.0 = no value, 1.0 = expected, >1.0 = above expected)",
+      "minimum": 0
+    },
+    "package_id": {
+      "type": "string",
+      "description": "Specific package within the media buy (if feedback is package-specific)",
+      "minLength": 1
+    },
+    "creative_id": {
+      "type": "string",
+      "description": "Specific creative asset (if feedback is creative-specific)",
+      "minLength": 1
+    },
+    "metric_type": {
+      "$ref": "/schemas/enums/metric-type.json",
+      "description": "The business metric being measured",
+      "default": "overall_performance"
+    },
+    "feedback_source": {
+      "$ref": "/schemas/enums/feedback-source.json",
+      "description": "Source of the performance data",
+      "default": "buyer_attribution"
+    },
+    "context": {
+      "$ref": "/schemas/core/context.json"
+    },
+    "ext": {
+      "$ref": "/schemas/core/ext.json"
+    }
+  },
+  "oneOf": [
+    {
+      "required": [
+        "media_buy_id",
+        "measurement_period",
+        "performance_index"
+      ]
+    },
+    {
+      "required": [
+        "buyer_ref",
+        "measurement_period",
+        "performance_index"
+      ]
+    }
+  ],
+  "additionalProperties": true
+}

package/dist/lib/schemas-data/v2.5/media-buy/provide-performance-feedback-response.json

@@ -0,0 +1,66 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/schemas/media-buy/provide-performance-feedback-response.json",
+  "title": "Provide Performance Feedback Response",
+  "description": "Response payload for provide_performance_feedback task. Returns either success confirmation OR error information, never both.",
+  "type": "object",
+  "oneOf": [
+    {
+      "title": "ProvidePerformanceFeedbackSuccess",
+      "description": "Success response - feedback received and processed",
+      "type": "object",
+      "properties": {
+        "success": {
+          "type": "boolean",
+          "description": "Whether the performance feedback was successfully received",
+          "const": true
+        },
+        "context": {
+          "$ref": "/schemas/core/context.json"
+        },
+        "ext": {
+          "$ref": "/schemas/core/ext.json"
+        }
+      },
+      "required": [
+        "success"
+      ],
+      "additionalProperties": true,
+      "not": {
+        "required": [
+          "errors"
+        ]
+      }
+    },
+    {
+      "title": "ProvidePerformanceFeedbackError",
+      "description": "Error response - feedback rejected or could not be processed",
+      "type": "object",
+      "properties": {
+        "errors": {
+          "type": "array",
+          "description": "Array of errors explaining why feedback was rejected (e.g., invalid measurement period, missing campaign data)",
+          "items": {
+            "$ref": "/schemas/core/error.json"
+          },
+          "minItems": 1
+        },
+        "context": {
+          "$ref": "/schemas/core/context.json"
+        },
+        "ext": {
+          "$ref": "/schemas/core/ext.json"
+        }
+      },
+      "required": [
+        "errors"
+      ],
+      "additionalProperties": true,
+      "not": {
+        "required": [
+          "success"
+        ]
+      }
+    }
+  ]
+}

package/dist/lib/schemas-data/v2.5/media-buy/sync-creatives-async-response-input-required.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/schemas/media-buy/sync-creatives-async-response-input-required.json",
+  "title": "Sync Creatives - Input Required",
+  "description": "Payload when sync_creatives task is paused waiting for buyer clarification or approval.",
+  "type": "object",
+  "properties": {
+    "reason": {
+      "type": "string",
+      "enum": [
+        "APPROVAL_REQUIRED",
+        "ASSET_CONFIRMATION",
+        "FORMAT_CLARIFICATION"
+      ],
+      "description": "Reason code indicating why buyer input is needed"
+    },
+    "context": {
+      "$ref": "/schemas/core/context.json"
+    },
+    "ext": {
+      "$ref": "/schemas/core/ext.json"
+    }
+  },
+  "additionalProperties": true
+}

package/dist/lib/schemas-data/v2.5/media-buy/sync-creatives-async-response-submitted.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/schemas/media-buy/sync-creatives-async-response-submitted.json",
+  "title": "Sync Creatives - Submitted",
+  "description": "Payload acknowledging sync_creatives task is queued for processing.",
+  "type": "object",
+  "properties": {
+    "context": {
+      "$ref": "/schemas/core/context.json"
+    },
+    "ext": {
+      "$ref": "/schemas/core/ext.json"
+    }
+  },
+  "additionalProperties": true
+}

package/dist/lib/schemas-data/v2.5/media-buy/sync-creatives-async-response-working.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/schemas/media-buy/sync-creatives-async-response-working.json",
+  "title": "Sync Creatives - Working",
+  "description": "Progress payload for active sync_creatives task.",
+  "type": "object",
+  "properties": {
+    "percentage": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 100,
+      "description": "Completion percentage (0-100)"
+    },
+    "current_step": {
+      "type": "string",
+      "description": "Current step or phase of the operation"
+    },
+    "total_steps": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Total number of steps in the operation"
+    },
+    "step_number": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Current step number"
+    },
+    "creatives_processed": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Number of creatives processed so far"
+    },
+    "creatives_total": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Total number of creatives to process"
+    },
+    "context": {
+      "$ref": "/schemas/core/context.json"
+    },
+    "ext": {
+      "$ref": "/schemas/core/ext.json"
+    }
+  },
+  "additionalProperties": true
+}

package/dist/lib/schemas-data/v2.5/media-buy/sync-creatives-request.json

@@ -0,0 +1,178 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/schemas/media-buy/sync-creatives-request.json",
+  "title": "Sync Creatives Request",
+  "description": "Request parameters for syncing creative assets with upsert semantics - supports bulk operations, scoped updates, and assignment management",
+  "type": "object",
+  "properties": {
+    "creatives": {
+      "type": "array",
+      "description": "Array of creative assets to sync (create or update)",
+      "items": {
+        "$ref": "/schemas/core/creative-asset.json"
+      },
+      "maxItems": 100
+    },
+    "creative_ids": {
+      "type": "array",
+      "description": "Optional filter to limit sync scope to specific creative IDs. When provided, only these creatives will be created/updated. Other creatives in the library are unaffected. Useful for partial updates and error recovery.",
+      "items": {
+        "type": "string"
+      },
+      "maxItems": 100
+    },
+    "assignments": {
+      "type": "object",
+      "description": "Optional bulk assignment of creatives to packages",
+      "patternProperties": {
+        "^[a-zA-Z0-9_-]+$": {
+          "type": "array",
+          "description": "Array of package IDs to assign this creative to",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "delete_missing": {
+      "type": "boolean",
+      "default": false,
+      "description": "When true, creatives not included in this sync will be archived. Use with caution for full library replacement."
+    },
+    "dry_run": {
+      "type": "boolean",
+      "default": false,
+      "description": "When true, preview changes without applying them. Returns what would be created/updated/deleted."
+    },
+    "validation_mode": {
+      "$ref": "/schemas/enums/validation-mode.json",
+      "default": "strict",
+      "description": "Validation strictness. 'strict' fails entire sync on any validation error. 'lenient' processes valid creatives and reports errors."
+    },
+    "push_notification_config": {
+      "$ref": "/schemas/core/push-notification-config.json",
+      "description": "Optional webhook configuration for async sync notifications. Publisher will send webhook when sync completes if operation takes longer than immediate response time (typically for large bulk operations or manual approval/HITL)."
+    },
+    "context": {
+      "$ref": "/schemas/core/context.json"
+    },
+    "ext": {
+      "$ref": "/schemas/core/ext.json"
+    }
+  },
+  "required": [
+    "creatives"
+  ],
+  "additionalProperties": true,
+  "examples": [
+    {
+      "description": "Full sync with hosted video creative",
+      "data": {
+        "creatives": [
+          {
+            "creative_id": "hero_video_30s",
+            "name": "Brand Hero Video 30s",
+            "format_id": {
+              "agent_url": "https://creative.adcontextprotocol.org",
+              "id": "video_standard_30s"
+            },
+            "assets": {
+              "video": {
+                "url": "https://cdn.example.com/hero-video.mp4",
+                "width": 1920,
+                "height": 1080,
+                "duration_ms": 30000
+              }
+            },
+            "tags": [
+              "q1_2024",
+              "video"
+            ]
+          }
+        ],
+        "assignments": {
+          "hero_video_30s": [
+            "pkg_ctv_001",
+            "pkg_ctv_002"
+          ]
+        }
+      }
+    },
+    {
+      "description": "Generative creative with approval",
+      "data": {
+        "creatives": [
+          {
+            "creative_id": "holiday_hero",
+            "name": "Holiday Campaign Hero",
+            "format_id": {
+              "agent_url": "https://publisher.com/.well-known/adcp/sales",
+              "id": "premium_bespoke_display"
+            },
+            "assets": {
+              "promoted_offerings": {
+                "brand_manifest": {
+                  "url": "https://retailer.com",
+                  "colors": {
+                    "primary": "#C41E3A",
+                    "secondary": "#165B33"
+                  }
+                }
+              },
+              "generation_prompt": {
+                "content": "Create a warm, festive holiday campaign featuring winter products"
+              }
+            },
+            "tags": [
+              "holiday",
+              "q4_2024"
+            ]
+          }
+        ]
+      }
+    },
+    {
+      "description": "Scoped update using creative_ids filter",
+      "data": {
+        "creative_ids": [
+          "hero_video_30s",
+          "banner_300x250"
+        ],
+        "creatives": [
+          {
+            "creative_id": "hero_video_30s",
+            "name": "Brand Hero Video 30s - Updated",
+            "format_id": {
+              "agent_url": "https://creative.adcontextprotocol.org",
+              "id": "video_standard_30s"
+            },
+            "assets": {
+              "video": {
+                "url": "https://cdn.example.com/updated-hero.mp4",
+                "width": 1920,
+                "height": 1080,
+                "duration_ms": 30000
+              }
+            }
+          },
+          {
+            "creative_id": "banner_300x250",
+            "name": "Display Banner 300x250 - Updated",
+            "format_id": {
+              "agent_url": "https://creative.adcontextprotocol.org",
+              "id": "display_300x250"
+            },
+            "assets": {
+              "image": {
+                "url": "https://cdn.example.com/updated-banner.png",
+                "width": 300,
+                "height": 250
+              }
+            }
+          }
+        ]
+      }
+    }
+  ]
+}

package/dist/lib/schemas-data/v2.5/media-buy/sync-creatives-response.json

@@ -0,0 +1,149 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/schemas/media-buy/sync-creatives-response.json",
+  "title": "Sync Creatives Response",
+  "description": "Response from creative sync operation. Returns either per-creative results (best-effort processing) OR operation-level errors (complete failure). This enforces atomic semantics at the operation level while allowing per-item failures within successful operations.",
+  "type": "object",
+  "oneOf": [
+    {
+      "title": "SyncCreativesSuccess",
+      "description": "Success response - sync operation processed creatives (may include per-item failures)",
+      "type": "object",
+      "properties": {
+        "dry_run": {
+          "type": "boolean",
+          "description": "Whether this was a dry run (no actual changes made)"
+        },
+        "creatives": {
+          "type": "array",
+          "description": "Results for each creative processed. Items with action='failed' indicate per-item validation/processing failures, not operation-level failures.",
+          "items": {
+            "type": "object",
+            "properties": {
+              "creative_id": {
+                "type": "string",
+                "description": "Creative ID from the request"
+              },
+              "action": {
+                "$ref": "/schemas/enums/creative-action.json",
+                "description": "Action taken for this creative"
+              },
+              "platform_id": {
+                "type": "string",
+                "description": "Platform-specific ID assigned to the creative"
+              },
+              "changes": {
+                "type": "array",
+                "description": "Field names that were modified (only present when action='updated')",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "errors": {
+                "type": "array",
+                "description": "Validation or processing errors (only present when action='failed')",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "warnings": {
+                "type": "array",
+                "description": "Non-fatal warnings about this creative",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "preview_url": {
+                "type": "string",
+                "format": "uri",
+                "description": "Preview URL for generative creatives (only present for generative formats)"
+              },
+              "expires_at": {
+                "type": "string",
+                "format": "date-time",
+                "description": "ISO 8601 timestamp when preview link expires (only present when preview_url exists)"
+              },
+              "assigned_to": {
+                "type": "array",
+                "description": "Package IDs this creative was successfully assigned to (only present when assignments were requested)",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "assignment_errors": {
+                "type": "object",
+                "description": "Assignment errors by package ID (only present when assignment failures occurred)",
+                "patternProperties": {
+                  "^[a-zA-Z0-9_-]+$": {
+                    "type": "string",
+                    "description": "Error message for this package assignment"
+                  }
+                },
+                "additionalProperties": true
+              }
+            },
+            "required": [
+              "creative_id",
+              "action"
+            ],
+            "additionalProperties": true
+          }
+        },
+        "context": {
+          "$ref": "/schemas/core/context.json"
+        },
+        "ext": {
+          "$ref": "/schemas/core/ext.json"
+        }
+      },
+      "required": [
+        "creatives"
+      ],
+      "additionalProperties": true,
+      "not": {
+        "required": [
+          "errors"
+        ]
+      }
+    },
+    {
+      "title": "SyncCreativesError",
+      "description": "Error response - operation failed completely, no creatives were processed",
+      "type": "object",
+      "properties": {
+        "errors": {
+          "type": "array",
+          "description": "Operation-level errors that prevented processing any creatives (e.g., authentication failure, service unavailable, invalid request format)",
+          "items": {
+            "$ref": "/schemas/core/error.json"
+          },
+          "minItems": 1
+        },
+        "context": {
+          "$ref": "/schemas/core/context.json"
+        },
+        "ext": {
+          "$ref": "/schemas/core/ext.json"
+        }
+      },
+      "required": [
+        "errors"
+      ],
+      "additionalProperties": true,
+      "not": {
+        "anyOf": [
+          {
+            "required": [
+              "creatives"
+            ]
+          },
+          {
+            "required": [
+              "dry_run"
+            ]
+          }
+        ]
+      }
+    }
+  ]
+}

package/dist/lib/schemas-data/v2.5/media-buy/update-media-buy-async-response-input-required.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/schemas/media-buy/update-media-buy-async-response-input-required.json",
+  "title": "Update Media Buy - Input Required",
+  "description": "Payload when update_media_buy task is paused waiting for user input or approval.",
+  "type": "object",
+  "properties": {
+    "reason": {
+      "type": "string",
+      "enum": [
+        "APPROVAL_REQUIRED",
+        "CHANGE_CONFIRMATION"
+      ],
+      "description": "Reason code indicating why input is needed"
+    },
+    "context": {
+      "$ref": "/schemas/core/context.json"
+    },
+    "ext": {
+      "$ref": "/schemas/core/ext.json"
+    }
+  },
+  "additionalProperties": true
+}

package/dist/lib/schemas-data/v2.5/media-buy/update-media-buy-async-response-submitted.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/schemas/media-buy/update-media-buy-async-response-submitted.json",
+  "title": "Update Media Buy - Submitted",
+  "description": "Payload acknowledging update_media_buy task is queued for processing.",
+  "type": "object",
+  "properties": {
+    "context": {
+      "$ref": "/schemas/core/context.json"
+    },
+    "ext": {
+      "$ref": "/schemas/core/ext.json"
+    }
+  },
+  "additionalProperties": true
+}

package/dist/lib/schemas-data/v2.5/media-buy/update-media-buy-async-response-working.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/schemas/media-buy/update-media-buy-async-response-working.json",
+  "title": "Update Media Buy - Working",
+  "description": "Progress payload for active update_media_buy task.",
+  "type": "object",
+  "properties": {
+    "percentage": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 100,
+      "description": "Completion percentage (0-100)"
+    },
+    "current_step": {
+      "type": "string",
+      "description": "Current step or phase of the operation"
+    },
+    "total_steps": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Total number of steps in the operation"
+    },
+    "step_number": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Current step number"
+    },
+    "context": {
+      "$ref": "/schemas/core/context.json"
+    },
+    "ext": {
+      "$ref": "/schemas/core/ext.json"
+    }
+  },
+  "additionalProperties": true
+}