@adcp/sdk 7.2.0 → 7.4.0

package/dist/lib/types/wellknown-schemas.generated.d.ts

@@ -248,14 +248,14 @@ export declare const BrandJsonSchema: z.ZodUnion<readonly [z.ZodObject<{
                 html: "html";
                 javascript: "javascript";
                 daast: "daast";
-                brief: "brief";
-                catalog: "catalog";
                 image: "image";
                 video: "video";
                 text: "text";
                 webhook: "webhook";
                 css: "css";
                 markdown: "markdown";
+                brief: "brief";
+                catalog: "catalog";
             }>;
             url: z.ZodString;
             tags: z.ZodOptional<z.ZodArray<z.ZodString>>;

package/dist/lib/validation/sync-creatives.d.ts

@@ -32,7 +32,7 @@ export declare const SyncCreativesItemSchema: z.ZodObject<{
             contacts: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 role: z.ZodUnion<readonly [z.ZodLiteral<"billing">, z.ZodLiteral<"legal">, z.ZodLiteral<"creative">, z.ZodLiteral<"general">]>;
                 name: z.ZodOptional<z.ZodString>;
-                email: z.ZodOptional<z.ZodString>;
+                email: z.ZodOptional<z.ZodEmail>;
                 phone: z.ZodOptional<z.ZodString>;
             }, z.core.$loose>>>;
             bank: z.ZodOptional<z.ZodObject<{
@@ -53,7 +53,7 @@ export declare const SyncCreativesItemSchema: z.ZodObject<{
         setup: z.ZodOptional<z.ZodObject<{
             url: z.ZodOptional<z.ZodString>;
             message: z.ZodString;
-            expires_at: z.ZodOptional<z.ZodString>;
+            expires_at: z.ZodOptional<z.ZodISODateTime>;
         }, z.core.$loose>>;
         account_scope: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"operator">, z.ZodLiteral<"brand">, z.ZodLiteral<"operator_brand">, z.ZodLiteral<"agent">]>>;
         governance_agents: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -132,7 +132,7 @@ export declare const SyncCreativesSuccessStrictSchema: z.ZodObject<{
                 contacts: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     role: z.ZodUnion<readonly [z.ZodLiteral<"billing">, z.ZodLiteral<"legal">, z.ZodLiteral<"creative">, z.ZodLiteral<"general">]>;
                     name: z.ZodOptional<z.ZodString>;
-                    email: z.ZodOptional<z.ZodString>;
+                    email: z.ZodOptional<z.ZodEmail>;
                     phone: z.ZodOptional<z.ZodString>;
                 }, z.core.$loose>>>;
                 bank: z.ZodOptional<z.ZodObject<{
@@ -153,7 +153,7 @@ export declare const SyncCreativesSuccessStrictSchema: z.ZodObject<{
             setup: z.ZodOptional<z.ZodObject<{
                 url: z.ZodOptional<z.ZodString>;
                 message: z.ZodString;
-                expires_at: z.ZodOptional<z.ZodString>;
+                expires_at: z.ZodOptional<z.ZodISODateTime>;
             }, z.core.$loose>>;
             account_scope: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"operator">, z.ZodLiteral<"brand">, z.ZodLiteral<"operator_brand">, z.ZodLiteral<"agent">]>>;
             governance_agents: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -246,7 +246,7 @@ export declare const SyncCreativesResponseStrictSchema: z.ZodUnion<readonly [z.Z
                 contacts: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     role: z.ZodUnion<readonly [z.ZodLiteral<"billing">, z.ZodLiteral<"legal">, z.ZodLiteral<"creative">, z.ZodLiteral<"general">]>;
                     name: z.ZodOptional<z.ZodString>;
-                    email: z.ZodOptional<z.ZodString>;
+                    email: z.ZodOptional<z.ZodEmail>;
                     phone: z.ZodOptional<z.ZodString>;
                 }, z.core.$loose>>>;
                 bank: z.ZodOptional<z.ZodObject<{
@@ -267,7 +267,7 @@ export declare const SyncCreativesResponseStrictSchema: z.ZodUnion<readonly [z.Z
             setup: z.ZodOptional<z.ZodObject<{
                 url: z.ZodOptional<z.ZodString>;
                 message: z.ZodString;
-                expires_at: z.ZodOptional<z.ZodString>;
+                expires_at: z.ZodOptional<z.ZodISODateTime>;
             }, z.core.$loose>>;
             account_scope: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"operator">, z.ZodLiteral<"brand">, z.ZodLiteral<"operator_brand">, z.ZodLiteral<"agent">]>>;
             governance_agents: z.ZodOptional<z.ZodArray<z.ZodObject<{

package/dist/lib/version.d.ts

@@ -1,7 +1,7 @@
 /**
  * AdCP SDK library version
  */
-export declare const LIBRARY_VERSION = "7.2.0";
+export declare const LIBRARY_VERSION = "7.4.0";
 /**
  * AdCP specification version this library is built for
  */
@@ -33,10 +33,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
  * Full version information
  */
 export declare const VERSION_INFO: {
-    readonly library: "7.2.0";
+    readonly library: "7.4.0";
     readonly adcp: "3.0.11";
     readonly compatibleVersions: readonly ["v2.5", "v2.6", "v3", "3.0.0-beta.1", "3.0.0-beta.3", "3.0.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"];
-    readonly generatedAt: "2026-05-12T23:51:47.164Z";
+    readonly generatedAt: "2026-05-16T15:53:19.396Z";
 };
 /**
  * Get the AdCP specification version this library is built for

package/dist/lib/version.js

@@ -11,7 +11,7 @@ exports.parseAdcpMajorVersion = parseAdcpMajorVersion;
 /**
  * AdCP SDK library version
  */
-exports.LIBRARY_VERSION = '7.2.0';
+exports.LIBRARY_VERSION = '7.4.0';
 /**
  * AdCP specification version this library is built for
  */
@@ -52,10 +52,10 @@ exports.COMPATIBLE_ADCP_VERSIONS = [
  * Full version information
  */
 exports.VERSION_INFO = {
-    library: '7.2.0',
+    library: '7.4.0',
     adcp: '3.0.11',
     compatibleVersions: exports.COMPATIBLE_ADCP_VERSIONS,
-    generatedAt: '2026-05-12T23:51:47.164Z',
+    generatedAt: '2026-05-16T15:53:19.396Z',
 };
 /**
  * Get the AdCP specification version this library is built for

package/examples/hello_creative_adapter_ad_server.ts

@@ -60,6 +60,7 @@ import {
   memoryBackend,
   serve,
   verifyApiKey,
+  assertNoExampleTlds,
   type AccountStore,
   type Account,
   type CreativeAdServerPlatform,
@@ -86,6 +87,10 @@ const ADCP_AUTH_TOKEN = process.env['ADCP_AUTH_TOKEN'] ?? 'sk_harness_do_not_use
 const PUBLIC_AGENT_URL = process.env['PUBLIC_AGENT_URL'] ?? `http://127.0.0.1:${PORT}`;
 
 const KNOWN_PUBLISHERS = ['creative-network.example', 'acmeoutdoor.example', 'pinnacle-agency.example'];
+assertNoExampleTlds(
+  { KNOWN_PUBLISHERS },
+  { allowIn: ['test', 'development'], checklistPath: 'examples/hello_creative_adapter_ad_server.ts' }
+);
 const SANDBOX_ID_PREFIX = 'sandbox_';
 
 // ---------------------------------------------------------------------------

package/examples/hello_creative_adapter_template.ts

@@ -38,6 +38,7 @@ import {
   memoryBackend,
   AdcpError,
   defineCreativeBuilderPlatform,
+  assertNoExampleTlds,
   type DecisioningPlatform,
   type CreativeBuilderPlatform,
   type BuildCreativeReturn,
@@ -72,6 +73,10 @@ const PUBLIC_AGENT_URL = process.env['PUBLIC_AGENT_URL'] ?? `http://127.0.0.1:${
 // platforms expose a global format catalog or the workspace tied to the API
 // key's principal; the mock fixture keys templates per workspace.
 const DEFAULT_LISTING_WORKSPACE = process.env['DEFAULT_LISTING_WORKSPACE'] ?? 'ws_acme_studio';
+assertNoExampleTlds(
+  { DEFAULT_LISTING_WORKSPACE, PUBLIC_AGENT_URL },
+  { allowIn: ['test', 'development'], checklistPath: 'examples/hello_creative_adapter_template.ts' }
+);
 
 // ---------------------------------------------------------------------------
 // Upstream client — SWAP for production.

package/examples/hello_seller_adapter_guaranteed.ts

@@ -68,6 +68,7 @@ import {
   AdcpError,
   getAccountMode,
   assertMediaBuyTransition,
+  assertNoExampleTlds,
   type DecisioningPlatform,
   type SalesCorePlatform,
   type SalesIngestionPlatform,
@@ -101,6 +102,10 @@ const ADCP_AUTH_TOKEN = process.env['ADCP_AUTH_TOKEN'] ?? 'sk_harness_do_not_use
 const PUBLIC_AGENT_URL = process.env['PUBLIC_AGENT_URL'] ?? `http://127.0.0.1:${PORT}`;
 
 const KNOWN_PUBLISHERS = ['acmeoutdoor.example', 'pinnacle-agency.example', 'premium-sports.example'];
+assertNoExampleTlds(
+  { KNOWN_PUBLISHERS },
+  { allowIn: ['test', 'development'], checklistPath: 'examples/hello_seller_adapter_guaranteed.ts' }
+);
 
 // SWAP: the seller's minimum committable max_variance_percent — the
 // buyer-vs-seller billing-count delta this seller will tolerate before

package/examples/hello_seller_adapter_non_guaranteed.ts

@@ -62,6 +62,7 @@ import {
   createMediaBuyStore,
   InMemoryStateStore,
   assertMediaBuyTransition,
+  assertNoExampleTlds,
   type DecisioningPlatform,
   type SalesCorePlatform,
   type SalesIngestionPlatform,
@@ -96,6 +97,10 @@ const ADCP_AUTH_TOKEN = process.env['ADCP_AUTH_TOKEN'] ?? 'sk_harness_do_not_use
 const PUBLIC_AGENT_URL = process.env['PUBLIC_AGENT_URL'] ?? `http://127.0.0.1:${PORT}`;
 
 const KNOWN_PUBLISHERS = ['remnant-network.example', 'acmeoutdoor.example', 'pinnacle-agency.example'];
+assertNoExampleTlds(
+  { KNOWN_PUBLISHERS },
+  { allowIn: ['test', 'development'], checklistPath: 'examples/hello_seller_adapter_non_guaranteed.ts' }
+);
 
 // TEST-ONLY: id-prefix used by the sandbox arm in `accounts.resolve` so
 // production sellers don't need this; remove the sandbox arm + this

package/examples/hello_seller_adapter_social.ts

@@ -38,6 +38,7 @@ import {
   AdcpError,
   defineSalesPlatform,
   defineAudiencePlatform,
+  assertNoExampleTlds,
   type DecisioningPlatform,
   type SalesPlatform,
   type AudiencePlatform,
@@ -303,6 +304,10 @@ interface AdvertiserMeta {
 // AdCP-side identifiers from the mock's seed data. SWAP: replace with a
 // real `/advertiser/list` call.
 const KNOWN_ADVERTISERS = ['acmeoutdoor.example', 'summit-media.example'];
+assertNoExampleTlds(
+  { KNOWN_ADVERTISERS },
+  { allowIn: ['test', 'development'], checklistPath: 'examples/hello_seller_adapter_social.ts' }
+);
 
 // Buyer event_source_id → upstream pixel_id translation map. The mock
 // ignores buyer-supplied pixel_id and assigns its own (`px_<uuid>`); buyers

package/examples/hello_si_adapter_brand.ts

@@ -47,6 +47,7 @@ import {
   createUpstreamHttpClient,
   memoryBackend,
   AdcpError,
+  assertNoExampleTlds,
   type AccountStore,
   type Account,
 } from '@adcp/sdk/server';
@@ -81,6 +82,10 @@ const ADCP_AUTH_TOKEN = process.env['ADCP_AUTH_TOKEN'] ?? 'sk_harness_do_not_use
 // tenant), so a hardcoded default is fine. Multi-brand deployments derive
 // from `ctx.authInfo` per-API-key binding instead.
 const DEFAULT_LISTING_BRAND = process.env['DEFAULT_LISTING_BRAND'] ?? 'brand_nova_motors';
+assertNoExampleTlds(
+  { DEFAULT_LISTING_BRAND },
+  { allowIn: ['test', 'development'], checklistPath: 'examples/hello_si_adapter_brand.ts' }
+);
 
 // ---------------------------------------------------------------------------
 // Upstream client — SWAP for production.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adcp/sdk",
-  "version": "7.2.0",
+  "version": "7.4.0",
   "description": "AdCP SDK — client, server, and compliance harnesses for the AdContext Protocol (MCP + A2A)",
   "workspaces": [
     ".",
@@ -202,12 +202,13 @@
   ],
   "scripts": {
     "prepare": "node scripts/install-hooks.js 2>/dev/null || true",
+    "sync:agents": "node scripts/import-claude-agents.mjs",
     "prepublishOnly": "npm run clean && npm run sync-schemas:all && (test -f src/lib/types/tools.generated.ts || npm run generate-types) && npm run build:lib && node --test-timeout=60000 --test-force-exit --test test/lib/adcp-client.test.js test/lib/validation.test.js test/lib/zod-schemas.test.js",
     "build": "npm run build:lib",
     "build:lib": "npm run sync-version && npm run schemas:ensure && tsx scripts/generate-wire-spec-fields.ts && tsc --project tsconfig.lib.json && tsx scripts/copy-schemas-to-dist.ts",
     "build:test-agents": "npm run build:lib && tsc -p test-agents/tsconfig.json --rootDir test-agents",
     "pretest": "npm run schemas:ensure",
-    "test": "NODE_ENV=test node --test-timeout=60000 --test-force-exit --test test/*.test.js test/lib/*.test.js",
+    "test": "NODE_ENV=test node --test-timeout=60000 --test-force-exit --test test/*.test.js test/lib/*.test.js && npm test --workspace=packages/eslint-plugin --if-present",
     "pretest:lib": "npm run schemas:ensure",
     "test:lib": "NODE_ENV=test node --test-timeout=60000 --test-force-exit --test test/lib/*.test.js",
     "pretest:examples": "npm run build",

package/skills/call-adcp-agent/SKILL.md

@@ -240,6 +240,7 @@ Quick lookup before reading the full envelope. Match what you see in `adcp_error
 | `recovery: 'transient'` (rate limit, 5xx, timeout) | Server-side, retry-safe | Retry with the **same** `idempotency_key`. |
 | `recovery: 'correctable'` | Buyer-side fix | Read `issues[]`, patch the pointers, resend. Most cases close in one attempt. |
 | `recovery: 'terminal'` (account suspended, payment required, …) | Requires human action | Don't retry. Surface to the user. |
+| `[adcp] Warning: agent … does not expose get_adcp_capabilities` (one-shot per client, `@adcp/client` only) | Seller didn't ship v3 discovery — routed through the v2 adapter with idempotency-TTL guarantee unknown | Branch on `client.isSyntheticV2()` before dispatch. Tighten retry policy (lower attempt cap, longer backoff) or fall back to natural-key recovery for these sellers. Same predicate also flags synthetic v3 caveat — see `isSyntheticV2()` JSDoc. |
 | HTTP 401 with `WWW-Authenticate` header | Missing or expired credential | Add `Authorization` per the agent's auth spec; re-auth if applicable. If the challenge `scheme` is `Basic` (gateway-fronted agents — Apigee, Kong, AWS API GW), the SDK / CLI need `auth: { type: 'basic', username, password }` or `--auth user:pass --auth-scheme basic` — `Bearer` will never succeed against that gateway. **Saved aliases**: if registered with `--auth-scheme basic`, the scheme persists in `~/.adcp/config.json` and auto-applies on every later invocation — don't redundantly repeat the flag on each call. |
 
 If your symptom isn't here, fall through to the next section.