Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
4 changes: 2 additions & 2 deletions docs/TYPE-SUMMARY.md
Original file line number Diff line number Diff line change
@@ -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`.

Expand Down
2 changes: 1 addition & 1 deletion docs/llms.txt
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
8 changes: 4 additions & 4 deletions docs/migration-14.x-rc-worksheet.md
Original file line number Diff line number Diff line change
Expand Up @@ -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` |
Expand All @@ -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
Expand Down
6 changes: 3 additions & 3 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -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": [
".",
Expand Down
2 changes: 1 addition & 1 deletion packages/client-shim/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -106,7 +106,7 @@
"LICENSE"
],
"dependencies": {
"@adcp/sdk": "^17.0.0-beta.28"
"@adcp/sdk": "^17.0.0-beta.29"
},
"keywords": [
"adcp",
Expand Down
6 changes: 3 additions & 3 deletions src/lib/version.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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;

/**
Expand Down
Loading