diff --git a/.changeset/adopt-adcp-3-3-rc-0.md b/.changeset/pre/adopt-adcp-3-3-rc-0.md similarity index 100% rename from .changeset/adopt-adcp-3-3-rc-0.md rename to .changeset/pre/adopt-adcp-3-3-rc-0.md diff --git a/.changeset/prerelease-selection.md b/.changeset/pre/prerelease-selection.md similarity index 100% rename from .changeset/prerelease-selection.md rename to .changeset/pre/prerelease-selection.md diff --git a/.changeset/refine-proposals-ext.md b/.changeset/pre/refine-proposals-ext.md similarity index 100% rename from .changeset/refine-proposals-ext.md rename to .changeset/pre/refine-proposals-ext.md diff --git a/.changeset/registry-verdict-explanation.md b/.changeset/pre/registry-verdict-explanation.md similarity index 100% rename from .changeset/registry-verdict-explanation.md rename to .changeset/pre/registry-verdict-explanation.md diff --git a/CHANGELOG.md b/CHANGELOG.md index 98c06c21a..3fca8ab41 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,23 @@ # Changelog +## 17.0.0-beta.29 + +### Minor Changes + +- 4393a0e: **Beta-channel break for beta.6 pins:** this SDK advertises and negotiates only the AdCP `3.3-rc.0` preview, the first 3.3 release candidate, and no longer packages or advertises `3.3-beta.6`. A buyer or seller still on beta.6 will not select the 3.3 preview with this release; the pair negotiates a shared stable release (3.2.8, 3.1.31 or 3.0.25) instead. Upgrade both sides together to keep exercising 3.3 preview features. An explicit `adcpVersion: '3.3.0-beta.6'` (or `'3.3-beta.6'`) pin now fails with a configuration error. + + Adopt the signed AdCP 3.3.0-rc.0 bundle (tag commit b5ac0e1bf733, sha256 bdcacb0bb548..., cosign-verified), replacing 3.3.0-beta.6. Public types, Zod schemas, tool metadata and the packaged compliance corpus are regenerated from the rc.0 release. + - **Renamed experimental values, no alias (adcontextprotocol/adcp#8989):** execution readiness `input_required` is now `input-required`, creative change kind `click_through` is now `clickthrough`, and delivery projection end state `underdelivery` is now `under_delivery`. The generated types follow. + - **Reserved-word-safe replacements (adcp#8915):** `passed` replaces `pass` (content-standards verdicts, `get_media_buy_artifacts` `local_verdict`, registry feed compliance tracks), `all` replaces `global` (`RATE_LIMITED` scope), and `full_name` replaces `name` (signal onboarder `match_keys`). The originals stay valid and deprecated through 3.x. Version projection to a pre-3.3 seller or caller now maps a replacement back to the value it supersedes (`passed` to `pass`) instead of dropping it. + - **Additions:** Instagram, Facebook, Snapchat and X distribution identifier types (adcp#8995); `creative.assignment_operations` (adcp#8997), which sellers declare through the new `creative.assignmentOperations` capability option and buyers read from `CreativeCapabilities.assignmentOperations` (newly exported with `CreativeAssignmentOperation`; a compact seller with a creative library must list `assign`); audience targeting without inline member push (adcp#8996); `image_carousel` `cta_values` (adcp#9001). `by_package` should carry a row (adcp#8970), inline `submitted` branches are aligned (adcp#8934), and `sync_plans` accepts an omitted `human_review_required` (adcp#9007). + - The proposal-terms review table, canonical storyboard fixtures and reporting-subscription vectors are unchanged from beta.6 and are re-pinned to v3.3.0-rc.0. + +### Patch Changes + +- 5f61fde: Keep stable AdCP pins on stable releases and require exact prerelease pins in server negotiation. Report the selected release in MCP tool discovery metadata. +- acab9ec: Accept the `ext` vendor extension point on `refine_proposals`. `validateRefineProposalsRequest`, which `createAdcpServer` runs before every handler, rejected `ext` on the request and on finalize and revise refinements with `VALIDATION_ERROR`, though the schemas allow it. `ext` is now accepted there when it is an object, and every other unknown key is still rejected. Response verification also accepts `ext` on result items. The request, refinement and result types carry an optional `ext`. +- 6c74752: Refresh the registry OpenAPI snapshot and generated types for the published storyboard verdict explanation (adcontextprotocol/adcp#8576): `verdict_explanation` on storyboard results, with the new `StoryboardVerdictExplanation` and `StoryboardVerdictContributor` schemas. It explains why a storyboard failed when no counted step did, and is populated only for owners and operators. The field is nullable and the change is additive. + ## 17.0.0-beta.28 ### Minor Changes diff --git a/docs/TYPE-SUMMARY.md b/docs/TYPE-SUMMARY.md index ebcc7f09f..fa5490e4b 100644 --- a/docs/TYPE-SUMMARY.md +++ b/docs/TYPE-SUMMARY.md @@ -1,7 +1,7 @@ # AdCP Type Summary -> Generated at: 2026-11-15 -> @adcp/sdk v17.0.0-beta.28 +> Generated at: 2026-11-17 +> @adcp/sdk v17.0.0-beta.29 Curated reference of the types that matter for using the AdCP client. For full generated types see `src/lib/types/tools.generated.ts` and `src/lib/types/core.generated.ts`. diff --git a/docs/llms.txt b/docs/llms.txt index 5be278fa2..592a2e8ff 100644 --- a/docs/llms.txt +++ b/docs/llms.txt @@ -1,7 +1,7 @@ # Ad Context Protocol (AdCP) > Generated at: 2026-11-17 -> Library: @adcp/sdk v17.0.0-beta.28 +> Library: @adcp/sdk v17.0.0-beta.29 > AdCP major version: 3 > Canonical URL: https://adcontextprotocol.github.io/adcp-client/llms.txt > Note: the `Library` stamp reflects the package.json version at doc-generation time. The narrative below describes the surface that lands on the next-published minor — including any 6.7 helpers documented here ahead of the release tag. diff --git a/docs/migration-14.x-rc-worksheet.md b/docs/migration-14.x-rc-worksheet.md index 3c553496a..f512b075c 100644 --- a/docs/migration-14.x-rc-worksheet.md +++ b/docs/migration-14.x-rc-worksheet.md @@ -16,8 +16,8 @@ pin using `ADCP_VERSION` inside that tarball. | Fact | Value | | --- | --- | -| Checkout `package.json` version | `@adcp/sdk@17.0.0-beta.28` | -| npm integrity | registry-derived after publication; run `npm view @adcp/sdk@17.0.0-beta.28 dist.integrity` | +| Checkout `package.json` version | `@adcp/sdk@17.0.0-beta.29` | +| npm integrity | registry-derived after publication; run `npm view @adcp/sdk@17.0.0-beta.29 dist.integrity` | | Node.js runtime | `^20.19.0 || >=22.12.0` | | Default AdCP wire release | `3.3.0-rc.0` | | Maintained wire releases | `v3`, `3.0.0`, `3.0`, `3.0.1`, `3.0.2`, `3.0.3`, `3.0.4`, `3.0.5`, `3.0.6`, `3.0.7`, `3.0.8`, `3.0.9`, `3.0.10`, `3.0.11`, `3.0.12`, `3.0.13`, `3.0.14`, `3.0.15`, `3.0.16`, `3.0.17`, `3.0.18`, `3.0.19`, `3.0.20`, `3.0.21`, `3.0.22`, `3.0.23`, `3.0.24`, `3.0.25`, `3.1.0`, `3.1`, `3.1.1`, `3.1.2`, `3.1.3`, `3.1.4`, `3.1.5`, `3.1.6`, `3.1.7`, `3.1.8`, `3.1.9`, `3.1.10`, `3.1.11`, `3.1.12`, `3.1.13`, `3.1.14`, `3.1.15`, `3.1.16`, `3.1.17`, `3.1.18`, `3.1.19`, `3.1.20`, `3.1.21`, `3.1.22`, `3.1.23`, `3.1.24`, `3.1.25`, `3.1.26`, `3.1.27`, `3.1.28`, `3.1.29`, `3.1.30`, `3.1.31`, `3.2.1`, `3.2`, `3.2.2`, `3.2.3`, `3.2.4`, `3.2.5`, `3.2.6`, `3.2.7`, `3.2.8`, `3.3.0-rc.0`, `3.3-rc.0` | @@ -26,8 +26,8 @@ pin using `ADCP_VERSION` inside that tarball. For a checkout at the published release commit, install the exact package version: ```bash -npm install --save-exact '@adcp/sdk@17.0.0-beta.28' -npm view '@adcp/sdk@17.0.0-beta.28' dist.integrity +npm install --save-exact '@adcp/sdk@17.0.0-beta.29' +npm view '@adcp/sdk@17.0.0-beta.29' dist.integrity ``` ### Required and optional peers diff --git a/package-lock.json b/package-lock.json index fd666b636..bde13deaa 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "@adcp/sdk", - "version": "17.0.0-beta.28", + "version": "17.0.0-beta.29", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "@adcp/sdk", - "version": "17.0.0-beta.28", + "version": "17.0.0-beta.29", "license": "Apache-2.0", "workspaces": [ ".", @@ -9688,7 +9688,7 @@ "version": "6.0.0", "license": "Apache-2.0", "dependencies": { - "@adcp/sdk": "^17.0.0-beta.28" + "@adcp/sdk": "^17.0.0-beta.29" }, "bin": { "adcp": "bin/adcp.js" diff --git a/package.json b/package.json index 58db18caa..53ae40288 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@adcp/sdk", - "version": "17.0.0-beta.28", + "version": "17.0.0-beta.29", "description": "AdCP SDK — client, server, and compliance harnesses for the AdContext Protocol (MCP + A2A)", "workspaces": [ ".", diff --git a/packages/client-shim/package.json b/packages/client-shim/package.json index 1c0635216..682c667f9 100644 --- a/packages/client-shim/package.json +++ b/packages/client-shim/package.json @@ -106,7 +106,7 @@ "LICENSE" ], "dependencies": { - "@adcp/sdk": "^17.0.0-beta.28" + "@adcp/sdk": "^17.0.0-beta.29" }, "keywords": [ "adcp", diff --git a/src/lib/version.ts b/src/lib/version.ts index 884d1c60c..07e5d2744 100644 --- a/src/lib/version.ts +++ b/src/lib/version.ts @@ -4,7 +4,7 @@ /** * AdCP SDK library version */ -export const LIBRARY_VERSION = '17.0.0-beta.28'; +export const LIBRARY_VERSION = '17.0.0-beta.29'; /** * AdCP specification version this library is built for @@ -114,10 +114,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number]; * Full version information */ export const VERSION_INFO = { - library: '17.0.0-beta.28', + library: '17.0.0-beta.29', adcp: '3.3.0-rc.0', compatibleVersions: COMPATIBLE_ADCP_VERSIONS, - generatedAt: '2026-11-15T14:00:59.479Z', + generatedAt: '2026-11-17T04:51:59.333Z', } as const; /**