From 5f47ccae45e4f81a19da71a134ae008091ecace8 Mon Sep 17 00:00:00 2001 From: Brian O'Kelley Date: Tue, 17 Nov 2026 05:50:16 +0000 Subject: [PATCH] chore(deps): bump @adcp/sdk to 17.0.0-beta.29 and move the test-agent preview to 3.3-rc.0 @adcp/sdk 17.0.0-beta.29 pins AdCP 3.3.0-rc.0, and Python adcp 10.0.0b20 adopts the same bundle. tests/sdk-runtime-compat ties Choose your SDK and the training agent to the installed SDK, so bump it, and move TRAINING_AGENT_HOSTED_PREVIEW to { wireVersion: '3.3-rc.0', bundle: '3.3.0-rc.0' }, the prerelease beta.29 negotiates. The preview-version and tenant-smoke tests follow, with 3.3-beta.6 as the previous preview. Docs, replacing the forward-looking rc.0 text from #8883: - Choose your SDK names 17.0.0-beta.29 and 10.0.0b20, both on 3.3.0-rc.0. - The prerelease page: 17.0.0-beta.24 to beta.28 and 10.0.0b17 to b19 support beta.6 (b19's wheel bundles 3.3.0-beta.6), beta.29 and b20 support rc.0, and the test-agent preview serves 3.3-rc.0. It also says what the agent refuses: installment_refs (#8986), and the assignment operations each route lists (#8997). - The release notes, Versions, the quickstart, and the creative33 sandbox note name the new versions and pin. Co-Authored-By: Claude Opus 5.5 --- .changeset/rc0-sdk-and-test-agent-preview.md | 5 +++++ docs/building/by-layer/L4/choose-your-sdk.mdx | 12 +++++------ docs/contributing/creative33-sandbox.md | 4 ++-- docs/quickstart.mdx | 2 +- docs/reference/3-3-beta.mdx | 20 ++++++++++--------- docs/reference/release-notes.mdx | 4 ++-- docs/reference/versions.mdx | 6 +++--- package-lock.json | 8 ++++---- package.json | 2 +- scripts/sdk-response-conformance/README.md | 2 +- .../known-findings.json | 2 +- .../src/training-agent/candidate-version.ts | 10 +++++----- .../tenants/tenant-smoke.test.ts | 4 ++-- .../training-agent-preview-version.test.ts | 20 +++++++++---------- 14 files changed, 54 insertions(+), 47 deletions(-) create mode 100644 .changeset/rc0-sdk-and-test-agent-preview.md diff --git a/.changeset/rc0-sdk-and-test-agent-preview.md b/.changeset/rc0-sdk-and-test-agent-preview.md new file mode 100644 index 0000000000..acaee304a6 --- /dev/null +++ b/.changeset/rc0-sdk-and-test-agent-preview.md @@ -0,0 +1,5 @@ +--- +"adcontextprotocol": patch +--- + +Docs: `@adcp/sdk` 17.0.0-beta.29 and Python `adcp` 10.0.0b20 bundle `3.3.0-rc.0`, and the public test agent's opt-in 3.3 preview moves to `3.3-rc.0`. Choose your SDK, the 3.3 prerelease page, the release notes, Versions, and the quickstart name the new versions and pin. `@adcp/sdk` 17.0.0-beta.24 through 17.0.0-beta.28 and Python `adcp` 10.0.0b17 through 10.0.0b19 support beta.6. The training agent's hosted preview is `3.3-rc.0`, validated against the published `3.3.0-rc.0` schemas. diff --git a/docs/building/by-layer/L4/choose-your-sdk.mdx b/docs/building/by-layer/L4/choose-your-sdk.mdx index fcff1d6e6c..88aabe1be2 100644 --- a/docs/building/by-layer/L4/choose-your-sdk.mdx +++ b/docs/building/by-layer/L4/choose-your-sdk.mdx @@ -43,18 +43,18 @@ Production stays on the 3.2 line and the packages above. For development and sta | SDK | Package | AdCP bundle | Roles and transports | Known limits | |---|---|---|---|---| -| **`@adcp/sdk`** (TypeScript) | `17.0.0-beta.28` (npm `beta` dist-tag) | Signed `3.3.0-beta.6`; also bundles stable 3.2.8, 3.1.31 and 3.0.25. Earlier 3.3 betas require a matching external schema root | Buyer client and seller server, MCP and A2A | Identity and Web Bot Auth (`@adcp/sdk/identity-3.3`) remain experimental opt-ins. Use a Reliable Reporting storage release whose `@adcp/sdk` peer range matches this SDK. | -| **`adcp`** (Python) | `10.0.0b17` (PyPI prerelease) | Signed `3.3.0-beta.6` | Buyer client and seller server, MCP and A2A | Negotiates only `3.3-beta.6`. Install the exact prerelease with `pip install --pre "adcp==10.0.0b17"`; for Reliable Reporting storage, use an `adcp-reporting-storage` prerelease whose `adcp` requirement matches this SDK. | +| **`@adcp/sdk`** (TypeScript) | `17.0.0-beta.29` (npm `beta` dist-tag) | Signed `3.3.0-rc.0`; also bundles stable 3.2.8, 3.1.31 and 3.0.25. Earlier 3.3 betas require a matching external schema root | Buyer client and seller server, MCP and A2A | Identity and Web Bot Auth (`@adcp/sdk/identity-3.3`) remain experimental opt-ins. Use a Reliable Reporting storage release whose `@adcp/sdk` peer range matches this SDK. | +| **`adcp`** (Python) | `10.0.0b20` (PyPI prerelease) | Signed `3.3.0-rc.0` | Buyer client and seller server, MCP and A2A | Negotiates only `3.3-rc.0`. Install the exact prerelease with `pip install --pre "adcp==10.0.0b20"`; for Reliable Reporting storage, use an `adcp-reporting-storage` prerelease whose `adcp` requirement matches this SDK. | | Go, Java | — | No 3.3 prerelease | — | Not supported for 3.3. Test from these languages through raw-wire calls against the signed bundle. | -SDK prereleases that adopt `3.3.0-rc.0` follow within days of the cut, and this table gains their rows when they publish. Until a row names rc.0, test rc.0 from its signed bundle and keep SDK-backed testing on beta.6. +`@adcp/sdk` 17.0.0-beta.29 and Python `adcp` 10.0.0b20 bundle `3.3.0-rc.0`. Each negotiates only its own prerelease, so a buyer on rc.0 and a seller on beta.6 settle on a stable release. ```bash -npm install @adcp/sdk@17.0.0-beta.28 -node -p "require('@adcp/sdk').ADCP_VERSION" # 3.3.0-beta.6 +npm install @adcp/sdk@17.0.0-beta.29 +node -p "require('@adcp/sdk').ADCP_VERSION" # 3.3.0-rc.0 ``` -This `@adcp/sdk` prerelease negotiates only the `3.3-beta.6` preview. A peer still on `3.3-beta.5` settles on a shared stable release instead, so upgrade both sides together to keep exercising 3.3 preview features. +This `@adcp/sdk` prerelease negotiates only the `3.3-rc.0` preview. A peer still on `3.3-beta.6` settles on a shared stable release instead, so upgrade both sides together to keep exercising 3.3 preview features. SDK 17 is a major release. Before upgrading from 16, read the [16 to 17 migration guide](https://github.com/adcontextprotocol/adcp-client/blob/main/docs/migration-16-to-17.md). It changes the HTML-markup legacy formats (`display_html`, `display_WxH_html`) from `html5` to `display_tag` with inline-markup delivery ([#8339](https://github.com/adcontextprotocol/adcp/issues/8339)). It also fails closed on unresolved account references on 3.3 routes. A 3.3 seller must advertise the exact beta it serves in `supported_versions` before an SDK 17 buyer sends that pin. diff --git a/docs/contributing/creative33-sandbox.md b/docs/contributing/creative33-sandbox.md index 8b116d3fa3..ad8e3f3125 100644 --- a/docs/contributing/creative33-sandbox.md +++ b/docs/contributing/creative33-sandbox.md @@ -7,8 +7,8 @@ description: "Exercise AdCP 3.3 beta creative workflows with the published SDK, # Creative 3.3 beta sandbox This development lab serves the frozen AdCP `3.3.0-beta.1` contract using the -published TypeScript SDK `17.0.0-beta.28`. The server registers the retained -beta.1 schemas; SDK 17 beta.28's bundled preview is beta.6, so a client validating this +published TypeScript SDK `17.0.0-beta.29`. The server registers the retained +beta.1 schemas; SDK 17 beta.29's bundled preview is rc.0, so a client validating this frozen lab needs the matching beta.1 schema root. Its MCP endpoint is: `https://test-agent.adcontextprotocol.org/beta/3.3/creative/mcp` diff --git a/docs/quickstart.mdx b/docs/quickstart.mdx index 62d77bf405..b1409e884f 100644 --- a/docs/quickstart.mdx +++ b/docs/quickstart.mdx @@ -26,7 +26,7 @@ export AGENT_URL="https://test-agent.adcontextprotocol.org/sales/mcp" The test agent is path-routed: `/sales/mcp` serves media-buy tools (this quickstart's path), and sibling URLs serve the other specialisms — `/signals/mcp`, `/governance/mcp`, `/creative/mcp`, `/creative-builder/mcp`, `/brand/mcp`. Hit [`/.well-known/adagents.json`](https://test-agent.adcontextprotocol.org/.well-known/adagents.json) for the full tenant + tool list. -The test agent serves AdCP 3.2, 3.1, and 3.0. It also serves the 3.3 beta as an experimental preview, but only to requests that pin `adcp_version: "3.3-beta.6"` exactly. See [Try the preview on the public test agent](/docs/reference/3-3-beta#try-the-preview-on-the-public-test-agent). +The test agent serves AdCP 3.2, 3.1, and 3.0. It also serves the 3.3 release candidate as an experimental preview, but only to requests that pin `adcp_version: "3.3-rc.0"` exactly. See [Try the preview on the public test agent](/docs/reference/3-3-beta#try-the-preview-on-the-public-test-agent). For your own API key (org-scoped, usage tracking), create one at the [AAO dashboard](https://agenticadvertising.org/dashboard/api-keys). diff --git a/docs/reference/3-3-beta.mdx b/docs/reference/3-3-beta.mdx index 8e412da32e..c5fd583add 100644 --- a/docs/reference/3-3-beta.mdx +++ b/docs/reference/3-3-beta.mdx @@ -32,7 +32,7 @@ GA follows the first release candidate that meets every one of the GA criteria i Beta.0 did not wait for the SDKs. A checkpoint is SDK-backed only after the matching SDK versions and integration evidence are published. `@adcp/sdk` 17.0.0-beta.11 is the first published SDK that bundles beta.3 ([SDK guidance](#sdk-guidance)). Three features that shipped in the betas are [withdrawn after beta.1](#withdrawn-after-beta-1), and the [closed-schema triage](#closed-schema-triage-before-rc-0) removes further beta fields before rc.0. -`@adcp/sdk` 17.0.0-beta.18 through 17.0.0-beta.20 and Python `adcp` 10.0.0b12 support beta.4. `@adcp/sdk` 17.0.0-beta.21 through 17.0.0-beta.23 and Python `adcp` 10.0.0b13 through 10.0.0b16 support beta.5. `@adcp/sdk` 17.0.0-beta.24 and later and Python `adcp` 10.0.0b17 and later support beta.6. No published SDK supports rc.0 yet: rc.0 is SDK-backed once new SDK prereleases bundle it ([SDK guidance](#sdk-guidance)). +`@adcp/sdk` 17.0.0-beta.18 through 17.0.0-beta.20 and Python `adcp` 10.0.0b12 support beta.4. `@adcp/sdk` 17.0.0-beta.21 through 17.0.0-beta.23 and Python `adcp` 10.0.0b13 through 10.0.0b16 support beta.5. `@adcp/sdk` 17.0.0-beta.24 through 17.0.0-beta.28 and Python `adcp` 10.0.0b17 through 10.0.0b19 support beta.6. `@adcp/sdk` 17.0.0-beta.29 and Python `adcp` 10.0.0b20 support rc.0, so rc.0 is SDK-backed ([SDK guidance](#sdk-guidance)). ## Know which version string to use @@ -78,13 +78,13 @@ Useful tests are: ## Try the preview on the public test agent -The public test agent at `https://test-agent.adcontextprotocol.org` serves `3.3.0-beta.6` as an opt-in preview alongside its stable releases. The preview moves to rc.0 once an `@adcp/sdk` prerelease that negotiates rc.0 publishes, which is expected within days of the cut; until then, this section describes the beta.6 preview. It lists `"3.3-beta.6"` in `adcp.supported_versions` and serves the preview only to a request that pins exactly that value: +The public test agent at `https://test-agent.adcontextprotocol.org` serves `3.3.0-rc.0` as an opt-in preview alongside its stable releases. It lists `"3.3-rc.0"` in `adcp.supported_versions` and serves the preview only to a request that pins exactly that value: | Request | Served | |---|---| -| `adcp_version: "3.3-beta.6"` | The preview. Responses echo `"3.3-beta.6"` and validate against the published `3.3.0-beta.6` schemas. | +| `adcp_version: "3.3-rc.0"` | The preview. Responses echo `"3.3-rc.0"` and validate against the published `3.3.0-rc.0` schemas. | | `adcp_version: "3.2"`, `"3.3"`, or a later release | 3.2. A release pin never resolves onto a prerelease. | -| Any other 3.3 prerelease, such as `"3.3-rc.0"` or the earlier preview `"3.3-beta.5"` | Never the preview. Prerelease pins match exactly. | +| Any other 3.3 prerelease, such as `"3.3-rc.1"` or the earlier preview `"3.3-beta.6"` | Never the preview. Prerelease pins match exactly. | | `adcp_major_version` alone, or no version | The route's stable default, never the preview. | ```bash @@ -92,7 +92,7 @@ curl -s https://test-agent.adcontextprotocol.org/sales/mcp \ -H "Authorization: Bearer $ADCP_AUTH_TOKEN" \ -H 'Content-Type: application/json' \ -H 'Accept: application/json, text/event-stream' \ - -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_adcp_capabilities","arguments":{"adcp_version":"3.3-beta.6"}}}' + -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_adcp_capabilities","arguments":{"adcp_version":"3.3-rc.0"}}}' ``` At the preview pin, `/sales/mcp` serves the experimental 3.3 surfaces the training agent implements: @@ -106,6 +106,8 @@ At the preview pin, `/sales/mcp` serves the experimental 3.3 surfaces the traini - the `seed_collection` controller scenario, which changes the caller's cards (a sample, a removal, a follower sweep) so the card webhooks fire; - inventory holds ([Hold policy](/docs/media-buy/task-reference/refine_proposals#hold-policy-experimental)): `hold_policy` on products and drafts (`media_buy.hold_policy`), committed proposals with `hold_placed_at`, ranked holds with `hold_rank` (`media_buy.hold_ranking`), per-installment `holds` (`media_buy.installment_holds`), `extend_hold` (`media_buy.hold_extension`), and the `force_hold_unavailable` controller scenario. +The agent does not implement `media_buy.installment_refinement` or `media_buy.installment_creative_assignment`. It refuses `installment_refs` on any assignment operation with `UNSUPPORTED_FEATURE` ([#8986](https://github.com/adcontextprotocol/adcp/pull/8986)), as a seller without the feature must. `creative.assignment_operations` lists `assign`, `unassign`, and `replace` on `/sales` and `/mcp`; the creative-only routes list none and refuse every operation ([#8997](https://github.com/adcontextprotocol/adcp/pull/8997)). + At the same pin, `/brand/mcp` returns `collections` on `get_brand_identity` for the creators (`brand.collection_links`). Holds are kept per caller and timed by the caller's sandbox clock, so two accounts that hold the same slot are queued at positions 1 and 2. These products carry hold policies: @@ -122,7 +124,7 @@ Other products take the default: a hold that never contends. `tools/list` includes `request_account` and `list_collections` only when the listing is pinned to the preview (`params._meta.adcp_version`, as `@adcp/sdk` sends it). -With `@adcp/sdk`, use 17.0.0-beta.24 or later, which negotiates exactly `3.3-beta.6`; with Python, use `adcp` 10.0.0b17 or later. Earlier 17.0.0 betas negotiate an older beta, so they settle on 3.2 with the test agent. +With `@adcp/sdk`, use 17.0.0-beta.29 or later, which negotiates exactly `3.3-rc.0`; with Python, use `adcp` 10.0.0b20 or later. Earlier 17.0.0 betas negotiate an older beta, so they settle on 3.2 with the test agent. **The preview is experimental and can change without notice.** It follows the 3.3 prerelease that the current `@adcp/sdk` prerelease negotiates, so it can trail the latest published checkpoint, and it moves when the SDK does. Once it moves, the old pin is no longer served. AAO can also switch the preview off, after which the agent serves only its stable releases. Use it to try 3.3 surfaces, not as a stable integration target. @@ -148,11 +150,11 @@ SDK maintainers should report protocol ambiguities against the [AdCP repository] ## SDK guidance -**rc.0.** TypeScript and Python prereleases that adopt `3.3.0-rc.0` follow within days of the cut; see [Choose your SDK](/docs/building/by-layer/L4/choose-your-sdk). GA needs SDK support for the latest release candidate. Until a row there names rc.0, test rc.0 from its signed bundle and keep SDK-backed testing on beta.6. +**rc.0.** `@adcp/sdk` 17.0.0-beta.29 and Python `adcp` 10.0.0b20 bundle `3.3.0-rc.0` ([Choose your SDK](/docs/building/by-layer/L4/choose-your-sdk)). GA needs SDK support for the latest release candidate. -**TypeScript.** Use `@adcp/sdk` **17.0.0-beta.6 or later** (npm `beta` dist-tag) to test 3.3. The published prereleases bundle a signed AdCP release: 17.0.0-beta.6 bundles `3.3.0-beta.1`, 17.0.0-beta.10 bundles `3.3.0-beta.2`, 17.0.0-beta.11 through 17.0.0-beta.17 bundle `3.3.0-beta.3`, 17.0.0-beta.18 through 17.0.0-beta.20 bundle `3.3.0-beta.4`, 17.0.0-beta.21 through 17.0.0-beta.23 bundle `3.3.0-beta.5`, and 17.0.0-beta.24 and later bundle `3.3.0-beta.6`. Each negotiates only its own prerelease, so a buyer and seller on different checkpoints settle on a stable release. Pin the exact SDK version, and send a prerelease `adcp_version` only to a peer that advertises that exact pin. `@adcp/sdk` 17 is a major release; read its [16 to 17 migration guide](https://github.com/adcontextprotocol/adcp-client/blob/main/docs/migration-16-to-17.md) first. +**TypeScript.** Use `@adcp/sdk` **17.0.0-beta.6 or later** (npm `beta` dist-tag) to test 3.3. The published prereleases bundle a signed AdCP release: 17.0.0-beta.6 bundles `3.3.0-beta.1`, 17.0.0-beta.10 bundles `3.3.0-beta.2`, 17.0.0-beta.11 through 17.0.0-beta.17 bundle `3.3.0-beta.3`, 17.0.0-beta.18 through 17.0.0-beta.20 bundle `3.3.0-beta.4`, 17.0.0-beta.21 through 17.0.0-beta.23 bundle `3.3.0-beta.5`, 17.0.0-beta.24 through 17.0.0-beta.28 bundle `3.3.0-beta.6`, and 17.0.0-beta.29 and later bundle `3.3.0-rc.0`. Each negotiates only its own prerelease, so a buyer and seller on different checkpoints settle on a stable release. Pin the exact SDK version, and send a prerelease `adcp_version` only to a peer that advertises that exact pin. `@adcp/sdk` 17 is a major release; read its [16 to 17 migration guide](https://github.com/adcontextprotocol/adcp-client/blob/main/docs/migration-16-to-17.md) first. -**Python.** `adcp` **10.0.0b17**, a PyPI prerelease (`pip install --pre "adcp==10.0.0b17"`), adopts the signed `3.3.0-beta.6` bundle and negotiates only `3.3-beta.6`; 10.0.0b13 through 10.0.0b16 adopt `3.3.0-beta.5`, and 10.0.0b12 adopts `3.3.0-beta.4`. 10.0.0b15 reads the `input` member of an [AdCP A2A profile](/docs/building/by-layer/L0/a2a-profile-extension) invocation, so a Python seller answers `@adcp/sdk` buyers over A2A 1.0, and it refuses `parameters` on an activated invocation. Keep production-line work on the 3.2 line: `adcp` 9.6.2 (AdCP 3.2.7) reads `input` too, and refuses only an activated invocation that carries both members. +**Python.** `adcp` **10.0.0b20**, a PyPI prerelease (`pip install --pre "adcp==10.0.0b20"`), adopts the signed `3.3.0-rc.0` bundle and negotiates only `3.3-rc.0`; 10.0.0b17 through 10.0.0b19 adopt `3.3.0-beta.6`, 10.0.0b13 through 10.0.0b16 adopt `3.3.0-beta.5`, and 10.0.0b12 adopts `3.3.0-beta.4`. 10.0.0b15 reads the `input` member of an [AdCP A2A profile](/docs/building/by-layer/L0/a2a-profile-extension) invocation, so a Python seller answers `@adcp/sdk` buyers over A2A 1.0, and it refuses `parameters` on an activated invocation. Keep production-line work on the 3.2 line: `adcp` 9.6.2 (AdCP 3.2.7) reads `input` too, and refuses only an activated invocation that carries both members. **Go and Java.** Neither supports 3.3. No Go or Java release bundles a 3.3 prerelease, so test 3.3 from those languages through raw-wire calls against the signed bundle, and check the [adcp-go releases](https://github.com/adcontextprotocol/adcp-go/releases) for any later support statement. diff --git a/docs/reference/release-notes.mdx b/docs/reference/release-notes.mdx index 0bce5fa7ac..1857110c0c 100644 --- a/docs/reference/release-notes.mdx +++ b/docs/reference/release-notes.mdx @@ -29,8 +29,8 @@ AdCP 3.3 lets scheduled, human-gated, and offline media run through the same buy | `3.3.0-beta.3` | 2026-10-31 | Live creative updates, the protocol envelope composed on every task response, money terms on resolved account requests, revocation as no access, and reporting-subscription coverage computable from the wire | `@adcp/sdk` 17.0.0-beta.11 through 17.0.0-beta.17 bundle this release | | `3.3.0-beta.4` | 2026-11-05 | Reporting-subscription coverage fixes (per-package `added_at`, a grant reduced without `get_reporting_status` as a loss of authority, schema-enforced durations) and the probe reset, `replace` that transfers assignment settings, tracker-slot limits only where a format declares slots, `BUDGET_TOO_LOW` details, `creative.supports_provenance`, `opportunity` on explicit-package buys, undefined-property reporting, and the hold, account-request, and reporting-subscription storyboards | `@adcp/sdk` 17.0.0-beta.18 through 17.0.0-beta.20 and Python `adcp` 10.0.0b12 support this release | | `3.3.0-beta.5` | 2026-11-07 | Experimental match keys for cross-publisher frequency capping, `sales-fixed-rate` promoted to stable, the bundled Public Suffix List (DR-0037), and offline legacy creative fixtures | `@adcp/sdk` 17.0.0-beta.21 through 17.0.0-beta.23 and Python `adcp` 10.0.0b13 through 10.0.0b16 support this release | -| `3.3.0-beta.6` | 2026-11-13 | Schemas open by default (DR-0036), the closed-schema triage that withdraws or moves the beta fields on deprecated tasks and on the commercial terms held closed until 4.0, the versioning rules for what changes between releases (#8704), origin-only `authorized_agents` URLs (#8939), declared-option creative conformance (#8941), TMP Context Match cache isolation (#7446), `creative.supports_registry_policy_enforcement` (#8857), `3gp`, `mpeg`, and `m4v` video containers (#8668), carousel `card_image_sizes` (#8937), loosened URL patterns (#8792), signed terms that bind every member (#8884), the experimental `https_put` reporting transport with no buyer secrets (#8793), `media_buy.supported_delivery_types` (#8458), display labels for geo targeting codes (#8966), experimental installment refinement (#8974) and per-installment creative assignment (#8972), and report definitions at `contract_version` `1.2` that carry `package_id` (#8983) | `@adcp/sdk` 17.0.0-beta.24 and later and Python `adcp` 10.0.0b17 and later support this release | -| `3.3.0-rc.0` | 2026-11-16 | First release candidate: everything in beta.6, plus prerelease pins, unpinned discovery, and anonymous capabilities, declared `sync_creatives` assignment operations (#8997), audience targeting without member push (#8996), carousel card `cta_values` (#9001), inline `submitted` branches aligned with their status files (#8934), the `by_package` guidance (#8970), scope and `signing_keys` rules for several matching `authorized_agents` entries (#9011, #9017), three renamed experimental values (#8989), an omitted `human_review_required` accepted by campaign governance (#9007), compliance gates for `audience_buy_flow` and `inline_creatives_without_sync` (#9013, #9005), the public test agent's `3.3-beta.6` preview (#9018), reserved-word-safe replacements for six enum values, with the originals deprecated (#8915), and the Instagram, Facebook, Snapchat and X distribution identifier types (#8995) | No published SDK supports it yet; new TypeScript and Python prereleases follow the cut | +| `3.3.0-beta.6` | 2026-11-13 | Schemas open by default (DR-0036), the closed-schema triage that withdraws or moves the beta fields on deprecated tasks and on the commercial terms held closed until 4.0, the versioning rules for what changes between releases (#8704), origin-only `authorized_agents` URLs (#8939), declared-option creative conformance (#8941), TMP Context Match cache isolation (#7446), `creative.supports_registry_policy_enforcement` (#8857), `3gp`, `mpeg`, and `m4v` video containers (#8668), carousel `card_image_sizes` (#8937), loosened URL patterns (#8792), signed terms that bind every member (#8884), the experimental `https_put` reporting transport with no buyer secrets (#8793), `media_buy.supported_delivery_types` (#8458), display labels for geo targeting codes (#8966), experimental installment refinement (#8974) and per-installment creative assignment (#8972), and report definitions at `contract_version` `1.2` that carry `package_id` (#8983) | `@adcp/sdk` 17.0.0-beta.24 through 17.0.0-beta.28 and Python `adcp` 10.0.0b17 through 10.0.0b19 support this release | +| `3.3.0-rc.0` | 2026-11-16 | First release candidate: everything in beta.6, plus prerelease pins, unpinned discovery, and anonymous capabilities, declared `sync_creatives` assignment operations (#8997), audience targeting without member push (#8996), carousel card `cta_values` (#9001), inline `submitted` branches aligned with their status files (#8934), the `by_package` guidance (#8970), scope and `signing_keys` rules for several matching `authorized_agents` entries (#9011, #9017), three renamed experimental values (#8989), an omitted `human_review_required` accepted by campaign governance (#9007), compliance gates for `audience_buy_flow` and `inline_creatives_without_sync` (#9013, #9005), the public test agent's `3.3-beta.6` preview (#9018), reserved-word-safe replacements for six enum values, with the originals deprecated (#8915), and the Instagram, Facebook, Snapchat and X distribution identifier types (#8995) | `@adcp/sdk` 17.0.0-beta.29 and Python `adcp` 10.0.0b20 support this release | Each prerelease is immutable. The `3.3-beta` documentation selector stays at beta.5, and `3.3-rc` advances to the latest release candidate, while pinned protocol, schema, compliance, and documentation artifacts remain available. See the [3.3 prerelease program](/docs/reference/3-3-beta). diff --git a/docs/reference/versions.mdx b/docs/reference/versions.mdx index 242c63cb1e..78413395fb 100644 --- a/docs/reference/versions.mdx +++ b/docs/reference/versions.mdx @@ -13,7 +13,7 @@ description: "Every published AdCP version, its status, and its end-of-life date | Status | Versions | Wire pin | What it means | |---|---|---|---| -| **Release candidate** | 3.3 (current prerelease: `rc.0`) | `"3.3-rc.0"` | Development and staging only. The first release candidate, after seven betas; no published SDK bundles it yet. Follow the [3.3 prerelease program](/docs/reference/3-3-beta). | +| **Release candidate** | 3.3 (current prerelease: `rc.0`) | `"3.3-rc.0"` | Development and staging only. The first release candidate, after seven betas; `@adcp/sdk` 17.0.0-beta.29 and Python `adcp` 10.0.0b20 bundle it. Follow the [3.3 prerelease program](/docs/reference/3-3-beta). | | **Active** | 3.2 (current stable: 3.2.1) | `"3.2"` | Current production minor release, published 2026-09-30. `3.2.0` was never released. TypeScript `@adcp/sdk@14.0.0` and Python `adcp==8.0.0` ship alongside it and embed it. See [What's new in AdCP 3.2](/docs/reference/whats-new-in-3-2) and the [3.1 to 3.2 migration guide](/docs/reference/migration/3-1-to-3-2). | | **Maintained** | 3.1 (current stable: 3.1.24) | `"3.1"` | Supported previous minor. Receives security and critical fixes on the `3.1.x` line for a maintainer-decided window. See [What's New in AdCP 3.1](/docs/reference/whats-new-in-3-1). | | **Maintained** | 3.0 (current stable: 3.0.26) | `"3.0"` | Supported previous minor for existing production integrations. Receives compatibility and security patches. | @@ -51,8 +51,8 @@ Supported patches don't change stable wire surfaces. Upgrading among supported 3 | Version | Released | Notes | |---|---|---| -| **3.3.0-rc.0** | 2026-11-16 | **Current 3.3 prerelease**, the first release candidate. Carries beta.6, plus the prerelease pins, unpinned discovery, and anonymous capabilities guidance, declared `sync_creatives` assignment operations (#8997), audience targeting without member push (#8996), carousel card `cta_values` (#9001), inline `submitted` branches aligned with their status files (#8934), the `by_package` guidance (#8970), scope and `signing_keys` rules for several matching `authorized_agents` entries (#9011, #9017), three renamed experimental values (#8989), an omitted `human_review_required` accepted by campaign governance (#9007), compliance gates for `audience_buy_flow` and `inline_creatives_without_sync` (#9013, #9005), the public test agent's `3.3-beta.6` preview (#9018), reserved-word-safe replacements for six enum values, with the originals deprecated (#8915), and the Instagram, Facebook, Snapchat and X distribution identifier types (#8995). No published SDK bundles it yet. See the [3.3 prerelease program](/docs/reference/3-3-beta). | -| 3.3.0-beta.6 | 2026-11-13 | Superseded. Opens the schemas that were closed by accident (DR-0036) and applies the closed-schema triage, which removes or moves the beta fields on deprecated tasks and on the commercial terms held closed until 4.0. `@adcp/sdk` 17.0.0-beta.24 and later and Python `adcp` 10.0.0b17 and later embed it. | +| **3.3.0-rc.0** | 2026-11-16 | **Current 3.3 prerelease**, the first release candidate. Carries beta.6, plus the prerelease pins, unpinned discovery, and anonymous capabilities guidance, declared `sync_creatives` assignment operations (#8997), audience targeting without member push (#8996), carousel card `cta_values` (#9001), inline `submitted` branches aligned with their status files (#8934), the `by_package` guidance (#8970), scope and `signing_keys` rules for several matching `authorized_agents` entries (#9011, #9017), three renamed experimental values (#8989), an omitted `human_review_required` accepted by campaign governance (#9007), compliance gates for `audience_buy_flow` and `inline_creatives_without_sync` (#9013, #9005), the public test agent's `3.3-beta.6` preview (#9018), reserved-word-safe replacements for six enum values, with the originals deprecated (#8915), and the Instagram, Facebook, Snapchat and X distribution identifier types (#8995). `@adcp/sdk` 17.0.0-beta.29 and Python `adcp` 10.0.0b20 embed it. See the [3.3 prerelease program](/docs/reference/3-3-beta). | +| 3.3.0-beta.6 | 2026-11-13 | Superseded. Opens the schemas that were closed by accident (DR-0036) and applies the closed-schema triage, which removes or moves the beta fields on deprecated tasks and on the commercial terms held closed until 4.0. `@adcp/sdk` 17.0.0-beta.24 through 17.0.0-beta.28 and Python `adcp` 10.0.0b17 through 10.0.0b19 embed it. | | 3.3.0-beta.5 | 2026-11-07 | Superseded. Experimental match keys, `sales-fixed-rate` promoted to stable, and the bundled Public Suffix List. `@adcp/sdk` 17.0.0-beta.21 through 17.0.0-beta.23 and Python `adcp` 10.0.0b13 through 10.0.0b16 embed it. | | 3.3.0-beta.4 | 2026-11-05 | Superseded. Reporting-subscription coverage fixes, assignment `replace` settings transfer, and the hold, account-request, and reporting-subscription storyboards. `@adcp/sdk` 17.0.0-beta.18 through 17.0.0-beta.20 and Python `adcp` 10.0.0b12 embed it. | | 3.3.0-beta.0 through beta.3 | 2026-10-22 to 2026-10-31 | Superseded. Beta.0 was the protocol-first input for SDK work; beta.1 to beta.3 added the account identity model, principal-level reporting subscriptions, live creative updates, and the protocol envelope on every response, and beta.2 withdrew definition pins, purchase rights, and installment selection. | diff --git a/package-lock.json b/package-lock.json index bf4eec3db1..49edabb45d 100644 --- a/package-lock.json +++ b/package-lock.json @@ -9,7 +9,7 @@ "version": "3.3.0-rc.0", "dependencies": { "@adcp/reporting-storage": "0.3.0-beta.1", - "@adcp/sdk": "17.0.0-beta.28", + "@adcp/sdk": "17.0.0-beta.29", "@anthropic-ai/sdk": "^0.127.0", "@asteasolutions/zod-to-openapi": "^8.5.0", "@contentauth/c2pa-node": "^0.10.0", @@ -163,9 +163,9 @@ } }, "node_modules/@adcp/sdk": { - "version": "17.0.0-beta.28", - "resolved": "https://registry.npmjs.org/@adcp/sdk/-/sdk-17.0.0-beta.28.tgz", - "integrity": "sha512-dZ5PQPyF/YFSd69nG23aZKvnkgrDr8LgDk5AK3EsobKHWU4ezBTChKTx7iHvndrs7rfCC1VRq1JKX+JwZ+Xctw==", + "version": "17.0.0-beta.29", + "resolved": "https://registry.npmjs.org/@adcp/sdk/-/sdk-17.0.0-beta.29.tgz", + "integrity": "sha512-uAz8TRJxY2JXJWeOZcz2TW4IizsHlzkMbAOBxKs2WoEDyX34yCszqPQv7/oqyAXOBRD/NErd4UVB9l7chk0lUQ==", "license": "Apache-2.0", "workspaces": [ ".", diff --git a/package.json b/package.json index 818adebc39..8de3015f85 100644 --- a/package.json +++ b/package.json @@ -215,7 +215,7 @@ }, "dependencies": { "@adcp/reporting-storage": "0.3.0-beta.1", - "@adcp/sdk": "17.0.0-beta.28", + "@adcp/sdk": "17.0.0-beta.29", "@anthropic-ai/sdk": "^0.127.0", "@asteasolutions/zod-to-openapi": "^8.5.0", "@contentauth/c2pa-node": "^0.10.0", diff --git a/scripts/sdk-response-conformance/README.md b/scripts/sdk-response-conformance/README.md index 30962d33fa..facea6cbe0 100644 --- a/scripts/sdk-response-conformance/README.md +++ b/scripts/sdk-response-conformance/README.md @@ -40,7 +40,7 @@ The report exits **1 for findings or skipped cases**, **2 for a harness failure* ## Initial findings and regression policy -The baseline was first recorded with `@adcp/sdk@14.0.0-rc.35`, `adcp==8.0.0b14`, and Go `adcp/v3@v3.2.1` against RC.1. Prior TypeScript evidence paired `@adcp/sdk@16.3.0` with the 3.2.1 GA release. The current TypeScript capture uses the exact published `@adcp/sdk@17.0.0-beta.28` artifact against that same 3.2.1 GA artifact. Its primary bundle is 3.3.0-beta.6; this probe independently grades the selected 3.2.1 release. All 125 cases dispatched: 124 responses passed the release schema, all 125 semantic checks passed, and the existing `catalog:list_products` schema finding remains. Artifact digests, coverage, findings and skips match the previous TypeScript baseline; only its recorded SDK version changes. Python and Go entries retain their earlier pinned evidence. There are two catalog cases, one case for every published error default, and three overrides per language. Go skips native listing. The report records: +The baseline was first recorded with `@adcp/sdk@14.0.0-rc.35`, `adcp==8.0.0b14`, and Go `adcp/v3@v3.2.1` against RC.1. Prior TypeScript evidence paired `@adcp/sdk@16.3.0` with the 3.2.1 GA release. The current TypeScript capture uses the exact published `@adcp/sdk@17.0.0-beta.29` artifact against that same 3.2.1 GA artifact. Its primary bundle is 3.3.0-rc.0; this probe independently grades the selected 3.2.1 release. All 125 cases dispatched: 124 responses passed the release schema, all 125 semantic checks passed, and the existing `catalog:list_products` schema finding remains. Artifact digests, coverage, findings and skips match the previous TypeScript baseline; only its recorded SDK version changes. Python and Go entries retain their earlier pinned evidence. There are two catalog cases, one case for every published error default, and three overrides per language. Go skips native listing. The report records: - TypeScript: error defaults and overrides agree; `list_products` gains `adcp_version`, which the raw pinned response schema forbids. This is a schema/envelope inconsistency, related to the prior [SDK normalization fix #2594](https://github.com/adcontextprotocol/adcp-client/issues/2594); it is not a claim that the fixed SDK client still rejects the response. The probe deliberately retains the raw artifact result instead of silently stripping fields or patching an immutable schema. - Python: 84 default recovery classifications differ from the published metadata; native listing gains `status: completed`, rejected both by the raw pinned schema and the MCP client's advertised-output validator. diff --git a/scripts/sdk-response-conformance/known-findings.json b/scripts/sdk-response-conformance/known-findings.json index 7321058832..9505248f3d 100644 --- a/scripts/sdk-response-conformance/known-findings.json +++ b/scripts/sdk-response-conformance/known-findings.json @@ -1,6 +1,6 @@ [ { - "sdk": {"package":"@adcp/sdk","version":"17.0.0-beta.28"}, + "sdk": {"package":"@adcp/sdk","version":"17.0.0-beta.29"}, "protocol": { "version": "3.2.1", "wire_selector": "3.2", diff --git a/server/src/training-agent/candidate-version.ts b/server/src/training-agent/candidate-version.ts index 66aaf1e4aa..e945c8433f 100644 --- a/server/src/training-agent/candidate-version.ts +++ b/server/src/training-agent/candidate-version.ts @@ -18,16 +18,16 @@ export const TRAINING_AGENT_CANDIDATE_ADCP_VERSION = trainingAgentCandidateVersi * (`dist/schemas/`) its responses validate against. * * It must name the prerelease the installed @adcp/sdk negotiates, or SDK - * buyers settle on 3.2 instead: 17.0.0-beta.24 and later negotiate exactly - * `3.3-beta.6`. Its published schemas must also match what the agent emits. - * One preview is served at a time, so advance it with the SDK's bundled beta; + * buyers settle on 3.2 instead: 17.0.0-beta.29 and later negotiate exactly + * `3.3-rc.0`. Its published schemas must also match what the agent emits. + * One preview is served at a time, so advance it with the SDK's bundled prerelease; * tenants/served-release-shape.test.ts grades the agent's preview responses * against this bundle, and training-agent-preview-version.test.ts checks * that the installed SDK selects it. */ export const TRAINING_AGENT_HOSTED_PREVIEW = Object.freeze({ - wireVersion: '3.3-beta.6', - bundle: '3.3.0-beta.6', + wireVersion: '3.3-rc.0', + bundle: '3.3.0-rc.0', } as const); /** Ops kill switch: set to `1` or `true` to stop advertising and serving the diff --git a/server/src/training-agent/tenants/tenant-smoke.test.ts b/server/src/training-agent/tenants/tenant-smoke.test.ts index a803626308..444b84deb6 100644 --- a/server/src/training-agent/tenants/tenant-smoke.test.ts +++ b/server/src/training-agent/tenants/tenant-smoke.test.ts @@ -2292,7 +2292,7 @@ describe('tenant routing smoke', () => { expect(body.result?.structuredContent?.adcp_version).toBe('3.2'); expect(body.result?.structuredContent?.adcp?.major_versions).toContain(3); // The opt-in 3.3 preview (#8181) is advertised last, served to an exact pin only. - expect(body.result?.structuredContent?.adcp?.supported_versions).toEqual(['3.0', '3.1-beta.5', '3.1-beta.7', '3.1-rc.4', '3.1-rc.6', '3.1-rc.7', '3.1-rc.8', '3.1-rc.9', '3.1-rc.10', '3.1-rc.14', '3.1-rc.15', '3.1', '3.2-beta.6', '3.2-rc.0', '3.2-rc.7', '3.2', '3.3-beta.6']); + expect(body.result?.structuredContent?.adcp?.supported_versions).toEqual(['3.0', '3.1-beta.5', '3.1-beta.7', '3.1-rc.4', '3.1-rc.6', '3.1-rc.7', '3.1-rc.8', '3.1-rc.9', '3.1-rc.10', '3.1-rc.14', '3.1-rc.15', '3.1', '3.2-beta.6', '3.2-rc.0', '3.2-rc.7', '3.2', '3.3-rc.0']); expect(mediaBuy?.features?.inline_creative_management).toBe(true); expect(mediaBuy?.supported_optimization_metrics).toContain('clicks'); expect(mediaBuy?.vendor_metric_optimization?.supported_targets).toContain('threshold_rate'); @@ -3927,7 +3927,7 @@ describe('tenant routing smoke', () => { field: 'adcp_version', details: { adcp_version: '4.0', - supported_versions: ['3.0', '3.1-beta.5', '3.1-beta.7', '3.1-rc.4', '3.1-rc.6', '3.1-rc.7', '3.1-rc.8', '3.1-rc.9', '3.1-rc.10', '3.1-rc.14', '3.1-rc.15', '3.1', '3.2-beta.6', '3.2-rc.0', '3.2-rc.7', '3.2', '3.3-beta.6'], + supported_versions: ['3.0', '3.1-beta.5', '3.1-beta.7', '3.1-rc.4', '3.1-rc.6', '3.1-rc.7', '3.1-rc.8', '3.1-rc.9', '3.1-rc.10', '3.1-rc.14', '3.1-rc.15', '3.1', '3.2-beta.6', '3.2-rc.0', '3.2-rc.7', '3.2', '3.3-rc.0'], }, }); expect(unsupportedBody.result?.structuredContent?.context?.correlation_id).toBe('tenant-local-version-unsupported'); diff --git a/server/tests/unit/training-agent-preview-version.test.ts b/server/tests/unit/training-agent-preview-version.test.ts index 0fa5fd32fc..cc7b82defb 100644 --- a/server/tests/unit/training-agent-preview-version.test.ts +++ b/server/tests/unit/training-agent-preview-version.test.ts @@ -34,8 +34,8 @@ type Structured = Record; describe('hosted 3.3 preview selection', () => { it('serves the published preview by default, in every runtime', () => { - expect(PREVIEW).toBe('3.3-beta.6'); - expect(TRAINING_AGENT_HOSTED_PREVIEW.bundle).toBe('3.3.0-beta.6'); + expect(PREVIEW).toBe('3.3-rc.0'); + expect(TRAINING_AGENT_HOSTED_PREVIEW.bundle).toBe('3.3.0-rc.0'); expect(TRAINING_AGENT_PREVIEW_ADCP_VERSION).toBe(PREVIEW); for (const NODE_ENV of ['production', 'development', 'test', undefined]) { expect(trainingAgentPreviewVersion({ NODE_ENV })).toBe(PREVIEW); @@ -53,10 +53,10 @@ describe('hosted 3.3 preview selection', () => { }); it('yields to a trusted storyboard candidate', () => { - const candidate = { NODE_ENV: 'test', ADCP_STORYBOARD_CANDIDATE_VERSION_MODE: '1', ADCP_TRAINING_CANDIDATE_VERSION: '3.3-beta.7' }; - expect(trainingAgentPreviewVersion(candidate)).toBe('3.3-beta.7'); + const candidate = { NODE_ENV: 'test', ADCP_STORYBOARD_CANDIDATE_VERSION_MODE: '1', ADCP_TRAINING_CANDIDATE_VERSION: '3.3-rc.1' }; + expect(trainingAgentPreviewVersion(candidate)).toBe('3.3-rc.1'); // The kill switch governs only the hosted preview. - expect(trainingAgentPreviewVersion({ ...candidate, [TRAINING_AGENT_PREVIEW_KILL_SWITCH]: '1' })).toBe('3.3-beta.7'); + expect(trainingAgentPreviewVersion({ ...candidate, [TRAINING_AGENT_PREVIEW_KILL_SWITCH]: '1' })).toBe('3.3-rc.1'); // Candidate mode never applies outside the test runtime. expect(trainingAgentPreviewVersion({ ...candidate, NODE_ENV: 'production' })).toBe(PREVIEW); }); @@ -75,7 +75,7 @@ describe('hosted 3.3 preview selection', () => { expect(resolveServedAdcpVersion({ adcp_version })).toEqual({ ok: true, servedVersion: '3.2' }); } // Other prereleases of the line are matched exactly, so they are refused. - for (const adcp_version of ['3.3-beta.5', '3.3-beta.7', '3.3-rc.1']) { + for (const adcp_version of ['3.3-beta.6', '3.3-rc.1', '3.3-rc.2']) { expect(resolveServedAdcpVersion({ adcp_version }).ok).toBe(false); } expect(resolveServedAdcpVersion({}).ok && resolveServedAdcpVersion({}).servedVersion).toBe('3.0'); @@ -90,7 +90,7 @@ describe('hosted 3.3 preview selection', () => { expect(requestPinsPreview(call({ adcp_version: PREVIEW }))).toBe(true); expect(requestPinsPreview({ method: 'tools/list', params: { _meta: { adcp_version: PREVIEW } } })).toBe(true); expect(requestPinsPreview({ method: 'tools/list', params: { adcp_version: PREVIEW } })).toBe(true); - for (const args of [{}, { adcp_major_version: 3 }, { adcp_version: '3.2' }, { adcp_version: '3.3' }, { adcp_version: '3.3-beta.5' }, { adcp_version: '3.3.0-beta.6' }]) { + for (const args of [{}, { adcp_major_version: 3 }, { adcp_version: '3.2' }, { adcp_version: '3.3' }, { adcp_version: '3.3-beta.6' }, { adcp_version: '3.3.0-rc.0' }]) { expect(requestPinsPreview(call(args)), JSON.stringify(args)).toBe(false); } expect(requestPinsPreview({ method: 'tools/list', params: {} })).toBe(false); @@ -163,11 +163,11 @@ describe('hosted 3.3 preview negotiation over MCP', () => { expect(result.adcp.supported_versions).toContain('3.2'); expect(result.adcp.supported_versions).not.toContain('3.3-beta.1'); // The previous preview is no longer served once the preview moves. - expect(result.adcp.supported_versions).not.toContain('3.3-beta.5'); + expect(result.adcp.supported_versions).not.toContain('3.3-beta.6'); } // A 3.3 prerelease the agent does not list never selects the preview: - // neither the previous preview nor a later beta. - for (const adcp_version of ['3.3-beta.5', '3.3-beta.7']) { + // neither the previous preview nor a later release candidate. + for (const adcp_version of ['3.3-beta.6', '3.3-rc.1']) { const result = await call(route, 'get_adcp_capabilities', { adcp_version }); expect(result.adcp_version, `${route} ${adcp_version}: ${JSON.stringify(result).slice(0, 300)}`).not.toBe(PREVIEW); expect(result.adcp_version).not.toBe(adcp_version);