From 7d7060794811679d83cd32a072e5767531de53b0 Mon Sep 17 00:00:00 2001 From: Brian O'Kelley Date: Thu, 29 Oct 2026 22:05:32 +0000 Subject: [PATCH 1/2] chore(deps): @adcp/sdk 17.0.0-beta.6 Moves the training agent's 3.3 candidate and creative sandbox pins from 3.3-beta.0 to 3.3-beta.1: SDK beta.5 no longer packages or negotiates beta.0. Co-Authored-By: Claude Sonnet 5.5 --- docs/building/by-layer/L4/choose-your-sdk.mdx | 6 +-- docs/contributing/creative33-sandbox.md | 6 +-- package-lock.json | 8 ++-- package.json | 2 +- .../known-findings.json | 2 +- .../src/training-agent/creative33/catalog.ts | 4 +- .../src/training-agent/creative33/router.ts | 4 +- server/src/training-agent/task-handlers.ts | 2 +- server/tests/unit/storyboard-cache.test.ts | 4 +- .../training-agent-candidate-version.test.ts | 38 +++++++++---------- ...aining-agent-creative-start-policy.test.ts | 2 +- .../training-agent-creative33-buyer.test.ts | 4 +- .../training-agent-creative33-routing.test.ts | 4 +- .../unit/training-agent-creators.test.ts | 6 +-- .../training-agent-gender-targeting.test.ts | 2 +- ...ning-agent-list-products-canonical.test.ts | 4 +- .../training-agent-package-forecast.test.ts | 6 +-- ...agent-seller-managed-event-sources.test.ts | 4 +- ...aining-agent-served-release-fields.test.ts | 6 +-- server/tests/unit/training-agent.test.ts | 2 +- 20 files changed, 58 insertions(+), 58 deletions(-) diff --git a/docs/building/by-layer/L4/choose-your-sdk.mdx b/docs/building/by-layer/L4/choose-your-sdk.mdx index abfa4ac8723..efbdff7ef98 100644 --- a/docs/building/by-layer/L4/choose-your-sdk.mdx +++ b/docs/building/by-layer/L4/choose-your-sdk.mdx @@ -43,13 +43,13 @@ 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.3` (npm `beta` dist-tag) | Signed `3.3.0-beta.0`; also bundles stable 3.2.7, 3.1.29 and 3.0.25 | Buyer client and seller server, MCP and A2A | Identity and Web Bot Auth (`@adcp/sdk/identity-3.3`) remain experimental opt-ins. The standalone commercial-terms verifier fails closed on 3.3 definition pins; keep snapshot verification on the stable 3.2.7 contract. Reliable Reporting storage needs `@adcp/reporting-storage@0.3.0-beta.1`. | +| **`@adcp/sdk`** (TypeScript) | `17.0.0-beta.6` (npm `beta` dist-tag) | Signed `3.3.0-beta.1` only (beta.5 dropped `3.3-beta.0`; a beta.0 peer negotiates stable 3.2.7); also bundles stable 3.2.7, 3.1.29 and 3.0.25 | Buyer client and seller server, MCP and A2A | Identity and Web Bot Auth (`@adcp/sdk/identity-3.3`) remain experimental opt-ins. The standalone commercial-terms verifier fails closed on 3.3 definition pins; keep snapshot verification on the stable 3.2.7 contract. Reliable Reporting storage needs `@adcp/reporting-storage@0.3.0-beta.1`. | No Python or Go package is listed for beta.0 yet. Until a row here names one, treat that SDK's 3.3 types and validators as unavailable. ```bash -npm install @adcp/sdk@17.0.0-beta.3 -node -p "require('@adcp/sdk').ADCP_VERSION" # 3.3.0-beta.0 +npm install @adcp/sdk@17.0.0-beta.6 +node -p "require('@adcp/sdk').ADCP_VERSION" # 3.3.0-beta.1 ``` 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 `3.3-beta.0` 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 d1e1bcec87f..6fb81db0032 100644 --- a/docs/contributing/creative33-sandbox.md +++ b/docs/contributing/creative33-sandbox.md @@ -6,12 +6,12 @@ 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.0` contract using the -published TypeScript SDK `17.0.0-beta.0`. Its MCP endpoint is: +This development lab serves the frozen AdCP `3.3.0-beta.1` contract using the +published TypeScript SDK `17.0.0-beta.6`. Its MCP endpoint is: `https://test-agent.adcontextprotocol.org/beta/3.3/creative/mcp` -The wire selector is `3.3-beta.0`. The endpoint defaults to that beta and +The wire selector is `3.3-beta.1`. The endpoint defaults to that beta and rejects stable or other prerelease selectors. Capability discovery lists only this release and the implemented creative fixture contracts. All operations finish synchronously. diff --git a/package-lock.json b/package-lock.json index 9bffd615e25..01bb643397c 100644 --- a/package-lock.json +++ b/package-lock.json @@ -9,7 +9,7 @@ "version": "3.3.0-beta.1", "dependencies": { "@adcp/reporting-storage": "0.3.0-beta.1", - "@adcp/sdk": "17.0.0-beta.3", + "@adcp/sdk": "17.0.0-beta.6", "@anthropic-ai/sdk": "^0.127.0", "@asteasolutions/zod-to-openapi": "^8.5.0", "@contentauth/c2pa-node": "^0.9.7", @@ -163,9 +163,9 @@ } }, "node_modules/@adcp/sdk": { - "version": "17.0.0-beta.3", - "resolved": "https://registry.npmjs.org/@adcp/sdk/-/sdk-17.0.0-beta.3.tgz", - "integrity": "sha512-P9dgrPoPJjIdzmV4J/PeSl0NVij0fLfdbeJycsalVBWZE3r723tPptCiH7wyfJfE/XGoEtKNY3ky3DLsyFt5dQ==", + "version": "17.0.0-beta.6", + "resolved": "https://registry.npmjs.org/@adcp/sdk/-/sdk-17.0.0-beta.6.tgz", + "integrity": "sha512-N3QGfGBvzV6K7vChp64+kDyv6Ih76bs9lFLdmW6T3FXk7itp8b6Zg0gBrhwXEXQjOEHz+QQ4f9rJg7HNROqCHg==", "license": "Apache-2.0", "workspaces": [ ".", diff --git a/package.json b/package.json index d7695c4a187..26f895745dc 100644 --- a/package.json +++ b/package.json @@ -213,7 +213,7 @@ }, "dependencies": { "@adcp/reporting-storage": "0.3.0-beta.1", - "@adcp/sdk": "17.0.0-beta.3", + "@adcp/sdk": "17.0.0-beta.6", "@anthropic-ai/sdk": "^0.127.0", "@asteasolutions/zod-to-openapi": "^8.5.0", "@contentauth/c2pa-node": "^0.9.7", diff --git a/scripts/sdk-response-conformance/known-findings.json b/scripts/sdk-response-conformance/known-findings.json index 56542e22e63..ffe333e89d9 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.3"}, + "sdk": {"package":"@adcp/sdk","version":"17.0.0-beta.6"}, "protocol": { "version": "3.2.1", "wire_selector": "3.2", diff --git a/server/src/training-agent/creative33/catalog.ts b/server/src/training-agent/creative33/catalog.ts index 42418d3bfa6..1fb2f23ef48 100644 --- a/server/src/training-agent/creative33/catalog.ts +++ b/server/src/training-agent/creative33/catalog.ts @@ -2,8 +2,8 @@ import { createHash } from 'node:crypto'; import { getAgentUrl } from '../config.js'; -export const CREATIVE33_WIRE_VERSION = '3.3-beta.0'; -export const CREATIVE33_SCHEMA_VERSION = '3.3.0-beta.0'; +export const CREATIVE33_WIRE_VERSION = '3.3-beta.1'; +export const CREATIVE33_SCHEMA_VERSION = '3.3.0-beta.1'; export const CREATIVE33_ROUTE = '/beta/3.3/creative'; export const CREATIVE33_SIZES = [{ width: 300, height: 250 }, { width: 728, height: 90 }]; export const CREATIVE33_RESPONSIVE_HTML = 'Acme outdoor — deterministic sandbox fixture'; diff --git a/server/src/training-agent/creative33/router.ts b/server/src/training-agent/creative33/router.ts index 5554a7d8ebd..40d1c4dbbe4 100644 --- a/server/src/training-agent/creative33/router.ts +++ b/server/src/training-agent/creative33/router.ts @@ -26,8 +26,8 @@ import { } from './catalog.js'; export const CREATIVE33_ROUTE = CREATIVE33_MCP_ROUTE; -export const CREATIVE33_WIRE_VERSION = '3.3-beta.0'; -export const CREATIVE33_BUNDLE_VERSION = '3.3.0-beta.0'; +export const CREATIVE33_WIRE_VERSION = '3.3-beta.1'; +export const CREATIVE33_BUNDLE_VERSION = '3.3.0-beta.1'; const NAMESPACE = 'adcp-training-agent:creative33'; const logger = createLogger('training-agent-creative33'); const TOOLS = new Set([ diff --git a/server/src/training-agent/task-handlers.ts b/server/src/training-agent/task-handlers.ts index de86c307276..38402f8468f 100644 --- a/server/src/training-agent/task-handlers.ts +++ b/server/src/training-agent/task-handlers.ts @@ -3302,7 +3302,7 @@ import { const SUPPORTED_MAJOR_VERSIONS = [3] as const; const SUPPORTED_RELEASE_VERSIONS = TRAINING_AGENT_SUPPORTED_RELEASE_VERSIONS; const DEFAULT_ADCP_VERSION = TRAINING_AGENT_DEFAULT_ADCP_VERSION; -const CORE_GENDER_CANDIDATE_VERSION = '3.3-beta.0'; +const CORE_GENDER_CANDIDATE_VERSION = '3.3-beta.1'; export const TRAINING_ACCEPTANCE_POLICY_CATALOG_PATH = '/registry/acceptance-policy-catalog.json'; export const TRAINING_ACCEPTANCE_POLICY_CATALOG_DIGEST = 'sha256:3afb3865dbd69025b4f925c5c018c7659fa0a744efcb0b12b87e1b3a119b3d2a'; export const TRAINING_ACCEPTANCE_POLICY_DEFAULT_PROFILE = 'meta_political_advertising_acceptance'; diff --git a/server/tests/unit/storyboard-cache.test.ts b/server/tests/unit/storyboard-cache.test.ts index 066e193768c..6bb54aaa68c 100644 --- a/server/tests/unit/storyboard-cache.test.ts +++ b/server/tests/unit/storyboard-cache.test.ts @@ -15,7 +15,7 @@ describe('compliance storyboard cache', () => { }); it('parses a bundle once and serves every ID from it', () => { - const options = { version: '3.3.0-beta.0', complianceDir: '/bundles/3.3' }; + const options = { version: '3.3.0-beta.1', complianceDir: '/bundles/3.3' }; expect(getCachedComplianceStoryboardById('a', options)?.id).toBe('a'); expect(getCachedComplianceStoryboardById('b', { ...options, unrelatedRunOption: true } as never)?.id).toBe('b'); expect(getCachedComplianceStoryboardById('missing', options)).toBeUndefined(); @@ -30,7 +30,7 @@ describe('compliance storyboard cache', () => { it('keeps bundles for different versions or directories apart', () => { getCachedComplianceStoryboardById('a', { version: '3.2', complianceDir: '/x' }); - getCachedComplianceStoryboardById('a', { version: '3.3.0-beta.0', complianceDir: '/x' }); + getCachedComplianceStoryboardById('a', { version: '3.3.0-beta.1', complianceDir: '/x' }); getCachedComplianceStoryboardById('a', { version: '3.2', complianceDir: '/y' }); getCachedComplianceStoryboardById('a', { version: '3.2', complianceDir: '/y', hostedStableLineAlias: '3.2' }); expect(list).toHaveBeenCalledTimes(4); diff --git a/server/tests/unit/training-agent-candidate-version.test.ts b/server/tests/unit/training-agent-candidate-version.test.ts index d8dbf1289c7..825663e2611 100644 --- a/server/tests/unit/training-agent-candidate-version.test.ts +++ b/server/tests/unit/training-agent-candidate-version.test.ts @@ -9,7 +9,7 @@ import { storyboardStepStatus } from '../manual/storyboard-report-format.js'; vi.hoisted(() => { process.env.ADCP_STORYBOARD_CANDIDATE_VERSION_MODE = '1'; - process.env.ADCP_TRAINING_CANDIDATE_VERSION = '3.3-beta.0'; + process.env.ADCP_TRAINING_CANDIDATE_VERSION = '3.3-beta.1'; process.env.PUBLIC_TEST_AGENT_TOKEN = 'candidate-version-test-token'; }); @@ -35,8 +35,8 @@ describe('local candidate wire contract', () => { } const indexPath = path.join(schemaRoot, 'index.json'); const index = JSON.parse(readFileSync(indexPath, 'utf8')); - writeFileSync(indexPath, JSON.stringify({ ...index, adcp_version: '3.3.0-beta.0' })); - registerExternalSchemaRoot('3.3.0-beta.0', schemaRoot); + writeFileSync(indexPath, JSON.stringify({ ...index, adcp_version: '3.3.0-beta.1' })); + registerExternalSchemaRoot('3.3.0-beta.1', schemaRoot); const { createTrainingAgentRouter } = await import('../../src/training-agent/index.js'); const app = express(); app.use(express.json({ verify: (req, _res, body) => { @@ -56,13 +56,13 @@ describe('local candidate wire contract', () => { server.closeAllConnections(); await new Promise(resolve => server.close(() => resolve())); } - unregisterExternalSchemaRoot('3.3.0-beta.0'); + unregisterExternalSchemaRoot('3.3.0-beta.1'); if (schemaRoot) rmSync(schemaRoot, { recursive: true, force: true }); }); it('requires the test runtime and both trusted candidate settings', () => { - const config = { NODE_ENV: 'test', ADCP_STORYBOARD_CANDIDATE_VERSION_MODE: '1', ADCP_TRAINING_CANDIDATE_VERSION: '3.3-beta.0' }; - expect(trainingAgentCandidateVersion(config)).toBe('3.3-beta.0'); + const config = { NODE_ENV: 'test', ADCP_STORYBOARD_CANDIDATE_VERSION_MODE: '1', ADCP_TRAINING_CANDIDATE_VERSION: '3.3-beta.1' }; + expect(trainingAgentCandidateVersion(config)).toBe('3.3-beta.1'); for (const NODE_ENV of ['production', 'development', undefined]) { expect(trainingAgentCandidateVersion({ ...config, NODE_ENV })).toBeUndefined(); } @@ -73,7 +73,7 @@ describe('local candidate wire contract', () => { }); it.each(['brand', 'sales'])('negotiates real candidate and explicit stable requests through /%s/mcp', async tenant => { - for (const adcp_version of ['3.3-beta.0', '3.2', undefined]) { + for (const adcp_version of ['3.3-beta.1', '3.2', undefined]) { const response = await fetch(`${baseUrl}/${tenant}/mcp`, { method: 'POST', headers: { 'content-type': 'application/json', accept: 'application/json, text/event-stream', authorization: 'Bearer candidate-version-test-token' }, @@ -85,10 +85,10 @@ describe('local candidate wire contract', () => { expect(result.adcp_error, JSON.stringify(result)).toBeUndefined(); expect(result.adcp_version).toBe(adcp_version ?? '3.2'); expect(result.adcp.supported_versions).toContain('3.2'); - expect(result.adcp.supported_versions.filter((version: string) => version === '3.3-beta.0')).toHaveLength(1); + expect(result.adcp.supported_versions.filter((version: string) => version === '3.3-beta.1')).toHaveLength(1); expect(result.experimental_features ?? []).not.toContain('media_buy.gender_targeting'); if (tenant === 'sales') { - if (adcp_version === '3.3-beta.0') expect(result.specialisms).toContain('sales-fixed-rate'); + if (adcp_version === '3.3-beta.1') expect(result.specialisms).toContain('sales-fixed-rate'); else expect(result.specialisms).not.toContain('sales-fixed-rate'); expect(result.compliance_testing.scenarios).toContain('force_media_buy_confirmation'); } @@ -98,11 +98,11 @@ describe('local candidate wire contract', () => { it('keeps gender preview opt-in independent and candidate versions unique with both flags', async () => { const preview = createTrainingAgentServer({ mode: 'open', developmentCoreGender: true }); const handler = (preview as unknown as { _requestHandlers: Map })._requestHandlers.get('tools/call')!; - for (const adcp_version of ['3.3-beta.0', '3.2']) { + for (const adcp_version of ['3.3-beta.1', '3.2']) { const response = await handler({ method: 'tools/call', params: { name: 'get_adcp_capabilities', arguments: { adcp_version } } }, {}); const result = response.structuredContent; - expect(result.adcp.supported_versions.filter((version: string) => version === '3.3-beta.0')).toHaveLength(1); - if (adcp_version === '3.3-beta.0') expect(result.experimental_features ?? []).toContain('media_buy.gender_targeting'); + expect(result.adcp.supported_versions.filter((version: string) => version === '3.3-beta.1')).toHaveLength(1); + if (adcp_version === '3.3-beta.1') expect(result.experimental_features ?? []).toContain('media_buy.gender_targeting'); else expect(result.experimental_features ?? []).not.toContain('media_buy.gender_targeting'); } await preview.close(); @@ -114,10 +114,10 @@ describe('local candidate wire contract', () => { const response = await fetch(`${baseUrl}/mcp`, { method: 'POST', headers: { 'content-type': 'application/json', accept: 'application/json, text/event-stream', authorization: 'Bearer candidate-version-test-token' }, - body: JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'tools/call', params: { name: 'get_adcp_capabilities', arguments: { adcp_version: '3.3-beta.0' } } }), + body: JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'tools/call', params: { name: 'get_adcp_capabilities', arguments: { adcp_version: '3.3-beta.1' } } }), }); const result = (await response.json()).result?.structuredContent; - expect(result?.adcp_version, JSON.stringify(result).slice(0, 300)).toBe('3.3-beta.0'); + expect(result?.adcp_version, JSON.stringify(result).slice(0, 300)).toBe('3.3-beta.1'); expect(result.account).toBeDefined(); expect(result.account).not.toHaveProperty('stable_account_id'); }); @@ -126,17 +126,17 @@ describe('local candidate wire contract', () => { const legacy = createTrainingAgentServer({ mode: 'open', strict: true, legacySigningProfile: true }); const handler = (legacy as unknown as { _requestHandlers: Map })._requestHandlers.get('tools/call')!; const response = await handler({ method: 'tools/call', params: { - name: 'get_adcp_capabilities', arguments: { adcp_version: '3.3-beta.0' }, + name: 'get_adcp_capabilities', arguments: { adcp_version: '3.3-beta.1' }, } }, {}); expect(response.structuredContent.adcp_error.code).toBe('VERSION_UNSUPPORTED'); - expect(response.structuredContent.adcp_error.details.supported_versions).not.toContain('3.3-beta.0'); + expect(response.structuredContent.adcp_error.details.supported_versions).not.toContain('3.3-beta.1'); await legacy.close(); }); it('reports real SDK advisory findings without overriding its blocking validation verdict', async () => { const storyboard = loadStoryboardFile(path.resolve('static/compliance/source/universal/capability-discovery.yaml')); const options = { - adcpVersion: '3.3.0-beta.0', wireAdcpVersion: '3.3-beta.0', schemaRoot, + adcpVersion: '3.3.0-beta.1', wireAdcpVersion: '3.3-beta.1', schemaRoot, auth: { type: 'bearer' as const, token: 'candidate-version-test-token' }, allow_http: true, }; const advisory = await runStoryboardStep(`${baseUrl}/sales/mcp`, storyboard, 'get_capabilities', options); @@ -173,8 +173,8 @@ describe('local candidate wire contract', () => { return result; }; const account = { brand: { domain: 'candidate-three-three.example' }, operator: 'candidate-three-three.example', sandbox: true }; - for (const adcp_version of ['3.3-beta.0', '3.2']) { - const current = adcp_version === '3.3-beta.0'; + for (const adcp_version of ['3.3-beta.1', '3.2']) { + const current = adcp_version === '3.3-beta.1'; const sales = await call('sales', 'get_adcp_capabilities', { adcp_version }); expect(sales.account.stable_account_id).toBe(current ? true : undefined); expect(sales.media_buy.features.supports_property_breakdown).toBe(current ? true : undefined); diff --git a/server/tests/unit/training-agent-creative-start-policy.test.ts b/server/tests/unit/training-agent-creative-start-policy.test.ts index ad1884dc54a..b51d06ba385 100644 --- a/server/tests/unit/training-agent-creative-start-policy.test.ts +++ b/server/tests/unit/training-agent-creative-start-policy.test.ts @@ -24,7 +24,7 @@ import type { ToolArgs, TrainingContext } from '../../src/training-agent/types.j const FIELD = 'start_requires_all_creatives_approved'; const ACCOUNT = { brand: { domain: 'nova-start-policy.example' }, operator: 'pinnacle-agency.example', sandbox: true }; const BRAND = { domain: 'nova-start-policy.example' }; -const CANDIDATE_CTX: TrainingContext = { mode: 'open', servedAdcpVersion: '3.3-beta.0' }; +const CANDIDATE_CTX: TrainingContext = { mode: 'open', servedAdcpVersion: '3.3-beta.1' }; const STABLE_CTX: TrainingContext = { mode: 'open', servedAdcpVersion: '3.2' }; const PRODUCT = { product_id: 'start_policy_display', pricing_option_id: 'fixed_cpm' }; type Result = Record; diff --git a/server/tests/unit/training-agent-creative33-buyer.test.ts b/server/tests/unit/training-agent-creative33-buyer.test.ts index 6e14420bb28..9e4e942244c 100644 --- a/server/tests/unit/training-agent-creative33-buyer.test.ts +++ b/server/tests/unit/training-agent-creative33-buyer.test.ts @@ -37,7 +37,7 @@ describe('published SDK buyer journeys on the frozen creative 3.3 beta', () => { await new Promise(resolve => server.once('listening', resolve)); base = `http://127.0.0.1:${(server.address() as { port: number }).port}`; agent = ADCPMultiAgentClient.simple(`${base}/beta/3.3/creative/mcp`, { - authToken: 'buyer-flow-test', adcpVersion: '3.3.0-beta.0', wireAdcpVersion: '3.3-beta.0', timeout: 15000, + authToken: 'buyer-flow-test', adcpVersion: '3.3.0-beta.1', wireAdcpVersion: '3.3-beta.1', timeout: 15000, }).agent('default-agent'); }); afterAll(async () => { @@ -60,7 +60,7 @@ describe('published SDK buyer journeys on the frozen creative 3.3 beta', () => { it('discovers the frozen contract', async () => { const discovered = data(await agent.getAdcpCapabilities({})); - expect(discovered).toMatchObject({ adcp_version: '3.3-beta.0', adcp: { supported_versions: ['3.3-beta.0'] } }); + expect(discovered).toMatchObject({ adcp_version: '3.3-beta.1', adcp: { supported_versions: ['3.3-beta.1'] } }); const formats = object(discovered.creative).supported_formats as Json[]; expect(formats.find(value => value.capability_id === capabilityId)).toMatchObject({ format: { format_kind: kind }, operations: expect.arrayContaining(['build', 'preview']) }); }); diff --git a/server/tests/unit/training-agent-creative33-routing.test.ts b/server/tests/unit/training-agent-creative33-routing.test.ts index 6a32ffa601f..c21b4887823 100644 --- a/server/tests/unit/training-agent-creative33-routing.test.ts +++ b/server/tests/unit/training-agent-creative33-routing.test.ts @@ -11,7 +11,7 @@ import { } from '../../src/training-agent/creative33/router.js'; const PATH = '/beta/3.3/creative/mcp'; -const VERSION = '3.3-beta.0'; +const VERSION = '3.3-beta.1'; const ACCOUNT = { account_id: 'creative33_sandbox' }; const PRINCIPALS: Record = { 'buyer-a': 'test:creative33:buyer-a', @@ -276,7 +276,7 @@ describe('creative 3.3 beta route security boundaries', () => { } }); - it.each(['3.2', '3.3', '3.3-beta.1', '3.3.0-beta.0', '../latest'])('refuses version %s without persisting', async version => { + it.each(['3.2', '3.3', '3.3-beta.0', '3.3.0-beta.1', '../latest'])('refuses version %s without persisting', async version => { const app = boot(); const id = `wrong_version_${randomUUID()}`; const response = await sync(app, creative(id), 'buyer-a', randomUUID(), { adcp_version: version }); diff --git a/server/tests/unit/training-agent-creators.test.ts b/server/tests/unit/training-agent-creators.test.ts index fd5e95474bb..b9efcfba7b5 100644 --- a/server/tests/unit/training-agent-creators.test.ts +++ b/server/tests/unit/training-agent-creators.test.ts @@ -7,7 +7,7 @@ import { beforeEach, describe, expect, it, vi } from 'vitest'; // candidate wire contract. vi.hoisted(() => { process.env.ADCP_STORYBOARD_CANDIDATE_VERSION_MODE = '1'; - process.env.ADCP_TRAINING_CANDIDATE_VERSION = '3.3-beta.0'; + process.env.ADCP_TRAINING_CANDIDATE_VERSION = '3.3-beta.1'; }); import type { CanonicalProposal } from '@adcp/sdk'; import { CREATOR_PUBLISHER } from '../../src/training-agent/creators.js'; @@ -191,7 +191,7 @@ describe('CreatorLoop compact lifecycle', () => { // material deadlines at all — the slot only existed on get_products. it('surfaces slot dates and material deadlines on the canonical product, not only on get_products', async () => { const result = await executeTrainingAgentTool('list_products', { - adcp_version: '3.3-beta.0', + adcp_version: '3.3-beta.1', account: { brand: { domain: 'buyer.example' }, operator: 'buyer.example' }, criteria: { product_ids: creatorProducts().map(product => product.product_id as string) }, }, context); @@ -221,7 +221,7 @@ describe('CreatorLoop compact lifecycle', () => { it('keeps the legacy and canonical slot sets identical apart from the dropped shorthand', async () => { const legacy = creatorProducts(); const result = await executeTrainingAgentTool('list_products', { - adcp_version: '3.3-beta.0', + adcp_version: '3.3-beta.1', account: { brand: { domain: 'buyer.example' }, operator: 'buyer.example' }, criteria: { product_ids: legacy.map(product => product.product_id as string) }, }, context); diff --git a/server/tests/unit/training-agent-gender-targeting.test.ts b/server/tests/unit/training-agent-gender-targeting.test.ts index e689c0a9bc8..01cca78a006 100644 --- a/server/tests/unit/training-agent-gender-targeting.test.ts +++ b/server/tests/unit/training-agent-gender-targeting.test.ts @@ -4,7 +4,7 @@ import { createTrainingAgentServer, clearTaskStore, invalidateCache } from '../. import { clearSessions } from '../../src/training-agent/state.js'; import { clearIdempotencyCache } from '../../src/training-agent/idempotency.js'; import { validateSourceSchema } from '../../src/training-agent/source-schema.js'; -const CANDIDATE_VERSION = '3.3-beta.0'; +const CANDIDATE_VERSION = '3.3-beta.1'; const account = { brand: { domain: 'acmeoutdoor.example' }, operator: 'pinnacle-agency.example', sandbox: true }; const age = { min: 18, max: 55, include_unknown: false }; diff --git a/server/tests/unit/training-agent-list-products-canonical.test.ts b/server/tests/unit/training-agent-list-products-canonical.test.ts index a0f20c8a806..1f798088366 100644 --- a/server/tests/unit/training-agent-list-products-canonical.test.ts +++ b/server/tests/unit/training-agent-list-products-canonical.test.ts @@ -5,7 +5,7 @@ import { describe, it, expect, beforeEach, vi } from 'vitest'; // contract is the only way the training agent serves 3.3. vi.hoisted(() => { process.env.ADCP_STORYBOARD_CANDIDATE_VERSION_MODE = '1'; - process.env.ADCP_TRAINING_CANDIDATE_VERSION = '3.3-beta.0'; + process.env.ADCP_TRAINING_CANDIDATE_VERSION = '3.3-beta.1'; }); import { @@ -29,7 +29,7 @@ import { TRAINING_AGENT_CURRENT_ADCP_VERSION, type TrainingContext } from '../.. // project onto core/canonical-installment.json, which drops the legacy // deprecated collection_id shorthand and requires collection_ref. -const THREE_THREE_VERSION = '3.3-beta.0'; +const THREE_THREE_VERSION = '3.3-beta.1'; const DEFAULT_CTX: TrainingContext = { mode: 'open' }; const ACCOUNT = { brand: { domain: 'acmeoutdoor.example' }, operator: 'pinnacle-agency.example', sandbox: true }; diff --git a/server/tests/unit/training-agent-package-forecast.test.ts b/server/tests/unit/training-agent-package-forecast.test.ts index 756d0d2a105..cfc5c14a1aa 100644 --- a/server/tests/unit/training-agent-package-forecast.test.ts +++ b/server/tests/unit/training-agent-package-forecast.test.ts @@ -3,7 +3,7 @@ import { beforeEach, describe, expect, it, vi } from 'vitest'; vi.hoisted(() => { process.env.ADCP_STORYBOARD_CANDIDATE_VERSION_MODE = '1'; - process.env.ADCP_TRAINING_CANDIDATE_VERSION = '3.3-beta.0'; + process.env.ADCP_TRAINING_CANDIDATE_VERSION = '3.3-beta.1'; }); import { @@ -27,7 +27,7 @@ const PRODUCT_ID = 'streamhaus_forecast_product'; const call = (toolName: string, args: Record) => runWithSessionContext(async () => { const result = await executeTrainingAgentTool(toolName, { - adcp_version: '3.3-beta.0', + adcp_version: '3.3-beta.1', idempotency_key: randomUUID(), account: ACCOUNT, ...args, @@ -84,7 +84,7 @@ describe('structured package forecasts on the reference training agent', () => { products: Array>; refinement_applied: Array>; }; - expect(data.adcp_version).toBe('3.3-beta.0'); + expect(data.adcp_version).toBe('3.3-beta.1'); expect(data.refinement_applied).toEqual([{ scope: 'product', product_id: PRODUCT_ID, status: 'unable', notes: expect.stringMatching(/\S/), }]); diff --git a/server/tests/unit/training-agent-seller-managed-event-sources.test.ts b/server/tests/unit/training-agent-seller-managed-event-sources.test.ts index 054dc0c5b76..001f35cc2cc 100644 --- a/server/tests/unit/training-agent-seller-managed-event-sources.test.ts +++ b/server/tests/unit/training-agent-seller-managed-event-sources.test.ts @@ -6,7 +6,7 @@ import crypto from 'node:crypto'; // contract. A 3.2 caller gets `seller_id` alone (#8487). vi.hoisted(() => { process.env.ADCP_STORYBOARD_CANDIDATE_VERSION_MODE = '1'; - process.env.ADCP_TRAINING_CANDIDATE_VERSION = '3.3-beta.0'; + process.env.ADCP_TRAINING_CANDIDATE_VERSION = '3.3-beta.1'; }); import { createTrainingAgentServer, @@ -45,7 +45,7 @@ async function callTool( const handler = requestHandlers.get('tools/call'); if (!handler) throw new Error('CallTool handler not found'); const response = await handler( - { method: 'tools/call', params: { name: toolName, arguments: withIdempotencyKey(toolName, { adcp_version: '3.3-beta.0', ...args }) } }, + { method: 'tools/call', params: { name: toolName, arguments: withIdempotencyKey(toolName, { adcp_version: '3.3-beta.1', ...args }) } }, {}, ); const text = response.content?.[0]?.text; diff --git a/server/tests/unit/training-agent-served-release-fields.test.ts b/server/tests/unit/training-agent-served-release-fields.test.ts index 528e41afa54..358a7a3ebcb 100644 --- a/server/tests/unit/training-agent-served-release-fields.test.ts +++ b/server/tests/unit/training-agent-served-release-fields.test.ts @@ -17,7 +17,7 @@ describe('served-release field gate (#8487)', () => { { properties?: Record; additionalProperties?: unknown } | undefined; expect(threeTwo?.additionalProperties).toBe(false); for (const field of withheld) expect(threeTwo?.properties, field).not.toHaveProperty(field); - expect(propertiesAddedAfterRelease('core/canonical-product.json', '3.3-beta.0')).toEqual(new Set()); + expect(propertiesAddedAfterRelease('core/canonical-product.json', '3.3-beta.1')).toEqual(new Set()); }); it('finds 3.3 fields under objects 3.2 leaves open, and leaves undeclared keys alone', () => { @@ -36,7 +36,7 @@ describe('served-release field gate (#8487)', () => { '/media_buy/vendor_metric_optimization/supported_metrics', ]); // Same release line, whatever the prerelease checkpoint. - expect(fieldsAddedAfterRelease(capabilities, CAPABILITIES, '3.3-beta.0')).toEqual([]); + expect(fieldsAddedAfterRelease(capabilities, CAPABILITIES, '3.3-beta.1')).toEqual([]); // A 3.2 field is newer than 3.1. expect(fieldsAddedAfterRelease({ media_buy: { anonymous_discovery: true } }, CAPABILITIES, '3.1')) .toEqual(['/media_buy/anonymous_discovery']); @@ -55,7 +55,7 @@ describe('served-release field gate (#8487)', () => { expect(servedReleaseEnum('enums/specialism.json', '3.1')).not.toContain('sales-dooh'); expect(servedReleaseEnum('enums/specialism.json', '3.2')).toContain('sales-dooh'); expect(servedReleaseEnum('enums/specialism.json', '3.2')).not.toContain('sales-fixed-rate'); - expect(servedReleaseEnum('enums/specialism.json', '3.3-beta.0')).toContain('sales-fixed-rate'); + expect(servedReleaseEnum('enums/specialism.json', '3.3-beta.1')).toContain('sales-fixed-rate'); // A prerelease pin the SDK ships no bundle for reads its release line. expect(servedReleaseEnum('enums/specialism.json', '3.1-rc.15')).toEqual(servedReleaseEnum('enums/specialism.json', '3.1')); expect(servedReleaseEnum('enums/specialism.json', '3.2-rc.0')).not.toContain('sales-fixed-rate'); diff --git a/server/tests/unit/training-agent.test.ts b/server/tests/unit/training-agent.test.ts index e6fbebfbe12..7ea8cc80e2b 100644 --- a/server/tests/unit/training-agent.test.ts +++ b/server/tests/unit/training-agent.test.ts @@ -1833,7 +1833,7 @@ describe('createTrainingAgentServer', () => { it('keeps the seller-level vendor_metric_optimization.supported_metrics rollup consistent with the catalog', async () => { // The rollup is a 3.3 field (#8070), served only on a 3.3 response (#8487). - const result = await handleGetAdcpCapabilities({}, { ...DEFAULT_CTX, servedAdcpVersion: '3.3-beta.0' }); + const result = await handleGetAdcpCapabilities({}, { ...DEFAULT_CTX, servedAdcpVersion: '3.3-beta.1' }); const rollup = ((result as Record).media_buy.vendor_metric_optimization.supported_metrics) as Array<{ vendor: { domain: string; brand_id?: string }; metric_id: string; From 77e0063a5ca566acce3e1108e5af29e84980ebed Mon Sep 17 00:00:00 2001 From: Brian O'Kelley Date: Fri, 30 Oct 2026 00:14:41 +0000 Subject: [PATCH 2/2] docs(sdk): point the 17 migration note at the 3.3-beta.1 pin Co-Authored-By: Claude Sonnet 5.5 --- docs/building/by-layer/L4/choose-your-sdk.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/building/by-layer/L4/choose-your-sdk.mdx b/docs/building/by-layer/L4/choose-your-sdk.mdx index efbdff7ef98..79dfac2ae35 100644 --- a/docs/building/by-layer/L4/choose-your-sdk.mdx +++ b/docs/building/by-layer/L4/choose-your-sdk.mdx @@ -45,14 +45,14 @@ Production stays on the 3.2 line and the packages above. For development and sta |---|---|---|---|---| | **`@adcp/sdk`** (TypeScript) | `17.0.0-beta.6` (npm `beta` dist-tag) | Signed `3.3.0-beta.1` only (beta.5 dropped `3.3-beta.0`; a beta.0 peer negotiates stable 3.2.7); also bundles stable 3.2.7, 3.1.29 and 3.0.25 | Buyer client and seller server, MCP and A2A | Identity and Web Bot Auth (`@adcp/sdk/identity-3.3`) remain experimental opt-ins. The standalone commercial-terms verifier fails closed on 3.3 definition pins; keep snapshot verification on the stable 3.2.7 contract. Reliable Reporting storage needs `@adcp/reporting-storage@0.3.0-beta.1`. | -No Python or Go package is listed for beta.0 yet. Until a row here names one, treat that SDK's 3.3 types and validators as unavailable. +No Python or Go package is listed for the 3.3 beta.1 preview yet. Until a row here names one, treat that SDK's 3.3 types and validators as unavailable. ```bash npm install @adcp/sdk@17.0.0-beta.6 node -p "require('@adcp/sdk').ADCP_VERSION" # 3.3.0-beta.1 ``` -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 `3.3-beta.0` in `supported_versions` before an SDK 17 buyer sends that pin. +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 `3.3-beta.1` in `supported_versions` before an SDK 17 buyer sends that pin. Integrations that stay on 3.1 keep using the 3.1 lines: `@adcp/sdk` 13.x (npm `adcp-3.1` dist-tag) and `adcp` 7.x. The [SDK version map](/docs/reference/migration/3-1-to-3-2#sdk-versions-for-3-2) lists the 3.1 and 3.2 line for each language and each SDK's upgrade guide.