diff --git a/.changeset/open-schemas-meant-to-be-open.md b/.changeset/open-schemas-meant-to-be-open.md new file mode 100644 index 00000000000..3ec19d0074c --- /dev/null +++ b/.changeset/open-schemas-meant-to-be-open.md @@ -0,0 +1,24 @@ +--- +"adcontextprotocol": minor +--- + +Open the schemas that were meant to be open (working-group decision of 2026-11-09, DR-0036). Closing a schema only breaks validators that hard-code it, so opening one is not a protocol break. + +`additionalProperties` goes from `false` to `true` at 747 of the 859 closed locations in the 3.3 source. Nothing else in those schemas changes, and every payload that was valid stays valid. This includes the capability blocks and containers that #8772 opened (daypart windows, the targeting overlay requirement and support containers, and the spot and canonical reporting capabilities), folded in here with thanks to Konstantin Mirin. The `sync_creatives` `assign` operation opens too. Its `operation` const keeps the branches apart, so it doesn't need #8772's named exception. From #8772, boolean `demographics` on the overlay schemas is also deprecated as the 3.2 shorthand for `{ "age": true }`. Senders MUST send the object form, receivers MUST accept `true`, and only support with `gender: true` satisfies a `gender` requirement. 4.0 removes the boolean form. + +112 locations stay closed: most for a structural reason, and the commercial terms as a hold until 4.0. + +- `oneOf` forms told apart by key presence: `a2ui/bound-value.json` and the `brand.json` document forms. +- Held closed until 4.0, as a hold rather than a structural reason: `commercial-terms`, `product-purchase`, `change-term`, `change-term-constraints`, `sla-window`, `bidding-policy`, and the canonical measurement terms, performance standard, reporting commitment, pricing option and budget allocation. +- Join keys: metric `qualifier` objects and forecast dimensions. +- `canonical-installment-ref` and the JWS response-payload envelope. +- Privacy clamps: the TMP identity and context match requests, `catalog-item-reference-not-found-error`, the per-agent `PERMISSION_DENIED` and `BILLING_NOT_PERMITTED_FOR_AGENT` details, the `get_principal` recognized, unconfigured and failed results and the `sync_principal` failed result, and the error objects of the `get_reporting_status` `lookup_unavailable` failure. +- Credential-free reporting destinations. `proposal-budget-constraint`, the strict peer of `budget-range`, is held until 4.0 with the commercial terms. +- No key material or markup: `trust.json`, on the signature-verification fetch path, and the declarative `placement-presentation` frame. +- Maps keyed by identifiers (`patternProperties`). + +Where closure also rejected a specific field the protocol defines elsewhere, the opened schema names it in `not: { anyOf: [{ required: [...] }] }`, as #8531 did for `canonical-product`. For example, `trackers` and `landing_page_url` stay `assign`-only, hold entries carry no `expires_at`, and delivery-ready webhooks carry no access token. Each node with a named rejection says in its description what it rejects and why, since generated types can't express `not`. + +The additive-minor check now flags an added property only where the schema stays closed. It still fails on removals, renames, retypes, removed enum values, tightened bounds, new required names, and closing an open schema. The closed-anywhere-in-the-major rule and the reopening corrections are gone, and the baseline keeps 4 entries, each with its resolution. + +**Generated types change.** A generator that reads `additionalProperties` now treats the opened objects as open: json-schema-to-typescript gives them an index signature, and Pydantic models stop forbidding extra fields. A strict validator built from the 3.2 schemas still rejects 3.3 fields on these objects, so send a 3.3 field only to a 3.3 peer. The next 3.2.x patch (#8864) opens the same locations that 3.2 has, all but one: it keeps `get-reporting-status-response.json#/oneOf/1/oneOf/0` closed, as 3.2 published it. diff --git a/.changeset/pre/compose-protocol-envelope-on-task-responses.md b/.changeset/pre/compose-protocol-envelope-on-task-responses.md index 0c56acbabc2..a4f0e6568fb 100644 --- a/.changeset/pre/compose-protocol-envelope-on-task-responses.md +++ b/.changeset/pre/compose-protocol-envelope-on-task-responses.md @@ -5,11 +5,11 @@ Every task response schema and async status payload now composes `core/protocol-envelope.json` through its root `allOf`, as the envelope's notes already require. On MCP and REST the envelope fields (`status`, `task_id`, `context_id`, `context`, `message`, `timestamp`, `replayed`, `adcp_error`, `push_notification_config`, `governance_context`) are siblings of the body fields at the response root, but 47 of the 124 tool response and async status schemas did not compose the envelope, and 18 closed roots and `oneOf`/`anyOf` branches rejected envelope fields outright, because draft-07 `additionalProperties` does not see properties declared through `allOf`. Generated SDK types therefore could not represent a conforming response. - `core/protocol-envelope.json` composes `core/version-envelope.json`, so `adcp_version` and `adcp_major_version` are envelope fields on every response, stamped by the server framework rather than carried as task data. Request schemas keep composing the version envelope directly; response schemas no longer do. -- Every response root and status branch is open, as DR-0019 keeps response roots, so the envelope's fields validate where the envelope declares them. The 18 that were closed are reopened: the 3.2 proposal-flow response roots and branches (DR-0036 correction (a)), the `list_collections`, `list_proposals`, `get_media_buy_issue` and `report_media_buy_issue` responses, which are new in 3.3, and the `get_reporting_status` failure branches, which are experimental. Closed value objects and rows inside response bodies stay closed. No build step adds the envelope: source and published schemas agree. +- Every response root and status branch is open, as DR-0019 keeps response roots, so the envelope's fields validate where the envelope declares them. The 18 that were closed are reopened: the 3.2 proposal-flow response roots and branches (reopened earlier in 3.3), the `list_collections`, `list_proposals`, `get_media_buy_issue` and `report_media_buy_issue` responses, which are new in 3.3, and the `get_reporting_status` failure branches, which are experimental. Closed value objects and rows inside response bodies stay closed. No build step adds the envelope: source and published schemas agree. - A local declaration of an envelope field is kept only where it narrows: a branch's `status` const or enum, a `const` pin such as the fixed `message` and `adcp_error` of an unavailable `get_reporting_status` lookup, and `context` as a `$ref` to `core/context.json`. The 66 other local copies (`task_id` ×23, `message` ×21, `replayed` ×11, the `get_reporting_status` failure branches' `adcp_version`, `adcp_major_version`, `context_id`, `timestamp` and `adcp_error`, `governance_context` on `check_governance`, and `status` on `get_task_status`) are removed, so the envelope's declarations govern. The untrusted-input guidance on the async `message` copies moves to `core/task-message.json`. The root `status` enums on `decline_proposals`, `request_proposals` and `refine_proposals` are removed; their branch consts discriminate. - The compact proposal-flow responses no longer pin `replayed` to `true` (12 locations); the envelope's boolean governs, so a response accepts `replayed: false`. -- A task-level `message` has one bound of 2,000 characters, in one definition: `core/task-message.json` (`type: string`, `maxLength: 2000`, untrusted input to the receiver). The envelope, the MCP webhook payload and the response wrapper refer to it, so the bound does not depend on the delivery path. The 23 response nodes that capped `message` at 2,000 themselves no longer restate it. A seller whose text is longer MUST truncate it rather than fail the task. 3.2.7's envelope, webhook payload and wrapper declared no bound; DR-0036 records the change as correction (d), at the 2,000 that 3.2.7 published on the compact and submitted responses. A `const` pin on `message`, such as the fixed text of an unavailable `get_reporting_status` lookup, is kept. `core/error.json`, `core/warning.json` and messages inside task bodies keep their own bounds. -- `task_id` has one definition, `core/task-id.json` (`type: string`, `minLength: 1`), that every `task_id` declaration refers to: the envelope, `tasks/get` and `get_task_status` requests and responses, the task list responses and filters, the MCP webhook payload and the compliance controller (which keeps its own `maxLength: 128`). An empty `task_id` identifies no task, so it is rejected; 3.2.7 already published `minLength: 1` on `core/compact-task-submitted.json`. DR-0036 records this as correction (c). A submitted response requires `task_id` through `core/task-submitted.json` (`status: submitted` and a required `task_id`), which every submitted response body and branch composes through `allOf`, so none restates the rule; generated types see the requirement. Likewise every working body composes `core/task-working.json` (`status: working`) and every input-required body composes `core/task-input-required.json` (`status: input-required`), so an async status payload accepts only its own status. +- A task-level `message` has one bound of 2,000 characters, in one definition: `core/task-message.json` (`type: string`, `maxLength: 2000`, untrusted input to the receiver). The envelope, the MCP webhook payload and the response wrapper refer to it, so the bound does not depend on the delivery path. The 23 response nodes that capped `message` at 2,000 themselves no longer restate it. A seller whose text is longer MUST truncate it rather than fail the task. 3.2.7's envelope, webhook payload and wrapper declared no bound; DR-0036 records the change as a correction, at the 2,000 that 3.2.7 published on the compact and submitted responses. A `const` pin on `message`, such as the fixed text of an unavailable `get_reporting_status` lookup, is kept. `core/error.json`, `core/warning.json` and messages inside task bodies keep their own bounds. +- `task_id` has one definition, `core/task-id.json` (`type: string`, `minLength: 1`), that every `task_id` declaration refers to: the envelope, `tasks/get` and `get_task_status` requests and responses, the task list responses and filters, the MCP webhook payload and the compliance controller (which keeps its own `maxLength: 128`). An empty `task_id` identifies no task, so it is rejected; 3.2.7 already published `minLength: 1` on `core/compact-task-submitted.json`. DR-0036 records this as a correction. A submitted response requires `task_id` through `core/task-submitted.json` (`status: submitted` and a required `task_id`), which every submitted response body and branch composes through `allOf`, so none restates the rule; generated types see the requirement. Likewise every working body composes `core/task-working.json` (`status: working`) and every input-required body composes `core/task-input-required.json` (`status: input-required`), so an async status payload accepts only its own status. - `core/protocol-envelope.json` states that an absent `replayed` means `false` and that a response may carry `replayed: false`; `replayed: true` appears only on a replay. - Async status payloads and the governance responses now require `status`, which the envelope already made required on every task response. Webhook `result` examples carry the task's `status`. diff --git a/.changeset/pre/reopen-proposal-flow-schemas.md b/.changeset/pre/reopen-proposal-flow-schemas.md index d7efd983598..241747ace2b 100644 --- a/.changeset/pre/reopen-proposal-flow-schemas.md +++ b/.changeset/pre/reopen-proposal-flow-schemas.md @@ -2,7 +2,7 @@ "adcontextprotocol": patch --- -Reopen the 3.2 proposal-flow schemas that were closed against DR-0019, as correction (a) recorded in DR-0036. +Reopen the 3.2 proposal-flow schemas that were closed against DR-0019. They were the first 3.2 schemas 3.3 opened; under the WG decision of 2026-11-09 (DR-0036), 3.3 then opened every schema that was meant to be open. 3.2 published the proposal-flow task roots and containers with `additionalProperties: false`. DR-0019 keeps request roots, response roots, and container objects open. These schemas now set `additionalProperties: true` at the listed locations: diff --git a/.changeset/pre/seller-offers-against-accepted-buys.md b/.changeset/pre/seller-offers-against-accepted-buys.md index 222225e3500..a5fa88c9f19 100644 --- a/.changeset/pre/seller-offers-against-accepted-buys.md +++ b/.changeset/pre/seller-offers-against-accepted-buys.md @@ -8,4 +8,4 @@ The buyer accepts with `accept_proposal`, declines with `decline_proposals`, or Seller-held change terms (pre-agreed seller changes inside `commercial_terms.change_terms[]`) are not part of 3.3: `commercial_terms` and `change-term.json` stay closed for the whole 3.x major, so the design is recorded for 4.0 as the `seller_held_change_terms_required_in_4_0` check in the 4.0 compatibility registry and in a "Planned for 4.0" note in the proposal-negotiation guide (#8087). In 3.3 every seller-initiated change to a signed buy is an offer. -Compatibility: sellers MUST NOT send offers or `proposal.offered` notifications to callers served below AdCP 3.3, because `proposal_initiator` is a 3.3 field on a schema reopened in 3.3, and 3.3 fields on reopened schemas go only to 3.3 peers (DR-0036); a caller with no declared pin is treated as below 3.3. +Compatibility: sellers MUST NOT send offers or `proposal.offered` notifications to callers served below AdCP 3.3, because `proposal_initiator` is a 3.3 field on a schema reopened in 3.3, and a seller shapes each response to the caller's served release (DR-0024); a caller with no declared pin is treated as below 3.3. diff --git a/.changeset/pre/withdraw-commercial-terms-features-to-4-0.md b/.changeset/pre/withdraw-commercial-terms-features-to-4-0.md index c593485c445..36d2469b8a1 100644 --- a/.changeset/pre/withdraw-commercial-terms-features-to-4-0.md +++ b/.changeset/pre/withdraw-commercial-terms-features-to-4-0.md @@ -2,7 +2,7 @@ "adcontextprotocol": minor --- -Withdraw definition pins, purchase rights, and installment selection from 3.3 and plan them for 4.0 (adcp#8501). All three add terms to `commercial_terms`. The `commercial-terms` schema is closed on purpose: a buyer must not be bound by terms it cannot read, and `terms_digest` signs exactly those terms. If the object were open, a 3.2 buyer could accept a 3.3 term it silently ignored, and a minor release never changes a closed schema (DR-0036). 4.0 gives `commercial_terms` a declared extension point with must-understand, and the three features come back through it. +Withdraw definition pins, purchase rights, and installment selection from 3.3 and plan them for 4.0 (adcp#8501). All three add terms to `commercial_terms`. The `commercial-terms` schema is held closed until 4.0 (DR-0036). 4.0 gives `commercial_terms` a declared extension point with must-understand, and the three features come back through it. **All three shipped in `3.3.0-beta.1` and are removed after it.** This is a beta-to-beta change, not a change to a stable release. Both betas are immutable, so a seller or SDK built from a beta bundle has the surfaces below to remove. The two experimental features also leave `experimental_features`: a seller stops listing `media_buy.purchase_rights` and `media_buy.installment_selection`. diff --git a/docs/building/by-layer/L1/security.mdx b/docs/building/by-layer/L1/security.mdx index 4ec65bf7284..845373870f5 100644 --- a/docs/building/by-layer/L1/security.mdx +++ b/docs/building/by-layer/L1/security.mdx @@ -2565,9 +2565,10 @@ present, every list and map is full, every string is at its maximum length, a union takes its widest branch, free text takes four bytes per character, and patterned or formatted strings one. The largest blocks are `media_buy` (34 MiB), `creative` (27 MiB), `adcp` (12 MiB), `governance` (6 MiB), `account` (5 MiB), -and `measurement` (4 MiB). Objects that admit undeclared members, such as `ext` -and context, are open: the schema cannot bound what a producer adds there, and -108 positions in the response are open in this sense. +and `measurement` (4 MiB). Objects that admit undeclared members, such as `ext`, +context, and the capability blocks 3.3 opens, are open: the schema cannot bound +what a producer adds there, and 190 positions in the response are open in this +sense. The multipliers behind that figure are nested object lists inside shared schemas: a brand reference (`brand-ref`, up to 111 KiB each, most of it diff --git a/docs/governance/campaign/specification.mdx b/docs/governance/campaign/specification.mdx index 5b76f93ac9a..797ca87e48e 100644 --- a/docs/governance/campaign/specification.mdx +++ b/docs/governance/campaign/specification.mdx @@ -929,7 +929,7 @@ Closed list — governance agents MUST NOT extend or shrink it; any addition is - `committedBudget` — derived from downstream `check_governance` / `report_plan_outcome` activity - `committedByType` — derived from the same activity -None of these appear in the `sync_plans` request schema (`additionalProperties: false` on the plan item); they exist only on the governance agent's persisted plan state. The list is stated explicitly so an implementer naively hashing their internal state struct strips the right fields. Implementations that discover additional GA-internal fields on their persisted plan state beyond this list MUST treat those fields as **IN the preimage** until the profile version bumps — fail-safe toward inclusion, not exclusion. The "anything that looks like bookkeeping → strip" shortcut silently diverges every implementation that guesses differently; the safe default is "if it is not on the closed list, it is part of the hash." +None of these is a `sync_plans` request field; they exist only on the governance agent's persisted plan state. The list is stated explicitly so an implementer naively hashing their internal state struct strips the right fields. Implementations that discover additional GA-internal fields on their persisted plan state beyond this list MUST treat those fields as **IN the preimage** until the profile version bumps — fail-safe toward inclusion, not exclusion. The "anything that looks like bookkeeping → strip" shortcut silently diverges every implementation that guesses differently; the safe default is "if it is not on the closed list, it is part of the hash." All other fields — including `ext`, `custom_policies`, `objectives`, `delegations`, `human_override`, and every field declared in the `sync_plans` plan-item schema — are IN the preimage. Caller guidance: diff --git a/docs/governance/content-standards/index.mdx b/docs/governance/content-standards/index.mdx index 065a4dfb095..f4e04418d93 100644 --- a/docs/governance/content-standards/index.mdx +++ b/docs/governance/content-standards/index.mdx @@ -225,7 +225,7 @@ Content Standards uses **addressable policies** — an array of policy entries, | `exemplars` | No | Structured `pass` and `fail` scenarios used to calibrate policy interpretation. | | `ext` | No | Vendor-namespaced extension data for partner-specific metadata. | -Policy entries are closed objects: fields outside this table fail schema validation rather than being silently ignored. Put partner-specific, buyer-visible metadata under a vendor key in `ext` (for example, `ext.acme`) instead of adding sibling fields or encoding structured metadata inside the natural-language `policy` value. +Fields outside this table aren't part of a policy entry, and readers ignore them. Put partner-specific, buyer-visible metadata under a vendor key in `ext` (for example, `ext.acme`) instead of adding sibling fields or encoding structured metadata inside the natural-language `policy` value. ```json { diff --git a/docs/media-buy/advanced-topics/pricing-models.mdx b/docs/media-buy/advanced-topics/pricing-models.mdx index f31d880291a..53b85d9fc60 100644 --- a/docs/media-buy/advanced-topics/pricing-models.mdx +++ b/docs/media-buy/advanced-topics/pricing-models.mdx @@ -895,7 +895,7 @@ A price, whether a fully priced offer or resolved from a table, is bound to what - In the accepted purchase `pricing`, the seller MUST return `fixed_price` as the resolved rate. When any row fired, the seller MUST also return `price_breakdown`: its `list_price` is the declared option's `list_price` when the option declares a `price_breakdown`, and otherwise the option's declared `fixed_price`; its `adjustments` are the declared breakdown's adjustments followed by one entry per fired row, in declared order. A rate row is recorded with its `rate` when that rate is below 1, and as its currency delta in `amount` otherwise (a fee rate of 1 or more); an amount row is recorded as its `amount`; a row whose delta rounds to zero contributes nothing and is omitted. `list_price` folded through `adjustments` equals `fixed_price`, so the invariant above covers selection-dependent pricing. A verifier re-resolves the table of the accepted `pricing_option_id` over the purchase's selections and flight and compares. - **The accepted `pricing_option_id` pins the table.** Any change to the table, or to which selections or dates it matches, is a change to binding price and mints a new `pricing_option_id`. So the accepted `pricing_option_id`, which `commercial_terms.terms_digest` covers, identifies exactly one immutable table, unfired rows and rows for other windows included. Changes the agreement already permits (a different format option or placement within the accepted `change_terms[]`) are priced from the table of the accepted `pricing_option_id` without a re-quote. Both parties retain that table from discovery, and the seller MUST price from it, not from a later table the option's successor carries. Quote expiry does not apply once the option is accepted: the accepted ID still names the table. - **The table grants no change rights.** Pinning the table does not make any selection or date change allowed. Which changes the buyer may make come only from the accepted `change_terms[]` ([DR-0016](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0016-proposal-bound-buyer-change-rights.md)): a change they do not permit returns `ACTION_NOT_ALLOWED` whatever the table would price it at, and a change that exceeds the accepted commercial envelope returns `REQUOTE_REQUIRED`. A seller MUST NOT read a row for an unused value as consent to that change, and a buyer MUST NOT read it as an entitlement. -- **The table is not embedded in the accepted snapshot.** The canonical schemas that carry accepted terms (`canonical-pricing-option.json`, `product-purchase.json`, and the commercial terms that contain them) are closed, and a minor release does not add properties to closed schemas. Embedding the table in the snapshot, so the terms are self-contained without the retained discovery copy, is a 4.0 item tracked with [#8501](https://github.com/adcontextprotocol/adcp/issues/8501). +- **The table is not embedded in the accepted snapshot.** The canonical schemas that carry accepted terms (`canonical-pricing-option.json`, `product-purchase.json`, and the commercial terms that contain them) are held closed until 4.0. Embedding the table in the snapshot, so the terms are self-contained without the retained discovery copy, is a 4.0 item tracked with [#8501](https://github.com/adcontextprotocol/adcp/issues/8501). A seller MUST NOT return an option carrying `price_adjustments` to a caller whose `adcp_version` is below 3.3, because an older buyer would read `fixed_price` as the whole price and be repriced at create; for those callers it publishes fully priced per-selection options or omits the option. A consumer that does not recognize a row's `dimension` treats the option as unpurchasable. The `fixed_price` is net of the option's declared discounts. Auction floors (`floor_price`) do not take adjustments, and `price_adjustments` requires `fixed_price`. Availability and forecasts stay seller-computed: the price resolves locally but feasibility does not. diff --git a/docs/media-buy/product-discovery/collections-and-installments.mdx b/docs/media-buy/product-discovery/collections-and-installments.mdx index bcbabb43e32..21ecc932551 100644 --- a/docs/media-buy/product-discovery/collections-and-installments.mdx +++ b/docs/media-buy/product-discovery/collections-and-installments.mdx @@ -789,7 +789,7 @@ Two qualifications matter in practice. ### Buying a product that names installments -A purchase buys the product as offered: run-of-collection when the product names no installments, and the product's complete installment set when it does. In 3.3 a purchase cannot name the exact slots it buys, and `refine_proposals` cannot drop or swap one. `commercial_terms` is closed in 3.x, so a slot selection a buyer could not read, but would be bound by through `terms_digest`, cannot be added in a minor release. Installment selection is planned for 4.0, where `commercial_terms` gets a declared extension point with must-understand; see [Planned for 4.0](/docs/reference/migration/v4-compatibility#installment_selection_required_in_4_0). +A purchase buys the product as offered: run-of-collection when the product names no installments, and the product's complete installment set when it does. In 3.3 a purchase cannot name the exact slots it buys, and `refine_proposals` cannot drop or swap one. `commercial_terms` is held closed until 4.0, so a slot selection waits for 4.0's declared extension point. Installment selection is planned for 4.0, where `commercial_terms` gets a declared extension point with must-understand; see [Planned for 4.0](/docs/reference/migration/v4-compatibility#installment_selection_required_in_4_0). A committed proposal can read back which installments its hold covers, in `holds[]` (experimental, `media_buy.installment_holds`); see [Installment holds](/docs/media-buy/task-reference/refine_proposals#installment-holds-experimental). `holds[]` is readback about the hold finalize placed, not contract, and is not covered by `terms_digest`. diff --git a/docs/media-buy/product-discovery/proposal-negotiation.mdx b/docs/media-buy/product-discovery/proposal-negotiation.mdx index 5e94ab9179e..5307a8c2162 100644 --- a/docs/media-buy/product-discovery/proposal-negotiation.mdx +++ b/docs/media-buy/product-discovery/proposal-negotiation.mdx @@ -509,7 +509,7 @@ flowchart LR ## Planned for 4.0: seller-held change terms -Not in 3.3. The group considered letting a seller state, in the committed terms, bounded changes it may make to a purchase without an offer (a budget release, a schedule shift, ordered line alternates), which the buyer would bind through `accept_proposal`. That design needs new members on `commercial_terms.change_terms[]`, and `commercial_terms` stays closed for the whole 3.x major, so it ships in 4.0 and is recorded in the [4.0 compatibility registry](/docs/reference/migration/v4-compatibility#seller_held_change_terms_required_in_4_0) ([#8087](https://github.com/adcontextprotocol/adcp/issues/8087)). The shape it is expected to take: +Not in 3.3. The group considered letting a seller state, in the committed terms, bounded changes it may make to a purchase without an offer (a budget release, a schedule shift, ordered line alternates), which the buyer would bind through `accept_proposal`. That design needs new members on `commercial_terms.change_terms[]`, and `commercial_terms` is held closed until 4.0, so it ships in 4.0 and is recorded in the [4.0 compatibility registry](/docs/reference/migration/v4-compatibility#seller_held_change_terms_required_in_4_0) ([#8087](https://github.com/adcontextprotocol/adcp/issues/8087)). The shape it is expected to take: - **One vocabulary.** `change_terms[]` entries gain `holder` (`buyer` or `seller`, default `buyer`) and `purchase_index`, rather than a second array. A seller-held term is limited to `decrease_budget`, `update_impression_goal`, `update_flight_dates` and `update_targeting`, plus an `alternates` constraint kind for television line alternates. - **Absolute bounds.** Every seller-held term carries at least one bound on the result (`min_result_amount`, `earliest_result` / `latest_result`, a minimum impression goal, or an ordered alternates chain), never a change measured from a base, so successive applications cannot compound. diff --git a/docs/media-buy/product-discovery/refinement.mdx b/docs/media-buy/product-discovery/refinement.mdx index ff9e8cc1393..2b7c293b995 100644 --- a/docs/media-buy/product-discovery/refinement.mdx +++ b/docs/media-buy/product-discovery/refinement.mdx @@ -472,13 +472,12 @@ Client implementations should validate refinement requests against the [request | `MULTI_FINALIZE_UNSUPPORTED` | `refine[]` carried multiple `action: 'finalize'` entries but the seller cannot guarantee atomic multi-proposal commit | Sequence single-proposal finalize calls (one finalize per `get_products` call) | | `INVALID_REQUEST` | `refine` provided in `brief` or `wholesale` mode, empty `refine` array, or missing required fields | Check `buying_mode` and required fields | -### Troubleshooting: "must NOT have additional properties" on `refine[].id` +### Troubleshooting: "must have required property 'product_id'" on `refine[]` -Each scope branch in `refine[]` is `additionalProperties: false`, which means a stray `id` field from the pre-3.0-rc refine shape is rejected — not silently ignored — with an error along the lines of: +The `product` scope requires `product_id` and the `proposal` scope requires `proposal_id` (the `request` scope requires `ask` instead). So an entry that carries only the generic `id` field from the pre-3.0-rc refine shape is rejected, with an error along the lines of: ``` -/refine/0: must NOT have additional properties { additionalProperty: "id" } -/refine/0: must match oneOf schema { required: ["product_id"] } +/refine/0: must have required property 'product_id' ``` If you see this, an orchestrator is still constructing product or proposal refine entries with the generic `id` field. Rename to `product_id` under `scope: "product"` and `proposal_id` under `scope: "proposal"`. See the [task reference](/docs/media-buy/task-reference/get_products#refine-array) for the current shape. The same rename applies to `refinement_applied[]` if you're echoing on the seller side. diff --git a/docs/media-buy/task-reference/get_products.mdx b/docs/media-buy/task-reference/get_products.mdx index aba73f5a85b..73171415f7c 100644 --- a/docs/media-buy/task-reference/get_products.mdx +++ b/docs/media-buy/task-reference/get_products.mdx @@ -291,7 +291,10 @@ legacy `daypart_targets: true` satisfies only `inventory_local`, whole-hour requirements; structured support is required for `iana`. The experimental `time_granularity` requirement is ordered (`hour` < `quarter_hour` < `minute`): product support matches when it is at least -as fine as the requested value. For `geo_places` and `geo_places_exclude`, +as fine as the requested value. For demographics, the boolean form is +deprecated: `demographics: true` is the 3.2 shorthand for `{ "age": true }`, on +both sides, and matches as that object. Only support with `gender: true` +satisfies a `gender` requirement. Send the object form. For `geo_places` and `geo_places_exclude`, every requested identifier system and country key must exist, and requested place-type and catalog-version arrays must be subsets of the corresponding product support arrays. Unrequested object fields and numeric seller limits do @@ -487,7 +490,7 @@ Audience evidence does not populate `targeting_overlay`, `demographic_targeting` **Experimental** (`media_buy.audience_evidence_targets`). `target_audiences` is part of AdCP 3.3 as an experimental surface: its schemas carry `x-status: experimental`, sellers that evaluate it MUST list `media_buy.audience_evidence_targets` in `experimental_features`, and it may change between 3.x releases with notice. Check the seller's `experimental_features` before sending it. See [Experimental status](/docs/reference/experimental-status). -`target_audiences` is a sibling of `audience_evidence_requirements`, not a member of it: the requirements object is a closed schema and a minor release never changes a closed schema. `target_audiences` MUST be sent with `audience_evidence_requirements`, whose `requirement_mode`, `evidence_presence` and admissibility constraints govern it. The requirements above constrain evidence *quality*. `target_audiences[]` adds *which audience* the buyer cares about, so a buyer can ask for "evidence that at least 40% of this inventory's audience is 25–54" instead of burying the preference in the brief. +`target_audiences` is a sibling of `audience_evidence_requirements`, not a member of it, because the two constrain different things: the requirements above constrain evidence *quality*, and `target_audiences[]` names *which audience* the buyer cares about. `target_audiences` MUST be sent with `audience_evidence_requirements`, whose `requirement_mode`, `evidence_presence` and admissibility constraints govern it. That lets a buyer say which audience it cares about, so a buyer can ask for "evidence that at least 40% of this inventory's audience is 25–54" instead of burying the preference in the brief. ```json { @@ -521,7 +524,7 @@ Seller behavior is normative: - A target is never a targeting predicate, impression-level proof, or legal-age verification. Hard delivery stays in `targeting_overlay.demographics`. - A seller that does not list `media_buy.audience_evidence_targets` in `experimental_features` MUST NOT apply `target_audiences`. With `requirement_mode: "required"` it MUST fail with [`UNSUPPORTED_FEATURE`](/docs/building/verification/compliance-catalog#error-code-unsupported-feature) rather than ignore the hard requirement. With `preferred` it MAY ignore the field but MUST NOT report it as applied. A 3.2 seller that validates strictly may instead return a validation error, so buyers check `experimental_features` before sending the field. - A required target a product misses is an exclusion, not an error. A seller MAY report it through `filter_diagnostics.excluded_by`. `index` targets carry no baseline in 3.3, so an index threshold is only comparable between sellers that publish the same baseline. Buyers that need to know why a product dropped out, or which targets a preferred result met, re-check the returned `audience_evidence_selections[]` against their own targets using the exact-match rule above. -- `target_audiences` is accepted on `get_products` `filters` and on `create_media_buy` packages, each as a sibling of `audience_evidence_requirements`. The [`buy_products`](/docs/media-buy/task-reference/buy_products) purchase schemas and the [`list_products`](/docs/media-buy/task-reference/list_products) `offer_filters` are closed, so they carry it in 4.0 rather than 3.3 (registry check [purchase_target_audiences_required_in_4_0](/docs/reference/migration/v4-compatibility#purchase_target_audiences_required_in_4_0)), and a purchase does not yet record the preference it was selected under. Until then, a buyer that needs an audit record keeps its own copy of the requirements and targets it sent. `audience_evidence_pins[]` identify the exact snapshots the package was built on, but a pin does not show that a target was honored. +- `target_audiences` is accepted on `get_products` `filters` and on `create_media_buy` packages, each as a sibling of `audience_evidence_requirements`. A [`buy_products`](/docs/media-buy/task-reference/buy_products) purchase records its terms in `product-purchase.json`, which is held closed with the commercial terms until 4.0, so purchases carry it in 4.0 rather than 3.3, and [`list_products`](/docs/media-buy/task-reference/list_products) `offer_filters` gains it with them (registry check [purchase_target_audiences_required_in_4_0](/docs/reference/migration/v4-compatibility#purchase_target_audiences_required_in_4_0)), and a purchase does not yet record the preference it was selected under. Until then, a buyer that needs an audit record keeps its own copy of the requirements and targets it sent. `audience_evidence_pins[]` identify the exact snapshots the package was built on, but a pin does not show that a target was honored. Known place IDs belong in `targeting_overlay`, so the returned product's availability, pricing, and forecast are scoped to the effective place diff --git a/docs/protocol/calling-an-agent.mdx b/docs/protocol/calling-an-agent.mdx index 469f94f1f1d..1780db38cf7 100644 --- a/docs/protocol/calling-an-agent.mdx +++ b/docs/protocol/calling-an-agent.mdx @@ -59,7 +59,7 @@ For the key-required operations listed above, a missing key produces `adcp_error "account": { "brand": { "domain": "acme.com" }, "operator": "pinnacle-media.com" } ``` -**Do NOT merge required fields across variants.** `additionalProperties: false` on each variant means `{account_id, brand}` fails BOTH. +**Do NOT merge required fields across variants.** Each variant rejects the other's fields, so `{account_id, brand}` fails BOTH. When a task schema requires `account`, send an explicit `AccountRef` even if the SDK auto-selected the only account available to the authenticated credential. Hidden credential-implied defaulting is not a protocol model. When a task marks `account` optional, omission has only the semantics documented by that task. @@ -157,9 +157,9 @@ Every validation failure produces an envelope shaped like: | Symptom | What it means | Fix | |---|---|---| | `keyword: 'oneOf'` with `variants[]` | Discriminated union — you sent fields from multiple variants, or none | Pick ONE variant from `variants[]`. Send only its `required` fields. | -| 2-3 `additionalProperties` errors at the same pointer | You merged `oneOf` variants | Drop to one variant. Don't keep "extra" fields "for completeness". | +| 2-3 `not` or `required` errors at the same pointer | You merged `oneOf` variants | Drop to one variant. Don't keep "extra" fields "for completeness". | | `keyword: 'required'`, `pointer: '/idempotency_key'` | Mutating tool, no UUID | Generate fresh UUID per logical operation. Reuse on retries. | -| `keyword: 'type'` or `additionalProperties` at `/budget` | Sent `{amount, currency}` | `budget` is a number. Currency is implied by `pricing_option_id`. | +| `keyword: 'type'` at `/budget` | Sent `{amount, currency}` | `budget` is a number. Currency is implied by `pricing_option_id`. | | `enum` at `/format_kind` | Sent a non-canonical format kind | Choose a registered canonical kind or use a valid `custom` declaration. | | `keyword: 'enum'` at `/destinations/*/type` | Made-up destination type | Use `'platform'` (with `platform`) or `'agent'` (with `agent_url`). | | Response carries `status: 'submitted'` and `task_id` | Async — work is queued, NOT done | On the AdCP v3 A2A profile, invoke [`get_task_status`](https://adcontextprotocol.org/schemas/v3/protocol/get-task-status-request.json). On MCP, use the advertised AdCP polling task. | diff --git a/docs/reference/3-3-beta.mdx b/docs/reference/3-3-beta.mdx index e322f318f61..30986d72979 100644 --- a/docs/reference/3-3-beta.mdx +++ b/docs/reference/3-3-beta.mdx @@ -166,7 +166,7 @@ After a beta is published, SDK maintainers ingest that signed bundle and publish ## Withdrawn after beta.1 -Three features shipped in `3.3.0-beta.1` and are not part of 3.3. They leave the protocol after beta.1. All three add terms to `commercial_terms`, which stays closed within 3.x so that a buyer is never bound by terms it cannot read ([adcp#8501](https://github.com/adcontextprotocol/adcp/issues/8501)). They are planned for 4.0, where `commercial_terms` gets a declared extension point with must-understand. +Three features shipped in `3.3.0-beta.1` and are not part of 3.3. They leave the protocol after beta.1. All three add terms to `commercial_terms`, which is held closed until 4.0 ([adcp#8501](https://github.com/adcontextprotocol/adcp/issues/8501)). They are planned for 4.0, where `commercial_terms` gets a declared extension point with must-understand. | Feature | Shipped in | Action | |---|---|---| @@ -212,7 +212,7 @@ Milestone assignment means **candidate for the 3.3 line**, not a commitment to a | JWS artifacts use the Web Bot Auth key directory ([DR-0026](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0026-jws-artifacts-use-the-wba-key-directory.md)) | Governance contexts, designated-task response signatures, and rights attestations from an origin its trust record lists verify against that origin's Web Bot Auth key directory in 3.3; amends DR-0023. | Merged: [#8299](https://github.com/adcontextprotocol/adcp/pull/8299). | | Seller revisions advance on every committed change ([DR-0031](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0031-seller-revision-any-origin.md)) | A seller-maintained revision (media-buy and account `revision`, creative `seller_revision`) advances on every committed change, whatever its origin; the `sync_creatives` assignment carve-out is removed. Other resource families are deferred to 3.4. | Merged: [#8159](https://github.com/adcontextprotocol/adcp/pull/8159); recorded in [#8389](https://github.com/adcontextprotocol/adcp/pull/8389). | | A major-only request is served the oldest supported release ([DR-0034](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0034-major-only-requests-are-served-the-oldest-release.md)) | A request that carries `adcp_major_version` and no `adcp_version` is served the oldest release the seller supports in that major, 3.0 where supported, and the response echoes it. `adcp_major_version` is removed in 4.0 ([DR-0035](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0035-adcp-major-version-removed-in-4-0.md)). | Accepted 2026-10-26; ratified in [#8410](https://github.com/adcontextprotocol/adcp/pull/8410). | -| Closed schemas stay closed within a major ([DR-0036](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0036-closed-schemas-stay-closed-within-a-major.md)) | A minor adds only to open schemas, and four recorded corrections are the only exceptions. This is why definition pins, purchase rights, and installment selection are [withdrawn](#withdrawn-after-beta-1). | Proposed; goes to ratification at the 2026-11-09 working-group session. The corrections merged in [#8531](https://github.com/adcontextprotocol/adcp/pull/8531) and [#8547](https://github.com/adcontextprotocol/adcp/pull/8547), and the CI guard in [#8502](https://github.com/adcontextprotocol/adcp/pull/8502). | +| Schemas are open by default ([DR-0036](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0036-closed-schemas-stay-closed-within-a-major.md)) | 3.3 opens the schemas that were meant to be open; a schema stays closed only for a structural reason, and `commercial_terms` is held closed until 4.0. A minor adds to open schemas and adds nothing to closed ones. Definition pins, purchase rights, and installment selection stay [withdrawn](#withdrawn-after-beta-1), because they add terms to `commercial_terms`. See [Schemas are open by default](/docs/reference/migration/3-2-to-3-3#schemas-are-open-by-default). | Decided at the 2026-11-09 working-group session. The proposal-flow reopening merged in [#8531](https://github.com/adcontextprotocol/adcp/pull/8531), and the CI guard in [#8502](https://github.com/adcontextprotocol/adcp/pull/8502). | | Verifiers bundle the Public Suffix List ([DR-0037](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0037-psl-bundled-not-pinned.md)) | Verifiers compute eTLD+1 with a Public Suffix List bundled with the verifier, never fetched at runtime, and AdCP names no reference snapshot. On the trust-record path, a verifier whose list lacks a newly added PRIVATE suffix fails closed. | Ratified 2026-11-02: [#8702](https://github.com/adcontextprotocol/adcp/pull/8702). | Four records document surfaces merged for beta.0 and are accepted (decided 2026-10-30): [DR-0027](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0027-mutation-outcome-on-error.md) (`error.mutation_outcome`), [DR-0028](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0028-sales-fixed-rate-specialism.md) (`sales-fixed-rate`), [DR-0029](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0029-delivery-projection-advisory.md) (delivery projection), and [DR-0030](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0030-media-buy-lineage-forward-only.md) (media-buy lineage). `sales-fixed-rate` is promoted from preview to stable in beta.5 ([#8445](https://github.com/adcontextprotocol/adcp/pull/8445)). diff --git a/docs/reference/experimental-status.mdx b/docs/reference/experimental-status.mdx index 80c526dcf65..7c6a86b1a04 100644 --- a/docs/reference/experimental-status.mdx +++ b/docs/reference/experimental-status.mdx @@ -152,7 +152,7 @@ Schemas marked with `x-status: experimental` are the authoritative source. The c | `media_buy.collection_lists` | The `collection_lists` and `collection_lists_exclude` fields on `targeting.json` and `targeting-input.json`, and the matching `overlay_support` / `required_overlay_support` keys with `max_references` ([#7834](https://github.com/adcontextprotocol/adcp/issues/7834)). See [Combining several collection lists](/docs/governance/collection/index#combining-several-collection-lists-experimental). | One buyer-side adopter so far, and the WG has not ratified the intersection/union semantics or the `max_references` shape. The singular `collection_list` fields are stable and unchanged. | | `signing.web_bot_auth` | The [Web Bot Auth request-signing profile](/docs/building/by-layer/L1/wba-profile): the `web-bot-auth` value in `request_signing.profiles` and `webhook_signing.profiles` on [`get_adcp_capabilities`](/docs/protocol/get_adcp_capabilities), and `signing_profile` on every webhook registration, adopted by DR-0023 | The profile follows an IETF draft that is still changing. The draft revision it pins and the `Signature-Agent` form may change before graduation. | | `media_buy.offline_delivery_metrics` | The `ooh_metrics` delivery block on `core/delivery-metrics.json` (panels, posting periods, posting records, share of voice, modeled `estimated_impressions` with `estimation_basis`; added in 3.2 and documented in [Out-of-home](/docs/creative/channels/ooh)), and the `print_metrics` delivery block (`page_delivered`, `position_delivered`, `circulation_delivered`, `circulation_basis`, `evidence`; added in 3.3 and documented in [Print creative](/docs/creative/channels/print#delivery-evidence-and-circulation)). Both carry `x-status: experimental`, both are addressable as `ooh_metrics` / `print_metrics` in the `available-metric` enum, and both reuse the channel-neutral `core/placement-evidence.json` artifact. | Delivery reporting for channels with no play or impression event — static OOH posting records and print proof-of-insertion with circulation — rests on one named adopter per channel and on contract conventions (OAAA proof of performance, tearsheets, circulation audits) that have not been field-tested across parties. `ooh_metrics` shipped in 3.2 without a registry row; this row registers it with `print_metrics` as a clarification, so a seller on 3.3 that reports either block declares the id. A seller on a 3.2 schema that already reports `ooh_metrics` is not made non-conformant retroactively. Field shapes, the `estimation_basis` / `circulation_basis` tier vocabularies, and the shared evidence artifact may change before they freeze. | -| `media_buy.audience_evidence_targets` | The `target_audiences[]` field, a sibling of `audience_evidence_requirements` on `core/product-filters.json` (`get_products` `filters`) and `media-buy/package-request.json` (`create_media_buy` packages), and its item schema `core/audience-evidence-target.json` (`audience`, `relationship`, `minimum_value`) ([RFC #8125](https://github.com/adcontextprotocol/adcp/issues/8125)). See [audience evidence requirements](/docs/media-buy/task-reference/get_products#audience-evidence-requirements). | Structured soft and hard audience preference over `audience_evidence`, with a single adopter so far and no field-testing across parties yet. The exact-match audience rule (no superset, subset, or adjusted-share matching), AND across targets, the lack of a baseline on `index` targets, the `minimum_value` units, the `maxItems` bound, and whether per-target satisfaction is reported in `audience_evidence_selections` may change. The field is a sibling rather than a member of the closed `audience_evidence_requirements` schemas, because a minor release never changes a closed schema. The closed `buy_products` purchase schemas and the closed `list_products` `offer_filters` do not carry it in 3.3; it arrives there in 4.0 (see the [4.0 compatibility check](/docs/reference/migration/v4-compatibility#purchase_target_audiences_required_in_4_0)), together with the purchase-snapshot echo. The `enums/audience-evidence-relationship.json` file carries the same values as the stable 3.2 `audience_evidence.relationship` enum, which stays inline and unchanged. Sellers that evaluate `target_audiences` declare the id; a seller that does not declare it MUST fail a `required` request with `UNSUPPORTED_FEATURE` rather than ignore it. | +| `media_buy.audience_evidence_targets` | The `target_audiences[]` field, a sibling of `audience_evidence_requirements` on `core/product-filters.json` (`get_products` `filters`) and `media-buy/package-request.json` (`create_media_buy` packages), and its item schema `core/audience-evidence-target.json` (`audience`, `relationship`, `minimum_value`) ([RFC #8125](https://github.com/adcontextprotocol/adcp/issues/8125)). See [audience evidence requirements](/docs/media-buy/task-reference/get_products#audience-evidence-requirements). | Structured soft and hard audience preference over `audience_evidence`, with a single adopter so far and no field-testing across parties yet. The exact-match audience rule (no superset, subset, or adjusted-share matching), AND across targets, the lack of a baseline on `index` targets, the `minimum_value` units, the `maxItems` bound, and whether per-target satisfaction is reported in `audience_evidence_selections` may change. The field is a sibling rather than a member of `audience_evidence_requirements` because the two constrain different things: which audience, and the quality of the evidence. The `buy_products` purchase input (`media-buy/product-purchase-input.json`) and the `list_products` `offer_filters` (`core/product-offer-filters.json`) are open in 3.3 but do not define it. It is defined there in 4.0 (see the [4.0 compatibility check](/docs/reference/migration/v4-compatibility#purchase_target_audiences_required_in_4_0)), together with the echo in the accepted purchase snapshot, `media-buy/product-purchase.json`, which is held closed with the commercial terms until 4.0. The `enums/audience-evidence-relationship.json` file carries the same values as the stable 3.2 `audience_evidence.relationship` enum, which stays inline and unchanged. Sellers that evaluate `target_audiences` declare the id; a seller that does not declare it MUST fail a `required` request with `UNSUPPORTED_FEATURE` rather than ignore it. | | `account.invoice_lines` | The optional `lines[]`, `invoice_kind` (`enums/invoice-kind.json`), and `adjusts_invoice_id` on `invoices[]` items of [`get_account_financials`](/docs/accounts/tasks/get_account_financials), and the `core/invoice-line.json` shape ([#8184](https://github.com/adcontextprotocol/adcp/issues/8184)) | Ties each invoice amount to the media buys, packages, official reporting revisions, and reporting adjustments it bills, so a buyer can reconcile what it was charged for against what was finalized. Reference only: it never creates, approves, or settles invoices. Single-adopter so far, and the ids it references come from `media_buy.reporting_delivery`. May change: itemised `lines[]` keyed to `reporting_revision_ids`, credit notes as `invoice_kind: credit_note` with a non-negative `amount` rather than a negative amount. The line shape is reusable so a later account-change-feed invoice notification can carry `lines` unchanged. | | `signals.pricing_groups` | The optional `pricing_group` field on the shared signal-listing fields (`get_signals` results and `Product.signal_targeting_options[]`), and `signal_pricing_group_rules[]` (schema: `core/signal-pricing-group-rule.json`) on `signal_targeting_rules` and the `get_signals` response (#7898) | Defines how fees of signals sharing a pricing group combine, a new commercial rule backed so far by one adopter (one adopter applies `highest` today as a platform default). Decided 2026-10-24 for 3.3 beta.1 ([#7898](https://github.com/adcontextprotocol/adcp/issues/7898)): a group with no rule is charged `each`, and `percent_of_media` is always `each` (no conversion rule). The `signal_charges[]` echo of per-signal charges on package state is a follow-up, so buyers reconcile against the published rules for now. | | `media_buy.price_adjustments` | The `price_adjustments` table on fixed-price pricing options (not embedded in accepted purchase `pricing`: the accepted `pricing_option_id` pins one immutable table, and embedding it is a 4.0 item, #8501), its fee and discount rows (applied in declared order to one running total) and validity windows, and `error-details/price-adjustments-mismatch.json` ([selection-dependent price adjustments](/docs/media-buy/advanced-topics/pricing-models#selection-dependent-price-adjustments)) | One named pilot (Dutch linear TV rate cards) and one RFC, with the field set still growing: position in break, audience, activation method, and measurement vendor have no selectable anchor yet, a dimension can fire only one row in 3.3, and per-installment resolution of a flight that crosses a validity window is open. A seller must not return a table to callers below 3.3. | diff --git a/docs/reference/known-limitations.mdx b/docs/reference/known-limitations.mdx index 30b2e224b11..e866ac40855 100644 --- a/docs/reference/known-limitations.mdx +++ b/docs/reference/known-limitations.mdx @@ -54,7 +54,7 @@ Request-specific configured offers are not a gap: canonical products carry no `i `installments` was the other absent member and shipped in 3.3 ([#8230](https://github.com/adcontextprotocol/adcp/issues/8230)). These bounds on it remain: -- **A purchase buys the product as offered; it cannot name slots.** `commercial_terms` is closed in 3.x, so a purchase cannot carry the exact installments it buys and `refine_proposals` cannot drop or swap one. A buyer sees which slots a product includes and can accept or decline the product as a fixed set. Installment selection inside `purchases[]` is planned for 4.0, where `commercial_terms` gets a declared extension point with must-understand ([adcp#8501](https://github.com/adcontextprotocol/adcp/issues/8501), [Planned for 4.0](/docs/reference/migration/v4-compatibility#installment_selection_required_in_4_0)). Installment references are seller-owned data and are not definition-pinned; a buyer detects a rescheduled slot by re-reading the product, bounded by each installment's `valid_until`. Seller-initiated reschedule offers are [#8102](https://github.com/adcontextprotocol/adcp/issues/8102). +- **A purchase buys the product as offered; it cannot name slots.** `commercial_terms` is held closed until 4.0, so a purchase cannot carry the exact installments it buys and `refine_proposals` cannot drop or swap one. A buyer sees which slots a product includes and can accept or decline the product as a fixed set. Installment selection inside `purchases[]` is planned for 4.0, where `commercial_terms` gets a declared extension point with must-understand ([adcp#8501](https://github.com/adcontextprotocol/adcp/issues/8501), [Planned for 4.0](/docs/reference/migration/v4-compatibility#installment_selection_required_in_4_0)). Installment references are seller-owned data and are not definition-pinned; a buyer detects a rescheduled slot by re-reading the product, bounded by each installment's `valid_until`. Seller-initiated reschedule offers are [#8102](https://github.com/adcontextprotocol/adcp/issues/8102). - **Absence is run-of-collection only inside a projection that asked for the field,** and only in one direction. A product that declares `collections` and omits `installments` in a projection that requested them is run-of-collection by definition. A product that declares neither says nothing about scheduled inventory; the compact lifecycle has no way to assert "this collection has no bookable installments in the flight", and buyers that need that answer re-query closer to the flight using the installments' `valid_until`. - **No per-installment pricing or forecast.** `pricing_options` and `forecast` stay product-scoped, so a product whose slots carry different rates is modelled as several products. - **Holds read back the slate, not a bought subset.** Per-installment hold readback shipped as the committed proposal's `holds[]` (experimental, `media_buy.installment_holds`, [#8086](https://github.com/adcontextprotocol/adcp/issues/8086), [Installment holds](/docs/media-buy/task-reference/refine_proposals#installment-holds-experimental)). It sits outside `commercial_terms`, so it is readback rather than contract and is not covered by `terms_digest`. Every entry's `product_id` is a product in `commercial_terms.purchases`, every installment is one that product includes within that purchase's flight, and a seller declaring the feature MUST emit `holds` on any committed proposal allocating a product that declares installments. Because a 3.3 purchase buys the product as offered, the product's installments bound the entries. No rule says `holds[]` MUST enumerate exactly the set the seller reserved, so a conformant seller can read back a hold narrower than the one it took; that wording is owned by [#8086](https://github.com/adcontextprotocol/adcp/issues/8086). Whether revising a proposal releases a hold remains seller policy. diff --git a/docs/reference/migration/3-2-to-3-3.mdx b/docs/reference/migration/3-2-to-3-3.mdx index 2fac6f690eb..909a55dff34 100644 --- a/docs/reference/migration/3-2-to-3-3.mdx +++ b/docs/reference/migration/3-2-to-3-3.mdx @@ -15,11 +15,11 @@ description: "Role-based migration checklist for adopting the AdCP 3.3 beta whil Read these first: -- [Required to claim 3.3 behavior](#required-to-claim-3-3-behavior): rules that narrow what a conformant implementation may do, including [unsupported webhook HMAC and batch bodies](#webhook-signing-mode-and-batch-bodies), [responses that conform to the served release](#responses-conform-to-the-served-release), [refinement that carries compliance forward](#refinement-carries-compliance-forward), [bounded counterparty-asserted domain lists](#counterparty-asserted-domain-lists-are-bounded), [seller revisions that advance on every committed change](#seller-revisions-advance-on-every-committed-change), [flight start for committed buys only](#flight-start-activates-committed-buys-only), [flat totals for multi-qualifier metrics](#multi-qualifier-metrics-omit-flat-totals), [enforceable domain identifiers](#property-domain-identifiers-have-an-enforceable-format), [property list references through AdCP tasks](#property-list-references-resolve-through-adcp-tasks), and [dual emission of platform IDs](#platform-ids-are-emitted-under-both-names), [`request_account` as the single account write](#request_account-is-the-single-account-write-where-supported), [the protocol envelope on every task response](#every-task-response-composes-the-protocol-envelope), [major-only requests served the oldest release](#a-major-only-request-is-served-the-oldest-supported-release), [closed schemas that stay closed](#closed-schemas-stay-closed-within-a-major), [capabilities bounded by structure](#capabilities-are-bounded-by-structure), [`replace` that transfers assignment settings](#assignment-replace-transfers-settings-to-the-replacement), and [tracker slots that apply only where a format declares them](#tracker-slot-limits-apply-only-where-a-format-declares-tracker-slots). +- [Required to claim 3.3 behavior](#required-to-claim-3-3-behavior): rules that narrow what a conformant implementation may do, including [unsupported webhook HMAC and batch bodies](#webhook-signing-mode-and-batch-bodies), [responses that conform to the served release](#responses-conform-to-the-served-release), [refinement that carries compliance forward](#refinement-carries-compliance-forward), [bounded counterparty-asserted domain lists](#counterparty-asserted-domain-lists-are-bounded), [seller revisions that advance on every committed change](#seller-revisions-advance-on-every-committed-change), [flight start for committed buys only](#flight-start-activates-committed-buys-only), [flat totals for multi-qualifier metrics](#multi-qualifier-metrics-omit-flat-totals), [enforceable domain identifiers](#property-domain-identifiers-have-an-enforceable-format), [property list references through AdCP tasks](#property-list-references-resolve-through-adcp-tasks), and [dual emission of platform IDs](#platform-ids-are-emitted-under-both-names), [`request_account` as the single account write](#request_account-is-the-single-account-write-where-supported), [the protocol envelope on every task response](#every-task-response-composes-the-protocol-envelope), [major-only requests served the oldest release](#a-major-only-request-is-served-the-oldest-supported-release), [schemas open by default](#schemas-are-open-by-default), [capabilities bounded by structure](#capabilities-are-bounded-by-structure), [`replace` that transfers assignment settings](#assignment-replace-transfers-settings-to-the-replacement), and [tracker slots that apply only where a format declares them](#tracker-slot-limits-apply-only-where-a-format-declares-tracker-slots). - [Brand JSON size cap rises to 2 MiB](#brand-json-size-cap-rises-to-2-mib), [audience match counts](#audience-match-counts-may-be-absent), and the [4 MiB response-size default](#client-response-size-default-rises-to-4-mib): three loosened guarantees, so a 3.2 peer can reject or misread what a 3.3 peer sends. - [Recommended: bound agent response size](#recommended-bound-agent-response-size): a new SHOULD that tightens what an adopting buyer accepts. - [Send only to 3.3 peers](#send-only-to-3-3-peers): new fields a 3.2 validator rejects. -- [Deprecations](#deprecations): `seller_id` on event source and audience results, `principal_kind` and `expected_principal_kind` on the principal tasks, the natural-key account reference after provisioning, the account identity-rekey machinery (`identity_updates`, `operator_identity`, `ACCOUNT_MOVED`, `ACCOUNT_IDENTITY_CONFLICT`, `stable_account_id`), and condition (b) of `request_signature_required`; removal no earlier than 4.0. +- [Deprecations](#deprecations): `seller_id` on event source and audience results, `principal_kind` and `expected_principal_kind` on the principal tasks, the natural-key account reference after provisioning, the account identity-rekey machinery (`identity_updates`, `operator_identity`, `ACCOUNT_MOVED`, `ACCOUNT_IDENTITY_CONFLICT`, `stable_account_id`), and condition (b) of `request_signature_required`, and the boolean form of `demographics`; removal no earlier than 4.0. - [SDK and code-generator maintainers](#sdk-and-code-generator-maintainers): schema-shape changes that alter generated types. Everything else is an optional declaration or a clarification. Agent identity (DR-0023) and demand-side grants (DR-0025) have their own role-by-role guide, [Migrating agent identity in AdCP 3.3](/docs/reference/migration/agent-identity-3-3). For the feature narrative, start with [What's new in AdCP 3.3](/docs/reference/whats-new-in-3-3). @@ -77,7 +77,7 @@ Everything else is an optional declaration or a clarification. Agent identity (D ## Withdrawn from 3.3, planned for 4.0 -Three features are not part of 3.3. All three add terms to `commercial_terms`, and `commercial-terms` stays closed within 3.x. A buyer must not be bound by terms it cannot read, and `terms_digest` signs exactly those terms. If the object were open, a 3.2 buyer could accept a 3.3 term it silently ignored, and a minor release never changes a closed schema ([DR-0036](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0036-closed-schemas-stay-closed-within-a-major.md)). 4.0 gives `commercial_terms` a declared extension point with must-understand, and the three features come back through it. The decision is in [adcp#8501](https://github.com/adcontextprotocol/adcp/issues/8501). +Three features are not part of 3.3. All three add terms to `commercial_terms`, and `commercial-terms` and the term objects inside it are held closed until 4.0 ([DR-0036](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0036-closed-schemas-stay-closed-within-a-major.md)). 4.0 gives `commercial_terms` a declared extension point with must-understand, and the three features come back through it. The decision is in [adcp#8501](https://github.com/adcontextprotocol/adcp/issues/8501). ### Definition pins (published in beta.0 and beta.1, removed after beta.1) @@ -370,7 +370,7 @@ Applies to sellers that declare the experimental `account.requests` capability ( ### Every task response composes the protocol envelope -([#8547](https://github.com/adcontextprotocol/adcp/pull/8547), correction (b) in [DR-0036](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0036-closed-schemas-stay-closed-within-a-major.md).) Every task response schema and async status payload composes `core/protocol-envelope.json` through its root `allOf`, as the envelope's own notes already required. Envelope fields (`status`, `task_id`, `context_id`, `context`, `message`, `timestamp`, `replayed`, `adcp_error`, `push_notification_config`, `governance_context`) are siblings of the body fields at the response root on MCP and REST. Before, 47 of the 124 response and status schemas did not compose it, and 18 closed roots and branches rejected envelope fields, so generated types could not represent a conforming response. +([#8547](https://github.com/adcontextprotocol/adcp/pull/8547), a correction under [DR-0036](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0036-closed-schemas-stay-closed-within-a-major.md).) Every task response schema and async status payload composes `core/protocol-envelope.json` through its root `allOf`, as the envelope's own notes already required. Envelope fields (`status`, `task_id`, `context_id`, `context`, `message`, `timestamp`, `replayed`, `adcp_error`, `push_notification_config`, `governance_context`) are siblings of the body fields at the response root on MCP and REST. Before, 47 of the 124 response and status schemas did not compose it, and 18 closed roots and branches rejected envelope fields, so generated types could not represent a conforming response. - **`status` is required.** The envelope required it already, and the schemas now enforce it on every response served at 3.3, including the async status payloads and governance responses that omitted it. A webhook `result` example carries the task's `status`. - **Version fields.** `core/protocol-envelope.json` composes `core/version-envelope.json`, so `adcp_version` and `adcp_major_version` are envelope fields on every response, stamped by the server framework rather than carried as task data. The `adcp_version` echo validates on the `control_media_buy`, `decline_proposals`, `buy_products`, and `accept_proposal` responses. @@ -387,15 +387,31 @@ A request that carries `adcp_major_version` and no `adcp_version` is served the **Sellers.** Resolve a major-only request to the oldest supported release in that major, and serve and echo it ([Serving an older pin](/docs/reference/versioning#serving-an-older-pin)). **In-house clients** that send only the integer lose newer fields; send `adcp_version`. -### Closed schemas stay closed within a major +### Schemas are open by default -A schema that any stable release of a major published closed (`additionalProperties: false` or `unevaluatedProperties: false`) stays as that release published it until the next major. A minor adds nothing to it, even to peers that negotiated the newer minor, and even for an experimental field ([DR-0036](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0036-closed-schemas-stay-closed-within-a-major.md), status: proposed, awaiting working-group ratification). Four recorded corrections are the only exceptions, each bringing a schema back to text the spec already required: (a) the 3.2 proposal flow is reopened, (b) the envelope is composed on every response with `status` required, (c) `task_id` identifies a task, and (d) `message` is bounded. Each ships in 3.3 and in a 3.2.x patch. +([DR-0036](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0036-closed-schemas-stay-closed-within-a-major.md), working-group decision of 2026-11-09.) 3.3 opens the schemas that were meant to be open. Closing a schema only breaks validators that hard-code it, so opening one is not a protocol break. `additionalProperties` goes from `false` to `true` at 747 of the 859 closed locations in the 3.3 source. Nothing else in those schemas changes, and every payload that was valid stays valid. The next 3.2.x patch ([#8864](https://github.com/adcontextprotocol/adcp/pull/8864)) opens the same locations that 3.2 has, all but one: it keeps the `get_reporting_status` `lookup_unavailable` branch closed, as 3.2 published it. + +A location stays closed where closure enforces something, and the commercial terms are held closed until 4.0: + +- **Unions told apart by key presence.** The `a2ui/bound-value.json` literal and path forms, and the `brand.json` redirect, house, agent and portfolio forms. Opening them would let a payload that is valid today match two forms. +- **Commercial terms, held closed until 4.0.** `commercial-terms` and the term objects inside it: `product-purchase`, `change-term`, `change-term-constraints`, `sla-window`, `bidding-policy`, and the canonical measurement terms, performance standard, reporting commitment, pricing option and budget allocation. This is a hold, not a structural reason: 4.0 gives `commercial_terms` a declared extension point with must-understand, and new terms wait for it. +- **Join keys.** Metric `qualifier` objects and forecast dimensions. Consumers join on their key sets. +- **Canonical identity and signatures.** `canonical-installment-ref` and the JWS response-payload envelope. +- **Privacy clamps.** The TMP identity and context match requests, `catalog-item-reference-not-found-error`, the per-agent `PERMISSION_DENIED` and `BILLING_NOT_PERMITTED_FOR_AGENT` details, the `get_principal` recognized, unconfigured and failed results and the `sync_principal` failed result, and the error objects of the `get_reporting_status` `lookup_unavailable` failure. +- **Credentials.** Reporting destinations, which are credential-free by contract; a credential can have any name. `proposal-budget-constraint`, the strict peer of `budget-range`, is held closed until 4.0 with the commercial terms. +- **No key material or markup.** `trust.json`, which sits on the signature-verification fetch path and whose keys are published only in the key directory, and `placement-presentation`, a declarative frame that consumers render. +- **Maps keyed by identifiers,** where closure checks the keys (`patternProperties`). + +Where closure also rejected a specific field the protocol defines elsewhere, such as `trackers` on an `unassign` operation or `expires_at` on a hold entry, the opened schema names it in a `not` clause, so that payload is still rejected. Each such schema says in its description what it rejects and why, because generated types can't express `not`. + +A minor may add to an open schema. It adds nothing to a schema that stays closed; that waits for the next major. The additive-minor check enforces both, and still fails on removals, renames, retypes, removed enum values, tightened bounds, new required names, and closing an open schema. What this means for 3.3 adopters: -- **Features that needed to add terms to `commercial_terms` are withdrawn** ([above](#withdrawn-from-3-3-planned-for-4-0)), and seller-held change terms are planned for 4.0 instead of shipping as `commercial_terms.change_terms[]`. -- **New 3.3 additions sit on open schemas or in sibling fields.** `target_audiences[]` is a sibling of the closed `audience_evidence_requirements`, `vendor_metric_provenance[]` is a sibling of the closed `vendor_metric_values[]` row, and `counting_mechanisms` reaches the closed canonical measurement terms in 4.0. -- **Send a 3.3 field on a reopened schema only to a 3.3 peer.** A strict validator on an earlier 3.2 patch still rejects it ([Send only to 3.3 peers](#send-only-to-3-3-peers)). +- **Readers ignore unknown fields** on an open schema ([versioning](/docs/reference/versioning)). A validator that hard-codes the 3.2 closures rejects 3.3 payloads, so regenerate it from the 3.3 schemas. +- **Generated types can change.** A generator that reads `additionalProperties` treats the opened objects as open: json-schema-to-typescript adds an index signature, and Pydantic models generated with `extra="forbid"` stop rejecting extra fields. Code that relied on a type or validation error for an unknown key needs its own check. +- **Send a 3.3 field only to a 3.3 peer.** A strict validator on 3.2.9 or earlier still rejects it ([Send only to 3.3 peers](#send-only-to-3-3-peers)). +- **Features that needed new terms in `commercial_terms` stay withdrawn** ([above](#withdrawn-from-3-3-planned-for-4-0)), and seller-held change terms are planned for 4.0 instead of shipping as `commercial_terms.change_terms[]`. ### Capabilities are bounded by structure @@ -792,13 +808,14 @@ Adopters of these patches have already seen these; their changesets reappear in ## Deprecations -3.3 deprecates two result fields, the principal kind field and assertion, the RFC 9421 signing profiles, one usage, and the account identity-rekey machinery; all remain functional throughout 3.x: +3.3 deprecates two result fields, the principal kind field and assertion, the RFC 9421 signing profiles, one usage, the account identity-rekey machinery, and the boolean form of `demographics`; all remain functional throughout 3.x: - **`seller_id` on `sync_event_sources` and `sync_audiences` results.** Use the new optional `platform_id` for the object's ID in the seller's ad platform, matching `sync_creatives` and `sync_catalogs`. **Sellers** reporting a platform identifier in 3.3 and later 3.x responses MUST emit both fields with identical values, including discovery responses and seller-managed event sources. **Buyers** MUST prefer `platform_id` and fall back to `seller_id` only when `platform_id` is absent. Either field may be absent in legacy responses, and both may be absent when no platform identifier is available. Continue using `event_source_id` and `audience_id` in AdCP requests. The aliases keep their object-ID semantics; they are never seller identity. `adagents.json` `contact.seller_id` and publisher identifiers of type `seller_id` are unchanged. Removal is no earlier than 4.0 and subject to the [six-month notice policy](/docs/reference/versioning#deprecation-policy). See [event source migration](/docs/media-buy/task-reference/sync_event_sources#platform-identifier-migration-adcp-3-3) and [audience migration](/docs/media-buy/task-reference/sync_audiences#platform-identifier-migration-adcp-3-3) ([#8290](https://github.com/adcontextprotocol/adcp/issues/8290)). - **`principal_kind` and `expected_principal_kind` on `sync_principal` and `get_principal`**, and the `enums/principal-kind.json` enum. A principal is the buyer agent as the seller has bound it, so the kind is always `buyer_agent` and carries no information. Sellers keep returning `principal_kind` and honoring `expected_principal_kind` throughout 3.x; buyers stop reading and sending them, and don't branch on `principal_kind`. Removal is no earlier than 4.0 and subject to the [six-month notice policy](/docs/reference/versioning#deprecation-policy). The task names are unchanged ([#8443](https://github.com/adcontextprotocol/adcp/pull/8443), [#8280](https://github.com/adcontextprotocol/adcp/issues/8280)). - **The AdCP RFC 9421 signing profiles**, for requests (`adcp/request-signing/v1`) and webhooks (`adcp/webhook-signing/v1`), with keys found through brand.json and `identity.brand_json_url`. They keep working throughout 3.x and are removed in AdCP 4.0, together with the brand.json trust fields ([DR-0023](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0023-agent-identity-is-an-origin.md)). Their replacement is the experimental Web Bot Auth profile ([Web Bot Auth identities](/docs/building/by-layer/L1/security#web-bot-auth-identities); role-by-role steps in the [agent identity migration guide](/docs/reference/migration/agent-identity-3-3)): identity is the signer's origin, keys come from that origin's key directory, and no capabilities call is needed. **Signers** that serve no capabilities endpoint can move now. **Verifiers** keep accepting RFC 9421 signatures through 3.x, under the no-downgrade rule once an origin is bound. - **The natural key as the account reference after provisioning.** Sending the natural-key `AccountRef` on account-scoped tasks once the account exists is deprecated and planned for removal in AdCP 4.0 ([#7850](https://github.com/adcontextprotocol/adcp/issues/7850)). It keeps working throughout 3.x. The natural key itself stays: buyers use it to open accounts with `sync_accounts` and as a `list_accounts` filter to look up an account's ID. **Buyers** store the returned ID and send it. See [Account identity](/docs/accounts/overview#account-identity). - **The account identity-rekey machinery** ([#8474](https://github.com/adcontextprotocol/adcp/pull/8474)). The `account.identity_updates` capability is deprecated and planned for removal in AdCP 4.0, with everything it gates. That covers `operator_identity` and `destination_billing_entity` on `sync_accounts`, the `identity_change` and `identity_change_preview` fields, and the `ACCOUNT_MOVED` and `ACCOUNT_IDENTITY_CONFLICT` error codes. `account.stable_account_id` is deprecated with it. An account's identity never changes, so no rekey or former key exists. **Sellers** that implement `operator_identity` keep it working through 3.x and SHOULD declare `stable_account_id: true` while the field exists. **Buyers** change `operator_unit` as an attribute and send `account_id` without checking `stable_account_id`. +- **The boolean form of `demographics`** in product `overlay_support` (`core/targeting-overlay-support.json`) and in `required_overlay_support` (`core/targeting-overlay-requirements.json`). `demographics: true` is the 3.2 shorthand for `{ "age": true }`, and every 3.2 release accepts the object form on both schemas. **Senders** MUST send the object form. **Receivers** MUST accept `true` and read it as `{ "age": true }`, so it satisfies an age requirement and never a `gender` requirement. It is planned for removal in AdCP 4.0 ([#8778](https://github.com/adcontextprotocol/adcp/issues/8778)). 3.3 also deprecates condition (b) of `request_signature_required` ([#8064](https://github.com/adcontextprotocol/adcp/pull/8064)), which exists only for the already-deprecated webhook `authentication` block. It is part of the `authentication` block's existing deprecation and is removed in 4.0 with the block. The experimental `configuration_task` field of `media_buy.reporting_delivery` is deprecated in favor of `configuration_tasks[]` and stays `"sync_accounts"` for clients pinned below 3.3 ([#8552](https://github.com/adcontextprotocol/adcp/pull/8552)). A deprecation window does not reset when a deprecated feature is modified. Other existing 3.2 deprecations keep their published removal windows. diff --git a/docs/reference/migration/v4-compatibility.mdx b/docs/reference/migration/v4-compatibility.mdx index 0dd91d3d139..891ee468bea 100644 --- a/docs/reference/migration/v4-compatibility.mdx +++ b/docs/reference/migration/v4-compatibility.mdx @@ -134,13 +134,13 @@ No storyboard step inspects every annotated field, so the suite reports this che **Detects:** a seller that lists `media_buy.audience_evidence_targets` in `experimental_features` does not accept `target_audiences` on `buy_products` purchases and `list_products` `offer_filters`. -In 3.3 the experimental `target_audiences[]` is a sibling of `audience_evidence_requirements` on `get_products` filters and on `create_media_buy` packages. `buy_products` purchases (`product-purchase-input.json`, `product-purchase.json`) and `list_products` `offer_filters` are closed schemas, and a minor release never changes a closed schema, so they gain the field in 4.0. +In 3.3 the experimental `target_audiences[]` is a sibling of `audience_evidence_requirements` on `get_products` filters and on `create_media_buy` packages. A purchase records its terms in `product-purchase.json`, which is held closed with the commercial terms until 4.0 ([DR-0036](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0036-closed-schemas-stay-closed-within-a-major.md)), so `buy_products` purchases gain the field in 4.0, and `list_products` `offer_filters` gains it with them. **Fix:** accept the sibling on those surfaces and record it in the accepted purchase snapshot. Until 4.0, a buyer that needs an audit record keeps its own copy of the requirements and targets it sent. A 3.x run cannot observe this check, so it reports as not observable. ## Planned for 4.0: withdrawn from 3.3 -The three checks below record 3.3 features that are withdrawn and planned for 4.0. All three add terms to `commercial_terms`. The `commercial-terms` schema is closed on purpose: a buyer must not be bound by terms it cannot read, and `terms_digest` signs exactly those terms. If the object were open, a 3.2 buyer could accept a 3.3 term it silently ignored. A minor release never changes a closed schema ([DR-0036](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0036-closed-schemas-stay-closed-within-a-major.md)), so these features wait for 4.0, where `commercial_terms` gets a declared extension point with must-understand. The decision and its reasoning are in [adcp#8501](https://github.com/adcontextprotocol/adcp/issues/8501). The [3.3 migration guide](/docs/reference/migration/3-2-to-3-3#withdrawn-from-3-3-planned-for-4-0) says what changed between `3.3.0-beta.0` and `3.3.0-beta.1`. +The three checks below record 3.3 features that are withdrawn and planned for 4.0. All three add terms to `commercial_terms`. The `commercial-terms` schema is held closed until 4.0 ([DR-0036](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0036-closed-schemas-stay-closed-within-a-major.md)), so these features wait for 4.0, where `commercial_terms` gets a declared extension point with must-understand. The decision and its reasoning are in [adcp#8501](https://github.com/adcontextprotocol/adcp/issues/8501). The [3.3 migration guide](/docs/reference/migration/3-2-to-3-3#withdrawn-from-3-3-planned-for-4-0) says what changed between `3.3.0-beta.0` and `3.3.0-beta.1`. Nothing here is graded. 3.3 has no wire form for any of it after beta.1, so a run cannot observe it. The designs are preserved at the merge commits named below, so the 4.0 work starts from them instead of from a blank page: `git show :` prints any file. @@ -206,7 +206,7 @@ Nothing here is graded. 3.3 has no wire form for any of it after beta.1, so a ru **Detects:** a seller that changes a signed purchase on its own authority carries no seller-held entry in `commercial_terms.change_terms[]` naming the bounded change. -In 3.3 a seller-initiated change to a signed buy is always a [seller offer](/docs/media-buy/product-discovery/proposal-negotiation#seller-offers) that the buyer accepts. A way for the buyer to pre-agree bounded seller changes (a budget release, a schedule shift, ordered line alternates) would add `holder` and `purchase_index` to `change-term.json` and new constraint kinds. `commercial_terms` and `change-term.json` are closed schemas, and a minor release never changes a closed schema, so the lane ships in 4.0. The expected shape is in [Planned for 4.0](/docs/media-buy/product-discovery/proposal-negotiation#planned-for-40-seller-held-change-terms). +In 3.3 a seller-initiated change to a signed buy is always a [seller offer](/docs/media-buy/product-discovery/proposal-negotiation#seller-offers) that the buyer accepts. A way for the buyer to pre-agree bounded seller changes (a budget release, a schedule shift, ordered line alternates) would add `holder` and `purchase_index` to `change-term.json` and new constraint kinds. `commercial_terms` and `change-term.json` are held closed until 4.0, so the lane ships in 4.0. The expected shape is in [Planned for 4.0](/docs/media-buy/product-discovery/proposal-negotiation#planned-for-40-seller-held-change-terms). **Fix:** until 4.0, send a seller offer for every seller-initiated change to a signed buy. A 3.x run cannot observe this check, so it reports as not observable. @@ -217,7 +217,7 @@ In 3.3 a seller-initiated change to a signed buy is always a [seller offer](/doc **Detects:** a seller that lists `media_buy.measurement_provenance` in `experimental_features` declares `counting_mechanisms` on `measurement_terms.billing_measurement` but not on the canonical commercial terms. -In 3.3 the experimental `billing_measurement.counting_mechanisms[]` is carried on `core/measurement-terms.json` only. `core/canonical-measurement-terms.json` holds terms the buyer is bound by and is a closed schema, and a minor release never changes a closed schema, so the canonical terms gain the field in 4.0. +In 3.3 the experimental `billing_measurement.counting_mechanisms[]` is carried on `core/measurement-terms.json` only. `core/canonical-measurement-terms.json` holds terms the buyer is bound by and is held closed until 4.0, so the canonical terms gain the field in 4.0. **Fix:** declare `counting_mechanisms` on the canonical terms as well. A 3.x run cannot observe this check, so it reports as not observable. @@ -230,7 +230,7 @@ A check is added once its 4.0 change is decided. These changes are still proposa - the `account_id` from `sync_accounts` as the only account reference after provisioning ([#7850](https://github.com/adcontextprotocol/adcp/issues/7850)) - nested `status` renamed to `media_buy_status` ([#4905](https://github.com/adcontextprotocol/adcp/issues/4905)) -The schemas also mark 46 deprecated fields with `x-removed-in: "4.0.0"`. The registry lists each one, either under the check that covers it or in `schema_removals_not_checked` with the reason no check covers it yet. Most uncovered fields are sent by buyers, so a seller run can't observe them. A few are seller-emitted and checkable but not graded yet: flat `valid_actions`, response-wide delivery `currency` and `aggregated_totals`, `inline_creative_management`, and the format-level build and pricing surface that `list_transformers` replaces. +The schemas also mark 48 deprecated fields with `x-removed-in: "4.0.0"`. The registry lists each one, either under the check that covers it or in `schema_removals_not_checked` with the reason no check covers it yet. Most uncovered fields are sent by buyers, so a seller run can't observe them. A few are seller-emitted and checkable but not graded yet: flat `valid_actions`, response-wide delivery `currency` and `aggregated_totals`, `inline_creative_management`, boolean `demographics` in product support, and the format-level build and pricing surface that `list_transformers` replaces. The full list of planned 4.0 work is the [4.0 milestone](https://github.com/adcontextprotocol/adcp/milestone/5). diff --git a/docs/reference/release-notes.mdx b/docs/reference/release-notes.mdx index b79d40a41f4..c5332a0db35 100644 --- a/docs/reference/release-notes.mdx +++ b/docs/reference/release-notes.mdx @@ -44,7 +44,7 @@ Each beta is immutable. The `3.3-beta` documentation selector advances to the la - **Commercial experiments (beta.1 and beta.2):** seller offers against an accepted buy, `media_buy.seller_offers` (#8102); selection-dependent `price_adjustments` on fixed-price pricing options, `media_buy.price_adjustments` (#7955); per-account execution readiness on `get_products`, `media_buy.execution_readiness` (#7934); `target_audiences[]` beside audience evidence requirements, `media_buy.audience_evidence_targets` (#8215); invoice lines on `get_account_financials`, `account.invoice_lines` (#8207); `media_buy.measurement_provenance`, a `collection-mechanism` vocabulary on `counting_mechanisms[]` and `vendor_metric_provenance[]` (#7940). - **Targeting and rosters:** experimental core gender targeting, `media_buy.gender_targeting` (#7925); an empty `publisher_properties` or `collections` list means the seller does not disclose the roster, with exclusions as the buyer's choice (#7948); optional structured package inputs for exact `get_products` availability checks (#8468). - **Creative:** experimental live creative updates, `creative.live_updates`, with staged activation and `CREATIVE_LIVE_UPDATE_UNSUPPORTED` (#8488); media-buy startup with mixed creative approval states and the optional `start_requires_all_creatives_approved` gate (#8485). -- **Envelope and negotiation:** `core/protocol-envelope.json` composed on every task response, with `status` required and one definition each for `message` and `task_id` (#8547); a request carrying only `adcp_major_version` is served the oldest supported release in that major, 3.0 where supported (DR-0034); the 3.2 proposal-flow schemas reopened as a recorded correction (#8531, DR-0036); the buyer's registration selects the webhook-signing mode (#8475); condition (b) of `request_signature_required` deprecated and JSON-RPC batch bodies rejected (#8064). +- **Envelope and negotiation:** `core/protocol-envelope.json` composed on every task response, with `status` required and one definition each for `message` and `task_id` (#8547); a request carrying only `adcp_major_version` is served the oldest supported release in that major, 3.0 where supported (DR-0034); the schemas that were meant to be open opened, starting with the 3.2 proposal flow (#8531), and the rest stay closed where closure enforces something, with `commercial_terms` held closed until 4.0 (DR-0036); the buyer's registration selects the webhook-signing mode (#8475); condition (b) of `request_signature_required` deprecated and JSON-RPC batch bodies rejected (#8064). - **Capabilities:** every array, string, and keyed map in the `get_adcp_capabilities` response is bounded by structure, and the 64 KiB byte cap is a receiver backstop, not a design target (#8505, #8526). - **Principals:** a principal is the buyer agent as the seller has bound it, so `principal_kind` and `expected_principal_kind` are deprecated (#8443); one delegation-chain rule for demand-side grants (#8473). - **Service commitments and records:** product creative-review timing, business-clock SLA windows, and the `report_media_buy_issue` and `get_media_buy_issue` contracts (#8417); package retention on canceled and completed buys (#8467); an optional display `name` on measurement catalog metrics (#8437); an optional `metric_id` on performance standards (#8436); `setup_url` accepts query strings and percent-encoding (#8548). @@ -187,7 +187,7 @@ These merged on `main` during the 3.3 cycle and were also released on the 3.2 li ### Withdrawn from 3.3, planned for 4.0 -Three features are not part of 3.3. All three add terms to `commercial_terms`, and `commercial-terms` stays closed within 3.x: a buyer must not be bound by terms it cannot read, and `terms_digest` signs exactly those terms. Opening the object would let a 3.2 buyer accept a 3.3 term it silently ignored, and a minor release never changes a closed schema ([DR-0036](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0036-closed-schemas-stay-closed-within-a-major.md)). 4.0 gives `commercial_terms` a declared extension point with must-understand and brings the features back ([adcp#8501](https://github.com/adcontextprotocol/adcp/issues/8501)). The removal merged in [#8537](https://github.com/adcontextprotocol/adcp/pull/8537) and first takes effect in `3.3.0-beta.2`. +Three features are not part of 3.3. All three add terms to `commercial_terms`, which is held closed until 4.0 ([DR-0036](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0036-closed-schemas-stay-closed-within-a-major.md)). 4.0 gives `commercial_terms` a declared extension point with must-understand and brings the features back ([adcp#8501](https://github.com/adcontextprotocol/adcp/issues/8501)). The removal merged in [#8537](https://github.com/adcontextprotocol/adcp/pull/8537) and first takes effect in `3.3.0-beta.2`. - **Definition pins (#7960), published in `3.3.0-beta.0` and `3.3.0-beta.1`, removed after beta.1.** `commercial_terms.definition_pins[]`, the `definition_changed` refinement reason with `drifted_pins[]`, `REFERENCE_DEFINITION_CHANGED`, the `definition_pin_probe` controller scenario, the `definition_pin_drift` storyboard, and the `definition-pins` test vectors are removed. The beta rule that sellers MUST pin covered third-party definitions no longer applies. This is a beta-to-beta change, not a change to any stable release. - **Purchase rights (#8101), published in `3.3.0-beta.1` as experimental `media_buy.purchase_rights` and removed after beta.1.** `purchases[].rights[]`, `brand/rights-scope.json` (so `brand/rights-terms.json` returns to its 3.2 form), and the `paid_amplification` and `content_reuse` values of `right-use` are removed. diff --git a/docs/reference/whats-new-in-3-3.mdx b/docs/reference/whats-new-in-3-3.mdx index 12b7c3ee136..115ecdd5374 100644 --- a/docs/reference/whats-new-in-3-3.mdx +++ b/docs/reference/whats-new-in-3-3.mdx @@ -103,7 +103,7 @@ These shipped before beta.3 and are summarized here with the rest. Everything ma - **Invoice lines (experimental, `account.invoice_lines`, [#8207](https://github.com/adcontextprotocol/adcp/pull/8207), beta.1).** `get_account_financials` invoices can carry `lines[]` that tie an amount to media buys, packages, and reporting revisions, plus `invoice_kind` (`credit_note` carries a non-negative `amount`) and `adjusts_invoice_id`. Lines are reference only and never settle an invoice. See [Invoice lines](/docs/accounts/tasks/get_account_financials#invoice-lines-experimental). - **Smaller additions.** Exact pre-booking availability checks through structured package inputs on product-scoped `get_products` refinement ([#8468](https://github.com/adcontextprotocol/adcp/pull/8468)); an optional display `name` on measurement catalog metrics ([#8437](https://github.com/adcontextprotocol/adcp/pull/8437)); an optional `metric_id` on performance standards ([#8436](https://github.com/adcontextprotocol/adcp/pull/8436)); one delegation-chain rule for demand-side grants ([#8473](https://github.com/adcontextprotocol/adcp/pull/8473)). -**Version negotiation and closed schemas.** A request that carries only `adcp_major_version` is served the oldest release the seller supports in that major, 3.0 where it is supported ([DR-0034](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0034-major-only-requests-are-served-the-oldest-release.md), accepted 2026-10-26). In practice that caller is a 3.0 buyer, so it is no longer answered in a shape its validator rejects. A buyer that wants newer behavior sends `adcp_version`. A schema that a stable release published closed stays closed until the next major: a minor adds only to open schemas, and the 3.2 proposal-flow schemas that were closed against DR-0019 are reopened as a recorded correction ([#8531](https://github.com/adcontextprotocol/adcp/pull/8531), [DR-0036](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0036-closed-schemas-stay-closed-within-a-major.md), proposed and awaiting ratification). +**Version negotiation and closed schemas.** A request that carries only `adcp_major_version` is served the oldest release the seller supports in that major, 3.0 where it is supported ([DR-0034](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0034-major-only-requests-are-served-the-oldest-release.md), accepted 2026-10-26). In practice that caller is a 3.0 buyer, so it is no longer answered in a shape its validator rejects. A buyer that wants newer behavior sends `adcp_version`. Schemas are open by default. 3.3 opens the schemas that were meant to be open, starting with the 3.2 proposal flow ([#8531](https://github.com/adcontextprotocol/adcp/pull/8531)), and keeps the rest closed where closure is the contract, such as a join key or a privacy boundary. `commercial_terms` and the term objects inside it are held closed until 4.0. A minor adds to open schemas and adds nothing to closed ones ([DR-0036](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0036-closed-schemas-stay-closed-within-a-major.md), decided 2026-11-09; [what opened](/docs/reference/migration/3-2-to-3-3#schemas-are-open-by-default)). ## Scheduled and human-gated buying @@ -325,7 +325,7 @@ These merged on `main` during the 3.3 cycle and were also released on the 3.2 li ## Withdrawn from 3.3, planned for 4.0 -Three features are not part of 3.3. All three add terms to `commercial_terms`, and `commercial-terms` stays closed within 3.x: a buyer must not be bound by terms it cannot read, and `terms_digest` signs exactly those terms. If the object were open, a 3.2 buyer could accept a 3.3 term it silently ignored. 4.0 gives `commercial_terms` a declared extension point with must-understand and brings them back ([adcp#8501](https://github.com/adcontextprotocol/adcp/issues/8501)). +Three features are not part of 3.3. All three add terms to `commercial_terms`, which is held closed until 4.0. 4.0 gives `commercial_terms` a declared extension point with must-understand and brings them back ([adcp#8501](https://github.com/adcontextprotocol/adcp/issues/8501)). | Feature | Where it stood | What changes | |---|---|---| @@ -346,7 +346,7 @@ Open 3.3 proposals are not part of any beta until they merge. Six working-group - **Seller revisions advance on every committed change ([DR-0031](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0031-seller-revision-any-origin.md), [#8159](https://github.com/adcontextprotocol/adcp/pull/8159)).** Merged; recorded in [#8389](https://github.com/adcontextprotocol/adcp/pull/8389). See [Tightened rules](#tightened-rules). - **Verifiers bundle the Public Suffix List ([DR-0037](https://github.com/adcontextprotocol/adcp/blob/main/governance/decisions/DR-0037-psl-bundled-not-pinned.md), [#8702](https://github.com/adcontextprotocol/adcp/pull/8702)).** Ratified 2026-11-02 and merged for beta.5. Verifiers compute eTLD+1 with a bundled list, never fetched at runtime. -Records DR-0027 to DR-0030 (mutation outcome, `sales-fixed-rate`, delivery projection, and lineage) describe surfaces merged for beta.0 and are accepted. DR-0028's `sales-fixed-rate` is stable from beta.5. DR-0034 (major-only requests) is accepted, and DR-0036 (closed schemas stay closed) is proposed and goes to ratification at the 2026-11-09 working-group session. The open proposals are listed in the [3.3 beta program](/docs/reference/3-3-beta#in-review-for-3-3). +Records DR-0027 to DR-0030 (mutation outcome, `sales-fixed-rate`, delivery projection, and lineage) describe surfaces merged for beta.0 and are accepted. DR-0028's `sales-fixed-rate` is stable from beta.5. DR-0034 (major-only requests) is accepted, and DR-0036 (schemas open by default) was decided at the 2026-11-09 working-group session. The open proposals are listed in the [3.3 beta program](/docs/reference/3-3-beta#in-review-for-3-3). ## Start here diff --git a/package.json b/package.json index 8def36b1f03..5ddf48949ed 100644 --- a/package.json +++ b/package.json @@ -33,7 +33,7 @@ "verify:schema-discovery": "node scripts/verify-schema-discovery.mjs", "typecheck": "tsc --project server/tsconfig.json --noEmit && npm run typecheck:fixed-trace-rollout-tests", "typecheck:fixed-trace-rollout-tests": "node scripts/typecheck-fixed-trace-rollout-tests.mjs", - "test:schemas": "node tests/schema-validation.test.cjs && node --test tests/seller-offers-contract.test.cjs tests/service-commitments.test.cjs tests/sync-platform-id.test.cjs tests/assignment-landing-page.test.cjs tests/assignment-trackers.test.cjs tests/assignment-replace.test.cjs tests/outcome-target.test.cjs tests/trusted-match-offer-creative-data.test.cjs tests/accessibility-violation-details.test.cjs tests/portfolio-routing-scope.test.cjs tests/catalog-item-availability-updates.test.cjs tests/catalog-ingestion-capabilities.test.cjs tests/sdk-implementation-metadata.test.cjs tests/seller-optimized-package-controls.test.cjs tests/compact-product-lifecycle-storyboards.test.cjs tests/timezone-resolution-storyboards.test.cjs tests/terminal-package-retention-storyboard.test.cjs tests/total-budget-redistribution-currency.test.cjs tests/dooh-allocation.test.cjs tests/x-added-in-3-3-sweep.test.cjs tests/url-pattern-loosening.test.cjs tests/performance-standard-metric-id.test.cjs tests/identity-absence-coherence.test.cjs tests/match-keys.test.cjs tests/execution-requirements.test.cjs tests/execution-readiness.test.cjs tests/schema-deprecation-metadata.test.cjs tests/products-only-brief-compatibility.test.cjs tests/price-adjustments-vectors.test.cjs tests/async-identity-convergence.test.cjs tests/creative-rotation.test.cjs tests/creative-start-policy.test.cjs tests/canonical-forecast-point-parity.test.cjs tests/creative-revisions.test.cjs tests/creative-live-updates.test.cjs tests/creative-delivery-contracts.test.cjs tests/tracker-execution-contracts.test.cjs tests/tracker-execution-package-integration.test.cjs tests/metric-identity-coherence.test.cjs tests/print-metrics.test.cjs tests/installment-lifecycle-reporting.test.cjs tests/rights-channel-restrictions.test.cjs tests/daypart-time-of-day.test.cjs tests/audience-size-range.test.cjs tests/media-buy-lineage.test.cjs tests/delivery-projection.test.cjs tests/viewable-rate-optimization-goal.test.cjs tests/sort-contract-delivery-reporting.test.cjs tests/time-based-views-contract.test.cjs tests/metric-qualifier-parity.test.cjs tests/collection-mechanism.test.cjs tests/requested-metrics-contract.test.cjs tests/auto-breakdown-negotiation-contract.test.cjs tests/format-delivery-reporting-contract.test.cjs tests/inventory-delivery-reporting-contract.test.cjs tests/property-delivery-conformance.test.cjs tests/lint-schema-enum-drift.test.cjs tests/lint-schema-required-declared.test.cjs tests/format-asset-type-parity.test.cjs tests/canonical-manifest-constructibility.test.cjs tests/synthetic-depiction.test.cjs tests/creative-rendering-authority.test.cjs tests/buyer-reason.test.cjs tests/mutation-outcome.test.cjs tests/error-recovery-vectors.test.cjs tests/reporting-status-contract.test.cjs tests/reporting-reconciliation-fixture.test.cjs tests/reporting-core-fixture.test.cjs tests/reporting-native-version-ref-bounds.test.cjs tests/trust-json-v1.test.cjs tests/refine-proposals-expected-confirmation-at.test.cjs tests/structured-package-refine.test.cjs tests/hold-policy.test.cjs tests/hold-policy-vectors.test.cjs tests/canonical-installments.test.cjs tests/withdrawn-to-4-0.test.cjs tests/collection-catalog.test.cjs tests/collection-copies-vectors.test.cjs tests/account-change-record.test.cjs tests/notification-config-payload-view.test.cjs tests/account-requests.test.cjs tests/reporting-subscriptions.test.cjs tests/reporting-subscription-probe.test.cjs tests/reporting-subscription-coverage-vectors.test.cjs tests/reporting-subscription-coverage-properties.test.cjs tests/product-roster-coverage-vectors.test.cjs && npm run test:premium-display-formats && npm run test:geo-region-targeting", + "test:schemas": "node tests/schema-validation.test.cjs && node --test tests/account-ref.test.cjs tests/canonical-account-ref.test.cjs tests/image-bleed.test.cjs tests/sync-plans-reserved-names.test.cjs tests/seller-offers-contract.test.cjs tests/service-commitments.test.cjs tests/sync-platform-id.test.cjs tests/assignment-landing-page.test.cjs tests/assignment-trackers.test.cjs tests/assignment-replace.test.cjs tests/outcome-target.test.cjs tests/trusted-match-offer-creative-data.test.cjs tests/accessibility-violation-details.test.cjs tests/portfolio-routing-scope.test.cjs tests/catalog-item-availability-updates.test.cjs tests/catalog-ingestion-capabilities.test.cjs tests/sdk-implementation-metadata.test.cjs tests/seller-optimized-package-controls.test.cjs tests/compact-product-lifecycle-storyboards.test.cjs tests/timezone-resolution-storyboards.test.cjs tests/terminal-package-retention-storyboard.test.cjs tests/total-budget-redistribution-currency.test.cjs tests/dooh-allocation.test.cjs tests/x-added-in-3-3-sweep.test.cjs tests/url-pattern-loosening.test.cjs tests/performance-standard-metric-id.test.cjs tests/identity-absence-coherence.test.cjs tests/match-keys.test.cjs tests/execution-requirements.test.cjs tests/execution-readiness.test.cjs tests/schema-deprecation-metadata.test.cjs tests/products-only-brief-compatibility.test.cjs tests/price-adjustments-vectors.test.cjs tests/async-identity-convergence.test.cjs tests/creative-rotation.test.cjs tests/creative-start-policy.test.cjs tests/canonical-forecast-point-parity.test.cjs tests/creative-revisions.test.cjs tests/creative-live-updates.test.cjs tests/creative-delivery-contracts.test.cjs tests/tracker-execution-contracts.test.cjs tests/tracker-execution-package-integration.test.cjs tests/metric-identity-coherence.test.cjs tests/print-metrics.test.cjs tests/installment-lifecycle-reporting.test.cjs tests/rights-channel-restrictions.test.cjs tests/daypart-time-of-day.test.cjs tests/audience-size-range.test.cjs tests/media-buy-lineage.test.cjs tests/delivery-projection.test.cjs tests/viewable-rate-optimization-goal.test.cjs tests/sort-contract-delivery-reporting.test.cjs tests/time-based-views-contract.test.cjs tests/metric-qualifier-parity.test.cjs tests/collection-mechanism.test.cjs tests/requested-metrics-contract.test.cjs tests/auto-breakdown-negotiation-contract.test.cjs tests/format-delivery-reporting-contract.test.cjs tests/inventory-delivery-reporting-contract.test.cjs tests/property-delivery-conformance.test.cjs tests/lint-schema-enum-drift.test.cjs tests/lint-schema-required-declared.test.cjs tests/format-asset-type-parity.test.cjs tests/canonical-manifest-constructibility.test.cjs tests/synthetic-depiction.test.cjs tests/creative-rendering-authority.test.cjs tests/buyer-reason.test.cjs tests/mutation-outcome.test.cjs tests/error-recovery-vectors.test.cjs tests/reporting-status-contract.test.cjs tests/reporting-reconciliation-fixture.test.cjs tests/reporting-core-fixture.test.cjs tests/reporting-native-version-ref-bounds.test.cjs tests/trust-json-v1.test.cjs tests/refine-proposals-expected-confirmation-at.test.cjs tests/structured-package-refine.test.cjs tests/hold-policy.test.cjs tests/hold-policy-vectors.test.cjs tests/canonical-installments.test.cjs tests/withdrawn-to-4-0.test.cjs tests/collection-catalog.test.cjs tests/collection-copies-vectors.test.cjs tests/account-change-record.test.cjs tests/notification-config-payload-view.test.cjs tests/account-requests.test.cjs tests/reporting-subscriptions.test.cjs tests/reporting-subscription-probe.test.cjs tests/reporting-subscription-coverage-vectors.test.cjs tests/reporting-subscription-coverage-properties.test.cjs tests/product-roster-coverage-vectors.test.cjs && npm run test:premium-display-formats && npm run test:geo-region-targeting", "test:performance-feedback": "node --test --test-force-exit --test-timeout=30000 tests/performance-feedback-contract.test.cjs", "test:dist-schema-version-ids": "node --test --test-force-exit --test-timeout=30000 tests/dist-schema-version-ids.test.cjs", "test:examples": "node tests/example-validation-simple.test.cjs && npm run test:tmp-context-merge", diff --git a/scripts/lint-additive-minor-baseline.json b/scripts/lint-additive-minor-baseline.json index 64c568af27a..8ce64033d19 100644 --- a/scripts/lint-additive-minor-baseline.json +++ b/scripts/lint-additive-minor-baseline.json @@ -1,272 +1,34 @@ { - "$comment": "Non-additive schema changes recorded by scripts/lint-additive-minor.cjs, relative to the release named in base. This list only shrinks: CI rejects an entry that the target branch does not have, unless its change already shipped in a stable release. Remove an entry when its change is reverted or released; record a WG decision in reason. An entry whose detail ends in \"(closed in )\" records an addition to a schema that an earlier release of the major published closed (DR-0036). It shipped before the base and stays until the next major.", - "base": "3.2.8", + "$comment": "Non-additive schema changes recorded by scripts/lint-additive-minor.cjs, relative to the release named in base. This list only shrinks: CI rejects an entry that the target branch does not have. Remove an entry when its change is reverted or released, and record the decision in reason. A property-added-to-closed entry records an addition to a schema that stays closed in 3.x; all four current entries are in commercial-terms schemas, which are held closed until 4.0 (DR-0036).", + "base": "3.2.9", "entries": [ - { - "file": "compliance/comply-test-controller-response.json", - "pointer": "/oneOf/3/properties/forced", - "kind": "property-added-to-closed", - "detail": "property proposal_id added", - "reason": "pending WG decision" - }, - { - "file": "core/agent-notification-config.json", - "pointer": "", - "kind": "property-added-to-closed", - "detail": "property signing_profile added", - "reason": "pending WG decision" - }, - { - "file": "core/canonical-media-buy-action-fields.json", - "pointer": "", - "kind": "property-added-to-closed", - "detail": "property review_sla added", - "reason": "pending WG decision" - }, { "file": "core/canonical-performance-standard.json", "pointer": "", "kind": "property-added-to-closed", "detail": "property metric_id added", - "reason": "pending WG decision" - }, - { - "file": "core/daypart-target.json", - "pointer": "", - "kind": "property-added-to-closed", - "detail": "property end_time added", - "reason": "pending WG decision" - }, - { - "file": "core/daypart-target.json", - "pointer": "", - "kind": "property-added-to-closed", - "detail": "property start_time added", - "reason": "pending WG decision" - }, - { - "file": "core/media-buy-available-action.json", - "pointer": "", - "kind": "property-added-to-closed", - "detail": "property review_sla added", - "reason": "pending WG decision" - }, - { - "file": "core/notification-config.json", - "pointer": "", - "kind": "property-added-to-closed", - "detail": "property signing_profile added", - "reason": "pending WG decision" - }, - { - "file": "core/postal-area-support.json", - "pointer": "", - "kind": "property-added-to-closed", - "detail": "property AT added (closed in 3.0.28)", - "reason": "Released in 3.1.0, before DR-0036. Every 3.0.x release closed the capabilities geo_postal_areas object with 11 boolean keys. 3.1.0 replaced it with core/postal-area-support.json, which adds the country keys, so a strict 3.0.x validator rejects them. The key stays until 4.0, because removing it would break 3.1 and later peers." - }, - { - "file": "core/postal-area-support.json", - "pointer": "", - "kind": "property-added-to-closed", - "detail": "property AU added (closed in 3.0.28)", - "reason": "Released in 3.1.0, before DR-0036. Every 3.0.x release closed the capabilities geo_postal_areas object with 11 boolean keys. 3.1.0 replaced it with core/postal-area-support.json, which adds the country keys, so a strict 3.0.x validator rejects them. The key stays until 4.0, because removing it would break 3.1 and later peers." - }, - { - "file": "core/postal-area-support.json", - "pointer": "", - "kind": "property-added-to-closed", - "detail": "property BR added (closed in 3.0.28)", - "reason": "Released in 3.1.0, before DR-0036. Every 3.0.x release closed the capabilities geo_postal_areas object with 11 boolean keys. 3.1.0 replaced it with core/postal-area-support.json, which adds the country keys, so a strict 3.0.x validator rejects them. The key stays until 4.0, because removing it would break 3.1 and later peers." - }, - { - "file": "core/postal-area-support.json", - "pointer": "", - "kind": "property-added-to-closed", - "detail": "property CA added (closed in 3.0.28)", - "reason": "Released in 3.1.0, before DR-0036. Every 3.0.x release closed the capabilities geo_postal_areas object with 11 boolean keys. 3.1.0 replaced it with core/postal-area-support.json, which adds the country keys, so a strict 3.0.x validator rejects them. The key stays until 4.0, because removing it would break 3.1 and later peers." - }, - { - "file": "core/postal-area-support.json", - "pointer": "", - "kind": "property-added-to-closed", - "detail": "property CH added (closed in 3.0.28)", - "reason": "Released in 3.1.0, before DR-0036. Every 3.0.x release closed the capabilities geo_postal_areas object with 11 boolean keys. 3.1.0 replaced it with core/postal-area-support.json, which adds the country keys, so a strict 3.0.x validator rejects them. The key stays until 4.0, because removing it would break 3.1 and later peers." - }, - { - "file": "core/postal-area-support.json", - "pointer": "", - "kind": "property-added-to-closed", - "detail": "property DE added (closed in 3.0.28)", - "reason": "Released in 3.1.0, before DR-0036. Every 3.0.x release closed the capabilities geo_postal_areas object with 11 boolean keys. 3.1.0 replaced it with core/postal-area-support.json, which adds the country keys, so a strict 3.0.x validator rejects them. The key stays until 4.0, because removing it would break 3.1 and later peers." - }, - { - "file": "core/postal-area-support.json", - "pointer": "", - "kind": "property-added-to-closed", - "detail": "property FR added (closed in 3.0.28)", - "reason": "Released in 3.1.0, before DR-0036. Every 3.0.x release closed the capabilities geo_postal_areas object with 11 boolean keys. 3.1.0 replaced it with core/postal-area-support.json, which adds the country keys, so a strict 3.0.x validator rejects them. The key stays until 4.0, because removing it would break 3.1 and later peers." - }, - { - "file": "core/postal-area-support.json", - "pointer": "", - "kind": "property-added-to-closed", - "detail": "property GB added (closed in 3.0.28)", - "reason": "Released in 3.1.0, before DR-0036. Every 3.0.x release closed the capabilities geo_postal_areas object with 11 boolean keys. 3.1.0 replaced it with core/postal-area-support.json, which adds the country keys, so a strict 3.0.x validator rejects them. The key stays until 4.0, because removing it would break 3.1 and later peers." - }, - { - "file": "core/postal-area-support.json", - "pointer": "", - "kind": "property-added-to-closed", - "detail": "property IN added (closed in 3.0.28)", - "reason": "Released in 3.1.0, before DR-0036. Every 3.0.x release closed the capabilities geo_postal_areas object with 11 boolean keys. 3.1.0 replaced it with core/postal-area-support.json, which adds the country keys, so a strict 3.0.x validator rejects them. The key stays until 4.0, because removing it would break 3.1 and later peers." - }, - { - "file": "core/postal-area-support.json", - "pointer": "", - "kind": "property-added-to-closed", - "detail": "property US added (closed in 3.0.28)", - "reason": "Released in 3.1.0, before DR-0036. Every 3.0.x release closed the capabilities geo_postal_areas object with 11 boolean keys. 3.1.0 replaced it with core/postal-area-support.json, which adds the country keys, so a strict 3.0.x validator rejects them. The key stays until 4.0, because removing it would break 3.1 and later peers." - }, - { - "file": "core/postal-area-support.json", - "pointer": "", - "kind": "property-added-to-closed", - "detail": "property ZA added (closed in 3.0.28)", - "reason": "Released in 3.1.0, before DR-0036. Every 3.0.x release closed the capabilities geo_postal_areas object with 11 boolean keys. 3.1.0 replaced it with core/postal-area-support.json, which adds the country keys, so a strict 3.0.x validator rejects them. The key stays until 4.0, because removing it would break 3.1 and later peers." + "reason": "Kept closed: part of the signed commercial terms (DR-0036). metric_id selects which vendor number decides a signed performance standard, so a 3.2 buyer would read the same standard differently. #8501 entry 6 withdraws it from 3.3 and removes this entry." }, { "file": "core/sla-window.json", "pointer": "", "kind": "property-added-to-closed", "detail": "property business_calendar_id added", - "reason": "pending WG decision" + "reason": "Kept closed: part of the signed commercial terms through change_terms[].processing_sla (DR-0036). #8762 (#8501 entry 12) moves business_calendar_id to core/creative-review-sla.json and removes this entry." }, { "file": "core/sla-window.json", "pointer": "", "kind": "property-added-to-closed", "detail": "property clock added", - "reason": "pending WG decision" - }, - { - "file": "core/spot-reporting-capability.json", - "pointer": "", - "kind": "property-added-to-closed", - "detail": "property available_statuses added", - "reason": "pending WG decision" - }, - { - "file": "core/spot-reporting-capability.json", - "pointer": "", - "kind": "property-added-to-closed", - "detail": "property supports_break_position added", - "reason": "pending WG decision" - }, - { - "file": "core/targeting-overlay-requirements.json", - "pointer": "", - "kind": "property-added-to-closed", - "detail": "property collection_lists added", - "reason": "pending WG decision" - }, - { - "file": "core/targeting-overlay-requirements.json", - "pointer": "", - "kind": "property-added-to-closed", - "detail": "property collection_lists_exclude added", - "reason": "pending WG decision" - }, - { - "file": "core/targeting-overlay-requirements.json", - "pointer": "/definitions/daypartRequirement/anyOf/1", - "kind": "property-added-to-closed", - "detail": "property time_granularity added", - "reason": "pending WG decision" - }, - { - "file": "core/targeting-overlay-requirements.json", - "pointer": "/properties/demographics/anyOf/1", - "kind": "property-added-to-closed", - "detail": "property gender added", - "reason": "pending WG decision" - }, - { - "file": "core/targeting-overlay-support.json", - "pointer": "/definitions/daypartSupport/anyOf/1", - "kind": "property-added-to-closed", - "detail": "property time_granularity added", - "reason": "pending WG decision" + "reason": "Kept closed: part of the signed commercial terms through change_terms[].processing_sla (DR-0036). A business clock changes what a signed maximum means. #8762 (#8501 entry 11) moves clock to core/creative-review-sla.json and removes this entry." }, { "file": "core/x-entity-types.json", "pointer": "", "kind": "enum-value-removed", "detail": "value \"evaluator\" removed", - "reason": "pending WG decision" - }, - { - "file": "creative/sync-creatives-request.json", - "pointer": "/properties/assignment_operations/items/oneOf/0", - "kind": "property-added-to-closed", - "detail": "property landing_page_url added", - "reason": "pending WG decision" - }, - { - "file": "creative/sync-creatives-request.json", - "pointer": "/properties/assignment_operations/items/oneOf/0", - "kind": "property-added-to-closed", - "detail": "property trackers added", - "reason": "pending WG decision" - }, - { - "file": "creative/sync-creatives-request.json", - "pointer": "/properties/assignments/items", - "kind": "property-added-to-closed", - "detail": "property landing_page_url added", - "reason": "pending WG decision" - }, - { - "file": "creative/sync-creatives-request.json", - "pointer": "/properties/assignments/items", - "kind": "property-added-to-closed", - "detail": "property trackers added", - "reason": "pending WG decision" - }, - { - "file": "media-buy/get-products-request.json", - "pointer": "/properties/refine/items/oneOf/1", - "kind": "property-added-to-closed", - "detail": "property package added", - "reason": "pending WG decision" - }, - { - "file": "media-buy/get-products-response.json", - "pointer": "/properties/refinement_applied/items/oneOf/1", - "kind": "property-added-to-closed", - "detail": "property resolved_end_time added", - "reason": "pending WG decision" - }, - { - "file": "media-buy/get-products-response.json", - "pointer": "/properties/refinement_applied/items/oneOf/1", - "kind": "property-added-to-closed", - "detail": "property resolved_start_time added", - "reason": "pending WG decision" - }, - { - "file": "media-buy/get-products-response.json", - "pointer": "/properties/refinement_applied/items/oneOf/1", - "kind": "property-added-to-closed", - "detail": "property result_product_id added", - "reason": "pending WG decision" - }, - { - "file": "protocol/get-adcp-capabilities-response.json", - "pointer": "/properties/identity", - "kind": "property-added-to-closed", - "detail": "property brand_json_url added (closed in 3.0.4)", - "reason": "Released in 3.1.0, before DR-0036. identity was closed in 3.0.0 to 3.0.4 and opened in 3.0.5, and 3.1.0 added brand_json_url, so a strict 3.0.0 to 3.0.4 validator rejects it. The field stays until 4.0, because removing it would break 3.1 and later peers." + "reason": "A published enum value that 3.3 removed. #8501 entry 26 restores it as a deprecated value and removes this entry." } ] } diff --git a/scripts/lint-additive-minor-corrections.json b/scripts/lint-additive-minor-corrections.json index 0caef1f6d77..8bbb5df5cda 100644 --- a/scripts/lint-additive-minor-corrections.json +++ b/scripts/lint-additive-minor-corrections.json @@ -1,271 +1,7 @@ { - "$comment": "Corrections that DR-0036 records. A minor or patch release may change a closed schema only to make it accept what the published spec text already required before that release. Each entry names a schema location by document and JSON pointer, the property the correction lets in (* reopens the whole schema), the stable release it lands in, the source text that required it (a repository path and a quote from it), and the reason. The additive-minor check accepts exactly these additions. Each entry must also appear in the correction tables of DR-0036.", + "$comment": "Corrections under DR-0036. A correction makes a schema match what the published text of the major already says. Each entry names a schema location by document and JSON pointer, the change it allows, the stable release it lands in, the source text it rests on (a repository path and a quote from it), and the reason. The additive-minor check accepts exactly these changes. A PR that adds an entry is reviewed against DR-0036, which states the rule and does not list entries.", "decision": "DR-0036", "corrections": [ - { - "file": "media-buy/list-products-request.json", - "pointer": "", - "property": "*", - "release": "3.3.0", - "source": { - "path": "governance/decisions/DR-0019-closed-row-schemas-deliberate-class.md", - "quote": "Schemas that do not fit either class must be opened." - }, - "reason": "Correction (a) of DR-0036: closed in 3.2 against DR-0019. Task root. A task root is not a row, so neither DR-0019 class applies." - }, - { - "file": "media-buy/request-proposals-request.json", - "pointer": "", - "property": "*", - "release": "3.3.0", - "source": { - "path": "governance/decisions/DR-0019-closed-row-schemas-deliberate-class.md", - "quote": "Schemas that do not fit either class must be opened." - }, - "reason": "Correction (a) of DR-0036: closed in 3.2 against DR-0019. Task root. A task root is not a row, so neither DR-0019 class applies." - }, - { - "file": "media-buy/refine-proposals-request.json", - "pointer": "", - "property": "*", - "release": "3.3.0", - "source": { - "path": "governance/decisions/DR-0019-closed-row-schemas-deliberate-class.md", - "quote": "Schemas that do not fit either class must be opened." - }, - "reason": "Correction (a) of DR-0036: closed in 3.2 against DR-0019. Task root. A task root is not a row, so neither DR-0019 class applies." - }, - { - "file": "media-buy/buy-products-request.json", - "pointer": "", - "property": "*", - "release": "3.3.0", - "source": { - "path": "governance/decisions/DR-0019-closed-row-schemas-deliberate-class.md", - "quote": "Schemas that do not fit either class must be opened." - }, - "reason": "Correction (a) of DR-0036: closed in 3.2 against DR-0019. Task root. A task root is not a row, so neither DR-0019 class applies." - }, - { - "file": "media-buy/accept-proposal-request.json", - "pointer": "", - "property": "*", - "release": "3.3.0", - "source": { - "path": "governance/decisions/DR-0019-closed-row-schemas-deliberate-class.md", - "quote": "Schemas that do not fit either class must be opened." - }, - "reason": "Correction (a) of DR-0036: closed in 3.2 against DR-0019. Task root. A task root is not a row, so neither DR-0019 class applies." - }, - { - "file": "media-buy/decline-proposals-request.json", - "pointer": "", - "property": "*", - "release": "3.3.0", - "source": { - "path": "governance/decisions/DR-0019-closed-row-schemas-deliberate-class.md", - "quote": "Schemas that do not fit either class must be opened." - }, - "reason": "Correction (a) of DR-0036: closed in 3.2 against DR-0019. Task root. A task root is not a row, so neither DR-0019 class applies." - }, - { - "file": "media-buy/control-media-buy-request.json", - "pointer": "", - "property": "*", - "release": "3.3.0", - "source": { - "path": "governance/decisions/DR-0019-closed-row-schemas-deliberate-class.md", - "quote": "Schemas that do not fit either class must be opened." - }, - "reason": "Correction (a) of DR-0036: closed in 3.2 against DR-0019. Task root. A task root is not a row, so neither DR-0019 class applies." - }, - { - "file": "media-buy/list-products-response.json", - "pointer": "", - "property": "*", - "release": "3.3.0", - "source": { - "path": "governance/decisions/DR-0019-closed-row-schemas-deliberate-class.md", - "quote": "Response roots, capability blocks, and container objects stay open" - }, - "reason": "Correction (a) of DR-0036: closed in 3.2 against DR-0019. Response root. DR-0019 keeps response roots open. It rejected the adcp_version echo (#8518)." - }, - { - "file": "media-buy/request-proposals-response.json", - "pointer": "", - "property": "*", - "release": "3.3.0", - "source": { - "path": "governance/decisions/DR-0019-closed-row-schemas-deliberate-class.md", - "quote": "Response roots, capability blocks, and container objects stay open" - }, - "reason": "Correction (a) of DR-0036: closed in 3.2 against DR-0019. Response root. DR-0019 keeps response roots open." - }, - { - "file": "media-buy/refine-proposals-response.json", - "pointer": "", - "property": "*", - "release": "3.3.0", - "source": { - "path": "governance/decisions/DR-0019-closed-row-schemas-deliberate-class.md", - "quote": "Response roots, capability blocks, and container objects stay open" - }, - "reason": "Correction (a) of DR-0036: closed in 3.2 against DR-0019. Response root. DR-0019 keeps response roots open." - }, - { - "file": "media-buy/refine-proposals-response.json", - "pointer": "/properties/results/items", - "property": "*", - "release": "3.3.0", - "source": { - "path": "governance/decisions/DR-0019-closed-row-schemas-deliberate-class.md", - "quote": "A Class B schema without an escape hatch is a defect." - }, - "reason": "Correction (a) of DR-0036: closed in 3.2 against DR-0019. Result row, one outcome per source proposal. It is not a join-key object, and it has no ext." - }, - { - "file": "media-buy/decline-proposals-response.json", - "pointer": "", - "property": "*", - "release": "3.3.0", - "source": { - "path": "governance/decisions/DR-0019-closed-row-schemas-deliberate-class.md", - "quote": "Response roots, capability blocks, and container objects stay open" - }, - "reason": "Correction (a) of DR-0036: closed in 3.2 against DR-0019. Response root. DR-0019 keeps response roots open. It rejected the adcp_version echo (#8518)." - }, - { - "file": "media-buy/media-buy-commitment-response.json", - "pointer": "/oneOf/0", - "property": "*", - "release": "3.3.0", - "source": { - "path": "governance/decisions/DR-0019-closed-row-schemas-deliberate-class.md", - "quote": "Response roots, capability blocks, and container objects stay open" - }, - "reason": "Correction (a) of DR-0036: closed in 3.2 against DR-0019. Response root branch for buy_products and accept_proposal. status tells the branches apart. A discriminated oneOf arm, but a whole task response, so the root rule wins." - }, - { - "file": "media-buy/media-buy-commitment-response.json", - "pointer": "/oneOf/1", - "property": "*", - "release": "3.3.0", - "source": { - "path": "governance/decisions/DR-0019-closed-row-schemas-deliberate-class.md", - "quote": "Response roots, capability blocks, and container objects stay open" - }, - "reason": "Correction (a) of DR-0036: closed in 3.2 against DR-0019. Response root branch for buy_products and accept_proposal. status tells the branches apart. A discriminated oneOf arm, but a whole task response, so the root rule wins." - }, - { - "file": "media-buy/media-buy-commitment-response.json", - "pointer": "/oneOf/2", - "property": "*", - "release": "3.3.0", - "source": { - "path": "governance/decisions/DR-0019-closed-row-schemas-deliberate-class.md", - "quote": "Response roots, capability blocks, and container objects stay open" - }, - "reason": "Correction (a) of DR-0036: closed in 3.2 against DR-0019. Response root branch for buy_products and accept_proposal. status tells the branches apart. A discriminated oneOf arm, but a whole task response, so the root rule wins." - }, - { - "file": "media-buy/control-media-buy-response.json", - "pointer": "/oneOf/0", - "property": "*", - "release": "3.3.0", - "source": { - "path": "governance/decisions/DR-0019-closed-row-schemas-deliberate-class.md", - "quote": "Response roots, capability blocks, and container objects stay open" - }, - "reason": "Correction (a) of DR-0036: closed in 3.2 against DR-0019. Response root branch for control_media_buy. status tells the branches apart. A discriminated oneOf arm, but a whole task response, so the root rule wins. It rejected the adcp_version echo (#8518)." - }, - { - "file": "media-buy/control-media-buy-response.json", - "pointer": "/oneOf/1", - "property": "*", - "release": "3.3.0", - "source": { - "path": "governance/decisions/DR-0019-closed-row-schemas-deliberate-class.md", - "quote": "Response roots, capability blocks, and container objects stay open" - }, - "reason": "Correction (a) of DR-0036: closed in 3.2 against DR-0019. Response root branch for control_media_buy. status tells the branches apart. A discriminated oneOf arm, but a whole task response, so the root rule wins. It rejected the adcp_version echo (#8518)." - }, - { - "file": "media-buy/control-media-buy-response.json", - "pointer": "/oneOf/2", - "property": "*", - "release": "3.3.0", - "source": { - "path": "governance/decisions/DR-0019-closed-row-schemas-deliberate-class.md", - "quote": "Response roots, capability blocks, and container objects stay open" - }, - "reason": "Correction (a) of DR-0036: closed in 3.2 against DR-0019. Response root branch for control_media_buy. status tells the branches apart. A discriminated oneOf arm, but a whole task response, so the root rule wins. It rejected the adcp_version echo (#8518)." - }, - { - "file": "core/canonical-proposal.json", - "pointer": "", - "property": "*", - "release": "3.3.0", - "source": { - "path": "governance/decisions/DR-0019-closed-row-schemas-deliberate-class.md", - "quote": "Response roots, capability blocks, and container objects stay open" - }, - "reason": "Correction (a) of DR-0036: closed in 3.2 against DR-0019. Container for a proposal's commercial terms, lineage, status, and narrative. It has no ext." - }, - { - "file": "core/canonical-product.json", - "pointer": "", - "property": "*", - "release": "3.3.0", - "source": { - "path": "governance/decisions/DR-0019-closed-row-schemas-deliberate-class.md", - "quote": "Schemas that do not fit either class must be opened." - }, - "reason": "Correction (a) of DR-0036: closed in 3.2 against DR-0019. Resource: the product, not a row. The product schema it parallels is open." - }, - { - "file": "media-buy/product-discovery-criteria.json", - "pointer": "", - "property": "*", - "release": "3.3.0", - "source": { - "path": "governance/decisions/DR-0019-closed-row-schemas-deliberate-class.md", - "quote": "Response roots, capability blocks, and container objects stay open" - }, - "reason": "Correction (a) of DR-0036: closed in 3.2 against DR-0019. Container for the discovery filters of list_products, request_proposals and refine_proposals." - }, - { - "file": "media-buy/proposal-refinement.json", - "pointer": "", - "property": "*", - "release": "3.3.0", - "source": { - "path": "governance/decisions/DR-0019-closed-row-schemas-deliberate-class.md", - "quote": "A Class B schema without an escape hatch is a defect." - }, - "reason": "Correction (a) of DR-0036: closed in 3.2 against DR-0019. Request row for one refinement instruction. It is not a join-key object, and it has no ext." - }, - { - "file": "media-buy/package-control.json", - "pointer": "", - "property": "*", - "release": "3.3.0", - "source": { - "path": "governance/decisions/DR-0019-closed-row-schemas-deliberate-class.md", - "quote": "A Class B schema without an escape hatch is a defect." - }, - "reason": "Correction (a) of DR-0036: closed in 3.2 against DR-0019. Request row for one package's controls. It is not a join-key object, and it has no ext." - }, - { - "file": "core/opportunity-context.json", - "pointer": "", - "property": "*", - "release": "3.3.0", - "source": { - "path": "governance/decisions/DR-0019-closed-row-schemas-deliberate-class.md", - "quote": "Response roots, capability blocks, and container objects stay open" - }, - "reason": "Correction (a) of DR-0036: closed in 3.2 against DR-0019. Container for buyer context in a planning cycle. Its opportunity_id is opaque, not a join key. It has no ext." - }, { "file": "core/protocol-envelope.json", "pointer": "/properties/task_id", @@ -276,7 +12,7 @@ "path": "static/schemas/source/core/protocol-envelope.json", "quote": "Unique identifier for tracking asynchronous operations. Present when a task requires extended processing time. Used to query task status and retrieve results when complete." }, - "reason": "Correction (c) of DR-0036: task_id identifies a task, so it is not empty, as 3.2.7's core/compact-task-submitted.json already published. The envelope's task_id, carried by every task response." + "reason": "Applies the bound the published text sets. task_id identifies a task, so it is not empty, as 3.2.7's core/compact-task-submitted.json already published. The envelope's task_id, carried by every task response." }, { "file": "core/mcp-webhook-payload.json", @@ -288,7 +24,7 @@ "path": "static/schemas/source/core/protocol-envelope.json", "quote": "Unique identifier for tracking asynchronous operations. Present when a task requires extended processing time. Used to query task status and retrieve results when complete." }, - "reason": "Correction (c) of DR-0036: task_id identifies a task, so it is not empty, as 3.2.7's core/compact-task-submitted.json already published. The task a webhook notification reports on." + "reason": "Applies the bound the published text sets. task_id identifies a task, so it is not empty, as 3.2.7's core/compact-task-submitted.json already published. The task a webhook notification reports on." }, { "file": "core/tasks-get-request.json", @@ -300,7 +36,7 @@ "path": "static/schemas/source/core/tasks-get-request.json", "quote": "Unique identifier of the task to retrieve" }, - "reason": "Correction (c) of DR-0036: task_id identifies a task, so it is not empty, as 3.2.7's core/compact-task-submitted.json already published. The task tasks/get retrieves; it requires task_id." + "reason": "Applies the bound the published text sets. task_id identifies a task, so it is not empty, as 3.2.7's core/compact-task-submitted.json already published. The task tasks/get retrieves; it requires task_id." }, { "file": "core/tasks-get-response.json", @@ -312,7 +48,7 @@ "path": "static/schemas/source/core/protocol-envelope.json", "quote": "Unique identifier for tracking asynchronous operations. Present when a task requires extended processing time. Used to query task status and retrieve results when complete." }, - "reason": "Correction (c) of DR-0036: task_id identifies a task, so it is not empty, as 3.2.7's core/compact-task-submitted.json already published. The task tasks/get returns." + "reason": "Applies the bound the published text sets. task_id identifies a task, so it is not empty, as 3.2.7's core/compact-task-submitted.json already published. The task tasks/get returns." }, { "file": "core/tasks-list-request.json", @@ -324,7 +60,7 @@ "path": "static/schemas/source/core/tasks-get-request.json", "quote": "Unique identifier of the task to retrieve" }, - "reason": "Correction (c) of DR-0036: task_id identifies a task, so it is not empty, as 3.2.7's core/compact-task-submitted.json already published. A task named in the tasks/list filter." + "reason": "Applies the bound the published text sets. task_id identifies a task, so it is not empty, as 3.2.7's core/compact-task-submitted.json already published. A task named in the tasks/list filter." }, { "file": "core/tasks-list-response.json", @@ -336,7 +72,7 @@ "path": "static/schemas/source/core/protocol-envelope.json", "quote": "Unique identifier for tracking asynchronous operations. Present when a task requires extended processing time. Used to query task status and retrieve results when complete." }, - "reason": "Correction (c) of DR-0036: task_id identifies a task, so it is not empty, as 3.2.7's core/compact-task-submitted.json already published. A task tasks/list returns." + "reason": "Applies the bound the published text sets. task_id identifies a task, so it is not empty, as 3.2.7's core/compact-task-submitted.json already published. A task tasks/list returns." }, { "file": "protocol/get-task-status-request.json", @@ -348,7 +84,7 @@ "path": "static/schemas/source/core/tasks-get-request.json", "quote": "Unique identifier of the task to retrieve" }, - "reason": "Correction (c) of DR-0036: task_id identifies a task, so it is not empty, as 3.2.7's core/compact-task-submitted.json already published. The task get_task_status retrieves; it requires task_id." + "reason": "Applies the bound the published text sets. task_id identifies a task, so it is not empty, as 3.2.7's core/compact-task-submitted.json already published. The task get_task_status retrieves; it requires task_id." }, { "file": "protocol/list-tasks-request.json", @@ -360,7 +96,7 @@ "path": "static/schemas/source/core/tasks-get-request.json", "quote": "Unique identifier of the task to retrieve" }, - "reason": "Correction (c) of DR-0036: task_id identifies a task, so it is not empty, as 3.2.7's core/compact-task-submitted.json already published. A task named in the list_tasks filter." + "reason": "Applies the bound the published text sets. task_id identifies a task, so it is not empty, as 3.2.7's core/compact-task-submitted.json already published. A task named in the list_tasks filter." }, { "file": "protocol/list-tasks-response.json", @@ -372,7 +108,7 @@ "path": "static/schemas/source/core/protocol-envelope.json", "quote": "Unique identifier for tracking asynchronous operations. Present when a task requires extended processing time. Used to query task status and retrieve results when complete." }, - "reason": "Correction (c) of DR-0036: task_id identifies a task, so it is not empty, as 3.2.7's core/compact-task-submitted.json already published. A task list_tasks returns." + "reason": "Applies the bound the published text sets. task_id identifies a task, so it is not empty, as 3.2.7's core/compact-task-submitted.json already published. A task list_tasks returns." }, { "file": "core/compact-task-input-required.json", @@ -383,7 +119,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "core/compact-task-working.json", @@ -394,7 +130,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "creative/sync-creatives-async-response-input-required.json", @@ -405,7 +141,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "creative/sync-creatives-async-response-working.json", @@ -416,7 +152,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/accept-proposal-async-response-input-required.json", @@ -427,7 +163,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/accept-proposal-async-response-working.json", @@ -438,7 +174,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/accept-proposal-response.json", @@ -449,7 +185,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/build-creative-async-response-input-required.json", @@ -460,7 +196,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/build-creative-async-response-working.json", @@ -471,7 +207,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/buy-products-async-response-input-required.json", @@ -482,7 +218,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/buy-products-async-response-working.json", @@ -493,7 +229,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/buy-products-response.json", @@ -504,7 +240,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/control-media-buy-async-response-input-required.json", @@ -515,7 +251,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/control-media-buy-async-response-working.json", @@ -526,7 +262,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/control-media-buy-response.json", @@ -537,7 +273,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/create-media-buy-async-response-input-required.json", @@ -548,7 +284,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/create-media-buy-async-response-working.json", @@ -559,7 +295,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/decline-proposals-async-response-input-required.json", @@ -570,7 +306,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/decline-proposals-async-response-working.json", @@ -581,7 +317,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/decline-proposals-response.json", @@ -592,7 +328,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/get-products-async-response-input-required.json", @@ -603,7 +339,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/get-products-async-response-working.json", @@ -614,7 +350,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/list-products-response.json", @@ -625,7 +361,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/media-buy-commitment-response.json", @@ -636,7 +372,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/refine-proposals-async-response-input-required.json", @@ -647,7 +383,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/refine-proposals-async-response-working.json", @@ -658,7 +394,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/refine-proposals-response.json", @@ -669,7 +405,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/request-proposals-async-response-input-required.json", @@ -680,7 +416,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/request-proposals-async-response-working.json", @@ -691,7 +427,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/request-proposals-response.json", @@ -702,7 +438,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/sync-catalogs-async-response-input-required.json", @@ -713,7 +449,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/sync-catalogs-async-response-working.json", @@ -724,7 +460,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/update-media-buy-async-response-input-required.json", @@ -735,7 +471,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "media-buy/update-media-buy-async-response-working.json", @@ -746,7 +482,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "signals/get-signals-async-response-working.json", @@ -757,7 +493,7 @@ "path": "dist/schemas/3.2.7/core/protocol-envelope.json", "quote": "The `status` field is REQUIRED on every task response envelope" }, - "reason": "Correction (b) of DR-0036: the response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." + "reason": "Applies the required name the published text sets. The response composes the protocol envelope, which already required status on every task response envelope in 3.2.7." }, { "file": "core/protocol-envelope.json", @@ -769,7 +505,7 @@ "path": "dist/schemas/3.2.7/core/compact-task-submitted.json", "quote": "\"message\": { \"type\": \"string\", \"maxLength\": 2000 }" }, - "reason": "Correction (d) of DR-0036: the envelope's message, on every task response, refers to core/task-message.json, so it carries the 2,000-character bound that 3.2.7 published on the compact responses and the submitted payloads. One bound for every delivery path, at the same 2,000." + "reason": "Applies the bound the published text sets. The envelope's message, on every task response, refers to core/task-message.json, so it carries the 2,000-character bound that 3.2.7 published on the compact responses and the submitted payloads. One bound for every delivery path, at the same 2,000." }, { "file": "core/mcp-webhook-payload.json", @@ -781,7 +517,7 @@ "path": "dist/schemas/3.2.7/core/compact-task-submitted.json", "quote": "\"message\": { \"type\": \"string\", \"maxLength\": 2000 }" }, - "reason": "Correction (d) of DR-0036: a webhook notification's message refers to core/task-message.json, so the bound does not depend on whether the task state arrives in a response or a webhook. The same 2,000 that 3.2.7 published on the compact responses." + "reason": "Applies the bound the published text sets. A webhook notification's message refers to core/task-message.json, so the bound does not depend on whether the task state arrives in a response or a webhook. The same 2,000 that 3.2.7 published on the compact responses." }, { "file": "core/response.json", @@ -793,7 +529,7 @@ "path": "dist/schemas/3.2.7/core/compact-task-submitted.json", "quote": "\"message\": { \"type\": \"string\", \"maxLength\": 2000 }" }, - "reason": "Correction (d) of DR-0036: the response wrapper's message refers to core/task-message.json, so the wrapper carries the same 2,000-character bound as the envelope." + "reason": "Applies the bound the published text sets. The response wrapper's message refers to core/task-message.json, so the wrapper carries the same 2,000-character bound as the envelope." } ] } diff --git a/scripts/lint-additive-minor.cjs b/scripts/lint-additive-minor.cjs index 5085f05973f..1776483305d 100644 --- a/scripts/lint-additive-minor.cjs +++ b/scripts/lint-additive-minor.cjs @@ -34,35 +34,28 @@ * additional-properties-closed, file-removed. * * Closed schemas (DR-0036) - * A schema that any stable release of the major published closed - * (`additionalProperties: false` or `unevaluatedProperties: false`) stays - * closed until the next major, even after a later release opens it. CI - * compares every earlier stable release of the base's major with the base, - * using the same node and branch matching, and records each node that an - * earlier release closed and the base leaves open. A property that such a - * node lacked in the last release that closed it is reported as - * property-added-to-closed, with that release named in the detail. A - * finding whose property the base already has is marked released: it - * shipped in a stable release and may enter the baseline at any time. + * Schemas are open by default. A schema stays closed + * (`additionalProperties: false` or `unevaluatedProperties: false`) only + * where closure enforces something; the commercial terms are held closed + * until 4.0. A property added to a schema that is closed in both the base + * and the candidate is property-added-to-closed: a validator + * on the base release rejects it. Opening a closed schema is allowed, and + * so is adding to a schema the candidate opens. Closing an open schema is + * additional-properties-closed. * * Notices (never fail) * additional-properties-opened: a closed schema is opened. Opening breaks no - * validator, but it permits no additions within the major. + * validator. * * Corrections (DR-0036) - * A minor or patch release may change a closed schema only to make it - * accept what the published spec text already required. - * scripts/lint-additive-minor-corrections.json lists each recorded - * correction: the schema location, the property it lets in, the release it - * lands in, and the source text that required it. The check accepts - * exactly the listed additions from the listed release on. Property `*` - * reopens the whole schema: the schema must be open in the candidate, and - * any addition to it passes. A named property must be declared at its - * location in the candidate. Each source file must exist and contain its - * quote, and each entry must appear in the correction tables of the - * decision record that the file names. + * A minor or patch release may tighten a schema only where the published + * spec text of the major already set the limit. + * scripts/lint-additive-minor-corrections.json lists each one: the schema + * location, the change, the release it lands in, and the source text it + * rests on. Each source file must exist and contain its quote, and the file + * must name an existing decision record under governance/decisions. * - * A correction may instead tighten one bound (`bound` and `value`, such as + * A correction may tighten one bound (`bound` and `value`, such as * `minLength` 1) where the published spec text already required it: an * empty identifier that the text says identifies a task. The check accepts * exactly that bound at that location from the listed release on, and the @@ -82,8 +75,6 @@ * prints a report; exits 0. * --history runs the check across consecutive 3.x * releases and prints tables and findings. - * Each pair is compared on its own, without - * the earlier-release closures. * --prune-baseline removes stale baseline entries only. * --baseline-ref also fails when the baseline has an entry * that the baseline at lacks, so the @@ -91,9 +82,10 @@ * $ADCP_ADDITIVE_MINOR_BASELINE_REF. * * Background: DR-0009 makes schemas open by default so that a minor can add - * optional fields, but many published schemas close objects with - * `additionalProperties: false`. A later minor that adds a field to a closed - * object breaks a receiver that validates against the earlier release. + * optional fields. A minor that adds a field to an object that stays closed + * breaks a receiver that validates against the earlier release, so 3.3 opens + * the schemas that were meant to be open (WG, 2026-11-09) and keeps closed + * only those whose closure enforces something (DR-0036). */ 'use strict'; @@ -662,22 +654,15 @@ function describeTypes(set) { /** * Compares two schema trees. Returns violations as `findings` and - * `notices`, each `{ file, pointer, kind, detail }`; a finding on a property - * the base already has also carries `released: true`. + * `notices`, each `{ file, pointer, kind, detail }`. * * Options: - * closedEarlier Map from a base node's location to `{ release, names }`: - * the last earlier stable release that published the node - * closed, and the properties it had there. - * corrections `{ reopened, properties }` from readCorrections: the base - * node locations whose additions are all allowed, and a Map - * from a base node location to the property names allowed - * there. + * corrections `{ bounds, required }` from readCorrections: the bounds + * and required names a finding location may add. * onObject Called as (baseNode, baseLocation, candNode, candLocation) * for every pair of matched object schemas. */ function compareTrees(baseTree, candTree, { - closedEarlier = null, corrections = null, onObject = null, skipIdentical = false, @@ -685,8 +670,6 @@ function compareTrees(baseTree, candTree, { const findings = []; const notices = []; const seen = new Set(); - const reopened = (location) => Boolean(corrections && location && corrections.reopened.has(location)); - const corrected = (location) => (corrections && location && corrections.properties.get(location)) || null; // A recorded required correction: a name a finding location may newly require. const requiredCorrected = (file, pointer, name) => Boolean( corrections && corrections.required && corrections.required.get(`${file}#${pointer}`)?.has(name), @@ -800,8 +783,7 @@ function compareTrees(baseTree, candTree, { if (ac === false && ab !== false) { report(file, pointer, 'additional-properties-closed', `${keyword} ${describe(ab, bDoc)} → false`); } else if (ab === false && ac !== false) { - report(file, pointer, 'additional-properties-opened', `${keyword} false → ${describe(ac, cDoc)}`, - reopened(bLocation) ? { corrected: true } : null); + report(file, pointer, 'additional-properties-opened', `${keyword} false → ${describe(ac, cDoc)}`); } else if (isObject(ab) && isObject(ac)) { compareNode(file, child(pointer, keyword), ab, bDoc, ac, cDoc, stack); } @@ -818,22 +800,13 @@ function compareTrees(baseTree, candTree, { report(file, pointer, 'property-removed', `property ${name} removed`); } } - // The closed form: the base's, or, for a node the base leaves open, the - // last earlier release that published it closed. - const earlier = !isClosed(b) && closedEarlier && bLocation ? closedEarlier.get(bLocation) : undefined; - const allowed = isClosed(b) ? new Set(Object.keys(pb)) : earlier && earlier.names; - if (allowed && !reopened(bLocation)) { - // A recorded correction lets in exactly the properties it names. - const correctedNames = corrected(bLocation); + // A node closed on both sides rejects, at the base release, any property + // the candidate adds. A node the candidate opens takes additions. + if (isClosed(b) && isClosed(c)) { for (const name of Object.keys(pc)) { - if (allowed.has(name) || (correctedNames && correctedNames.has(name))) continue; - if (!earlier) { + if (!Object.prototype.hasOwnProperty.call(pb, name)) { report(file, pointer, 'property-added-to-closed', `property ${name} added`); - continue; } - const released = Object.prototype.hasOwnProperty.call(pb, name); - report(file, pointer, 'property-added-to-closed', `property ${name} added (closed in ${earlier.release})`, - released ? { released: true } : null); } } @@ -886,56 +859,18 @@ function compareTrees(baseTree, candTree, { return { findings, notices, filesCompared: files.length }; } -/** - * For each node of `baseTree` that is open, the last of `earlierTrees` that - * published it closed, and the properties it had there. `earlierTrees` is - * `[{ version, tree }]`, oldest first: the stable releases of the base's - * major that precede the base. - */ -function closedInEarlierReleases(baseTree, earlierTrees) { - const closed = new Map(); - for (const { version, tree } of earlierTrees) { - // A file identical in both releases has the same closures in both; a $ref - // that leaves it is followed from the file that differs. - compareTrees(tree, baseTree, { - skipIdentical: true, - onObject: (earlier, _earlierLocation, base, baseLocation) => { - if (!baseLocation || !isClosed(earlier) || isClosed(base)) return; - closed.set(baseLocation, { - release: version, - names: new Set(isObject(earlier.properties) ? Object.keys(earlier.properties) : []), - }); - }, - }); - } - return closed; -} - -/** The stable releases of `base`'s major that precede it, oldest first. */ -function earlierStableVersions(base, releasedVersions) { - const parsed = parseVersion(base); - return releasedVersions - .map(parseVersion) - .filter((v) => v && v.major === parsed.major && v.prerelease.length === 0 && compareVersions(v, parsed) < 0) - .sort(compareVersions) - .map((v) => v.raw); -} - // --------------------------------------------------------------------------- // Corrections // --------------------------------------------------------------------------- -/** The property of a correction entry that reopens the whole schema. */ -const WHOLE_SCHEMA = '*'; - /** - * A correction's identity: its location and the property it lets in, or the - * bound it adds (`minLength: 1`). + * A correction's identity: its location and the bound it adds + * (`minLength: 1`) or the name it requires. */ function correctionKey(entry) { const change = typeof entry.bound === 'string' ? `${entry.bound}: ${entry.value}` - : typeof entry.required === 'string' ? `required: ${entry.required}` : entry.property; + : `required: ${entry.required}`; return `${entry.file}#${entry.pointer} ${change}`; } @@ -945,8 +880,6 @@ const CORRECTABLE_BOUNDS = new Set([...LOWER_BOUNDS, ...UPPER_BOUNDS]); * Validates the corrections list and returns what `candidateVersion` may * carry: the corrections whose release is at or below it. A prerelease counts * as its release (3.3.0-beta.1 as 3.3.0). Returns - * reopened the base node locations that a `*` entry reopens; - * properties a Map from a base node location to the names it lets in; * bounds a Map from a finding location to the bounds (keyword → value) * it may add; * required a Map from a finding location to the names it may newly @@ -954,12 +887,10 @@ const CORRECTABLE_BOUNDS = new Set([...LOWER_BOUNDS, ...UPPER_BOUNDS]); */ function readCorrections(value, candidateVersion) { const errors = []; - const reopened = new Set(); - const properties = new Map(); const bounds = new Map(); const required = new Map(); if (!isObject(value) || !Array.isArray(value.corrections)) { - return { reopened, properties, bounds, required, entries: [], errors: ['corrections list must be an object with a corrections array'] }; + return { bounds, required, entries: [], errors: ['corrections list must be an object with a corrections array'] }; } const candidate = parseVersion(candidateVersion); const current = candidate && { ...candidate, prerelease: [] }; @@ -972,16 +903,21 @@ function readCorrections(value, candidateVersion) { } const isBound = entry.bound !== undefined; const isRequired = entry.required !== undefined; - const changeField = isBound ? 'bound' : isRequired ? 'required' : 'property'; + if (entry.property !== undefined) { + errors.push(`${label} lets in a property; opening a schema or adding to an open one needs no correction (DR-0036)`); + return; + } + if (isBound === isRequired) { + errors.push(`${label} must name exactly one of bound and required`); + return; + } + const changeField = isBound ? 'bound' : 'required'; for (const field of ['file', 'pointer', changeField, 'release', 'reason']) { if (typeof entry[field] !== 'string') errors.push(`${label}.${field} must be a string`); } for (const field of [changeField, 'reason']) { if (typeof entry[field] === 'string' && !entry[field].trim()) errors.push(`${label}.${field} must not be empty`); } - if ([isBound, isRequired, entry.property !== undefined].filter(Boolean).length > 1) { - errors.push(`${label} names more than one of property, bound and required`); - } if (isBound) { if (typeof entry.bound === 'string' && !CORRECTABLE_BOUNDS.has(entry.bound)) errors.push(`${label}.bound must be a JSON Schema bound keyword`); if (typeof entry.value !== 'number') errors.push(`${label}.value must be a number`); @@ -1009,53 +945,26 @@ function readCorrections(value, candidateVersion) { bounds.get(location).set(entry.bound, entry.value); return; } - if (isRequired) { - if (typeof entry.required !== 'string') return; - if (!required.has(location)) required.set(location, new Set()); - required.get(location).add(entry.required); - return; - } - if (typeof entry.property !== 'string') return; - if (entry.property === WHOLE_SCHEMA) reopened.add(location); - else { - if (!properties.has(location)) properties.set(location, new Set()); - properties.get(location).add(entry.property); - } + if (typeof entry.required !== 'string') return; + if (!required.has(location)) required.set(location, new Set()); + required.get(location).add(entry.required); }); - return { reopened, properties, bounds, required, entries: value.corrections, errors }; + return { bounds, required, entries: value.corrections, errors }; } /** * Each correction in effect must be applied in the candidate tree: a - * reopened schema is open, a corrected property is declared there, and a * corrected bound has its value there (through a `$ref` if the location - * refers to a shared definition). + * refers to a shared definition), and a required name is in the composed + * required set there. */ -function checkCorrectionsApplied({ reopened, properties, bounds = new Map(), required = new Map() }, candTree) { +function checkCorrectionsApplied({ bounds = new Map(), required = new Map() }, candTree) { const errors = []; const nodeAt = (location) => { const [key, pointer] = location.split('#'); const document = candTree.documents.get(key); return document ? readPointer(document.schema, pointer) : undefined; }; - for (const location of reopened) { - const node = nodeAt(location); - if (!isObject(node)) errors.push(`correction ${location} does not exist in ${candTree.label}`); - else if (isClosed(node)) errors.push(`correction ${location} reopens a schema that is still closed in ${candTree.label}`); - } - for (const [location, names] of properties) { - const node = nodeAt(location); - if (!isObject(node)) { - errors.push(`correction ${location} does not exist in ${candTree.label}`); - continue; - } - const declared = isObject(node.properties) ? node.properties : {}; - for (const name of names) { - if (!Object.prototype.hasOwnProperty.call(declared, name)) { - errors.push(`correction ${location} does not declare ${name} in ${candTree.label}`); - } - } - } for (const [location, expected] of bounds) { let node = nodeAt(location); if (isObject(node) && typeof node.$ref === 'string') { @@ -1126,32 +1035,10 @@ function checkCorrectionSources(entries, root) { } /** - * The corrections a decision record lists, as correction keys. The tables sit - * under its `### Corrections` heading. In a table row, the first cell names - * the schema file in code, the second reads `root` or lists pointers in code, - * and the third names the property in code. + * The corrections list names the decision record that governs it, and that + * record must exist under governance/decisions. */ -function recordedCorrections(recordText) { - const keys = new Set(); - const heading = /^### Corrections[^\n]*$/m.exec(recordText); - if (!heading) return keys; - const section = recordText.slice(heading.index + heading[0].length).split(/^#{1,3} /m)[0]; - for (const line of section.split('\n')) { - const cells = line.split('|').map((cell) => cell.trim()); - const file = /^`([^`]+\.json)`$/.exec(cells[1] || ''); - const property = /^`([^`]+)`$/.exec(cells[3] || ''); - if (!file || !property) continue; - const pointers = cells[2] === 'root' ? [''] : [...cells[2].matchAll(/`([^`]*)`/g)].map((m) => m[1]); - for (const pointer of pointers) keys.add(correctionKey({ file: file[1], pointer, property: property[1] })); - } - return keys; -} - -/** - * Each correction must appear in the correction tables of the decision record - * that the list names, so a new correction needs a governance change. - */ -function checkCorrectionsRecorded(value, root) { +function checkCorrectionsDecision(value, root) { if (!isObject(value) || !Array.isArray(value.corrections) || value.corrections.length === 0) return []; if (typeof value.decision !== 'string' || !/^DR-\d+$/.test(value.decision)) { return ['corrections list must name its decision record, such as DR-0036']; @@ -1160,17 +1047,7 @@ function checkCorrectionsRecorded(value, root) { const record = fs.existsSync(directory) ? fs.readdirSync(directory).find((name) => name.startsWith(`${value.decision}-`) && name.endsWith('.md')) : undefined; - if (!record) return [`no decision record for ${value.decision} under governance/decisions`]; - const recorded = recordedCorrections(fs.readFileSync(path.join(directory, record), 'utf8')); - // Malformed entries are reported by readCorrections. - const changeField = (entry) => (entry.bound !== undefined ? 'bound' : entry.required !== undefined ? 'required' : 'property'); - const wellFormed = (entry) => isObject(entry) - && ['file', 'pointer', changeField(entry)].every((field) => typeof entry[field] === 'string'); - return value.corrections - .filter(wellFormed) - .map(correctionKey) - .filter((key) => !recorded.has(key)) - .map((key) => `correction ${key} is not in the correction tables of ${record}`); + return record ? [] : [`no decision record for ${value.decision} under governance/decisions`]; } // --------------------------------------------------------------------------- @@ -1257,13 +1134,10 @@ function checkAgainstBaseline({ base, findings, baselineValue, previousBaseline } if (previousBaseline) { - // A released finding shipped in a stable release, so no change can undo - // it within the major. Recording it hides no unreleased change. - const released = new Set(findings.filter((f) => f.released).map(findingKey)); const previous = new Set(validateBaseline(previousBaseline).entries.map(findingKey)); for (const entry of baseline.entries) { const key = findingKey(entry); - if (!previous.has(key) && !released.has(key)) { + if (!previous.has(key)) { errors.push(`baseline grew: ${key} is not in the target branch baseline`); } } @@ -1316,34 +1190,25 @@ function formatHistory(results) { // --------------------------------------------------------------------------- /** - * Compares a candidate tree with a base, applying the closures of the earlier - * stable releases in the base's major and the recorded corrections. - * `earlierTrees` defaults to the released trees on disk or in git. + * Compares a candidate tree with a base, applying the recorded corrections. * Correction sources and the decision record resolve against `repoRoot`. */ function analyze({ - base, baseTree, candTree, candidateVersion, - earlierTrees, correctionsValue, repoRoot = REPO_ROOT, }) { - const trees = earlierTrees || (base - ? earlierStableVersions(base, listReleasedVersions(repoRoot)).map((version) => ({ version, tree: loadReleasedTree(version, repoRoot) })) - : []); const value = correctionsValue === undefined ? { corrections: [] } : correctionsValue; const corrections = readCorrections(value, candidateVersion); const errors = [ - ...trees.flatMap(({ tree }) => tree.errors), ...corrections.errors, ...checkCorrectionSources(corrections.entries, repoRoot), - ...checkCorrectionsRecorded(value, repoRoot), + ...checkCorrectionsDecision(value, repoRoot), ...checkCorrectionsApplied(corrections, candTree), ]; - const closedEarlier = closedInEarlierReleases(baseTree, trees); - const result = compareTrees(baseTree, candTree, { closedEarlier, corrections }); + const result = compareTrees(baseTree, candTree, { corrections }); return { ...result, errors }; } @@ -1365,7 +1230,6 @@ function lintAdditiveMinor({ baseTree, baseVersion, candidateVersion, - earlierTrees, previousBaseline = null, } = {}) { let base = baseVersion; @@ -1377,11 +1241,9 @@ function lintAdditiveMinor({ const baseSchemas = baseTree || loadReleasedTree(base, repoRoot); const candTree = loadDirectoryTree(sourceDir, 'source'); const { findings, notices, filesCompared, errors: analysisErrors } = analyze({ - base, baseTree: baseSchemas, candTree, candidateVersion: version, - earlierTrees: earlierTrees || (baseTree ? [] : undefined), correctionsValue: correctionsValue === undefined ? readJsonFile(correctionsPath, { corrections: [] }) : correctionsValue, repoRoot, }); @@ -1432,9 +1294,7 @@ function main() { console.log(`No stable release precedes ${candidateVersion} in its major line; nothing to compare.`); return; } - const baseIsRelease = Boolean(parseVersion(base)); const { findings, notices, filesCompared, errors } = analyze({ - base: baseIsRelease ? base : null, baseTree: loadTreeSpec(base, options), candTree: loadTreeSpec(candidate, options), candidateVersion, @@ -1477,10 +1337,8 @@ function main() { console.log('✓ additive-minor lint: the source major line has no stable release yet; nothing to compare.'); return; } - for (const notice of result.notices) { - console.log(notice.corrected - ? `notice: ${findingKey(notice)}. Reopened as a correction recorded in DR-0036 (scripts/lint-additive-minor-corrections.json).` - : `notice: ${findingKey(notice)}. Opening breaks no validator, but it permits no additions until the next major (DR-0036).`); + if (result.notices.length) { + console.log(`notice: ${result.notices.length} closed schema locations opened since ${result.base}. Opening breaks no validator (DR-0036); see --base/--candidate for the list.`); } result.warnings.forEach((warning) => console.warn(`warning: ${warning}`)); if (result.warnings.length) console.warn('Run `node scripts/lint-additive-minor.cjs --prune-baseline` to drop stale entries.'); @@ -1498,8 +1356,9 @@ function main() { '\nA minor release only adds. Make the change additive instead: add the property to an open' + ' object, keep removed values and properties, and keep new properties optional. If the change' + ' has to ship anyway, it needs a WG decision and a major release. If the published spec text' + - ' already required it, record it as a correction in DR-0036 and' + - ' scripts/lint-additive-minor-corrections.json.', + ' already required it, add it as a correction to scripts/lint-additive-minor-corrections.json' + + ' (DR-0036). A correction sets a bound or a required name; to add a property to a closed' + + ' schema, open the schema instead.', ); } process.exitCode = 1; @@ -1509,7 +1368,6 @@ module.exports = { readBaselineAtRef, NOTICE_KINDS, VIOLATION_KINDS, - WHOLE_SCHEMA, analyze, buildTree, checkAgainstBaseline, @@ -1518,7 +1376,6 @@ module.exports = { findingKey, historyPairs, lintAdditiveMinor, - recordedCorrections, }; if (require.main === module) main(); diff --git a/scripts/mcp-schema-projection.cjs b/scripts/mcp-schema-projection.cjs index a0f6333e5a9..81b64b0eda2 100644 --- a/scripts/mcp-schema-projection.cjs +++ b/scripts/mcp-schema-projection.cjs @@ -813,6 +813,15 @@ function stripPresentationAnnotations(schema) { return stripped; } +/** True for `{ required: [...] }` or an `anyOf` of only such clauses. */ +function isNamedRejection(not) { + const requiredOnly = value => value && typeof value === 'object' && !Array.isArray(value) + && Object.keys(value).length === 1 && Array.isArray(value.required); + if (requiredOnly(not)) return true; + return Boolean(not) && typeof not === 'object' && Object.keys(not).length === 1 + && Array.isArray(not.anyOf) && not.anyOf.length > 0 && not.anyOf.every(requiredOnly); +} + function stripModelContextAnnotations(schema) { const stripped = stripPresentationAnnotations(schema); walkSchema(stripped, node => { @@ -840,6 +849,10 @@ function stripModelContextAnnotations(schema) { // JSON Schema's default, so omit that redundant spelling as well. Retain // schema-valued additionalProperties to describe typed dictionary values. if (typeof node.additionalProperties === 'boolean') delete node.additionalProperties; + // A named rejection (`not` over required names only, beside declared + // properties) is validation, like the bounds omitted above; the validation + // profile keeps it. A bare `not` branch of a union is logic and stays. + if (node.properties && isNamedRejection(node.not)) delete node.not; for (const keyword of Object.keys(node)) { if (keyword.startsWith('x-')) delete node[keyword]; } diff --git a/server/src/training-agent/principal.ts b/server/src/training-agent/principal.ts index a46ca23c360..828ce53cc63 100644 --- a/server/src/training-agent/principal.ts +++ b/server/src/training-agent/principal.ts @@ -73,6 +73,8 @@ const MAX_GENERATION_REFS = 32; const SELLER_ASYNC_EXPERIMENTAL_FEATURES: readonly string[] = ['protocol.principal']; /** Algorithms the seller signs webhooks with; also advertised in `webhook_signing`. */ export const SELLER_WEBHOOK_SIGNING_ALGORITHMS: readonly string[] = ['ed25519']; +/** The members of core/principal-declarations.json. */ +const DECLARATION_AXES = ['async_adcp_versions', 'webhook_signing_algorithms', 'experimental_features'] as const; const SELLER_ASYNC_ADCP_VERSIONS: readonly string[] = TRAINING_AGENT_SUPPORTED_RELEASE_VERSIONS .filter(version => /^\d+\.\d+$/.test(version)); @@ -632,7 +634,13 @@ export async function syncPrincipalLegacy( next = { ...next, subscriptions: applySubscriptions(prior.subscriptions ?? [], submitted.reporting_subscriptions, nowIso) }; } if (submitted.declarations !== undefined) { - next = { ...next, declared: structuredClone(submitted.declarations) }; + // The declarations schema is open; keep only the axes this seller reads, + // so an unknown member is ignored rather than stored and read back. + const declared = Object.fromEntries( + DECLARATION_AXES.filter(axis => submitted.declarations![axis] !== undefined) + .map(axis => [axis, structuredClone(submitted.declarations![axis])]), + ); + next = { ...next, declared }; } requireSignableWebhooks(next.declared, loaded.hasActiveSubscriber); } catch (error) { diff --git a/server/src/training-agent/source-schema.ts b/server/src/training-agent/source-schema.ts index 7218754d7b4..b5fc3677934 100644 --- a/server/src/training-agent/source-schema.ts +++ b/server/src/training-agent/source-schema.ts @@ -86,11 +86,14 @@ function linkedSchemaType(uri: string): unknown { return linked && typeof linked === 'object' ? (linked as JsonSchema).type : undefined; } -function keepDefinitionKey(key: string): boolean { +function keepDefinitionKey(key: string, value?: unknown): boolean { return key !== '$id' && key !== '$schema' && (key === 'x-adcp-schema-uri' || !key.startsWith('x-')) - && !definitionAnnotationKeys.has(key); + && !definitionAnnotationKeys.has(key) + // `additionalProperties: true` is JSON Schema's default and carries no + // information, so referenced definitions omit it from tools/list. + && !(key === 'additionalProperties' && value === true); } /** Build one self-contained schema without duplicating referenced schemas or @@ -156,7 +159,7 @@ function bundleSchema(root: JsonSchema): JsonSchema { const siblings = Object.fromEntries( Object.entries(record) - .filter(([key]) => key !== '$ref' && (!definitionPath || keepDefinitionKey(key))) + .filter(([key, entry]) => key !== '$ref' && (!definitionPath || keepDefinitionKey(key, entry))) .map(([key, entry]) => [key, rewrite(entry, definitionPath)]), ); if (Object.keys(siblings).length === 0) return { $ref: rewrittenRef }; @@ -167,7 +170,7 @@ function bundleSchema(root: JsonSchema): JsonSchema { return Object.fromEntries( Object.entries(record) - .filter(([key]) => !definitionPath || keepDefinitionKey(key)) + .filter(([key, entry]) => !definitionPath || keepDefinitionKey(key, entry)) .map(([key, entry]) => [key, rewrite(entry, definitionPath)]), ); } diff --git a/server/tests/unit/product-discovery-schema-parity.test.ts b/server/tests/unit/product-discovery-schema-parity.test.ts index 36a8f6bed2c..c6ddf10c5e1 100644 --- a/server/tests/unit/product-discovery-schema-parity.test.ts +++ b/server/tests/unit/product-discovery-schema-parity.test.ts @@ -22,6 +22,12 @@ function resolveLocalRef(root: JsonSchema, value: JsonSchema): JsonSchema { ), root); } +// tools/list omits `additionalProperties: true` inside bundled definitions (it +// is JSON Schema's default), so compare openness rather than the keyword. +function openness(schema: JsonSchema): boolean { + return schema.additionalProperties !== false; +} + describe('product discovery MCP schema parity', () => { it('keeps runtime discovery constraints aligned with source schemas', () => { const tools = new Map(productDiscoveryAliasToolDefinitions().map(tool => [tool.name, tool.inputSchema as JsonSchema])); @@ -64,34 +70,36 @@ describe('product discovery MCP schema parity', () => { expect(runtimeRefinement).toMatchObject({ type: sourceRefinement.type, required: sourceRefinement.required, - additionalProperties: sourceRefinement.additionalProperties, }); + expect(openness(runtimeRefinement)).toBe(openness(sourceRefinement)); // Repository-local refs must be bundled because MCP consumers do not have // an AdCP schema registry attached to tools/list. for (const runtime of tools.values()) { expect(JSON.stringify(runtime)).not.toContain('"$ref":"/schemas/'); } - expect(resolveLocalRef(list, list.properties.brand)).toMatchObject({ required: ['domain'], additionalProperties: false }); + const brand = resolveLocalRef(list, list.properties.brand); + expect(brand).toMatchObject({ required: ['domain'] }); + expect(openness(brand)).toBe(true); expect(resolveLocalRef(list, list.properties.fields)).toMatchObject({ minItems: 1, uniqueItems: true, items: { enum: expect.arrayContaining(['product_id', 'format_options', 'pricing_options']) }, }); - expect(resolveLocalRef(list, list.properties.criteria)) - .toMatchObject({ additionalProperties: sourceSchema('product-discovery-criteria').additionalProperties }); + expect(openness(resolveLocalRef(list, list.properties.criteria))) + .toBe(openness(sourceSchema('product-discovery-criteria'))); expect(resolveLocalRef(refineTool, refineTool.properties.refinements.items)) .toMatchObject({ required: ['proposal_id'], - additionalProperties: sourceRefinement.additionalProperties, // Definition annotations are intentionally stripped from tools/list; // dispatch still applies the source-schema default semantics. properties: { action: { enum: ['revise', 'finalize', 'extend_hold'] } }, oneOf: expect.any(Array), }); const declineTool = tools.get('decline_proposals')!; - expect(resolveLocalRef(declineTool, declineTool.properties.declines.items)) - .toMatchObject({ required: ['proposal_id', 'reason'], additionalProperties: false }); + const decline = resolveLocalRef(declineTool, declineTool.properties.declines.items); + expect(decline).toMatchObject({ required: ['proposal_id', 'reason'] }); + expect(openness(decline)).toBe(openness(sourceSchema('decline-proposals-request').properties.declines.items)); }); it('bundles each tools/list input schema as a valid standalone document', () => { diff --git a/server/tests/unit/training-agent-principal.test.ts b/server/tests/unit/training-agent-principal.test.ts index 8692be22711..f44a5d6324f 100644 --- a/server/tests/unit/training-agent-principal.test.ts +++ b/server/tests/unit/training-agent-principal.test.ts @@ -321,9 +321,7 @@ describe('principal layer: declarations', () => { describe('principal layer: request validation', () => { it.each([ ['an empty configuration', {}], - ['an unknown section', { bogus: [] }], ['an unknown destination property', { reporting_destinations: [destination({ access_key: 'AKIAEXAMPLE' })] }], - ['an unknown declarations property', { declarations: { api_token: 'x' } }], ['a signed-URL location', { reporting_destinations: [destination({ location: 's3://pinnacle/p?X-Amz-Signature=abc' })] }], ])('rejects %s without persisting', async (_label, configuration) => { const result = await sync(configuration); @@ -331,6 +329,22 @@ describe('principal layer: request validation', () => { expect((await read()).result.kind).toBe('recognized'); }); + // The request schema is open (WG decision 2026-11-09). A section the seller + // doesn't support is still refused, now by the handler rather than the + // schema, and nothing persists. + it('refuses an unknown section without persisting', async () => { + const result = await sync({ bogus: [] }); + expect(result.result).toMatchObject({ kind: 'failed', errors: [{ code: 'UNSUPPORTED_FEATURE' }] }); + expect((await read()).result.kind).toBe('recognized'); + }); + + // An unknown declarations property is ignored, and never read back. + it('ignores an unknown declarations property', async () => { + const result = await sync({ declarations: { api_token: 'x' } }); + expect(result.result.kind).toBe('applied'); + expect(JSON.stringify(await read())).not.toContain('api_token'); + }); + it('rejects the notification_configs section because it is not advertised', async () => { const result = await sync({ notification_configs: [subscriber()] }); expect(result.result).toMatchObject({ kind: 'failed', errors: [{ code: 'UNSUPPORTED_FEATURE' }] }); diff --git a/server/tests/unit/training-agent.test.ts b/server/tests/unit/training-agent.test.ts index 848e468a782..235783c8403 100644 --- a/server/tests/unit/training-agent.test.ts +++ b/server/tests/unit/training-agent.test.ts @@ -20342,6 +20342,43 @@ describe('proposal lifecycle', () => { expect(unsupported.isError).toBeFalsy(); expect(unsupported.result).toMatchObject({ outcome: 'listed', products: [] }); + // The requirements container is open, so an unknown requirement validates. + // It still fails closed: "Missing or unknown required fields do not match." + // The only difference from allRegions above is the unknown key. + const unknownRequirement = { + geo_regions: { countries: { FR: { values: ['FR-49'] } } }, + future_unknown_dimension: true, + }; + const unknownRequirementValidation = validateSourceSchema( + 'core/targeting-overlay-requirements.json', + unknownRequirement, + ); + expect(unknownRequirementValidation.valid, JSON.stringify(unknownRequirementValidation.errors)).toBe(true); + const unknownListed = await simulateCallTool(server, 'list_products', { + account, + criteria: { + product_ids: [targetedProductId], + required_overlay_support: unknownRequirement, + }, + }); + expect(unknownListed.isError, JSON.stringify(unknownListed.result)).toBeFalsy(); + expect(unknownListed.result).toMatchObject({ outcome: 'listed', products: [] }); + const discover = (required_overlay_support: Record) => executeTrainingAgentTool('get_products', { + adcp_version: CURRENT_ADCP_VERSION, + account, + buying_mode: 'brief', + brief: 'Regional display inventory in France', + required_overlay_support, + }, DEFAULT_CTX); + const knownDiscovered = await discover({ geo_regions: unknownRequirement.geo_regions }); + expect(knownDiscovered.success, knownDiscovered.error).toBe(true); + expect((knownDiscovered.data as { products: Array<{ product_id: string }> }).products) + .toEqual(expect.arrayContaining([expect.objectContaining({ product_id: targetedProductId })])); + const unknownDiscovered = await discover(unknownRequirement); + expect(unknownDiscovered.success, unknownDiscovered.error).toBe(true); + expect(unknownDiscovered.data).not.toHaveProperty('errors'); + expect((unknownDiscovered.data as { products: unknown[] }).products).toEqual([]); + const concurrentListings = await Promise.all(['US', 'CA'].map(country => simulateCallTool( server, 'list_products', diff --git a/static/compliance/source/universal/v4-compatibility.yaml b/static/compliance/source/universal/v4-compatibility.yaml index c944ef069a3..c84787f59e2 100644 --- a/static/compliance/source/universal/v4-compatibility.yaml +++ b/static/compliance/source/universal/v4-compatibility.yaml @@ -465,3 +465,12 @@ schema_removals_not_checked: sites: - "core/media-buy-legacy-terms-ref.json#" - "media-buy/request-proposals-response.json#/properties/purchase_continuation" + + - change: "Boolean demographics, the 3.2 shorthand for { age: true }" + issue: 8778 + reason: >- + Product support is seller-emitted and observable on get_products, but + not graded yet. Requirements are buyer-sent. + sites: + - "core/targeting-overlay-support.json#/properties/demographics/anyOf/0" + - "core/targeting-overlay-requirements.json#/properties/demographics/anyOf/0" diff --git a/static/schemas/source/aao/agent-publishers.json b/static/schemas/source/aao/agent-publishers.json index 9a659052f54..e9992399343 100644 --- a/static/schemas/source/aao/agent-publishers.json +++ b/static/schemas/source/aao/agent-publishers.json @@ -32,7 +32,7 @@ "description": "Opaque pagination cursor. Absent or null on the terminal page. Stable across the directory's refresh cycle for the lifetime of the cursor." } }, - "additionalProperties": false, + "additionalProperties": true, "definitions": { "PublisherEntry": { "type": "object", @@ -112,7 +112,7 @@ } } ], - "additionalProperties": false + "additionalProperties": true } } } diff --git a/static/schemas/source/account/sync-governance-request.json b/static/schemas/source/account/sync-governance-request.json index 6c3efc75797..8658e1c4080 100644 --- a/static/schemas/source/account/sync-governance-request.json +++ b/static/schemas/source/account/sync-governance-request.json @@ -65,14 +65,14 @@ "schemes", "credentials" ], - "additionalProperties": false + "additionalProperties": true } }, "required": [ "url", "authentication" ], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1, "maxItems": 1 @@ -82,7 +82,7 @@ "account", "governance_agents" ], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1, "maxItems": 100 diff --git a/static/schemas/source/account/sync-governance-response.json b/static/schemas/source/account/sync-governance-response.json index 98502efde62..51e0e103781 100644 --- a/static/schemas/source/account/sync-governance-response.json +++ b/static/schemas/source/account/sync-governance-response.json @@ -49,7 +49,7 @@ "required": [ "url" ], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1, "maxItems": 1 diff --git a/static/schemas/source/brand.json b/static/schemas/source/brand.json index 840036e4ced..ae2cb84f76f 100644 --- a/static/schemas/source/brand.json +++ b/static/schemas/source/brand.json @@ -89,7 +89,7 @@ } }, "required": ["domain", "brand_id"], - "additionalProperties": false + "additionalProperties": true }, "localized_name": { "type": "object", @@ -248,7 +248,7 @@ "required": ["kind", "surface"] } ], - "additionalProperties": false + "additionalProperties": true }, "guideline_severity": { "type": "string", @@ -483,7 +483,7 @@ { "required": ["url"] }, { "required": ["email"] } ], - "additionalProperties": false + "additionalProperties": true }, "brand": { "type": "object", @@ -1121,7 +1121,7 @@ } } }, - "additionalProperties": false + "additionalProperties": true }, "brand_shapes": { "type": "object", @@ -1360,7 +1360,7 @@ "width": { "type": "string", "description": "Minimum width, such as 48px or 12mm." }, "height": { "type": "string", "description": "Minimum height, such as 18px or 6mm." } }, - "additionalProperties": false + "additionalProperties": true }, "clear_space": { "type": "string", diff --git a/static/schemas/source/collection/base-collection-source.json b/static/schemas/source/collection/base-collection-source.json index b5305b8a002..78ec18e1b44 100644 --- a/static/schemas/source/collection/base-collection-source.json +++ b/static/schemas/source/collection/base-collection-source.json @@ -33,7 +33,7 @@ } }, "required": ["type", "value"], - "additionalProperties": false, + "additionalProperties": true, "not": { "required": ["type"], "properties": { "type": { "const": "platform_channel_id" } } @@ -43,7 +43,7 @@ } }, "required": ["selection_type", "identifiers"], - "additionalProperties": false + "additionalProperties": true }, { "type": "object", @@ -70,7 +70,7 @@ } }, "required": ["selection_type", "publisher_domain", "collection_ids"], - "additionalProperties": false + "additionalProperties": true }, { "type": "object", @@ -101,7 +101,7 @@ } }, "required": ["selection_type", "publisher_domain", "genres", "genre_taxonomy"], - "additionalProperties": false + "additionalProperties": true } ] } diff --git a/static/schemas/source/collection/collection-list-changed-webhook.json b/static/schemas/source/collection/collection-list-changed-webhook.json index 078063085ca..625ffc4eccd 100644 --- a/static/schemas/source/collection/collection-list-changed-webhook.json +++ b/static/schemas/source/collection/collection-list-changed-webhook.json @@ -43,7 +43,7 @@ "description": "Total collections in the resolved list" } }, - "additionalProperties": false + "additionalProperties": true }, "resolved_at": { "type": "string", @@ -64,5 +64,5 @@ } }, "required": ["idempotency_key", "event", "list_id", "resolved_at", "signature"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/collection/collection-list-filters.json b/static/schemas/source/collection/collection-list-filters.json index 7b82916d66c..aac20358478 100644 --- a/static/schemas/source/collection/collection-list-filters.json +++ b/static/schemas/source/collection/collection-list-filters.json @@ -65,7 +65,7 @@ } }, "required": ["type", "value"], - "additionalProperties": false, + "additionalProperties": true, "not": { "required": ["type"], "properties": { "type": { "const": "platform_channel_id" } } @@ -82,5 +82,5 @@ "minItems": 1 } }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/collection/collection-list.json b/static/schemas/source/collection/collection-list.json index d80e1d89ce6..d47938ed22e 100644 --- a/static/schemas/source/collection/collection-list.json +++ b/static/schemas/source/collection/collection-list.json @@ -64,5 +64,5 @@ } }, "required": ["list_id", "name"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/collection/get-collection-list-request.json b/static/schemas/source/collection/get-collection-list-request.json index a7fe6f7bc99..70309e9f71d 100644 --- a/static/schemas/source/collection/get-collection-list-request.json +++ b/static/schemas/source/collection/get-collection-list-request.json @@ -40,7 +40,7 @@ "description": "Opaque cursor from a previous response to fetch the next page" } }, - "additionalProperties": false + "additionalProperties": true }, "context": { "$ref": "/schemas/core/context.json" diff --git a/static/schemas/source/collection/get-collection-list-response.json b/static/schemas/source/collection/get-collection-list-response.json index 172995748b3..9db65e04f09 100644 --- a/static/schemas/source/collection/get-collection-list-response.json +++ b/static/schemas/source/collection/get-collection-list-response.json @@ -56,7 +56,7 @@ "type", "value" ], - "additionalProperties": false, + "additionalProperties": true, "not": { "required": ["type"], "properties": { "type": { "const": "platform_channel_id" } } @@ -85,7 +85,7 @@ "required": [ "name" ], - "additionalProperties": false + "additionalProperties": true } }, "pagination": { @@ -122,7 +122,7 @@ "type", "value" ], - "additionalProperties": false, + "additionalProperties": true, "not": { "required": ["type"], "properties": { "type": { "const": "platform_channel_id" } } diff --git a/static/schemas/source/compliance/comply-test-controller-request.json b/static/schemas/source/compliance/comply-test-controller-request.json index 89bde52edfc..b292f2d660d 100644 --- a/static/schemas/source/compliance/comply-test-controller-request.json +++ b/static/schemas/source/compliance/comply-test-controller-request.json @@ -1506,7 +1506,7 @@ } }, "required": ["vendor", "metric_id"], - "additionalProperties": false + "additionalProperties": true } }, "not_yet_measurable_vendor_metrics_by_package": { @@ -1529,7 +1529,7 @@ } }, "required": ["vendor", "metric_id"], - "additionalProperties": false + "additionalProperties": true } } }, diff --git a/static/schemas/source/compliance/comply-test-controller-response.json b/static/schemas/source/compliance/comply-test-controller-response.json index 8954845b559..f7529ec9331 100644 --- a/static/schemas/source/compliance/comply-test-controller-response.json +++ b/static/schemas/source/compliance/comply-test-controller-response.json @@ -55,7 +55,9 @@ "allOf": [ { "$ref": "/schemas/core/reporting-subscription-coverage.json#/properties/timezone_cutovers/items" }, { "required": ["offering_id", "previous_timezone"] } - ] + ], + "description": "Rejects `changed_at`, which belongs to the result, not to a cutover.", + "not": { "required": ["changed_at"] } } } }, @@ -334,7 +336,7 @@ "required": [ "arm" ], - "additionalProperties": false, + "additionalProperties": true, "allOf": [ { "if": { @@ -708,7 +710,7 @@ "identifier_value_sha256", "found" ], - "additionalProperties": false + "additionalProperties": true } }, "timestamp": { @@ -732,7 +734,7 @@ "payload_length", "timestamp" ], - "additionalProperties": false, + "additionalProperties": true, "discriminator": { "propertyName": "attestation_mode" }, diff --git a/static/schemas/source/content-standards/get-media-buy-artifacts-request.json b/static/schemas/source/content-standards/get-media-buy-artifacts-request.json index 0239b82bd35..250c55ba509 100644 --- a/static/schemas/source/content-standards/get-media-buy-artifacts-request.json +++ b/static/schemas/source/content-standards/get-media-buy-artifacts-request.json @@ -63,7 +63,7 @@ "description": "Opaque cursor from a previous response to fetch the next page" } }, - "additionalProperties": false + "additionalProperties": true }, "context": { "$ref": "/schemas/core/context.json" diff --git a/static/schemas/source/core/account-change-recorded-webhook.json b/static/schemas/source/core/account-change-recorded-webhook.json index 6f769754d64..08a55ee2f40 100644 --- a/static/schemas/source/core/account-change-recorded-webhook.json +++ b/static/schemas/source/core/account-change-recorded-webhook.json @@ -83,7 +83,7 @@ } }, "required": ["idempotency_key", "notification_id", "notification_type", "fired_at", "subscriber_id", "account_id", "change_id", "recorded_at", "resource", "action"], - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "description": "Creative update invalidation", diff --git a/static/schemas/source/core/account-identity-change-preview.json b/static/schemas/source/core/account-identity-change-preview.json index 4df54eaa5a9..909dfa10dd3 100644 --- a/static/schemas/source/core/account-identity-change-preview.json +++ b/static/schemas/source/core/account-identity-change-preview.json @@ -40,7 +40,7 @@ "area", "effect" ], - "additionalProperties": false + "additionalProperties": true }, "nonblocking_impacts": { "type": "array", @@ -108,7 +108,7 @@ "requested_operator_identity", "impacts" ], - "additionalProperties": false + "additionalProperties": true }, { "title": "AccountIdentityChangeWouldRequireApproval", @@ -130,7 +130,7 @@ "requested_operator_identity", "impacts" ], - "additionalProperties": false + "additionalProperties": true }, { "title": "AccountIdentityChangeBlocked", @@ -162,7 +162,7 @@ "impacts", "blockers" ], - "additionalProperties": false + "additionalProperties": true } ] } diff --git a/static/schemas/source/core/account-identity-change.json b/static/schemas/source/core/account-identity-change.json index e4c1b8ab0a0..923290a7316 100644 --- a/static/schemas/source/core/account-identity-change.json +++ b/static/schemas/source/core/account-identity-change.json @@ -7,6 +7,7 @@ "description": "Deprecated in 3.3, planned for removal in 4.0. A requested operator-identity change that has not been applied. The account's top-level operator and operator_unit remain canonical until this object disappears after approval and the canonical fields advance. Rejected changes remain visible until replaced by a later request so buyers polling list_accounts can observe the outcome.", "oneOf": [ { + "description": "A pending change rejects `reason`: only a rejected change carries one.", "title": "AccountIdentityChangePending", "type": "object", "properties": { @@ -29,7 +30,8 @@ "status", "requested_operator_identity" ], - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["reason"] } }, { "title": "AccountIdentityChangeRejected", @@ -61,7 +63,7 @@ "requested_operator_identity", "reason" ], - "additionalProperties": false + "additionalProperties": true } ] } diff --git a/static/schemas/source/core/account-ref.json b/static/schemas/source/core/account-ref.json index c6c62bd6d40..df97830dd27 100644 --- a/static/schemas/source/core/account-ref.json +++ b/static/schemas/source/core/account-ref.json @@ -2,7 +2,7 @@ "$schema": "http://json-schema.org/draft-07/schema#", "$id": "/schemas/core/account-ref.json", "title": "Account Reference", - "description": "Reference to an advertiser account by seller-assigned account_id or by natural key. An account's identity is its account_id, which the seller issues when the account opens and never changes. The natural key is brand + operator, the account's parties; its optional brand.countries, operator_unit.id, currency, timezone, and sandbox fields are account attributes that act as lookup filters. Each supplied attribute must equal the account's value: countries compares as a set and operator_unit compares by id. An omitted attribute does not filter, except sandbox, which defaults to false. A natural key resolves only when exactly one of the caller's accounts matches it; when several match, the seller returns ACCOUNT_AMBIGUOUS. operator_unit identifies the operator-owned buying seat or business unit and is distinct from the seller account. Sending the natural key as the reference on account-scoped tasks after the account opens is deprecated as of 3.3 and planned for removal in 4.0; it stays valid throughout 3.x, and the natural key stays valid as a list_accounts filter. After the account opens, buyers send account_id.", + "description": "Reference to an advertiser account by seller-assigned account_id or by natural key. An account's identity is its account_id, which the seller issues when the account opens and never changes. The natural key is brand + operator, the account's parties; its optional brand.countries, operator_unit.id, currency, timezone, and sandbox fields are account attributes that act as lookup filters. Each supplied attribute must equal the account's value: countries compares as a set and operator_unit compares by id. An omitted attribute does not filter, except sandbox, which defaults to false. A natural key resolves only when exactly one of the caller's accounts matches it; when several match, the seller returns ACCOUNT_AMBIGUOUS. operator_unit identifies the operator-owned buying seat or business unit and is distinct from the seller account. Sending the natural key as the reference on account-scoped tasks after the account opens is deprecated as of 3.3 and planned for removal in 4.0; it stays valid throughout 3.x, and the natural key stays valid as a list_accounts filter. After the account opens, buyers send account_id. The two forms exclude each other: the account_id form rejects the natural-key fields (`brand`, `operator`, `operator_unit`, `currency`, `timezone`, `sandbox`), and the natural-key form rejects `account_id`.", "type": "object", "oneOf": [ { @@ -14,7 +14,8 @@ } }, "required": ["account_id"], - "additionalProperties": false + "not": { "anyOf": [{ "required": ["brand"] }, { "required": ["operator"] }, { "required": ["operator_unit"] }, { "required": ["currency"] }, { "required": ["timezone"] }, { "required": ["sandbox"] }] }, + "additionalProperties": true }, { "properties": { @@ -49,7 +50,8 @@ } }, "required": ["brand", "operator"], - "additionalProperties": false + "not": { "required": ["account_id"] }, + "additionalProperties": true } ], "examples": [ diff --git a/static/schemas/source/core/account-request-changed-webhook.json b/static/schemas/source/core/account-request-changed-webhook.json index 4e24a96a941..a443894fb85 100644 --- a/static/schemas/source/core/account-request-changed-webhook.json +++ b/static/schemas/source/core/account-request-changed-webhook.json @@ -65,7 +65,7 @@ "ext": { "$ref": "/schemas/core/ext.json" } }, "required": ["idempotency_key", "notification_id", "notification_type", "fired_at", "subscriber_id", "agent_url", "request_id", "state", "changed_at"], - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "description": "Seller review finished and matched an existing account", diff --git a/static/schemas/source/core/account-status-changed-webhook.json b/static/schemas/source/core/account-status-changed-webhook.json index 4204e8e85ee..79e5cb28c4c 100644 --- a/static/schemas/source/core/account-status-changed-webhook.json +++ b/static/schemas/source/core/account-status-changed-webhook.json @@ -80,7 +80,7 @@ }, "setup": { "type": "object", - "description": "Reduced setup hint when the new status requires human action. This block intentionally omits setup.url; receivers fetch the current setup URL from list_accounts if the caller is authorized to see it.", + "description": "Reduced setup hint when the new status requires human action. This block intentionally omits setup.url; receivers fetch the current setup URL from list_accounts if the caller is authorized to see it. Rejects `url`, so a setup link is never fanned out to every subscriber of this webhook.", "properties": { "message": { "type": "string", @@ -95,7 +95,8 @@ "required": [ "message" ], - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["url"] } }, "ext": { "$ref": "/schemas/core/ext.json" @@ -113,7 +114,7 @@ "observed_at", "reason_code" ], - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "description": "Account requires payment action", diff --git a/static/schemas/source/core/account-timezone-capability.json b/static/schemas/source/core/account-timezone-capability.json index 93c60e7acbd..6dbf3a4e2d4 100644 --- a/static/schemas/source/core/account-timezone-capability.json +++ b/static/schemas/source/core/account-timezone-capability.json @@ -76,5 +76,5 @@ "then": { "not": { "required": ["supported_timezones"] } } } ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/account.json b/static/schemas/source/core/account.json index a8b8e83f689..7b6abd5e784 100644 --- a/static/schemas/source/core/account.json +++ b/static/schemas/source/core/account.json @@ -154,7 +154,7 @@ "required": [ "url" ], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1, "maxItems": 1 @@ -237,7 +237,7 @@ "bucket", "file_retention_days" ], - "additionalProperties": false + "additionalProperties": true }, "sandbox": { "type": "boolean", diff --git a/static/schemas/source/core/agent-encryption-key.json b/static/schemas/source/core/agent-encryption-key.json index 880bd5088c9..2daf3bbafd4 100644 --- a/static/schemas/source/core/agent-encryption-key.json +++ b/static/schemas/source/core/agent-encryption-key.json @@ -37,5 +37,5 @@ "use", "x" ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/agent-notification-config-state.json b/static/schemas/source/core/agent-notification-config-state.json index 15c33826a51..90cde1fe170 100644 --- a/static/schemas/source/core/agent-notification-config-state.json +++ b/static/schemas/source/core/agent-notification-config-state.json @@ -48,6 +48,7 @@ "description": "Echoed from the desired configuration when set." }, "authentication": { + "description": "Rejects `credentials`: credentials are write-only and never read back.", "type": "object", "deprecated": true, "properties": { @@ -63,7 +64,8 @@ "required": [ "schemes" ], - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["credentials"] } }, "active": { "type": "boolean", @@ -78,5 +80,5 @@ "url", "event_types" ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/agent-notification-config.json b/static/schemas/source/core/agent-notification-config.json index 59d4f48ea69..5a611302d88 100644 --- a/static/schemas/source/core/agent-notification-config.json +++ b/static/schemas/source/core/agent-notification-config.json @@ -74,7 +74,7 @@ "required": [ "schemes" ], - "additionalProperties": false + "additionalProperties": true }, "signing_profile": { "x-status": "experimental", @@ -137,7 +137,7 @@ "required": ["all_authorized_accounts"] }, "not": { "required": ["authentication", "signing_profile"] }, - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "description": "Registry subscriber receiving capability-change invalidations", diff --git a/static/schemas/source/core/agent-reporting-destination-state.json b/static/schemas/source/core/agent-reporting-destination-state.json index c5d0c2ae941..5bc5b892b3f 100644 --- a/static/schemas/source/core/agent-reporting-destination-state.json +++ b/static/schemas/source/core/agent-reporting-destination-state.json @@ -154,5 +154,5 @@ } } ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/agent-webhook-challenge.json b/static/schemas/source/core/agent-webhook-challenge.json index 6bc365866d1..c0596fb1bd0 100644 --- a/static/schemas/source/core/agent-webhook-challenge.json +++ b/static/schemas/source/core/agent-webhook-challenge.json @@ -99,7 +99,7 @@ } } ], - "additionalProperties": false + "additionalProperties": true }, "event_types": { "type": "array", @@ -123,7 +123,7 @@ "delivery_auth", "event_types" ], - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "description": "Agent-level endpoint proof-of-control challenge", diff --git a/static/schemas/source/core/assets/display-tag-asset.json b/static/schemas/source/core/assets/display-tag-asset.json index ec0cddcc0d9..01dc86b7fbd 100644 --- a/static/schemas/source/core/assets/display-tag-asset.json +++ b/static/schemas/source/core/assets/display-tag-asset.json @@ -33,13 +33,15 @@ "type": "array", "minItems": 1, "items": { + "description": "Rejects `unit`: sizes are in pixels, and a unit would change what they mean.", "type": "object", "required": ["width", "height"], "properties": { "width": { "type": "integer", "minimum": 1 }, "height": { "type": "integer", "minimum": 1 } }, - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["unit"] } }, "description": "Selectable entry-canvas sizes in logical pixels at which the same representation can render, rather than placement constraints or expanded states. Mutually exclusive with width/height. Omit all size fields for an unsized or responsive asset; absence does not establish compatibility with a size-constrained option." }, diff --git a/static/schemas/source/core/assets/html-asset.json b/static/schemas/source/core/assets/html-asset.json index 942d6e63ee4..b2b2f494813 100644 --- a/static/schemas/source/core/assets/html-asset.json +++ b/static/schemas/source/core/assets/html-asset.json @@ -58,13 +58,15 @@ "type": "array", "minItems": 1, "items": { + "description": "Rejects `unit`: sizes are in pixels, and a unit would change what they mean.", "type": "object", "required": ["width", "height"], "properties": { "width": { "type": "integer", "minimum": 1 }, "height": { "type": "integer", "minimum": 1 } }, - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["unit"] } }, "description": "Selectable entry-canvas sizes in logical pixels at which the same representation can render, rather than placement constraints or expanded states. Mutually exclusive with width/height. Omit all size fields for an unsized or responsive asset; absence does not establish compatibility with a size-constrained option." }, diff --git a/static/schemas/source/core/assets/zip-asset.json b/static/schemas/source/core/assets/zip-asset.json index 2b7927572f8..faccd8152cf 100644 --- a/static/schemas/source/core/assets/zip-asset.json +++ b/static/schemas/source/core/assets/zip-asset.json @@ -79,13 +79,15 @@ "type": "array", "minItems": 1, "items": { + "description": "Rejects `unit`: sizes are in pixels, and a unit would change what they mean.", "type": "object", "required": ["width", "height"], "properties": { "width": { "type": "integer", "minimum": 1 }, "height": { "type": "integer", "minimum": 1 } }, - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["unit"] } }, "description": "Selectable entry-canvas sizes in logical pixels at which the same representation can render, rather than placement constraints or expanded states. Mutually exclusive with width/height. Omit all size fields for an unsized or responsive asset; absence does not establish compatibility with a size-constrained option." }, diff --git a/static/schemas/source/core/attestation-capabilities.json b/static/schemas/source/core/attestation-capabilities.json index 495eebbeaf0..2077306ba1c 100644 --- a/static/schemas/source/core/attestation-capabilities.json +++ b/static/schemas/source/core/attestation-capabilities.json @@ -105,7 +105,7 @@ } }, "required": ["resolver_id", "url", "authentication"], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1, "x-max-items-4.0": 8 @@ -115,7 +115,7 @@ } }, "required": ["issuer"], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1, "x-max-items-4.0": 32 @@ -156,7 +156,7 @@ } }, "required": ["agent_url"], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1, "x-max-items-4.0": 16 @@ -194,7 +194,7 @@ } } ], - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "accepted_claim_types": [ diff --git a/static/schemas/source/core/attestation-evaluation.json b/static/schemas/source/core/attestation-evaluation.json index eff7be47977..521eeaf71cf 100644 --- a/static/schemas/source/core/attestation-evaluation.json +++ b/static/schemas/source/core/attestation-evaluation.json @@ -111,7 +111,7 @@ "required": ["action_digest"] } ], - "additionalProperties": false + "additionalProperties": true }, "ext": { "$ref": "/schemas/core/ext.json" @@ -141,7 +141,7 @@ } } ], - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "reference_digest": "sha256:6a09e667bb67ae853c6ef372a54ff53a510e527fade682d1b05688c2b3e6c1f0", diff --git a/static/schemas/source/core/attestation-issuer.json b/static/schemas/source/core/attestation-issuer.json index fd3646adad7..795a1b4da51 100644 --- a/static/schemas/source/core/attestation-issuer.json +++ b/static/schemas/source/core/attestation-issuer.json @@ -24,7 +24,7 @@ } }, "required": ["type", "brand"], - "additionalProperties": false + "additionalProperties": true }, { "title": "AttestationAgentIssuer", @@ -46,7 +46,7 @@ } }, "required": ["type", "agent_url"], - "additionalProperties": false + "additionalProperties": true }, { "title": "AttestationOriginIssuer", @@ -68,7 +68,7 @@ } }, "required": ["type", "origin"], - "additionalProperties": false + "additionalProperties": true } ], "examples": [ diff --git a/static/schemas/source/core/attestation-reference.json b/static/schemas/source/core/attestation-reference.json index d659a67f053..88d12acacec 100644 --- a/static/schemas/source/core/attestation-reference.json +++ b/static/schemas/source/core/attestation-reference.json @@ -2,7 +2,7 @@ "$schema": "http://json-schema.org/draft-07/schema#", "$id": "/schemas/core/attestation-reference.json", "title": "Attestation Reference", - "description": "Portable, reference-first presentation of an independently issued claim. It identifies the claimed issuer, claim vocabulary, subject, and either a stable credential locator or an embedded credential. A presentation is a locator and claim hint, not proof or a trust decision. The evaluator remains verifier-of-record and MUST resolve or inspect the credential only under its published attestation capabilities and local trust policy.", + "description": "Portable, reference-first presentation of an independently issued claim. It identifies the claimed issuer, claim vocabulary, subject, and either a stable credential locator or an embedded credential. A presentation is a locator and claim hint, not proof or a trust decision. The evaluator remains verifier-of-record and MUST resolve or inspect the credential only under its published attestation capabilities and local trust policy. Rejects `decision` and `confidence`: a presenter can't supply an evaluator's outcome, which only attestation-evaluation records.", "type": "object", "properties": { "issuer": { @@ -41,7 +41,7 @@ } }, "required": ["type", "credential_uri"], - "additionalProperties": false + "additionalProperties": true }, { "title": "AttestationIssuerCredentialIdLocator", @@ -70,7 +70,7 @@ } }, "required": ["type", "credential_id", "resolver_id"], - "additionalProperties": false + "additionalProperties": true } ] }, @@ -93,7 +93,7 @@ } }, "required": ["format", "value"], - "additionalProperties": false + "additionalProperties": true }, "content_digest": { "type": "string", @@ -119,7 +119,7 @@ "format": "date-time" } }, - "additionalProperties": false, + "additionalProperties": true, "minProperties": 1 }, "verify_agent": { @@ -133,7 +133,7 @@ } }, "required": ["agent_url"], - "additionalProperties": false + "additionalProperties": true }, "ext": { "$ref": "/schemas/core/ext.json" @@ -158,7 +158,8 @@ } } ], - "additionalProperties": false, + "additionalProperties": true, + "not": { "anyOf": [{ "required": ["decision"] }, { "required": ["confidence"] }] }, "examples": [ { "issuer": { diff --git a/static/schemas/source/core/attestation-subject.json b/static/schemas/source/core/attestation-subject.json index d7d945baf3c..5884727136d 100644 --- a/static/schemas/source/core/attestation-subject.json +++ b/static/schemas/source/core/attestation-subject.json @@ -23,7 +23,7 @@ } }, "required": ["type", "brand"], - "additionalProperties": false + "additionalProperties": true }, { "title": "AttestationAgentSubject", @@ -44,7 +44,7 @@ } }, "required": ["type", "agent_url"], - "additionalProperties": false + "additionalProperties": true }, { "title": "AttestationResourceSubject", @@ -80,7 +80,7 @@ } }, "required": ["type", "resource_type", "namespace", "id"], - "additionalProperties": false + "additionalProperties": true } ], "examples": [ diff --git a/static/schemas/source/core/audience-activation-method.json b/static/schemas/source/core/audience-activation-method.json index eda4d670cae..cebb7700e1c 100644 --- a/static/schemas/source/core/audience-activation-method.json +++ b/static/schemas/source/core/audience-activation-method.json @@ -14,7 +14,7 @@ "pattern": { "type": "string", "const": "sync_audiences" } }, "required": ["pattern"], - "additionalProperties": false + "additionalProperties": true }, { "title": "TMP identity match", @@ -32,11 +32,11 @@ } }, "required": ["agent_url"], - "additionalProperties": false + "additionalProperties": true } }, "required": ["pattern", "buyer_agent"], - "additionalProperties": false + "additionalProperties": true }, { "title": "File transfer", @@ -64,7 +64,7 @@ } }, "required": ["pattern", "transport", "vendor"], - "additionalProperties": false + "additionalProperties": true }, { "title": "Dataset query", @@ -104,14 +104,14 @@ "cloud": ["region"], "region": ["cloud"] }, - "additionalProperties": false + "additionalProperties": true }, "minItems": 1, "maxItems": 32 } }, "required": ["pattern", "vendor"], - "additionalProperties": false + "additionalProperties": true }, { "title": "Clean room", @@ -125,7 +125,7 @@ } }, "required": ["pattern", "vendor"], - "additionalProperties": false + "additionalProperties": true }, { "title": "Platform distribution", @@ -150,7 +150,7 @@ } }, "required": ["pattern", "vendor"], - "additionalProperties": false + "additionalProperties": true } ], "examples": [ diff --git a/static/schemas/source/core/audience-characteristic.json b/static/schemas/source/core/audience-characteristic.json index 957e97aa87c..9ff1eed8b97 100644 --- a/static/schemas/source/core/audience-characteristic.json +++ b/static/schemas/source/core/audience-characteristic.json @@ -41,7 +41,7 @@ "max": { "type": "number" } }, "minProperties": 1, - "additionalProperties": false + "additionalProperties": true }, "taxonomy": { "type": "object", @@ -52,7 +52,7 @@ "value_id": { "type": "string", "minLength": 1 } }, "required": ["system"], - "additionalProperties": false + "additionalProperties": true }, "label": { "type": "string", @@ -90,11 +90,11 @@ "max": { "type": "integer", "minimum": 0 } }, "minProperties": 1, - "additionalProperties": false + "additionalProperties": true } } } } ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/audience-evidence-pin.json b/static/schemas/source/core/audience-evidence-pin.json index faf58f0ae5c..5c5b89c4d53 100644 --- a/static/schemas/source/core/audience-evidence-pin.json +++ b/static/schemas/source/core/audience-evidence-pin.json @@ -20,5 +20,5 @@ "ext": { "$ref": "/schemas/core/ext.json" } }, "required": ["evidence_id", "snapshot_id", "version", "content_digest"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/audience-evidence-requirements.json b/static/schemas/source/core/audience-evidence-requirements.json index 621a659d795..1458ff304ff 100644 --- a/static/schemas/source/core/audience-evidence-requirements.json +++ b/static/schemas/source/core/audience-evidence-requirements.json @@ -111,5 +111,5 @@ "then": { "required": ["accepted_attestation_issuers"] } } ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/audience-evidence-selection.json b/static/schemas/source/core/audience-evidence-selection.json index eaca2037cfe..b142ca80573 100644 --- a/static/schemas/source/core/audience-evidence-selection.json +++ b/static/schemas/source/core/audience-evidence-selection.json @@ -54,7 +54,7 @@ } }, "required": ["action_type", "action_id", "action_digest"], - "additionalProperties": false + "additionalProperties": true } }, "required": ["action_binding"] @@ -63,7 +63,7 @@ } }, "required": ["reference", "evaluation"], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1, "maxItems": 10 @@ -71,5 +71,5 @@ "ext": { "$ref": "/schemas/core/ext.json" } }, "required": ["evidence_id", "snapshot_id", "version", "content_digest", "decision_use"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/audience-evidence-target.json b/static/schemas/source/core/audience-evidence-target.json index 718db9983a1..2fb26c43680 100644 --- a/static/schemas/source/core/audience-evidence-target.json +++ b/static/schemas/source/core/audience-evidence-target.json @@ -33,5 +33,5 @@ "then": { "properties": { "minimum_value": { "type": "integer" } } } } ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/audience-evidence.json b/static/schemas/source/core/audience-evidence.json index 5dbd1422585..3ebde8bfe19 100644 --- a/static/schemas/source/core/audience-evidence.json +++ b/static/schemas/source/core/audience-evidence.json @@ -55,7 +55,7 @@ "description": { "type": "string" } }, "required": ["system", "population_id", "version"], - "additionalProperties": false + "additionalProperties": true }, "evidence_type": { "type": "string", @@ -147,5 +147,5 @@ "then": { "properties": { "unit": { "const": "count" }, "value": { "type": "integer" } } } } ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/audience-source.json b/static/schemas/source/core/audience-source.json index 672086833cd..5c337e8db68 100644 --- a/static/schemas/source/core/audience-source.json +++ b/static/schemas/source/core/audience-source.json @@ -3,7 +3,7 @@ "$id": "/schemas/core/audience-source.json", "title": "Audience Source", "x-status": "experimental", - "description": "External source reference for an audience: a pointer to buyer data that the seller ingests over a declared activation rail, instead of inline member deltas. The data never transits AdCP — the protocol carries the reference; ingestion happens on the vendor's rails. kind discriminates the entry. A buyer MUST only send a source kind whose corresponding activation pattern (dataset_query for dataset, platform_distribution for platform_segment) the seller has declared via audience_activation; sellers reject undeclared kinds with UNSUPPORTED_FEATURE. References are never credentials: grant-based paths are in-protocol only when the vendor flow is grantee-identified (the grant names a principal; no secret is conveyed), and requests carrying credential material are rejected with CREDENTIAL_IN_ARGS. Experimental (x-status: experimental): part of the media_buy.audience_activation surface — sellers implementing external sources MUST list media_buy.audience_activation in experimental_features. Per docs/reference/experimental-status, this surface MAY change between 3.x releases with notice.", + "description": "External source reference for an audience: a pointer to buyer data that the seller ingests over a declared activation rail, instead of inline member deltas. The data never transits AdCP — the protocol carries the reference; ingestion happens on the vendor's rails. kind discriminates the entry. A buyer MUST only send a source kind whose corresponding activation pattern (dataset_query for dataset, platform_distribution for platform_segment) the seller has declared via audience_activation; sellers reject undeclared kinds with UNSUPPORTED_FEATURE. References are never credentials: grant-based paths are in-protocol only when the vendor flow is grantee-identified (the grant names a principal; no secret is conveyed), and requests carrying credential material are rejected with CREDENTIAL_IN_ARGS. Experimental (x-status: experimental): part of the media_buy.audience_activation surface — sellers implementing external sources MUST list media_buy.audience_activation in experimental_features. Per docs/reference/experimental-status, this surface MAY change between 3.x releases with notice. Each kind rejects the fields only the other defines: a dataset source rejects `segment_ref`, and a platform segment rejects `locator` and `access_expires_at`.", "type": "object", "oneOf": [ { @@ -29,7 +29,8 @@ } }, "required": ["kind", "vendor", "locator"], - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["segment_ref"] } }, { "title": "Platform segment", @@ -49,7 +50,8 @@ } }, "required": ["kind", "vendor", "segment_ref"], - "additionalProperties": false + "additionalProperties": true, + "not": { "anyOf": [{ "required": ["locator"] }, { "required": ["access_expires_at"] }] } } ], "examples": [ diff --git a/static/schemas/source/core/bidding-policy-capability.json b/static/schemas/source/core/bidding-policy-capability.json index 0445a73aeba..016ee9d843a 100644 --- a/static/schemas/source/core/bidding-policy-capability.json +++ b/static/schemas/source/core/bidding-policy-capability.json @@ -16,11 +16,11 @@ } }, "minProperties": 1, - "additionalProperties": false, + "additionalProperties": true, "definitions": { "scope_capability": { "type": "object", - "description": "Support at one authored scope, partitioned by the media buy's resulting allocation mode. Omitted contexts are unsupported; claims in one context make no claim about the other.", + "description": "Support at one authored scope, partitioned by the media buy's resulting allocation mode. Omitted contexts are unsupported; claims in one context make no claim about the other. Rejects `modes`, `cost_per_strengths`, `roas_strengths` and `supported_combinations`, which belong to policy_profile one level down.", "properties": { "fixed": { "$ref": "#/definitions/policy_profile", @@ -32,7 +32,15 @@ } }, "minProperties": 1, - "additionalProperties": false + "additionalProperties": true, + "not": { + "anyOf": [ + { "required": ["modes"] }, + { "required": ["cost_per_strengths"] }, + { "required": ["roas_strengths"] }, + { "required": ["supported_combinations"] } + ] + } }, "policy_profile": { "type": "object", @@ -102,7 +110,7 @@ "else": { "not": { "required": ["roas_strengths"] } } } ], - "additionalProperties": false + "additionalProperties": true }, "max_bid_with_cost_per": { "type": "object", @@ -117,7 +125,7 @@ } }, "required": ["kind", "cost_per_strengths"], - "additionalProperties": false + "additionalProperties": true }, "max_bid_with_roas": { "type": "object", @@ -132,7 +140,7 @@ } }, "required": ["kind", "roas_strengths"], - "additionalProperties": false + "additionalProperties": true } } } diff --git a/static/schemas/source/core/brand-key.json b/static/schemas/source/core/brand-key.json index 5bb3bd08739..3247e059196 100644 --- a/static/schemas/source/core/brand-key.json +++ b/static/schemas/source/core/brand-key.json @@ -26,5 +26,5 @@ } }, "required": ["domain"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/brand-ref.json b/static/schemas/source/core/brand-ref.json index 4f81f71c1fe..46d235ee3c0 100644 --- a/static/schemas/source/core/brand-ref.json +++ b/static/schemas/source/core/brand-ref.json @@ -44,7 +44,7 @@ { "required": ["url"] }, { "required": ["email"] } ], - "additionalProperties": false + "additionalProperties": true }, "brand_kit_override": { "type": "object", @@ -79,7 +79,7 @@ } }, "required": ["domain"], - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "domain": "nova-brands.com", diff --git a/static/schemas/source/core/brand-response-authorization-result.json b/static/schemas/source/core/brand-response-authorization-result.json index 23e6774a1af..979ed5a311d 100644 --- a/static/schemas/source/core/brand-response-authorization-result.json +++ b/static/schemas/source/core/brand-response-authorization-result.json @@ -48,5 +48,5 @@ "required": ["trust", "reason"] } ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/budget-allocation.json b/static/schemas/source/core/budget-allocation.json index cf2f422b459..0b05b054a08 100644 --- a/static/schemas/source/core/budget-allocation.json +++ b/static/schemas/source/core/budget-allocation.json @@ -20,7 +20,7 @@ "required": [ "mode" ], - "additionalProperties": false + "additionalProperties": true }, { "type": "object", @@ -58,7 +58,7 @@ "mode", "optimization_goals" ], - "additionalProperties": false + "additionalProperties": true } ] } diff --git a/static/schemas/source/core/business-calendar.json b/static/schemas/source/core/business-calendar.json index de157bef2d2..ef87f17f451 100644 --- a/static/schemas/source/core/business-calendar.json +++ b/static/schemas/source/core/business-calendar.json @@ -25,14 +25,14 @@ "end_time": { "type": "string", "pattern": "^(?:(?:[01][0-9]|2[0-3]):[0-5][0-9]|24:00)$" } }, "required": ["days", "start_time", "end_time"], - "additionalProperties": false + "additionalProperties": true }, "maxItems": 14 }, "non_working_dates": { "type": "array", "uniqueItems": true, "items": { "type": "string", "format": "date" }, "description": "Complete list of local non-working dates within coverage, overriding weekly periods. An empty list explicitly means no additional closures in that interval.", "maxItems": 1024 } }, "required": ["calendar_id", "timezone", "valid_from", "valid_through", "business_day_minutes", "working_periods", "non_working_dates"], - "additionalProperties": false, + "additionalProperties": true, "x-adcp-validation": { "verifier_constraints": { "calendar_integrity": "valid_from <= valid_through; working periods have start < end and never overlap on a shared weekday; all non_working_dates are within coverage; timezone resolves in IANA TZDB; calendar_id is immutable and unique within the seller." diff --git a/static/schemas/source/core/business-entity.json b/static/schemas/source/core/business-entity.json index 006058632df..7698c8dd44f 100644 --- a/static/schemas/source/core/business-entity.json +++ b/static/schemas/source/core/business-entity.json @@ -54,7 +54,7 @@ } }, "required": ["street", "city", "postal_code", "country"], - "additionalProperties": false + "additionalProperties": true }, "contacts": { "type": "array", @@ -89,7 +89,7 @@ } }, "required": ["role"], - "additionalProperties": false + "additionalProperties": true }, "maxItems": 10 }, @@ -125,14 +125,14 @@ } }, "required": ["account_holder"], - "additionalProperties": false + "additionalProperties": true }, "ext": { "$ref": "/schemas/core/ext.json" } }, "required": ["legal_name"], - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "description": "German agency with full B2B details", diff --git a/static/schemas/source/core/canonical-account-ref.json b/static/schemas/source/core/canonical-account-ref.json index db13cb2ff17..25d4a82fc90 100644 --- a/static/schemas/source/core/canonical-account-ref.json +++ b/static/schemas/source/core/canonical-account-ref.json @@ -2,7 +2,7 @@ "$schema": "http://json-schema.org/draft-07/schema#", "$id": "/schemas/core/canonical-account-ref.json", "title": "Canonical Account Reference", - "description": "Compact advertiser-account reference for canonical 3.2 tools. Uses either the seller/storefront account_id, which is the account's identity, or the buyer-declared natural key without BrandRef inline overrides. The natural key is brand + operator; its optional brand.countries, operator_unit.id, currency, timezone, and sandbox fields are account attributes that act as lookup filters, matched as in account-ref.json. A natural key resolves only when exactly one of the caller's accounts matches; otherwise the seller returns ACCOUNT_AMBIGUOUS. brand.countries does not target delivery; operator_unit.name is display metadata and never filters.", + "description": "Compact advertiser-account reference for canonical 3.2 tools. Uses either the seller/storefront account_id, which is the account's identity, or the buyer-declared natural key without BrandRef inline overrides. The natural key is brand + operator; its optional brand.countries, operator_unit.id, currency, timezone, and sandbox fields are account attributes that act as lookup filters, matched as in account-ref.json. A natural key resolves only when exactly one of the caller's accounts matches; otherwise the seller returns ACCOUNT_AMBIGUOUS. brand.countries does not target delivery; operator_unit.name is display metadata and never filters. The two forms exclude each other: the account_id form rejects the natural-key fields (`brand`, `operator`, `operator_unit`, `currency`, `timezone`, `sandbox`), and the natural-key form rejects `account_id`.", "type": "object", "anyOf": [ { @@ -14,7 +14,8 @@ } }, "required": ["account_id"], - "additionalProperties": false + "not": { "anyOf": [{ "required": ["brand"] }, { "required": ["operator"] }, { "required": ["operator_unit"] }, { "required": ["currency"] }, { "required": ["timezone"] }, { "required": ["sandbox"] }] }, + "additionalProperties": true }, { "properties": { @@ -46,7 +47,8 @@ } }, "required": ["brand", "operator"], - "additionalProperties": false + "not": { "required": ["account_id"] }, + "additionalProperties": true } ], "examples": [ diff --git a/static/schemas/source/core/canonical-audience-evidence-selection.json b/static/schemas/source/core/canonical-audience-evidence-selection.json index b06e0e87dac..c53e0fcb593 100644 --- a/static/schemas/source/core/canonical-audience-evidence-selection.json +++ b/static/schemas/source/core/canonical-audience-evidence-selection.json @@ -15,5 +15,5 @@ "ext": { "$ref": "/schemas/core/ext.json" } }, "required": ["evidence_id", "snapshot_id", "version", "content_digest", "decision_use"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/canonical-audience-evidence.json b/static/schemas/source/core/canonical-audience-evidence.json index 11ec3159b9f..3d75fd940e5 100644 --- a/static/schemas/source/core/canonical-audience-evidence.json +++ b/static/schemas/source/core/canonical-audience-evidence.json @@ -22,7 +22,7 @@ "description": { "type": "string" } }, "required": ["system", "population_id", "version"], - "additionalProperties": false + "additionalProperties": true }, "evidence_type": { "type": "string", "enum": ["measured", "forecast", "seller_declared"] }, "methodology": { "$ref": "/schemas/enums/audience-evidence-methodology.json" }, @@ -49,5 +49,5 @@ { "if": { "properties": { "relationship": { "const": "index" } }, "required": ["relationship"] }, "then": { "properties": { "unit": { "const": "ratio" } } } }, { "if": { "properties": { "relationship": { "const": "reach_estimate" } }, "required": ["relationship"] }, "then": { "properties": { "unit": { "const": "count" }, "value": { "type": "integer" } } } } ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/canonical-delivery-forecast.json b/static/schemas/source/core/canonical-delivery-forecast.json index 52cfe301d83..99cf40ef1d0 100644 --- a/static/schemas/source/core/canonical-delivery-forecast.json +++ b/static/schemas/source/core/canonical-delivery-forecast.json @@ -22,5 +22,5 @@ "ext": { "$ref": "/schemas/core/ext.json" } }, "required": ["points", "method", "currency"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/canonical-forecast-point.json b/static/schemas/source/core/canonical-forecast-point.json index bc0100fc1a4..c2db6bf529f 100644 --- a/static/schemas/source/core/canonical-forecast-point.json +++ b/static/schemas/source/core/canonical-forecast-point.json @@ -31,7 +31,7 @@ "viewed_seconds": { "$ref": "/schemas/core/forecast-range.json" }, "standard": { "$ref": "/schemas/enums/viewability-standard.json" } }, - "additionalProperties": false, + "additionalProperties": true, "anyOf": [ { "not": { @@ -52,5 +52,5 @@ } }, "required": ["metrics"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/canonical-forecast-vendor-metric-value.json b/static/schemas/source/core/canonical-forecast-vendor-metric-value.json index 80192d1f847..2990b364826 100644 --- a/static/schemas/source/core/canonical-forecast-vendor-metric-value.json +++ b/static/schemas/source/core/canonical-forecast-vendor-metric-value.json @@ -13,5 +13,5 @@ "breakdown": { "type": "object", "additionalProperties": true } }, "required": ["vendor", "metric_id", "value"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/canonical-format-option.json b/static/schemas/source/core/canonical-format-option.json index 51e7290b92f..82a058e55d2 100644 --- a/static/schemas/source/core/canonical-format-option.json +++ b/static/schemas/source/core/canonical-format-option.json @@ -2,7 +2,7 @@ "$schema": "http://json-schema.org/draft-07/schema#", "$id": "/schemas/core/canonical-format-option.json", "title": "Canonical Format Option", - "description": "Compact canonical creative-format declaration. Legacy named-format links are intentionally absent; params are validated against the canonical schema selected by format_kind without inlining every format union into product discovery. Format-option processing metadata such as macro_resolution_capabilities stays at this object's top level and is not part of canonical params.", + "description": "Compact canonical creative-format declaration. Legacy named-format links are intentionally absent; params are validated against the canonical schema selected by format_kind without inlining every format union into product discovery. Format-option processing metadata such as macro_resolution_capabilities stays at this object's top level and is not part of canonical params. Rejects `v1_format_ref`, the legacy named-format link of product-format-declaration.", "type": "object", "properties": { "format_option_id": { "type": "string", "minLength": 1 }, @@ -72,5 +72,6 @@ } } }, - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["v1_format_ref"] } } diff --git a/static/schemas/source/core/canonical-installment.json b/static/schemas/source/core/canonical-installment.json index 8404a340953..2ef1bb915f7 100644 --- a/static/schemas/source/core/canonical-installment.json +++ b/static/schemas/source/core/canonical-installment.json @@ -3,7 +3,7 @@ "$id": "/schemas/core/canonical-installment.json", "title": "Canonical Installment", "x-added-in": "3.3.0", - "description": "Compact closed installment view for the AdCP compact product lifecycle — one episode, issue, event, rotation period, or creator slot within a collection. Identity is the tuple (collection_ref, installment_id), so both fields are required and the deprecated publisher-domain-free collection_id shorthand carried by the legacy get_products installment is absent. The parent collection's kind indicates how to interpret each installment. Installments inherit collection-level fields they don't override: content_rating defaults to the collection's baseline, guest_talent is additive to the collection's recurring talent, and topics add context beyond the collection's genre.", + "description": "Compact installment view for the AdCP compact product lifecycle — one episode, issue, event, rotation period, or creator slot within a collection. Identity is the tuple (collection_ref, installment_id), so both fields are required and the deprecated publisher-domain-free collection_id shorthand carried by the legacy get_products installment is absent. The parent collection's kind indicates how to interpret each installment. Installments inherit collection-level fields they don't override: content_rating defaults to the collection's baseline, guest_talent is additive to the collection's recurring talent, and topics add context beyond the collection's genre. Rejects `collection_id`, the deprecated shorthand; collection_ref identifies the collection.", "type": "object", "properties": { "installment_id": { @@ -94,10 +94,11 @@ } }, "required": ["installment_ref", "type"], - "additionalProperties": false + "additionalProperties": true }, "ext": { "$ref": "/schemas/core/ext.json" } }, "required": ["installment_id", "collection_ref"], - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["collection_id"] } } diff --git a/static/schemas/source/core/canonical-media-buy-action-fields.json b/static/schemas/source/core/canonical-media-buy-action-fields.json index 08128ef14db..03edbd8fb91 100644 --- a/static/schemas/source/core/canonical-media-buy-action-fields.json +++ b/static/schemas/source/core/canonical-media-buy-action-fields.json @@ -2,7 +2,7 @@ "$schema": "http://json-schema.org/draft-07/schema#", "$id": "/schemas/core/canonical-media-buy-action-fields.json", "title": "Canonical Media Buy Action Fields", - "description": "Shared closed field set for task-discriminated canonical MediaBuy actions.", + "description": "Shared field set for task-discriminated canonical MediaBuy actions.", "type": "object", "properties": { "task": { @@ -30,5 +30,5 @@ "then": { "properties": { "task": { "const": "sync_creatives" }, "action": { "enum": ["replace_creative", "update_creative_assignments"] } } } } ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/canonical-optimization-goal.json b/static/schemas/source/core/canonical-optimization-goal.json index 45183385cc8..4ea1b19701f 100644 --- a/static/schemas/source/core/canonical-optimization-goal.json +++ b/static/schemas/source/core/canonical-optimization-goal.json @@ -25,7 +25,7 @@ }, "required": ["window"], "anyOf": [{ "required": ["min"] }, { "required": ["max"] }], - "additionalProperties": false + "additionalProperties": true }, "view_duration_seconds": { "type": "number", "exclusiveMinimum": 0 }, "target": { @@ -35,7 +35,7 @@ "value": { "type": "number", "exclusiveMinimum": 0 } }, "required": ["kind", "value"], - "additionalProperties": false + "additionalProperties": true }, "priority": { "type": "integer", "minimum": 1 } }, @@ -53,7 +53,7 @@ "else": { "not": { "anyOf": [{ "required": ["standard"] }, { "required": ["vendor"] }] } } } ], - "additionalProperties": false + "additionalProperties": true }, { "type": "object", @@ -71,7 +71,7 @@ "value_factor": { "type": "number", "default": 1 } }, "required": ["event_source_id", "event_type"], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1 }, @@ -81,13 +81,13 @@ "kind": { "type": "string", "const": "maximize_value" } }, "required": ["kind"], - "additionalProperties": false + "additionalProperties": true }, "attribution_window": { "$ref": "/schemas/core/attribution-window.json" }, "priority": { "type": "integer", "minimum": 1 } }, "required": ["kind", "event_sources"], - "additionalProperties": false + "additionalProperties": true }, { "type": "object", @@ -102,12 +102,12 @@ "value": { "type": "number", "exclusiveMinimum": 0 } }, "required": ["kind", "value"], - "additionalProperties": false + "additionalProperties": true }, "priority": { "type": "integer", "minimum": 1 } }, "required": ["kind", "vendor", "metric_id"], - "additionalProperties": false + "additionalProperties": true } ] } diff --git a/static/schemas/source/core/canonical-placement.json b/static/schemas/source/core/canonical-placement.json index 74dceba7ce7..6b2bb3c9190 100644 --- a/static/schemas/source/core/canonical-placement.json +++ b/static/schemas/source/core/canonical-placement.json @@ -2,7 +2,7 @@ "$schema": "http://json-schema.org/draft-07/schema#", "$id": "/schemas/core/canonical-placement.json", "title": "Canonical Product Placement", - "description": "Compact product placement with canonical format narrowing. Publisher references carry their publisher authority. New seller-inline placements SHOULD carry seller_agent as their defining authority; legacy seller-inline placements without it remain valid in product context.", + "description": "Compact product placement with canonical format narrowing. Publisher references carry their publisher authority. New seller-inline placements SHOULD carry seller_agent as their defining authority; legacy seller-inline placements without it remain valid in product context. Rejects `format_ids`, the legacy placement format list; canonical placements reference format options.", "type": "object", "definitions": { "CanonicalDoohScreenResolution": { @@ -14,7 +14,7 @@ "height": { "type": "integer", "minimum": 1 } }, "required": ["width", "height"], - "additionalProperties": false + "additionalProperties": true }, "CanonicalDoohAddress": { "title": "Canonical DOOH Address", @@ -27,7 +27,7 @@ "postal_code": { "type": "string", "description": "Postal or ZIP code." }, "country": { "type": "string", "pattern": "^[A-Z]{2}$", "description": "ISO 3166-1 alpha-2 country code." } }, - "additionalProperties": false + "additionalProperties": true }, "CanonicalDoohLocation": { "title": "Canonical DOOH Location", @@ -48,7 +48,7 @@ }, "address": { "$ref": "#/definitions/CanonicalDoohAddress" } }, - "additionalProperties": false + "additionalProperties": true }, "CanonicalDoohPlacementAttributes": { "title": "Canonical DOOH Placement Attributes", @@ -139,5 +139,6 @@ "required": ["kind", "name"] } ], - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["format_ids"] } } diff --git a/static/schemas/source/core/canonical-product-action.json b/static/schemas/source/core/canonical-product-action.json index 1bb75f9a278..5021286a266 100644 --- a/static/schemas/source/core/canonical-product-action.json +++ b/static/schemas/source/core/canonical-product-action.json @@ -2,7 +2,7 @@ "$schema": "http://json-schema.org/draft-07/schema#", "$id": "/schemas/core/canonical-product-action.json", "title": "Canonical Product Action", - "description": "Fine-grained action template advertised on a compact product. The resulting MediaBuy exposes the authoritative routed task in available_actions.", + "description": "Fine-grained action template advertised on a compact product. The resulting MediaBuy exposes the authoritative routed task in available_actions. Rejects `review_sla`: a product's review commitment is creative_policy.review_sla.", "x-adcp-validation": { "verifier_constraints": { "constraint_action_compatibility": "The constraints.kind is compatible with action under change-term-constraints.json. Product constraints are advisory and a proposal must restate binding bounds." @@ -24,5 +24,6 @@ "then": { "properties": { "sla": { "$ref": "/schemas/core/escalation-sla.json" }, "modes": { "items": { "const": "seller_managed" } }, "constraints": false, "terms_ref": false } } } ], - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["review_sla"] } } diff --git a/static/schemas/source/core/canonical-product.json b/static/schemas/source/core/canonical-product.json index 59bf4aa1af1..79920c0c48e 100644 --- a/static/schemas/source/core/canonical-product.json +++ b/static/schemas/source/core/canonical-product.json @@ -123,7 +123,7 @@ "submitted_count": { "type": "integer", "minimum": 0 } }, "required": ["submitted_count"], - "additionalProperties": false + "additionalProperties": true }, "list_applications": { "type": "array", diff --git a/static/schemas/source/core/canonical-proposal.json b/static/schemas/source/core/canonical-proposal.json index 19328387b59..368bda74765 100644 --- a/static/schemas/source/core/canonical-proposal.json +++ b/static/schemas/source/core/canonical-proposal.json @@ -67,6 +67,7 @@ "x-added-in": "3.3.0", "description": "Experimental (media_buy.installment_holds). Readback of the specific installments this committed proposal's hold covers. It describes the one hold that finalize placed, not separate holds: every entry was placed by the same all-or-none finalize, shares hold_placed_at and this proposal's expires_at, and is accepted, extended, superseded, or lapses with the proposal as a whole. No task addresses an entry on its own, and there are no partial holds. Allowed only on a non-draft proposal whose hold_policy has available true; forbidden on drafts and on terms-only commitments. It is readback, not contract: commercial_terms stays authoritative. When present it lists every installment the hold covers, once per product_id and installment_ref; every product_id is a product in commercial_terms.purchases, and every installment is one that product includes, scheduled within that purchase's flight. Inventory that is not a specific installment, such as a run-of-collection product, is not listed. Entries carry no expires_at: this proposal's expires_at is the hold deadline for every entry, and it is already capped at the earliest booking_deadline or change_cutoff of the held installments. Under a rankable hold_policy (media_buy.hold_ranking), every entry carries hold_rank, and this proposal's hold_rank is no better than any entry's; it equals the worst entry's unless unlisted inventory is held at a worse position. The array lists only this proposal's own hold: sellers MUST NOT include or describe other buyers' holds on the same installments. A seller that lists media_buy.installment_holds MUST include holds on every committed proposal it returns to a caller at 3.3 or later that allocates a product declaring specific installments. Each extend_hold successor lists the same entries, at positions no worse than the source's. Omitted, with hold_policy, for callers below 3.3.", "items": { + "description": "Rejects `expires_at`: the proposal's expires_at covers every hold entry.", "type": "object", "properties": { "product_id": { @@ -86,7 +87,8 @@ } }, "required": ["product_id", "installment_ref"], - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["expires_at"] } } }, "name": { "type": "string", "minLength": 1, "maxLength": 500 }, @@ -110,7 +112,7 @@ }, "required": ["currency"], "anyOf": [{ "required": ["recommended"] }, { "required": ["min"] }, { "required": ["max"] }], - "additionalProperties": false + "additionalProperties": true }, "forecast": { "allOf": [{ "$ref": "/schemas/core/canonical-delivery-forecast.json" }], diff --git a/static/schemas/source/core/canonical-reporting-capabilities.json b/static/schemas/source/core/canonical-reporting-capabilities.json index da69838f2db..6dfb48c7cec 100644 --- a/static/schemas/source/core/canonical-reporting-capabilities.json +++ b/static/schemas/source/core/canonical-reporting-capabilities.json @@ -28,7 +28,7 @@ "metric_id": { "$ref": "/schemas/core/vendor-metric-id.json" } }, "required": ["vendor", "metric_id"], - "additionalProperties": false + "additionalProperties": true } }, "supports_creative_breakdown": { "type": "boolean" }, @@ -52,5 +52,5 @@ "measurement_windows": { "type": "array", "items": { "$ref": "/schemas/core/measurement-window.json" }, "minItems": 1, "uniqueItems": true } }, "required": ["available_reporting_frequencies", "expected_delay_minutes", "timezone", "supports_webhooks", "available_metrics", "date_range_support"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/capabilities-changed-webhook.json b/static/schemas/source/core/capabilities-changed-webhook.json index 9f389d88936..7f78cfb61f0 100644 --- a/static/schemas/source/core/capabilities-changed-webhook.json +++ b/static/schemas/source/core/capabilities-changed-webhook.json @@ -90,7 +90,7 @@ "reason", "capabilities_version" ], - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "description": "Seller enabled sandbox support", diff --git a/static/schemas/source/core/catalog-selection.json b/static/schemas/source/core/catalog-selection.json index 9073ad126b8..5d3cbe221ff 100644 --- a/static/schemas/source/core/catalog-selection.json +++ b/static/schemas/source/core/catalog-selection.json @@ -31,5 +31,5 @@ } }, "required": ["catalog_id"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/catchment.json b/static/schemas/source/core/catchment.json index a5c0f63eb3f..ff014dd38c8 100644 --- a/static/schemas/source/core/catchment.json +++ b/static/schemas/source/core/catchment.json @@ -27,7 +27,7 @@ } }, "required": ["value", "unit"], - "additionalProperties": false + "additionalProperties": true }, "transport_mode": { "$ref": "/schemas/enums/transport-mode.json", @@ -48,7 +48,7 @@ } }, "required": ["value", "unit"], - "additionalProperties": false + "additionalProperties": true }, "geometry": { "type": "object", @@ -65,7 +65,7 @@ } }, "required": ["type", "coordinates"], - "additionalProperties": false + "additionalProperties": true }, "ext": { "$ref": "/schemas/core/ext.json" diff --git a/static/schemas/source/core/collection-distribution.json b/static/schemas/source/core/collection-distribution.json index ef2638fd506..477484cc5cb 100644 --- a/static/schemas/source/core/collection-distribution.json +++ b/static/schemas/source/core/collection-distribution.json @@ -34,7 +34,7 @@ } }, "required": ["type", "value"], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1 }, diff --git a/static/schemas/source/core/collection-list-ref.json b/static/schemas/source/core/collection-list-ref.json index 7991fbe3a1d..01a632f44a9 100644 --- a/static/schemas/source/core/collection-list-ref.json +++ b/static/schemas/source/core/collection-list-ref.json @@ -22,5 +22,5 @@ } }, "required": ["agent_url", "list_id"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/collection-selection.json b/static/schemas/source/core/collection-selection.json index 372ea35e9d4..46b81d6e450 100644 --- a/static/schemas/source/core/collection-selection.json +++ b/static/schemas/source/core/collection-selection.json @@ -42,7 +42,7 @@ "mode", "collections" ], - "additionalProperties": false + "additionalProperties": true }, { "title": "Product default collections", @@ -59,7 +59,7 @@ "required": [ "mode" ], - "additionalProperties": false + "additionalProperties": true } ] } diff --git a/static/schemas/source/core/collection.json b/static/schemas/source/core/collection.json index 58ce569bc77..b177aa371f7 100644 --- a/static/schemas/source/core/collection.json +++ b/static/schemas/source/core/collection.json @@ -122,6 +122,7 @@ "type": "array", "description": "Relationships to other collections (spin-offs, companion collections, etc.). Each entry references another collection by collection_id within the same publisher's adagents.json.", "items": { + "description": "Rejects `publisher_domain`: a related collection is a local reference, not a cross-publisher declaration.", "type": "object", "properties": { "collection_id": { @@ -135,7 +136,8 @@ } }, "required": ["collection_id", "relationship"], - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["publisher_domain"] } } }, "ext": { diff --git a/static/schemas/source/core/committed-metric.json b/static/schemas/source/core/committed-metric.json index 2d27519b78a..a1dd3e113b6 100644 --- a/static/schemas/source/core/committed-metric.json +++ b/static/schemas/source/core/committed-metric.json @@ -21,7 +21,7 @@ }, "qualifier": { "type": "object", - "description": "Disambiguates metrics whose definition varies by qualifier. Today carries five keys — `viewability_standard` (MRC vs GroupM viewability), `completion_source` (seller- vs vendor-attested completion), `attribution_methodology` (how attribution was computed for outcome metrics), `attribution_window` (the time window over which outcomes were attributed), and `lift_dimension` (which dimension of brand_lift this row represents — awareness, consideration, etc.). Required when the underlying `metric_id` has multiple incompatible measurement paths AND the seller commits to a specific one. Symmetric on `missing_metrics`. Reserved for additive qualifiers in future minors — schema is closed (`additionalProperties: false`); new keys ship explicitly. **Heterogeneous value types**: qualifier values can be either string enums (`viewability_standard`, `completion_source`, `attribution_methodology`, `lift_dimension`) or structured objects (`attribution_window` is a duration `{interval, unit}`). Consumers MUST dispatch on key name to know value shape; structured-value qualifiers join on canonical (key-sorted) deep equality so `{interval: 14, unit: 'days'}` and `{unit: 'days', interval: 14}` resolve to the same partition. Rate-style metrics (`new_to_brand_rate`, `engagement_rate`, etc.) inherit the methodology of their numerator — when a rate carries `attribution_methodology` qualifier, it applies to the underlying conversions/events being rated.", + "description": "Disambiguates metrics whose definition varies by qualifier. Today carries five keys — `viewability_standard` (MRC vs GroupM viewability), `completion_source` (seller- vs vendor-attested completion), `attribution_methodology` (how attribution was computed for outcome metrics), `attribution_window` (the time window over which outcomes were attributed), and `lift_dimension` (which dimension of brand_lift this row represents — awareness, consideration, etc.). Required when the underlying `metric_id` has multiple incompatible measurement paths AND the seller commits to a specific one. Symmetric on `missing_metrics`. Closed (`additionalProperties: false`), because consumers join on the key set; new keys ship in a major release. **Heterogeneous value types**: qualifier values can be either string enums (`viewability_standard`, `completion_source`, `attribution_methodology`, `lift_dimension`) or structured objects (`attribution_window` is a duration `{interval, unit}`). Consumers MUST dispatch on key name to know value shape; structured-value qualifiers join on canonical (key-sorted) deep equality so `{interval: 14, unit: 'days'}` and `{unit: 'days', interval: 14}` resolve to the same partition. Rate-style metrics (`new_to_brand_rate`, `engagement_rate`, etc.) inherit the methodology of their numerator — when a rate carries `attribution_methodology` qualifier, it applies to the underlying conversions/events being rated.", "properties": { "viewability_standard": { "$ref": "/schemas/enums/viewability-standard.json", @@ -53,7 +53,7 @@ } }, "required": ["scope", "metric_id", "committed_at"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -76,7 +76,7 @@ }, "qualifier": { "type": "object", - "description": "Optional qualifier disambiguating commitments to the same vendor metric measured under different methodologies or windows. Same closed key set as standard-scope entries; new keys ship explicitly.", + "description": "Optional qualifier disambiguating commitments to the same vendor metric measured under different methodologies or windows. Same closed key set as standard-scope entries; new keys ship in a major release.", "properties": { "viewability_standard": { "$ref": "/schemas/enums/viewability-standard.json", @@ -108,7 +108,7 @@ } }, "required": ["scope", "vendor", "metric_id", "committed_at"], - "additionalProperties": false + "additionalProperties": true } ] } diff --git a/static/schemas/source/core/creative-approval-scope.json b/static/schemas/source/core/creative-approval-scope.json index d592c585410..4b04f932abc 100644 --- a/static/schemas/source/core/creative-approval-scope.json +++ b/static/schemas/source/core/creative-approval-scope.json @@ -45,5 +45,5 @@ } } ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/creative-policy.json b/static/schemas/source/core/creative-policy.json index 7844d23a6a0..4fa37526298 100644 --- a/static/schemas/source/core/creative-policy.json +++ b/static/schemas/source/core/creative-policy.json @@ -77,7 +77,7 @@ } }, "required": ["agent_url"], - "additionalProperties": false + "additionalProperties": true } } }, diff --git a/static/schemas/source/core/creative-variant.json b/static/schemas/source/core/creative-variant.json index 4110d8cf044..44796e9ab02 100644 --- a/static/schemas/source/core/creative-variant.json +++ b/static/schemas/source/core/creative-variant.json @@ -80,7 +80,7 @@ } }, "required": ["property_id", "artifact_id"], - "additionalProperties": false + "additionalProperties": true }, "ext": { "$ref": "/schemas/core/ext.json" diff --git a/static/schemas/source/core/daypart-target.json b/static/schemas/source/core/daypart-target.json index f9589d7b61c..ca58976135a 100644 --- a/static/schemas/source/core/daypart-target.json +++ b/static/schemas/source/core/daypart-target.json @@ -79,5 +79,5 @@ } } ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/delivery-metric-aggregate.json b/static/schemas/source/core/delivery-metric-aggregate.json index 7963dd3f525..fb881d63ca6 100644 --- a/static/schemas/source/core/delivery-metric-aggregate.json +++ b/static/schemas/source/core/delivery-metric-aggregate.json @@ -39,7 +39,7 @@ }, "qualifier": { "type": "object", - "description": "Qualifier keys disambiguating this row from sibling rows under the same `metric_id`. Symmetric with `committed_metrics.qualifier` today; expected to diverge in future minors as transparency disclosures buyers don't commit to ship delivery-only. Closed (`additionalProperties: false`) — new qualifier keys ship explicitly.", + "description": "Qualifier keys disambiguating this row from sibling rows under the same `metric_id`. Symmetric with `committed_metrics.qualifier` today; expected to diverge as transparency disclosures buyers don't commit to ship delivery-only. Closed (`additionalProperties: false`), because consumers join on the key set; new qualifier keys ship in a major release.", "properties": { "viewability_standard": { "$ref": "/schemas/enums/viewability-standard.json", @@ -114,7 +114,7 @@ "metric_id", "value" ], - "additionalProperties": false, + "additionalProperties": true, "allOf": [ { "if": { @@ -195,7 +195,7 @@ }, "qualifier": { "type": "object", - "description": "Optional qualifier keys disambiguating this vendor-metric row from sibling rows under the same (vendor, metric_id) — e.g., attribution_window on a vendor outcome metric. Same closed key set as the standard branch; new keys ship explicitly.", + "description": "Optional qualifier keys disambiguating this vendor-metric row from sibling rows under the same (vendor, metric_id) — e.g., attribution_window on a vendor outcome metric. Same closed key set as the standard branch; new keys ship in a major release.", "properties": { "viewability_standard": { "$ref": "/schemas/enums/viewability-standard.json", @@ -236,7 +236,7 @@ "metric_id", "value" ], - "additionalProperties": false + "additionalProperties": true } ] } diff --git a/static/schemas/source/core/delivery-metrics.json b/static/schemas/source/core/delivery-metrics.json index 02e48ccc1d9..24305017886 100644 --- a/static/schemas/source/core/delivery-metrics.json +++ b/static/schemas/source/core/delivery-metrics.json @@ -544,7 +544,7 @@ } }, "required": ["p25", "p50", "p75", "p90", "p95"], - "additionalProperties": false + "additionalProperties": true }, "viewed_seconds_histogram": { "type": "array", @@ -570,7 +570,7 @@ } }, "required": ["lower_bound_seconds", "impressions"], - "additionalProperties": false + "additionalProperties": true } }, "standard": { diff --git a/static/schemas/source/core/delivery-provider.json b/static/schemas/source/core/delivery-provider.json index 00011818bd0..0160394fec5 100644 --- a/static/schemas/source/core/delivery-provider.json +++ b/static/schemas/source/core/delivery-provider.json @@ -12,5 +12,5 @@ } }, "required": ["domain"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/delivery-recipient.json b/static/schemas/source/core/delivery-recipient.json index 734f2ef8257..242a5d3bc67 100644 --- a/static/schemas/source/core/delivery-recipient.json +++ b/static/schemas/source/core/delivery-recipient.json @@ -30,5 +30,5 @@ "cloud" ] }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/demographic-reporting-capability.json b/static/schemas/source/core/demographic-reporting-capability.json index 4e7d345a690..a6e01656b24 100644 --- a/static/schemas/source/core/demographic-reporting-capability.json +++ b/static/schemas/source/core/demographic-reporting-capability.json @@ -69,7 +69,7 @@ "then": { "required": ["demographic"] } } ], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1, "uniqueItems": true @@ -100,7 +100,7 @@ } } ], - "additionalProperties": false + "additionalProperties": true }, "demographic_systems": { "type": "array", @@ -121,5 +121,5 @@ { "required": ["age"] }, { "required": ["demographic_systems"] } ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/destination-item.json b/static/schemas/source/core/destination-item.json index af8d3220a66..5a71e22a46b 100644 --- a/static/schemas/source/core/destination-item.json +++ b/static/schemas/source/core/destination-item.json @@ -48,7 +48,7 @@ } }, "required": ["lat", "lng"], - "additionalProperties": false + "additionalProperties": true }, "destination_type": { "type": "string", diff --git a/static/schemas/source/core/destination.json b/static/schemas/source/core/destination.json index ed0656eac64..8a3cc46c694 100644 --- a/static/schemas/source/core/destination.json +++ b/static/schemas/source/core/destination.json @@ -69,7 +69,7 @@ "required": [ "pattern" ], - "additionalProperties": false, + "additionalProperties": true, "x-added-in": "3.3.0" } }, diff --git a/static/schemas/source/core/dooh-inventory-summary.json b/static/schemas/source/core/dooh-inventory-summary.json index 33f55cd4c00..d6a9e49438b 100644 --- a/static/schemas/source/core/dooh-inventory-summary.json +++ b/static/schemas/source/core/dooh-inventory-summary.json @@ -108,7 +108,7 @@ } } ], - "additionalProperties": false + "additionalProperties": true } }, "properties": { @@ -120,5 +120,5 @@ } }, "required": ["venue_counts"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/duration.json b/static/schemas/source/core/duration.json index 08deafd5e87..419691908f4 100644 --- a/static/schemas/source/core/duration.json +++ b/static/schemas/source/core/duration.json @@ -17,5 +17,5 @@ } }, "required": ["interval", "unit"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/error.json b/static/schemas/source/core/error.json index 8e4b7ef1739..e811f3e5325 100644 --- a/static/schemas/source/core/error.json +++ b/static/schemas/source/core/error.json @@ -101,7 +101,7 @@ } }, "required": ["property_name", "value"], - "additionalProperties": false + "additionalProperties": true }, "x-max-items-4.0": 8 } diff --git a/static/schemas/source/core/evaluator-spec.json b/static/schemas/source/core/evaluator-spec.json index 9f6b109e76e..c53aae1d57d 100644 --- a/static/schemas/source/core/evaluator-spec.json +++ b/static/schemas/source/core/evaluator-spec.json @@ -32,7 +32,7 @@ } }, "required": ["feature_id"], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1 }, @@ -52,7 +52,7 @@ } }, "required": ["agent_url"], - "additionalProperties": false + "additionalProperties": true }, "eval_budget": { "type": "object", diff --git a/static/schemas/source/core/feature-requirement.json b/static/schemas/source/core/feature-requirement.json index 6d906f79dd9..5f1f398c140 100644 --- a/static/schemas/source/core/feature-requirement.json +++ b/static/schemas/source/core/feature-requirement.json @@ -36,5 +36,5 @@ } }, "required": ["feature_id"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/flight-item.json b/static/schemas/source/core/flight-item.json index fd97ba9aff4..45a2b97763b 100644 --- a/static/schemas/source/core/flight-item.json +++ b/static/schemas/source/core/flight-item.json @@ -24,7 +24,7 @@ } }, "required": ["airport_code"], - "additionalProperties": false + "additionalProperties": true }, "destination": { "type": "object", @@ -41,7 +41,7 @@ } }, "required": ["airport_code"], - "additionalProperties": false + "additionalProperties": true }, "airline": { "type": "string", diff --git a/static/schemas/source/core/forecast-vendor-metric-value.json b/static/schemas/source/core/forecast-vendor-metric-value.json index 85066fb8621..79ffb90051c 100644 --- a/static/schemas/source/core/forecast-vendor-metric-value.json +++ b/static/schemas/source/core/forecast-vendor-metric-value.json @@ -41,7 +41,7 @@ } }, "required": ["vendor", "metric_id", "value"], - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "vendor": { "domain": "attentionvendor.example" }, diff --git a/static/schemas/source/core/frequency-cap-constraints.json b/static/schemas/source/core/frequency-cap-constraints.json index b89f2b526af..a8eeee1cdb8 100644 --- a/static/schemas/source/core/frequency-cap-constraints.json +++ b/static/schemas/source/core/frequency-cap-constraints.json @@ -56,7 +56,7 @@ { "required": ["window_constraints"] }, { "required": ["suppression_constraints"] } ], - "additionalProperties": false, + "additionalProperties": true, "x-adcp-validation": { "unique_window_units": "window_constraints MUST contain at most one entry for each unit.", "unique_suppression_units": "suppression_constraints MUST contain at most one entry for each unit." diff --git a/static/schemas/source/core/frequency-cap-impression-constraints.json b/static/schemas/source/core/frequency-cap-impression-constraints.json index 16868de5421..d1a46d8adfd 100644 --- a/static/schemas/source/core/frequency-cap-impression-constraints.json +++ b/static/schemas/source/core/frequency-cap-impression-constraints.json @@ -31,7 +31,7 @@ "not": { "required": ["allowed_values"] } } ], - "additionalProperties": false, + "additionalProperties": true, "x-adcp-validation": { "ordered_bounds": "minimum MUST be less than or equal to maximum." } diff --git a/static/schemas/source/core/frequency-cap-interval-constraints.json b/static/schemas/source/core/frequency-cap-interval-constraints.json index f0595374fc8..fec4a686025 100644 --- a/static/schemas/source/core/frequency-cap-interval-constraints.json +++ b/static/schemas/source/core/frequency-cap-interval-constraints.json @@ -47,7 +47,7 @@ } } }, - "additionalProperties": false, + "additionalProperties": true, "x-adcp-validation": { "ordered_bounds": "minimum_interval MUST be less than or equal to maximum_interval." } diff --git a/static/schemas/source/core/frequency-cap-requirements.json b/static/schemas/source/core/frequency-cap-requirements.json index 3ece862f6bc..f4cc20cec63 100644 --- a/static/schemas/source/core/frequency-cap-requirements.json +++ b/static/schemas/source/core/frequency-cap-requirements.json @@ -39,5 +39,5 @@ "uniqueItems": true } }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/geo-breakdown-support.json b/static/schemas/source/core/geo-breakdown-support.json index dc1a8ea4a2c..d5d24f11a2f 100644 --- a/static/schemas/source/core/geo-breakdown-support.json +++ b/static/schemas/source/core/geo-breakdown-support.json @@ -24,5 +24,5 @@ "$ref": "/schemas/core/postal-area-support.json" } }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/geo-metro.json b/static/schemas/source/core/geo-metro.json index 9bae5866176..1076b659983 100644 --- a/static/schemas/source/core/geo-metro.json +++ b/static/schemas/source/core/geo-metro.json @@ -17,5 +17,5 @@ } }, "required": ["system", "values"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/geo-place-area.json b/static/schemas/source/core/geo-place-area.json index e43eb2f372c..f99b62ebf22 100644 --- a/static/schemas/source/core/geo-place-area.json +++ b/static/schemas/source/core/geo-place-area.json @@ -68,5 +68,5 @@ } } ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/geo-place-catalog-capability.json b/static/schemas/source/core/geo-place-catalog-capability.json index d90f7f098de..0e6558263b4 100644 --- a/static/schemas/source/core/geo-place-catalog-capability.json +++ b/static/schemas/source/core/geo-place-catalog-capability.json @@ -30,7 +30,7 @@ } }, "required": ["current_version", "supported_versions", "resolver"], - "additionalProperties": false, + "additionalProperties": true, "x-adcp-validation": { "member_of": { "field": "current_version", "array_field": "supported_versions" }, "description": "JSON Schema draft-07 cannot express scalar membership in a sibling array; conformance tooling MUST verify current_version is present in supported_versions." diff --git a/static/schemas/source/core/geo-place-catalog-entry.json b/static/schemas/source/core/geo-place-catalog-entry.json index d307e6062c3..214ef899fe7 100644 --- a/static/schemas/source/core/geo-place-catalog-entry.json +++ b/static/schemas/source/core/geo-place-catalog-entry.json @@ -59,5 +59,5 @@ } }, "required": ["value", "country", "place_type", "label", "canonical_name", "parent_labels", "status"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/geo-place-requirement.json b/static/schemas/source/core/geo-place-requirement.json index f097d425c40..0ce24d6c461 100644 --- a/static/schemas/source/core/geo-place-requirement.json +++ b/static/schemas/source/core/geo-place-requirement.json @@ -2,7 +2,7 @@ "$schema": "http://json-schema.org/draft-07/schema#", "$id": "/schemas/core/geo-place-requirement.json", "title": "Geographic Place Requirement", - "description": "Identifier systems and collision-safe country/type pairs the buyer must be allowed to select later.", + "description": "Identifier systems and collision-safe country/type pairs the buyer must be allowed to select later. Rejects the seller limits `max_values_per_package` and `max_packages`, which only product support discloses.", "type": "object", "definitions": { "catalogRequirement": { @@ -29,7 +29,7 @@ } }, "required": ["countries"], - "additionalProperties": false + "additionalProperties": true } }, "properties": { @@ -41,5 +41,6 @@ } }, "required": ["systems"], - "additionalProperties": false + "additionalProperties": true, + "not": { "anyOf": [{ "required": ["max_values_per_package"] }, { "required": ["max_packages"] }] } } diff --git a/static/schemas/source/core/geo-place-resolver.json b/static/schemas/source/core/geo-place-resolver.json index 453b5b51025..7fcfc8f9569 100644 --- a/static/schemas/source/core/geo-place-resolver.json +++ b/static/schemas/source/core/geo-place-resolver.json @@ -23,5 +23,5 @@ } }, "required": ["url", "auth", "protocol"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/geo-place-support.json b/static/schemas/source/core/geo-place-support.json index 89ccd45cfc2..78fefe5b77c 100644 --- a/static/schemas/source/core/geo-place-support.json +++ b/static/schemas/source/core/geo-place-support.json @@ -28,5 +28,5 @@ } }, "required": ["countries", "catalog"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/geo-region-requirement.json b/static/schemas/source/core/geo-region-requirement.json index d91e27ad982..e435754f709 100644 --- a/static/schemas/source/core/geo-region-requirement.json +++ b/static/schemas/source/core/geo-region-requirement.json @@ -2,7 +2,7 @@ "$schema": "http://json-schema.org/draft-07/schema#", "$id": "/schemas/core/geo-region-requirement.json", "title": "Geographic Region Requirement", - "description": "Buyer minimum requirements for ISO 3166-2 subdivision values that must remain independently selectable later. Country keys prevent a false cross-country capability claim. all_values requires support for every protocol-valid ISO subdivision active in the seller's support snapshot when the declaration is issued; values requests an exact finite candidate set. Exact delivery values known now belong in get_products.targeting_overlay instead.", + "description": "Buyer minimum requirements for ISO 3166-2 subdivision values that must remain independently selectable later. Country keys prevent a false cross-country capability claim. all_values requires support for every protocol-valid ISO subdivision active in the seller's support snapshot when the declaration is issued; values requests an exact finite candidate set. Exact delivery values known now belong in get_products.targeting_overlay instead. Rejects the seller limits `max_values_per_package` and `max_packages`, which only product support discloses.", "type": "object", "properties": { "countries": { @@ -12,6 +12,7 @@ "pattern": "^[A-Z]{2}$" }, "additionalProperties": { + "description": "`all_values` and `values` exclude each other.", "anyOf": [ { "type": "object", @@ -23,7 +24,8 @@ } }, "required": ["all_values"], - "additionalProperties": false + "not": { "required": ["values"] }, + "additionalProperties": true }, { "type": "object", @@ -40,7 +42,8 @@ } }, "required": ["values"], - "additionalProperties": false + "not": { "required": ["all_values"] }, + "additionalProperties": true } ] }, @@ -48,7 +51,8 @@ } }, "required": ["countries"], - "additionalProperties": false, + "additionalProperties": true, + "not": { "anyOf": [{ "required": ["max_values_per_package"] }, { "required": ["max_packages"] }] }, "x-adcp-validation": { "verifier_constraints": { "country_prefix_matches_map_key": { diff --git a/static/schemas/source/core/geo-region-support.json b/static/schemas/source/core/geo-region-support.json index ba93dd0ae01..b374cd9f02a 100644 --- a/static/schemas/source/core/geo-region-support.json +++ b/static/schemas/source/core/geo-region-support.json @@ -12,6 +12,7 @@ "pattern": "^[A-Z]{2}$" }, "additionalProperties": { + "description": "`all_values` and `values` exclude each other.", "anyOf": [ { "type": "object", @@ -23,7 +24,8 @@ } }, "required": ["all_values"], - "additionalProperties": false + "not": { "required": ["values"] }, + "additionalProperties": true }, { "type": "object", @@ -41,7 +43,8 @@ } }, "required": ["values"], - "additionalProperties": false + "not": { "required": ["all_values"] }, + "additionalProperties": true } ] }, @@ -74,7 +77,7 @@ } }, "required": ["countries"], - "additionalProperties": false, + "additionalProperties": true, "x-adcp-validation": { "verifier_constraints": { "country_prefix_matches_map_key": { diff --git a/static/schemas/source/core/get-geo-place-resolution-request.json b/static/schemas/source/core/get-geo-place-resolution-request.json index a248c639b07..a0bde4a35d9 100644 --- a/static/schemas/source/core/get-geo-place-resolution-request.json +++ b/static/schemas/source/core/get-geo-place-resolution-request.json @@ -54,5 +54,5 @@ { "required": ["value"] } ], "not": { "required": ["q", "value"] }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/get-geo-place-resolution-response.json b/static/schemas/source/core/get-geo-place-resolution-response.json index aeb2c68827b..b79b4b7f31d 100644 --- a/static/schemas/source/core/get-geo-place-resolution-response.json +++ b/static/schemas/source/core/get-geo-place-resolution-response.json @@ -60,5 +60,5 @@ } } ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/hold-policy.json b/static/schemas/source/core/hold-policy.json index fd1a78611fc..5ca66c9a1ca 100644 --- a/static/schemas/source/core/hold-policy.json +++ b/static/schemas/source/core/hold-policy.json @@ -76,5 +76,5 @@ "description": "Strictly positive ISO 8601 duration using only days, hours, minutes, and seconds, such as P2D or PT36H. A day is exactly 24 hours of elapsed time on the UTC instant. Year, month, and week parts are excluded so a duration never depends on calendar length." } }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/hotel-item.json b/static/schemas/source/core/hotel-item.json index 9dd888ebe29..187159790c3 100644 --- a/static/schemas/source/core/hotel-item.json +++ b/static/schemas/source/core/hotel-item.json @@ -35,7 +35,7 @@ } }, "required": ["lat", "lng"], - "additionalProperties": false + "additionalProperties": true }, "address": { "type": "object", @@ -63,7 +63,7 @@ "description": "ISO 3166-1 alpha-2 country code." } }, - "additionalProperties": false + "additionalProperties": true }, "star_rating": { "type": "integer", diff --git a/static/schemas/source/core/identifier.json b/static/schemas/source/core/identifier.json index f19594782d2..0a42ded67a4 100644 --- a/static/schemas/source/core/identifier.json +++ b/static/schemas/source/core/identifier.json @@ -18,7 +18,7 @@ "type", "value" ], - "additionalProperties": false, + "additionalProperties": true, "allOf": [ { "if": { diff --git a/static/schemas/source/core/identity-relying-party.json b/static/schemas/source/core/identity-relying-party.json index 3b2d914acc8..14a956f2bfc 100644 --- a/static/schemas/source/core/identity-relying-party.json +++ b/static/schemas/source/core/identity-relying-party.json @@ -31,6 +31,6 @@ "issuer", "relying_party_id" ], - "additionalProperties": false, + "additionalProperties": true, "x-added-in": "3.3.0" } diff --git a/static/schemas/source/core/impairment.json b/static/schemas/source/core/impairment.json index 1fd087bf876..dbab8162e64 100644 --- a/static/schemas/source/core/impairment.json +++ b/static/schemas/source/core/impairment.json @@ -40,7 +40,7 @@ "description": "Current (offline) status of the resource. Drawn from the resource_type's canonical lifecycle enum; see impairment-offline-state for per-value resource_type pairing. The pairing is validated by impairment.coherence." } }, - "additionalProperties": false + "additionalProperties": true }, "reason_code": { "$ref": "/schemas/enums/impairment-reason-code.json", diff --git a/static/schemas/source/core/indicators-changed-webhook.json b/static/schemas/source/core/indicators-changed-webhook.json index fae45a90d0c..56ae6f397db 100644 --- a/static/schemas/source/core/indicators-changed-webhook.json +++ b/static/schemas/source/core/indicators-changed-webhook.json @@ -149,7 +149,7 @@ }, "spec": "specs/relationship-scoped-indicators.md#webhook-contract" }, - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "description": "Creative fatigue changed for one assignment", diff --git a/static/schemas/source/core/installment.json b/static/schemas/source/core/installment.json index 8f2343992db..f50ad910373 100644 --- a/static/schemas/source/core/installment.json +++ b/static/schemas/source/core/installment.json @@ -100,7 +100,7 @@ } }, "required": ["installment_id", "type"], - "additionalProperties": false + "additionalProperties": true }, "ext": { "$ref": "/schemas/core/ext.json" diff --git a/static/schemas/source/core/inventory-list-application.json b/static/schemas/source/core/inventory-list-application.json index 5e83fd8ac6e..a3405599cad 100644 --- a/static/schemas/source/core/inventory-list-application.json +++ b/static/schemas/source/core/inventory-list-application.json @@ -2,7 +2,7 @@ "$schema": "http://json-schema.org/draft-07/schema#", "$id": "/schemas/core/inventory-list-application.json", "title": "Inventory List Application", - "description": "Seller-issued, product-scoped receipt showing how one effective property- or collection-list targeting reference intersected the inventory represented by a returned product. Each receipt compares its resolved entries independently against the same product inventory before any effective list is applied; product pricing and forecasts reflect the eligible inventory after all effective lists are composed. Sellers MUST NOT echo auth_token or other separately supplied fetch credentials; the closed receipt shape defines no credential field.", + "description": "Seller-issued, product-scoped receipt showing how one effective property- or collection-list targeting reference intersected the inventory represented by a returned product. Each receipt compares its resolved entries independently against the same product inventory before any effective list is applied; product pricing and forecasts reflect the eligible inventory after all effective lists are composed. Sellers MUST NOT echo auth_token or other separately supplied fetch credentials; the receipt shape defines no credential field. Both receipt branches reject `auth_token`.", "type": "object", "x-adcp-validation": { "verifier_constraints": { @@ -69,7 +69,7 @@ } }, "required": ["matched", "unmatched"], - "additionalProperties": false + "additionalProperties": true } }, "required": [ @@ -81,7 +81,8 @@ "evaluated_at", "summary" ], - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["auth_token"] } }, { "title": "Collection list application", @@ -134,7 +135,7 @@ } }, "required": ["matched", "unmatched"], - "additionalProperties": false + "additionalProperties": true } }, "required": [ @@ -146,7 +147,8 @@ "evaluated_at", "summary" ], - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["auth_token"] } } ] } diff --git a/static/schemas/source/core/job-item.json b/static/schemas/source/core/job-item.json index da64b94b944..8750004b95d 100644 --- a/static/schemas/source/core/job-item.json +++ b/static/schemas/source/core/job-item.json @@ -61,7 +61,7 @@ } }, "required": ["currency", "period"], - "additionalProperties": false + "additionalProperties": true }, "date_posted": { "type": "string", diff --git a/static/schemas/source/core/keyword-target.json b/static/schemas/source/core/keyword-target.json index 9b4c2b10069..1d6be7da60e 100644 --- a/static/schemas/source/core/keyword-target.json +++ b/static/schemas/source/core/keyword-target.json @@ -10,5 +10,5 @@ "bid_price": { "type": "number", "minimum": 0 } }, "required": ["keyword", "match_type"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/later-proposals-state.json b/static/schemas/source/core/later-proposals-state.json index c7edd6955a6..58107aa6c28 100644 --- a/static/schemas/source/core/later-proposals-state.json +++ b/static/schemas/source/core/later-proposals-state.json @@ -43,5 +43,5 @@ "required": ["accepted"] }, "then": { "required": ["window_ends_at", "max_count", "min_interval"] }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/macro-declaration.json b/static/schemas/source/core/macro-declaration.json index 94c225462e3..1431306d906 100644 --- a/static/schemas/source/core/macro-declaration.json +++ b/static/schemas/source/core/macro-declaration.json @@ -74,7 +74,7 @@ "context": { "$ref": "/schemas/enums/macro-value-context.json" } }, "required": ["field", "occurrence", "context"], - "additionalProperties": false + "additionalProperties": true }, "encoding": { "$ref": "/schemas/core/macro-encoding.json", @@ -102,7 +102,7 @@ "required", "unavailable_behavior" ], - "additionalProperties": false, + "additionalProperties": true, "allOf": [ { "if": { "properties": { "dialect": { "enum": ["iab_vast", "iab_daast", "vendor"] } }, "required": ["dialect"] }, diff --git a/static/schemas/source/core/macro-encoding.json b/static/schemas/source/core/macro-encoding.json index 8b4ca0717d6..4044576362b 100644 --- a/static/schemas/source/core/macro-encoding.json +++ b/static/schemas/source/core/macro-encoding.json @@ -15,7 +15,7 @@ } }, "required": ["kind", "depth"], - "additionalProperties": false, + "additionalProperties": true, "allOf": [ { "if": { "properties": { "kind": { "const": "none" } }, "required": ["kind"] }, diff --git a/static/schemas/source/core/macro-resolution-capability.json b/static/schemas/source/core/macro-resolution-capability.json index ff02b43273f..aaa0064c6cc 100644 --- a/static/schemas/source/core/macro-resolution-capability.json +++ b/static/schemas/source/core/macro-resolution-capability.json @@ -56,7 +56,7 @@ "performed_by", "supported_contexts" ], - "additionalProperties": false, + "additionalProperties": true, "allOf": [ { "if": { "properties": { "dialect": { "enum": ["iab_vast", "iab_daast", "vendor"] } }, "required": ["dialect"] }, diff --git a/static/schemas/source/core/macro-resolution-result.json b/static/schemas/source/core/macro-resolution-result.json index 194b91275f7..5e1e1412328 100644 --- a/static/schemas/source/core/macro-resolution-result.json +++ b/static/schemas/source/core/macro-resolution-result.json @@ -58,7 +58,7 @@ "status", "reason" ], - "additionalProperties": false, + "additionalProperties": true, "allOf": [ { "if": { "properties": { "dialect": { "enum": ["iab_vast", "iab_daast", "vendor"] } }, "required": ["dialect"] }, diff --git a/static/schemas/source/core/macro-translation-target.json b/static/schemas/source/core/macro-translation-target.json index 4c6a4b3d419..8c01df93822 100644 --- a/static/schemas/source/core/macro-translation-target.json +++ b/static/schemas/source/core/macro-translation-target.json @@ -20,7 +20,7 @@ "encoding": { "$ref": "/schemas/core/macro-encoding.json" } }, "required": ["token", "dialect", "dialect_semantic", "mapping_status", "next_operation", "performed_by", "encoding"], - "additionalProperties": false, + "additionalProperties": true, "allOf": [ { "if": { "properties": { "dialect": { "enum": ["iab_vast", "iab_daast", "vendor"] } }, "required": ["dialect"] }, diff --git a/static/schemas/source/core/media-buy-available-action.json b/static/schemas/source/core/media-buy-available-action.json index 0ef5d84b9e6..fae14d99d8a 100644 --- a/static/schemas/source/core/media-buy-available-action.json +++ b/static/schemas/source/core/media-buy-available-action.json @@ -70,5 +70,5 @@ "then": { "properties": { "action": { "enum": ["sync_creatives", "replace_creative", "update_creative_assignments"] } } } } ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/media-buy-issue.json b/static/schemas/source/core/media-buy-issue.json index b994b8c6e6c..0caee41b1f5 100644 --- a/static/schemas/source/core/media-buy-issue.json +++ b/static/schemas/source/core/media-buy-issue.json @@ -3,7 +3,7 @@ "$id": "/schemas/core/media-buy-issue.json", "title": "Media Buy Issue", "x-added-in": "3.3.0", - "description": "Seller-owned report status, separate from transport task status and MediaBuy revision. Only the seller may acknowledge or resolve it. Reporting never changes delivery or commercial terms.", + "description": "Seller-owned report status, separate from transport task status and MediaBuy revision. Only the seller may acknowledge or resolve it. Reporting never changes delivery or commercial terms. Rejects `revision` and `sla`: an issue snapshot carries no revision of its own and doesn't repeat the commitment metadata.", "type": "object", "properties": { "issue_id": { @@ -90,7 +90,8 @@ "status", "received_at" ], - "additionalProperties": false, + "additionalProperties": true, + "not": { "anyOf": [{ "required": ["revision"] }, { "required": ["sla"] }] }, "allOf": [ { "if": { diff --git a/static/schemas/source/core/media-buy-support-requirements.json b/static/schemas/source/core/media-buy-support-requirements.json index 57c719fe007..52c8abda587 100644 --- a/static/schemas/source/core/media-buy-support-requirements.json +++ b/static/schemas/source/core/media-buy-support-requirements.json @@ -16,5 +16,5 @@ "frequency_cap_constraints": ["frequency_cap"] }, "minProperties": 1, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/media-buy.json b/static/schemas/source/core/media-buy.json index aec4e858623..7ff60889d7a 100644 --- a/static/schemas/source/core/media-buy.json +++ b/static/schemas/source/core/media-buy.json @@ -83,7 +83,7 @@ "maxLength": 500 } }, - "additionalProperties": false + "additionalProperties": true }, "cancellation_effective_at": { "type": "string", @@ -112,7 +112,7 @@ "stop_time": { "type": "string", "format": "date-time", "description": "Stop time in force before the edit." } }, "required": ["recorded_at", "start_time", "stop_time"], - "additionalProperties": false + "additionalProperties": true } }, "total_budget": { diff --git a/static/schemas/source/core/missing-metric.json b/static/schemas/source/core/missing-metric.json index 598052ad69a..a2764034e06 100644 --- a/static/schemas/source/core/missing-metric.json +++ b/static/schemas/source/core/missing-metric.json @@ -44,7 +44,7 @@ "scope", "metric_id" ], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -86,7 +86,7 @@ "vendor", "metric_id" ], - "additionalProperties": false + "additionalProperties": true } ] } diff --git a/static/schemas/source/core/negative-keyword.json b/static/schemas/source/core/negative-keyword.json index 32f21368ff5..6f5d3566ca5 100644 --- a/static/schemas/source/core/negative-keyword.json +++ b/static/schemas/source/core/negative-keyword.json @@ -13,5 +13,5 @@ "match_type": { "$ref": "/schemas/enums/match-type.json" } }, "required": ["keyword", "match_type"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/notification-config.json b/static/schemas/source/core/notification-config.json index 8df53248ace..277bf9a1a87 100644 --- a/static/schemas/source/core/notification-config.json +++ b/static/schemas/source/core/notification-config.json @@ -80,7 +80,7 @@ "required": [ "schemes" ], - "additionalProperties": false + "additionalProperties": true }, "signing_profile": { "x-status": "experimental", @@ -115,7 +115,7 @@ } ], "not": { "required": ["authentication", "signing_profile"] }, - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "description": "Single subscriber receiving creative lifecycle events", diff --git a/static/schemas/source/core/operator-identity.json b/static/schemas/source/core/operator-identity.json index 17c61ce1cee..0f99230b2d5 100644 --- a/static/schemas/source/core/operator-identity.json +++ b/static/schemas/source/core/operator-identity.json @@ -21,5 +21,5 @@ "required": [ "operator" ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/operator-unit.json b/static/schemas/source/core/operator-unit.json index d15a9e16bdb..851538e9829 100644 --- a/static/schemas/source/core/operator-unit.json +++ b/static/schemas/source/core/operator-unit.json @@ -21,7 +21,7 @@ } }, "required": ["id"], - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "id": "234284238", "name": "Nova EMEA" }, { "id": "benelux-seat", "name": "Nova Benelux" } diff --git a/static/schemas/source/core/opportunity-context.json b/static/schemas/source/core/opportunity-context.json index 9d6fdc415c8..2a9ee5efbe8 100644 --- a/static/schemas/source/core/opportunity-context.json +++ b/static/schemas/source/core/opportunity-context.json @@ -84,7 +84,7 @@ } }, "required": ["accepted"], - "additionalProperties": false + "additionalProperties": true } }, "required": ["opportunity_id"], diff --git a/static/schemas/source/core/outcome-target-cost-per.json b/static/schemas/source/core/outcome-target-cost-per.json index d596b7f401e..29954d47207 100644 --- a/static/schemas/source/core/outcome-target-cost-per.json +++ b/static/schemas/source/core/outcome-target-cost-per.json @@ -2,7 +2,7 @@ "$schema": "http://json-schema.org/draft-07/schema#", "$id": "/schemas/core/outcome-target-cost-per.json", "title": "Outcome Target Cost Per", - "description": "Average cost the buyer will pay per goal result: BiddingPolicy.cost_per plus a currency. It requires a goal expressible as a canonical optimization goal; otherwise the seller rejects with INVALID_REQUEST naming criteria.outcome_target.cost_per, since the goal stays plannable by volume. With a buyer budget (offer_filters.budget_range or the brief), the seller plans the volume it can deliver within it at or below (cap) or around (target) the cost; with volume, see volume; with neither, it MUST state the spend for the volume it can deliver at the cost in total_budget_guidance. Each proposal answers in commercial_terms.bidding.cost_per, which the buyer adopts on acceptance; it is an execution control, not an expected price, and billing stays on the selected pricing option. The answer MUST NOT carry purchase-level bidding. Under fixed or omitted budget_allocation every purchase's primary optimization goal, and under seller_optimized the primary budget_allocation.optimization_goals goal, MUST match goal and resolve to one result unit as BiddingPolicy.cost_per defines it: the same metric and result-defining qualifiers, or for an event goal every event_sources[] entry carrying the goal's event_type (and custom_event_name) with one resolved attribution_window. Seller-added qualifiers (such as view_duration_seconds or reach_unit) are permitted and visible in the proposal. For an event goal the seller fills event_sources from sources available on the buyer's account for that event, buyer-synced or seller-managed, exactly one unless it advertises conversion_tracking.multi_source_event_dedup, and states attribution_window, which SHOULD be one advertised in conversion_tracking.attribution_windows; with none available it rejects. A seller declares event-goal cost support by listing cost_per in conversion_tracking.supported_targets; a vendor_metric goal needs cost_per in the matching vendor_metric_optimization supported_targets, else the seller rejects. A seller MUST NOT answer with a bidding policy outside its advertised features.bidding_policy profile for the proposal's scope and allocation mode; a declaring seller without one rejects. Rejections of a target that cannot be represented or bound (strength, currency, goal, capability) use INVALID_REQUEST naming criteria.outcome_target.cost_per; a valid target with no viable inventory is outcome 'rejected'.", + "description": "Average cost the buyer will pay per goal result: BiddingPolicy.cost_per plus a currency. It requires a goal expressible as a canonical optimization goal; otherwise the seller rejects with INVALID_REQUEST naming criteria.outcome_target.cost_per, since the goal stays plannable by volume. With a buyer budget (offer_filters.budget_range or the brief), the seller plans the volume it can deliver within it at or below (cap) or around (target) the cost; with volume, see volume; with neither, it MUST state the spend for the volume it can deliver at the cost in total_budget_guidance. Each proposal answers in commercial_terms.bidding.cost_per, which the buyer adopts on acceptance; it is an execution control, not an expected price, and billing stays on the selected pricing option. The answer MUST NOT carry purchase-level bidding. Under fixed or omitted budget_allocation every purchase's primary optimization goal, and under seller_optimized the primary budget_allocation.optimization_goals goal, MUST match goal and resolve to one result unit as BiddingPolicy.cost_per defines it: the same metric and result-defining qualifiers, or for an event goal every event_sources[] entry carrying the goal's event_type (and custom_event_name) with one resolved attribution_window. Seller-added qualifiers (such as view_duration_seconds or reach_unit) are permitted and visible in the proposal. For an event goal the seller fills event_sources from sources available on the buyer's account for that event, buyer-synced or seller-managed, exactly one unless it advertises conversion_tracking.multi_source_event_dedup, and states attribution_window, which SHOULD be one advertised in conversion_tracking.attribution_windows; with none available it rejects. A seller declares event-goal cost support by listing cost_per in conversion_tracking.supported_targets; a vendor_metric goal needs cost_per in the matching vendor_metric_optimization supported_targets, else the seller rejects. A seller MUST NOT answer with a bidding policy outside its advertised features.bidding_policy profile for the proposal's scope and allocation mode; a declaring seller without one rejects. Rejections of a target that cannot be represented or bound (strength, currency, goal, capability) use INVALID_REQUEST naming criteria.outcome_target.cost_per; a valid target with no viable inventory is outcome 'rejected'. Rejects `max_bid`, which belongs to bidding_policy.", "type": "object", "properties": { "amount": { @@ -21,5 +21,6 @@ } }, "required": ["amount", "currency", "strength"], - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["max_bid"] } } diff --git a/static/schemas/source/core/overlay.json b/static/schemas/source/core/overlay.json index b510bede810..cafea655630 100644 --- a/static/schemas/source/core/overlay.json +++ b/static/schemas/source/core/overlay.json @@ -34,7 +34,7 @@ } }, "minProperties": 1, - "additionalProperties": false + "additionalProperties": true }, "bounds": { "type": "object", @@ -65,9 +65,9 @@ } }, "required": ["x", "y", "width", "height", "unit"], - "additionalProperties": false + "additionalProperties": true } }, "required": ["id", "bounds"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/package-targeting-resolution.json b/static/schemas/source/core/package-targeting-resolution.json index 11654bde062..3eb7935f3bd 100644 --- a/static/schemas/source/core/package-targeting-resolution.json +++ b/static/schemas/source/core/package-targeting-resolution.json @@ -12,5 +12,5 @@ "ext": { "$ref": "/schemas/core/ext.json" } }, "required": ["demographics"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/package.json b/static/schemas/source/core/package.json index 06d9651af4f..6a6f672508c 100644 --- a/static/schemas/source/core/package.json +++ b/static/schemas/source/core/package.json @@ -303,7 +303,7 @@ "description": "ISO 8601 timestamp when the seller acknowledged the cancellation. Confirms inventory has been released and billing stopped. Absent until the seller processes the cancellation." } }, - "additionalProperties": false + "additionalProperties": true }, "agency_estimate_number": { "type": "string", diff --git a/static/schemas/source/core/pagination-request.json b/static/schemas/source/core/pagination-request.json index 425bb74e659..7ce1f267e10 100644 --- a/static/schemas/source/core/pagination-request.json +++ b/static/schemas/source/core/pagination-request.json @@ -17,5 +17,5 @@ "description": "Opaque cursor from a previous response to fetch the next page" } }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/pagination-response.json b/static/schemas/source/core/pagination-response.json index 8b0f1e2997d..8665c5c5e57 100644 --- a/static/schemas/source/core/pagination-response.json +++ b/static/schemas/source/core/pagination-response.json @@ -22,5 +22,5 @@ "required": [ "has_more" ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/performance-feedback-assertion.json b/static/schemas/source/core/performance-feedback-assertion.json index 8251646588e..fd9b98a349b 100644 --- a/static/schemas/source/core/performance-feedback-assertion.json +++ b/static/schemas/source/core/performance-feedback-assertion.json @@ -105,10 +105,10 @@ } }, "required": ["lower", "upper", "level"], - "additionalProperties": false + "additionalProperties": true } }, - "additionalProperties": false + "additionalProperties": true }, "evidence_ref": { "type": "string", diff --git a/static/schemas/source/core/performance-feedback-metric.json b/static/schemas/source/core/performance-feedback-metric.json index 426d1737190..6b8b47c8f3f 100644 --- a/static/schemas/source/core/performance-feedback-metric.json +++ b/static/schemas/source/core/performance-feedback-metric.json @@ -41,7 +41,7 @@ } }, "required": ["scope", "metric_id"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -80,7 +80,7 @@ } }, "required": ["scope", "vendor", "metric_id"], - "additionalProperties": false + "additionalProperties": true } ] } diff --git a/static/schemas/source/core/performance-feedback.json b/static/schemas/source/core/performance-feedback.json index 9dd366030e5..43ca0dd559f 100644 --- a/static/schemas/source/core/performance-feedback.json +++ b/static/schemas/source/core/performance-feedback.json @@ -72,7 +72,7 @@ }, "qualifier": { "type": "object", - "description": "Disambiguator — same shape as `committed_metrics.qualifier`. Carry `viewability_standard` for MRC vs GroupM viewability feedback; `completion_source` for seller- vs vendor-attested completion feedback; `attribution_methodology` and `attribution_window` for outcome-metric feedback (the buyer pinning a specific methodology or window when the feedback is methodology-sensitive). Closed (`additionalProperties: false`); new keys ship explicitly in subsequent minors.", + "description": "Disambiguator — same shape as `committed_metrics.qualifier`. Carry `viewability_standard` for MRC vs GroupM viewability feedback; `completion_source` for seller- vs vendor-attested completion feedback; `attribution_methodology` and `attribution_window` for outcome-metric feedback (the buyer pinning a specific methodology or window when the feedback is methodology-sensitive). Closed (`additionalProperties: false`), because consumers join on the key set; new keys ship in a major release.", "properties": { "viewability_standard": { "$ref": "/schemas/enums/viewability-standard.json" @@ -94,7 +94,7 @@ } }, "required": ["scope", "metric_id"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -135,7 +135,7 @@ } }, "required": ["scope", "vendor", "metric_id"], - "additionalProperties": false + "additionalProperties": true } ] }, diff --git a/static/schemas/source/core/placement-definition.json b/static/schemas/source/core/placement-definition.json index 6d3259c69e9..3dc4ab0bd59 100644 --- a/static/schemas/source/core/placement-definition.json +++ b/static/schemas/source/core/placement-definition.json @@ -14,7 +14,7 @@ "height": { "type": "integer", "description": "Screen height in pixels.", "minimum": 1 } }, "required": ["width", "height"], - "additionalProperties": false + "additionalProperties": true }, "PublisherDoohAddress": { "title": "Publisher DOOH Address", @@ -27,7 +27,7 @@ "postal_code": { "type": "string", "description": "Postal or ZIP code." }, "country": { "type": "string", "pattern": "^[A-Z]{2}$", "description": "ISO 3166-1 alpha-2 country code." } }, - "additionalProperties": false + "additionalProperties": true }, "PublisherDoohLocation": { "title": "Publisher DOOH Location", @@ -48,7 +48,7 @@ }, "address": { "$ref": "#/definitions/PublisherDoohAddress" } }, - "additionalProperties": false + "additionalProperties": true }, "PublisherDoohPlacementAttributes": { "title": "Publisher DOOH Placement Attributes", diff --git a/static/schemas/source/core/placement-identity.json b/static/schemas/source/core/placement-identity.json index 352e3aacff3..4bdcd40bb65 100644 --- a/static/schemas/source/core/placement-identity.json +++ b/static/schemas/source/core/placement-identity.json @@ -24,7 +24,7 @@ } }, "required": ["kind", "publisher_domain", "placement_id"], - "additionalProperties": false + "additionalProperties": true }, { "title": "Seller inline placement identity", @@ -46,7 +46,7 @@ } }, "required": ["kind", "seller_agent", "placement_id"], - "additionalProperties": false + "additionalProperties": true } ] } diff --git a/static/schemas/source/core/placement-selection.json b/static/schemas/source/core/placement-selection.json index 18dab797e04..af37ad4bda0 100644 --- a/static/schemas/source/core/placement-selection.json +++ b/static/schemas/source/core/placement-selection.json @@ -40,9 +40,10 @@ } }, "required": ["mode", "placement_refs"], - "additionalProperties": false + "additionalProperties": true }, { + "description": "Rejects `placement_refs`: the default mode names no placements.", "title": "Product default placements", "type": "object", "properties": { @@ -55,7 +56,8 @@ } }, "required": ["mode"], - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["placement_refs"] } } ] } diff --git a/static/schemas/source/core/placement.json b/static/schemas/source/core/placement.json index b0712e9d91e..dbbf75af5f2 100644 --- a/static/schemas/source/core/placement.json +++ b/static/schemas/source/core/placement.json @@ -14,7 +14,7 @@ "height": { "type": "integer", "description": "Screen height in pixels.", "minimum": 1 } }, "required": ["width", "height"], - "additionalProperties": false + "additionalProperties": true }, "ProductDoohAddress": { "title": "Product DOOH Address", @@ -27,7 +27,7 @@ "postal_code": { "type": "string", "description": "Postal or ZIP code." }, "country": { "type": "string", "pattern": "^[A-Z]{2}$", "description": "ISO 3166-1 alpha-2 country code." } }, - "additionalProperties": false + "additionalProperties": true }, "ProductDoohLocation": { "title": "Product DOOH Location", @@ -48,7 +48,7 @@ }, "address": { "$ref": "#/definitions/ProductDoohAddress" } }, - "additionalProperties": false + "additionalProperties": true }, "ProductDoohPlacementAttributes": { "title": "Product DOOH Placement Attributes", diff --git a/static/schemas/source/core/postal-area.json b/static/schemas/source/core/postal-area.json index 064b8c0aafb..919778bc35e 100644 --- a/static/schemas/source/core/postal-area.json +++ b/static/schemas/source/core/postal-area.json @@ -32,9 +32,10 @@ } }, "required": ["country", "system", "values"], - "additionalProperties": false + "additionalProperties": true }, { + "description": "Rejects `country`: the fused legacy system already names the country.", "title": "PostalAreaWithFusedSystem", "deprecated": true, "type": "object", @@ -54,7 +55,8 @@ } }, "required": ["system", "values"], - "additionalProperties": false + "not": { "required": ["country"] }, + "additionalProperties": true } ] } diff --git a/static/schemas/source/core/presentation-ref.json b/static/schemas/source/core/presentation-ref.json index f825606c633..ec21a06eba1 100644 --- a/static/schemas/source/core/presentation-ref.json +++ b/static/schemas/source/core/presentation-ref.json @@ -28,5 +28,5 @@ "description": "Version of /schemas/core/placement-presentation.json used to validate and compose the referenced document." } }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/preview-provider.json b/static/schemas/source/core/preview-provider.json index 333ea054538..e1b3f69a13a 100644 --- a/static/schemas/source/core/preview-provider.json +++ b/static/schemas/source/core/preview-provider.json @@ -40,14 +40,14 @@ "description": "True only when the publisher delegates both creative rendering and the complete placement-specific frame to this route. When false or omitted, consumers compose any presentation_ref around the provider's creative render." } }, - "additionalProperties": false + "additionalProperties": true }, "x-adcp-validation": { "unique_item_properties": ["format_option_id"] } } }, - "additionalProperties": false, + "additionalProperties": true, "x-adcp-validation": { "verifier_constraints": { "format_option_id": "resolves_within_declaring_adagents_json_and_is_listed_on_placement", diff --git a/static/schemas/source/core/price.json b/static/schemas/source/core/price.json index a3a487348c9..801243deff1 100644 --- a/static/schemas/source/core/price.json +++ b/static/schemas/source/core/price.json @@ -22,7 +22,7 @@ } }, "required": ["amount", "currency"], - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "description": "One-time purchase price", diff --git a/static/schemas/source/core/principal-changed-webhook.json b/static/schemas/source/core/principal-changed-webhook.json index df535c7ae49..bdd95574c86 100644 --- a/static/schemas/source/core/principal-changed-webhook.json +++ b/static/schemas/source/core/principal-changed-webhook.json @@ -74,7 +74,7 @@ } }, "required": ["idempotency_key", "notification_id", "notification_type", "fired_at", "subscriber_id", "agent_url", "changed_at", "reason"], - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "description": "Destination reached ready after recipient acceptance", diff --git a/static/schemas/source/core/principal-declarations-state.json b/static/schemas/source/core/principal-declarations-state.json index e144d4f3288..8fecdcf2042 100644 --- a/static/schemas/source/core/principal-declarations-state.json +++ b/static/schemas/source/core/principal-declarations-state.json @@ -41,12 +41,12 @@ } }, "required": ["axis", "value", "reason"], - "additionalProperties": false + "additionalProperties": true }, "maxItems": 64, "description": "Every declared value that is absent from the accepted intersection, with the seller's reason. Present whenever declared and accepted differ, so a buyer can see why a capability it relies on was not accepted instead of diffing the two sets." } }, "required": ["declared", "accepted"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/principal-declarations.json b/static/schemas/source/core/principal-declarations.json index fb703d725a5..6c57ac0b464 100644 --- a/static/schemas/source/core/principal-declarations.json +++ b/static/schemas/source/core/principal-declarations.json @@ -38,5 +38,5 @@ "description": "Experimental feature identifiers, matching the seller's experimental_features vocabulary, that the caller opts into receiving in asynchronous payloads. Unknown identifiers are accepted and excluded from the intersection rather than rejected, so a caller can declare once across sellers with different surfaces." } }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/principal-state.json b/static/schemas/source/core/principal-state.json index d09b32260f1..f926a86874d 100644 --- a/static/schemas/source/core/principal-state.json +++ b/static/schemas/source/core/principal-state.json @@ -65,12 +65,12 @@ } }, "required": ["destination_id", "destination_refs"], - "additionalProperties": false + "additionalProperties": true }, "maxItems": 64, "description": "Destinations the caller revoked by omitting them from a submitted reporting_destinations section, retained while any generation remains resolvable for reporting history. Enumerable only by the owning principal. Reusing a retired destination_id requires fresh registration and proof and produces a new generation." } }, "minProperties": 1, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/product-allowed-action.json b/static/schemas/source/core/product-allowed-action.json index 4e147075853..c7a9fcd885b 100644 --- a/static/schemas/source/core/product-allowed-action.json +++ b/static/schemas/source/core/product-allowed-action.json @@ -2,7 +2,7 @@ "$schema": "http://json-schema.org/draft-07/schema#", "$id": "/schemas/core/product-allowed-action.json", "title": "Product Allowed Action", - "description": "An action a seller declares as allowed on buys created against this product, scoped to the buy statuses where the action is permitted and the modes available. Advisory template only — the authoritative per-buy resolution lives in `available_actions[]` on the buy response (which may diverge from the product template based on negotiated terms, account tier, or buy-level overrides). The containing `allowed_actions[]` array is uniquely keyed by `action`; sellers MUST NOT emit two entries with the same `action` value. JSON Schema `uniqueItems` only catches structurally identical objects, so validators MUST enforce action-uniqueness separately.", + "description": "An action a seller declares as allowed on buys created against this product, scoped to the buy statuses where the action is permitted and the modes available. Advisory template only — the authoritative per-buy resolution lives in `available_actions[]` on the buy response (which may diverge from the product template based on negotiated terms, account tier, or buy-level overrides). The containing `allowed_actions[]` array is uniquely keyed by `action`; sellers MUST NOT emit two entries with the same `action` value. JSON Schema `uniqueItems` only catches structurally identical objects, so validators MUST enforce action-uniqueness separately. Rejects `review_sla`: a product's review commitment is creative_policy.review_sla.", "x-adcp-validation": { "verifier_constraints": { "constraint_action_compatibility": "The constraints.kind is compatible with action under change-term-constraints.json. Product constraints are advisory upper bounds and cannot create a proposal-bound right." @@ -52,5 +52,6 @@ "then": { "properties": { "sla": { "$ref": "/schemas/core/escalation-sla.json" }, "modes": { "items": { "const": "seller_managed" } }, "constraints": false, "terms_ref": false } } } ], - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["review_sla"] } } diff --git a/static/schemas/source/core/product-audience-evidence-requirements.json b/static/schemas/source/core/product-audience-evidence-requirements.json index 5de3517b15e..af0cb5405c0 100644 --- a/static/schemas/source/core/product-audience-evidence-requirements.json +++ b/static/schemas/source/core/product-audience-evidence-requirements.json @@ -69,7 +69,7 @@ "ext": { "$ref": "/schemas/core/ext.json" } }, "required": ["type", "brand"], - "additionalProperties": false + "additionalProperties": true }, { "type": "object", @@ -83,7 +83,7 @@ "ext": { "$ref": "/schemas/core/ext.json" } }, "required": ["type", "agent_url"], - "additionalProperties": false + "additionalProperties": true }, { "type": "object", @@ -97,7 +97,7 @@ "ext": { "$ref": "/schemas/core/ext.json" } }, "required": ["type", "origin"], - "additionalProperties": false + "additionalProperties": true } ] }, @@ -122,5 +122,5 @@ "then": { "required": ["accepted_attestation_issuers"] } } ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/product-filters.json b/static/schemas/source/core/product-filters.json index 4981eea41c4..c5ea2168be1 100644 --- a/static/schemas/source/core/product-filters.json +++ b/static/schemas/source/core/product-filters.json @@ -151,7 +151,7 @@ } }, "required": ["system", "code"], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1 }, @@ -251,7 +251,7 @@ "minItems": 1 } }, - "additionalProperties": false + "additionalProperties": true }, "audience_activation_methods": { "type": "array", @@ -266,7 +266,7 @@ "pattern": { "type": "string", "const": "sync_audiences" } }, "required": ["pattern"], - "additionalProperties": false + "additionalProperties": true }, { "type": "object", @@ -280,11 +280,11 @@ "agent_url": { "type": "string", "format": "uri" } }, "required": ["agent_url"], - "additionalProperties": false + "additionalProperties": true } }, "required": ["pattern"], - "additionalProperties": false + "additionalProperties": true }, { "type": "object", @@ -311,7 +311,7 @@ } }, "required": ["pattern"], - "additionalProperties": false + "additionalProperties": true }, { "type": "object", @@ -324,7 +324,7 @@ } }, "required": ["pattern"], - "additionalProperties": false + "additionalProperties": true }, { "type": "object", @@ -337,7 +337,7 @@ } }, "required": ["pattern"], - "additionalProperties": false + "additionalProperties": true }, { "type": "object", @@ -350,7 +350,7 @@ } }, "required": ["pattern"], - "additionalProperties": false + "additionalProperties": true } ] }, @@ -449,7 +449,7 @@ } } ], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1 }, @@ -521,7 +521,7 @@ } }, "required": ["value", "unit"], - "additionalProperties": false + "additionalProperties": true }, "transport_mode": { "$ref": "/schemas/enums/transport-mode.json", @@ -542,7 +542,7 @@ } }, "required": ["value", "unit"], - "additionalProperties": false + "additionalProperties": true }, "geometry": { "type": "object", @@ -559,7 +559,7 @@ } }, "required": ["type", "coordinates"], - "additionalProperties": false + "additionalProperties": true } }, "oneOf": [ @@ -633,7 +633,7 @@ } }, "anyOf": [{ "required": ["vendor"] }, { "required": ["metric_id"] }], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1, "examples": [ @@ -668,7 +668,7 @@ } }, "required": ["keyword"], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1 }, diff --git a/static/schemas/source/core/product-identity.json b/static/schemas/source/core/product-identity.json index b4ce61a3b24..1f9f3080966 100644 --- a/static/schemas/source/core/product-identity.json +++ b/static/schemas/source/core/product-identity.json @@ -60,5 +60,5 @@ } } ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/product-offer-filters.json b/static/schemas/source/core/product-offer-filters.json index f5d3a7af4d2..0bb8a36a0f0 100644 --- a/static/schemas/source/core/product-offer-filters.json +++ b/static/schemas/source/core/product-offer-filters.json @@ -53,7 +53,7 @@ }, "availability_horizon": { "type": "object", - "description": "Flexible-window availability discovery: the buyer is open to any bookable window inside [start_time, end_time) and asks the seller to describe when the returned inventory can run, instead of filtering to one exact flight. Sellers that support this field partition the horizon into time-dimensioned forecast rows (forecast-dimension-time) carrying availability_status; sellers that cannot cover the full horizon signal the gap via the response's incomplete[] mechanism. Unlike start_date/end_date this is not an eligibility filter — products remain returnable when only part of the horizon is open. The resulting availability is a snapshot bounded by the forecast's valid_until, never a hold. Mutually exclusive with start_date and end_date, which declare a fixed flight; buyers that already know their dates use those instead.", + "description": "Flexible-window availability discovery: the buyer is open to any bookable window inside [start_time, end_time) and asks the seller to describe when the returned inventory can run, instead of filtering to one exact flight. Sellers that support this field partition the horizon into time-dimensioned forecast rows (forecast-dimension-time) carrying availability_status; sellers that cannot cover the full horizon signal the gap via the response's incomplete[] mechanism. Unlike start_date/end_date this is not an eligibility filter — products remain returnable when only part of the horizon is open. The resulting availability is a snapshot bounded by the forecast's valid_until, never a hold. Mutually exclusive with start_date and end_date, which declare a fixed flight; buyers that already know their dates use those instead. Rejects `timezone`: the bounds are instants.", "properties": { "start_time": { "type": "string", @@ -67,7 +67,8 @@ } }, "required": ["start_time", "end_time"], - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["timezone"] } }, "budget_range": { "$ref": "/schemas/core/budget-range.json" @@ -109,7 +110,7 @@ "system", "code" ], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1 }, @@ -185,7 +186,7 @@ "minItems": 1 } }, - "additionalProperties": false + "additionalProperties": true }, "required_features": { "allOf": [{ "$ref": "/schemas/core/canonical-media-buy-features.json" }], @@ -223,7 +224,7 @@ "metric_id": { "$ref": "/schemas/core/vendor-metric-id.json" } }, "anyOf": [{ "required": ["vendor"] }, { "required": ["metric_id"] }], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1 }, @@ -242,5 +243,5 @@ } } ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/product-targeting-resolution.json b/static/schemas/source/core/product-targeting-resolution.json index 9e30e63b3eb..74343608309 100644 --- a/static/schemas/source/core/product-targeting-resolution.json +++ b/static/schemas/source/core/product-targeting-resolution.json @@ -20,5 +20,5 @@ "ext": { "$ref": "/schemas/core/ext.json" } }, "required": ["modifications"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/product.json b/static/schemas/source/core/product.json index 4120c9d4c7a..58d2b9e0b9d 100644 --- a/static/schemas/source/core/product.json +++ b/static/schemas/source/core/product.json @@ -668,7 +668,7 @@ } }, "required": ["methods"], - "additionalProperties": false + "additionalProperties": true }, "material_submission": { "type": "object", diff --git a/static/schemas/source/core/property-list-ref.json b/static/schemas/source/core/property-list-ref.json index 861b51f9037..b22e409ceed 100644 --- a/static/schemas/source/core/property-list-ref.json +++ b/static/schemas/source/core/property-list-ref.json @@ -25,5 +25,5 @@ "agent_url", "list_id" ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/proposal-created-webhook.json b/static/schemas/source/core/proposal-created-webhook.json index 7940901f11f..e2b3f6cbc39 100644 --- a/static/schemas/source/core/proposal-created-webhook.json +++ b/static/schemas/source/core/proposal-created-webhook.json @@ -4,7 +4,7 @@ "title": "Proposal Created Webhook", "x-status": "experimental", "x-added-in": "3.3.0", - "description": "Compact account-anchored invalidation fired after the seller creates a later proposal and the snapshot is readable through list_proposals. Identifiers only: the payload carries no commercial terms or seller prose, so it cannot inject terms or instructions into a buyer agent. Receivers verify the webhook signature, dedupe by notification_id, and call list_proposals on the seller bound to the notification config, never on an endpoint taken from the body. Experimental (media_buy.open_opportunities): sellers emitting it MUST list the feature id in experimental_features.", + "description": "Compact account-anchored invalidation fired after the seller creates a later proposal and the snapshot is readable through list_proposals. Identifiers only: the payload carries no commercial terms or seller prose, so it cannot inject terms or instructions into a buyer agent. Receivers verify the webhook signature, dedupe by notification_id, and call list_proposals on the seller bound to the notification config, never on an endpoint taken from the body. Experimental (media_buy.open_opportunities): sellers emitting it MUST list the feature id in experimental_features. Rejects an embedded `proposal`: the notification names the proposal and never carries its body.", "type": "object", "properties": { "idempotency_key": { @@ -73,7 +73,8 @@ } }, "required": ["idempotency_key", "notification_id", "notification_type", "fired_at", "subscriber_id", "account_id", "proposal_id", "opportunity_id", "later_reason", "expires_at"], - "additionalProperties": false, + "additionalProperties": true, + "not": { "required": ["proposal"] }, "examples": [ { "description": "New event inventory for an open opportunity", diff --git a/static/schemas/source/core/proposal-offered-webhook.json b/static/schemas/source/core/proposal-offered-webhook.json index 5e237d83c98..8ac7d9025be 100644 --- a/static/schemas/source/core/proposal-offered-webhook.json +++ b/static/schemas/source/core/proposal-offered-webhook.json @@ -4,7 +4,7 @@ "title": "Proposal Offered Webhook", "x-status": "experimental", "x-added-in": "3.3.0", - "description": "Account-anchored invalidation fired when a seller creates a committed offer against an accepted media buy, after the snapshot is readable through list_proposals. A sibling of proposal-created-webhook.json with the same identifiers-only rule: the payload names the offer and its response deadline but carries no commercial terms or seller prose, so it cannot inject terms or instructions into a buyer agent. Experimental in AdCP 3.3 (media_buy.seller_offers). Registered through sync_accounts notification_configs with event_types: [\"proposal.offered\"]. Receivers verify the webhook signature, dedupe by idempotency_key, and call list_proposals on the seller bound to the notification config, never on an endpoint taken from the body. Push is optional; list_proposals remains the authoritative read. notification_id equals proposal_id, so a seller MUST mint offer proposal_id values that match the notification_id pattern. A replacement offer is a new proposal with a new proposal_id.", + "description": "Account-anchored invalidation fired when a seller creates a committed offer against an accepted media buy, after the snapshot is readable through list_proposals. A sibling of proposal-created-webhook.json with the same identifiers-only rule: the payload names the offer and its response deadline but carries no commercial terms or seller prose, so it cannot inject terms or instructions into a buyer agent. Experimental in AdCP 3.3 (media_buy.seller_offers). Registered through sync_accounts notification_configs with event_types: [\"proposal.offered\"]. Receivers verify the webhook signature, dedupe by idempotency_key, and call list_proposals on the seller bound to the notification config, never on an endpoint taken from the body. Push is optional; list_proposals remains the authoritative read. notification_id equals proposal_id, so a seller MUST mint offer proposal_id values that match the notification_id pattern. A replacement offer is a new proposal with a new proposal_id. Rejects `commercial_terms` and `opportunity_id`: a buy offer names its proposal and carries no terms.", "type": "object", "properties": { "idempotency_key": { @@ -76,7 +76,8 @@ "expires_at", "offer_reason" ], - "additionalProperties": false, + "additionalProperties": true, + "not": { "anyOf": [{ "required": ["commercial_terms"] }, { "required": ["opportunity_id"] }] }, "examples": [ { "description": "A creator postponed a scheduled installment and the seller offered a new date", diff --git a/static/schemas/source/core/provenance.json b/static/schemas/source/core/provenance.json index af227b72c76..d727de4b491 100644 --- a/static/schemas/source/core/provenance.json +++ b/static/schemas/source/core/provenance.json @@ -137,7 +137,7 @@ } }, "required": ["agent_url"], - "additionalProperties": false + "additionalProperties": true }, "embedded_at": { "type": "string", @@ -182,7 +182,7 @@ } }, "required": ["agent_url"], - "additionalProperties": false + "additionalProperties": true }, "c2pa_action": { "$ref": "/schemas/enums/c2pa-watermark-action.json", diff --git a/static/schemas/source/core/push-notification-config.json b/static/schemas/source/core/push-notification-config.json index 7cd39e37c2c..d514284f9e4 100644 --- a/static/schemas/source/core/push-notification-config.json +++ b/static/schemas/source/core/push-notification-config.json @@ -49,7 +49,7 @@ "schemes", "credentials" ], - "additionalProperties": false + "additionalProperties": true }, "signing_profile": { "x-status": "experimental", diff --git a/static/schemas/source/core/real-estate-item.json b/static/schemas/source/core/real-estate-item.json index eb263d29fac..1b8b4c3e5b7 100644 --- a/static/schemas/source/core/real-estate-item.json +++ b/static/schemas/source/core/real-estate-item.json @@ -39,7 +39,7 @@ "description": "ISO 3166-1 alpha-2 country code." } }, - "additionalProperties": false + "additionalProperties": true }, "price": { "$ref": "/schemas/core/price.json", @@ -81,7 +81,7 @@ } }, "required": ["value", "unit"], - "additionalProperties": false + "additionalProperties": true }, "description": { "type": "string", @@ -105,7 +105,7 @@ } }, "required": ["lat", "lng"], - "additionalProperties": false + "additionalProperties": true }, "image_url": { "type": "string", diff --git a/static/schemas/source/core/reference-renderer.json b/static/schemas/source/core/reference-renderer.json index 8233d944de0..661ef5af387 100644 --- a/static/schemas/source/core/reference-renderer.json +++ b/static/schemas/source/core/reference-renderer.json @@ -53,10 +53,10 @@ "description": "Repository-relative GitHub Actions workflow path that npm provenance buildDefinition.externalParameters.workflow.path MUST identify." } }, - "additionalProperties": false + "additionalProperties": true } }, - "additionalProperties": false, + "additionalProperties": true, "x-adcp-validation": { "verifier_constraints": { "export": "exists_in_pinned_package_and_passes_contract_fixtures_for_enclosing_format_input_contract" diff --git a/static/schemas/source/core/registry-event.json b/static/schemas/source/core/registry-event.json index 9f062fdd689..c7ded149f83 100644 --- a/static/schemas/source/core/registry-event.json +++ b/static/schemas/source/core/registry-event.json @@ -552,7 +552,7 @@ } }, "required": ["publisher_domain", "type", "value"], - "additionalProperties": false + "additionalProperties": true }, "collectionPayload": { "type": "object", diff --git a/static/schemas/source/core/registry-feed-response.json b/static/schemas/source/core/registry-feed-response.json index 2da9d50e993..69ca9aaed02 100644 --- a/static/schemas/source/core/registry-feed-response.json +++ b/static/schemas/source/core/registry-feed-response.json @@ -60,7 +60,7 @@ "lag_seconds", "retention_days" ], - "additionalProperties": false + "additionalProperties": true } }, "required": [ diff --git a/static/schemas/source/core/reporting-adjustment-receipt.json b/static/schemas/source/core/reporting-adjustment-receipt.json index b508928881f..5e4cbb13fdb 100644 --- a/static/schemas/source/core/reporting-adjustment-receipt.json +++ b/static/schemas/source/core/reporting-adjustment-receipt.json @@ -37,5 +37,5 @@ "acceptance_match": "accepted requires observed_adjustment_sha256 to equal the referenced adjustment's canonical_adjustment_sha256 and adjusts_reporting_revision_id to equal its target. A digest or semantic disagreement is rejected with stable rejection_codes.", "immutability": "A reporting_receipt_id is immutable. Exact retries are idempotent; reuse with different content is a conflict. A new ID may supersede only the current rejected receipt for this adjustment; history remains append-only and an accepted current leaf is terminal." }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/reporting-adjustment.json b/static/schemas/source/core/reporting-adjustment.json index 3845211210b..3b36bd398da 100644 --- a/static/schemas/source/core/reporting-adjustment.json +++ b/static/schemas/source/core/reporting-adjustment.json @@ -22,7 +22,7 @@ "end": { "type": "string", "format": "date-time" } }, "required": ["start", "end"], - "additionalProperties": false + "additionalProperties": true }, "control_total_deltas": { "type": "array", @@ -42,5 +42,5 @@ "ordering": "correction_observed_at MUST be no earlier than the adjusted revision's finalized_at and no later than created_at.", "canonical_evidence": "When the adjusted revision belongs to an obligation whose selected atomic offering uses reconciliation_mode: consumer_receipt (the Reconciled Billing tier), the adjustment MUST include canonical_adjustment_sha256 computed over the complete immutable adjustment object with only canonical_adjustment_sha256 omitted, using RFC 8785 JCS UTF-8 bytes and SHA-256. A seller's separate Core or Managed Delivery obligations do not inherit this requirement merely because the seller also advertises reconciled_billing: true; their adjustments do not require digest or receipt code and MAY omit this field." }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/reporting-canonical-content-digest.json b/static/schemas/source/core/reporting-canonical-content-digest.json index a77aa4b2ef2..aef11fe4bd7 100644 --- a/static/schemas/source/core/reporting-canonical-content-digest.json +++ b/static/schemas/source/core/reporting-canonical-content-digest.json @@ -13,5 +13,5 @@ "canonicalization_sha256": { "type": "string", "pattern": "^[A-Fa-f0-9]{64}$" } }, "required": ["algorithm", "value", "canonicalization_id", "canonicalization_uri", "canonicalization_sha256"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/reporting-canonicalization-contract.json b/static/schemas/source/core/reporting-canonicalization-contract.json index dacbbd2bde7..d68f1886ac9 100644 --- a/static/schemas/source/core/reporting-canonicalization-contract.json +++ b/static/schemas/source/core/reporting-canonicalization-contract.json @@ -40,7 +40,7 @@ "sha256": { "type": "string", "const": "4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945" } }, "required": ["name", "purpose", "input_rows", "canonical_utf8_base64", "sha256"], - "additionalProperties": false + "additionalProperties": true }, "ordering_encoding": { "title": "OrderingEncodingGoldenVector", @@ -53,7 +53,7 @@ "sha256": { "type": "string", "pattern": "^[A-Fa-f0-9]{64}$" } }, "required": ["name", "purpose", "input_rows", "canonical_utf8_base64", "sha256"], - "additionalProperties": false + "additionalProperties": true }, "additional": { "type": "array", @@ -68,12 +68,12 @@ "sha256": { "type": "string", "pattern": "^[A-Fa-f0-9]{64}$" } }, "required": ["name", "purpose", "input_rows", "canonical_utf8_base64", "sha256"], - "additionalProperties": false + "additionalProperties": true } } }, "required": ["empty_report", "ordering_encoding"], - "additionalProperties": false, + "additionalProperties": true, "description": "Named cross-language conformance cases: exactly one empty_report vector, exactly one ordering_encoding vector, and an optional list of additional vectors." } }, @@ -82,5 +82,5 @@ "algorithm": "adcp_jcs_rows_v1 rejects duplicate JSON object keys, non-finite numbers, lone Unicode surrogates, missing/non-scalar primary keys, and duplicate primary-key tuples. Validate every row against the pinned row schema; do not normalize Unicode. RFC 8785-encode each primary-key value array and sort rows by unsigned lexicographic comparison of those UTF-8 bytes. RFC 8785-encode each complete row, then emit the UTF-8 bytes for '[' + the encoded rows joined by ',' + ']'. SHA-256 is computed over exactly those bytes.", "binding": "schema_sha256 and primary_keys MUST exactly equal the selected offering. Golden-vector names MUST be unique across empty_report, ordering_encoding, and additional. empty_report is the exact [] case. ordering_encoding is non-trivial: its input row order differs from canonical primary-key order and its object member order differs from JCS order. SDKs MUST strictly base64-decode canonical_utf8_base64, reproduce every golden vector's exact bytes and sha256, and reject any mismatch before using the contract." }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/reporting-capabilities.json b/static/schemas/source/core/reporting-capabilities.json index 89e2b3bf592..25200b30b20 100644 --- a/static/schemas/source/core/reporting-capabilities.json +++ b/static/schemas/source/core/reporting-capabilities.json @@ -85,7 +85,7 @@ } }, "required": ["vendor", "metric_id"], - "additionalProperties": false, + "additionalProperties": true, "x-adcp-validation": { "verifier_constraints": { "vendor_relationship_required_for_self_measurement": "when vendor.domain equals the seller's own brand.json domain (or a domain the seller's brand.json lists as under common ownership or control), vendor_relationship MUST be present and MUST be first_party or affiliated", diff --git a/static/schemas/source/core/reporting-consumer-status.json b/static/schemas/source/core/reporting-consumer-status.json index 566a169717f..3b9ad2fc210 100644 --- a/static/schemas/source/core/reporting-consumer-status.json +++ b/static/schemas/source/core/reporting-consumer-status.json @@ -60,7 +60,7 @@ "source_timezone": { "type": "string", "minLength": 1 } }, "required": ["start", "end", "source_timezone"], - "additionalProperties": false + "additionalProperties": true }, "reporting_obligation_id": { "type": "string", @@ -187,5 +187,5 @@ "snapshot_provenance": "When seller_ledger_snapshot_id is present, the seller MUST resolve it and require seller_ledger_as_of to exactly match the issued snapshot for this authenticated caller, account, and applicable filter scope. Unknown, unauthorized, cross-account, cross-caller, expired, or mismatched snapshot identities fail with the same unavailable result.", "time": "status_as_of MUST be no earlier than the superseded statement's status_as_of and no later than recorded_at except for the seller's documented clock-skew tolerance. Sellers reject unreasonable future timestamps and retain the submitted value as consumer-attributed evidence rather than rewriting it." }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/reporting-control-total.json b/static/schemas/source/core/reporting-control-total.json index 2c282080799..4019413e301 100644 --- a/static/schemas/source/core/reporting-control-total.json +++ b/static/schemas/source/core/reporting-control-total.json @@ -29,7 +29,7 @@ } }, "required": ["name", "value", "value_type"], - "additionalProperties": false + "additionalProperties": true }, { "title": "DecimalReportingControlTotal", @@ -55,7 +55,7 @@ } }, "required": ["name", "value", "value_type"], - "additionalProperties": false + "additionalProperties": true } ] } diff --git a/static/schemas/source/core/reporting-coverage.json b/static/schemas/source/core/reporting-coverage.json index fbb256dfdfb..18a8bd3cae9 100644 --- a/static/schemas/source/core/reporting-coverage.json +++ b/static/schemas/source/core/reporting-coverage.json @@ -44,7 +44,7 @@ "package_ids": { "type": "array", "items": { "$ref": "#/definitions/ReportingPackageId" }, "minItems": 1, "uniqueItems": true } }, "required": ["reason", "media_buy_id"], - "additionalProperties": false + "additionalProperties": true } } }, @@ -54,5 +54,5 @@ "status": "full requires every media buy to be fully covered and every package covered; the explicit empty denominator is full. partial requires at least one covered package, fully covered media buy, or partially covered media buy and at least one partial, unsupported, or unknown item. A partially covered media buy counts as a covered item when excluding none and unknown. none requires a nonempty denominator, no covered item, at least one unsupported item, and no unknown item. unknown requires a nonempty denominator, no covered item, and at least one unknown item.", "aggregation": "Metrics computed only over covered_package_ids MUST be labeled partial whenever status is not full and MUST NOT be represented as complete media-buy or campaign totals. Implementations MUST NOT weaken the selected report definition to create an undeclared lowest-common-denominator profile." }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/reporting-delivery-capabilities.json b/static/schemas/source/core/reporting-delivery-capabilities.json index b1ca6e8aaaa..b9a9ae6d800 100644 --- a/static/schemas/source/core/reporting-delivery-capabilities.json +++ b/static/schemas/source/core/reporting-delivery-capabilities.json @@ -65,7 +65,7 @@ } }, "required": ["supported"], - "additionalProperties": false + "additionalProperties": true }, "status_task": { "type": "string", @@ -133,7 +133,7 @@ "email": { "type": "string", "format": "email", "maxLength": 254, "description": "Monitored operations mailbox for reporting escalations. A role address, not an individual." } }, "minProperties": 1, - "additionalProperties": false + "additionalProperties": true }, "reliability_statistics": { "type": "array", @@ -338,5 +338,5 @@ "reliability_statistics": "Each reliability_statistics offering_id MUST name exactly one offerings entry and occur at most once. Counts and percentiles follow reporting-reliability-statistics.json; a long declared delivery_sla never substitutes for disclosure of observed publication delay and adjustment behavior.", "reliable_reporting_discovery": "Reliable Reporting 1.0 is supported if and only if reliable_reporting_version is 1.0, supported is true, and the enclosing capability document contains media_buy.reporting_delivery in experimental_features. Such sellers use reporting-definition contract 1.1 and implement checkpoint/adjustment fields even though those fields remain schema-optional for compatibility with the preceding experimental managed-reporting shape. managed_delivery and reconciled_billing then identify optional tiers; offering and product applicability still determine whether a concrete feed is available." }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/reporting-delivery-config-state.json b/static/schemas/source/core/reporting-delivery-config-state.json index f1045b56ca1..ae433247bfd 100644 --- a/static/schemas/source/core/reporting-delivery-config-state.json +++ b/static/schemas/source/core/reporting-delivery-config-state.json @@ -92,7 +92,7 @@ "action", "message" ], - "additionalProperties": false + "additionalProperties": true }, "issues": { "type": "array", @@ -201,5 +201,5 @@ "safe_setup_url": "Reject URL userinfo, non-HTTPS, credential-like query/fragment values, redirects or origins outside the seller/named provider allowlist. Agents must surface the URL for explicit human action without fetching or interpreting its content.", "core_readiness": "A configuration selecting a Core offering (no method) reaches ready without any destination, provider grant, or setup action: validation covers scope, schedule, and offering match only. destination_ref and destination proof are required for ready when and only when the selected offering declares a method." }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/reporting-delivery-config.json b/static/schemas/source/core/reporting-delivery-config.json index c7c04ca8417..a4b13a5ed3f 100644 --- a/static/schemas/source/core/reporting-delivery-config.json +++ b/static/schemas/source/core/reporting-delivery-config.json @@ -22,7 +22,7 @@ }, "minProperties": 1, "maxProperties": 1, - "additionalProperties": false + "additionalProperties": true }, "coverage_requirement": { "type": "string", "enum": ["full", "allow_partial"], "description": "Whether every package in the resolved media-buy scope must support the exact selected offering. full fails closed when any package is unsupported or unknown. allow_partial permits publication only for the explicitly covered package denominator; every revision and status response still exposes partial coverage and MUST NOT present covered-subset totals as whole-buy totals." }, "required_finality": { "$ref": "/schemas/enums/reporting-finality.json", "description": "Finality the durable path must ultimately provide. Snapshot delivery may still precede an official requirement." }, @@ -54,5 +54,5 @@ "billing_continuity": "Experimental (3.3). Billing on an account-level configuration follows the same continuity rules as billing reporting subscriptions. For a billing feed_purpose, when a new generation of the caller's configuration for the account takes effect, or an account timezone change switches an account_timezone schedule, at instant T, the handoff is a cutover as reporting-subscription.json cutover defines it: the outgoing schedule owes its periods that start before T, in full, ending at E, and when the incoming schedule has no boundary at E, the stretch from E to its first boundary is owed as one stub obligation whose stub is true, followed by the incoming schedule's regular periods. A seller with an active billing generation for an account MUST NOT deliver on a buy in that account outside the buy's flight, as reporting-subscription.json delivery_within_flight defines: it extends end_time before any later delivery, make-goods included, and a canceled or completed buy's make-good goes on a subsequent buy.", "coverage_requirement": "A full configuration MUST NOT become ready for a current nonempty partial, none, or unknown scope and any later incomplete period becomes action_required with REPORTING_COVERAGE_INCOMPLETE. allow_partial MAY become ready when some scope is covered, but every obligation and revision freezes exact coverage and aggregate consumers keep the partial label." }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/reporting-delivery-method.json b/static/schemas/source/core/reporting-delivery-method.json index ca624c3c13f..0109a93bebe 100644 --- a/static/schemas/source/core/reporting-delivery-method.json +++ b/static/schemas/source/core/reporting-delivery-method.json @@ -26,7 +26,7 @@ "format": { "type": "string", "enum": ["jsonl", "csv", "parquet", "avro", "orc"], "description": "Physical file format." } }, "required": ["pattern", "transport", "orchestration", "destination", "format"], - "additionalProperties": false + "additionalProperties": true }, { "title": "Dataset share", @@ -38,7 +38,7 @@ "destination": { "$ref": "/schemas/core/reporting-dataset-share-destination.json" } }, "required": ["pattern", "transport", "orchestration", "destination"], - "additionalProperties": false + "additionalProperties": true }, { "title": "Warehouse materialization", @@ -50,7 +50,7 @@ "destination": { "$ref": "/schemas/core/reporting-write-destination.json" } }, "required": ["pattern", "transport", "orchestration", "destination"], - "additionalProperties": false + "additionalProperties": true } ] } diff --git a/static/schemas/source/core/reporting-delivery-offering.json b/static/schemas/source/core/reporting-delivery-offering.json index 835b3528be9..1a3e4ce9a39 100644 --- a/static/schemas/source/core/reporting-delivery-offering.json +++ b/static/schemas/source/core/reporting-delivery-offering.json @@ -76,7 +76,7 @@ "canonicalization_sha256": { "type": "string", "pattern": "^[A-Fa-f0-9]{64}$", "description": "Digest of the exact canonicalization contract identified by canonicalization_id." } }, "required": ["id", "version", "schema_uri", "schema_sha256", "schema_dialect", "schema_ref_policy", "grain", "primary_keys"], - "additionalProperties": false + "additionalProperties": true }, "schedule": { "$ref": "/schemas/core/reporting-schedule-offering.json", "description": "Period and availability SLA this offering can honor. For example, PT1H with snapshot finality explicitly advertises hourly provisional snapshots; a separate P1D official offering advertises daily finalized reporting." }, "supported_finality": { "type": "array", "items": { "$ref": "/schemas/enums/reporting-finality.json" }, "minItems": 1, "uniqueItems": true, "description": "Finality classes available under this exact report definition, schedule, and delivery method. snapshot is an explicit provisional capability, not inferred from poll frequency. Use separate atomic offerings when snapshot and official schedules or methods differ." }, @@ -89,21 +89,21 @@ "transport": { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[a-z][a-z0-9_.-]*$" }, "orchestration": { "$ref": "/schemas/core/reporting-delivery-method.json#/definitions/ReportingOrchestration" }, "destination_modes": { "type": "array", "items": { "type": "string", "enum": ["provision", "existing"] }, "minItems": 1, "uniqueItems": true }, - "provider": { "type": "object", "properties": { "domain": { "type": "string", "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$", "maxLength": 253 } }, "required": ["domain"], "additionalProperties": false }, + "provider": { "type": "object", "properties": { "domain": { "type": "string", "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$", "maxLength": 253 } }, "required": ["domain"], "additionalProperties": true }, "format": { "type": "string", "enum": ["jsonl", "csv", "parquet", "avro", "orc"] }, "access_mode": { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[a-z][a-z0-9_.-]*$" }, "producer_identity": { "type": "object", "description": "Seller principal a buyer grants access to for this exact buyer-hosted destination offering.", "properties": { - "provider": { "type": "object", "properties": { "domain": { "type": "string", "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$", "maxLength": 253 } }, "required": ["domain"], "additionalProperties": false }, + "provider": { "type": "object", "properties": { "domain": { "type": "string", "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$", "maxLength": 253 } }, "required": ["domain"], "additionalProperties": true }, "identity": { "type": "string", "minLength": 1, "maxLength": 512 }, "cloud": { "$ref": "/schemas/core/reporting-dataset-share-destination.json#/definitions/ReportingCloud" }, "region": { "type": "string", "minLength": 1, "maxLength": 128 } }, "required": ["provider", "identity"], "dependencies": { "cloud": ["region"], "region": ["cloud"] }, - "additionalProperties": false + "additionalProperties": true }, "reader_compatibility": { "type": "array", "items": { "$ref": "/schemas/core/reporting-resource.json#/definitions/ReportingReaderCompatibilityItem" }, "uniqueItems": true, "maxItems": 32 } }, @@ -122,7 +122,7 @@ "then": { "required": ["access_mode"] } } ], - "additionalProperties": false + "additionalProperties": true } }, "required": ["offering_id", "feed_purpose", "report_definition_id", "report_definition_uri", "report_definition_sha256", "reporting_profile", "schedule", "supported_finality", "reconciliation_mode"], @@ -155,5 +155,5 @@ "safe_schema_fetch": "schema_uri, canonicalization_uri, and report_definition_uri origins must be the authenticated seller, the named provider, or an AdCP registry. Reject userinfo, IP literals, localhost, private/reserved DNS results, redirects, and DNS/connect-target mismatch; pin resolution, cap bytes/time, require the expected content type, verify the corresponding SHA-256 before parsing, and cache by digest. The canonicalization and report-definition documents MUST validate against their AdCP contract schemas. The fetched row schema's $schema MUST equal schema_dialect, whose metaschema is SDK-bundled and never network-fetched. Before compiling with no network-capable resolver installed, recursively reject every $ref not beginning with #, all $dynamicRef and $recursiveRef keywords, cyclic references, excessive depth/node count, oversized regexes, and unsupported vocabularies. Fetched content and annotations are untrusted data, never agent or LLM instructions.", "snapshot_declaration": "A snapshot claim is the atomic combination of supported_finality containing snapshot, this exact schedule, report definition/profile, and delivery method. Sellers MUST NOT imply a faster snapshot cadence from polling, webhook, or transport support that is not advertised by such an offering." }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/reporting-delivery-ready-webhook.json b/static/schemas/source/core/reporting-delivery-ready-webhook.json index 171c800fcde..97c9de7d2ba 100644 --- a/static/schemas/source/core/reporting-delivery-ready-webhook.json +++ b/static/schemas/source/core/reporting-delivery-ready-webhook.json @@ -3,7 +3,7 @@ "$id": "/schemas/core/reporting-delivery-ready-webhook.json", "title": "Reporting Delivery Ready Webhook", "x-status": "experimental", - "description": "Compact account-anchored readiness doorbell registered through sync_accounts notification_configs using reporting.delivery_ready. Managed-delivery tier only: it names a materialization at a destination, so Core (API-delivered) configurations never fire it — Core consumers subscribe to reporting.status_changed and poll get_reporting_status. The named revision/materialization MUST already be observable through the intended consumer path. Transport retries are deduplicated by (authenticated sender, idempotency_key); downstream ingestion is deduplicated independently by reporting_revision_id and reporting_materialization_id. Ordering is unconstrained and receivers repair through authenticated get_reporting_status. The event MUST be signed using the advertised AdCP webhook-signing profile and MUST NOT contain rows, object lists, signed URLs, activation URLs, credentials, or access tokens.", + "description": "Compact account-anchored readiness doorbell registered through sync_accounts notification_configs using reporting.delivery_ready. Managed-delivery tier only: it names a materialization at a destination, so Core (API-delivered) configurations never fire it — Core consumers subscribe to reporting.status_changed and poll get_reporting_status. The named revision/materialization MUST already be observable through the intended consumer path. Transport retries are deduplicated by (authenticated sender, idempotency_key); downstream ingestion is deduplicated independently by reporting_revision_id and reporting_materialization_id. Ordering is unconstrained and receivers repair through authenticated get_reporting_status. The event MUST be signed using the advertised AdCP webhook-signing profile and MUST NOT contain rows, object lists, signed URLs, activation URLs, credentials, or access tokens. Rejects `access_token`: the webhook never carries a bearer credential, and the receiver fetches with its own credentials.", "type": "object", "properties": { "idempotency_key": { @@ -105,5 +105,6 @@ "authorization": "The authenticated webhook signer, subscriber_id, account_id, configuration generation, revision, and materialization MUST belong to one caller/account binding; receivers MUST repair through an authenticated status read rather than trusting event contents alone.", "deduplication": "Deduplicate transport retries by (authenticated sender, idempotency_key), then deduplicate ingestion independently by reporting_revision_id and reporting_materialization_id." }, - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["access_token"] } } diff --git a/static/schemas/source/core/reporting-file-entry.json b/static/schemas/source/core/reporting-file-entry.json index 5be88467439..1bbea3c1b0c 100644 --- a/static/schemas/source/core/reporting-file-entry.json +++ b/static/schemas/source/core/reporting-file-entry.json @@ -18,5 +18,5 @@ } }, "required": ["object_ref", "size_bytes", "sha256", "row_count"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/reporting-file-manifest.json b/static/schemas/source/core/reporting-file-manifest.json index f1747cfedb4..bbcf54ff99f 100644 --- a/static/schemas/source/core/reporting-file-manifest.json +++ b/static/schemas/source/core/reporting-file-manifest.json @@ -19,7 +19,7 @@ "source_timezone": { "type": "string", "minLength": 1 } }, "required": ["start", "end", "source_timezone"], - "additionalProperties": false + "additionalProperties": true }, "format": { "type": "string", "enum": ["jsonl", "csv", "parquet", "avro", "orc"] }, "compression": { "$ref": "/schemas/core/reporting-file-compression.json" }, @@ -43,5 +43,5 @@ "object_set": "object_ref values MUST be unique. total_size_bytes and row_count MUST equal the sums across files. Every file checksum MUST be verified before downstream commit.", "identity_match": "The revision, obligation, materialization, period, format, row count, and control totals MUST equal the referenced ledger records and verification evidence." }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/reporting-ledger-changed-webhook.json b/static/schemas/source/core/reporting-ledger-changed-webhook.json index 657499d94e9..83cb38a5ed0 100644 --- a/static/schemas/source/core/reporting-ledger-changed-webhook.json +++ b/static/schemas/source/core/reporting-ledger-changed-webhook.json @@ -37,5 +37,5 @@ "x-adcp-validation": { "logical_record": "One destination-independent revision or adjustment produces one logical account event even when it fans out through multiple obligations or delivery configurations. Receivers use changes_after to resolve the affected obligations and deduplicate by the immutable record identity." }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/reporting-materialization.json b/static/schemas/source/core/reporting-materialization.json index a9c03bc0e07..6f491cbd2af 100644 --- a/static/schemas/source/core/reporting-materialization.json +++ b/static/schemas/source/core/reporting-materialization.json @@ -71,5 +71,5 @@ "obligation_match": "reporting_obligation_id, delivery_config_id, delivery_config_version, destination_ref, feed_purpose, and method MUST match one caller/account-bound obligation. This join is what permits one revision to fan out to many destinations and principals.", "authorization": "The caller MUST be authorized for the referenced account and destination binding. Cross-caller and cross-account identifiers MUST be rejected without revealing whether they exist." }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/reporting-obligation.json b/static/schemas/source/core/reporting-obligation.json index 024c350e1f4..f7e79dcd43b 100644 --- a/static/schemas/source/core/reporting-obligation.json +++ b/static/schemas/source/core/reporting-obligation.json @@ -99,7 +99,7 @@ "end", "source_timezone" ], - "additionalProperties": false + "additionalProperties": true }, "expected_at": { "type": "string", @@ -464,5 +464,5 @@ "core_readability": "For a Core (API-delivered) obligation — no destination_ref — healthy and complete assert an authoritative readable revision: production_status published, at least one immutable revision retained per status_retention_days, and readable through the existing get_media_buy_delivery and reporting_webhook transports. An open REVISION_UNREADABLE issue for any revision of the obligation also blocks healthy and complete. Managed-delivery obligations additionally require at least one successful retained materialization.", "consumer_mismatch": "Consumer status is separately attributed and never satisfies production or billing reconciliation. A current statement that conflicts with the seller's otherwise healthy/complete projection degrades only this authenticated caller/account view with a CONSUMER_STATUS_MISMATCH issue carrying opened_at and the causing reporting_status_id. Conflicts are obligation_missing, revision_missing, unreadable, content_mismatch, and received naming a revision that is no longer the current required revision after a seller restatement. Every conflict except that last one is immediately action_required. A received statement made stale only by a seller restatement is delayed until the grace deadline defined by get-reporting-status-response.json stale_received_grace — the first superseding revision's created_at plus the configuration generation's schedule.delivery_sla, or automated_recovery_window_seconds when that SLA resolves to zero — and action_required at or after it, because the buyer consumed exactly what the seller then required and has not yet had a bounded chance to re-read. Later restatements do not restart that window, and an advertised consumer_mismatch_escalation_seconds boundary takes precedence over it. The issue keeps one issue_id and one opened_at across that severity change, and is retired only under reporting-status-issue.json consumer_mismatch_lifecycle. An exact bilateral waiver retires the issue and restores this obligation's underlying seller health even while current_consumer_status_id continues to name the immutable causing statement; a later statement or materially different conflict is evaluated independently. The seller assigns responsible_party from the diagnosed cause; an uncorroborated consumer statement or waiver never changes another caller's view or seller-advertised reliability_statistics. Absence of consumer status is never a conflict: after expected_at plus automated_recovery_window_seconds it is counted in the response's obligation_counts.consumer_status_pending and changes no health." }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/reporting-receipt.json b/static/schemas/source/core/reporting-receipt.json index 8c916ca5d6b..539ac93fac8 100644 --- a/static/schemas/source/core/reporting-receipt.json +++ b/static/schemas/source/core/reporting-receipt.json @@ -56,5 +56,5 @@ "acceptance_match": "accepted requires exact equality with the selected materialization verification evidence: row count and control totals always; canonical digest or manifest digest when selected. A mismatch MUST be submitted or recorded as rejected.", "immutability": "A reporting_receipt_id is immutable. Exact retries are idempotent; reuse with different content is a conflict. A consumer retains one current leaf per obligation and revision: a new ID may supersede only that current rejected leaf. History remains append-only; an accepted current leaf is terminal." }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/reporting-reliability-statistics.json b/static/schemas/source/core/reporting-reliability-statistics.json index 0b723871724..acede5882de 100644 --- a/static/schemas/source/core/reporting-reliability-statistics.json +++ b/static/schemas/source/core/reporting-reliability-statistics.json @@ -13,7 +13,7 @@ "p95": { "type": "integer", "minimum": 0 } }, "required": ["p50", "p95"], - "additionalProperties": false + "additionalProperties": true }, "ReportingReliabilityMeasurementPeriod": { "type": "object", @@ -22,7 +22,7 @@ "end": { "type": "string", "format": "date-time" } }, "required": ["start", "end"], - "additionalProperties": false + "additionalProperties": true } }, "properties": { @@ -47,7 +47,7 @@ "p95_absolute_delta": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$", "maxLength": 32 } }, "required": ["control_total_name", "unit", "sample_count", "p50_absolute_delta", "p95_absolute_delta"], - "additionalProperties": false + "additionalProperties": true }, "uniqueItems": true, "maxItems": 16 @@ -68,7 +68,7 @@ "else": { "not": { "anyOf": [{ "required": ["attestation_uri"] }, { "required": ["attestation_sha256"] }] } } } ], - "additionalProperties": false + "additionalProperties": true } }, "required": ["offering_id", "measurement_period", "obligations_due", "obligations_on_time", "official_revisions_published", "official_revisions_adjusted", "publication_latency_seconds", "evidence"], @@ -83,5 +83,5 @@ "comparability": "Statistics MUST use the exact selected offering semantics and complete measurement period. Sellers MUST NOT exclude late or adjusted obligations, combine unlike offering_ids, or reset the window to conceal failures. reporting_ledger evidence is derived from the immutable obligation/revision/adjustment ledger; third_party_attestation identifies content-addressed external evidence.", "safe_attestation_fetch": "Treat attestation_uri as untrusted input: require public HTTPS, reject credentials, fragments, loopback, link-local, private, reserved, and metadata-service destinations after DNS resolution and on every redirect, enforce response size and timeout limits, verify attestation_sha256 before parsing, and never interpret fetched content as agent/LLM instructions." }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/reporting-report-definition.json b/static/schemas/source/core/reporting-report-definition.json index 941dc2319a5..f8d115737c9 100644 --- a/static/schemas/source/core/reporting-report-definition.json +++ b/static/schemas/source/core/reporting-report-definition.json @@ -23,14 +23,14 @@ "source": { "type": "object", "properties": { - "provider": { "type": "object", "properties": { "domain": { "type": "string", "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$" } }, "required": ["domain"], "additionalProperties": false }, + "provider": { "type": "object", "properties": { "domain": { "type": "string", "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$" } }, "required": ["domain"], "additionalProperties": true }, "system": { "type": "string", "minLength": 1, "maxLength": 128 }, "api_version": { "type": "string", "minLength": 1, "maxLength": 128 }, "query_semantics": { "type": "object", "description": "Canonical JSON object containing every source option that can change the numbers, including attribution settings, action-report-time, filters, and mapping version." }, "custody": { "$ref": "/schemas/enums/reporting-custody.json", "description": "Whether the producer is the system of record for the numbers or derived them from the upstream provider and system named in this source. Optional; omitted means the definition makes no custody claim. Fixed per definition by report_definition_sha256, so no per-revision field exists.", "x-added-in": "3.3.0" } }, "required": ["provider", "system", "api_version", "query_semantics"], - "additionalProperties": false + "additionalProperties": true }, "calendar": { "type": "object", @@ -42,7 +42,7 @@ "allOf": [ { "if": { "properties": { "timezone_basis": { "const": "configured_timezone" } }, "required": ["timezone_basis"] }, "then": { "required": ["timezone"] }, "else": { "not": { "required": ["timezone"] } } } ], - "additionalProperties": false + "additionalProperties": true }, "metrics": { "type": "array", @@ -55,7 +55,7 @@ "unit": { "type": "string", "minLength": 1, "maxLength": 64 } }, "required": ["name", "source_expression", "aggregation"], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1 }, @@ -68,7 +68,7 @@ "official_correction_mode": { "type": "string", "const": "adjustments_only", "description": "Once an official revision is published it is immutable and cannot be superseded. Later source corrections are separate reporting-adjustment records applied to a later accounting period." } }, "required": ["source_requery_duration", "emit_only_on_content_change"], - "additionalProperties": false + "additionalProperties": true }, "finality_policies": { "type": "array", @@ -82,7 +82,7 @@ "source_signal": { "type": "string", "minLength": 1, "maxLength": 512 } }, "required": ["finality_policy_id", "basis", "source_signal"], - "additionalProperties": false + "additionalProperties": true }, { "type": "object", @@ -92,7 +92,7 @@ "duration_after_period_end": { "type": "string", "pattern": "^P(?=\\d|T)(?=.*\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?=\\d)(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$" } }, "required": ["finality_policy_id", "basis", "duration_after_period_end"], - "additionalProperties": false + "additionalProperties": true }, { "type": "object", @@ -103,7 +103,7 @@ "unchanged_for": { "type": "string", "pattern": "^P(?=\\d|T)(?=.*\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?=\\d)(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$" } }, "required": ["finality_policy_id", "basis", "minimum_age", "unchanged_for"], - "additionalProperties": false + "additionalProperties": true } ] }, @@ -121,5 +121,5 @@ "binding": "report_definition_id and reporting_profile MUST equal the selected offering. finality_policy_id values MUST be unique. Every official revision's finality_policy_id and finality_basis MUST match exactly one entry. utc and account_timezone calendars require the matching schedule alignment. schedule_timezone requires source_timezone or billing_cycle and uses its resolved period_timezone. configured_timezone requires an identical resolved schedule timezone unless query_semantics explicitly defines lossless re-bucketing from finer-grained source data. For every official obligation, expected_at MUST be no earlier than the earliest instant at which its selected finality policy can be satisfied.", "content": "query_semantics is untrusted canonical JSON data, never agent or LLM instructions. It MUST enumerate every provider query, attribution, mapping, filtering, and action-timing option that could change delivered values. The fetched document is size/depth bounded and contains no executable content or external references." }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/reporting-resource.json b/static/schemas/source/core/reporting-resource.json index e75afcf89e0..c599eac7c0c 100644 --- a/static/schemas/source/core/reporting-resource.json +++ b/static/schemas/source/core/reporting-resource.json @@ -39,5 +39,5 @@ "x-adcp-validation": { "retention": "expires_at MUST be no earlier than the owning obligation.resource_retained_until and publication plus advertised resource_retention_days. A completed obligation cannot rely on deterministic rematerialization in place of a readable exact resource." }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/reporting-revision.json b/static/schemas/source/core/reporting-revision.json index dac207d6c2e..7068b506fa6 100644 --- a/static/schemas/source/core/reporting-revision.json +++ b/static/schemas/source/core/reporting-revision.json @@ -3,7 +3,7 @@ "$id": "/schemas/core/reporting-revision.json", "title": "Reporting Revision", "x-status": "experimental", - "description": "One immutable emitted version of logical reporting content. The revision is destination-independent: one canonical revision may fan out through many caller/account-bound obligations and materializations, including file, warehouse, and dataset-share destinations. The report_definition_id plus period and scope identify the logical slice; provisional restatements create a new snapshot revision and keep the superseded snapshot's metadata for the advertised retention window; content_retention defines which superseded content stays readable. An official revision is terminal; later corrections are separate reporting adjustments.", + "description": "One immutable emitted version of logical reporting content. The revision is destination-independent: one canonical revision may fan out through many caller/account-bound obligations and materializations, including file, warehouse, and dataset-share destinations. The report_definition_id plus period and scope identify the logical slice; provisional restatements create a new snapshot revision and keep the superseded snapshot's metadata for the advertised retention window; content_retention defines which superseded content stays readable. An official revision is terminal; later corrections are separate reporting adjustments. Rejects `destination_ref`: a revision is destination-independent.", "type": "object", "properties": { "reporting_revision_id": { "type": "string", "minLength": 1, "maxLength": 255, "pattern": "^[A-Za-z0-9_.:-]{1,255}$", "x-entity": "reporting_revision", "description": "Portable AdCP identity for this immutable report publication. Distinct from package delivery_revision_id and provider-native versions." }, @@ -29,7 +29,7 @@ "source_timezone": { "type": "string", "minLength": 1 } }, "required": ["start", "end", "source_timezone"], - "additionalProperties": false + "additionalProperties": true }, "finality": { "$ref": "/schemas/enums/reporting-finality.json" }, "finality_basis": { "type": "string", "enum": ["source_final", "contractual_cutoff", "stabilized"], "description": "Why an official revision is considered final: an authoritative source signal, a versioned contractual cutoff, or a versioned stabilization rule." }, @@ -72,5 +72,6 @@ "content_retention": "A revision's retention window is status_retention_days measured from its created_at. Once a later revision names it in supersedes_reporting_revision_id, the window runs from that successor's created_at instead. An official revision's window runs from the latest created_at among the revision and the reporting adjustments whose adjusts_reporting_revision_id names it. Metadata for every revision stays queryable throughout its window. Within its window, the seller MUST keep a revision's content readable through exact reads when the revision is (a) the current, unsuperseded revision of its logical slice, which includes every official revision; (b) the revision that the current revision names in supersedes_reporting_revision_id; (c) a superseded snapshot within its recovery grace, which runs from its successor's created_at for automated_recovery_window_seconds or one hour, whichever is longer; or (d) named, for the requesting caller, by that caller's own reporting receipt in any status or by its current consumer status statement with status received, unreadable, or content_mismatch. The seller MAY compact any other superseded snapshot revision to metadata only, and MAY retain content longer than required. An exact read of a revision whose window has ended, or whose content was compacted under this rule, returns the same nondisclosing REFERENCE_NOT_FOUND as an unknown ID. A caller can tell compaction from failure using the ledger and its own receipts and statements: a revision covered by (a) through (d) whose content cannot be served is REVISION_UNREADABLE, never REFERENCE_NOT_FOUND. A seller that keeps obligation metadata after its authoritative revision's window ends MUST treat that period as outside retained coverage (scope.ledger_retained_from), never as complete. Compaction under this rule takes effect only in the next eligible minor release after November 20, 2026. Until then, sellers keep every superseded snapshot's content readable throughout its window.", "digest_requirement": "revision_content_sha256 is required for every revision and is SHA-256 of RFC 8785 JCS for {reporting_revision_id,row_count,control_totals,reporting_rows}. Exact revision reads MUST return metadata, rows, ID, count, totals, and this digest identically to status. canonical_content_digest is separate external-materialization evidence: it is optional for non-billing delivery profiles and mandatory when a referenced materialization selects canonical_digest and for every billing obligation." }, - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["destination_ref"] } } diff --git a/static/schemas/source/core/reporting-schedule-offering.json b/static/schemas/source/core/reporting-schedule-offering.json index 00e249c2f4c..c0516fa2ea6 100644 --- a/static/schemas/source/core/reporting-schedule-offering.json +++ b/static/schemas/source/core/reporting-schedule-offering.json @@ -55,5 +55,5 @@ "iana_timezone": "Every advertised fixed period_timezone MUST be a recognized IANA Time Zone Database zone name or link, including UTC. Unknown identifiers and numeric UTC offsets are invalid.", "source_compatibility": "The resolved schedule MUST be compatible with the pinned report definition calendar. A seller MUST NOT advertise or accept a schedule merely because it can query the source eventually; it must be able to produce the exact promised periods natively or through lossless finer-grained re-bucketing." }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/reporting-schedule.json b/static/schemas/source/core/reporting-schedule.json index 3a01c54a0ea..fc46c95968f 100644 --- a/static/schemas/source/core/reporting-schedule.json +++ b/static/schemas/source/core/reporting-schedule.json @@ -42,5 +42,5 @@ "iana_timezone": "Every period_timezone and echoed period.source_timezone value MUST be a recognized IANA Time Zone Database zone name or link, including UTC. Reject unknown identifiers before accepting a configuration; do not silently substitute the host timezone or a numeric offset.", "source_compatibility": "Before accepting a configuration, the seller MUST prove that its upstream source can produce every configured half-open period exactly, either natively or by lossless re-bucketing from finer-grained source data. source_timezone MUST equal the upstream reporting calendar used by the pinned report definition. A structural incompatibility MUST fail configuration validation and MUST NOT be represented as indefinitely waiting reporting. If incompatibility is discovered after acceptance, the configuration becomes action_required with the seller responsible." }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/reporting-status-changed-webhook.json b/static/schemas/source/core/reporting-status-changed-webhook.json index 61ee85751c7..439828eeed2 100644 --- a/static/schemas/source/core/reporting-status-changed-webhook.json +++ b/static/schemas/source/core/reporting-status-changed-webhook.json @@ -108,7 +108,7 @@ "x-adcp-validation": { "waived_mismatch_transition": "When an exact bilateral CONSUMER_STATUS_MISMATCH waiver removes the last impairment and restores underlying seller health, this is a recovery health transition. A seller advertising reporting.status_changed MUST fire it after the recovered projection is readable, with health set to healthy or complete, previous_health set to delayed or action_required, and issue_ids empty or absent. If another impairment keeps health unchanged, no reporting.status_changed fire is required; polling get_reporting_status remains authoritative." }, - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "description": "Clock-driven transition to delayed with a stable issue id", diff --git a/static/schemas/source/core/reporting-status-issue.json b/static/schemas/source/core/reporting-status-issue.json index d6c3392cb12..eb0df83f2f8 100644 --- a/static/schemas/source/core/reporting-status-issue.json +++ b/static/schemas/source/core/reporting-status-issue.json @@ -186,5 +186,5 @@ "consumer_mismatch_escalation": "A CONSUMER_STATUS_MISMATCH issue MUST carry opened_at and the reporting_status_id that caused it. When the seller advertises consumer_mismatch_escalation_seconds, an open or acknowledged issue still unresolved at opened_at plus that window MUST be emitted at severity action_required with a recommended_action in the contact_ family — contact_buyer, contact_seller, or contact_provider — naming the diagnosed responsible_party, and the seller MUST advertise operations_contact so the named party is reachable. wait_for_retry MUST NOT survive the escalation boundary: an unattended mismatch is an escalation, not a retry. This escalation takes precedence over the stale-received grace window in get-reporting-status-response.json: when the two windows overlap, the escalation boundary wins and the issue is action_required even if the grace window has not closed. An issue already retired under consumer_mismatch_lifecycle is not subject to this rule, because it is no longer in issues[].", "revision_unreadable": "REVISION_UNREADABLE means the seller cannot currently serve or verify the content of a published revision that it still owes through exact reads within status_retention_days. Examples: the stored rows are missing, or they no longer reproduce row_count, control_totals, and revision_content_sha256. PRODUCTION_FAILED does not apply, because the revision was produced and published. The issue names one affected reporting_obligation_id and the reporting_revision_id. When one revision serves several of the caller's obligations, the seller emits one issue per obligation. An affected obligation is neither healthy nor complete while the issue is open. The issue is delayed with wait_for_retry while automatic repair is in progress, and action_required with contact_seller once the seller cannot restore the content automatically. While the issue is open, an exact read of the revision by a caller authorized for it MUST return SERVICE_UNAVAILABLE. It MUST NOT return REFERENCE_NOT_FOUND, and it MUST NOT return rows that fail the binding. Unauthorized callers still receive the nondisclosing REFERENCE_NOT_FOUND. The revision's metadata stays listed in the ledger. The issue is retired when exact reads again return content that matches the committed binding, or when content_retention in reporting-revision.json no longer requires the revision's content. If a later reporting adjustment makes a retired revision's content owed again and it is still unreadable, the seller opens a new issue with a new issue_id. A seller MUST NOT retire it by serving different content under the same reporting_revision_id. Because an official revision cannot be superseded, an obligation whose official revision is lost does not become complete." }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/reporting-subscription-coverage.json b/static/schemas/source/core/reporting-subscription-coverage.json index 205bee50f68..c79977bff8a 100644 --- a/static/schemas/source/core/reporting-subscription-coverage.json +++ b/static/schemas/source/core/reporting-subscription-coverage.json @@ -61,7 +61,7 @@ }, "minProperties": 1, "maxProperties": 1, - "additionalProperties": false + "additionalProperties": true } }, "required": ["reason", "from"], @@ -80,7 +80,7 @@ "then": { "required": ["media_buy_id"], "properties": { "reason": { "enum": ["offering_unsupported", "overridden"] } } } } ], - "additionalProperties": false + "additionalProperties": true } }, "timezone_cutovers": { @@ -95,7 +95,7 @@ "timezone": { "type": "string", "minLength": 1, "maxLength": 255, "description": "The account's new IANA timezone, as list_accounts shows it." } }, "required": ["effective_at", "timezone"], - "additionalProperties": false + "additionalProperties": true } }, "gaps": { @@ -110,7 +110,7 @@ "reason": { "type": "string", "enum": ["unauthorized"] } }, "required": ["from", "until", "reason"], - "additionalProperties": false + "additionalProperties": true } } }, @@ -141,7 +141,7 @@ }, { "if": { "properties": { "status": { "const": "inactive" } }, "required": ["status"] }, "then": { "required": ["deactivated_at"] }, "else": { "not": { "required": ["deactivated_at"] } } } ], - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "description": "Active account: one buy's products carry no matching offering, and an earlier capacity refusal has ended", diff --git a/static/schemas/source/core/reporting-subscription-state.json b/static/schemas/source/core/reporting-subscription-state.json index e44acf783fe..829193a7b6d 100644 --- a/static/schemas/source/core/reporting-subscription-state.json +++ b/static/schemas/source/core/reporting-subscription-state.json @@ -34,7 +34,7 @@ "accepted_at", "superseded_at" ], - "additionalProperties": false + "additionalProperties": true }, "ReportingSubscriptionAccountExceptions": { "title": "Reporting Subscription Account Exceptions", @@ -66,7 +66,7 @@ "account_id", "reasons" ], - "additionalProperties": false + "additionalProperties": true }, "ReportingSubscriptionUnauthorizedAccount": { "title": "Reporting Subscription Unauthorized Account", @@ -111,7 +111,7 @@ "unauthorized_at", "withheld_period_count" ], - "additionalProperties": false + "additionalProperties": true } }, "properties": { @@ -156,7 +156,7 @@ "reactivated_at": { "type": "string", "format": "date-time", "description": "When active true was applied again. Absent for the current interval while the subscription is inactive." } }, "required": ["deactivated_at"], - "additionalProperties": false + "additionalProperties": true } }, "destination_ref": { @@ -196,7 +196,7 @@ "destination_ref": { "type": "string", "minLength": 1, "maxLength": 255, "x-entity": "reporting_destination" } }, "required": ["destination_id", "destination_ref"], - "additionalProperties": false + "additionalProperties": true } }, "accounts_unauthorized": { @@ -223,5 +223,5 @@ "else": { "not": { "required": ["deactivated_at"] } } } ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/reporting-subscription.json b/static/schemas/source/core/reporting-subscription.json index f19e6753e01..723891f58df 100644 --- a/static/schemas/source/core/reporting-subscription.json +++ b/static/schemas/source/core/reporting-subscription.json @@ -40,7 +40,7 @@ }, "minProperties": 1, "maxProperties": 1, - "additionalProperties": false + "additionalProperties": true }, "exclude_account_ids": { "type": "array", @@ -60,7 +60,7 @@ }, "selector": { "type": "object", - "description": "Offering attributes that are stable across sellers. The seller resolves the selector separately for each account and its products. An account, buy, or package with no matching offering is excluded with reason offering_unsupported; that never fails the subscription.", + "description": "Offering attributes that are stable across sellers. The seller resolves the selector separately for each account and its products. An account, buy, or package with no matching offering is excluded with reason offering_unsupported; that never fails the subscription. Rejects `offering_id`: the selector chooses by stable attributes, never by a seller-specific offering.", "properties": { "feed_purpose": { "type": "string", "enum": ["pacing", "analytics", "billing"], "description": "Same values as the offering feed_purpose." }, "period_duration": { @@ -96,7 +96,8 @@ } }, "required": ["feed_purpose", "period_duration", "required_finality"], - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["offering_id"] } }, "reconciliation_mode": { "$ref": "/schemas/core/reporting-reconciliation-mode.json", @@ -127,7 +128,7 @@ } }, "required": ["destination_id"], - "additionalProperties": false + "additionalProperties": true }, "destination_overrides": { "type": "array", @@ -151,7 +152,7 @@ "then": { "properties": { "path_template": { "pattern": "\\{account_id\\}" } } } }, "else": { "required": ["operator_domains"], "properties": { "path_template": { "pattern": "\\{account_id\\}" } } }, - "additionalProperties": false + "additionalProperties": true } } }, @@ -208,7 +209,7 @@ "delivery_within_flight": "A seller advertising media_buy.reporting_subscriptions, or holding an active billing generation of an account-level reporting_delivery_configs entry for the buy's account (reporting-delivery-config.json billing_continuity), MUST NOT deliver on a buy outside its flight, from start_time to the stop time defined in coverage, so all delivery on a buy falls in periods the coverage rule owes. To deliver past the stop time, including make-good delivery under makegood_policy additional_delivery on the same buy, the seller first extends end_time, recorded on the buy and advancing its revision before that delivery starts; the added periods are then still unresolved, so the coverage rule owes them. A canceled or completed buy is not extended: make-good delivery for it goes on a subsequent buy in the same account, which is covered like any other buy.", "destination": "destination_id, and every destination_overrides destination_id, MUST name a destination present in the caller's reporting_destinations after the same request applies; otherwise the whole request fails. Each account's data goes to the destination of the account_ids override naming it, else the operator_domains override naming its operator, else destination. When more than one active subscription of the caller shares a destination, every path_template MUST contain {account_id} and the templates MUST differ. Destination proof establishes where data may go, never which account data the caller may receive: every delivery re-checks account authority. Every delivered row carries account_id, set to the account the row reports. A seller advertising media_buy.reporting_subscriptions MUST publish, on every managed-delivery offering (one with method), a reporting_profile whose row schema declares account_id as a required string property and whose primary_keys include account_id, so rows from several accounts in one consolidated destination validate and never collide. An SDK refuses an offering that breaks this with SUBSCRIPTIONS_REQUIRE_ACCOUNT_ID_KEY (reporting-delivery-offering.json subscription_rows)." }, - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "description": "Daily official analytics for every authorized account, partitioned by account", diff --git a/static/schemas/source/core/reporting-verification.json b/static/schemas/source/core/reporting-verification.json index f11a8cc2b42..51aa1a2838e 100644 --- a/static/schemas/source/core/reporting-verification.json +++ b/static/schemas/source/core/reporting-verification.json @@ -31,7 +31,7 @@ "value": { "type": "string", "pattern": "^[A-Fa-f0-9]{64}$" } }, "required": ["object_ref", "algorithm", "value"], - "additionalProperties": false + "additionalProperties": true }, { "title": "SHA-512 physical checksum", @@ -42,7 +42,7 @@ "value": { "type": "string", "pattern": "^[A-Fa-f0-9]{128}$" } }, "required": ["object_ref", "algorithm", "value"], - "additionalProperties": false + "additionalProperties": true } ] }, @@ -56,7 +56,7 @@ "observed_through": { "type": "string", "enum": ["representative_consumer", "destination"] } }, "required": ["native_version_ref", "observed_through"], - "additionalProperties": false + "additionalProperties": true } }, "required": ["verified_at", "verification_path", "verification_profile", "row_count", "control_totals"], @@ -80,5 +80,5 @@ "native_version_match": "When native_commit_evidence is present, native_version_ref MUST equal resource.native_version_ref and observed_through MUST match the consumer/destination verification path.", "checksum_binding": "Every physical_checksums.object_ref MUST be an object selected by this exact immutable resource/manifest; algorithm and value length MUST agree." }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/reporting-webhook.json b/static/schemas/source/core/reporting-webhook.json index df5723c0eec..1520a5b0440 100644 --- a/static/schemas/source/core/reporting-webhook.json +++ b/static/schemas/source/core/reporting-webhook.json @@ -48,7 +48,7 @@ "schemes", "credentials" ], - "additionalProperties": false + "additionalProperties": true }, "signing_profile": { "x-status": "experimental", diff --git a/static/schemas/source/core/representation-destination.json b/static/schemas/source/core/representation-destination.json index 35b855c3715..ce6aa263c9c 100644 --- a/static/schemas/source/core/representation-destination.json +++ b/static/schemas/source/core/representation-destination.json @@ -42,5 +42,5 @@ } }, "required": ["product_id", "format_option"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/representation-selection.json b/static/schemas/source/core/representation-selection.json index a9b0702c6b6..7a2846f2265 100644 --- a/static/schemas/source/core/representation-selection.json +++ b/static/schemas/source/core/representation-selection.json @@ -65,5 +65,5 @@ } }, "required": ["creative_id", "revision_id", "revision_content_digest", "selected_representation_id", "strategy", "selected_output_digest", "resolved_by"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/requirements/image-asset-requirements.json b/static/schemas/source/core/requirements/image-asset-requirements.json index ddb6b109619..2755308d825 100644 --- a/static/schemas/source/core/requirements/image-asset-requirements.json +++ b/static/schemas/source/core/requirements/image-asset-requirements.json @@ -63,7 +63,7 @@ }, "bleed": { "type": "object", - "description": "Required bleed area beyond the trim size. The submitted image must be larger than the declared dimensions: total width = trim width + left bleed + right bleed, total height = trim height + top bleed + bottom bleed. For uniform bleed: total = trim + (2 * uniform). Uses the same unit as the parent dimensions.", + "description": "Required bleed area beyond the trim size. The submitted image must be larger than the declared dimensions: total width = trim width + left bleed + right bleed, total height = trim height + top bleed + bottom bleed. For uniform bleed: total = trim + (2 * uniform). Uses the same unit as the parent dimensions. The uniform and per-side forms exclude each other.", "oneOf": [ { "properties": { @@ -74,7 +74,8 @@ } }, "required": ["uniform"], - "additionalProperties": false + "not": { "anyOf": [{ "required": ["top"] }, { "required": ["right"] }, { "required": ["bottom"] }, { "required": ["left"] }] }, + "additionalProperties": true }, { "properties": { @@ -84,7 +85,8 @@ "left": { "type": "number", "minimum": 0 } }, "required": ["top", "right", "bottom", "left"], - "additionalProperties": false + "not": { "required": ["uniform"] }, + "additionalProperties": true } ] }, diff --git a/static/schemas/source/core/rights-attestation-evaluation.json b/static/schemas/source/core/rights-attestation-evaluation.json index 9d7cc052951..82f4765c541 100644 --- a/static/schemas/source/core/rights-attestation-evaluation.json +++ b/static/schemas/source/core/rights-attestation-evaluation.json @@ -95,5 +95,5 @@ "scope": "Reusable evaluation of one exact rights grant by evaluation.evaluated_by. It is not a serving authorization and does not cover creative, media buy, use, country, delivery scope, or cap state.", "local_provenance": "A consumer MUST require outcome == verified and retrieve the byte-identical evaluation from its own local store keyed by (evaluation.evaluated_by, evaluation.reference_digest). It MUST reject buyer-authored, foreign-evaluator, missing-store, or locally mismatched readback even when evaluated_by names the consumer." }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/rights-constraint.json b/static/schemas/source/core/rights-constraint.json index f5ca6f37134..b9e17bfed80 100644 --- a/static/schemas/source/core/rights-constraint.json +++ b/static/schemas/source/core/rights-constraint.json @@ -119,7 +119,7 @@ "then": { "required": ["text"] } } ], - "additionalProperties": false + "additionalProperties": true }, "creative_approval_required": { "type": "boolean", diff --git a/static/schemas/source/core/seller-agent-ref.json b/static/schemas/source/core/seller-agent-ref.json index ea91b4b2dcd..6a86ef51f7c 100644 --- a/static/schemas/source/core/seller-agent-ref.json +++ b/static/schemas/source/core/seller-agent-ref.json @@ -19,7 +19,7 @@ } }, "required": ["agent_url"], - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "agent_url": "https://agent.acme.example" } ] diff --git a/static/schemas/source/core/signal-coverage-forecast.json b/static/schemas/source/core/signal-coverage-forecast.json index f1adae2074b..51a6b0024c8 100644 --- a/static/schemas/source/core/signal-coverage-forecast.json +++ b/static/schemas/source/core/signal-coverage-forecast.json @@ -149,5 +149,5 @@ } } ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/signal-definition-enrichment.json b/static/schemas/source/core/signal-definition-enrichment.json index 8d6c9730b92..7a3c76d306f 100644 --- a/static/schemas/source/core/signal-definition-enrichment.json +++ b/static/schemas/source/core/signal-definition-enrichment.json @@ -72,7 +72,7 @@ } }, "required": ["id"], - "additionalProperties": false + "additionalProperties": true } }, "value_mappings": { @@ -98,7 +98,7 @@ } }, "required": ["value", "taxonomy_value_id"], - "additionalProperties": false + "additionalProperties": true } }, "parent_match_behavior": { @@ -107,7 +107,7 @@ } }, "required": ["ref", "values"], - "additionalProperties": false + "additionalProperties": true }, "segmentation_criteria": { "type": "string", @@ -184,7 +184,7 @@ } }, "required": ["match_keys"], - "additionalProperties": false + "additionalProperties": true }, "countries": { "type": "array", @@ -227,7 +227,7 @@ } }, "required": ["type", "provider_signed"], - "additionalProperties": false + "additionalProperties": true }, "training_data_jurisdictions": { "type": "array", @@ -246,7 +246,7 @@ } }, "required": ["method", "seed_source", "training_data_jurisdictions", "ai_act_risk_class"], - "additionalProperties": false + "additionalProperties": true }, "data_subject_rights": { "type": "object", @@ -312,7 +312,7 @@ { "required": ["url"] }, { "required": ["email"] } ], - "additionalProperties": false + "additionalProperties": true } }, "response_sla_days": { @@ -327,7 +327,7 @@ } }, "required": ["channels"], - "additionalProperties": false + "additionalProperties": true }, "last_updated": { "type": "string", diff --git a/static/schemas/source/core/signal-definition.json b/static/schemas/source/core/signal-definition.json index a0e350c1b7d..56de34b6da5 100644 --- a/static/schemas/source/core/signal-definition.json +++ b/static/schemas/source/core/signal-definition.json @@ -87,7 +87,7 @@ } }, "required": ["min", "max"], - "additionalProperties": false + "additionalProperties": true }, "taxonomy": { "type": "object", @@ -136,7 +136,7 @@ } }, "required": ["id"], - "additionalProperties": false + "additionalProperties": true } }, "value_mappings": { @@ -167,7 +167,7 @@ } }, "required": ["value", "taxonomy_value_id"], - "additionalProperties": false + "additionalProperties": true } }, "parent_match_behavior": { @@ -181,7 +181,7 @@ } }, "required": ["ref", "values"], - "additionalProperties": false + "additionalProperties": true }, "segmentation_criteria": { "type": "string", @@ -267,7 +267,7 @@ } }, "required": ["match_keys"], - "additionalProperties": false + "additionalProperties": true }, "subject_type": { "$ref": "/schemas/enums/audience-subject-type.json", @@ -339,7 +339,7 @@ } }, "required": ["type", "provider_signed"], - "additionalProperties": false + "additionalProperties": true }, "training_data_jurisdictions": { "type": "array", @@ -361,7 +361,7 @@ } }, "required": ["method", "seed_source", "training_data_jurisdictions", "ai_act_risk_class"], - "additionalProperties": false + "additionalProperties": true }, "data_subject_rights": { "type": "object", @@ -434,7 +434,7 @@ { "required": ["url"] }, { "required": ["email"] } ], - "additionalProperties": false + "additionalProperties": true } }, "response_sla_days": { @@ -451,7 +451,7 @@ } }, "required": ["channels"], - "additionalProperties": false + "additionalProperties": true }, "last_updated": { "type": "string", diff --git a/static/schemas/source/core/signal-delivery-method.json b/static/schemas/source/core/signal-delivery-method.json index 1cbc4d35e03..c035f0eef93 100644 --- a/static/schemas/source/core/signal-delivery-method.json +++ b/static/schemas/source/core/signal-delivery-method.json @@ -3,7 +3,7 @@ "$id": "/schemas/core/signal-delivery-method.json", "title": "Signal Delivery Method", "x-status": "experimental", - "description": "One rail a signal agent can use to deliver licensed segment membership to an agent destination: the send-side reading of core/audience-activation-method.json, same pattern vocabulary, receiver-neutral fields only. Compatibility is pattern+vendor intersection with the destination's audience_activation.methods; receiver fields (destination_ref, consumer_identities, bind_expiry_days) are resolved from the destination at activation time. tmp_identity_match is excluded because no membership file moves. Experimental (signals.delivery_methods); see docs/reference/experimental-status.", + "description": "One rail a signal agent can use to deliver licensed segment membership to an agent destination: the send-side reading of core/audience-activation-method.json, same pattern vocabulary, receiver-neutral fields only. Compatibility is pattern+vendor intersection with the destination's audience_activation.methods; receiver fields (destination_ref, consumer_identities, bind_expiry_days) are resolved from the destination at activation time. tmp_identity_match is excluded because no membership file moves. Experimental (signals.delivery_methods); see docs/reference/experimental-status. The dataset_query pattern rejects `consumer_identities`, and the platform_distribution pattern rejects `destination_ref` and `bind_expiry_days`: the receive side resolves those from the destination at activation time.", "type": "object", "oneOf": [ { @@ -19,7 +19,7 @@ "required": [ "pattern" ], - "additionalProperties": false + "additionalProperties": true }, { "title": "File transfer", @@ -44,7 +44,7 @@ "transport", "vendor" ], - "additionalProperties": false + "additionalProperties": true }, { "title": "Dataset query", @@ -64,7 +64,8 @@ "pattern", "vendor" ], - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["consumer_identities"] } }, { "title": "Clean room", @@ -84,7 +85,7 @@ "pattern", "vendor" ], - "additionalProperties": false + "additionalProperties": true }, { "title": "Platform distribution", @@ -104,7 +105,8 @@ "pattern", "vendor" ], - "additionalProperties": false + "additionalProperties": true, + "not": { "anyOf": [{ "required": ["destination_ref"] }, { "required": ["bind_expiry_days"] }] } } ], "examples": [ diff --git a/static/schemas/source/core/signal-listing.json b/static/schemas/source/core/signal-listing.json index 2d1ee0e7a58..64370b92969 100644 --- a/static/schemas/source/core/signal-listing.json +++ b/static/schemas/source/core/signal-listing.json @@ -58,7 +58,7 @@ } }, "required": ["min", "max"], - "additionalProperties": false + "additionalProperties": true }, "restricted_attributes": { "type": "array", diff --git a/static/schemas/source/core/signal-modeling-disclosure.json b/static/schemas/source/core/signal-modeling-disclosure.json index 71d770f5519..a88af7e49ea 100644 --- a/static/schemas/source/core/signal-modeling-disclosure.json +++ b/static/schemas/source/core/signal-modeling-disclosure.json @@ -45,7 +45,7 @@ } }, "required": ["country", "regulation"], - "additionalProperties": false + "additionalProperties": true } }, "notes": { @@ -68,5 +68,5 @@ } } ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/spot-reporting-capability.json b/static/schemas/source/core/spot-reporting-capability.json index 3aa4527df92..1249834a813 100644 --- a/static/schemas/source/core/spot-reporting-capability.json +++ b/static/schemas/source/core/spot-reporting-capability.json @@ -31,5 +31,5 @@ } }, "required": ["available_metrics"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/store-item.json b/static/schemas/source/core/store-item.json index 4f5e5cfb624..20d78bca251 100644 --- a/static/schemas/source/core/store-item.json +++ b/static/schemas/source/core/store-item.json @@ -31,7 +31,7 @@ } }, "required": ["lat", "lng"], - "additionalProperties": false + "additionalProperties": true }, "address": { "type": "object", @@ -59,7 +59,7 @@ "description": "ISO 3166-1 alpha-2 country code." } }, - "additionalProperties": false + "additionalProperties": true }, "catchments": { "type": "array", diff --git a/static/schemas/source/core/targeting-input.json b/static/schemas/source/core/targeting-input.json index 685408a7e08..dc108ce6e9e 100644 --- a/static/schemas/source/core/targeting-input.json +++ b/static/schemas/source/core/targeting-input.json @@ -272,7 +272,7 @@ } }, "required": ["keyword", "match_type"], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1 }, diff --git a/static/schemas/source/core/targeting-modification.json b/static/schemas/source/core/targeting-modification.json index 23ea0b0917d..70ad0602459 100644 --- a/static/schemas/source/core/targeting-modification.json +++ b/static/schemas/source/core/targeting-modification.json @@ -23,7 +23,7 @@ "ext": { "$ref": "/schemas/core/ext.json" } }, "required": ["operation", "path", "applied", "reason"], - "additionalProperties": false + "additionalProperties": true }, { "title": "Remove targeting set values", @@ -59,7 +59,7 @@ "system": { "type": "string", "minLength": 1 } }, "required": ["country", "system"], - "additionalProperties": false + "additionalProperties": true }, "values": { "type": "array", @@ -86,7 +86,7 @@ "else": { "not": { "required": ["selector"] } } } ], - "additionalProperties": false + "additionalProperties": true } ] } diff --git a/static/schemas/source/core/targeting-overlay-requirements.json b/static/schemas/source/core/targeting-overlay-requirements.json index af7d3cb1153..9e866e62910 100644 --- a/static/schemas/source/core/targeting-overlay-requirements.json +++ b/static/schemas/source/core/targeting-overlay-requirements.json @@ -2,7 +2,7 @@ "$schema": "http://json-schema.org/draft-07/schema#", "$id": "/schemas/core/targeting-overlay-requirements.json", "title": "Targeting Overlay Requirements", - "description": "Buyer minimum requirements for targeting dimensions that will be selected on packages later. This request shape deliberately excludes seller limits such as max_values_per_package and max_packages. Matching is capability containment: where a field permits a boolean form, a requirement value of true matches product support true or any valid positive support object, and product support true satisfies every protocol-valid structured requirement except daypart_targets, where true promises inventory_local and whole-hour granularity only. daypart_targets time_granularity is ordered rather than a subset: support matches when its granularity is at least as fine as the requirement (hour < quarter_hour < minute). Otherwise, structured product support must contain the structured requirement. For geo_regions and geo_regions_exclude, every requested country must exist; requested all_values requires supported all_values; and requested values must be a subset of supported values unless support declares all_values. For geo_places and geo_places_exclude, every requested system and country key must exist and each requested place-type and system-version array must be a subset of the corresponding product array. Include and exclude fields match independently. Every valid structured requirement or support object represents a positive capability; empty, extension-only, and false-only objects are invalid. Object fields the buyer did not request do not participate. Missing or unknown required fields do not match. Numeric seller limits are disclosed only in Product.overlay_support and never participate in matching. Legacy frequency_cap: true matches only the unchanged broad declaration. frequency_cap_support matches either legacy true or a containing structured declaration; an empty object requests either positive form. A requirement carries at most one of the two.", + "description": "Buyer minimum requirements for targeting dimensions that will be selected on packages later. This request schema deliberately excludes seller limits such as max_values_per_package and max_packages. Matching is capability containment: where a field permits a boolean form, a requirement value of true matches product support true or any valid positive support object, and product support true satisfies every protocol-valid structured requirement except daypart_targets, where true promises inventory_local and whole-hour granularity only. For demographics, true on either side is the deprecated shorthand for { age: true } and matches as that object. daypart_targets time_granularity is ordered rather than a subset: support matches when its granularity is at least as fine as the requirement (hour < quarter_hour < minute). Otherwise, structured product support must contain the structured requirement. For geo_regions and geo_regions_exclude, every requested country must exist; requested all_values requires supported all_values; and requested values must be a subset of supported values unless support declares all_values. For geo_places and geo_places_exclude, every requested system and country key must exist and each requested place-type and system-version array must be a subset of the corresponding product array. Include and exclude fields match independently. Every valid structured requirement or support object represents a positive capability; empty, extension-only, and false-only objects are invalid. Object fields the buyer did not request do not participate. Missing or unknown required fields do not match. Numeric seller limits are disclosed only in Product.overlay_support and never participate in matching. Legacy frequency_cap: true matches only the unchanged broad declaration. frequency_cap_support matches either legacy true or a containing structured declaration; an empty object requests either positive form. A requirement carries at most one of the two.", "type": "object", "definitions": { "required": { "type": "boolean", "const": true }, @@ -10,6 +10,7 @@ "anyOf": [ { "$ref": "#/definitions/required" }, { + "description": "Rejects the seller limits `max_values_per_package` and `max_packages`, which only product support discloses.", "type": "object", "properties": { "systems": { @@ -20,7 +21,8 @@ } }, "required": ["systems"], - "additionalProperties": false + "additionalProperties": true, + "not": { "anyOf": [{ "required": ["max_values_per_package"] }, { "required": ["max_packages"] }] } } ] }, @@ -38,7 +40,7 @@ } }, "required": ["supported_match_types"], - "additionalProperties": false + "additionalProperties": true } ] }, @@ -57,7 +59,7 @@ } }, "required": ["families"], - "additionalProperties": false + "additionalProperties": true } ] }, @@ -107,7 +109,7 @@ } } ], - "additionalProperties": false + "additionalProperties": true } ] } @@ -159,6 +161,7 @@ "anyOf": [ { "$ref": "#/definitions/required" }, { + "description": "Rejects the seller limit `max_values_per_package`, which only product support discloses.", "type": "object", "properties": { "radius": { "$ref": "#/definitions/required" }, @@ -177,7 +180,8 @@ { "required": ["geometry"] }, { "required": ["transport_modes"] } ], - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["max_values_per_package"] } } ] }, @@ -187,7 +191,13 @@ "signal_targeting_groups": { "$ref": "#/definitions/required" }, "demographics": { "anyOf": [ - { "$ref": "#/definitions/required" }, + { + "$ref": "#/definitions/required", + "deprecated": true, + "x-deprecated-in": "3.3.0", + "x-removed-in": "4.0.0", + "description": "Deprecated in 3.3. The 3.2 shorthand for { age: true }. Senders MUST send the object; receivers MUST accept true." + }, { "type": "object", "properties": { @@ -196,11 +206,11 @@ "$ref": "#/definitions/required", "x-status": "experimental", "x-added-in": "3.3.0", - "description": "Experimental in AdCP 3.3 (media_buy.gender_targeting). AdCP 3.2 core remains age-only." + "description": "Experimental in AdCP 3.3 (media_buy.gender_targeting). Only product support with gender: true satisfies it." } }, "anyOf": [{ "required": ["age"] }, { "required": ["gender"] }], - "additionalProperties": false + "additionalProperties": true } ] }, @@ -231,5 +241,5 @@ }, "minProperties": 1, "not": { "required": ["frequency_cap", "frequency_cap_support"] }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/targeting-overlay-support.json b/static/schemas/source/core/targeting-overlay-support.json index 50795edbe62..9f3d705b770 100644 --- a/static/schemas/source/core/targeting-overlay-support.json +++ b/static/schemas/source/core/targeting-overlay-support.json @@ -28,7 +28,7 @@ } }, "required": ["max_values_per_package"], - "additionalProperties": false + "additionalProperties": true } ] }, @@ -62,7 +62,7 @@ } }, "required": ["systems"], - "additionalProperties": false + "additionalProperties": true } ] }, @@ -96,7 +96,7 @@ "ext": { "$ref": "/schemas/core/ext.json" } }, "required": ["countries", "current_version", "system_versions"], - "additionalProperties": false, + "additionalProperties": true, "x-adcp-validation": { "member_of": { "field": "current_version", "array_field": "system_versions" }, "description": "JSON Schema draft-07 cannot express scalar membership in a sibling array; conformance tooling MUST verify current_version is present in system_versions." @@ -121,7 +121,7 @@ "ext": { "$ref": "/schemas/core/ext.json" } }, "required": ["systems"], - "additionalProperties": false + "additionalProperties": true }, "collectionListsSupport": { "x-status": "experimental", @@ -143,7 +143,7 @@ } }, "required": ["max_references"], - "additionalProperties": false + "additionalProperties": true } ] }, @@ -168,7 +168,7 @@ } }, "required": ["supported_match_types"], - "additionalProperties": false + "additionalProperties": true } ] }, @@ -188,7 +188,7 @@ "ext": { "$ref": "/schemas/core/ext.json" } }, "required": ["families"], - "additionalProperties": false + "additionalProperties": true } ] }, @@ -253,7 +253,7 @@ } } ], - "additionalProperties": false + "additionalProperties": true } ] } @@ -317,7 +317,7 @@ { "required": ["geometry"] }, { "required": ["transport_modes"] } ], - "additionalProperties": false + "additionalProperties": true } ] }, @@ -327,7 +327,13 @@ "signal_targeting_groups": { "$ref": "#/definitions/supported" }, "demographics": { "anyOf": [ - { "$ref": "#/definitions/supported" }, + { + "$ref": "#/definitions/supported", + "deprecated": true, + "x-deprecated-in": "3.3.0", + "x-removed-in": "4.0.0", + "description": "Deprecated in 3.3. The 3.2 shorthand for { age: true }. Senders MUST send the object; receivers MUST accept true." + }, { "type": "object", "properties": { @@ -336,7 +342,7 @@ "$ref": "#/definitions/supported", "x-status": "experimental", "x-added-in": "3.3.0", - "description": "Experimental in AdCP 3.3 (media_buy.gender_targeting). AdCP 3.2 core remains age-only." + "description": "Experimental in AdCP 3.3 (media_buy.gender_targeting)." }, "ext": { "$ref": "/schemas/core/ext.json" } }, @@ -367,7 +373,7 @@ "ext": { "$ref": "/schemas/core/ext.json" } }, "minProperties": 1, - "additionalProperties": false + "additionalProperties": true } ] }, diff --git a/static/schemas/source/core/targeting.json b/static/schemas/source/core/targeting.json index 492d54826e5..302f7e45d99 100644 --- a/static/schemas/source/core/targeting.json +++ b/static/schemas/source/core/targeting.json @@ -80,7 +80,7 @@ } }, "required": ["system", "values"], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1 }, @@ -252,7 +252,7 @@ } }, "required": ["min"], - "additionalProperties": false + "additionalProperties": true }, "device_platform": { "type": "array", @@ -372,7 +372,7 @@ } }, "required": ["value", "unit"], - "additionalProperties": false + "additionalProperties": true }, "transport_mode": { "$ref": "/schemas/enums/transport-mode.json", @@ -393,7 +393,7 @@ } }, "required": ["value", "unit"], - "additionalProperties": false + "additionalProperties": true }, "geometry": { "type": "object", @@ -410,7 +410,7 @@ } }, "required": ["type", "coordinates"], - "additionalProperties": false + "additionalProperties": true }, "ext": { "$ref": "/schemas/core/ext.json" @@ -480,7 +480,7 @@ } }, "required": ["keyword", "match_type"], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1 }, diff --git a/static/schemas/source/core/tracker-execution-contract.json b/static/schemas/source/core/tracker-execution-contract.json index 5180d0682ba..c0d14fa8b24 100644 --- a/static/schemas/source/core/tracker-execution-contract.json +++ b/static/schemas/source/core/tracker-execution-contract.json @@ -26,5 +26,5 @@ "layer_derivation": "Publisher, placement, and seller effective-contract derivation is evaluated over atomic tuples of normalized non-version selector identity, one exact version (or null for pixel), execution_actor, and one firing_path. For a complete parent, every child tuple MUST exist in the parent, the child remains complete, and array compression MUST NOT create a version/path cross-product. An incomplete or omitted parent is not a ceiling: a child may add or omit affirmative tuples for its narrower scope, but remains incomplete until every applicable layer is complete. Omission from an incomplete child is undeclared, not an assertion that the tuple is unsupported.", "cardinality": "Each accepted manifest tracker instance is initiated exactly once in total for each logical event occurrence; identical URLs are not deduplicated." }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/tracker-execution-selector.json b/static/schemas/source/core/tracker-execution-selector.json index 5faf9da6315..c6ca92622e7 100644 --- a/static/schemas/source/core/tracker-execution-selector.json +++ b/static/schemas/source/core/tracker-execution-selector.json @@ -57,7 +57,7 @@ "else": { "not": { "required": ["custom_event_name"] } } } ], - "additionalProperties": false + "additionalProperties": true }, { "type": "object", @@ -107,7 +107,7 @@ "allOf": [ { "$ref": "/schemas/core/vast-tracker-constraints.json" } ], - "additionalProperties": false + "additionalProperties": true }, { "type": "object", @@ -157,7 +157,7 @@ "allOf": [ { "$ref": "/schemas/core/daast-tracker-constraints.json" } ], - "additionalProperties": false + "additionalProperties": true } ], "discriminator": { "propertyName": "asset_type" } diff --git a/static/schemas/source/core/truncation-sentinel.json b/static/schemas/source/core/truncation-sentinel.json index 4ba7a3b204f..b68a6bd715c 100644 --- a/static/schemas/source/core/truncation-sentinel.json +++ b/static/schemas/source/core/truncation-sentinel.json @@ -32,5 +32,5 @@ "required": [ "_truncation" ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/vehicle-item.json b/static/schemas/source/core/vehicle-item.json index 1926edd77a7..8b8965428fe 100644 --- a/static/schemas/source/core/vehicle-item.json +++ b/static/schemas/source/core/vehicle-item.json @@ -59,7 +59,7 @@ } }, "required": ["value", "unit"], - "additionalProperties": false + "additionalProperties": true }, "body_style": { "type": "string", @@ -102,7 +102,7 @@ } }, "required": ["lat", "lng"], - "additionalProperties": false + "additionalProperties": true }, "image_url": { "type": "string", diff --git a/static/schemas/source/core/vendor-metric-optimization-supported-metric.json b/static/schemas/source/core/vendor-metric-optimization-supported-metric.json index 213282bb397..bb369cec74c 100644 --- a/static/schemas/source/core/vendor-metric-optimization-supported-metric.json +++ b/static/schemas/source/core/vendor-metric-optimization-supported-metric.json @@ -24,5 +24,5 @@ } }, "required": ["vendor", "metric_id"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/vendor-metric-value.json b/static/schemas/source/core/vendor-metric-value.json index 5b31a40eeb2..e0fa59c3bf4 100644 --- a/static/schemas/source/core/vendor-metric-value.json +++ b/static/schemas/source/core/vendor-metric-value.json @@ -71,7 +71,7 @@ } }, "required": ["vendor", "metric_id", "value"], - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "vendor": { "domain": "attentionvendor.example" }, diff --git a/static/schemas/source/core/warning-resource.json b/static/schemas/source/core/warning-resource.json index 802a73c9d19..39d0a68dc83 100644 --- a/static/schemas/source/core/warning-resource.json +++ b/static/schemas/source/core/warning-resource.json @@ -76,5 +76,5 @@ } } ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/webhook-activity-record.json b/static/schemas/source/core/webhook-activity-record.json index 786733022ca..75d3a8e88f3 100644 --- a/static/schemas/source/core/webhook-activity-record.json +++ b/static/schemas/source/core/webhook-activity-record.json @@ -83,7 +83,7 @@ }, "ext": { "$ref": "/schemas/core/ext.json", - "description": "Resource-specific extension slot. Adopters MAY surface a resource-specific cross-reference (e.g., `creative_id` on a creative-lifecycle record, `media_buy_id` on a record nested inside an account-level read) under `ext` rather than adding top-level fields — the canonical record shape stays uniform across resources and the `ext` envelope absorbs per-resource needs. Top-level extensions are not permitted (`additionalProperties: false`)." + "description": "Resource-specific extension slot. Adopters MAY surface a resource-specific cross-reference (e.g., `creative_id` on a creative-lifecycle record, `media_buy_id` on a record nested inside an account-level read) under `ext` rather than adding top-level fields — the canonical record shape stays uniform across resources and the `ext` envelope absorbs per-resource needs." } }, "required": [ @@ -94,5 +94,5 @@ "status", "url" ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/core/webhook-challenge-response.json b/static/schemas/source/core/webhook-challenge-response.json index 9c56703e199..50e02ea1fdb 100644 --- a/static/schemas/source/core/webhook-challenge-response.json +++ b/static/schemas/source/core/webhook-challenge-response.json @@ -38,7 +38,7 @@ "token" ] }, - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "description": "Preferred response shape", diff --git a/static/schemas/source/core/webhook-challenge.json b/static/schemas/source/core/webhook-challenge.json index f7e673d335f..65164dafec4 100644 --- a/static/schemas/source/core/webhook-challenge.json +++ b/static/schemas/source/core/webhook-challenge.json @@ -99,7 +99,7 @@ } } ], - "additionalProperties": false + "additionalProperties": true }, "event_types": { "type": "array", @@ -120,7 +120,7 @@ "delivery_auth", "event_types" ], - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "description": "Endpoint proof-of-control challenge", diff --git a/static/schemas/source/core/wholesale-feed-event.json b/static/schemas/source/core/wholesale-feed-event.json index eddcef02a3d..88cfd42c03d 100644 --- a/static/schemas/source/core/wholesale-feed-event.json +++ b/static/schemas/source/core/wholesale-feed-event.json @@ -627,7 +627,7 @@ "required": [ "scope" ], - "additionalProperties": false + "additionalProperties": true }, { "description": "Account overlay — invalidate the named account overlays only; public layer unaffected. The seller MAY omit account_ids when the affected set is competitively sensitive, but MUST ensure account-scoped webhook fan-out only delivers changes to subscribers authorized for the affected account overlays.", @@ -647,7 +647,7 @@ "required": [ "scope" ], - "additionalProperties": false + "additionalProperties": true } ] }, @@ -720,7 +720,7 @@ "min", "max" ], - "additionalProperties": false + "additionalProperties": true }, "signal_type": { "$ref": "/schemas/enums/signal-catalog-type.json" diff --git a/static/schemas/source/core/wholesale-feed-webhook.json b/static/schemas/source/core/wholesale-feed-webhook.json index 1f4faeb18b7..047c2bdb154 100644 --- a/static/schemas/source/core/wholesale-feed-webhook.json +++ b/static/schemas/source/core/wholesale-feed-webhook.json @@ -102,7 +102,7 @@ "event", "account_id" ], - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "description": "Product pricing change webhook", diff --git a/static/schemas/source/creative/audit-observation.json b/static/schemas/source/creative/audit-observation.json index 30ad94efc31..939a6e723cb 100644 --- a/static/schemas/source/creative/audit-observation.json +++ b/static/schemas/source/creative/audit-observation.json @@ -63,7 +63,7 @@ } }, "required": ["human_oversight", "disclosure_required"], - "additionalProperties": false + "additionalProperties": true }, "observed_value": { "description": "Verifier observation relevant to the claim, when applicable.", @@ -82,7 +82,7 @@ } }, "required": ["agent_url", "claimed_value"], - "additionalProperties": false + "additionalProperties": true }, "ext": { "$ref": "/schemas/core/ext.json" @@ -96,5 +96,5 @@ "message", "details" ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/creative/creative-assignment-changed-webhook.json b/static/schemas/source/creative/creative-assignment-changed-webhook.json index 301069fdd75..6916b98364e 100644 --- a/static/schemas/source/creative/creative-assignment-changed-webhook.json +++ b/static/schemas/source/creative/creative-assignment-changed-webhook.json @@ -77,7 +77,7 @@ "change_kind", "observed_at" ], - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "description": "Assignment approval changed", diff --git a/static/schemas/source/creative/creative-feature-result.json b/static/schemas/source/creative/creative-feature-result.json index afa5781387f..88b1456e7d8 100644 --- a/static/schemas/source/creative/creative-feature-result.json +++ b/static/schemas/source/creative/creative-feature-result.json @@ -56,5 +56,5 @@ } }, "required": ["feature_id", "value"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/creative/creative-purged-webhook.json b/static/schemas/source/creative/creative-purged-webhook.json index cf42cb706c5..0a4d9dc5038 100644 --- a/static/schemas/source/creative/creative-purged-webhook.json +++ b/static/schemas/source/creative/creative-purged-webhook.json @@ -93,7 +93,7 @@ "reason_code", "initiator" ], - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "description": "Retention-driven soft purge (tombstone available on list_creatives)", diff --git a/static/schemas/source/creative/creative-staged-update-changed-webhook.json b/static/schemas/source/creative/creative-staged-update-changed-webhook.json index 4e5eac108d8..3996a6f6074 100644 --- a/static/schemas/source/creative/creative-staged-update-changed-webhook.json +++ b/static/schemas/source/creative/creative-staged-update-changed-webhook.json @@ -93,7 +93,7 @@ "observed_at", "initiator" ], - "additionalProperties": false, + "additionalProperties": true, "allOf": [ { "if": { "properties": { "outcome": { "const": "promoted" } }, "required": ["outcome"] }, diff --git a/static/schemas/source/creative/creative-status-changed-webhook.json b/static/schemas/source/creative/creative-status-changed-webhook.json index fa01df7578b..07bd6c55872 100644 --- a/static/schemas/source/creative/creative-status-changed-webhook.json +++ b/static/schemas/source/creative/creative-status-changed-webhook.json @@ -2,7 +2,7 @@ "$schema": "http://json-schema.org/draft-07/schema#", "$id": "/schemas/creative/creative-status-changed-webhook.json", "title": "Creative Status Changed Webhook", - "description": "Account-level push notification fired when a creative in the library transitions status by seller or system initiative. Fires per registered subscriber against each `notification_configs[]` entry whose `event_types` includes `creative.status_changed`. Buyer-initiated transitions (archive, unarchive, resubmit) do NOT fire — those are acknowledged on the `sync_creatives` response path. Receivers MUST verify signing per the registered scheme (RFC 9421 webhook profile by default; legacy Bearer / HMAC-SHA256 when `authentication` was supplied at registration) and dedupe by `idempotency_key`. See docs/protocol/snapshot-and-log.mdx for the snapshot/log duality rules — the current status is always authoritative on `list_creatives`.", + "description": "Account-level push notification fired when a creative in the library transitions status by seller or system initiative. Fires per registered subscriber against each `notification_configs[]` entry whose `event_types` includes `creative.status_changed`. Buyer-initiated transitions (archive, unarchive, resubmit) do NOT fire — those are acknowledged on the `sync_creatives` response path. Receivers MUST verify signing per the registered scheme (RFC 9421 webhook profile by default; legacy Bearer / HMAC-SHA256 when `authentication` was supplied at registration) and dedupe by `idempotency_key`. See docs/protocol/snapshot-and-log.mdx for the snapshot/log duality rules — the current status is always authoritative on `list_creatives`. Rejects `staged_update`: staged outcomes don't ride on status_changed.", "type": "object", "properties": { "idempotency_key": { @@ -91,7 +91,7 @@ "to", "observed_at" ], - "additionalProperties": false, + "additionalProperties": true, "allOf": [ { "if": { @@ -180,7 +180,8 @@ "reason_code", "initiator" ], - "additionalProperties": false, + "additionalProperties": true, + "not": { "required": ["staged_update"] }, "examples": [ { "description": "Approved → rejected post-approval revocation (paired with a media-buy impairment)", diff --git a/static/schemas/source/creative/list-creatives-response.json b/static/schemas/source/creative/list-creatives-response.json index b03b77c48a5..e48cb8d095a 100644 --- a/static/schemas/source/creative/list-creatives-response.json +++ b/static/schemas/source/creative/list-creatives-response.json @@ -568,7 +568,7 @@ "at", "reason_code" ], - "additionalProperties": false + "additionalProperties": true }, "webhook_activity": { "type": "array", diff --git a/static/schemas/source/creative/sync-creatives-request.json b/static/schemas/source/creative/sync-creatives-request.json index 63821c78771..5db6fa5709d 100644 --- a/static/schemas/source/creative/sync-creatives-request.json +++ b/static/schemas/source/creative/sync-creatives-request.json @@ -236,7 +236,7 @@ "creative_id", "package_id" ], - "additionalProperties": false, + "additionalProperties": true, "x-adcp-validation": { "verifier_constraints": { "product_format_locale_policy": { @@ -260,6 +260,7 @@ "minItems": 1, "maxItems": 500, "items": { + "description": "`trackers` and `landing_page_url` belong only to assign: unassign, replace and merge reject them, and merge also rejects `weight`, which a later assign changes.", "type": "object", "discriminator": { "propertyName": "operation" @@ -292,7 +293,7 @@ } }, "required": ["operation", "creative_id", "package_id"], - "additionalProperties": false, + "additionalProperties": true, "x-adcp-validation": { "verifier_constraints": { "product_format_locale_policy": { @@ -316,7 +317,8 @@ "package_id": { "type": "string", "minLength": 1, "x-entity": "package" } }, "required": ["operation", "creative_id", "package_id"], - "additionalProperties": false + "additionalProperties": true, + "not": { "anyOf": [{ "required": ["trackers"] }, { "required": ["landing_page_url"] }] } }, { "title": "Replace assignment", @@ -336,7 +338,8 @@ } }, "required": ["operation", "creative_id", "replaces_creative_id", "package_id"], - "additionalProperties": false, + "additionalProperties": true, + "not": { "anyOf": [{ "required": ["trackers"] }, { "required": ["landing_page_url"] }] }, "x-adcp-validation": { "verifier_constraints": { "product_format_locale_policy": { @@ -362,7 +365,8 @@ "merged_creative_id": { "type": "string", "minLength": 1, "description": "Seller-created creative (one that entered the library outside sync_creatives, under a seller-assigned creative_id) currently assigned to package_id that the seller verifies is the same creative as creative_id.", "x-entity": "creative" } }, "required": ["operation", "creative_id", "package_id", "merged_creative_id"], - "additionalProperties": false, + "additionalProperties": true, + "not": { "anyOf": [{ "required": ["trackers"] }, { "required": ["landing_page_url"] }, { "required": ["weight"] }] }, "x-added-in": "3.3.0", "x-adcp-validation": { "verifier_constraints": { diff --git a/static/schemas/source/error-details/creative-merge-rejected.json b/static/schemas/source/error-details/creative-merge-rejected.json index 7c2b1db0054..67f07468ffe 100644 --- a/static/schemas/source/error-details/creative-merge-rejected.json +++ b/static/schemas/source/error-details/creative-merge-rejected.json @@ -36,11 +36,11 @@ } }, "required": ["operation_index", "creative_id", "package_id", "merged_creative_id", "reason"], - "additionalProperties": false + "additionalProperties": true } } }, "required": ["rejections"], - "additionalProperties": false, + "additionalProperties": true, "x-added-in": "3.3.0" } diff --git a/static/schemas/source/error-details/creative-revision-content-mismatch.json b/static/schemas/source/error-details/creative-revision-content-mismatch.json index bb9537ba834..fdcde739bac 100644 --- a/static/schemas/source/error-details/creative-revision-content-mismatch.json +++ b/static/schemas/source/error-details/creative-revision-content-mismatch.json @@ -15,5 +15,5 @@ } }, "required": ["creative_id", "revision_id"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/error-details/governance-agent-not-accepted.json b/static/schemas/source/error-details/governance-agent-not-accepted.json index d066ecf119e..c77f102db5d 100644 --- a/static/schemas/source/error-details/governance-agent-not-accepted.json +++ b/static/schemas/source/error-details/governance-agent-not-accepted.json @@ -19,7 +19,7 @@ "accepted_governance_agents": { "$ref": "/schemas/governance/accepted-governance-agents.json" } }, "required": ["disclosure", "attempted_agent_origin", "accepted_governance_agents"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -32,7 +32,7 @@ } }, "required": ["disclosure"], - "additionalProperties": false + "additionalProperties": true } ] } diff --git a/static/schemas/source/formats/canonical/display_tag.json b/static/schemas/source/formats/canonical/display_tag.json index c0a2b6d5fbc..8ec6c801451 100644 --- a/static/schemas/source/formats/canonical/display_tag.json +++ b/static/schemas/source/formats/canonical/display_tag.json @@ -221,7 +221,7 @@ "minimum": 1 } }, - "additionalProperties": false + "additionalProperties": true }, "description": "List of accepted (width, height) pairs for a multi-size flexible slot. The buyer's third-party tag must render at one of the listed sizes; the seller picks which size to request at impression time. Mutually exclusive with `(width, height)` and with responsive ranges." }, diff --git a/static/schemas/source/formats/canonical/html5.json b/static/schemas/source/formats/canonical/html5.json index f3a24a0f8a7..7caee0e6579 100644 --- a/static/schemas/source/formats/canonical/html5.json +++ b/static/schemas/source/formats/canonical/html5.json @@ -226,7 +226,7 @@ "minimum": 1 } }, - "additionalProperties": false + "additionalProperties": true }, "description": "List of accepted (width, height) pairs for a multi-size flexible slot (publisher banner that accepts 300×250 OR 728×90 OR 970×250). Mirrors OpenRTB `banner.format[]`. Mutually exclusive with `(width, height)` and with responsive ranges." }, diff --git a/static/schemas/source/formats/canonical/image.json b/static/schemas/source/formats/canonical/image.json index 277d44d42d0..b0bb4caca67 100644 --- a/static/schemas/source/formats/canonical/image.json +++ b/static/schemas/source/formats/canonical/image.json @@ -114,7 +114,7 @@ "width": { "type": "integer", "minimum": 1 }, "height": { "type": "integer", "minimum": 1 } }, - "additionalProperties": false + "additionalProperties": true }, "description": "List of accepted logical (width, height) render pairs for a multi-size flexible slot. The buyer ships an asset matching one logical size multiplied by one accepted `pixel_ratios` entry (or by 1 when `pixel_ratios` is absent). SDKs MUST treat size and density as separate axes: a 600×500 intrinsic asset at 2x satisfies a logical 300×250 size; it does not create a logical 600×500 placement. Mirrors OpenRTB `banner.format[]` semantics. Mutually exclusive with `(width, height)` and with responsive ranges." }, diff --git a/static/schemas/source/formats/canonical/native_in_feed.json b/static/schemas/source/formats/canonical/native_in_feed.json index 6268b7e0477..71adcc7eade 100644 --- a/static/schemas/source/formats/canonical/native_in_feed.json +++ b/static/schemas/source/formats/canonical/native_in_feed.json @@ -111,7 +111,7 @@ "width": { "type": "integer", "minimum": 1 }, "height": { "type": "integer", "minimum": 1 } }, - "additionalProperties": false + "additionalProperties": true }, "description": "Accepted logical (width, height) pairs for the main_image slot. Common IAB native sizes: 1200×627 (1.91:1), 1080×1080 (1:1), 1080×1350 (4:5). When the effective main_image slot declares `pixel_ratios`, intrinsic asset dimensions are the matched logical pair multiplied by the selected ratio; absence remains 1x." }, @@ -122,7 +122,7 @@ "width": { "type": "integer", "minimum": 1 }, "height": { "type": "integer", "minimum": 1 } }, - "additionalProperties": false, + "additionalProperties": true, "description": "Required logical (width, height) for the icon slot when present (typical: 80×80 or 100×100). When the effective icon slot declares `pixel_ratios`, intrinsic dimensions are multiplied by the selected ratio; absence remains 1x." }, "max_image_file_size_kb": { diff --git a/static/schemas/source/governance/accepted-governance-agents.json b/static/schemas/source/governance/accepted-governance-agents.json index 011ebb0d515..0838bcb357c 100644 --- a/static/schemas/source/governance/accepted-governance-agents.json +++ b/static/schemas/source/governance/accepted-governance-agents.json @@ -18,7 +18,7 @@ "agent_url": { "type": "string", "format": "uri", "pattern": "^https://[^/?#@]+(?:/[^?#]*)?$", "maxLength": 2048, "description": "Exact canonical agent endpoint without userinfo, query, or fragment. Redirect targets, DNS aliases, and URLs asserted by the candidate do not satisfy this matcher." } }, "required": ["kind", "agent_url"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -35,7 +35,7 @@ "max_age_seconds": { "type": "integer", "minimum": 0, "description": "Maximum age of the registry evidence at binding time. Zero requires a fresh result. Evidence is pinned to the accepted binding; later registry drift does not silently revoke an existing binding." } }, "required": ["kind", "registry", "role", "adcp_version", "verification_modes", "max_age_seconds"], - "additionalProperties": false + "additionalProperties": true } ] }, @@ -43,5 +43,5 @@ } }, "required": ["any_of"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/governance/attribute-definition.json b/static/schemas/source/governance/attribute-definition.json index 05dc37fd00c..5f339b2e24b 100644 --- a/static/schemas/source/governance/attribute-definition.json +++ b/static/schemas/source/governance/attribute-definition.json @@ -39,7 +39,7 @@ } }, "required": ["name", "summary"], - "additionalProperties": false + "additionalProperties": true } }, "includes": { @@ -63,5 +63,5 @@ } }, "required": ["attribute_id", "name", "description"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/governance/audience-constraints.json b/static/schemas/source/governance/audience-constraints.json index 0028507bb3e..eac34d7a8a7 100644 --- a/static/schemas/source/governance/audience-constraints.json +++ b/static/schemas/source/governance/audience-constraints.json @@ -23,5 +23,5 @@ } }, "minProperties": 1, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/governance/check-governance-request.json b/static/schemas/source/governance/check-governance-request.json index eb2a52feb44..a68efa8a300 100644 --- a/static/schemas/source/governance/check-governance-request.json +++ b/static/schemas/source/governance/check-governance-request.json @@ -265,7 +265,7 @@ "currency": { "type": "string", "pattern": "^[A-Z]{3}$" } }, "required": ["amount", "currency"], - "additionalProperties": false + "additionalProperties": true }, "execution_commitment": { "type": "object", @@ -275,7 +275,7 @@ "currency": { "type": "string", "pattern": "^[A-Z]{3}$" } }, "required": ["amount", "currency"], - "additionalProperties": false + "additionalProperties": true }, "tool": { "type": "string", @@ -357,7 +357,7 @@ "start", "end" ], - "additionalProperties": false + "additionalProperties": true }, "spend": { "type": "number", @@ -455,13 +455,13 @@ "baseline", "indices" ], - "additionalProperties": false + "additionalProperties": true } }, "required": [ "reporting_period" ], - "additionalProperties": false + "additionalProperties": true }, "modification_summary": { "type": "string", diff --git a/static/schemas/source/governance/check-governance-response.json b/static/schemas/source/governance/check-governance-response.json index 495d1a0442e..bc074b7d4cf 100644 --- a/static/schemas/source/governance/check-governance-response.json +++ b/static/schemas/source/governance/check-governance-response.json @@ -195,7 +195,7 @@ "severity", "explanation" ], - "additionalProperties": false + "additionalProperties": true } }, "conditions": { @@ -220,7 +220,7 @@ "field", "reason" ], - "additionalProperties": false + "additionalProperties": true } }, "consultation_context": { @@ -256,7 +256,7 @@ "end": { "type": "string", "format": "date-time" } }, "required": ["start", "end"], - "additionalProperties": false + "additionalProperties": true }, "cumulative_spend": { "type": "number", "minimum": 0 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, @@ -268,11 +268,11 @@ "delivery_metrics": { "type": "object", "additionalProperties": true } }, "required": ["seller_reference", "delivery_metrics"], - "additionalProperties": false + "additionalProperties": true } }, "required": ["statement_id", "statement_digest", "sequence", "issued_at", "seller_reference", "reporting_period", "cumulative_spend", "currency", "canonical_payload"], - "additionalProperties": false + "additionalProperties": true }, "categories_evaluated": { "type": "array", diff --git a/static/schemas/source/governance/get-plan-audit-logs-request.json b/static/schemas/source/governance/get-plan-audit-logs-request.json index 7de0c43ded7..7f099068b91 100644 --- a/static/schemas/source/governance/get-plan-audit-logs-request.json +++ b/static/schemas/source/governance/get-plan-audit-logs-request.json @@ -18,7 +18,7 @@ "x-entity": "governance_plan" }, "minItems": 1, - "description": "Plan IDs to retrieve. For a single plan, pass a one-element array. Plans uniquely scope account and operator; do not include a separate `account` field — the governance agent resolves account from each plan. Including `account` is rejected by `additionalProperties: false`." + "description": "Plan IDs to retrieve. For a single plan, pass a one-element array. Plans uniquely scope account and operator; do not include a separate `account` field — the governance agent resolves account from each plan." }, "portfolio_plan_ids": { "type": "array", diff --git a/static/schemas/source/governance/get-plan-audit-logs-response.json b/static/schemas/source/governance/get-plan-audit-logs-response.json index 39cfb7c9e50..200dc97a8b4 100644 --- a/static/schemas/source/governance/get-plan-audit-logs-response.json +++ b/static/schemas/source/governance/get-plan-audit-logs-response.json @@ -88,7 +88,7 @@ "description": "Committed as a percentage of authorized." } }, - "additionalProperties": false + "additionalProperties": true }, "channel_allocation": { "type": "object", @@ -105,7 +105,7 @@ "description": "Channel's share of the authorized total budget." } }, - "additionalProperties": false + "additionalProperties": true } }, "summary": { @@ -146,7 +146,7 @@ "description": "Supplementary count of checks that went through internal human review. These checks are also counted in approved or denied." } }, - "additionalProperties": false + "additionalProperties": true }, "findings_count": { "type": "integer", @@ -181,7 +181,7 @@ "check_id", "reason" ], - "additionalProperties": false + "additionalProperties": true } }, "drift_metrics": { @@ -250,13 +250,13 @@ "description": "Maximum acceptable human override rate. A high rate suggests the governance agent's recommendations are poorly calibrated." } }, - "additionalProperties": false + "additionalProperties": true } }, - "additionalProperties": false + "additionalProperties": true } }, - "additionalProperties": false + "additionalProperties": true }, "entries": { "type": "array", @@ -379,7 +379,7 @@ "severity", "explanation" ], - "additionalProperties": false + "additionalProperties": true } }, "delivery_statement": { @@ -400,7 +400,7 @@ "end": { "type": "string", "format": "date-time" } }, "required": ["start", "end"], - "additionalProperties": false + "additionalProperties": true }, "canonical_payload": { "type": "object", @@ -410,11 +410,11 @@ "delivery_metrics": { "type": "object", "additionalProperties": true } }, "required": ["seller_reference", "delivery_metrics"], - "additionalProperties": false + "additionalProperties": true } }, "required": ["statement_id", "statement_digest", "sequence", "issued_at", "seller_reference", "cumulative_spend", "currency", "reporting_period", "canonical_payload"], - "additionalProperties": false + "additionalProperties": true }, "outcome": { "$ref": "/schemas/enums/outcome-type.json", @@ -461,7 +461,7 @@ "amount", "currency" ], - "additionalProperties": false + "additionalProperties": true }, "headroom_restored": { "type": "number", @@ -540,7 +540,7 @@ "start", "end" ], - "additionalProperties": false + "additionalProperties": true }, "cumulative_spend": { "type": "number", @@ -583,7 +583,7 @@ } }, "required": ["reference", "evaluation"], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1, "maxItems": 10 @@ -624,7 +624,7 @@ "issued_at": { "type": "string", "format": "date-time" } }, "required": ["evidence_id", "evidence_type", "digest", "issued_at"], - "additionalProperties": false + "additionalProperties": true }, "reviewed_by": { "type": "string", "format": "uri" }, "reviewed_at": { "type": "string", "format": "date-time" }, @@ -645,7 +645,7 @@ } } ], - "additionalProperties": false + "additionalProperties": true } }, "governed_actions": { @@ -704,7 +704,7 @@ "end": { "type": "string", "format": "date-time" } }, "required": ["start", "end"], - "additionalProperties": false, + "additionalProperties": true, "description": "Current seller statement period summarized for this governed action." }, "conservative_exposure": { @@ -737,7 +737,7 @@ "committed", "check_count" ], - "additionalProperties": false + "additionalProperties": true } } }, @@ -749,7 +749,7 @@ "governed_actions", "summary" ], - "additionalProperties": false + "additionalProperties": true } }, "context": { diff --git a/static/schemas/source/governance/policy-category-definition.json b/static/schemas/source/governance/policy-category-definition.json index af6b1536c09..be837b4f414 100644 --- a/static/schemas/source/governance/policy-category-definition.json +++ b/static/schemas/source/governance/policy-category-definition.json @@ -34,7 +34,7 @@ "description": { "type": "string", "minLength": 1 } }, "required": ["facet_id", "name", "description"], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1 }, @@ -64,7 +64,7 @@ } }, "required": ["name", "summary"], - "additionalProperties": false + "additionalProperties": true } }, "restricted_attributes": { @@ -100,5 +100,5 @@ { "path": "facets", "field": "facet_id" } ] }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/governance/policy-entry.json b/static/schemas/source/governance/policy-entry.json index d78664afef5..7d1c7479fd3 100644 --- a/static/schemas/source/governance/policy-entry.json +++ b/static/schemas/source/governance/policy-entry.json @@ -101,7 +101,7 @@ "name": { "type": "string", "minLength": 1 } }, "required": ["domain"], - "additionalProperties": false + "additionalProperties": true }, "acceptance_profile": { "$ref": "/schemas/media-buy/acceptance-policy-profile.json", @@ -131,14 +131,14 @@ "description": "Scenarios that violate this policy." } }, - "additionalProperties": false + "additionalProperties": true }, "ext": { "$ref": "/schemas/core/ext.json" } }, "required": ["policy_id", "enforcement", "policy"], - "additionalProperties": false, + "additionalProperties": true, "$defs": { "exemplar": { "type": "object", @@ -153,7 +153,7 @@ } }, "required": ["scenario", "explanation"], - "additionalProperties": false + "additionalProperties": true } } } diff --git a/static/schemas/source/governance/policy-ref.json b/static/schemas/source/governance/policy-ref.json index b3c2a3e994a..59b73a0bbe3 100644 --- a/static/schemas/source/governance/policy-ref.json +++ b/static/schemas/source/governance/policy-ref.json @@ -21,5 +21,5 @@ } }, "required": ["policy_id"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/governance/report-plan-adjustment-request.json b/static/schemas/source/governance/report-plan-adjustment-request.json index f3b208786bb..416376b96fb 100644 --- a/static/schemas/source/governance/report-plan-adjustment-request.json +++ b/static/schemas/source/governance/report-plan-adjustment-request.json @@ -104,7 +104,7 @@ } }, "required": ["amount", "currency"], - "additionalProperties": false + "additionalProperties": true }, "reason": { "type": "string", @@ -136,7 +136,7 @@ "issued_at": { "type": "string", "format": "date-time" } }, "required": ["evidence_id", "evidence_type", "digest", "issued_at"], - "additionalProperties": false + "additionalProperties": true }, "idempotency_key": { "type": "string", diff --git a/static/schemas/source/governance/report-plan-adjustment-response.json b/static/schemas/source/governance/report-plan-adjustment-response.json index 620bfb28848..9c8e2255d75 100644 --- a/static/schemas/source/governance/report-plan-adjustment-response.json +++ b/static/schemas/source/governance/report-plan-adjustment-response.json @@ -28,7 +28,7 @@ "currency": { "type": "string", "pattern": "^[A-Z]{3}$" } }, "required": ["amount", "currency"], - "additionalProperties": false + "additionalProperties": true }, "headroom_restored": { "type": "number", @@ -49,7 +49,7 @@ "budget_remaining": { "type": "number" } }, "required": ["accounting_mode", "gross_committed", "adjustments_reported", "adjustments_verified", "net_cost", "headroom_restored", "ledger_committed", "net_committed", "budget_remaining"], - "additionalProperties": false + "additionalProperties": true }, "context": { "$ref": "/schemas/core/context.json" }, "ext": { "$ref": "/schemas/core/ext.json" } diff --git a/static/schemas/source/governance/report-plan-outcome-request.json b/static/schemas/source/governance/report-plan-outcome-request.json index 15c8c9559e2..7a60abb428d 100644 --- a/static/schemas/source/governance/report-plan-outcome-request.json +++ b/static/schemas/source/governance/report-plan-outcome-request.json @@ -151,7 +151,7 @@ "start", "end" ], - "additionalProperties": false + "additionalProperties": true }, "cumulative_spend": { "type": "number", @@ -186,7 +186,7 @@ "then": { "required": ["seller_statement_id", "seller_statement_digest"] } } ], - "additionalProperties": false + "additionalProperties": true }, "error": { "$ref": "/schemas/governance/reported-outcome-error.json", diff --git a/static/schemas/source/governance/report-plan-outcome-response.json b/static/schemas/source/governance/report-plan-outcome-response.json index a36148df4e3..185a5750e70 100644 --- a/static/schemas/source/governance/report-plan-outcome-response.json +++ b/static/schemas/source/governance/report-plan-outcome-response.json @@ -73,7 +73,7 @@ "severity", "explanation" ], - "additionalProperties": false + "additionalProperties": true } }, "plan_summary": { @@ -89,7 +89,7 @@ "description": "Authorized budget minus total committed." } }, - "additionalProperties": false + "additionalProperties": true }, "context": { "$ref": "/schemas/core/context.json" diff --git a/static/schemas/source/governance/sync-plans-request.json b/static/schemas/source/governance/sync-plans-request.json index 4a9bfa744b0..51df934a931 100644 --- a/static/schemas/source/governance/sync-plans-request.json +++ b/static/schemas/source/governance/sync-plans-request.json @@ -23,6 +23,7 @@ "type": "array", "description": "One or more campaign plans to sync.", "items": { + "description": "Rejects `version`, `status`, `syncedAt`, `revisionHistory`, `committedBudget` and `committedByType`: these names are reserved for the governance agent's persisted plan state and excluded from the plan_hash preimage, so a buyer MUST NOT send them.", "type": "object", "properties": { "plan_id": { @@ -94,7 +95,7 @@ "description": "Maximum percentage of total budget for this purchase type." } }, - "additionalProperties": false + "additionalProperties": true } }, "periods": { @@ -136,7 +137,7 @@ "end", "amount" ], - "additionalProperties": false + "additionalProperties": true } } }, @@ -171,7 +172,7 @@ } } ], - "additionalProperties": false + "additionalProperties": true }, "channels": { "type": "object", @@ -204,11 +205,11 @@ "type": "number" } }, - "additionalProperties": false + "additionalProperties": true } } }, - "additionalProperties": false + "additionalProperties": true }, "flight": { "type": "object", @@ -229,7 +230,7 @@ "start", "end" ], - "additionalProperties": false + "additionalProperties": true }, "countries": { "type": "array", @@ -341,7 +342,7 @@ "amount", "currency" ], - "additionalProperties": false + "additionalProperties": true }, "markets": { "type": "array", @@ -360,7 +361,7 @@ "agent_url", "authority" ], - "additionalProperties": false + "additionalProperties": true } }, "portfolio": { @@ -390,7 +391,7 @@ "amount", "currency" ], - "additionalProperties": false + "additionalProperties": true }, "shared_policy_ids": { "type": "array", @@ -411,7 +412,7 @@ "required": [ "member_plan_ids" ], - "additionalProperties": false + "additionalProperties": true }, "ext": { "$ref": "/schemas/core/ext.json" @@ -481,7 +482,8 @@ } } ], - "additionalProperties": false + "not": { "anyOf": [{ "required": ["version"] }, { "required": ["status"] }, { "required": ["syncedAt"] }, { "required": ["revisionHistory"] }, { "required": ["committedBudget"] }, { "required": ["committedByType"] }] }, + "additionalProperties": true } }, "context": { diff --git a/static/schemas/source/governance/sync-plans-response.json b/static/schemas/source/governance/sync-plans-response.json index b2c77f3f1a3..fb365045f77 100644 --- a/static/schemas/source/governance/sync-plans-response.json +++ b/static/schemas/source/governance/sync-plans-response.json @@ -57,7 +57,7 @@ "category_id", "status" ], - "additionalProperties": false + "additionalProperties": true } }, "resolved_policies": { @@ -93,7 +93,7 @@ "source", "enforcement" ], - "additionalProperties": false + "additionalProperties": true } } }, @@ -102,7 +102,7 @@ "status", "version" ], - "additionalProperties": false + "additionalProperties": true } }, "context": { diff --git a/static/schemas/source/manifest.schema.json b/static/schemas/source/manifest.schema.json index 068a7c0e500..46e67810dcf 100644 --- a/static/schemas/source/manifest.schema.json +++ b/static/schemas/source/manifest.schema.json @@ -5,7 +5,7 @@ "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", "task_result_resolution", "error_codes", "error_code_policy", "specialisms"], - "additionalProperties": false, + "additionalProperties": true, "properties": { "$schema": { "type": "string", @@ -29,7 +29,7 @@ "additionalProperties": { "type": "object", "required": ["protocol", "mutating", "request_schema", "response_schema", "async_response_schemas"], - "additionalProperties": false, + "additionalProperties": true, "properties": { "protocol": { "type": "string", @@ -84,7 +84,7 @@ "legacy_fallback": { "type": "object", "description": "How an SDK exposing this tool's current API may satisfy it against a peer that only exposes a legacy tool. This is caller-side adaptation metadata, not authorization or idempotency equivalence.", - "additionalProperties": false, + "additionalProperties": true, "properties": { "tool": { "$ref": "#/definitions/tool_name", @@ -141,7 +141,7 @@ "type": "object", "description": "Machine-readable rule for resolving the schema of a tracked task result without generating the full async-response-data union as an SDK type. Consumers check terminal_schema_overrides first, then apply terminal_schema_pointer_template.", "required": ["discriminator_field", "terminal_schema_pointer_template", "terminal_schema_overrides"], - "additionalProperties": false, + "additionalProperties": true, "properties": { "discriminator_field": { "type": "string", @@ -163,7 +163,7 @@ "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, + "additionalProperties": true, "properties": { "default_unknown_recovery": { "type": "string", @@ -183,7 +183,7 @@ "additionalProperties": { "type": "object", "required": ["recovery", "description", "suggestion"], - "additionalProperties": false, + "additionalProperties": true, "properties": { "recovery": { "type": "string", @@ -211,7 +211,7 @@ "additionalProperties": { "type": "object", "required": ["protocol", "entry_point_tools", "exercised_tools"], - "additionalProperties": false, + "additionalProperties": true, "properties": { "protocol": { "type": "string", diff --git a/static/schemas/source/media-buy/accept-proposal-request.json b/static/schemas/source/media-buy/accept-proposal-request.json index 4ca533abf48..79519c8526c 100644 --- a/static/schemas/source/media-buy/accept-proposal-request.json +++ b/static/schemas/source/media-buy/accept-proposal-request.json @@ -57,7 +57,7 @@ "currency": { "type": "string", "pattern": "^[A-Z]{3}$" } }, "required": ["amount", "currency"], - "additionalProperties": false + "additionalProperties": true }, "daily_budget_cap": { "type": "number", @@ -78,7 +78,7 @@ "signature_id": { "type": "string", "minLength": 1 } }, "required": ["io_id", "accepted_at", "signatory"], - "additionalProperties": false + "additionalProperties": true }, "purchase_order_ref": { "type": "string", diff --git a/static/schemas/source/media-buy/acceptance-context.json b/static/schemas/source/media-buy/acceptance-context.json index 6bf9bc09e81..4589915ddbf 100644 --- a/static/schemas/source/media-buy/acceptance-context.json +++ b/static/schemas/source/media-buy/acceptance-context.json @@ -19,7 +19,7 @@ } }, "required": ["subject_category"], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1 }, @@ -52,5 +52,5 @@ ] }, "minProperties": 1, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/media-buy/acceptance-policy-catalog.json b/static/schemas/source/media-buy/acceptance-policy-catalog.json index 79f6c9baadd..90d1efd3146 100644 --- a/static/schemas/source/media-buy/acceptance-policy-catalog.json +++ b/static/schemas/source/media-buy/acceptance-policy-catalog.json @@ -38,5 +38,5 @@ } ] }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/media-buy/acceptance-policy-profile-ref.json b/static/schemas/source/media-buy/acceptance-policy-profile-ref.json index bc37ccb8c1d..215084df983 100644 --- a/static/schemas/source/media-buy/acceptance-policy-profile-ref.json +++ b/static/schemas/source/media-buy/acceptance-policy-profile-ref.json @@ -16,5 +16,5 @@ "x-adcp-validation": { "resolver_integrity": "Resolve the exact policy_id/policy_version. The resolver returns canonical_content and content_digest; RFC 8785-canonicalize canonical_content, verify that its SHA-256 equals both content_digest and policy_digest, then select the embedded profile_id/profile_version and verify profile_digest before use. A null digest or canonical_content is not sufficient for a pinned registry profile." }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/media-buy/acceptance-policy-profile.json b/static/schemas/source/media-buy/acceptance-policy-profile.json index cb8f2a49f14..893557cd47a 100644 --- a/static/schemas/source/media-buy/acceptance-policy-profile.json +++ b/static/schemas/source/media-buy/acceptance-policy-profile.json @@ -26,7 +26,7 @@ } }, "required": ["policy_id", "version", "content_digest"], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1, "description": "Exact registry policy versions from which this profile was derived. Consumers MUST NOT silently substitute a different version." @@ -77,7 +77,7 @@ { "required": ["jurisdiction_groups"] }, { "required": ["all_jurisdictions"] } ], - "additionalProperties": false + "additionalProperties": true }, "region_aliases": { "type": "object", @@ -124,5 +124,5 @@ "then": { "required": ["scope"] } } ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/media-buy/acceptance-policy-requirement.json b/static/schemas/source/media-buy/acceptance-policy-requirement.json index a6d38181c0b..dc0ecb6240e 100644 --- a/static/schemas/source/media-buy/acceptance-policy-requirement.json +++ b/static/schemas/source/media-buy/acceptance-policy-requirement.json @@ -13,7 +13,7 @@ "description": { "type": "string", "minLength": 1 } }, "required": ["kind"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -22,7 +22,7 @@ "description": { "type": "string", "minLength": 1 } }, "required": ["kind"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -37,7 +37,7 @@ "description": { "type": "string", "minLength": 1 } }, "required": ["kind", "criteria"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -52,7 +52,7 @@ "description": { "type": "string", "minLength": 1 } }, "required": ["kind", "criteria"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -61,7 +61,7 @@ "description": { "type": "string", "minLength": 1 } }, "required": ["kind"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -70,7 +70,7 @@ "description": { "type": "string", "minLength": 1 } }, "required": ["kind"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -78,7 +78,7 @@ "description": { "type": "string", "minLength": 1 } }, "required": ["kind"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -86,7 +86,7 @@ "description": { "type": "string", "minLength": 1 } }, "required": ["kind"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -94,7 +94,7 @@ "description": { "type": "string", "minLength": 1 } }, "required": ["kind"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -104,7 +104,7 @@ "description": { "type": "string", "minLength": 1 } }, "required": ["kind"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -118,7 +118,7 @@ "description": { "type": "string", "minLength": 1 } }, "required": ["kind"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -126,7 +126,7 @@ "description": { "type": "string", "minLength": 1 } }, "required": ["kind", "description"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -134,7 +134,7 @@ "description": { "type": "string", "minLength": 1 } }, "required": ["kind", "description"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -152,7 +152,7 @@ "description": { "type": "string", "minLength": 1 } }, "required": ["kind"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -162,7 +162,7 @@ "description": { "type": "string", "minLength": 1 } }, "required": ["kind"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -170,7 +170,7 @@ "description": { "type": "string", "minLength": 1 } }, "required": ["kind"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -180,7 +180,7 @@ "ext": { "$ref": "/schemas/core/ext.json" } }, "required": ["kind", "id", "description"], - "additionalProperties": false + "additionalProperties": true } ] } diff --git a/static/schemas/source/media-buy/acceptance-policy-rule.json b/static/schemas/source/media-buy/acceptance-policy-rule.json index dba00d24569..228e50592d2 100644 --- a/static/schemas/source/media-buy/acceptance-policy-rule.json +++ b/static/schemas/source/media-buy/acceptance-policy-rule.json @@ -77,5 +77,5 @@ "then": { "required": ["requirements"] } } ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/media-buy/buy-products-request.json b/static/schemas/source/media-buy/buy-products-request.json index 596b8582282..a45ea45d2f7 100644 --- a/static/schemas/source/media-buy/buy-products-request.json +++ b/static/schemas/source/media-buy/buy-products-request.json @@ -64,7 +64,7 @@ "currency": { "type": "string", "pattern": "^[A-Z]{3}$" } }, "required": ["amount", "currency"], - "additionalProperties": false + "additionalProperties": true }, "daily_budget_cap": { "type": "number", diff --git a/static/schemas/source/media-buy/control-media-buy-request.json b/static/schemas/source/media-buy/control-media-buy-request.json index 777918e39da..7257f6311e4 100644 --- a/static/schemas/source/media-buy/control-media-buy-request.json +++ b/static/schemas/source/media-buy/control-media-buy-request.json @@ -68,7 +68,7 @@ "currency": { "type": "string", "pattern": "^[A-Z]{3}$" } }, "required": ["amount", "currency"], - "additionalProperties": false + "additionalProperties": true }, "daily_budget_cap": { "type": ["number", "null"], diff --git a/static/schemas/source/media-buy/create-media-buy-request.json b/static/schemas/source/media-buy/create-media-buy-request.json index ca3fc0b7da4..d079a8d6b6b 100644 --- a/static/schemas/source/media-buy/create-media-buy-request.json +++ b/static/schemas/source/media-buy/create-media-buy-request.json @@ -104,7 +104,7 @@ "amount", "currency" ], - "additionalProperties": false + "additionalProperties": true }, "daily_budget_cap": { "type": "number", @@ -281,7 +281,7 @@ "schemes", "credentials" ], - "additionalProperties": false + "additionalProperties": true }, "delivery_mode": { "type": "string", diff --git a/static/schemas/source/media-buy/decline-proposals-response.json b/static/schemas/source/media-buy/decline-proposals-response.json index 4bb87bae519..af050c7d9f5 100644 --- a/static/schemas/source/media-buy/decline-proposals-response.json +++ b/static/schemas/source/media-buy/decline-proposals-response.json @@ -53,7 +53,7 @@ "required": ["outcome", "reason"] } ], - "additionalProperties": false + "additionalProperties": true } }, "errors": { "type": "array", "items": { "$ref": "/schemas/core/error.json" } }, diff --git a/static/schemas/source/media-buy/get-media-buy-delivery-request.json b/static/schemas/source/media-buy/get-media-buy-delivery-request.json index df0dac0a99b..241da6380bf 100644 --- a/static/schemas/source/media-buy/get-media-buy-delivery-request.json +++ b/static/schemas/source/media-buy/get-media-buy-delivery-request.json @@ -439,7 +439,7 @@ "default": "desc" } }, - "additionalProperties": false + "additionalProperties": true }, "spot": { "type": "object", diff --git a/static/schemas/source/media-buy/get-media-buy-delivery-response.json b/static/schemas/source/media-buy/get-media-buy-delivery-response.json index af98da6c1a7..067406b45e8 100644 --- a/static/schemas/source/media-buy/get-media-buy-delivery-response.json +++ b/static/schemas/source/media-buy/get-media-buy-delivery-response.json @@ -114,7 +114,7 @@ "content_sha256": { "type": "string", "pattern": "^[A-Fa-f0-9]{64}$", "description": "SHA-256 of RFC 8785 JCS of {reporting_revision_id,row_count,control_totals,reporting_rows}, where reporting_rows is the complete ordered sequence concatenated across every cursor page; identical to reporting_revision.revision_content_sha256." } }, "required": ["reporting_revision_id", "row_count", "control_totals", "content_sha256"], - "additionalProperties": false + "additionalProperties": true }, "reporting_revision": { "$ref": "/schemas/core/reporting-revision.json", "description": "Full immutable revision metadata, identical to the get_reporting_status revision record." }, "reporting_rows": { "type": "array", "items": { "type": "object" }, "description": "One page of authoritative logical rows for an exact reporting_revision_id read. Validate every row against the revision's digest-pinned schema; concatenate pages in cursor order before verifying the binding digest." }, diff --git a/static/schemas/source/media-buy/get-media-buy-issue-request.json b/static/schemas/source/media-buy/get-media-buy-issue-request.json index b9062fd7eb0..38d6ad64049 100644 --- a/static/schemas/source/media-buy/get-media-buy-issue-request.json +++ b/static/schemas/source/media-buy/get-media-buy-issue-request.json @@ -3,7 +3,7 @@ "$id": "/schemas/media-buy/get-media-buy-issue-request.json", "title": "Get Media Buy Issue Request", "x-added-in": "3.3.0", - "description": "Read the latest seller-owned state of one issue within an authorized account and media buy. The read remains available after the buy is paused, canceled, or completed. An issue_id does not grant access.", + "description": "Read the latest seller-owned state of one issue within an authorized account and media buy. The read remains available after the buy is paused, canceled, or completed. An issue_id does not grant access. Rejects `context_id`, which is not request authority.", "x-tool-summary": "Read the acknowledgement and resolution of a media-buy issue.", "x-operation-family": "get_media_buy_issue", "x-legacy-fallback": { @@ -58,7 +58,8 @@ "media_buy_id", "issue_id" ], - "additionalProperties": false, + "additionalProperties": true, + "not": { "required": ["context_id"] }, "allOf": [ { "$ref": "/schemas/core/version-envelope.json" diff --git a/static/schemas/source/media-buy/get-media-buys-response.json b/static/schemas/source/media-buy/get-media-buys-response.json index 65b519dd80e..45a56b7b3b8 100644 --- a/static/schemas/source/media-buy/get-media-buys-response.json +++ b/static/schemas/source/media-buy/get-media-buys-response.json @@ -192,7 +192,7 @@ "maxLength": 500 } }, - "additionalProperties": false + "additionalProperties": true }, "cancellation_effective_at": { "type": "string", @@ -221,7 +221,7 @@ "stop_time": { "type": "string", "format": "date-time", "description": "Stop time in force before the edit." } }, "required": ["recorded_at", "start_time", "stop_time"], - "additionalProperties": false + "additionalProperties": true } }, "revision": { @@ -501,7 +501,7 @@ "maxLength": 500 } }, - "additionalProperties": false + "additionalProperties": true }, "creative_deadline": { "type": "string", diff --git a/static/schemas/source/media-buy/get-products-request.json b/static/schemas/source/media-buy/get-products-request.json index 37648f461dc..7de1d0b25ee 100644 --- a/static/schemas/source/media-buy/get-products-request.json +++ b/static/schemas/source/media-buy/get-products-request.json @@ -80,6 +80,7 @@ "description": "Array of change requests for iterating on products and proposals from a previous get_products response. Each entry declares a scope (request, product, or proposal) and what the buyer is asking for. Only valid when buying_mode is 'refine'. The seller responds to each entry via refinement_applied in the response, matched by position.\n\nFinalize-exclusivity rule: if any entry has `action: 'finalize'`, ALL entries in the array MUST be proposal-scoped with `action: 'finalize'` — mixing finalize entries with `include`/`omit` entries or with request- / product-scoped entries MUST be rejected by the seller with `INVALID_REQUEST`. Finalize is a commit, not a refinement; the buyer expressing intent to commit means refinements have already converged. Buyers needing to refine AND commit in close succession sequence the calls: first a refine call (no finalize), then a finalize call against the resulting `proposal_id`(s).\n\nMulti-finalize semantics: multiple finalize entries against different `proposal_id` values in a single call are allowed and MUST be **atomic at the observation point** — sellers MUST NOT return a success response unless every named proposal has both completed and been persisted as committed. Pre-commit validation runs before any side-effects (inventory pull, terms lock, governance attestation); if any proposal fails validation, the seller MUST reject the entire call without committing any of the named proposals. There is no rollback operation in the spec — an `unfinalize` would itself be a new mutation surface; the atomicity guarantee runs entirely on the seller's pre-commit validation gate, not on post-commit reversal. Sellers that cannot guarantee atomic pre-commit validation MUST reject multi-finalize arrays with `MULTI_FINALIZE_UNSUPPORTED` (preferred — distinguishes seller-side capability gap from a malformed request) or `INVALID_REQUEST` (acceptable fallback for sellers on a pre-3.1 error catalog). If a mid-commit failure occurs *after* validation passed but before all proposals persist (e.g., a downstream ad server fails between commits one and two), the seller MUST return `INTERNAL_ERROR` with `refinement_applied[]` carrying per-position outcomes — the spec does NOT define a recovery path for this case, and buyers SHOULD treat the resulting state as undefined and re-read via `get_media_buys` / equivalent before retrying. Buyers MUST NOT assume multi-finalize support without a successful first attempt — there is no capability flag for this; the failure response is the discovery surface. Buyers whose intent specifically requires atomic commit (e.g., budget-shared proposals where one finalizing without the other is incoherent) MUST be prepared to abandon the intent if the seller returns `MULTI_FINALIZE_UNSUPPORTED` — there is no recovery for that loss of buyer intent beyond sequencing single-finalize calls and accepting the looser commit guarantee.", "minItems": 1, "items": { + "description": "Only the product scope takes `package`; the request and proposal scopes reject it.", "type": "object", "discriminator": { "propertyName": "scope" @@ -99,7 +100,8 @@ } }, "required": ["scope", "ask"], - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["package"] } }, { "properties": { @@ -137,7 +139,7 @@ "then": { "properties": { "action": { "const": "include" } } } } ], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -164,7 +166,8 @@ } }, "required": ["scope", "proposal_id"], - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["package"] } } ] } diff --git a/static/schemas/source/media-buy/get-products-response.json b/static/schemas/source/media-buy/get-products-response.json index 6b3229fefd0..e08b40461c3 100644 --- a/static/schemas/source/media-buy/get-products-response.json +++ b/static/schemas/source/media-buy/get-products-response.json @@ -180,7 +180,7 @@ "scope", "status" ], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -247,7 +247,7 @@ } } ], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -279,7 +279,7 @@ "proposal_id", "status" ], - "additionalProperties": false + "additionalProperties": true } ] } @@ -319,7 +319,7 @@ "scope", "description" ], - "additionalProperties": false + "additionalProperties": true } }, "filter_diagnostics": { @@ -373,7 +373,7 @@ "required": [ "count" ], - "additionalProperties": false + "additionalProperties": true } } }, diff --git a/static/schemas/source/media-buy/get-products-targeting-resolution.json b/static/schemas/source/media-buy/get-products-targeting-resolution.json index 11eda2dcbe2..4a75a933a93 100644 --- a/static/schemas/source/media-buy/get-products-targeting-resolution.json +++ b/static/schemas/source/media-buy/get-products-targeting-resolution.json @@ -12,5 +12,5 @@ "ext": { "$ref": "/schemas/core/ext.json" } }, "required": ["brief_targeting"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/media-buy/get-reporting-status-request.json b/static/schemas/source/media-buy/get-reporting-status-request.json index 18774873302..1ee9d01c5c7 100644 --- a/static/schemas/source/media-buy/get-reporting-status-request.json +++ b/static/schemas/source/media-buy/get-reporting-status-request.json @@ -48,7 +48,7 @@ "end": { "type": "string", "format": "date-time" } }, "required": ["start", "end"], - "additionalProperties": false + "additionalProperties": true }, "health": { "type": "array", "items": { "$ref": "/schemas/enums/reporting-health.json" }, "minItems": 1, "uniqueItems": true, "description": "Periods-view result filter only; it never changes summary health." }, "finality": { "type": "array", "items": { "$ref": "/schemas/enums/reporting-finality.json" }, "minItems": 1, "uniqueItems": true }, diff --git a/static/schemas/source/media-buy/get-reporting-status-response.json b/static/schemas/source/media-buy/get-reporting-status-response.json index a4a51c68685..9873ee28bad 100644 --- a/static/schemas/source/media-buy/get-reporting-status-response.json +++ b/static/schemas/source/media-buy/get-reporting-status-response.json @@ -66,7 +66,7 @@ "offering_id": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9_.:-]{1,128}$", "x-entity": "reporting_offering", "x-status": "experimental", "x-added-in": "3.3.0", "description": "Present when and only when the generation is derived from a reporting subscription (media_buy.reporting_subscriptions): the offering its obligations in this entry resolved." } }, "required": ["delivery_config_id", "delivery_config_version", "feed_purpose"], - "additionalProperties": false + "additionalProperties": true }, "uniqueItems": true }, @@ -82,7 +82,7 @@ "then": { "required": ["media_buy_ids"], "properties": { "media_buy_ids": {} } } } ], - "additionalProperties": false + "additionalProperties": true }, "health": { "$ref": "/schemas/enums/reporting-health.json" }, "coverage": { "$ref": "/schemas/core/reporting-coverage.json", "description": "Aggregated effective coverage for the exact selected scope. This remains independent of reporting health and finality so a fresh covered subset cannot look like complete campaign reporting." }, @@ -100,7 +100,7 @@ "consumer_status_pending": { "type": "integer", "minimum": 0, "description": "Obligations in this scope whose elapsed expected period has passed its consumer-status deadline — expected_at plus automated_recovery_window_seconds — without a current consumer status from the authenticated caller. A chain with any unsuperseded leaf counts as current whatever that leaf says; only an empty chain is pending. Because it counts obligations, a period the seller omitted entirely has no obligation and is not counted here — the buyer's independently derived denominator, not this field, remains the authority on omitted periods. It is a visibility count over the caller's own silence, never a health input: it MUST NOT change health, any other count, or seller-advertised reliability_statistics, and it overlaps the health counts rather than partitioning them. Required when the seller advertises consumer_status_task." } }, "required": ["total", "waiting", "healthy", "delayed", "action_required", "complete"], - "additionalProperties": false + "additionalProperties": true }, "issues": { "type": "array", "items": { "$ref": "/schemas/core/reporting-status-issue.json" } }, "periods": { "type": "array", "items": { "$ref": "/schemas/core/reporting-obligation.json" } }, @@ -151,6 +151,7 @@ "required": ["status"], "oneOf": [ { + "description": "Every unknown or unauthorized identifier returns this one shape: its message and error are constants, its error objects are closed, and it names no ledger snapshot, ledger time or account.", "title": "Unavailable lookup", "type": "object", "properties": { diff --git a/static/schemas/source/media-buy/legacy-purchase-continuation-input.json b/static/schemas/source/media-buy/legacy-purchase-continuation-input.json index 23969c02315..ce07ed7087a 100644 --- a/static/schemas/source/media-buy/legacy-purchase-continuation-input.json +++ b/static/schemas/source/media-buy/legacy-purchase-continuation-input.json @@ -54,7 +54,7 @@ "accepted_losses", "legacy_create_request" ], - "additionalProperties": false, + "additionalProperties": true, "x-adcp-sdk-local": true, "x-adcp-validation": { "verifier_constraints": { diff --git a/static/schemas/source/media-buy/list-collections-request.json b/static/schemas/source/media-buy/list-collections-request.json index 5d454f6dce0..2fb7d95446b 100644 --- a/static/schemas/source/media-buy/list-collections-request.json +++ b/static/schemas/source/media-buy/list-collections-request.json @@ -83,7 +83,7 @@ "brand_id": { "$ref": "/schemas/core/brand-id.json" } }, "required": ["domain"], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1 }, @@ -103,7 +103,7 @@ "description": "Include only collections whose name contains this string, compared case-insensitively." } }, - "additionalProperties": false + "additionalProperties": true }, "pagination": { "$ref": "/schemas/core/pagination-request.json", @@ -116,7 +116,7 @@ }, "ext": { "$ref": "/schemas/core/ext.json" } }, - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "description": "Key lookup to refresh two cards, passing product selectors through unchanged", diff --git a/static/schemas/source/media-buy/list-products-response.json b/static/schemas/source/media-buy/list-products-response.json index 48e425fb2ee..de9430b2cc9 100644 --- a/static/schemas/source/media-buy/list-products-response.json +++ b/static/schemas/source/media-buy/list-products-response.json @@ -48,7 +48,7 @@ "estimated_wait": { "$ref": "/schemas/core/duration.json" } }, "required": ["scope", "description"], - "additionalProperties": false + "additionalProperties": true } }, "context": { "$ref": "/schemas/core/context.json" }, diff --git a/static/schemas/source/media-buy/list-proposals-request.json b/static/schemas/source/media-buy/list-proposals-request.json index 240986ad2bb..940788f3123 100644 --- a/static/schemas/source/media-buy/list-proposals-request.json +++ b/static/schemas/source/media-buy/list-proposals-request.json @@ -81,7 +81,7 @@ }, "required": ["account"], "allOf": [{ "$ref": "/schemas/core/version-envelope.json" }], - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "description": "Read the open proposals for one opportunity after a proposal.created notification", diff --git a/static/schemas/source/media-buy/list-proposals-response.json b/static/schemas/source/media-buy/list-proposals-response.json index ef957b1af89..daae444db1b 100644 --- a/static/schemas/source/media-buy/list-proposals-response.json +++ b/static/schemas/source/media-buy/list-proposals-response.json @@ -86,7 +86,7 @@ } } ], - "additionalProperties": false + "additionalProperties": true } }, "opportunities": { @@ -124,7 +124,7 @@ }, "then": { "required": ["close_reason"] }, "else": { "not": { "required": ["close_reason"] } }, - "additionalProperties": false + "additionalProperties": true } }, "next_cursor": { "type": "string", "minLength": 1 }, diff --git a/static/schemas/source/media-buy/media-buy-commitment-response.json b/static/schemas/source/media-buy/media-buy-commitment-response.json index 0867bb2d594..0c09d851998 100644 --- a/static/schemas/source/media-buy/media-buy-commitment-response.json +++ b/static/schemas/source/media-buy/media-buy-commitment-response.json @@ -82,7 +82,7 @@ "package_id": { "type": "string", "minLength": 1, "x-entity": "package" } }, "required": ["purchase_index", "product_id", "package_id"], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1, "uniqueItems": true diff --git a/static/schemas/source/media-buy/outcome-target.json b/static/schemas/source/media-buy/outcome-target.json index 377de8c8f26..e6df73c20f3 100644 --- a/static/schemas/source/media-buy/outcome-target.json +++ b/static/schemas/source/media-buy/outcome-target.json @@ -20,7 +20,7 @@ } }, "required": ["kind", "metric"], - "additionalProperties": false + "additionalProperties": true }, { "type": "object", @@ -43,12 +43,12 @@ "required": ["event_type"] }, "then": { "required": ["custom_event_name"] }, - "additionalProperties": false + "additionalProperties": true }, { "type": "object", "x-added-in": "3.3.0", - "description": "Plan against a vendor-measured outcome, such as store visits. The (vendor, metric_id) pair is the key optimization goals and delivery's vendor_metric_values[] use. The forecast carries the flight total in points' vendor_metric_values[] with the vendor's declared unit, not in metrics, and the proposal binds the goal and a vendor reporting commitment on every purchase.", + "description": "Plan against a vendor-measured outcome, such as store visits. The (vendor, metric_id) pair is the key optimization goals and delivery's vendor_metric_values[] use. The forecast carries the flight total in points' vendor_metric_values[] with the vendor's declared unit, not in metrics, and the proposal binds the goal and a vendor reporting commitment on every purchase. Rejects `metric`, which belongs to the metric goal, and `target`, the deprecated target shape.", "properties": { "kind": { "type": "string", "const": "vendor_metric" }, "vendor": { @@ -61,7 +61,8 @@ } }, "required": ["kind", "vendor", "metric_id"], - "additionalProperties": false + "additionalProperties": true, + "not": { "anyOf": [{ "required": ["target"] }, { "required": ["metric"] }] } } ] }, @@ -76,5 +77,5 @@ }, "required": ["goal"], "anyOf": [{ "required": ["volume"] }, { "required": ["cost_per"] }], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/media-buy/package-request.json b/static/schemas/source/media-buy/package-request.json index 960458cd317..ab1bb929cce 100644 --- a/static/schemas/source/media-buy/package-request.json +++ b/static/schemas/source/media-buy/package-request.json @@ -263,7 +263,7 @@ } }, "required": ["scope", "metric_id"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -308,7 +308,7 @@ } }, "required": ["scope", "vendor", "metric_id"], - "additionalProperties": false + "additionalProperties": true } ] }, diff --git a/static/schemas/source/media-buy/package-update.json b/static/schemas/source/media-buy/package-update.json index 8896fda04d2..ea0739c720d 100644 --- a/static/schemas/source/media-buy/package-update.json +++ b/static/schemas/source/media-buy/package-update.json @@ -132,7 +132,7 @@ } }, "required": ["keyword", "match_type"], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1 }, @@ -152,7 +152,7 @@ } }, "required": ["keyword", "match_type"], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1 }, @@ -172,7 +172,7 @@ } }, "required": ["keyword", "match_type"], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1 }, @@ -192,7 +192,7 @@ } }, "required": ["keyword", "match_type"], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1 }, diff --git a/static/schemas/source/media-buy/product-purchase-input.json b/static/schemas/source/media-buy/product-purchase-input.json index cffec66c220..01a1f4d1ff7 100644 --- a/static/schemas/source/media-buy/product-purchase-input.json +++ b/static/schemas/source/media-buy/product-purchase-input.json @@ -53,7 +53,7 @@ "performance_standards": { "$ref": "/schemas/media-buy/product-purchase.json#/properties/performance_standards" } }, "required": ["product_id", "pricing_option_id"], - "additionalProperties": false, + "additionalProperties": true, "not": { "anyOf": [ { "required": ["creatives"] }, diff --git a/static/schemas/source/media-buy/product-refinement.json b/static/schemas/source/media-buy/product-refinement.json index 51b40960f26..5ff2b51f861 100644 --- a/static/schemas/source/media-buy/product-refinement.json +++ b/static/schemas/source/media-buy/product-refinement.json @@ -25,7 +25,7 @@ } }, "required": ["scope", "ask"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -52,7 +52,7 @@ } }, "required": ["scope", "product_id"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -79,7 +79,7 @@ } }, "required": ["scope", "proposal_id"], - "additionalProperties": false + "additionalProperties": true } ] } diff --git a/static/schemas/source/media-buy/proposal-decline.json b/static/schemas/source/media-buy/proposal-decline.json index fc8616d7c5a..40f8ce662ad 100644 --- a/static/schemas/source/media-buy/proposal-decline.json +++ b/static/schemas/source/media-buy/proposal-decline.json @@ -30,5 +30,5 @@ "then": { "required": ["detail"] } } ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/media-buy/proposal-refinement.json b/static/schemas/source/media-buy/proposal-refinement.json index f15f4a857eb..a13d4668b81 100644 --- a/static/schemas/source/media-buy/proposal-refinement.json +++ b/static/schemas/source/media-buy/proposal-refinement.json @@ -37,7 +37,7 @@ "currency": { "type": "string", "pattern": "^[A-Z]{3}$" } }, "required": ["max", "currency"], - "additionalProperties": false + "additionalProperties": true }, "impressions": { "type": "object", @@ -46,7 +46,7 @@ "min": { "type": "number", "exclusiveMinimum": 0 } }, "required": ["min"], - "additionalProperties": false + "additionalProperties": true }, "flight": { "type": "object", @@ -59,11 +59,11 @@ { "required": ["start_no_later_than"] }, { "required": ["end_no_earlier_than"] } ], - "additionalProperties": false + "additionalProperties": true } }, "minProperties": 1, - "additionalProperties": false + "additionalProperties": true }, "product_changes": { "$ref": "/schemas/core/product-change-map.json", @@ -81,7 +81,7 @@ } }, "required": ["count"], - "additionalProperties": false + "additionalProperties": true }, "ask": { "type": "string", diff --git a/static/schemas/source/media-buy/report-media-buy-issue-request.json b/static/schemas/source/media-buy/report-media-buy-issue-request.json index 388c29338f3..c395af43a83 100644 --- a/static/schemas/source/media-buy/report-media-buy-issue-request.json +++ b/static/schemas/source/media-buy/report-media-buy-issue-request.json @@ -3,7 +3,7 @@ "$id": "/schemas/media-buy/report-media-buy-issue-request.json", "title": "Report Media Buy Issue Request", "x-added-in": "3.3.0", - "description": "Raise a seller-action report against an authorized media buy, optionally scoped to a package or creative. Completion of this task means the report was stored, not human acknowledgement or resolution. Reporting does not pause a buy or remove a creative. Requires advertised media_buy.issue_reporting and a matching available_actions entry.", + "description": "Raise a seller-action report against an authorized media buy, optionally scoped to a package or creative. Completion of this task means the report was stored, not human acknowledgement or resolution. Reporting does not pause a buy or remove a creative. Requires advertised media_buy.issue_reporting and a matching available_actions entry. Rejects `context_id`, which is not request authority, and `status` and `acknowledged_at`, which only the seller sets.", "x-tool-summary": "Report urgent seller-side delivery, creative, safety, or tracking issues.", "x-mutates-state": true, "x-operation-family": "report_media_buy_issue", @@ -89,7 +89,8 @@ "category", "description" ], - "additionalProperties": false, + "additionalProperties": true, + "not": { "anyOf": [{ "required": ["context_id"] }, { "required": ["status"] }, { "required": ["acknowledged_at"] }] }, "allOf": [ { "$ref": "/schemas/core/version-envelope.json" diff --git a/static/schemas/source/media-buy/request-proposals-response.json b/static/schemas/source/media-buy/request-proposals-response.json index d11c1c62dfd..cc16630b4d9 100644 --- a/static/schemas/source/media-buy/request-proposals-response.json +++ b/static/schemas/source/media-buy/request-proposals-response.json @@ -56,7 +56,7 @@ "estimated_wait": { "$ref": "/schemas/core/duration.json" } }, "required": ["scope", "description"], - "additionalProperties": false + "additionalProperties": true } }, "purchase_continuation": { @@ -96,7 +96,7 @@ } }, "required": ["kind", "product_ids", "cache_scope", "feed_version"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -153,7 +153,7 @@ } } ], - "additionalProperties": false + "additionalProperties": true } ] }, diff --git a/static/schemas/source/media-buy/sync-audiences-response.json b/static/schemas/source/media-buy/sync-audiences-response.json index 4f0cc4c53a7..133c9e8e2ee 100644 --- a/static/schemas/source/media-buy/sync-audiences-response.json +++ b/static/schemas/source/media-buy/sync-audiences-response.json @@ -169,7 +169,7 @@ } }, "required": ["kind", "vendor"], - "additionalProperties": false + "additionalProperties": true }, "minimum_size": { "type": "integer", diff --git a/static/schemas/source/media-buy/sync-reporting-receipts-response.json b/static/schemas/source/media-buy/sync-reporting-receipts-response.json index c859ef3e215..2dbeb1f3ab8 100644 --- a/static/schemas/source/media-buy/sync-reporting-receipts-response.json +++ b/static/schemas/source/media-buy/sync-reporting-receipts-response.json @@ -13,6 +13,7 @@ "results": { "type": "array", "items": { + "description": "A result carries a receipt or an adjustment receipt, never both, and a failed result carries neither.", "anyOf": [ { "title": "Recorded reporting receipt", @@ -27,7 +28,8 @@ } }, "required": ["result", "receipt"], - "additionalProperties": false + "not": { "required": ["adjustment_receipt"] }, + "additionalProperties": true }, { "title": "Unchanged reporting receipt", @@ -42,7 +44,8 @@ } }, "required": ["result", "receipt"], - "additionalProperties": false + "not": { "required": ["adjustment_receipt"] }, + "additionalProperties": true }, { "title": "Recorded reporting adjustment receipt", @@ -57,7 +60,8 @@ } }, "required": ["result", "adjustment_receipt"], - "additionalProperties": false + "not": { "required": ["receipt"] }, + "additionalProperties": true }, { "title": "Unchanged reporting adjustment receipt", @@ -72,7 +76,8 @@ } }, "required": ["result", "adjustment_receipt"], - "additionalProperties": false + "not": { "required": ["receipt"] }, + "additionalProperties": true }, { "title": "Failed reporting receipt", @@ -83,7 +88,8 @@ "errors": { "type": "array", "items": { "$ref": "/schemas/core/error.json" }, "minItems": 1, "maxItems": 16 } }, "required": ["result", "reporting_receipt_id", "errors"], - "additionalProperties": false + "not": { "anyOf": [{ "required": ["receipt"] }, { "required": ["adjustment_receipt"] }] }, + "additionalProperties": true } ] }, diff --git a/static/schemas/source/media-buy/sync-reporting-status-request.json b/static/schemas/source/media-buy/sync-reporting-status-request.json index 246239cc65f..4c1e6b6c3cc 100644 --- a/static/schemas/source/media-buy/sync-reporting-status-request.json +++ b/static/schemas/source/media-buy/sync-reporting-status-request.json @@ -41,5 +41,5 @@ "partial_results": "Each status is independent. One failed result does not roll back successfully recorded statuses; retries use the same status IDs and content.", "buyer_duty": "When the seller advertises consumer_status_task, a buyer using that Reliable Reporting configuration MUST automate this task: report a failed consumption promptly after its bounded retry/give-up window expires, report each later state change, and post a current status for every elapsed expected period no later than that period's expected_at plus the seller's advertised automated_recovery_window_seconds. That deadline, not scope close, is the buyer's duty; a still-retrying buyer posts revision_missing or unreadable by the deadline and supersedes it later rather than staying silent. A buyer MUST also have a current status for every elapsed expected period before closing that reporting scope. Until the field becomes required Core in the next eligible minor, its absence means the buyer retains status locally and does not infer a reverse endpoint. Seller production health never depends on receiving buyer status, and missing buyer feedback never excuses a seller obligation: a missed deadline is counted in the seller's obligation_counts.consumer_status_pending and creates no issue and no health change." }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/media-buy/sync-reporting-status-response.json b/static/schemas/source/media-buy/sync-reporting-status-response.json index 415b12930d0..e56887e7083 100644 --- a/static/schemas/source/media-buy/sync-reporting-status-response.json +++ b/static/schemas/source/media-buy/sync-reporting-status-response.json @@ -27,7 +27,7 @@ } }, "required": ["result", "consumer_status"], - "additionalProperties": false + "additionalProperties": true }, { "title": "Unchanged reporting consumer status", @@ -42,7 +42,7 @@ } }, "required": ["result", "consumer_status"], - "additionalProperties": false + "additionalProperties": true }, { "title": "Failed reporting consumer status", @@ -59,7 +59,7 @@ "errors": { "type": "array", "items": { "$ref": "/schemas/core/error.json" }, "minItems": 1, "maxItems": 16 } }, "required": ["result", "reporting_status_id", "errors"], - "additionalProperties": false + "additionalProperties": true } ] }, diff --git a/static/schemas/source/media-buy/update-media-buy-request.json b/static/schemas/source/media-buy/update-media-buy-request.json index 6fef4247b1e..e615fa4e0de 100644 --- a/static/schemas/source/media-buy/update-media-buy-request.json +++ b/static/schemas/source/media-buy/update-media-buy-request.json @@ -177,7 +177,7 @@ "amount", "currency" ], - "additionalProperties": false + "additionalProperties": true }, "daily_budget_cap": { "type": ["number", "null"], diff --git a/static/schemas/source/pricing-options/price-adjustments.json b/static/schemas/source/pricing-options/price-adjustments.json index dc999cb77e1..bb6d608e8f2 100644 --- a/static/schemas/source/pricing-options/price-adjustments.json +++ b/static/schemas/source/pricing-options/price-adjustments.json @@ -73,7 +73,7 @@ ] } ], - "additionalProperties": false + "additionalProperties": true }, { "type": "object", @@ -157,7 +157,7 @@ ] } ], - "additionalProperties": false + "additionalProperties": true }, { "type": "object", @@ -220,7 +220,7 @@ ] } ], - "additionalProperties": false + "additionalProperties": true } ] }, diff --git a/static/schemas/source/property/authorization-result.json b/static/schemas/source/property/authorization-result.json index 48187649fcc..2e8a7252f58 100644 --- a/static/schemas/source/property/authorization-result.json +++ b/static/schemas/source/property/authorization-result.json @@ -33,9 +33,9 @@ } }, "required": ["code", "message"], - "additionalProperties": false + "additionalProperties": true } }, "required": ["status"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/property/base-property-source.json b/static/schemas/source/property/base-property-source.json index d23b0c2bc30..cbe6fd5f09e 100644 --- a/static/schemas/source/property/base-property-source.json +++ b/static/schemas/source/property/base-property-source.json @@ -32,7 +32,7 @@ } }, "required": ["selection_type", "publisher_domain", "tags"], - "additionalProperties": false + "additionalProperties": true }, { "type": "object", @@ -59,7 +59,7 @@ } }, "required": ["selection_type", "publisher_domain", "property_ids"], - "additionalProperties": false + "additionalProperties": true }, { "type": "object", @@ -81,7 +81,7 @@ } }, "required": ["selection_type", "identifiers"], - "additionalProperties": false + "additionalProperties": true } ] } diff --git a/static/schemas/source/property/delivery-record.json b/static/schemas/source/property/delivery-record.json index 29e6bc17a77..7ff1a5c064e 100644 --- a/static/schemas/source/property/delivery-record.json +++ b/static/schemas/source/property/delivery-record.json @@ -28,5 +28,5 @@ } }, "required": ["identifier", "impressions"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/property/get-property-list-request.json b/static/schemas/source/property/get-property-list-request.json index eff4a02536b..cfe9e66df34 100644 --- a/static/schemas/source/property/get-property-list-request.json +++ b/static/schemas/source/property/get-property-list-request.json @@ -40,7 +40,7 @@ "description": "Opaque cursor from a previous response to fetch the next page" } }, - "additionalProperties": false + "additionalProperties": true }, "context": { "$ref": "/schemas/core/context.json" diff --git a/static/schemas/source/property/property-error.json b/static/schemas/source/property/property-error.json index 7b46b096efc..3e149eba20c 100644 --- a/static/schemas/source/property/property-error.json +++ b/static/schemas/source/property/property-error.json @@ -27,5 +27,5 @@ } }, "required": ["code", "message"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/property/property-feature-definition.json b/static/schemas/source/property/property-feature-definition.json index 1672c270d94..63019a4573e 100644 --- a/static/schemas/source/property/property-feature-definition.json +++ b/static/schemas/source/property/property-feature-definition.json @@ -36,7 +36,7 @@ } }, "required": ["min", "max"], - "additionalProperties": false + "additionalProperties": true }, "allowed_values": { "type": "array", @@ -64,7 +64,7 @@ } } }, - "additionalProperties": false + "additionalProperties": true }, "methodology_url": { "type": "string", @@ -80,5 +80,5 @@ } }, "required": ["feature_id", "name", "type", "methodology_url"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/property/property-feature-result.json b/static/schemas/source/property/property-feature-result.json index 25a43a64392..adfd3515cd2 100644 --- a/static/schemas/source/property/property-feature-result.json +++ b/static/schemas/source/property/property-feature-result.json @@ -39,5 +39,5 @@ } }, "required": ["property", "coverage_status"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/property/property-feature-value.json b/static/schemas/source/property/property-feature-value.json index c2b70ab712e..4b93466c83e 100644 --- a/static/schemas/source/property/property-feature-value.json +++ b/static/schemas/source/property/property-feature-value.json @@ -47,5 +47,5 @@ } }, "required": ["value"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/property/property-feature.json b/static/schemas/source/property/property-feature.json index 6c9939b5950..76aa45242e0 100644 --- a/static/schemas/source/property/property-feature.json +++ b/static/schemas/source/property/property-feature.json @@ -19,5 +19,5 @@ } }, "required": ["feature_id", "value"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/property/property-list-changed-webhook.json b/static/schemas/source/property/property-list-changed-webhook.json index a9488ecdb1a..23dfc20eb46 100644 --- a/static/schemas/source/property/property-list-changed-webhook.json +++ b/static/schemas/source/property/property-list-changed-webhook.json @@ -43,7 +43,7 @@ "description": "Total properties in the resolved list" } }, - "additionalProperties": false + "additionalProperties": true }, "resolved_at": { "type": "string", @@ -66,5 +66,5 @@ } }, "required": ["idempotency_key", "event", "list_id", "resolved_at", "signature"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/property/property-list-filters.json b/static/schemas/source/property/property-list-filters.json index 7ac3ab6874b..6e72d4fa003 100644 --- a/static/schemas/source/property/property-list-filters.json +++ b/static/schemas/source/property/property-list-filters.json @@ -47,5 +47,5 @@ "minItems": 1 } }, - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/property/property-list.json b/static/schemas/source/property/property-list.json index 0e095d3c225..d97bb5a9f71 100644 --- a/static/schemas/source/property/property-list.json +++ b/static/schemas/source/property/property-list.json @@ -72,5 +72,5 @@ } }, "required": ["list_id", "name"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/property/validate-property-delivery-response.json b/static/schemas/source/property/validate-property-delivery-response.json index 69883ac6032..1ffce2d3d5d 100644 --- a/static/schemas/source/property/validate-property-delivery-response.json +++ b/static/schemas/source/property/validate-property-delivery-response.json @@ -76,7 +76,7 @@ "unidentified_records", "unidentified_impressions" ], - "additionalProperties": false + "additionalProperties": true }, "aggregate": { "type": "object", @@ -149,7 +149,7 @@ "unknown_records", "unknown_impressions" ], - "additionalProperties": false + "additionalProperties": true }, "results": { "type": "array", diff --git a/static/schemas/source/property/validation-result.json b/static/schemas/source/property/validation-result.json index 6d80d8c0652..76e2a94cf9b 100644 --- a/static/schemas/source/property/validation-result.json +++ b/static/schemas/source/property/validation-result.json @@ -63,7 +63,7 @@ "items": {} } }, - "additionalProperties": false + "additionalProperties": true }, "confidence": { "type": "number", @@ -73,7 +73,7 @@ } }, "required": ["feature_id", "status"], - "additionalProperties": false + "additionalProperties": true } }, "authorization": { @@ -85,5 +85,5 @@ } }, "required": ["identifier", "status", "impressions"], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/protocol/get-adcp-capabilities-response.json b/static/schemas/source/protocol/get-adcp-capabilities-response.json index 243ccfa91a6..92111770e1a 100644 --- a/static/schemas/source/protocol/get-adcp-capabilities-response.json +++ b/static/schemas/source/protocol/get-adcp-capabilities-response.json @@ -878,7 +878,7 @@ "implementation": { "x-added-in": "3.3.0", "type": "object", - "description": "Optional, self-reported AdCP SDK identity and integration metadata, introduced in 3.3. Omission means SDK use is unknown. An empty sdks array explicitly reports no AdCP SDK use. This metadata is advisory: it does not establish SDK approval, prove deployed code execution, change capability obligations, or justify skipping conformance checks without independently trusted evidence covering this endpoint and integration. Buyers MUST NOT use it for version negotiation.", + "description": "Optional, self-reported AdCP SDK identity and integration metadata, introduced in 3.3. Omission means SDK use is unknown. An empty sdks array explicitly reports no AdCP SDK use. This metadata is advisory: it does not establish SDK approval, prove deployed code execution, change capability obligations, or justify skipping conformance checks without independently trusted evidence covering this endpoint and integration. Buyers MUST NOT use it for version negotiation. Rejects `approved`, here and on each sdks entry: an agent can't assert its own approval.", "properties": { "sdks": { "type": "array", @@ -922,14 +922,16 @@ } }, "required": ["name", "version", "components"], - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["approved"] } }, "uniqueItems": true, "maxItems": 16 } }, "required": ["sdks"], - "additionalProperties": false + "additionalProperties": true, + "not": { "required": ["approved"] } }, "idempotency": { "type": "object", @@ -1074,7 +1076,7 @@ } }, "required": ["pattern", "transports", "verification_profiles"], - "additionalProperties": false + "additionalProperties": true } }, "suspension_interval_seconds": { @@ -1135,7 +1137,7 @@ "task_presence": "The agent's MCP tools/list or A2A skill list MUST include sync_principal and get_principal when this block is present.", "offering_boundary": "Requests are rejected atomically for schema violations, authorization failures, unsupported sections, and out-of-offering destinations. In-offering destinations that fail provider-side setup are reported per destination as validating, action_required, or rejected inside an applied response, never as a failed request." }, - "additionalProperties": false + "additionalProperties": true }, "capability_changes": { "type": "object", @@ -1266,7 +1268,7 @@ } }, "required": ["task", "modes"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -1280,7 +1282,7 @@ } }, "required": ["task", "modes"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -1294,7 +1296,7 @@ } }, "required": ["task", "modes"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -1308,7 +1310,7 @@ } }, "required": ["task", "modes"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -1322,7 +1324,7 @@ } }, "required": ["task", "modes"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -1336,7 +1338,7 @@ } }, "required": ["task", "modes"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -1350,7 +1352,7 @@ } }, "required": ["task", "modes"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -1364,7 +1366,7 @@ } }, "required": ["task", "modes"], - "additionalProperties": false + "additionalProperties": true }, { "properties": { @@ -1378,7 +1380,7 @@ } }, "required": ["task", "modes"], - "additionalProperties": false + "additionalProperties": true } ] }, @@ -1393,7 +1395,7 @@ }, "required": ["tasks"], "x-status": "experimental", - "additionalProperties": false + "additionalProperties": true }, "attestations": { "$ref": "/schemas/core/attestation-capabilities.json", @@ -1685,7 +1687,7 @@ "supported", "supported_changes" ], - "additionalProperties": false + "additionalProperties": true }, { "title": "AccountIdentityUpdatesUnsupported", @@ -1704,7 +1706,7 @@ "supported_changes" ] }, - "additionalProperties": false + "additionalProperties": true } ] }, @@ -1762,7 +1764,7 @@ } }, "required": ["catalog_url", "catalog_digest"], - "additionalProperties": false + "additionalProperties": true }, "supported_pricing_models": { "type": "array", @@ -1885,7 +1887,7 @@ "required": ["supported"] }, "then": { "required": ["max_open_duration"] }, - "additionalProperties": false + "additionalProperties": true } }, "if": { @@ -1901,7 +1903,7 @@ "properties": { "list_proposals": { "const": true } }, "required": ["list_proposals"] }, - "additionalProperties": false + "additionalProperties": true }, "reporting_delivery_methods": { "type": "array", @@ -2042,7 +2044,7 @@ } }, "required": ["supported", "registration_task", "event_types", "repair_tasks"], - "additionalProperties": false + "additionalProperties": true }, "features": { "allOf": [ @@ -2231,7 +2233,7 @@ "type": "boolean" } }, - "additionalProperties": false + "additionalProperties": true }, "geo_postal_areas": { "description": "Postal area targeting. Prefer the native country-keyed map where each ISO 3166-1 alpha-2 country lists supported country-local postal systems. Deprecated legacy country-fused postal-system boolean aliases may be emitted alongside native country keys during migration.", @@ -2448,7 +2450,7 @@ } }, "required": ["requirement"], - "additionalProperties": false + "additionalProperties": true }, "audience_targeting": { "type": "object", @@ -2505,7 +2507,7 @@ "minimum": 0 } }, - "additionalProperties": false + "additionalProperties": true } }, "required": ["supported_identifier_types", "minimum_audience_size"], @@ -2993,11 +2995,11 @@ } }, "required": ["requirement", "claim_types"], - "additionalProperties": false + "additionalProperties": true } }, "required": ["signal_activation"], - "additionalProperties": false + "additionalProperties": true }, "aggregation_window_days": { "type": "integer", @@ -3473,7 +3475,7 @@ "description": "Informational implementation origin. platform_native means the route uses the serving platform's preview machinery; agent_approximation means the agent renders an approximation. Neither value grants authority without a publisher preview_provider delegation." } }, - "additionalProperties": false + "additionalProperties": true }, "minItems": 1, "x-adcp-validation": { @@ -3482,7 +3484,7 @@ "x-max-items-4.0": 128 } }, - "additionalProperties": false, + "additionalProperties": true, "x-adcp-validation": { "verifier_constraints": { "routes": "capability_id_set_equals_routable_capability_ids_of_creative.supported_formats_entries_with_preview_operation" @@ -3974,7 +3976,7 @@ "description": "Origin (scheme + host) serving the TMP-signing JWKS, when this operator participates in TMP." } }, - "additionalProperties": false, + "additionalProperties": true, "x-adcp-validation": { "verifier_constraints": { "purpose_anchoring": { @@ -4002,7 +4004,7 @@ "default": false } }, - "additionalProperties": false + "additionalProperties": true } }, "additionalProperties": true @@ -4108,7 +4110,7 @@ } }, "required": ["accrediting_body"], - "additionalProperties": false + "additionalProperties": true }, "uniqueItems": true, "maxItems": 8 @@ -4148,7 +4150,7 @@ } }, "required": ["metric_id"], - "additionalProperties": false + "additionalProperties": true }, "minItems": 1, "uniqueItems": true, diff --git a/static/schemas/source/protocol/get-principal-request.json b/static/schemas/source/protocol/get-principal-request.json index d51d395cce4..42182782998 100644 --- a/static/schemas/source/protocol/get-principal-request.json +++ b/static/schemas/source/protocol/get-principal-request.json @@ -32,7 +32,7 @@ "pagination": { "$ref": "/schemas/core/pagination-request.json" } }, "required": ["subscription_id", "list"], - "additionalProperties": false + "additionalProperties": true }, "context": { "$ref": "/schemas/core/context.json" diff --git a/static/schemas/source/protocol/get-principal-response.json b/static/schemas/source/protocol/get-principal-response.json index f792d19ea18..06571d0135d 100644 --- a/static/schemas/source/protocol/get-principal-response.json +++ b/static/schemas/source/protocol/get-principal-response.json @@ -67,11 +67,11 @@ { "if": { "properties": { "list": { "const": "accounts_unauthorized" } }, "required": ["list"] }, "then": { "required": ["accounts_unauthorized"], "not": { "anyOf": [{ "required": ["accounts_with_exceptions"] }, { "required": ["prior_versions"] }] } } }, { "if": { "properties": { "list": { "const": "prior_versions" } }, "required": ["list"] }, "then": { "required": ["prior_versions"], "not": { "anyOf": [{ "required": ["accounts_with_exceptions"] }, { "required": ["accounts_unauthorized"] }] } } } ], - "additionalProperties": false + "additionalProperties": true } }, "required": ["kind", "principal_id", "principal_kind", "configuration_version", "configuration"], - "additionalProperties": false + "additionalProperties": true }, { "title": "Recognized principal without standing configuration", diff --git a/static/schemas/source/protocol/sync-principal-request.json b/static/schemas/source/protocol/sync-principal-request.json index 5a3fd82aec8..d2031cf93fa 100644 --- a/static/schemas/source/protocol/sync-principal-request.json +++ b/static/schemas/source/protocol/sync-principal-request.json @@ -114,7 +114,7 @@ } }, "minProperties": 1, - "additionalProperties": false + "additionalProperties": true }, "dry_run": { "type": "boolean", diff --git a/static/schemas/source/protocol/sync-principal-response.json b/static/schemas/source/protocol/sync-principal-response.json index f5adea0ad9d..4b786e2c782 100644 --- a/static/schemas/source/protocol/sync-principal-response.json +++ b/static/schemas/source/protocol/sync-principal-response.json @@ -60,9 +60,10 @@ } }, "required": ["kind", "action", "dry_run", "principal_id", "principal_kind", "configuration_version", "configuration"], - "additionalProperties": false + "additionalProperties": true }, { + "description": "Rejects `destination_ref` and `configuration_version`: a dry run issues no durable identifier.", "title": "Validated principal dry run", "type": "object", "properties": { @@ -87,7 +88,8 @@ } }, "required": ["kind", "action", "dry_run"], - "additionalProperties": false + "not": { "anyOf": [{ "required": ["destination_ref"] }, { "required": ["configuration_version"] }] }, + "additionalProperties": true }, { "title": "Failed principal sync", diff --git a/static/schemas/source/registries/v1-canonical-mapping.json b/static/schemas/source/registries/v1-canonical-mapping.json index 2cfff89ea4b..16349673494 100644 --- a/static/schemas/source/registries/v1-canonical-mapping.json +++ b/static/schemas/source/registries/v1-canonical-mapping.json @@ -110,7 +110,7 @@ "description": "Value transform applied during forwarding. identity copies the value; singleton_array wraps it in a one-element array." } }, - "additionalProperties": false + "additionalProperties": true } } } diff --git a/static/schemas/source/signals/get-signals-response.json b/static/schemas/source/signals/get-signals-response.json index 02a2ed94ca3..b2053849fb0 100644 --- a/static/schemas/source/signals/get-signals-response.json +++ b/static/schemas/source/signals/get-signals-response.json @@ -74,7 +74,7 @@ "min", "max" ], - "additionalProperties": false + "additionalProperties": true }, "signal_type": { "$ref": "/schemas/enums/signal-catalog-type.json", @@ -188,7 +188,7 @@ "scope", "description" ], - "additionalProperties": false + "additionalProperties": true } }, "wholesale_feed_version": { diff --git a/static/schemas/source/sponsored-intelligence/si-sponsored-context.json b/static/schemas/source/sponsored-intelligence/si-sponsored-context.json index 858aa193d70..94f040a14cd 100644 --- a/static/schemas/source/sponsored-intelligence/si-sponsored-context.json +++ b/static/schemas/source/sponsored-intelligence/si-sponsored-context.json @@ -27,7 +27,7 @@ "required": [ "account_id" ], - "additionalProperties": false + "additionalProperties": true }, "operator": { "type": "string", diff --git a/static/schemas/source/trust/v1/trust-acknowledgements.json b/static/schemas/source/trust/v1/trust-acknowledgements.json index 5d2e388bc04..c4c9de4e067 100644 --- a/static/schemas/source/trust/v1/trust-acknowledgements.json +++ b/static/schemas/source/trust/v1/trust-acknowledgements.json @@ -30,5 +30,5 @@ "required": [ "acknowledgements" ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/trusted-match/available-package.json b/static/schemas/source/trusted-match/available-package.json index 2c78e1e6cdd..2a4c1da7e11 100644 --- a/static/schemas/source/trusted-match/available-package.json +++ b/static/schemas/source/trusted-match/available-package.json @@ -52,5 +52,5 @@ "media_buy_id", "seller_agent" ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/trusted-match/context-match-response.json b/static/schemas/source/trusted-match/context-match-response.json index 6175420ea55..fb9a42d6a7e 100644 --- a/static/schemas/source/trusted-match/context-match-response.json +++ b/static/schemas/source/trusted-match/context-match-response.json @@ -30,7 +30,7 @@ "key", "value" ], - "additionalProperties": false + "additionalProperties": true } } }, @@ -89,7 +89,7 @@ "required": [ "targeting_kvs" ], - "additionalProperties": false + "additionalProperties": true }, "minProperties": 1 } diff --git a/static/schemas/source/trusted-match/identity-match-response.json b/static/schemas/source/trusted-match/identity-match-response.json index 9ec4568b535..35126e3937b 100644 --- a/static/schemas/source/trusted-match/identity-match-response.json +++ b/static/schemas/source/trusted-match/identity-match-response.json @@ -62,7 +62,7 @@ } }, "required": ["chunks"], - "additionalProperties": false + "additionalProperties": true } } }, diff --git a/static/schemas/source/trusted-match/offer-price.json b/static/schemas/source/trusted-match/offer-price.json index 99e4e153e4d..ba03ebff4bf 100644 --- a/static/schemas/source/trusted-match/offer-price.json +++ b/static/schemas/source/trusted-match/offer-price.json @@ -27,5 +27,5 @@ "amount", "model" ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/trusted-match/provider-context-match-response.json b/static/schemas/source/trusted-match/provider-context-match-response.json index 9d92ba3ad81..7506dbfbe97 100644 --- a/static/schemas/source/trusted-match/provider-context-match-response.json +++ b/static/schemas/source/trusted-match/provider-context-match-response.json @@ -30,7 +30,7 @@ "key", "value" ], - "additionalProperties": false + "additionalProperties": true } } }, diff --git a/static/schemas/source/trusted-match/provider-registration.json b/static/schemas/source/trusted-match/provider-registration.json index 0e28452f28b..1113ad91513 100644 --- a/static/schemas/source/trusted-match/provider-registration.json +++ b/static/schemas/source/trusted-match/provider-registration.json @@ -113,5 +113,5 @@ { "properties": { "context_match": { "const": true } }, "required": ["context_match"] }, { "properties": { "identity_match": { "const": true } }, "required": ["identity_match"] } ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/trusted-match/publisher-targeting-kv-config.json b/static/schemas/source/trusted-match/publisher-targeting-kv-config.json index 30192abdbf7..9abc10743d2 100644 --- a/static/schemas/source/trusted-match/publisher-targeting-kv-config.json +++ b/static/schemas/source/trusted-match/publisher-targeting-kv-config.json @@ -30,7 +30,7 @@ "required": [ "targeting_kv_mapping" ], - "additionalProperties": false, + "additionalProperties": true, "examples": [ { "targeting_kv_mapping": { diff --git a/static/schemas/source/trusted-match/publisher-tmpx-config.json b/static/schemas/source/trusted-match/publisher-tmpx-config.json index e3c8cee5717..e364315cf2c 100644 --- a/static/schemas/source/trusted-match/publisher-tmpx-config.json +++ b/static/schemas/source/trusted-match/publisher-tmpx-config.json @@ -37,5 +37,5 @@ "required": [ "tmpx_macro_mapping" ], - "additionalProperties": false + "additionalProperties": true } diff --git a/static/schemas/source/trusted-match/tmpx-chunk.json b/static/schemas/source/trusted-match/tmpx-chunk.json index d36bcb66ec2..01432ccf1d6 100644 --- a/static/schemas/source/trusted-match/tmpx-chunk.json +++ b/static/schemas/source/trusted-match/tmpx-chunk.json @@ -21,5 +21,5 @@ } }, "required": ["slot_id", "value"], - "additionalProperties": false + "additionalProperties": true } diff --git a/tests/account-ref.test.cjs b/tests/account-ref.test.cjs new file mode 100644 index 00000000000..bd730d7b5fc --- /dev/null +++ b/tests/account-ref.test.cjs @@ -0,0 +1,49 @@ +const assert = require('node:assert/strict'); +const test = require('node:test'); +const Ajv = require('ajv'); +const addFormats = require('ajv-formats'); +const { ensureBuiltSchemas, readBuiltSchema } = require('../scripts/built-schemas.cjs'); + +ensureBuiltSchemas(); + +const readSchema = (relativePath) => readBuiltSchema(`/schemas/${relativePath}`); + +async function compile() { + const ajv = new Ajv({ + allErrors: true, + strict: false, + discriminator: true, + loadSchema: async (uri) => readSchema(uri.replace('/schemas/', '')), + }); + addFormats(ajv); + return ajv.compileAsync(readSchema('core/account-ref.json')); +} + +const errors = (validate) => JSON.stringify(validate.errors, null, 2); +const BRAND = { domain: 'nova-athletics.example' }; +const OPERATOR = 'nova-athletics.example'; + +test('an account ref is an account_id or the brand + operator natural key', async () => { + const validate = await compile(); + assert.equal(validate({ account_id: 'acc_nova_nl' }), true, errors(validate)); + assert.equal(validate({ brand: BRAND, operator: OPERATOR }), true, errors(validate)); + assert.equal(validate({}), false, 'one of the two forms is required'); + assert.equal(validate({ brand: BRAND }), false, 'the natural key needs an operator'); +}); + +test('the account_id form names no natural-key member, and the natural key names no account_id', async () => { + const validate = await compile(); + const members = { brand: BRAND, operator: OPERATOR, operator_unit: { id: 'unit_1' }, currency: 'USD', timezone: 'Europe/Amsterdam', sandbox: true }; + for (const [name, value] of Object.entries(members)) { + assert.equal(validate({ account_id: 'acc_nova_nl', [name]: value }), false, `${name} beside account_id`); + } + assert.equal(validate({ account_id: 'acc_nova_nl', brand: BRAND, operator: OPERATOR }), false, 'both forms at once'); + assert.equal(validate({ brand: BRAND, operator: OPERATOR, account_id: 'acc_nova_nl' }), false, 'account_id beside the natural key'); +}); + +test('an unknown key on an account ref validates', async () => { + const validate = await compile(); + // Open by default (WG decision of 2026-11-09, DR-0036): an unknown key validates. + assert.equal(validate({ account_id: 'acc_nova_nl', note: 'x' }), true, errors(validate)); + assert.equal(validate({ brand: BRAND, operator: OPERATOR, note: 'x' }), true, errors(validate)); +}); diff --git a/tests/audience-evidence-targets.test.cjs b/tests/audience-evidence-targets.test.cjs index dcc4f285bb6..c674caacb0b 100644 --- a/tests/audience-evidence-targets.test.cjs +++ b/tests/audience-evidence-targets.test.cjs @@ -131,23 +131,25 @@ describe('audience evidence target audiences (#8125)', () => { assert.equal(validatePackageRequest(packageRequest), false); }); - it('keeps the closed requirements schemas unchanged: target_audiences is not a member', () => { + it('keeps the requirements schemas unchanged: target_audiences is not a declared member', () => { assert.equal(validateRequirements(base), true); assert.equal(validateCompact(base), true); - assert.equal(validateRequirements({ ...base, target_audiences: [target] }), false); - assert.equal(validateCompact({ ...base, target_audiences: [target] }), false); + // Open by default (DR-0036): an unknown key validates, so target_audiences is accepted though undeclared. + assert.equal(validateRequirements({ ...base, target_audiences: [target] }), true); + assert.equal(validateCompact({ ...base, target_audiences: [target] }), true); for (const uri of ['/schemas/core/audience-evidence-requirements.json', '/schemas/core/product-audience-evidence-requirements.json']) { assert.equal(readSchema(uri).properties.target_audiences, undefined, uri); } }); - it('requires audience, relationship, and minimum_value and closes the item', () => { + it('requires audience, relationship, and minimum_value; an unknown key on the item validates', () => { for (const field of ['audience', 'relationship', 'minimum_value']) { const invalid = clone(target); delete invalid[field]; assert.equal(validateTarget(invalid), false, field); } - assert.equal(validateTarget({ ...target, strength: 'required' }), false); + // Open by default (DR-0036): `strength` is an unknown key and validates. + assert.equal(validateTarget({ ...target, strength: 'required' }), true); assert.equal(validateTarget({ ...target, relationship: 'affinity' }), false); assert.equal(validateTarget({ ...target, minimum_value: -0.1 }), false); assert.equal(validateTarget({ ...target, audience: { dimension: 'age' } }), false); @@ -170,20 +172,21 @@ describe('audience evidence target audiences (#8125)', () => { assert.equal(filtersWith([{ ...target, audience: { dimension: 'age', range: { min: -1, max: 54 } } }]), false); }); - it('accepts target_audiences on create_media_buy packages and leaves the closed purchase path to 4.0', () => { + it('accepts target_audiences on create_media_buy packages and leaves the purchase path to 4.0', () => { assert.equal(validatePackageRequest(fixture.package_request), true, JSON.stringify(validatePackageRequest.errors)); const packageRequest = clone(fixture.package_request); packageRequest.target_audiences = [target]; assert.equal(validatePackageRequest(packageRequest), true, JSON.stringify(validatePackageRequest.errors)); - // Closed purchase schemas do not carry the sibling in 3.3: the field is a 4.0 addition. - for (const [validate, schemaUri] of [ - [validatePurchaseInput, '/schemas/media-buy/product-purchase-input.json'], - [validatePurchase, '/schemas/media-buy/product-purchase.json'], + // The purchase schemas do not declare the sibling in 3.3: the field is a 4.0 addition. + // product-purchase-input.json is open by default (DR-0036); product-purchase.json stays closed (signed terms). + for (const [validate, schemaUri, additionalProperties] of [ + [validatePurchaseInput, '/schemas/media-buy/product-purchase-input.json', true], + [validatePurchase, '/schemas/media-buy/product-purchase.json', false], ]) { const schema = readSchema(schemaUri); assert.equal(schema.properties.target_audiences, undefined, schemaUri); - assert.equal(schema.additionalProperties, false, schemaUri); + assert.equal(schema.additionalProperties, additionalProperties, schemaUri); assert.equal(validate.schema.properties.target_audiences, undefined, schemaUri); } }); diff --git a/tests/canonical-account-ref.test.cjs b/tests/canonical-account-ref.test.cjs new file mode 100644 index 00000000000..c814b484a64 --- /dev/null +++ b/tests/canonical-account-ref.test.cjs @@ -0,0 +1,49 @@ +const assert = require('node:assert/strict'); +const test = require('node:test'); +const Ajv = require('ajv'); +const addFormats = require('ajv-formats'); +const { ensureBuiltSchemas, readBuiltSchema } = require('../scripts/built-schemas.cjs'); + +ensureBuiltSchemas(); + +const readSchema = (relativePath) => readBuiltSchema(`/schemas/${relativePath}`); + +async function compile() { + const ajv = new Ajv({ + allErrors: true, + strict: false, + discriminator: true, + loadSchema: async (uri) => readSchema(uri.replace('/schemas/', '')), + }); + addFormats(ajv); + return ajv.compileAsync(readSchema('core/canonical-account-ref.json')); +} + +const errors = (validate) => JSON.stringify(validate.errors, null, 2); +const BRAND = { domain: 'nova-athletics.example' }; +const OPERATOR = 'nova-athletics.example'; + +test('a canonical account ref is an account_id or the brand + operator natural key', async () => { + const validate = await compile(); + assert.equal(validate({ account_id: 'acc_nova_nl' }), true, errors(validate)); + assert.equal(validate({ brand: BRAND, operator: OPERATOR }), true, errors(validate)); + assert.equal(validate({}), false, 'one of the two forms is required'); + assert.equal(validate({ brand: BRAND }), false, 'the natural key needs an operator'); +}); + +test('the account_id form names no natural-key member, and the natural key names no account_id', async () => { + const validate = await compile(); + assert.equal(validate({ account_id: 'acc_nova_nl', brand: BRAND }), false, 'brand beside account_id'); + assert.equal(validate({ account_id: 'acc_nova_nl', operator: OPERATOR }), false, 'operator beside account_id'); + assert.equal(validate({ account_id: 'acc_nova_nl', brand: BRAND, operator: OPERATOR }), false, 'both forms at once'); + assert.equal(validate({ account_id: 'acc_nova_nl', sandbox: true }), false, 'sandbox beside account_id'); + assert.equal(validate({ account_id: 'acc_nova_nl', currency: 'USD' }), false, 'currency beside account_id'); + assert.equal(validate({ brand: BRAND, operator: OPERATOR, account_id: 'acc_nova_nl' }), false, 'account_id beside the natural key'); +}); + +test('an unknown key on a canonical account ref validates', async () => { + const validate = await compile(); + // Open by default (WG decision of 2026-11-09, DR-0036): an unknown key validates. + assert.equal(validate({ account_id: 'acc_nova_nl', note: 'x' }), true, errors(validate)); + assert.equal(validate({ brand: BRAND, operator: OPERATOR, note: 'x' }), true, errors(validate)); +}); diff --git a/tests/canonical-installments.test.cjs b/tests/canonical-installments.test.cjs index 3d6f01aed95..693486e8d7a 100644 --- a/tests/canonical-installments.test.cjs +++ b/tests/canonical-installments.test.cjs @@ -97,12 +97,14 @@ test('a canonical installment is identified by the (collection_ref, installment_ assert.equal(validate(omit(slot(1), 'collection_ref')), false, 'collection_ref is required'); assert.equal(validate(omit(slot(1), 'installment_id')), false, 'installment_id is required'); assert.equal(validate({ ...slot(1), collection_id: COLLECTION_ID }), false, 'the deprecated shorthand is not inherited'); - assert.equal(validate({ ...slot(1), undeclared: true }), false, 'the canonical shape is closed'); + // Open by default (DR-0036): an unknown key validates. + assert.equal(validate({ ...slot(1), undeclared: true }), true, errors(validate)); assert.equal(validate({ ...slot(1), collection_ref: { collection_id: COLLECTION_ID } }), false, 'publisher_domain scopes the ID'); assert.equal(validate({ ...slot(1), installment_id: '' }), false, 'installment_id is non-empty'); const schema = readSchema('core/canonical-installment.json'); - assert.equal(schema.additionalProperties, false); + // Open by default (DR-0036). + assert.equal(schema.additionalProperties, true); assert.deepEqual(schema.required, ['installment_id', 'collection_ref']); assert.equal(schema.properties.collection_id, undefined, 'no deprecated shorthand is declared'); assert.equal(schema.properties.installment_id['x-entity'], 'installment'); diff --git a/tests/capabilities-structural-bounds.test.cjs b/tests/capabilities-structural-bounds.test.cjs index 7a38468e1fc..7dc70ee4e08 100644 --- a/tests/capabilities-structural-bounds.test.cjs +++ b/tests/capabilities-structural-bounds.test.cjs @@ -28,7 +28,7 @@ const security = read('docs/building/by-layer/L1/security.mdx'); // The documented worst case. Update security.mdx with this number. const DOCUMENTED_WORST_CASE_BYTES = 99_101_026; -const DOCUMENTED_OPEN_POSITIONS = 108; +const DOCUMENTED_OPEN_POSITIONS = 190; const rows = bounds.coverage(); const KEYWORD_BY_KIND = { array: 'maxItems', string: 'maxLength', map: 'maxProperties' }; diff --git a/tests/collection-catalog.test.cjs b/tests/collection-catalog.test.cjs index 98e161a81c5..908ba99b5f8 100644 --- a/tests/collection-catalog.test.cjs +++ b/tests/collection-catalog.test.cjs @@ -105,12 +105,14 @@ test('list_collections request: selectors, filters and pagination, strict', () = }; assert.equal(requestSchema(ok), true, JSON.stringify(requestSchema.errors)); assert.equal(requestSchema({}), true, 'every field is optional: an empty request browses the catalog'); - assert.equal(requestSchema({ ...ok, include_products: true }), false, 'the request rejects unknown fields'); - assert.equal(requestSchema({ ...ok, filters: { audience_size_min: 1000 } }), false, 'unknown filters are rejected'); - assert.equal(requestSchema({ ...ok, filters: { sort: 'followers' } }), false, 'there is no sort'); + // Open by default (DR-0036): unknown request fields and filter keys validate; `sort` is not a declared filter. + assert.equal(requestSchema({ ...ok, include_products: true }), true, 'the request accepts unknown fields'); + assert.equal(requestSchema({ ...ok, filters: { audience_size_min: 1000 } }), true, 'unknown filters are accepted'); + assert.equal(requestSchema({ ...ok, filters: { sort: 'followers' } }), true, 'sort is not declared, so it is an unknown key'); assert.equal(requestSchema({ ...ok, pagination: { max_results: 101 } }), false, 'pagination caps at 100'); - assert.equal(requestSchema({ ...ok, filters: { talent: [{ domain: 'jordanvega.example', countries: ['US'] }] } }), false, - 'talent filters read only domain and brand_id'); + // Open by default (DR-0036): an unknown key on a talent filter validates. + assert.equal(requestSchema({ ...ok, filters: { talent: [{ domain: 'jordanvega.example', countries: ['US'] }] } }), true, + 'unknown talent filter keys are accepted'); assert.equal(requestSchema({ ...ok, filters: { statuses: ['paused'] } }), false, 'statuses use collection-status'); const schema = read('media-buy/list-collections-request.json'); assert.equal(schema['x-status'], 'experimental'); diff --git a/tests/collection-mechanism.test.cjs b/tests/collection-mechanism.test.cjs index be47e1c3eb3..968ec1f7f15 100644 --- a/tests/collection-mechanism.test.cjs +++ b/tests/collection-mechanism.test.cjs @@ -50,9 +50,10 @@ describe("collection mechanism vocabulary", () => { assert.equal(sibling.items.$ref, "/schemas/core/vendor-metric-provenance.json"); }); - it("leaves the closed schemas unchanged (DR-0036): the fields live on open homes", () => { + it("leaves the row schemas unchanged (DR-0036): the fields live on open homes", () => { const row = readSchema("/schemas/core/vendor-metric-value.json"); - assert.equal(row.additionalProperties, false); + // Open by default (DR-0036). + assert.equal(row.additionalProperties, true); assert.equal(row.properties.measurement_provenance, undefined); const canonical = readSchema("/schemas/core/canonical-measurement-terms.json"); assert.equal(canonical.properties.billing_measurement.properties.counting_mechanisms, undefined); @@ -96,9 +97,10 @@ describe("collection mechanism vocabulary", () => { assert.ok(!validateEntry(entry({ mechanisms: ["panel"], deduplicated: "yes" }))); assert.ok(!validateMetrics({ vendor_metric_provenance: [] })); }); - it("stays open per DR-0009 while the enclosing row stays closed", () => { + it("stays open per DR-0009, and so does the enclosing row", () => { assert.ok(validateEntry(entry({ mechanisms: ["panel"], vendor_note: "x" }))); - assert.ok(!validateMetrics({ vendor_metric_values: [{ ...row, mechanisms: ["panel"] }] })); + // Open by default (DR-0036): an unknown key on the row validates. + assert.ok(validateMetrics({ vendor_metric_values: [{ ...row, mechanisms: ["panel"] }] })); }); }); diff --git a/tests/composed-schema-validation.test.cjs b/tests/composed-schema-validation.test.cjs index 46c9fc13d5e..fb825df35fe 100644 --- a/tests/composed-schema-validation.test.cjs +++ b/tests/composed-schema-validation.test.cjs @@ -3583,13 +3583,14 @@ async function runTests() { }, 'SignalCoverageForecast scope accepts seller-specific extra qualifier (inventory_class)' ); - await testSchemaRejection( + // Open by default (DR-0036): the typo is an unknown key and is ignored. + await testSchemaValidation( '/schemas/core/signal-coverage-forecast.json', { ...signalCoverageForecast, bucket_completness: 'partial' }, - 'SignalCoverageForecast rejects unknown top-level field (bucket_completness typo)' + 'SignalCoverageForecast ignores unknown top-level field (bucket_completness typo)' ); log(''); @@ -6768,7 +6769,8 @@ async function runTests() { }, 'Rejects DSR routing that declares no access, erasure, or objection channel' ); - await testSchemaRejection( + // Open by default (DR-0036): signal-level gpc_honored is an unknown key and validates (ignored). + await testSchemaValidation( '/schemas/core/signal-definition.json', { id: 'dsr_gpc_not_signal_level', @@ -6784,7 +6786,7 @@ async function runTests() { gpc_honored: true } }, - 'Rejects signal-level gpc_honored in DSR routing' + 'Ignores signal-level gpc_honored in DSR routing (unknown key)' ); log(''); diff --git a/tests/daypart-time-of-day.test.cjs b/tests/daypart-time-of-day.test.cjs index 6cb2f99cbf4..9f1ca61dfb4 100644 --- a/tests/daypart-time-of-day.test.cjs +++ b/tests/daypart-time-of-day.test.cjs @@ -41,6 +41,9 @@ test("daypart entries carry exactly one of the hour or clock-time forms", async { days: ["friday", "saturday"], start_time: "22:00", end_time: "02:00", label: "Late fringe" }, { days: ["sunday"], start_time: "23:15", end_time: "00:00" }, { days: ["monday"], start_time: "00:00", end_time: "06:00" }, + // The window is open (a correction under DR-0036); the oneOf still keeps the + // two forms apart. + { days: WEEKDAYS, start_time: "19:30", end_time: "23:00", end_minute: 0 }, ]; for (const daypart of valid) { assert.equal(validate(daypart), true, JSON.stringify(daypart)); @@ -57,7 +60,6 @@ test("daypart entries carry exactly one of the hour or clock-time forms", async ["complete time form plus stray hour", { days: WEEKDAYS, start_time: "19:30", end_time: "23:00", start_hour: 19 }], ["complete hour form plus stray time", { days: WEEKDAYS, start_hour: 19, end_hour: 23, end_time: "23:00" }], ["missing days", { start_time: "19:30", end_time: "23:00" }], - ["unknown field", { days: WEEKDAYS, start_time: "19:30", end_time: "23:00", end_minute: 0 }], ]; for (const [label, daypart] of invalid) { assert.equal(validate(daypart), false, label); diff --git a/tests/example-validation-simple.test.cjs b/tests/example-validation-simple.test.cjs index 4a7a322cb13..42cfea52380 100644 --- a/tests/example-validation-simple.test.cjs +++ b/tests/example-validation-simple.test.cjs @@ -1527,8 +1527,9 @@ async function runTests() { "refine": [{ "scope": "product", "id": "prod_video_premium", "action": "include" }] }, '/schemas/media-buy/get-products-request.json', - 'refine[] product with old `id` field is rejected and error flags the unknown property', - ['product_id', /additionalProperties|must NOT have additional propert/i] + 'refine[] product with old `id` field is rejected and error flags the missing product_id', + // Open by default (DR-0036): the unknown `id` key is no longer named; the missing `product_id` is. + ['product_id', /must have required property 'product_id'/] ); await expectInvalid( @@ -1538,8 +1539,9 @@ async function runTests() { "refine": [{ "scope": "proposal", "id": "prop_balanced_v1", "action": "finalize" }] }, '/schemas/media-buy/get-products-request.json', - 'refine[] proposal with old `id` field is rejected and error flags the unknown property', - ['proposal_id', /additionalProperties|must NOT have additional propert/i] + 'refine[] proposal with old `id` field is rejected and error flags the missing proposal_id', + // Open by default (DR-0036): the unknown `id` key is no longer named; the missing `proposal_id` is. + ['proposal_id', /must have required property 'proposal_id'/] ); // Happy path — optional `action` defaults to include server-side; schema must accept the minimal shape. diff --git a/tests/fast-channel-collections.test.cjs b/tests/fast-channel-collections.test.cjs index b43665d3554..960c06e39e0 100644 --- a/tests/fast-channel-collections.test.cjs +++ b/tests/fast-channel-collections.test.cjs @@ -220,12 +220,13 @@ test('sample_content role takes a url or video asset but not a published_post', assert.equal(validate({ role: 'sample_content', asset: { asset_type: 'published_post', post_url: 'https://video.example.com/watch/1' } }), false); }); -test('collection card fields reject malformed entries and the registry lists the feature id', async () => { +test('collection card fields reject malformed entries, accept unknown keys, and the registry lists the feature id', async () => { const validate = await compile('/schemas/core/collection.json'); const base = { collection_id: 'retro_news', name: 'Acme Retro News' }; assert.equal(validate({ ...base, images: [{ asset_type: 'video', url: 'https://cdn.example.com/a.mp4' }] }), false); assert.equal(validate({ ...base, sample_content: [{ asset_type: 'published_post' }] }), false); - assert.equal(validate({ ...base, talent: [{ role: 'host', name: 'Jordan Vega', brand_ref: { domain: 'jordanvega.example.com', bogus: true } }] }), false); + // Open by default (DR-0036): an unknown key on brand_ref validates. + assert.equal(validate({ ...base, talent: [{ role: 'host', name: 'Jordan Vega', brand_ref: { domain: 'jordanvega.example.com', bogus: true } }] }), true); const role = await compile('/schemas/core/product-card-reference-asset.json'); assert.equal(role({ role: 'bogus_role', asset: { asset_type: 'url', url: 'https://example.com' } }), false); const registry = fs.readFileSync(path.join(__dirname, '../docs/reference/experimental-status.mdx'), 'utf8'); diff --git a/tests/hold-policy.test.cjs b/tests/hold-policy.test.cjs index d9041009692..73676835fea 100644 --- a/tests/hold-policy.test.cjs +++ b/tests/hold-policy.test.cjs @@ -88,14 +88,15 @@ const DRAFT = { terms_digest: 'sha256:IO3B2jLn52O7-u_xeztyhTFDUJWbV4mQrCcTfCWpAQg', }; -test('hold_policy validates standalone and rejects undeclared properties', async () => { +test('hold_policy validates standalone and accepts undeclared properties', async () => { const validate = await compile('/schemas/core/hold-policy.json'); assert.equal(validate(HOLDABLE), true, errors(validate)); assert.equal(validate({ available: true }), true, errors(validate)); assert.equal(validate({ available: false }), true, errors(validate)); assert.equal(validate({ available: false, extendable: false }), false, 'extendable is forbidden without a hold'); assert.equal(validate({}), false, 'available is required'); - assert.equal(validate({ ...HOLDABLE, undeclared: true }), false, 'additionalProperties is closed'); + // Open by default (DR-0036): an unknown key validates. + assert.equal(validate({ ...HOLDABLE, undeclared: true }), true, errors(validate)); assert.equal(validate({ available: 'yes' }), false); }); @@ -142,7 +143,8 @@ test('legacy and canonical products carry hold_policy', async () => { const validateCanonical = await compile('/schemas/core/canonical-product.json'); assert.equal(validateCanonical({ ...CANONICAL_PRODUCT, hold_policy: HOLDABLE }), true, errors(validateCanonical)); - assert.equal(validateCanonical({ ...CANONICAL_PRODUCT, hold_policy: { ...HOLDABLE, undeclared: 1 } }), false); + // Open by default (DR-0036): an unknown key inside hold_policy validates. + assert.equal(validateCanonical({ ...CANONICAL_PRODUCT, hold_policy: { ...HOLDABLE, undeclared: 1 } }), true, errors(validateCanonical)); }); test('only canonical proposals carry hold_policy; the legacy proposal does not', async () => { @@ -200,7 +202,8 @@ test('hold_policy surfaces are experimental 3.3 additions', () => { const holdPolicy = readSchema('core/hold-policy.json'); assert.equal(holdPolicy['x-status'], 'experimental'); assert.equal(holdPolicy['x-added-in'], '3.3.0'); - assert.equal(holdPolicy.additionalProperties, false); + // Open by default (DR-0036). + assert.equal(holdPolicy.additionalProperties, true); assert.deepEqual(holdPolicy.required, ['available']); for (const [name, field] of Object.entries(holdPolicy.properties)) { assert.equal(field['x-status'], 'experimental', `${name} x-status`); diff --git a/tests/identity-absence-coherence.test.cjs b/tests/identity-absence-coherence.test.cjs index 19a82916c71..daee0e0c5a6 100644 --- a/tests/identity-absence-coherence.test.cjs +++ b/tests/identity-absence-coherence.test.cjs @@ -106,8 +106,9 @@ test("identity-absent products cannot advertise identifier-backed frequency-cap ...completeProduct, identity: { ...completeProduct.identity, undeclared: true }, }), - false, - "identity declaration remains a closed experimental object" + true, + // Open by default (DR-0036): an unknown key on the identity declaration validates. + "identity declaration accepts an unknown key" ); const identity = readJson("core/product-identity.json"); diff --git a/tests/image-bleed.test.cjs b/tests/image-bleed.test.cjs new file mode 100644 index 00000000000..56fb6a33872 --- /dev/null +++ b/tests/image-bleed.test.cjs @@ -0,0 +1,45 @@ +const assert = require('node:assert/strict'); +const test = require('node:test'); +const Ajv = require('ajv'); +const addFormats = require('ajv-formats'); +const { ensureBuiltSchemas, readBuiltSchema } = require('../scripts/built-schemas.cjs'); + +ensureBuiltSchemas(); + +const readSchema = (relativePath) => readBuiltSchema(`/schemas/${relativePath}`); + +async function compile() { + const ajv = new Ajv({ + allErrors: true, + strict: false, + discriminator: true, + loadSchema: async (uri) => readSchema(uri.replace('/schemas/', '')), + }); + addFormats(ajv); + return ajv.compileAsync(readSchema('core/requirements/image-asset-requirements.json')); +} + +const errors = (validate) => JSON.stringify(validate.errors, null, 2); +const withBleed = (bleed) => ({ bleed }); + +test('bleed is either one uniform value or all four sides', async () => { + const validate = await compile(); + assert.equal(validate(withBleed({ uniform: 2 })), true, errors(validate)); + assert.equal(validate(withBleed({ top: 1, right: 1, bottom: 1, left: 1 })), true, errors(validate)); + assert.equal(validate(withBleed({})), false, 'one form is required'); + assert.equal(validate(withBleed({ top: 1, right: 1 })), false, 'the per-side form needs all four sides'); + assert.equal(validate(withBleed({ uniform: -1 })), false, 'bleed is not negative'); +}); + +test('the uniform and per-side bleed forms exclude each other', async () => { + const validate = await compile(); + assert.equal(validate(withBleed({ uniform: 2, top: 1 })), false, 'uniform with one side'); + assert.equal(validate(withBleed({ uniform: 2, top: 1, right: 1, bottom: 1, left: 1 })), false, 'per-side form plus uniform'); +}); + +test('an unknown key on bleed validates', async () => { + const validate = await compile(); + // Open by default (WG decision of 2026-11-09, DR-0036): an unknown key validates. + assert.equal(validate(withBleed({ uniform: 2, note: 'x' })), true, errors(validate)); + assert.equal(validate(withBleed({ top: 1, right: 1, bottom: 1, left: 1, note: 'x' })), true, errors(validate)); +}); diff --git a/tests/lint-additive-minor.test.cjs b/tests/lint-additive-minor.test.cjs index 2e96703055a..010485c1078 100644 --- a/tests/lint-additive-minor.test.cjs +++ b/tests/lint-additive-minor.test.cjs @@ -29,7 +29,6 @@ const { findingKey, historyPairs, lintAdditiveMinor, - recordedCorrections, readBaselineAtRef, } = require('../scripts/lint-additive-minor.cjs'); const { fixtureEnv, gitFixture } = require('./helpers/git-object-fixture.cjs'); @@ -223,12 +222,36 @@ for (const { kind, change, expected } of VIOLATION_CASES) { }); } -test('reads closure from the base, so opening an object while adding a property still fails', () => { - const findings = findingsAfter((t) => { +test('an addition to a node closed in both base and candidate fails', () => { + assert.deepEqual( + findingsAfter((t) => { t['core/closed.json'].properties.extra = { type: 'string' }; }).map((f) => [f.kind, f.detail]), + [['property-added-to-closed', 'property extra added']], + ); +}); + +test('opening an object while adding a property passes with one notice', () => { + const { findings, notices } = compareTrees(tree('base', fixture()), tree('candidate', (() => { + const t = fixture(); t['core/closed.json'].additionalProperties = true; t['core/closed.json'].properties.extra = { type: 'string' }; - }); - assert.deepEqual(findings.map((f) => [f.kind, f.detail]), [['property-added-to-closed', 'property extra added']]); + return t; + })())); + assert.deepEqual(findings, []); + assert.deepEqual(notices.map((n) => [n.kind, n.file, n.detail]), [ + ['additional-properties-opened', 'core/closed.json', 'additionalProperties false → true'], + ]); +}); + +test('an addition to a node that is open in the base passes', () => { + assert.deepEqual(findingsAfter((t) => { t['core/explicit-open.json'].properties.extra = { type: 'string' }; }), []); + assert.deepEqual(findingsAfter((t) => { t['core/open.json'].properties.extra = { type: 'string' }; }), []); +}); + +test('closing an open node fails as additional-properties-closed', () => { + assert.deepEqual( + findingsAfter((t) => { t['core/explicit-open.json'].additionalProperties = false; }).map((f) => [f.kind, f.detail]), + [['additional-properties-closed', 'additionalProperties true → false']], + ); }); test('treats unevaluatedProperties: false as closed', () => { @@ -241,125 +264,6 @@ test('treats unevaluatedProperties: false as closed', () => { assert.deepEqual(findings.map((f) => f.kind), ['property-added-to-closed']); }); -// --------------------------------------------------------------------------- -// Closed anywhere in the major (DR-0036) -// --------------------------------------------------------------------------- - -/** - * Compares a candidate with the fixture as base, where one earlier stable - * release published core/explicit-open.json closed with only `name`. - */ -function analyzeWithEarlierClosure(change, { correctionsValue, candidateVersion = '3.3.0-beta.0', earlier } = {}) { - const older = fixture(); - older['core/explicit-open.json'].additionalProperties = false; - if (earlier) earlier(older); - const candidate = fixture(); - change(candidate); - return analyze({ - base: '3.2.7', - baseTree: tree('3.2.7', fixture()), - candTree: tree('source', candidate), - candidateVersion, - earlierTrees: [{ version: '3.0.4', tree: tree('3.0.4', older) }], - correctionsValue, - repoRoot: fixtureRoot(), - }); -} - -test('an unchanged copy produces no findings when an earlier release closed a schema', () => { - const result = analyzeWithEarlierClosure(() => {}); - assert.deepEqual([result.findings, result.notices, result.errors], [[], [], []]); -}); - -test('flags a property added to a schema an earlier release closed and the base leaves open', () => { - const { findings } = analyzeWithEarlierClosure((t) => { t['core/explicit-open.json'].properties.extra = { type: 'string' }; }); - assert.deepEqual(findings, [{ - file: 'core/explicit-open.json', - pointer: '', - kind: 'property-added-to-closed', - detail: 'property extra added (closed in 3.0.4)', - }]); -}); - -test('marks a property the base already has, added after the earlier closure, as released', () => { - const base = fixture(); - base['core/explicit-open.json'].properties.shipped = { type: 'string' }; - const older = fixture(); - older['core/explicit-open.json'].additionalProperties = false; - const result = analyze({ - base: '3.2.7', - baseTree: tree('3.2.7', base), - candTree: tree('source', base), - candidateVersion: '3.3.0-beta.0', - earlierTrees: [{ version: '3.0.4', tree: tree('3.0.4', older) }], - }); - assert.deepEqual(result.findings, [{ - file: 'core/explicit-open.json', - pointer: '', - kind: 'property-added-to-closed', - detail: 'property shipped added (closed in 3.0.4)', - released: true, - }]); -}); - -test('names the last earlier release that published the schema closed', () => { - const first = fixture(); - first['core/explicit-open.json'].additionalProperties = false; - const second = fixture(); - second['core/explicit-open.json'].additionalProperties = false; - const candidate = fixture(); - candidate['core/explicit-open.json'].properties.extra = { type: 'string' }; - const { findings } = analyze({ - base: '3.2.7', - baseTree: tree('3.2.7', fixture()), - candTree: tree('source', candidate), - candidateVersion: '3.3.0-beta.0', - earlierTrees: [{ version: '3.0.0', tree: tree('3.0.0', first) }, { version: '3.0.4', tree: tree('3.0.4', second) }], - }); - assert.deepEqual(findings.map((f) => f.detail), ['property extra added (closed in 3.0.4)']); -}); - -test('keys an earlier closure on the node a $ref now reaches, not on the referring file', () => { - // The earlier release closed an inline object; the base replaced it with a - // $ref to a shared open schema. The shared schema inherits the closure. - const older = fixture(); - older['core/open.json'].properties.area = { - type: 'object', - properties: { zip: { type: 'boolean' } }, - additionalProperties: false, - }; - const base = fixture(); - base['core/area.json'] = { - $id: '/schemas/core/area.json', - type: 'object', - properties: { zip: { type: 'boolean' } }, - }; - base['core/open.json'].properties.area = { $ref: '/schemas/core/area.json' }; - const candidate = JSON.parse(JSON.stringify(base)); - candidate['core/area.json'].properties.US = { type: 'array' }; - const { findings } = analyze({ - base: '3.2.7', - baseTree: tree('3.2.7', base), - candTree: tree('source', candidate), - candidateVersion: '3.3.0-beta.0', - earlierTrees: [{ version: '3.0.28', tree: tree('3.0.28', older) }], - }); - assert.deepEqual(findings, [{ - file: 'core/area.json', - pointer: '', - kind: 'property-added-to-closed', - detail: 'property US added (closed in 3.0.28)', - }]); -}); - -test('an earlier release that marked the schema experimental does not close it', () => { - const { findings } = analyzeWithEarlierClosure( - (t) => { t['core/explicit-open.json'].properties.extra = { type: 'string' }; }, - { earlier: (t) => { t['core/explicit-open.json']['x-status'] = 'experimental'; } }, - ); - assert.deepEqual(findings, []); -}); - // --------------------------------------------------------------------------- // Notices // --------------------------------------------------------------------------- @@ -408,8 +312,8 @@ test('an opened schema in the CI check passes and reports the notice', () => { // Corrections // --------------------------------------------------------------------------- -// A repository root for correction fixtures: one source text and one decision -// record whose correction tables list the fixture corrections. +// A repository root for correction fixtures: one source text and the decision +// record that the fixture corrections list names. const FIXTURE_DECISION = 'DR-9001'; const FIXTURE_SOURCE = { path: 'docs/rule.md', quote: 'Roots and containers stay open.' }; let fixtureRootPath = null; @@ -421,43 +325,7 @@ function fixtureRoot() { // The quote wraps across a line break, as prose in the repository does. fs.writeFileSync(path.join(fixtureRootPath, FIXTURE_SOURCE.path), '# Rule\n\nRoots and containers\nstay open.\n'); fs.mkdirSync(path.join(fixtureRootPath, 'governance', 'decisions'), { recursive: true }); - fs.writeFileSync(path.join(fixtureRootPath, 'governance', 'decisions', `${FIXTURE_DECISION}-fixture.md`), [ - '## Decision', - '', - '### Corrections', - '', - '#### (a) Reopen the fixture schemas', - '', - '| Schema | Pointer | Property | Reason |', - '|---|---|---|---|', - '| `core/closed.json` | root | `*` | A root. |', - '| `core/explicit-open.json` | root | `*` | A root. |', - '| `core/union.json` | `/oneOf/0`, `/oneOf/1` | `*` | Response branches. |', - '| `core/closed.json` | `/properties/missing` | `*` | A location no schema has. |', - '', - '#### (b) Declare one property', - '', - '| Schema | Pointer | Property | Reason |', - '|---|---|---|---|', - '| `core/closed.json` | root | `extra` | Required by the rule. |', - '', - '#### (c) Tighten one bound', - '', - '| Schema | Pointer | Bound | Reason |', - '|---|---|---|---|', - '| `core/closed.json` | `/properties/id` | `minLength: 1` | The rule names an identifier. |', - '', - '#### (d) Require one name', - '', - '| Schema | Pointer | Required | Reason |', - '|---|---|---|---|', - '| `core/open.json` | root | `required: note` | The rule requires a note. |', - '', - '## Rationale', - '', - '| `core/open.json` | root | `*` | Outside the corrections section. |', - '', - ].join('\n')); + fs.writeFileSync(path.join(fixtureRootPath, 'governance', 'decisions', `${FIXTURE_DECISION}-fixture.md`), '## Decision\n\nA fixture record.\n'); return fixtureRootPath; } @@ -469,8 +337,9 @@ test.after(() => { function correction(overrides = {}) { return { file: 'core/closed.json', - pointer: '', - property: '*', + pointer: '/properties/id', + bound: 'minLength', + value: 1, release: '3.3.0', source: { ...FIXTURE_SOURCE }, reason: 'Closed against the rule.', @@ -482,12 +351,6 @@ function corrections(...entries) { return { decision: FIXTURE_DECISION, corrections: entries }; } -/** Opens core/closed.json and adds a property, the change a reopening allows. */ -function reopenAndAdd(t) { - t['core/closed.json'].additionalProperties = true; - t['core/closed.json'].properties.extra = { type: 'string' }; -} - function analyzePair(change, { correctionsValue, candidateVersion = '3.3.0-beta.0' } = {}) { const candidate = fixture(); change(candidate); @@ -496,47 +359,19 @@ function analyzePair(change, { correctionsValue, candidateVersion = '3.3.0-beta. baseTree: tree('3.2.7', fixture()), candTree: tree('source', candidate), candidateVersion, - earlierTrees: [], correctionsValue, repoRoot: fixtureRoot(), }); } -test('a listed reopening accepts additions from its release on', () => { - const result = analyzePair(reopenAndAdd, { correctionsValue: corrections(correction()) }); - assert.deepEqual([result.findings, result.errors], [[], []]); - assert.deepEqual(result.notices.map((n) => [n.detail, n.corrected]), [['additionalProperties false → true', true]]); -}); - -test('a listed reopening accepts no additions before its release', () => { - const result = analyzePair(reopenAndAdd, { correctionsValue: corrections(correction()), candidateVersion: '3.2.8' }); - assert.deepEqual(result.findings.map((f) => [f.kind, f.detail]), [['property-added-to-closed', 'property extra added']]); -}); - -test('a listed property correction accepts that property on a closed schema', () => { - const result = analyzePair( - (t) => { t['core/closed.json'].properties.extra = { type: 'string' }; }, - { correctionsValue: corrections(correction({ property: 'extra' })) }, - ); - assert.deepEqual([result.findings, result.notices, result.errors], [[], [], []]); -}); - -test('an addition next to a listed property correction still fails', () => { - const result = analyzePair( - (t) => { - t['core/closed.json'].properties.extra = { type: 'string' }; - t['core/closed.json'].properties.other = { type: 'string' }; - }, - { correctionsValue: corrections(correction({ property: 'extra' })) }, - ); - assert.deepEqual(result.findings.map((f) => [f.file, f.detail]), [['core/closed.json', 'property other added']]); - assert.deepEqual(result.errors, []); -}); - /** A bound correction entry: core/closed.json's id gains minLength 1. */ function boundCorrection(overrides = {}) { - const { property: _property, ...entry } = correction({ pointer: '/properties/id', bound: 'minLength', value: 1 }); - return { ...entry, ...overrides }; + return correction(overrides); +} + +/** Applies the tightening boundCorrection() lists. */ +function applyBound(t) { + t['core/closed.json'].properties.id.minLength = 1; } test('a listed bound correction accepts exactly that tightening', () => { @@ -574,14 +409,6 @@ test('fails when a bound correction is not applied in the candidate', () => { assert.deepEqual(result.errors, ['correction core/closed.json#/properties/id does not carry minLength: 1 in source']); }); -test('fails when a bound correction is missing from its decision record', () => { - const result = analyzePair( - (t) => { t['core/closed.json'].properties.id.maxLength = 64; }, - { correctionsValue: corrections(boundCorrection({ bound: 'maxLength', value: 64 })) }, - ); - assert.deepEqual(result.errors, [`correction core/closed.json#/properties/id maxLength: 64 is not in the correction tables of ${FIXTURE_DECISION}-fixture.md`]); -}); - /** Makes core/open.json require `note` through a new allOf entry, core/note-required.json. */ function requireNoteThroughAllOf(t) { t['core/note-required.json'] = { $id: '/schemas/core/note-required.json', type: 'object', required: ['note'] }; @@ -597,7 +424,7 @@ test('a name required through a new allOf entry is newly required', () => { /** A required correction entry: core/open.json newly requires note. */ function requiredCorrection(overrides = {}) { - const { property: _property, ...entry } = correction({ file: 'core/open.json', required: 'note' }); + const { bound: _bound, value: _value, ...entry } = correction({ file: 'core/open.json', pointer: '', required: 'note' }); return { ...entry, ...overrides }; } @@ -616,44 +443,6 @@ test('fails when a required correction is not applied in the candidate', () => { assert.deepEqual(result.errors, ['correction core/open.json# does not require note in source']); }); -test('an addition to a schema no correction names still fails', () => { - const result = analyzePair(reopenAndAdd, { - correctionsValue: corrections(correction({ file: 'core/explicit-open.json' })), - }); - assert.deepEqual(result.findings.map((f) => [f.file, f.detail]), [['core/closed.json', 'property extra added']]); -}); - -test('a listed reopening applies to a schema an earlier release closed', () => { - const result = analyzeWithEarlierClosure( - (t) => { t['core/explicit-open.json'].properties.extra = { type: 'string' }; }, - { correctionsValue: corrections(correction({ file: 'core/explicit-open.json' })) }, - ); - assert.deepEqual([result.findings, result.errors], [[], []]); -}); - -test('a listed reopening covers each oneOf branch it names', () => { - const result = analyzePair( - (t) => { - for (const branch of t['core/union.json'].oneOf) { - branch.additionalProperties = true; - branch.properties.extra = { type: 'string' }; - } - }, - { - correctionsValue: corrections( - correction({ file: 'core/union.json', pointer: '/oneOf/0' }), - correction({ file: 'core/union.json', pointer: '/oneOf/1' }), - ), - }, - ); - assert.deepEqual([result.findings, result.errors], [[], []]); -}); - -test('fails when a reopened schema is still closed in the candidate', () => { - const result = analyzePair(() => {}, { correctionsValue: corrections(correction()) }); - assert.deepEqual(result.errors, ['correction core/closed.json# reopens a schema that is still closed in source']); -}); - test('fails when a correction names a location that does not exist', () => { const result = analyzePair(() => {}, { correctionsValue: corrections(correction({ pointer: '/properties/missing' })), @@ -661,80 +450,68 @@ test('fails when a correction names a location that does not exist', () => { assert.deepEqual(result.errors, ['correction core/closed.json#/properties/missing does not exist in source']); }); -test('fails when a property correction is not declared in the candidate', () => { - const result = analyzePair(() => {}, { correctionsValue: corrections(correction({ property: 'extra' })) }); - assert.deepEqual(result.errors, ['correction core/closed.json# does not declare extra in source']); -}); - test('every correction needs a stable release', () => { - const result = analyzePair(reopenAndAdd, { correctionsValue: corrections(correction({ release: '3.3.0-beta.0' })) }); + const result = analyzePair(applyBound, { correctionsValue: corrections(correction({ release: '3.3.0-beta.0' })) }); assert.deepEqual(result.errors, ['corrections[0].release must be a stable release']); }); test('every correction needs a reason', () => { - const result = analyzePair(reopenAndAdd, { correctionsValue: corrections(correction({ reason: '' })) }); + const result = analyzePair(applyBound, { correctionsValue: corrections(correction({ reason: '' })) }); assert.deepEqual(result.errors, ['corrections[0].reason must not be empty']); }); -test('every correction names a property', () => { - const result = analyzePair(reopenAndAdd, { correctionsValue: corrections(correction({ property: undefined })) }); - assert.deepEqual(result.errors, ['corrections[0].property must be a string']); +test('every correction names exactly one of bound and required', () => { + for (const overrides of [{ bound: undefined, value: undefined }, { required: 'id' }]) { + const result = analyzePair(applyBound, { correctionsValue: corrections(correction(overrides)) }); + assert.ok(result.errors.includes('corrections[0] must name exactly one of bound and required'), result.errors.join('\n')); + } +}); + +test('a correction with a property is an error', () => { + const result = analyzePair(applyBound, { correctionsValue: corrections(correction({ property: 'extra' })) }); + assert.ok( + result.errors.includes('corrections[0] lets in a property; opening a schema or adding to an open one needs no correction (DR-0036)'), + result.errors.join('\n'), + ); }); test('every correction needs a source with a path and a quote', () => { - const result = analyzePair(reopenAndAdd, { + const result = analyzePair(applyBound, { correctionsValue: corrections(correction({ source: { path: FIXTURE_SOURCE.path } })), }); assert.deepEqual(result.errors, ['corrections[0].source must name a path and a quote']); }); test('fails when a correction source file does not exist', () => { - const result = analyzePair(reopenAndAdd, { + const result = analyzePair(applyBound, { correctionsValue: corrections(correction({ source: { ...FIXTURE_SOURCE, path: 'docs/missing.md' } })), }); assert.deepEqual(result.errors, ['corrections[0].source.path docs/missing.md does not exist']); }); test('fails when a correction source path names a directory', () => { - const result = analyzePair(reopenAndAdd, { + const result = analyzePair(applyBound, { correctionsValue: corrections(correction({ source: { ...FIXTURE_SOURCE, path: 'docs' } })), }); assert.deepEqual(result.errors, ['corrections[0].source.path docs does not exist']); }); test('fails when a correction source path leaves the repository', () => { - const result = analyzePair(reopenAndAdd, { + const result = analyzePair(applyBound, { correctionsValue: corrections(correction({ source: { ...FIXTURE_SOURCE, path: '../rule.md' } })), }); assert.deepEqual(result.errors, ['corrections[0].source.path ../rule.md does not exist']); }); test('fails when a correction quote is not in its source file', () => { - const result = analyzePair(reopenAndAdd, { + const result = analyzePair(applyBound, { correctionsValue: corrections(correction({ source: { ...FIXTURE_SOURCE, quote: 'Roots may close.' } })), }); assert.deepEqual(result.errors, [`corrections[0].source.quote is not in ${FIXTURE_SOURCE.path}`]); }); -test('fails when a correction is missing from its decision record', () => { - const result = analyzePair( - (t) => { t['core/explicit-open.json'].properties.extra = { type: 'string' }; }, - { correctionsValue: corrections(correction({ file: 'core/explicit-open.json', property: 'extra' })) }, - ); - assert.deepEqual(result.errors, [ - `correction core/explicit-open.json# extra is not in the correction tables of ${FIXTURE_DECISION}-fixture.md`, - ]); -}); - -test('a table outside the record\'s Corrections section does not record a correction', () => { - const result = analyzePair(() => {}, { correctionsValue: corrections(correction({ file: 'core/open.json' })) }); - assert.deepEqual(result.errors, [ - `correction core/open.json# * is not in the correction tables of ${FIXTURE_DECISION}-fixture.md`, - ]); -}); - test('fails when the corrections list names no existing decision record', () => { - const result = analyzePair(reopenAndAdd, { + const result = analyzePair(applyBound, { correctionsValue: { decision: 'DR-9002', corrections: [correction()] }, }); assert.deepEqual(result.errors, ['no decision record for DR-9002 under governance/decisions']); @@ -749,28 +526,11 @@ test('the repository corrections list is valid', () => { baseTree: sourceTree, candTree: sourceTree, candidateVersion: '9.9.9', - earlierTrees: [], correctionsValue: value, }); assert.deepEqual(result.errors, []); }); -test('the repository corrections list holds exactly the correction tables of DR-0036', () => { - const root = path.join(__dirname, '..'); - const value = JSON.parse(fs.readFileSync(path.join(root, 'scripts', 'lint-additive-minor-corrections.json'), 'utf8')); - const decisions = path.join(root, 'governance', 'decisions'); - const record = fs.readdirSync(decisions).find((name) => name.startsWith(`${value.decision}-`)); - const recorded = recordedCorrections(fs.readFileSync(path.join(decisions, record), 'utf8')); - assert.ok(recorded.size > 0, `${record} has no correction tables`); - // A bound correction is keyed by its bound (`minLength: 1`) and a required - // correction by its name (`required: status`), as their table rows name them. - const listed = value.corrections.map((entry) => `${entry.file}#${entry.pointer} ${ - typeof entry.bound === 'string' ? `${entry.bound}: ${entry.value}` - : typeof entry.required === 'string' ? `required: ${entry.required}` : entry.property}`); - assert.deepEqual(listed.filter((key) => !recorded.has(key)), [], 'listed but not in the tables'); - assert.deepEqual([...recorded].filter((key) => !listed.includes(key)), [], 'in the tables but not listed'); -}); - // --------------------------------------------------------------------------- // Additive changes pass // --------------------------------------------------------------------------- @@ -973,27 +733,6 @@ test('the baseline only shrinks against the target branch', () => { assert.deepEqual(grown.errors, [`baseline grew: ${findingKey({ ...VIOLATION_B, detail: 'property z newly required' })} is not in the target branch baseline`]); }); -test('a released finding may enter the baseline; an unreleased one may not', () => { - const released = { ...VIOLATION_A, detail: 'property x added (closed in 3.0.4)', released: true }; - const previousBaseline = { base: '3.2.7', entries: [] }; - const allowed = checkAgainstBaseline({ - base: '3.2.7', - findings: [released], - baselineValue: { base: '3.2.7', entries: [entry(released, 'shipped in 3.1.0')] }, - previousBaseline, - }); - assert.equal(allowed.ok, true, allowed.errors.join('\n')); - - const unreleased = { ...released, released: undefined }; - const rejected = checkAgainstBaseline({ - base: '3.2.7', - findings: [unreleased], - baselineValue: { base: '3.2.7', entries: [entry(unreleased, 'shipped in 3.1.0')] }, - previousBaseline, - }); - assert.deepEqual(rejected.errors, [`baseline grew: ${findingKey(unreleased)} is not in the target branch baseline`]); -}); - test('every baseline entry needs a reason', () => { const result = checkAgainstBaseline({ base: '3.2.7', diff --git a/tests/mcp-schema-analysis.test.cjs b/tests/mcp-schema-analysis.test.cjs index a577d41902a..6d6bd301a51 100644 --- a/tests/mcp-schema-analysis.test.cjs +++ b/tests/mcp-schema-analysis.test.cjs @@ -170,7 +170,10 @@ test("prompt argument adapter expands compact targeting requirements before vali strict: false, validateFormats: false, }).compile(canonicalSchema); - assert.equal(validator(compactArguments), false); + // The requirements container is open (a correction under DR-0036), so the + // compact form also validates, but only as unknown requirements, which + // match no product. The adapter turns it into the canonical dimensions. + assert.equal(validator(compactArguments), true, JSON.stringify(validator.errors)); assert.equal(validator(adapted), true, JSON.stringify(validator.errors)); }); diff --git a/tests/mcp-schema-projection.test.cjs b/tests/mcp-schema-projection.test.cjs index a296add80ce..395a2d90776 100644 --- a/tests/mcp-schema-projection.test.cjs +++ b/tests/mcp-schema-projection.test.cjs @@ -51,10 +51,19 @@ const STORYBOARD_DIR = path.join(REPO_ROOT, 'static', 'compliance', 'source'); const LATEST_DIR = path.join(REPO_ROOT, 'dist', 'schemas', 'latest'); const PROJECTION_DIR = path.join(LATEST_DIR, 'mcp', MCP_PROTOCOL_VERSION); const PRODUCTION_PROFILE_DIR = path.join(PROJECTION_DIR, 'profiles', 'production'); -// The canonical Product's `not`, as the projection serializes it. -const CANONICAL_PRODUCT_PROHIBITION = JSON.stringify({ - not: JSON.parse(fs.readFileSync(path.join(SOURCE_DIR, 'core', 'canonical-product.json'), 'utf8')).not, -}).slice(1, -1); +// A named rejection (`not: { required: [...] }`) forbids a legacy key without +// exposing it, and its schema description may name the key it rejects. Drops +// every `not` keyword and description string so a legacy-graph scan sees only +// what a schema accepts, whatever the rejection's shape or serialization. +function withoutNamedRejections(node, parentKey) { + if (Array.isArray(node)) return node.map((item) => withoutNamedRejections(item, parentKey)); + if (!node || typeof node !== 'object') return node; + return Object.fromEntries( + Object.entries(node) + .filter(([key, value]) => parentKey === 'properties' || !(key === 'not' || (key === 'description' && typeof value === 'string'))) + .map(([key, value]) => [key, withoutNamedRejections(value, key)]), + ); +} // The generated profiles describe the active surface of the package's release // line. Before the line's GA (x.y.0-rc.N) that is the x.y.0 surface the tool // manifest declares via added_in; once the line has a stable release it is the @@ -129,6 +138,8 @@ const ACTIVE_SURFACE_VERSION = semver.prerelease(PACKAGE_VERSION) // PRs each add a few hundred bytes to a few KiB (measured 465-467 KiB each on // top of main). Bound at 476 KiB once for the window; resume per-PR bounding // after the beta.1 cut. +// Named rejections (DR-0036) are validation, so the model-context view omits +// them with the bounds; the budget is unchanged. const MODEL_CONTEXT_BUDGET_KIB = { 'media-buy': 476, creative: 410, @@ -203,7 +214,16 @@ const MODEL_CONTEXT_BUDGET_KIB = { // Product.identity.match_keys: 1_375_833 → 1_383_804 bytes. Bound at 1_384_000. // image_carousel `card_image_sizes` (#8911) reaches the seeded Product's // format_options: 1_384_855 bytes. Bound at 1_385_000. -const PARITY_COMPILE_LIMIT = 1_385_000; +// Opening the 3.3 schemas and naming the fields closure used to reject (DR-0036) +// adds 395 bytes to the comply-test-controller-request closure +// (account-identity-change 30, attestation-reference 72, audience-source 113, +// collection 40, inventory-list-application 68, placement-selection 38, +// product-allowed-action 34): 1_383_804 → 1_384_081 bytes. Bound at 1_385_000. +// The later named rejections and their descriptions measure 1_385_027 bytes; +// bound at 1_386_000. +// With both on main (#8911 and the named rejections), the controller measures +// 1_386_397 bytes; bound at 1_387_000. +const PARITY_COMPILE_LIMIT = 1_387_000; function readJson(filename) { return JSON.parse(fs.readFileSync(filename, 'utf8')); @@ -422,6 +442,13 @@ test('model-context presentation keeps request shape and omits validation-only d assert.equal(projected.properties.extensions.additionalProperties, undefined); assert.equal(projected.properties.ext, undefined); assert.equal(projected.oneOf[1].not.required[0], 'mode'); + // A named rejection beside declared properties is validation-only. + const named = stripModelContextAnnotations({ + type: 'object', + properties: { a: { type: 'string' } }, + not: { anyOf: [{ required: ['b'] }, { required: ['c'] }] }, + }); + assert.equal(named.not, undefined); const negotiated = stripModelContextAnnotations({ type: 'object', @@ -1119,9 +1146,9 @@ test('generated MCP projection covers every tool within AdCP safety bounds', () if (['list_products', 'request_proposals', 'refine_proposals'].includes(toolName)) { assert.match(output, /Canonical Product/, `${toolName} output must use the canonical-only Product view`); - // The canonical Product forbids the legacy Product's keys by name; - // forbidding them does not expose them. - const exposed = output.replaceAll(CANONICAL_PRODUCT_PROHIBITION, ''); + // The canonical Product forbids the legacy Product's keys by name and + // says so in descriptions; forbidding them does not expose them. + const exposed = JSON.stringify(withoutNamedRejections(JSON.parse(output))); assert.doesNotMatch(exposed, /format_ids|format-id\.json|v1_format_ref|update_packages|"update_media_buy"/, `${toolName} output must not expose the legacy Product graph`); } diff --git a/tests/outcome-target.test.cjs b/tests/outcome-target.test.cjs index 938b1207527..86915e87352 100644 --- a/tests/outcome-target.test.cjs +++ b/tests/outcome-target.test.cjs @@ -127,13 +127,14 @@ describe('outcome_target reverse-forecast criteria', () => { ); }); - it('rejects non-positive volumes and unknown outcome_target fields', () => { + it('rejects non-positive volumes; an unknown outcome_target field validates', () => { const goal = { kind: 'metric', metric: 'clicks' }; assert.equal(validateCriteria({ outcome_target: { goal, volume: 0 } }), false); assert.equal(validateCriteria({ outcome_target: { goal, volume: -5 } }), false); + // Open by default (DR-0036): an unknown key (`currency`) beside `volume` validates. assert.equal( validateCriteria({ outcome_target: { goal, volume: 100, currency: 'USD' } }), - false, + true, ); }); @@ -220,12 +221,13 @@ describe('outcome_target reverse-forecast criteria', () => { assert.equal(forecastable.includes('store_visits_14d_exposed'), false); }); - it('keeps threshold_rate and per_ad_spend out of outcome_target', () => { + it('reserves threshold_rate and per_ad_spend for a later minor; they are currently ignored', () => { // Deferred past 3.3: planning semantics for threshold_rate are undecided // and per_ad_spend needs event-scoped value delivery does not carry. const goal = { kind: 'metric', metric: 'clicks' }; for (const field of ['threshold_rate', 'per_ad_spend']) { - assert.equal(validateCriteria({ outcome_target: { goal, volume: 10, [field]: { value: 0.5 } } }), false, field); + // Open by default (DR-0036): neither is declared, so each is an unknown key and validates. + assert.equal(validateCriteria({ outcome_target: { goal, volume: 10, [field]: { value: 0.5 } } }), true, field); } }); diff --git a/tests/reporting-status-contract.test.cjs b/tests/reporting-status-contract.test.cjs index d145259ad0d..46d64ca509a 100644 --- a/tests/reporting-status-contract.test.cjs +++ b/tests/reporting-status-contract.test.cjs @@ -954,7 +954,8 @@ describe('managed reporting status contract', () => { `the count stays optional for sellers that do not advertise consumer_status_task: ${JSON.stringify(validateResponse.errors)}`, ); response.obligation_counts.consumer_status_overdue = 4; - assert.equal(validateResponse(response), false, 'obligation_counts stays a closed object'); + // Open by default (DR-0036): an unknown count key validates. + assert.equal(validateResponse(response), true, 'obligation_counts accepts an unknown key'); assert.match( readSchema('/schemas/media-buy/get-reporting-status-response.json')['x-adcp-validation'].incremental_repair, /requires obligation_counts.consumer_status_pending on the summary view/, @@ -1411,7 +1412,8 @@ describe('managed reporting status contract', () => { /at most one statement for each logical chain/, ); const syncRequestSchema = readSchema('/schemas/media-buy/sync-reporting-status-request.json'); - assert.equal(syncRequestSchema.additionalProperties, false); + // Open by default (DR-0036). + assert.equal(syncRequestSchema.additionalProperties, true); assert.ok( (syncRequestSchema.allOf || []).some((arm) => arm.$ref === '/schemas/core/version-envelope.json'), 'closed request composes the version envelope via root allOf', diff --git a/tests/reporting-subscriptions.test.cjs b/tests/reporting-subscriptions.test.cjs index 02ae74f7b5f..71f1da46a34 100644 --- a/tests/reporting-subscriptions.test.cjs +++ b/tests/reporting-subscriptions.test.cjs @@ -146,7 +146,8 @@ test('lost authority is reported in the caller\'s own subscription state', () => assert.ok(state({ ...current, accounts_unauthorized: [revoked], accounts_unauthorized_count: 1 }), JSON.stringify(state.errors)); const { withheld_period_count: _w, ...noCount } = revoked; assert.equal(state({ ...current, accounts_unauthorized: [noCount], accounts_unauthorized_count: 1 }), false, 'withheld_period_count required'); - assert.equal(state({ ...current, accounts_unauthorized: [{ ...revoked, covered: [] }], accounts_unauthorized_count: 1 }), false, 'no current account data'); + // Open by default (DR-0036): `covered` is defined nowhere here, so it is an unknown key and validates. + assert.ok(state({ ...current, accounts_unauthorized: [{ ...revoked, covered: [] }], accounts_unauthorized_count: 1 }), 'covered is an ignored unknown key'); const caps = read('core/reporting-delivery-capabilities.json').properties.subscriptions.properties.backfill_on_regrant.description; assert.match(caps, /no gap is recorded/); assert.ok(state({ ...current, prior_versions: [{ subscription_version: 1, accepted_at: '2026-10-01T00:00:00Z', superseded_at: '2026-11-01T00:00:00Z' }], prior_versions_count: 1 }), JSON.stringify(state.errors)); @@ -192,8 +193,10 @@ test('coverage readback lists exceptions only, each with its interval', () => { ]; for (const doc of ok) assert.ok(v(doc), `${doc.status}: ${JSON.stringify(v.errors)}`); + // Open by default (DR-0036): `covered` is not declared (asserted above), so a positive listing is an ignored unknown key. + assert.ok(v({ ...coverageBase, status: 'active', covered: [] }), 'a positive covered listing is an ignored unknown key'); + const bad = [ - ['a positive covered listing', { ...coverageBase, status: 'active', covered: [] }], ['unauthorized is not an account status here', { ...coverageBase, status: 'unauthorized' }], ['an exception without from', { ...coverageBase, status: 'excluded', excluded: [{ reason: 'capacity' }] }], ['a gap without until', { ...coverageBase, status: 'active', gaps: [{ from, reason: 'unauthorized' }] }], @@ -980,7 +983,8 @@ test('destination_overrides items declare their fields at the top level, for cod assert.equal(item.type, 'object', file); assert.deepEqual(Object.keys(item.properties).sort(), ['account_ids', 'destination_id', 'operator_domains', 'path_template'], file); for (const keyword of ['anyOf', 'oneOf', 'allOf', 'not', '$ref']) assert.equal(item[keyword], undefined, `${file}: ${keyword} at the item level`); - assert.equal(item.additionalProperties, false, file); + // Open by default (DR-0036). + assert.equal(item.additionalProperties, true, file); } const vs = validate('/schemas/core/reporting-subscription.json'); const accept = [ @@ -995,8 +999,9 @@ test('destination_overrides items declare their fields at the top level, for cod [{ account_ids: ['a'], operator_domains: ['b.example'], destination_id: 'x' }, 'two selectors'], [{ account_ids: ['a', 'b'], destination_id: 'x', path_template: 'flat' }, 'several accounts, not partitioned'], [{ operator_domains: ['b.example'], destination_id: 'x', path_template: 'flat' }, 'operator, not partitioned'], - [{ account_ids: ['a'], destination_id: 'x', extra: true }, 'unknown field'], ]; + // Open by default (DR-0036): an unknown key on an override validates. + accept.push([{ account_ids: ['a'], destination_id: 'x', extra: true }, 'unknown field']); for (const [override, label] of accept) assert.ok(vs({ ...allAccounts, destination_overrides: [override] }), `${label}: ${JSON.stringify(vs.errors)}`); for (const [override, label] of reject) assert.equal(vs({ ...allAccounts, destination_overrides: [override] }), false, label); }); diff --git a/tests/sdk-implementation-metadata.test.cjs b/tests/sdk-implementation-metadata.test.cjs index 6164625c003..451e092b406 100644 --- a/tests/sdk-implementation-metadata.test.cjs +++ b/tests/sdk-implementation-metadata.test.cjs @@ -107,8 +107,12 @@ test('malformed, duplicate, and approval-bearing reports are rejected', () => { { sdks: [sdk(), sdk()] }, { sdks: [], approved: true }, { sdks: [sdk({ approved: true })] }, - { sdks: [sdk({ verified: true })] }, ]) { assert.equal(validate(capabilities(implementation)), false, JSON.stringify(implementation)); } }); + +test('an unknown verified key on an SDK entry validates', () => { + // Open by default (DR-0036): `verified` is defined nowhere, so it is an unknown key; `approved` stays rejected. + assert.equal(validate(capabilities({ sdks: [sdk({ verified: true })] })), true); +}); diff --git a/tests/seller-governance-policy-surfaces.test.cjs b/tests/seller-governance-policy-surfaces.test.cjs index e02e79162dc..908cc36e648 100644 --- a/tests/seller-governance-policy-surfaces.test.cjs +++ b/tests/seller-governance-policy-surfaces.test.cjs @@ -174,7 +174,8 @@ test('acceptance context uses registry category facets instead of a political bo delivery_jurisdictions: ['DE'], }), true, JSON.stringify(validate.errors)); - assert.equal(validate({ political: true }), false); + // Open by default (DR-0036): `political` is an unknown key and validates. + assert.equal(validate({ political: true }), true); }); test('storyboard fixtures cannot invent acceptance-policy facets', () => { diff --git a/tests/service-commitments.test.cjs b/tests/service-commitments.test.cjs index 39a3ed3af25..1e406ec073e 100644 --- a/tests/service-commitments.test.cjs +++ b/tests/service-commitments.test.cjs @@ -222,8 +222,11 @@ test('issue receipts omit revision and duplicated commitment metadata', async () accepts(validate, { ...issue, severity: 'warning' }); for (const fields of [ { revision: 1 }, { sla: escalation }, - { response_due_at: issue.received_at }, { completion_due_at: issue.received_at }, ]) rejects(validate, { ...issue, ...fields }); + // Open by default (DR-0036): response_due_at and completion_due_at are declared nowhere, so they validate. + for (const fields of [{ response_due_at: issue.received_at }, { completion_due_at: issue.received_at }]) { + accepts(validate, { ...issue, ...fields }); + } }); test('report and polling responses separate stored snapshots from task errors', async () => { diff --git a/tests/spot-delivery-reporting-contract.test.cjs b/tests/spot-delivery-reporting-contract.test.cjs index 77f82051640..2cb4abf41e6 100644 --- a/tests/spot-delivery-reporting-contract.test.cjs +++ b/tests/spot-delivery-reporting-contract.test.cjs @@ -371,7 +371,8 @@ describe("spot lifecycle, makegood linkage and break position (experimental, 3.3 JSON.stringify(validateCapabilities.errors) ); assert.equal(validateCapabilities({ ...base, available_statuses: ["bumped"] }), false); - assert.equal(validateCapabilities({ ...base, unknown_field: true }), false, "closed object"); + // A capability block stays open (a correction under DR-0036). + assert.equal(validateCapabilities({ ...base, unknown_field: true }), true, "open capability block"); const capSchema = readSchema("/schemas/core/spot-reporting-capability.json"); for (const name of ["available_statuses", "supports_break_position"]) { assert.equal(capSchema.properties[name]["x-status"], "experimental", name); diff --git a/tests/sync-plans-reserved-names.test.cjs b/tests/sync-plans-reserved-names.test.cjs new file mode 100644 index 00000000000..b20db1351e4 --- /dev/null +++ b/tests/sync-plans-reserved-names.test.cjs @@ -0,0 +1,69 @@ +const assert = require('node:assert/strict'); +const test = require('node:test'); +const Ajv = require('ajv'); +const addFormats = require('ajv-formats'); +const { ensureBuiltSchemas, readBuiltSchema } = require('../scripts/built-schemas.cjs'); + +ensureBuiltSchemas(); + +const readSchema = (relativePath) => readBuiltSchema(`/schemas/${relativePath}`); + +async function compile() { + const ajv = new Ajv({ + allErrors: true, + strict: false, + discriminator: true, + loadSchema: async (uri) => readSchema(uri.replace('/schemas/', '')), + }); + addFormats(ajv); + return ajv.compileAsync(readSchema('governance/sync-plans-request.json')); +} + +const errors = (validate) => JSON.stringify(validate.errors, null, 2); + +// Names reserved for the governance agent's persisted plan state and excluded +// from the plan_hash preimage (docs/governance/campaign/specification.mdx). +const RESERVED = { + version: 3, + status: 'active', + syncedAt: '2026-04-19T12:00:00Z', + revisionHistory: [], + committedBudget: 100, + committedByType: {}, +}; + +const request = (planFields = {}) => ({ + idempotency_key: 'reserved-names-plan-1', + plans: [{ + plan_id: 'reserved_names_campaign', + brand: { domain: 'acme.example' }, + objectives: 'Reach a broad audience.', + budget: { total: 1000, currency: 'USD', reallocation_threshold: 0 }, + flight: { start: '2026-10-01T00:00:00Z', end: '2026-11-01T00:00:00Z' }, + ...planFields, + }], +}); + +test('a plan without reserved names validates, and an unknown key on it validates', async () => { + const validate = await compile(); + assert.equal(validate(request()), true, errors(validate)); + // Open by default (WG decision of 2026-11-09, DR-0036): an unknown key validates. + assert.equal(validate(request({ buyer_note: 'x' })), true, errors(validate)); +}); + +for (const [name, value] of Object.entries(RESERVED)) { + test(`a plan that sends the reserved name ${name} is rejected by the plan's not keyword`, async () => { + const validate = await compile(); + assert.equal(validate(request({ [name]: value })), false, name); + assert.ok( + validate.errors.some((error) => error.keyword === 'not' && error.schemaPath.includes('/plans/items/not')), + `${name}: ${errors(validate)}`, + ); + }); +} + +test('the plan item description names every reserved name and forbids sending them', () => { + const { description } = readSchema('governance/sync-plans-request.json').properties.plans.items; + for (const name of Object.keys(RESERVED)) assert.ok(description.includes(`\`${name}\``), name); + assert.match(description, /MUST NOT send them/); +}); diff --git a/tests/targeting-aware-discovery.test.cjs b/tests/targeting-aware-discovery.test.cjs index 825e90dae1d..1ad88f7fdba 100644 --- a/tests/targeting-aware-discovery.test.cjs +++ b/tests/targeting-aware-discovery.test.cjs @@ -271,8 +271,9 @@ test("frequency cap detail preserves the legacy boolean and separates aggregate validateConstraints({ max_impressions_constraints: { minimum: 1, maximum: 10, step: 2 }, }), - false, - "count ranges have no step" + // Open by default (DR-0036): `step` is defined nowhere, so it is an unknown key and validates. + true, + "count ranges declare no step; it is an ignored unknown key" ); const requirementsSchema = JSON.parse( @@ -654,13 +655,15 @@ test("product responses expose symmetric property and collection list applicatio ); assert.equal( validateReceipt({ ...collectionReceipt, mode: "exclude" }), - false, - "effect is the only application discriminator" + // Open by default (DR-0036): `mode` is defined nowhere, so it is an unknown key and validates. + true, + "effect is the only declared application discriminator; mode is ignored" ); assert.equal( validateReceipt({ ...collectionReceipt, entries_total: 200 }), - false, - "counts are represented only by the closed summary partition" + // Open by default (DR-0036): `entries_total` is an unknown key and validates. + true, + "counts are declared only by the summary partition; entries_total is ignored" ); assert.equal( validateCanonicalProduct({ @@ -2008,9 +2011,19 @@ test("required overlay requirements exclude seller limit fields", async () => { false, "seller maxima are response-only" ); + // The requirements container is open (a correction under DR-0036). An unknown + // hard requirement still isn't ignored: matching fails closed on it. The + // functional case is in server/tests/unit/training-agent.test.ts. assert.equal( validate({ future_unknown_dimension: true }), - false, + true, + errors(validate) + ); + assert.match( + JSON.parse( + fs.readFileSync(path.join(SCHEMA_ROOT, "core", "targeting-overlay-requirements.json"), "utf8") + ).description, + /Missing or unknown required fields do not match\./, "unknown hard requirements must not be ignored" ); for (const zeroCapability of [ @@ -2078,7 +2091,6 @@ test("required overlay requirements exclude seller limit fields", async () => { { geo_countries: {} }, { geo_countries: { ext: { vendor: "hint" } } }, { geo_countries: { max_values_per_package: 0 } }, - { geo_countries: { max_values_per_package: 1, unknown: true } }, { geo_proximity: { radius: true, max_values_per_package: 0 } }, { geo_proximity: { max_values_per_package: 1 } }, ]) { @@ -2091,6 +2103,13 @@ test("required overlay requirements exclude seller limit fields", async () => { ); } + // Open by default (DR-0036): an unknown key beside a valid seller maximum validates. + assert.equal( + validateSupport({ geo_countries: { max_values_per_package: 1, unknown: true } }), + true, + errors(validateSupport) + ); + const requirements = JSON.parse( fs.readFileSync( path.join(SCHEMA_ROOT, "core", "targeting-overlay-requirements.json"), @@ -2110,6 +2129,36 @@ test("required overlay requirements exclude seller limit fields", async () => { } }); +test("boolean demographics is the deprecated 3.2 shorthand for { age: true }", async () => { + for (const name of ["targeting-overlay-support", "targeting-overlay-requirements"]) { + const uri = `/schemas/core/${name}.json`; + const validate = await compile(uri); + for (const demographics of [true, { age: true }, { gender: true }, { age: true, gender: true }]) { + assert.equal( + validate({ demographics }), + true, + `${name} accepts demographics ${JSON.stringify(demographics)}: ${errors(validate)}` + ); + } + assert.equal(validate({ demographics: false }), false, `${name} rejects demographics false`); + + const source = JSON.parse( + fs.readFileSync(path.join(SCHEMA_ROOT, "core", `${name}.json`), "utf8") + ); + for (const schema of [source, readBuiltSchema(uri)]) { + const [booleanBranch, objectBranch] = schema.properties.demographics.anyOf; + assert.equal(booleanBranch.deprecated, true, `${name} marks the boolean branch deprecated`); + assert.equal(booleanBranch["x-deprecated-in"], "3.3.0"); + assert.equal(booleanBranch["x-removed-in"], "4.0.0"); + assert.match(booleanBranch.description, /^Deprecated in 3\.3\./); + assert.match(booleanBranch.description, /The 3\.2 shorthand for \{ age: true \}\./); + assert.match(booleanBranch.description, /Senders MUST send the object; receivers MUST accept true\./); + assert.equal(objectBranch.type, "object"); + assert.equal(objectBranch.deprecated, undefined, `${name} keeps the object branch current`); + } + } +}); + test("product identity and forecast semantics distinguish wholesale from custom offers", () => { const product = JSON.parse( fs.readFileSync(path.join(SCHEMA_ROOT, "core", "product.json"), "utf8") diff --git a/tests/trusted-match-context-merge.test.cjs b/tests/trusted-match-context-merge.test.cjs index cf839e1bab6..aebda8adea7 100644 --- a/tests/trusted-match-context-merge.test.cjs +++ b/tests/trusted-match-context-merge.test.cjs @@ -174,13 +174,18 @@ describe('Trusted Match Context targeting merge vectors', () => { { targeting_kv_mapping: { provider_a: {} } }, { targeting_kv_mapping: { provider_a: { key: '' } } }, {}, - { targeting_kv_mapping: {}, unexpected: true }, ]; for (const config of invalidConfigs) { assert.equal(validatePublisherConfig(config), false, `${JSON.stringify(config)} unexpectedly validated`); } }); + it('accepts an unknown key on the publisher targeting config', () => { + // Open by default (WG decision of 2026-11-09, DR-0036): an unknown key validates. + const config = { targeting_kv_mapping: {}, unexpected: true }; + assert.equal(validatePublisherConfig(config), true, JSON.stringify(validatePublisherConfig.errors)); + }); + it('rejects invalid merged response shapes', () => { for (const vector of fixture.invalid_router_responses) { assert.equal(validateRouterResponse(vector.response), false, `${vector.id} unexpectedly validated`); diff --git a/tests/withdrawn-to-4-0.test.cjs b/tests/withdrawn-to-4-0.test.cjs index a4803cabe1f..54dd5b4b7cf 100644 --- a/tests/withdrawn-to-4-0.test.cjs +++ b/tests/withdrawn-to-4-0.test.cjs @@ -1,13 +1,12 @@ /** * Contract test for the 3.3 features withdrawn to 4.0 (adcp#8501). * - * commercial-terms is closed on purpose: a buyer must not be bound by terms it - * cannot read, and terms_digest signs exactly those terms. A minor release - * never changes a closed schema (DR-0036), so definition pins, purchase rights - * and installment selection wait for 4.0, where commercial_terms gets a - * declared extension point with must-understand. This test fails if any of - * them returns to a 3.x schema, and checks that the release story and the 4.0 - * registry say where the designs went. + * commercial-terms and the term objects inside it are held closed until 4.0 + * (DR-0036), so definition pins, purchase rights and installment selection + * wait for 4.0, where commercial_terms gets a declared extension point with + * must-understand. This test fails if any of them returns to a 3.x schema, + * and checks that the release story and the 4.0 registry say where the + * designs went. */ 'use strict';