@adcp/sdk 16.0.0-beta.7 → 16.0.0-beta.9

package/AGENTS.md

@@ -19,7 +19,7 @@ This document contains essential guidelines for AI coding assistants (Claude, Co
 
 **Testing an agent for conformance?** — Read `docs/guides/CONFORMANCE.md` and call `runConformance(agentUrl, opts)` from `@adcp/sdk/conformance`. Property-based fuzzing against the bundled JSON schemas; stateless tier covers 11 discovery tools across every protocol.
 
-**Migration guides** — [Account change feed](docs/migration-account-change-feed.md) (wake-up parsing, guarded bootstrap/drain, subscriber registration and ownership boundaries); `docs/migration-6.6-to-6.7.md` (fifteen adopter recipes; two breaking changes — `'implicit'` enforces inline-`account_id` refusal and `SalesPlatform` split into `SalesCorePlatform & SalesIngestionPlatform`; plus `definePlatform` helpers, `composeMethod`, `accounts.resolve` security presets, `accounts.upsert/list/syncGovernance(ctx)`, typed errors, `issues[].hint`, `BuyerAgentRegistry`, `createTenantRegistry`, `createOAuthPassthroughResolver`, `createRosterAccountStore`, `createTenantStore` w/ built-in tenant gate, `MEDIA_BUY_TRANSITIONS` lifecycle helpers, `createMediaBuyStore` for `targeting_overlay` echo, `NoAccountCtx` narrow, `refAccountId(ref)`); `docs/migration-5.x-to-6.x.md` (5 → 6 framework shape); `docs/migration-4.x-to-5.x.md` (4 → 5); `docs/migration-buyer-agent-registry.md` (registry deep-dive).
+**Migration guides** — [AdCP 2 retirement](docs/migration-drop-adcp-2.md) (AdCP 3-only discovery, removed compatibility APIs, and last supporting SDK pins); [Account change feed](docs/migration-account-change-feed.md) (wake-up parsing, guarded bootstrap/drain, subscriber registration and ownership boundaries); `docs/migration-6.6-to-6.7.md` (fifteen adopter recipes; two breaking changes — `'implicit'` enforces inline-`account_id` refusal and `SalesPlatform` split into `SalesCorePlatform & SalesIngestionPlatform`; plus `definePlatform` helpers, `composeMethod`, `accounts.resolve` security presets, `accounts.upsert/list/syncGovernance(ctx)`, typed errors, `issues[].hint`, `BuyerAgentRegistry`, `createTenantRegistry`, `createOAuthPassthroughResolver`, `createRosterAccountStore`, `createTenantStore` w/ built-in tenant gate, `MEDIA_BUY_TRANSITIONS` lifecycle helpers, `createMediaBuyStore` for `targeting_overlay` echo, `NoAccountCtx` narrow, `refAccountId(ref)`); `docs/migration-5.x-to-6.x.md` (5 → 6 framework shape); `docs/migration-4.x-to-5.x.md` (4 → 5); `docs/migration-buyer-agent-registry.md` (registry deep-dive).
 
 **Putting credentials in `ctx_metadata`?** — Don't. Read `docs/guides/CTX-METADATA-SAFETY.md` — wire-strip protects buyer responses but not log lines / error envelopes / heap dumps / adopter strings. Re-derive bearers per request; embed only non-secret upstream IDs.
 
@@ -263,7 +263,7 @@ npm run generate-zod-schemas  # Generate runtime validation
 
 ### Wire-version compat (v3 SDK ↔ legacy sellers)
 
-The SDK speaks one AdCP major (`ADCP_VERSION` in `src/lib/version.ts`, currently `3.2.5`) on its public surface and adapts to legacy sellers underneath. v2.5 is the only active legacy shim; the recipe for adding a new one (e.g. v3 when the SDK pin moves to v4) lives in [`docs/development/WIRE-VERSION-COMPAT.md`](https://github.com/adcontextprotocol/adcp-client/blob/main/docs/development/WIRE-VERSION-COMPAT.md). Touch that doc whenever you add to `src/lib/adapters/legacy/`, `src/lib/types/v*-*/`, or `schemas/cache/<version>/`.
+The SDK speaks one AdCP major (`ADCP_VERSION` in `src/lib/version.ts`, currently `3.2.5`) on its public surface and adapts to legacy sellers underneath. AdCP 2 support has been removed following its August 1, 2026 end of life. Maintained AdCP 3 compatibility and the policy for future major-version support are documented in [`docs/development/WIRE-VERSION-COMPAT.md`](https://github.com/adcontextprotocol/adcp-client/blob/main/docs/development/WIRE-VERSION-COMPAT.md). Touch that doc whenever you add to `src/lib/adapters/legacy/`, `src/lib/types/v*-*/`, or `schemas/cache/<version>/`.
 
 ## Testing Strategies
 
@@ -317,7 +317,7 @@ The pattern:
 
 - `normalizeRequestParams()` runs before validation, filling in derivable fields
 - `validateRequest()` runs Zod schemas after normalization
-- `adaptRequestForServerVersion()` handles v3→v2 downgrades for older servers
+- `adaptRequestForServerVersion()` adapts requests to maintained AdCP 3 releases; AdCP 2 targets are rejected
 
 **Never add a required field without a backwards-compatible default or inference path.**
 

package/README.md

@@ -34,6 +34,8 @@ npm install @adcp/sdk@adcp-3.1     # 13.x, maintained AdCP 3.1 line
 npm install @adcp/sdk@adcp-3.0     # 7.11.x, AdCP 3.0
 ```
 
+AdCP 2 reached end of life on August 1, 2026. This checkout supports AdCP 3 agents only; review the [AdCP 2 retirement guide](./docs/migration-drop-adcp-2.md) before upgrading an integration that still calls AdCP 2 sellers.
+
 Upgrading to SDK 14? Read the [release-bound upgrade worksheet](./docs/migration-14.x-rc-worksheet.md), then use the [13-to-14](./docs/migration-13-to-14.md) or [12-to-14](./docs/migration-12-to-14.md) migration guide. The [prerelease history](./docs/releases/14.0.0-beta.0.md) covers changes made during the 14.0 beta cycle. The npm `latest` tag tracks SDK 14 (AdCP 3.2); SDK 13 stays available on `adcp-3.1` as the maintained AdCP 3.1 line. SDK 14 requires Node.js `^20.19.0 || >=22.12.0`. Older paths: [12-to-13](./docs/migration-12-to-13.md), **[MIGRATION-v8.md](./MIGRATION-v8.md)**, and [8.0-to-8.1](./docs/migration-8.0-to-8.1.md).
 
 ### Narrow type imports (`@adcp/sdk/types/<tool>`)
@@ -103,6 +105,7 @@ Start with the persona guide that matches your job:
 - [Build a seller](./docs/guides/SELLER-QUICKSTART-3.2.md)
 - [Call a seller](./docs/guides/BUYER-QUICKSTART-3.2.md)
 - [Adopt the account change feed](./docs/migration-account-change-feed.md)
+- [Upgrade an integration that still uses AdCP 2](./docs/migration-drop-adcp-2.md)
 - [Upgrade from SDK 13](./docs/migration-13-to-14.md)
 - [Add AdCP to an existing platform](./docs/guides/EXISTING-PLATFORM.md)
 - [Run in production](./docs/guides/PRODUCTION-DURABILITY.md)
@@ -808,6 +811,23 @@ Build a registry service that:
 
 Library provides discovery logic - you add persistence layer.
 
+### Property catalog registration and errors
+
+For bulk property catalog registration, use `RegistryClient.resolveIdentifiersAll()`
+in default `resolve` mode (requires an API key and provenance); use `mode: 'lookup'`
+for read-only resolution. It splits by count and request bytes, bounds concurrency,
+honors rate-limit retry delays, and returns per-input outcomes. `saveProperty()`
+updates hosted publisher configuration; `saveProperties()` fans out those updates
+and is intended for one configuration per publisher domain. Both validate
+`publisher_domain` before HTTP. See [the property-list guide](docs/guides/PROPERTY-LISTS.md)
+for identifier validators, mixed app/CTV matching, MCP list serving, signed change
+notifications, and certification.
+
+Registry HTTP errors use `RegistryRequestError` / `isRegistryRequestError` with
+`status`, `method`, `retryAfterMs`, and bounded untrusted `details`. Do not parse
+`error.message` for HTTP status or retry timing. Local identifier validation uses
+`IdentifierValidationError`; bulk resolve failures are available in each outcome.
+
 ### Brand relationship verification
 
 Use `RegistryClient.lookupBrand()` to resolve a domain and verify its relationship to a house. The public v3 registry does not expose an ordered-chain endpoint; v3 hierarchy is one level deep.

package/bin/adcp.js

@@ -2023,7 +2023,6 @@ OPTIONS:
   --wait            Wait for async/webhook responses
   --json            Raw JSON output
   --debug           Debug output
-  --allow-v2        Suppress the v2-sunset warning (unsupported since 2026-04-20)
   --help, -h        Show help
 
 BUILT-IN AGENTS:
@@ -2121,7 +2120,7 @@ RUN OPTIONS (full assessment):
   --media-buy-lifecycle-compat
                       Route compact media-buy storyboard steps through the
                       SDK compatibility coordinator so the same storyboard can
-                      exercise established v2.5–3.2 sellers.
+                      exercise established AdCP 3.0–3.2 sellers.
   --media-buy-compat-losses LOSSES
                       Comma-separated guarantee losses explicitly accepted by
                       that coordinator (for example feed_version_not_atomic).
@@ -4222,7 +4221,7 @@ function printFixtureResolution(records, coverageGaps) {
     const scope = record.product_handle ? `${record.product_handle}/` : '';
     if (record.status === 'resolved') {
       const ids = record.seller_ids || {};
-      const sellerId = ids.pricing_option_id || ids.product_id || '?';
+      const sellerId = ids.pricing_option_id || ids.product_id || ids.capability_id || ids.format_id?.id || '?';
       console.log(`  ✅ ${record.fixture_type} ${scope}${record.handle} → ${sellerId} (${record.strategy})`);
     } else if (record.status === 'unsatisfied') {
       continue;
@@ -5841,6 +5840,12 @@ function formatVerdict(verdict) {
 
 async function main() {
   const args = process.argv.slice(2);
+  if (args.some(arg => arg === '--allow-v2' || arg.startsWith('--allow-v2='))) {
+    console.error(
+      'ERROR: --allow-v2 has been removed. AdCP 2 reached end of life on 2026-08-01; upgrade the agent to AdCP 3. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/migration-drop-adcp-2.md'
+    );
+    process.exit(2);
+  }
   if (args[0] === 'identity') return require('./adcp-identity.js').handleIdentityCommand(args.slice(1));
 
   // `--version` / `-v` is handled before subcommands and before the
@@ -5859,14 +5864,6 @@ async function main() {
   // skipped in CI, non-TTY, --json, and when ADCP_SKIP_VERSION_CHECK=1.
   scheduleVersionCheck(LIBRARY_VERSION);
 
-  // Global: suppress the v2-sunset warning before any subcommand runs.
-  // v2 went unsupported on 2026-04-20 (AdCP 3.0 GA, adcp#2220) — the library
-  // warns whenever an agent advertises v2 capabilities. The flag is for
-  // legacy holdouts who know what they're doing.
-  if (args.includes('--allow-v2')) {
-    process.env.ADCP_ALLOW_V2 = '1';
-  }
-
   // Handle subcommands before global --help so their own --help works
   if (args[0] === 'registry') {
     const code = await handleRegistryCommand(args.slice(1));
@@ -5877,7 +5874,7 @@ async function main() {
   if (args[0] === 'init') {
     const { handleInitCommand } = require('./adcp-project.js');
     await handleInitCommand(
-      args.slice(1).filter(arg => arg !== '--allow-v2' && arg !== '--allow-http'),
+      args.slice(1).filter(arg => arg !== '--allow-http'),
       { libraryVersion: LIBRARY_VERSION }
     );
     return;
@@ -5886,7 +5883,7 @@ async function main() {
   if (args[0] === 'doctor') {
     const { handleDoctorCommand } = require('./adcp-project.js');
     await handleDoctorCommand(
-      args.slice(1).filter(arg => arg !== '--allow-v2' && arg !== '--allow-http'),
+      args.slice(1).filter(arg => arg !== '--allow-http'),
       {
         libraryVersion: LIBRARY_VERSION,
         adcpVersion: ADCP_VERSION,

package/dist/lib/conformance/index.d.mts

@@ -19,6 +19,8 @@
  * ```
  */
 export { runConformance } from './runConformance.mjs';
+export { runPropertyListConformance } from './property-lists.mjs';
+export type { PropertyListConformanceReport } from './property-lists.mjs';
 export { runWebhookConformance } from './webhook.mjs';
 export { seedFixtures } from './seeder.mjs';
 export { TARGETING_GEOGRAPHY_CONFORMANCE_VECTORS, buildTargetingInputConformanceVectors, runTargetingInputConformance, } from './targeting.mjs';

package/dist/lib/conformance/index.d.ts

@@ -19,6 +19,8 @@
  * ```
  */
 export { runConformance } from './runConformance';
+export { runPropertyListConformance } from './property-lists';
+export type { PropertyListConformanceReport } from './property-lists';
 export { runWebhookConformance } from './webhook';
 export { seedFixtures } from './seeder';
 export { TARGETING_GEOGRAPHY_CONFORMANCE_VECTORS, buildTargetingInputConformanceVectors, runTargetingInputConformance, } from './targeting';

package/dist/lib/conformance/index.js

@@ -29,12 +29,14 @@ __export(conformance_exports, {
   UPDATE_TIER_TOOLS: () => import_types.UPDATE_TIER_TOOLS,
   buildTargetingInputConformanceVectors: () => import_targeting.buildTargetingInputConformanceVectors,
   runConformance: () => import_runConformance.runConformance,
+  runPropertyListConformance: () => import_property_lists.runPropertyListConformance,
   runTargetingInputConformance: () => import_targeting.runTargetingInputConformance,
   runWebhookConformance: () => import_webhook.runWebhookConformance,
   seedFixtures: () => import_seeder.seedFixtures
 });
 module.exports = __toCommonJS(conformance_exports);
 var import_runConformance = require('./runConformance.js');
+var import_property_lists = require('./property-lists.js');
 var import_webhook = require('./webhook.js');
 var import_seeder = require('./seeder.js');
 var import_targeting = require('./targeting.js');
@@ -52,6 +54,7 @@ var import_types = require('./types.js');
   UPDATE_TIER_TOOLS,
   buildTargetingInputConformanceVectors,
   runConformance,
+  runPropertyListConformance,
   runTargetingInputConformance,
   runWebhookConformance,
   seedFixtures

package/dist/lib/conformance/index.mjs

@@ -1,4 +1,5 @@
 import { runConformance } from "./runConformance.mjs";
+import { runPropertyListConformance } from "./property-lists.mjs";
 import { runWebhookConformance } from "./webhook.mjs";
 import { seedFixtures } from "./seeder.mjs";
 import {
@@ -28,6 +29,7 @@ export {
   UPDATE_TIER_TOOLS,
   buildTargetingInputConformanceVectors,
   runConformance,
+  runPropertyListConformance,
   runTargetingInputConformance,
   runWebhookConformance,
   seedFixtures

package/dist/lib/conformance/property-lists.d.mts

@@ -0,0 +1,14 @@
+import type { PropertyListReference } from '../types/tools.generated.mjs';
+import { type ResolveListOptions } from '../server/targeting-helpers.mjs';
+export interface PropertyListConformanceReport {
+    totalRuns: number;
+    totalFailures: number;
+    results: Array<{
+        index: number;
+        ok: boolean;
+        identifierCount?: number;
+        code?: string;
+    }>;
+}
+/** Certify buyer-issued references using the same MCP resolver sellers use, with caching disabled. */
+export declare function runPropertyListConformance(references: readonly PropertyListReference[], options?: ResolveListOptions): Promise<PropertyListConformanceReport>;

package/dist/lib/conformance/property-lists.d.ts

@@ -0,0 +1,14 @@
+import type { PropertyListReference } from '../types/tools.generated';
+import { type ResolveListOptions } from '../server/targeting-helpers';
+export interface PropertyListConformanceReport {
+    totalRuns: number;
+    totalFailures: number;
+    results: Array<{
+        index: number;
+        ok: boolean;
+        identifierCount?: number;
+        code?: string;
+    }>;
+}
+/** Certify buyer-issued references using the same MCP resolver sellers use, with caching disabled. */
+export declare function runPropertyListConformance(references: readonly PropertyListReference[], options?: ResolveListOptions): Promise<PropertyListConformanceReport>;

package/dist/lib/conformance/property-lists.js

@@ -0,0 +1,45 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var property_lists_exports = {};
+__export(property_lists_exports, {
+  runPropertyListConformance: () => runPropertyListConformance
+});
+module.exports = __toCommonJS(property_lists_exports);
+var import_targeting_helpers = require('../server/targeting-helpers.js');
+async function runPropertyListConformance(references, options = {}) {
+  const results = [];
+  for (const [index, reference] of references.entries()) {
+    try {
+      const resolved = await (0, import_targeting_helpers.resolvePropertyList)(reference, {
+        ...options,
+        cache: false,
+        strictResponseValidation: true
+      });
+      if (resolved.listId !== reference.list_id) throw new Error("property_list_identity_mismatch");
+      results.push({ index, ok: true, identifierCount: resolved.identifiers.length });
+    } catch {
+      results.push({ index, ok: false, code: "property_list_reference_unresolvable" });
+    }
+  }
+  return { totalRuns: results.length, totalFailures: results.filter((result) => !result.ok).length, results };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  runPropertyListConformance
+});

package/dist/lib/conformance/property-lists.mjs

@@ -0,0 +1,21 @@
+import { resolvePropertyList } from "../server/targeting-helpers.mjs";
+async function runPropertyListConformance(references, options = {}) {
+  const results = [];
+  for (const [index, reference] of references.entries()) {
+    try {
+      const resolved = await resolvePropertyList(reference, {
+        ...options,
+        cache: false,
+        strictResponseValidation: true
+      });
+      if (resolved.listId !== reference.list_id) throw new Error("property_list_identity_mismatch");
+      results.push({ index, ok: true, identifierCount: resolved.identifiers.length });
+    } catch {
+      results.push({ index, ok: false, code: "property_list_reference_unresolvable" });
+    }
+  }
+  return { totalRuns: results.length, totalFailures: results.filter((result) => !result.ok).length, results };
+}
+export {
+  runPropertyListConformance
+};

package/dist/lib/conformance/runConformance.js

@@ -23,6 +23,7 @@ __export(runConformance_exports, {
 });
 module.exports = __toCommonJS(runConformance_exports);
 var import_AgentClient = require('../core/AgentClient.js');
+var import_property_lists = require('./property-lists.js');
 var import_version = require('../version.js');
 var import_types = require('./types.js');
 var import_schemaLoader = require('./schemaLoader.js');
@@ -120,6 +121,23 @@ async function runConformance(agentUrl, options = {}) {
     });
     uniformError.push(report);
   }
+  const propertyLists = options.propertyListReferences ? await (0, import_property_lists.runPropertyListConformance)(options.propertyListReferences) : void 0;
+  for (const result of propertyLists?.results ?? []) {
+    if (result.ok) continue;
+    if (failures.length >= maxFailures) {
+      droppedFailures++;
+      continue;
+    }
+    failures.push({
+      tool: "get_property_list",
+      seed,
+      shrunk: false,
+      input: { propertyListReferenceIndex: result.index },
+      response: null,
+      verdict: "invalid",
+      invariantFailures: ["Buyer-issued property-list reference could not be resolved."]
+    });
+  }
   const completedAt = /* @__PURE__ */ new Date();
   return {
     agentUrl,
@@ -131,8 +149,9 @@ async function runConformance(agentUrl, options = {}) {
     fixturesUsed: mergedFixtures,
     autoSeeded: !!options.autoSeed,
     seedWarnings,
-    totalRuns,
+    totalRuns: totalRuns + (propertyLists?.totalRuns ?? 0),
     totalFailures: failures.length + droppedFailures,
+    ...propertyLists ? { propertyLists } : {},
     droppedFailures,
     perTool,
     failures,

package/dist/lib/conformance/runConformance.mjs

@@ -1,4 +1,5 @@
 import { AgentClient } from "../core/AgentClient.mjs";
+import { runPropertyListConformance } from "./property-lists.mjs";
 import { parseAdcpMajorVersion } from "../version.mjs";
 import {
   COMPACT_LIFECYCLE_TOOLS,
@@ -105,6 +106,23 @@ async function runConformance(agentUrl, options = {}) {
     });
     uniformError.push(report);
   }
+  const propertyLists = options.propertyListReferences ? await runPropertyListConformance(options.propertyListReferences) : void 0;
+  for (const result of propertyLists?.results ?? []) {
+    if (result.ok) continue;
+    if (failures.length >= maxFailures) {
+      droppedFailures++;
+      continue;
+    }
+    failures.push({
+      tool: "get_property_list",
+      seed,
+      shrunk: false,
+      input: { propertyListReferenceIndex: result.index },
+      response: null,
+      verdict: "invalid",
+      invariantFailures: ["Buyer-issued property-list reference could not be resolved."]
+    });
+  }
   const completedAt = /* @__PURE__ */ new Date();
   return {
     agentUrl,
@@ -116,8 +134,9 @@ async function runConformance(agentUrl, options = {}) {
     fixturesUsed: mergedFixtures,
     autoSeeded: !!options.autoSeed,
     seedWarnings,
-    totalRuns,
+    totalRuns: totalRuns + (propertyLists?.totalRuns ?? 0),
     totalFailures: failures.length + droppedFailures,
+    ...propertyLists ? { propertyLists } : {},
     droppedFailures,
     perTool,
     failures,

package/dist/lib/conformance/types.d.mts

@@ -32,6 +32,8 @@ export declare const DEFAULT_TOOLS: readonly ConformanceToolName[];
 /** Tier 1 + Tier 2 + Tier 3. Used when `autoSeed` is true or fixtures were supplied. */
 export declare const DEFAULT_TOOLS_WITH_UPDATES: readonly ConformanceToolName[];
 export interface RunConformanceOptions {
+    /** Buyer-issued references to certify through the seller MCP resolution path (without cached results). */
+    propertyListReferences?: readonly import('../types/tools.generated.mjs').PropertyListReference[];
     /** Seed for reproducible runs. Omit for a random seed. */
     seed?: number;
     /** Subset of tools to fuzz. Defaults to the full stateless tier. */
@@ -210,6 +212,7 @@ export interface ConformanceToolStats {
     skipReason?: SkipReason;
 }
 export interface ConformanceReport {
+    propertyLists?: import('./property-lists.mjs').PropertyListConformanceReport;
     agentUrl: string;
     seed: number;
     /** Schema version the fuzzer loaded. Pinned so a report is replayable. */

package/dist/lib/conformance/types.d.ts

@@ -32,6 +32,8 @@ export declare const DEFAULT_TOOLS: readonly ConformanceToolName[];
 /** Tier 1 + Tier 2 + Tier 3. Used when `autoSeed` is true or fixtures were supplied. */
 export declare const DEFAULT_TOOLS_WITH_UPDATES: readonly ConformanceToolName[];
 export interface RunConformanceOptions {
+    /** Buyer-issued references to certify through the seller MCP resolution path (without cached results). */
+    propertyListReferences?: readonly import('../types/tools.generated').PropertyListReference[];
     /** Seed for reproducible runs. Omit for a random seed. */
     seed?: number;
     /** Subset of tools to fuzz. Defaults to the full stateless tier. */
@@ -210,6 +212,7 @@ export interface ConformanceToolStats {
     skipReason?: SkipReason;
 }
 export interface ConformanceReport {
+    propertyLists?: import('./property-lists').PropertyListConformanceReport;
     agentUrl: string;
     seed: number;
     /** Schema version the fuzzer loaded. Pinned so a report is replayable. */

package/dist/lib/core/AgentClient.d.mts

@@ -160,7 +160,7 @@ export type TaskRequestFor<K extends AdcpTaskName> = TaskRequestTypeMap[K];
  * - `governance` — buyer-side governance config
  * - `requireV3ForMutations` — enforce AdCP v3 before dispatching mutating tools
  */
-export type InProcessAgentClientConfig = Pick<SingleAgentClientConfig, 'adcpVersion' | 'wireAdcpVersion' | 'versionEnvelope' | 'debug' | 'validation' | 'governance' | 'onActivity' | 'legacyFormatConverter' | 'projectionCatalogs' | 'canonicalFormatLegacyResolver' | 'validateFeatures' | 'requireV3ForMutations' | 'allowV2' | 'workingTimeout' | 'defaultMaxClarifications' | 'persistConversations' | 'deferredStorage' | 'resolveDeferredAgent' | 'deferredTaskTtlSeconds'> & {
+export type InProcessAgentClientConfig = Pick<SingleAgentClientConfig, 'adcpVersion' | 'wireAdcpVersion' | 'versionEnvelope' | 'debug' | 'validation' | 'governance' | 'onActivity' | 'legacyFormatConverter' | 'projectionCatalogs' | 'canonicalFormatLegacyResolver' | 'validateFeatures' | 'requireV3ForMutations' | 'workingTimeout' | 'defaultMaxClarifications' | 'persistConversations' | 'deferredStorage' | 'resolveDeferredAgent' | 'deferredTaskTtlSeconds'> & {
     /**
      * Human-readable name for this agent, used in debug logs and
      * `getAgentName()`. Defaults to `'in-process'`.
@@ -536,8 +536,10 @@ export declare class AgentClient {
     /**
      * Resolve the creative wire mode used by canonical writes without sending a
      * mutation. Uses capabilities, this tool's input schema, and the client wire
-     * pin. Older peers with insufficient evidence return `unknown` and require
-     * an unambiguous legacy reference during projection; conflicting evidence
+     * pin. Older peers with insufficient evidence return `unknown`; a matching
+     * seller-advertised product option can establish canonical delivery for an
+     * individual 3.1 write. Otherwise projection requires an unambiguous legacy
+     * reference. Conflicting evidence
      * or unproven support with a 3.2+ buyer pin throws `CreativeFormatCapabilityError`.
      */
     resolveCreativeFormatWireMode(taskType: 'sync_creatives' | 'create_media_buy' | 'update_media_buy', options?: Pick<TaskOptions, 'signal' | 'transport'>): Promise<CreativeFormatWireMode>;
@@ -553,13 +555,12 @@ export declare class AgentClient {
      * Return the seller's declared `adcp.idempotency.replay_ttl_seconds`, or
      * throw when a v3 seller omits the (required) declaration.
      *
-     * Returns `undefined` for v2 agents — v2 pre-dates the idempotency envelope.
      */
     getIdempotencyReplayTtlSeconds(): Promise<number | undefined>;
     /**
      * Assert that the seller's capabilities corroborate this client's pinned
      * AdCP major (per `getAdcpVersion()`). Throws `VersionUnsupportedError`
-     * otherwise. Set `ADCP_ALLOW_V2=1` to bypass.
+     * otherwise.
      */
     requireSupportedMajor(taskType?: string): Promise<void>;
     /**
@@ -739,6 +740,8 @@ export declare class AgentClient {
      * Get the agent protocol
      */
     getProtocol(): 'mcp' | 'a2a';
+    /** Resolved MCP endpoint already used by this client; never performs discovery. */
+    getDiscoveredMcpEndpoint(): string | undefined;
     /**
      * Get the canonical base URL for this agent
      *

package/dist/lib/core/AgentClient.d.ts

@@ -160,7 +160,7 @@ export type TaskRequestFor<K extends AdcpTaskName> = TaskRequestTypeMap[K];
  * - `governance` — buyer-side governance config
  * - `requireV3ForMutations` — enforce AdCP v3 before dispatching mutating tools
  */
-export type InProcessAgentClientConfig = Pick<SingleAgentClientConfig, 'adcpVersion' | 'wireAdcpVersion' | 'versionEnvelope' | 'debug' | 'validation' | 'governance' | 'onActivity' | 'legacyFormatConverter' | 'projectionCatalogs' | 'canonicalFormatLegacyResolver' | 'validateFeatures' | 'requireV3ForMutations' | 'allowV2' | 'workingTimeout' | 'defaultMaxClarifications' | 'persistConversations' | 'deferredStorage' | 'resolveDeferredAgent' | 'deferredTaskTtlSeconds'> & {
+export type InProcessAgentClientConfig = Pick<SingleAgentClientConfig, 'adcpVersion' | 'wireAdcpVersion' | 'versionEnvelope' | 'debug' | 'validation' | 'governance' | 'onActivity' | 'legacyFormatConverter' | 'projectionCatalogs' | 'canonicalFormatLegacyResolver' | 'validateFeatures' | 'requireV3ForMutations' | 'workingTimeout' | 'defaultMaxClarifications' | 'persistConversations' | 'deferredStorage' | 'resolveDeferredAgent' | 'deferredTaskTtlSeconds'> & {
     /**
      * Human-readable name for this agent, used in debug logs and
      * `getAgentName()`. Defaults to `'in-process'`.
@@ -536,8 +536,10 @@ export declare class AgentClient {
     /**
      * Resolve the creative wire mode used by canonical writes without sending a
      * mutation. Uses capabilities, this tool's input schema, and the client wire
-     * pin. Older peers with insufficient evidence return `unknown` and require
-     * an unambiguous legacy reference during projection; conflicting evidence
+     * pin. Older peers with insufficient evidence return `unknown`; a matching
+     * seller-advertised product option can establish canonical delivery for an
+     * individual 3.1 write. Otherwise projection requires an unambiguous legacy
+     * reference. Conflicting evidence
      * or unproven support with a 3.2+ buyer pin throws `CreativeFormatCapabilityError`.
      */
     resolveCreativeFormatWireMode(taskType: 'sync_creatives' | 'create_media_buy' | 'update_media_buy', options?: Pick<TaskOptions, 'signal' | 'transport'>): Promise<CreativeFormatWireMode>;
@@ -553,13 +555,12 @@ export declare class AgentClient {
      * Return the seller's declared `adcp.idempotency.replay_ttl_seconds`, or
      * throw when a v3 seller omits the (required) declaration.
      *
-     * Returns `undefined` for v2 agents — v2 pre-dates the idempotency envelope.
      */
     getIdempotencyReplayTtlSeconds(): Promise<number | undefined>;
     /**
      * Assert that the seller's capabilities corroborate this client's pinned
      * AdCP major (per `getAdcpVersion()`). Throws `VersionUnsupportedError`
-     * otherwise. Set `ADCP_ALLOW_V2=1` to bypass.
+     * otherwise.
      */
     requireSupportedMajor(taskType?: string): Promise<void>;
     /**
@@ -739,6 +740,8 @@ export declare class AgentClient {
      * Get the agent protocol
      */
     getProtocol(): 'mcp' | 'a2a';
+    /** Resolved MCP endpoint already used by this client; never performs discovery. */
+    getDiscoveredMcpEndpoint(): string | undefined;
     /**
      * Get the canonical base URL for this agent
      *

package/dist/lib/core/AgentClient.js

@@ -794,8 +794,10 @@ class AgentClient {
   /**
    * Resolve the creative wire mode used by canonical writes without sending a
    * mutation. Uses capabilities, this tool's input schema, and the client wire
-   * pin. Older peers with insufficient evidence return `unknown` and require
-   * an unambiguous legacy reference during projection; conflicting evidence
+   * pin. Older peers with insufficient evidence return `unknown`; a matching
+   * seller-advertised product option can establish canonical delivery for an
+   * individual 3.1 write. Otherwise projection requires an unambiguous legacy
+   * reference. Conflicting evidence
    * or unproven support with a 3.2+ buyer pin throws `CreativeFormatCapabilityError`.
    */
   async resolveCreativeFormatWireMode(taskType, options) {
@@ -821,7 +823,6 @@ class AgentClient {
    * Return the seller's declared `adcp.idempotency.replay_ttl_seconds`, or
    * throw when a v3 seller omits the (required) declaration.
    *
-   * Returns `undefined` for v2 agents — v2 pre-dates the idempotency envelope.
    */
   async getIdempotencyReplayTtlSeconds() {
     return this.client.getIdempotencyReplayTtlSeconds();
@@ -829,7 +830,7 @@ class AgentClient {
   /**
    * Assert that the seller's capabilities corroborate this client's pinned
    * AdCP major (per `getAdcpVersion()`). Throws `VersionUnsupportedError`
-   * otherwise. Set `ADCP_ALLOW_V2=1` to bypass.
+   * otherwise.
    */
   async requireSupportedMajor(taskType = "request") {
     return this.client.requireSupportedMajor(taskType);
@@ -1173,6 +1174,10 @@ class AgentClient {
   getProtocol() {
     return this.client.getProtocol();
   }
+  /** Resolved MCP endpoint already used by this client; never performs discovery. */
+  getDiscoveredMcpEndpoint() {
+    return this.client.getDiscoveredMcpEndpoint();
+  }
   /**
    * Get the canonical base URL for this agent
    *

package/dist/lib/core/AgentClient.mjs

@@ -762,8 +762,10 @@ class AgentClient {
   /**
    * Resolve the creative wire mode used by canonical writes without sending a
    * mutation. Uses capabilities, this tool's input schema, and the client wire
-   * pin. Older peers with insufficient evidence return `unknown` and require
-   * an unambiguous legacy reference during projection; conflicting evidence
+   * pin. Older peers with insufficient evidence return `unknown`; a matching
+   * seller-advertised product option can establish canonical delivery for an
+   * individual 3.1 write. Otherwise projection requires an unambiguous legacy
+   * reference. Conflicting evidence
    * or unproven support with a 3.2+ buyer pin throws `CreativeFormatCapabilityError`.
    */
   async resolveCreativeFormatWireMode(taskType, options) {
@@ -789,7 +791,6 @@ class AgentClient {
    * Return the seller's declared `adcp.idempotency.replay_ttl_seconds`, or
    * throw when a v3 seller omits the (required) declaration.
    *
-   * Returns `undefined` for v2 agents — v2 pre-dates the idempotency envelope.
    */
   async getIdempotencyReplayTtlSeconds() {
     return this.client.getIdempotencyReplayTtlSeconds();
@@ -797,7 +798,7 @@ class AgentClient {
   /**
    * Assert that the seller's capabilities corroborate this client's pinned
    * AdCP major (per `getAdcpVersion()`). Throws `VersionUnsupportedError`
-   * otherwise. Set `ADCP_ALLOW_V2=1` to bypass.
+   * otherwise.
    */
   async requireSupportedMajor(taskType = "request") {
     return this.client.requireSupportedMajor(taskType);
@@ -1141,6 +1142,10 @@ class AgentClient {
   getProtocol() {
     return this.client.getProtocol();
   }
+  /** Resolved MCP endpoint already used by this client; never performs discovery. */
+  getDiscoveredMcpEndpoint() {
+    return this.client.getDiscoveredMcpEndpoint();
+  }
   /**
    * Get the canonical base URL for this agent
    *