feat: update adcp types for latest push notification schemas and update utility functions around webhooks

schemas/cache/adagents.json

@@ -3,12 +3,12 @@
   "description": "Declaration of authorized sales agents for advertising inventory. Hosted at /.well-known/adagents.json on publisher domains. Can either contain the full structure inline or reference an authoritative URL.",
   "examples": [
     {
-      "$schema": "https://adcontextprotocol.org/schemas/adagents.json",
+      "$schema": "/schemas/latest/adagents.json",
       "authoritative_location": "https://cdn.example.com/adagents/v2/adagents.json",
       "last_updated": "2025-01-15T10:00:00Z"
     },
     {
-      "$schema": "https://adcontextprotocol.org/schemas/adagents.json",
+      "$schema": "/schemas/latest/adagents.json",
       "authorized_agents": [
         {
           "authorization_type": "property_tags",
@@ -41,7 +41,7 @@
       }
     },
     {
-      "$schema": "https://adcontextprotocol.org/schemas/adagents.json",
+      "$schema": "/schemas/latest/adagents.json",
       "authorized_agents": [
         {
           "authorization_type": "property_tags",
@@ -135,7 +135,7 @@
       }
     },
     {
-      "$schema": "https://adcontextprotocol.org/schemas/adagents.json",
+      "$schema": "/schemas/latest/adagents.json",
       "authorized_agents": [
         {
           "authorization_type": "property_tags",
@@ -174,7 +174,7 @@
       }
     },
     {
-      "$schema": "https://adcontextprotocol.org/schemas/adagents.json",
+      "$schema": "/schemas/latest/adagents.json",
       "authorized_agents": [
         {
           "authorization_type": "publisher_properties",
@@ -226,7 +226,6 @@
       "description": "URL reference variant - points to the authoritative location of the adagents.json file",
       "properties": {
         "$schema": {
-          "default": "https://adcontextprotocol.org/schemas/adagents.json",
           "description": "JSON Schema identifier for this adagents.json file",
           "type": "string"
         },
@@ -252,7 +251,6 @@
       "description": "Inline structure variant - contains full agent authorization data",
       "properties": {
         "$schema": {
-          "default": "https://adcontextprotocol.org/schemas/adagents.json",
           "description": "JSON Schema identifier for this adagents.json file",
           "type": "string"
         },

schemas/cache/core/assets/image-asset.json

@@ -1,32 +1,37 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "allOf": [
-    {
-      "$ref": "../../core/dimensions.json"
+  "additionalProperties": false,
+  "description": "Image asset with URL and dimensions",
+  "properties": {
+    "alt_text": {
+      "description": "Alternative text for accessibility",
+      "type": "string"
+    },
+    "format": {
+      "description": "Image file format (jpg, png, gif, webp, etc.)",
+      "type": "string"
+    },
+    "height": {
+      "description": "Height in pixels",
+      "minimum": 1,
+      "type": "integer"
     },
-    {
-      "additionalProperties": false,
-      "properties": {
-        "alt_text": {
-          "description": "Alternative text for accessibility",
-          "type": "string"
-        },
-        "format": {
-          "description": "Image file format (jpg, png, gif, webp, etc.)",
-          "type": "string"
-        },
-        "url": {
-          "description": "URL to the image asset",
-          "format": "uri",
-          "type": "string"
-        }
-      },
-      "required": [
-        "url"
-      ],
-      "type": "object"
+    "url": {
+      "description": "URL to the image asset",
+      "format": "uri",
+      "type": "string"
+    },
+    "width": {
+      "description": "Width in pixels",
+      "minimum": 1,
+      "type": "integer"
     }
+  },
+  "required": [
+    "url",
+    "width",
+    "height"
   ],
-  "description": "Image asset with URL and dimensions",
-  "title": "Image Asset"
+  "title": "Image Asset",
+  "type": "object"
 }

schemas/cache/core/assets/video-asset.json

@@ -1,38 +1,43 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "allOf": [
-    {
-      "$ref": "../../core/dimensions.json"
+  "additionalProperties": false,
+  "description": "Video asset with URL and specifications",
+  "properties": {
+    "bitrate_kbps": {
+      "description": "Video bitrate in kilobits per second",
+      "minimum": 1,
+      "type": "integer"
+    },
+    "duration_ms": {
+      "description": "Video duration in milliseconds",
+      "minimum": 1,
+      "type": "integer"
+    },
+    "format": {
+      "description": "Video file format (mp4, webm, mov, etc.)",
+      "type": "string"
     },
-    {
-      "additionalProperties": false,
-      "properties": {
-        "bitrate_kbps": {
-          "description": "Video bitrate in kilobits per second",
-          "minimum": 1,
-          "type": "integer"
-        },
-        "duration_ms": {
-          "description": "Video duration in milliseconds",
-          "minimum": 1,
-          "type": "integer"
-        },
-        "format": {
-          "description": "Video file format (mp4, webm, mov, etc.)",
-          "type": "string"
-        },
-        "url": {
-          "description": "URL to the video asset",
-          "format": "uri",
-          "type": "string"
-        }
-      },
-      "required": [
-        "url"
-      ],
-      "type": "object"
+    "height": {
+      "description": "Height in pixels",
+      "minimum": 1,
+      "type": "integer"
+    },
+    "url": {
+      "description": "URL to the video asset",
+      "format": "uri",
+      "type": "string"
+    },
+    "width": {
+      "description": "Width in pixels",
+      "minimum": 1,
+      "type": "integer"
     }
+  },
+  "required": [
+    "url",
+    "width",
+    "height"
   ],
-  "description": "Video asset with URL and specifications",
-  "title": "Video Asset"
+  "title": "Video Asset",
+  "type": "object"
 }

schemas/cache/core/async-response-data.json

@@ -0,0 +1,87 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "anyOf": [
+    {
+      "$ref": "../media-buy/get-products-response.json",
+      "description": "Response for completed or failed get_products",
+      "title": "GetProductsResponse"
+    },
+    {
+      "$ref": "../media-buy/get-products-async-response-working.json",
+      "description": "Progress data for working get_products",
+      "title": "GetProductsAsyncWorking"
+    },
+    {
+      "$ref": "../media-buy/get-products-async-response-input-required.json",
+      "description": "Input requirements for get_products needing clarification",
+      "title": "GetProductsAsyncInputRequired"
+    },
+    {
+      "$ref": "../media-buy/get-products-async-response-submitted.json",
+      "description": "Acknowledgment for submitted get_products (custom curation)",
+      "title": "GetProductsAsyncSubmitted"
+    },
+    {
+      "$ref": "../media-buy/create-media-buy-response.json",
+      "description": "Response for completed or failed create_media_buy",
+      "title": "CreateMediaBuyResponse"
+    },
+    {
+      "$ref": "../media-buy/create-media-buy-async-response-working.json",
+      "description": "Progress data for working create_media_buy",
+      "title": "CreateMediaBuyAsyncWorking"
+    },
+    {
+      "$ref": "../media-buy/create-media-buy-async-response-input-required.json",
+      "description": "Input requirements for create_media_buy needing user input",
+      "title": "CreateMediaBuyAsyncInputRequired"
+    },
+    {
+      "$ref": "../media-buy/create-media-buy-async-response-submitted.json",
+      "description": "Acknowledgment for submitted create_media_buy",
+      "title": "CreateMediaBuyAsyncSubmitted"
+    },
+    {
+      "$ref": "../media-buy/update-media-buy-response.json",
+      "description": "Response for completed or failed update_media_buy",
+      "title": "UpdateMediaBuyResponse"
+    },
+    {
+      "$ref": "../media-buy/update-media-buy-async-response-working.json",
+      "description": "Progress data for working update_media_buy",
+      "title": "UpdateMediaBuyAsyncWorking"
+    },
+    {
+      "$ref": "../media-buy/update-media-buy-async-response-input-required.json",
+      "description": "Input requirements for update_media_buy needing user input",
+      "title": "UpdateMediaBuyAsyncInputRequired"
+    },
+    {
+      "$ref": "../media-buy/update-media-buy-async-response-submitted.json",
+      "description": "Acknowledgment for submitted update_media_buy",
+      "title": "UpdateMediaBuyAsyncSubmitted"
+    },
+    {
+      "$ref": "../media-buy/sync-creatives-response.json",
+      "description": "Response for completed or failed sync_creatives",
+      "title": "SyncCreativesResponse"
+    },
+    {
+      "$ref": "../media-buy/sync-creatives-async-response-working.json",
+      "description": "Progress data for working sync_creatives",
+      "title": "SyncCreativesAsyncWorking"
+    },
+    {
+      "$ref": "../media-buy/sync-creatives-async-response-input-required.json",
+      "description": "Input requirements for sync_creatives needing user input",
+      "title": "SyncCreativesAsyncInputRequired"
+    },
+    {
+      "$ref": "../media-buy/sync-creatives-async-response-submitted.json",
+      "description": "Acknowledgment for submitted sync_creatives",
+      "title": "SyncCreativesAsyncSubmitted"
+    }
+  ],
+  "description": "Union of all possible data payloads for async task webhook responses. For completed/failed statuses, use the main task response schema. For working/input-required/submitted, use the status-specific schemas.",
+  "title": "AdCP Async Response Data"
+}