@adcp/sdk 6.6.0 → 6.8.0

package/dist/lib/schemas-data/3.0/manifest.schema.json

@@ -0,0 +1,202 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/schemas/3.0.5/manifest.schema.json",
+  "title": "AdCP Manifest",
+  "description": "Machine-readable registry of every AdCP tool, error code, and specialism for a given AdCP version. SDKs consume this artifact at codegen time to derive their tool/error tables instead of hand-transcribing the spec. Replaces three categories of drift documented in adcp#3725: hand-rolled tool-by-protocol arrays, hand-classified error recovery, and hand-listed specialism→tool mappings.",
+  "type": "object",
+  "required": [
+    "adcp_version",
+    "generated_at",
+    "tools",
+    "error_codes",
+    "error_code_policy",
+    "specialisms"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "Reference to this manifest meta-schema."
+    },
+    "adcp_version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+(-[A-Za-z0-9.-]+)?$",
+      "description": "Full semver of the AdCP release this manifest describes."
+    },
+    "generated_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO-8601 timestamp the manifest was generated. SDKs MAY use this for cache invalidation."
+    },
+    "tools": {
+      "type": "object",
+      "description": "Every tool the AdCP spec defines, keyed by tool name (the snake_case name used in MCP/A2A invocations).",
+      "minProperties": 1,
+      "additionalProperties": {
+        "type": "object",
+        "required": [
+          "protocol",
+          "mutating",
+          "request_schema",
+          "response_schema",
+          "async_response_schemas"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "protocol": {
+            "type": "string",
+            "description": "The protocol surface this tool belongs to. Derived from the source directory: media-buy, signals, governance, account, creative, brand, content-standards, property, collection, sponsored-intelligence, protocol, compliance, tmp.",
+            "enum": [
+              "media-buy",
+              "signals",
+              "governance",
+              "account",
+              "creative",
+              "brand",
+              "content-standards",
+              "property",
+              "collection",
+              "sponsored-intelligence",
+              "protocol",
+              "compliance",
+              "tmp",
+              "a2ui"
+            ]
+          },
+          "mutating": {
+            "type": "boolean",
+            "description": "True if invoking this tool with identical inputs more than once is unsafe — i.e., the tool changes server-side state. Mutating tools MUST declare an idempotency_key on the request schema (or carry an explicit `naturally idempotent` exemption marker in the schema's description). Read-only tools (verbs `get-`, `list-`, `check-`, `validate-`, `preview-`, `search-`) are safe to retry without an idempotency key."
+          },
+          "request_schema": {
+            "type": "string",
+            "description": "Path to the request schema, relative to the manifest's directory (e.g., 'media-buy/create-media-buy-request.json')."
+          },
+          "response_schema": {
+            "type": "string",
+            "description": "Path to the synchronous response schema, relative to the manifest's directory."
+          },
+          "async_response_schemas": {
+            "type": "array",
+            "description": "Paths to the tool's async response variants (typically -submitted, -working, -input-required). Empty array if the tool has no async surface. Buyer agents MUST handle every entry — a tool with async_response_schemas non-empty can return any of these from a non-final task state.",
+            "items": {
+              "type": "string"
+            }
+          },
+          "specialisms": {
+            "type": "array",
+            "description": "Specialism IDs that include this tool in their required_tools (or via inherited scenarios). Lets SDKs answer \"if I claim specialism X, which tools must I implement?\" without re-deriving from the compliance cache.",
+            "items": {
+              "type": "string"
+            }
+          },
+          "added_in": {
+            "type": "string",
+            "description": "Semver of the AdCP release that introduced this tool. Optional; absent means \"present since 1.0\"."
+          },
+          "deprecated_in": {
+            "type": "string",
+            "description": "Semver of the AdCP release that deprecated this tool. Absent means active."
+          }
+        }
+      }
+    },
+    "error_code_policy": {
+      "type": "object",
+      "description": "How SDKs should handle codes outside the standard set. The error vocabulary is open: sellers MAY return platform-specific codes that aren't in `error_codes`. Agents MUST fall back to `default_unknown_recovery` for unknown codes — they SHOULD NOT throw or treat unknown codes as malformed responses.",
+      "required": [
+        "default_unknown_recovery",
+        "note"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "default_unknown_recovery": {
+          "type": "string",
+          "enum": [
+            "correctable",
+            "transient",
+            "terminal"
+          ],
+          "description": "The recovery classification an agent MUST apply to a code that is not present in this manifest's `error_codes` block. `transient` is the safe default — unknown codes from a non-conforming seller should be retried with backoff, not classified as fatal."
+        },
+        "note": {
+          "type": "string",
+          "description": "Human-readable summary of the open-set policy."
+        }
+      }
+    },
+    "error_codes": {
+      "type": "object",
+      "description": "Every standard error code in the AdCP error vocabulary, keyed by the SCREAMING_SNAKE code. Mirrors enums/error-code.json's enum + enumMetadata + enumDescriptions. Open-set: see error_code_policy for unknown-code handling.",
+      "minProperties": 1,
+      "additionalProperties": {
+        "type": "object",
+        "required": [
+          "recovery",
+          "description",
+          "suggestion"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "recovery": {
+            "type": "string",
+            "enum": [
+              "correctable",
+              "transient",
+              "terminal"
+            ],
+            "description": "How the caller should respond. correctable: fix the request and retry. transient: retry with backoff. terminal: no autonomous recovery — operator intervention required."
+          },
+          "description": {
+            "type": "string",
+            "description": "Human-readable description of the error. Sourced from enumDescriptions in enums/error-code.json."
+          },
+          "suggestion": {
+            "type": "string",
+            "description": "Short remediation hint a buyer agent can act on. Sourced from enumMetadata in enums/error-code.json."
+          },
+          "added_in": {
+            "type": "string",
+            "description": "Semver of the AdCP release that introduced this code. Optional."
+          }
+        }
+      }
+    },
+    "specialisms": {
+      "type": "object",
+      "description": "Every storyboard specialism declared in static/compliance/source/specialisms/, keyed by specialism ID. Lets SDKs declare which specialisms they implement and verify their tool surface covers the required tools.",
+      "additionalProperties": {
+        "type": "object",
+        "required": [
+          "protocol",
+          "entry_point_tools",
+          "exercised_tools"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "protocol": {
+            "type": "string",
+            "description": "The protocol surface this specialism belongs to. Sourced from index.yaml's `protocol` field. Note: this is the specialism's home protocol; individual `exercised_tools` may belong to other protocols (e.g., a sales-track specialism may exercise an account-protocol tool like sync_accounts)."
+          },
+          "title": {
+            "type": "string",
+            "description": "Human-readable title. Sourced from index.yaml's `title` field."
+          },
+          "entry_point_tools": {
+            "type": "array",
+            "description": "The minimal contract: tools the spec asserts an implementer MUST ship to claim this specialism. Sourced from index.yaml's `required_tools` field. An agent declaring this specialism in its capabilities MUST respond to every tool listed here.",
+            "items": {
+              "type": "string"
+            }
+          },
+          "exercised_tools": {
+            "type": "array",
+            "description": "The full surface the conformance kit will call: union of entry_point_tools, the specialism's own phases[].steps[].task, and every linked scenario's tasks. An agent declaring this specialism MUST be prepared to handle every call here, even though some are inherited via storyboard scenarios rather than declared in `required_tools`. Use this set to size your tool registration, not entry_point_tools.",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/dist/lib/schemas-data/3.0/media-buy/build-creative-async-response-input-required.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.0.1/media-buy/build-creative-async-response-input-required.json",
+  "$id": "/schemas/3.0.5/media-buy/build-creative-async-response-input-required.json",
   "title": "Build Creative - Input Required",
   "description": "Payload when build_creative is paused waiting for user input. May occur during generation when the agent needs creative direction, or when brand guidelines require approval.",
   "type": "object",
@@ -18,14 +18,14 @@
       "type": "array",
       "description": "Optional validation errors or warnings explaining why input is required.",
       "items": {
-        "$ref": "/schemas/3.0.1/core/error.json"
+        "$ref": "/schemas/3.0.5/core/error.json"
       }
     },
     "context": {
-      "$ref": "/schemas/3.0.1/core/context.json"
+      "$ref": "/schemas/3.0.5/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.0.1/core/ext.json"
+      "$ref": "/schemas/3.0.5/core/ext.json"
     }
   },
   "additionalProperties": true

package/dist/lib/schemas-data/3.0/media-buy/build-creative-async-response-submitted.json

@@ -1,15 +1,15 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.0.1/media-buy/build-creative-async-response-submitted.json",
+  "$id": "/schemas/3.0.5/media-buy/build-creative-async-response-submitted.json",
   "title": "Build Creative - Submitted",
   "description": "Payload acknowledging the build_creative task is queued.",
   "type": "object",
   "properties": {
     "context": {
-      "$ref": "/schemas/3.0.1/core/context.json"
+      "$ref": "/schemas/3.0.5/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.0.1/core/ext.json"
+      "$ref": "/schemas/3.0.5/core/ext.json"
     }
   },
   "additionalProperties": true

package/dist/lib/schemas-data/3.0/media-buy/build-creative-async-response-working.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.0.1/media-buy/build-creative-async-response-working.json",
+  "$id": "/schemas/3.0.5/media-buy/build-creative-async-response-working.json",
   "title": "Build Creative - Working",
   "description": "Progress payload for active build_creative task. Returned during AI generation, format transformation, or complex library retrieval with macro resolution.",
   "type": "object",
@@ -26,10 +26,10 @@
       "description": "Current step number"
     },
     "context": {
-      "$ref": "/schemas/3.0.1/core/context.json"
+      "$ref": "/schemas/3.0.5/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.0.1/core/ext.json"
+      "$ref": "/schemas/3.0.5/core/ext.json"
     }
   },
   "additionalProperties": true

package/dist/lib/schemas-data/3.0/media-buy/build-creative-request.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.0.1/media-buy/build-creative-request.json",
+  "$id": "/schemas/3.0.5/media-buy/build-creative-request.json",
   "title": "Build Creative Request",
   "description": "Request to transform, generate, or retrieve a creative manifest. Supports three modes: (1) generation from a brief or seed assets, (2) transformation of an existing manifest, (3) retrieval from a creative library by creative_id. Produces target manifest(s) in the specified format(s). Provide either target_format_id for a single format or target_format_ids for multiple formats.",
   "x-mutates-state": true,
@@ -17,7 +17,7 @@
       "description": "Natural language instructions for the transformation or generation. For pure generation, this is the creative brief. For transformation, this provides guidance on how to adapt the creative. For refinement, this describes the desired changes."
     },
     "creative_manifest": {
-      "$ref": "/schemas/3.0.1/core/creative-manifest.json",
+      "$ref": "/schemas/3.0.5/core/creative-manifest.json",
       "description": "Creative manifest to transform or generate from. For pure generation, this should include the target format_id and any required input assets. For transformation (e.g., resizing, reformatting), this is the complete creative to adapt. When creative_id is provided, the agent resolves the creative from its library and this field is ignored."
     },
     "creative_id": {
@@ -40,27 +40,27 @@
       "x-entity": "package"
     },
     "target_format_id": {
-      "$ref": "/schemas/3.0.1/core/format-id.json",
+      "$ref": "/schemas/3.0.5/core/format-id.json",
       "description": "Single format ID to generate. Mutually exclusive with target_format_ids. The format definition specifies required input assets and output structure."
     },
     "target_format_ids": {
       "type": "array",
       "items": {
-        "$ref": "/schemas/3.0.1/core/format-id.json"
+        "$ref": "/schemas/3.0.5/core/format-id.json"
       },
       "minItems": 1,
       "description": "Array of format IDs to generate in a single call. Mutually exclusive with target_format_id. The creative agent produces one manifest per format. Each format definition specifies its own required input assets and output structure."
     },
     "account": {
-      "$ref": "/schemas/3.0.1/core/account-ref.json",
+      "$ref": "/schemas/3.0.5/core/account-ref.json",
       "description": "Account reference for pricing and billing. When present, the creative agent applies account-specific pricing from the rate card, records the build against the account for billing, and can enforce account-level quotas or entitlements. Required by creative agents that charge for their services."
     },
     "brand": {
-      "$ref": "/schemas/3.0.1/core/brand-ref.json",
+      "$ref": "/schemas/3.0.5/core/brand-ref.json",
       "description": "Brand reference for creative generation. Resolved to full brand identity (colors, logos, tone) at execution time."
     },
     "quality": {
-      "$ref": "/schemas/3.0.1/enums/creative-quality.json",
+      "$ref": "/schemas/3.0.5/enums/creative-quality.json",
       "description": "Quality tier for generation. 'draft' produces fast, lower-fidelity output for iteration and review. 'production' produces full-quality output for final delivery. If omitted, the creative agent uses its own default. For non-generative transforms (e.g., format resizing), creative agents MAY ignore this field."
     },
     "item_limit": {
@@ -102,11 +102,11 @@
       "minItems": 1
     },
     "preview_quality": {
-      "$ref": "/schemas/3.0.1/enums/creative-quality.json",
+      "$ref": "/schemas/3.0.5/enums/creative-quality.json",
       "description": "Render quality for inline preview when include_preview is true. 'draft' produces fast, lower-fidelity renderings. 'production' produces full-quality renderings. Independent of the build quality parameter — you can build at draft quality and preview at production quality, or vice versa. If omitted, the creative agent uses its own default. Ignored when include_preview is false or omitted."
     },
     "preview_output_format": {
-      "$ref": "/schemas/3.0.1/enums/preview-output-format.json",
+      "$ref": "/schemas/3.0.5/enums/preview-output-format.json",
       "default": "url",
       "description": "Output format for preview renders when include_preview is true. 'url' returns preview_url (iframe-embeddable URL), 'html' returns preview_html (raw HTML). Ignored when include_preview is false or omitted."
     },
@@ -125,10 +125,10 @@
       "pattern": "^[A-Za-z0-9_.:-]{16,255}$"
     },
     "context": {
-      "$ref": "/schemas/3.0.1/core/context.json"
+      "$ref": "/schemas/3.0.5/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.0.1/core/ext.json"
+      "$ref": "/schemas/3.0.5/core/ext.json"
     }
   },
   "required": [

package/dist/lib/schemas-data/3.0/media-buy/build-creative-response.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.0.1/media-buy/build-creative-response.json",
+  "$id": "/schemas/3.0.5/media-buy/build-creative-response.json",
   "title": "Build Creative Response",
   "description": "Response containing the transformed or generated creative manifest(s), ready for use with preview_creative or sync_creatives. Returns either a single creative_manifest, an array of creative_manifests (for multi-format requests), or error information.",
   "type": "object",
@@ -11,7 +11,7 @@
       "type": "object",
       "properties": {
         "creative_manifest": {
-          "$ref": "/schemas/3.0.1/core/creative-manifest.json",
+          "$ref": "/schemas/3.0.5/core/creative-manifest.json",
           "description": "The generated or transformed creative manifest"
         },
         "sandbox": {
@@ -41,7 +41,7 @@
                     "type": "array",
                     "description": "Array of rendered pieces for this preview variant. Most formats render as a single piece. Companion ad formats render as multiple pieces.",
                     "items": {
-                      "$ref": "/schemas/3.0.1/creative/preview-render.json"
+                      "$ref": "/schemas/3.0.5/creative/preview-render.json"
                     },
                     "minItems": 1
                   },
@@ -96,7 +96,7 @@
           ]
         },
         "preview_error": {
-          "$ref": "/schemas/3.0.1/core/error.json",
+          "$ref": "/schemas/3.0.5/core/error.json",
           "description": "When include_preview was true in the request but preview generation failed. Uses the standard error structure with code, message, and recovery classification. Distinguishes 'agent does not support inline preview' (preview and preview_error both absent) from 'preview generation failed' (preview absent, preview_error present). Omitted when preview succeeded or was not requested."
         },
         "pricing_option_id": {
@@ -115,14 +115,14 @@
           "description": "ISO 4217 currency code for vendor_cost."
         },
         "consumption": {
-          "$ref": "/schemas/3.0.1/core/creative-consumption.json",
+          "$ref": "/schemas/3.0.5/core/creative-consumption.json",
           "description": "Structured consumption details for this build. Informational — lets the buyer verify that vendor_cost is consistent with the rate card. vendor_cost is the billing source of truth."
         },
         "context": {
-          "$ref": "/schemas/3.0.1/core/context.json"
+          "$ref": "/schemas/3.0.5/core/context.json"
         },
         "ext": {
-          "$ref": "/schemas/3.0.1/core/ext.json"
+          "$ref": "/schemas/3.0.5/core/ext.json"
         }
       },
       "required": [
@@ -138,7 +138,7 @@
         "creative_manifests": {
           "type": "array",
           "items": {
-            "$ref": "/schemas/3.0.1/core/creative-manifest.json"
+            "$ref": "/schemas/3.0.5/core/creative-manifest.json"
           },
           "minItems": 1,
           "description": "Array of generated creative manifests, one per requested format. Each manifest contains its own format_id identifying which format it was generated for."
@@ -167,14 +167,14 @@
                     "description": "Unique identifier for this preview"
                   },
                   "format_id": {
-                    "$ref": "/schemas/3.0.1/core/format-id.json",
+                    "$ref": "/schemas/3.0.5/core/format-id.json",
                     "description": "The format this preview was generated for. Matches one of the requested target_format_ids."
                   },
                   "renders": {
                     "type": "array",
                     "description": "Array of rendered pieces for this format's preview. Most formats render as a single piece. Companion ad formats render as multiple pieces.",
                     "items": {
-                      "$ref": "/schemas/3.0.1/creative/preview-render.json"
+                      "$ref": "/schemas/3.0.5/creative/preview-render.json"
                     },
                     "minItems": 1
                   },
@@ -230,7 +230,7 @@
           ]
         },
         "preview_error": {
-          "$ref": "/schemas/3.0.1/core/error.json",
+          "$ref": "/schemas/3.0.5/core/error.json",
           "description": "When include_preview was true in the request but preview generation failed. Uses the standard error structure with code, message, and recovery classification. Omitted when preview succeeded or was not requested."
         },
         "pricing_option_id": {
@@ -249,14 +249,14 @@
           "description": "ISO 4217 currency code for vendor_cost."
         },
         "consumption": {
-          "$ref": "/schemas/3.0.1/core/creative-consumption.json",
+          "$ref": "/schemas/3.0.5/core/creative-consumption.json",
           "description": "Structured consumption details for this build. Informational — lets the buyer verify that vendor_cost is consistent with the rate card."
         },
         "context": {
-          "$ref": "/schemas/3.0.1/core/context.json"
+          "$ref": "/schemas/3.0.5/core/context.json"
         },
         "ext": {
-          "$ref": "/schemas/3.0.1/core/ext.json"
+          "$ref": "/schemas/3.0.5/core/ext.json"
         }
       },
       "required": [
@@ -273,15 +273,15 @@
           "type": "array",
           "description": "Array of errors explaining why creative generation failed",
           "items": {
-            "$ref": "/schemas/3.0.1/core/error.json"
+            "$ref": "/schemas/3.0.5/core/error.json"
           },
           "minItems": 1
         },
         "context": {
-          "$ref": "/schemas/3.0.1/core/context.json"
+          "$ref": "/schemas/3.0.5/core/context.json"
         },
         "ext": {
-          "$ref": "/schemas/3.0.1/core/ext.json"
+          "$ref": "/schemas/3.0.5/core/ext.json"
         }
       },
       "required": [

package/dist/lib/schemas-data/3.0/media-buy/create-media-buy-async-response-input-required.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.0.1/media-buy/create-media-buy-async-response-input-required.json",
+  "$id": "/schemas/3.0.5/media-buy/create-media-buy-async-response-input-required.json",
   "title": "Create Media Buy - Input Required",
   "description": "Payload when task is paused waiting for user input or approval.",
   "type": "object",
@@ -17,14 +17,14 @@
       "type": "array",
       "description": "Optional validation errors or warnings for debugging purposes. Helps explain why input is required.",
       "items": {
-        "$ref": "/schemas/3.0.1/core/error.json"
+        "$ref": "/schemas/3.0.5/core/error.json"
       }
     },
     "context": {
-      "$ref": "/schemas/3.0.1/core/context.json"
+      "$ref": "/schemas/3.0.5/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.0.1/core/ext.json"
+      "$ref": "/schemas/3.0.5/core/ext.json"
     }
   },
   "additionalProperties": true

package/dist/lib/schemas-data/3.0/media-buy/create-media-buy-async-response-submitted.json

@@ -1,15 +1,15 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.0.1/media-buy/create-media-buy-async-response-submitted.json",
+  "$id": "/schemas/3.0.5/media-buy/create-media-buy-async-response-submitted.json",
   "title": "Create Media Buy - Submitted",
   "description": "Payload acknowledging the task is queued. Usually empty or just context.",
   "type": "object",
   "properties": {
     "context": {
-      "$ref": "/schemas/3.0.1/core/context.json"
+      "$ref": "/schemas/3.0.5/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.0.1/core/ext.json"
+      "$ref": "/schemas/3.0.5/core/ext.json"
     }
   },
   "additionalProperties": true

package/dist/lib/schemas-data/3.0/media-buy/create-media-buy-async-response-working.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.0.1/media-buy/create-media-buy-async-response-working.json",
+  "$id": "/schemas/3.0.5/media-buy/create-media-buy-async-response-working.json",
   "title": "Create Media Buy - Working",
   "description": "Progress payload for active create_media_buy task.",
   "type": "object",
@@ -26,10 +26,10 @@
       "description": "Current step number"
     },
     "context": {
-      "$ref": "/schemas/3.0.1/core/context.json"
+      "$ref": "/schemas/3.0.5/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.0.1/core/ext.json"
+      "$ref": "/schemas/3.0.5/core/ext.json"
     }
   },
   "additionalProperties": true

package/dist/lib/schemas-data/3.0/media-buy/create-media-buy-request.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.0.1/media-buy/create-media-buy-request.json",
+  "$id": "/schemas/3.0.5/media-buy/create-media-buy-request.json",
   "title": "Create Media Buy Request",
   "description": "Request parameters for creating a media buy. Supports two modes: (1) Manual mode - provide packages array with explicit line item configurations, or (2) Proposal mode - provide proposal_id and total_budget to execute a proposal from get_products. One of packages or proposal_id must be provided.",
   "x-mutates-state": true,
@@ -25,7 +25,7 @@
       "x-entity": "governance_plan"
     },
     "account": {
-      "$ref": "/schemas/3.0.1/core/account-ref.json",
+      "$ref": "/schemas/3.0.5/core/account-ref.json",
       "description": "Account to bill for this media buy. Pass a natural key (brand, operator, optional sandbox) or a seller-assigned account_id from list_accounts."
     },
     "proposal_id": {
@@ -56,20 +56,20 @@
       "type": "array",
       "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.",
       "items": {
-        "$ref": "/schemas/3.0.1/media-buy/package-request.json"
+        "$ref": "/schemas/3.0.5/media-buy/package-request.json"
       },
       "minItems": 1
     },
     "brand": {
-      "$ref": "/schemas/3.0.1/core/brand-ref.json",
+      "$ref": "/schemas/3.0.5/core/brand-ref.json",
       "description": "Brand reference for this media buy. Resolved to full brand identity at execution time from brand.json or the registry."
     },
     "advertiser_industry": {
-      "$ref": "/schemas/3.0.1/enums/advertiser-industry.json",
+      "$ref": "/schemas/3.0.5/enums/advertiser-industry.json",
       "description": "Industry classification for this specific campaign. A brand may operate across multiple industries (brand.json industries field), but each media buy targets one. For example, a consumer health company running a wellness campaign sends 'healthcare.wellness', not 'cpg'. Sellers map this to platform-native codes (e.g., Spotify ADV categories, LinkedIn industry IDs). When omitted, sellers may infer from the brand manifest's industries field."
     },
     "invoice_recipient": {
-      "$ref": "/schemas/3.0.1/core/business-entity.json",
+      "$ref": "/schemas/3.0.5/core/business-entity.json",
       "description": "Override the account's default billing entity for this specific buy. When provided, the seller invoices this entity instead. The seller MUST validate the invoice recipient is authorized for this account. When governance_agents are configured, the seller MUST include invoice_recipient in the check_governance request."
     },
     "io_acceptance": {
@@ -113,7 +113,7 @@
       "description": "Agency estimate or authorization number. Primary financial reference for broadcast buys — links the order to the agency's media plan and billing system. Travels with the order and Ad-IDs through the transaction lifecycle."
     },
     "start_time": {
-      "$ref": "/schemas/3.0.1/core/start-timing.json"
+      "$ref": "/schemas/3.0.5/core/start-timing.json"
     },
     "end_time": {
       "type": "string",
@@ -121,11 +121,11 @@
       "description": "Campaign end date/time in ISO 8601 format"
     },
     "push_notification_config": {
-      "$ref": "/schemas/3.0.1/core/push-notification-config.json",
+      "$ref": "/schemas/3.0.5/core/push-notification-config.json",
       "description": "Optional webhook configuration for async task status notifications. Publisher will send webhooks when status changes (working, input-required, completed, failed). The client generates an operation_id and embeds it in the URL before sending — the publisher echoes it back in webhook payloads for correlation."
     },
     "reporting_webhook": {
-      "$ref": "/schemas/3.0.1/core/reporting-webhook.json",
+      "$ref": "/schemas/3.0.5/core/reporting-webhook.json",
       "description": "Optional webhook configuration for automated reporting delivery"
     },
     "artifact_webhook": {
@@ -151,7 +151,7 @@
               "type": "array",
               "description": "Array of authentication schemes. Supported: ['Bearer'] for simple token auth, ['HMAC-SHA256'] for signature verification (recommended for production)",
               "items": {
-                "$ref": "/schemas/3.0.1/enums/auth-scheme.json"
+                "$ref": "/schemas/3.0.5/enums/auth-scheme.json"
               },
               "minItems": 1,
               "maxItems": 1
@@ -199,10 +199,10 @@
       "additionalProperties": true
     },
     "context": {
-      "$ref": "/schemas/3.0.1/core/context.json"
+      "$ref": "/schemas/3.0.5/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.0.1/core/ext.json"
+      "$ref": "/schemas/3.0.5/core/ext.json"
     }
   },
   "required": [