@adcp/sdk 5.25.1 → 6.1.0

package/dist/lib/validation/schema-validator.js

@@ -18,18 +18,42 @@ function formatIssue(err) {
         typeof err.params.missingProperty === 'string'
         ? `/${err.params.missingProperty}`
         : '';
+    // Enrich enum errors with the allowed values from AJV's params + replace
+    // the opaque "must be equal to one of the allowed values" message with
+    // the actual list. Without this, LLM-generated platforms can't self-
+    // correct (Emma matrix v17, 2026-04-30): the validation cascade from
+    // a single bad enum value swallows ~30 storyboard steps because no
+    // self-correction signal is available without fetching the schema.
+    const isEnum = err.keyword === 'enum' &&
+        err.params != null &&
+        Array.isArray(err.params.allowedValues);
+    const allowedValues = isEnum ? err.params.allowedValues : undefined;
+    const message = isEnum
+        ? `must be one of: ${allowedValues.map(v => JSON.stringify(v)).join(', ')}`
+        : (err.message ?? 'validation failed');
     return {
         pointer: `${instancePath}${missingProperty}` || '/',
-        message: err.message ?? 'validation failed',
+        message,
         keyword: err.keyword,
         schemaPath: err.schemaPath,
+        ...(allowedValues !== undefined && { allowedValues }),
     };
 }
+// Path segments we refuse to walk into during schema-path resolution. AJV
+// emits trusted `schemaPath` strings today, but the function is exported in
+// shape (anything in this file is reachable via the compiled JS), so any
+// future caller passing user-influenced paths can't traverse into prototype
+// chains. Bundled schemas have no use for these names either.
+const FORBIDDEN_SCHEMA_PATH_SEGMENTS = new Set(['__proto__', 'constructor', 'prototype']);
 /**
  * Resolve an AJV `schemaPath` like `"#/properties/account/oneOf"` against
  * the compiled validator's root schema. Returns `undefined` if the path
  * doesn't land on an object. Handles URI-encoded path segments (AJV
  * escapes `~` as `~0` and `/` as `~1` per RFC 6901).
+ *
+ * Refuses prototype-chain segments and uses own-property indexing so a
+ * future caller (or a pathological future schema) can't induce a walk
+ * into `Object.prototype`.
  */
 function resolveSchemaPath(rootSchema, schemaPath) {
     if (rootSchema == null)
@@ -42,10 +66,221 @@ function resolveSchemaPath(rootSchema, schemaPath) {
         if (cursor == null || (typeof cursor !== 'object' && !Array.isArray(cursor)))
             return undefined;
         const decoded = raw.replace(/~1/g, '/').replace(/~0/g, '~');
+        if (FORBIDDEN_SCHEMA_PATH_SEGMENTS.has(decoded))
+            return undefined;
+        if (!Object.prototype.hasOwnProperty.call(cursor, decoded))
+            return undefined;
         cursor = cursor[decoded];
     }
     return cursor;
 }
+/**
+ * Compact AJV's `oneOf` / `anyOf` cascades before they reach the wire.
+ *
+ * AJV with `allErrors: true` emits one error per non-matching variant
+ * plus a synthetic "must match exactly one schema" root. For a 9-way
+ * `pricing_options` union with a single bad `pricing_model` value that
+ * is 14+ errors per failed item, drowning real residual errors elsewhere
+ * in the same payload (adcontextprotocol/adcp-client#1111).
+ *
+ * Strategy:
+ *  1. For each union root, group variant errors by variant index.
+ *  2. Inspect each variant's schema for `const`-constrained properties.
+ *     A property where ≥2 variants assert `const` at the same path is a
+ *     candidate discriminator (covers single-field discriminators like
+ *     `pricing_model` and composite ones like `audience-selector`'s
+ *     `(type, value_type)`).
+ *  3. Collapse a candidate path iff EVERY variant that asserts `const`
+ *     there emitted a `const` error. (If some variants silently passed,
+ *     the user's value matched some allowed const — collapsing would
+ *     hide that and tell them their valid value was wrong.)
+ *  4. Each collapse becomes a synthetic `enum`-keyword issue carrying
+ *     the union of allowed const values; the existing `formatIssue`
+ *     enrichment then renders "must be one of: A, B, ...".
+ *  5. After collapse, if any variant has zero residual errors, the
+ *     discriminator collapse fully explains the failure — drop the
+ *     synthetic union root and the residuals from the other variants.
+ *  6. Otherwise pick the variant with the fewest residual errors,
+ *     tie-breaking by fewest residual `const` errors so a variant the
+ *     user's discriminator value satisfied wins over a sibling whose
+ *     discriminator they violated. Drop the rest.
+ */
+function compactUnionErrors(errors, rootSchema) {
+    if (errors.length === 0)
+        return [...errors];
+    // Pre-bucket once so each error is scanned a constant number of times even
+    // when a malicious or pathological payload pushes Ajv to emit thousands of
+    // errors across many union failures. The naive `for root in unionRoots: for
+    // e in errors` form is O(U·N) — at K=100 product items each producing a
+    // 14-error pricing-options cascade that's ~140k iterations on the
+    // request-validation hot path.
+    const errorsByOneOfPath = new Map();
+    for (const e of errors) {
+        const m = e.schemaPath.match(/^(.*\/(?:oneOf|anyOf))\/\d+(?:\/|$)/);
+        if (!m)
+            continue;
+        const root = m[1];
+        const bucket = errorsByOneOfPath.get(root);
+        if (bucket)
+            bucket.push(e);
+        else
+            errorsByOneOfPath.set(root, [e]);
+    }
+    const dropped = new Set();
+    const added = [];
+    // Deepest-first ordering matters for nested unions: by the time the outer
+    // root is evaluated, the inner cascade has already been replaced by a
+    // synthetic enum at a `<...>/discriminator/<field>` schemaPath that won't
+    // match the outer's `oneOfPath + '/'` prefix and stays independent.
+    const unionRoots = errors
+        .filter(e => e.keyword === 'oneOf' || e.keyword === 'anyOf')
+        .slice()
+        .sort((a, b) => b.schemaPath.length - a.schemaPath.length);
+    for (const root of unionRoots) {
+        if (dropped.has(root))
+            continue;
+        const oneOfPath = root.schemaPath;
+        const rootInstance = root.instancePath;
+        // Variant errors: pulled from the prebuilt index (constant per-error work
+        // above), then grouped by variant index. instancePath scoping keeps two
+        // separate union failures sharing the same `schemaPath` but different
+        // instancePaths — e.g., `products[0].pricing_options[0]` and
+        // `products[1]...` — independent.
+        const candidateErrors = errorsByOneOfPath.get(oneOfPath) ?? [];
+        const byVariant = new Map();
+        for (const e of candidateErrors) {
+            if (e === root || dropped.has(e))
+                continue;
+            const tail = e.schemaPath.slice(oneOfPath.length + 1);
+            const m = tail.match(/^(\d+)(?:\/|$)/);
+            if (!m)
+                continue;
+            if (e.instancePath !== rootInstance && !e.instancePath.startsWith(rootInstance + '/'))
+                continue;
+            const idx = parseInt(m[1], 10);
+            const bucket = byVariant.get(idx);
+            if (bucket)
+                bucket.push(e);
+            else
+                byVariant.set(idx, [e]);
+        }
+        if (byVariant.size === 0)
+            continue;
+        // Resolve the variant schema array. Without it we fall back to a pure
+        // error-shape collapse (still correct, just less precise on which
+        // variants asserted const where the user happened to match).
+        const variantSchemas = resolveSchemaPath(rootSchema, oneOfPath);
+        const variantArr = Array.isArray(variantSchemas) ? variantSchemas : [];
+        // For each top-level property in each variant, record which variants
+        // declare a `const` value there. Top-level only — composite
+        // discriminators in AdCP (`audience-selector`, pricing-option) all
+        // sit at the variant root.
+        const constAsserters = new Map();
+        for (let i = 0; i < variantArr.length; i++) {
+            const variant = variantArr[i];
+            if (!variant || typeof variant !== 'object')
+                continue;
+            const props = variant.properties;
+            if (!props || typeof props !== 'object')
+                continue;
+            for (const [key, prop] of Object.entries(props)) {
+                if (prop && typeof prop === 'object' && 'const' in prop) {
+                    const path = `/${key.replace(/~/g, '~0').replace(/\//g, '~1')}`;
+                    let m = constAsserters.get(path);
+                    if (!m)
+                        constAsserters.set(path, (m = new Map()));
+                    m.set(i, prop.const);
+                }
+            }
+        }
+        // For each candidate path with ≥2 asserters, did every asserter emit?
+        const collapsedPaths = new Set();
+        for (const [relPath, asserters] of constAsserters) {
+            if (asserters.size < 2)
+                continue;
+            const absolutePath = rootInstance + relPath;
+            const emittersByVariant = new Map();
+            for (const [idx, errs] of byVariant) {
+                for (const e of errs) {
+                    if (e.keyword === 'const' && e.instancePath === absolutePath) {
+                        emittersByVariant.set(idx, e);
+                        break;
+                    }
+                }
+            }
+            let allEmitted = true;
+            for (const idx of asserters.keys()) {
+                if (!emittersByVariant.has(idx)) {
+                    allEmitted = false;
+                    break;
+                }
+            }
+            if (!allEmitted)
+                continue;
+            const allowedValues = [];
+            for (const v of asserters.values()) {
+                const already = allowedValues.some(existing => existing === v);
+                if (!already)
+                    allowedValues.push(v);
+            }
+            const sample = emittersByVariant.values().next().value;
+            // Synthetic enum issue. `schemaPath: ''` keeps it out of any caller
+            // that walks the path back to a real schema location (the synthesized
+            // `<oneOfPath>/discriminator/<field>` would dangle if dereferenced)
+            // while still satisfying the wire shape — the response-side errors
+            // helper already gates `schemaPath` exposure via `exposeSchemaPath`.
+            // `JSON.stringify` on the const values is safe: they come from the
+            // bundled (trusted) schema and the outer wire envelope re-encodes
+            // anyway, so control characters or quotes can't break framing.
+            added.push({
+                ...sample,
+                keyword: 'enum',
+                schemaPath: '',
+                message: `must be one of: ${allowedValues.map(v => JSON.stringify(v)).join(', ')}`,
+                params: { allowedValues },
+            });
+            for (const e of emittersByVariant.values())
+                dropped.add(e);
+            collapsedPaths.add(absolutePath);
+        }
+        // Compute residuals after the collapse.
+        const residualByVariant = new Map();
+        for (const [idx, errs] of byVariant) {
+            residualByVariant.set(idx, errs.filter(e => !dropped.has(e)));
+        }
+        if (collapsedPaths.size > 0) {
+            const anyZeroResidual = [...residualByVariant.values()].some(r => r.length === 0);
+            if (anyZeroResidual) {
+                for (const errs of residualByVariant.values())
+                    for (const e of errs)
+                        dropped.add(e);
+                dropped.add(root);
+                continue;
+            }
+        }
+        // Pick the best surviving variant; prefer fewest residuals, tie-break
+        // by fewest residual `const` errors (so variants whose discriminator
+        // the user actually picked win over siblings whose discriminator they
+        // violated).
+        let bestIdx = -1;
+        let bestCount = Infinity;
+        let bestConsts = Infinity;
+        for (const [idx, residual] of residualByVariant) {
+            const constCount = residual.reduce((n, e) => (e.keyword === 'const' ? n + 1 : n), 0);
+            if (residual.length < bestCount || (residual.length === bestCount && constCount < bestConsts)) {
+                bestIdx = idx;
+                bestCount = residual.length;
+                bestConsts = constCount;
+            }
+        }
+        for (const [idx, residual] of residualByVariant) {
+            if (idx !== bestIdx)
+                for (const e of residual)
+                    dropped.add(e);
+        }
+    }
+    return [...errors.filter(e => !dropped.has(e)), ...added];
+}
 /**
  * When an AJV error has `keyword: 'oneOf' | 'anyOf'`, resolve the
  * schema's variant array and summarize each variant so a client can
@@ -87,9 +322,10 @@ function validateRequest(toolName, payload, version) {
     if (valid)
         return { valid: true, issues: [], variant: 'request' };
     const rootSchema = validator.schema;
+    const compacted = compactUnionErrors(validator.errors ?? [], rootSchema);
     return {
         valid: false,
-        issues: (validator.errors ?? []).map(formatIssue).map(i => enrichWithVariants(i, rootSchema)),
+        issues: compacted.map(formatIssue).map(i => enrichWithVariants(i, rootSchema)),
         variant: 'request',
     };
 }
@@ -136,9 +372,10 @@ function validateResponse(toolName, payload, version) {
     if (valid)
         return { valid: true, issues: [], variant: usedVariant, ...fallbackFields };
     const rootSchema = effective.schema;
+    const compacted = compactUnionErrors(effective.errors ?? [], rootSchema);
     return {
         valid: false,
-        issues: (effective.errors ?? []).map(formatIssue).map(i => enrichWithVariants(i, rootSchema)),
+        issues: compacted.map(formatIssue).map(i => enrichWithVariants(i, rootSchema)),
         variant: usedVariant,
         ...fallbackFields,
     };

package/dist/lib/validation/schema-validator.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema-validator.js","sourceRoot":"","sources":["../../../src/lib/validation/schema-validator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema-validator.js","sourceRoot":"","sources":["../../../src/lib/validation/schema-validator.ts"],"names":[],"mappings":"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"}

package/dist/lib/version.d.ts

@@ -1,7 +1,7 @@
 /**
  * AdCP SDK library version
  */
-export declare const LIBRARY_VERSION = "5.25.1";
+export declare const LIBRARY_VERSION = "6.1.0";
 /**
  * AdCP specification version this library is built for
  */
@@ -29,10 +29,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
  * Full version information
  */
 export declare const VERSION_INFO: {
-    readonly library: "5.25.1";
+    readonly library: "6.1.0";
     readonly adcp: "3.0.1";
     readonly compatibleVersions: readonly ["v2.5", "v2.6", "v3", "3.0.0-beta.1", "3.0.0-beta.3", "3.0.0", "3.0.1"];
-    readonly generatedAt: "2026-04-30T12:38:18.013Z";
+    readonly generatedAt: "2026-05-01T01:08:59.054Z";
 };
 /**
  * Get the AdCP specification version this library is built for

package/dist/lib/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,eAAe,WAAW,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,YAAY,UAAU,CAAC;AAEpC;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,wBAAwB,mFAQ3B,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,SAAS,MAAM,EAAE,CAEzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAK7D"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC;;GAEG;AACH,eAAO,MAAM,YAAY,UAAU,CAAC;AAEpC;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,wBAAwB,mFAQ3B,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,SAAS,MAAM,EAAE,CAEzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAK7D"}

package/dist/lib/version.js

@@ -11,7 +11,7 @@ exports.parseAdcpMajorVersion = parseAdcpMajorVersion;
 /**
  * AdCP SDK library version
  */
-exports.LIBRARY_VERSION = '5.25.1';
+exports.LIBRARY_VERSION = '6.1.0';
 /**
  * AdCP specification version this library is built for
  */
@@ -38,10 +38,10 @@ exports.COMPATIBLE_ADCP_VERSIONS = [
  * Full version information
  */
 exports.VERSION_INFO = {
-    library: '5.25.1',
+    library: '6.1.0',
     adcp: '3.0.1',
     compatibleVersions: exports.COMPATIBLE_ADCP_VERSIONS,
-    generatedAt: '2026-04-30T12:38:18.013Z',
+    generatedAt: '2026-05-01T01:08:59.054Z',
 };
 /**
  * Get the AdCP specification version this library is built for

package/dist/lib/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":";AAAA,gCAAgC;AAChC,iDAAiD;;;AAuDjD,wCAEC;AAKD,8CAEC;AAKD,4CAEC;AAKD,sDAEC;AAWD,sDAKC;AA5FD;;GAEG;AACU,QAAA,eAAe,GAAG,QAAQ,CAAC;AAExC;;GAEG;AACU,QAAA,YAAY,GAAG,OAAO,CAAC;AAEpC;;;;GAIG;AACU,QAAA,kBAAkB,GAAG,CAAC,CAAC;AAEpC;;GAEG;AACU,QAAA,wBAAwB,GAAG;IACtC,MAAM;IACN,MAAM;IACN,IAAI;IACJ,cAAc;IACd,cAAc;IACd,OAAO;IACP,OAAO;CACC,CAAC;AAYX;;GAEG;AACU,QAAA,YAAY,GAAG;IAC1B,OAAO,EAAE,QAAQ;IACjB,IAAI,EAAE,OAAO;IACb,kBAAkB,EAAE,gCAAwB;IAC5C,WAAW,EAAE,0BAA0B;CAC/B,CAAC;AAEX;;GAEG;AACH,SAAgB,cAAc;IAC5B,OAAO,oBAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB;IAC/B,OAAO,uBAAe,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,WAAmB;IAClD,OAAQ,gCAA8C,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC/E,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB;IACnC,OAAO,gCAAwB,CAAC;AAClC,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,qBAAqB,CAAC,OAAe;IACnD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACxE,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":";AAAA,gCAAgC;AAChC,iDAAiD;;;AAuDjD,wCAEC;AAKD,8CAEC;AAKD,4CAEC;AAKD,sDAEC;AAWD,sDAKC;AA5FD;;GAEG;AACU,QAAA,eAAe,GAAG,OAAO,CAAC;AAEvC;;GAEG;AACU,QAAA,YAAY,GAAG,OAAO,CAAC;AAEpC;;;;GAIG;AACU,QAAA,kBAAkB,GAAG,CAAC,CAAC;AAEpC;;GAEG;AACU,QAAA,wBAAwB,GAAG;IACtC,MAAM;IACN,MAAM;IACN,IAAI;IACJ,cAAc;IACd,cAAc;IACd,OAAO;IACP,OAAO;CACC,CAAC;AAYX;;GAEG;AACU,QAAA,YAAY,GAAG;IAC1B,OAAO,EAAE,OAAO;IAChB,IAAI,EAAE,OAAO;IACb,kBAAkB,EAAE,gCAAwB;IAC5C,WAAW,EAAE,0BAA0B;CAC/B,CAAC;AAEX;;GAEG;AACH,SAAgB,cAAc;IAC5B,OAAO,oBAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB;IAC/B,OAAO,uBAAe,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,WAAmB;IAClD,OAAQ,gCAA8C,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC/E,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB;IACnC,OAAO,gCAAwB,CAAC;AAClC,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,qBAAqB,CAAC,OAAe;IACnD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACxE,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;AAC9C,CAAC"}

package/docs/guides/BUILD-AN-AGENT.md

@@ -12,12 +12,37 @@ We'll build a **signals agent** that serves audience segments via the `get_signa
 - `@adcp/sdk` installed (`npm install @adcp/sdk`)
 - `@modelcontextprotocol/sdk` (installed as a dependency of `@adcp/sdk`)
 
+## Two paths
+
+`@adcp/sdk` exposes two server entry points. Pick based on the agent
+shape:
+
+- **`createAdcpServerFromPlatform`** — recommended for new agents. You
+  declare a typed `DecisioningPlatform` (per-specialism interfaces:
+  `SalesPlatform`, `CreativeBuilderPlatform`, `AudiencePlatform`,
+  `SignalsPlatform`, etc.) and the framework wires capability
+  projection, idempotency, RFC 9421 signing, async tasks, status
+  normalization, lifecycle state, multi-tenant routing, and webhook
+  auto-emit on sync mutations. Compile-time enforcement via
+  `RequiredPlatformsFor<S>` catches missing methods before runtime.
+- **`createAdcpServer`** — the lower-level handler-bag API. Still
+  fully supported (it's the substrate `createAdcpServerFromPlatform`
+  calls into) and the right choice when you want fine control over
+  individual handlers, mid-migration from a v5 codebase, or
+  custom-shaped tools the platform interface doesn't yet model.
+
+The Quick Start below uses `createAdcpServer` for a single-tool signals
+agent because that's the smallest possible shape. For multi-specialism
+production agents (sales + creative + governance + brand-rights, etc.)
+read `docs/migration-5.x-to-6.x.md` for the platform path — and the
+`skills/build-decisioning-platform/` skill for a fuller walkthrough.
+
 ## Quick Start
 
 A minimal signals agent using `createAdcpServer`:
 
 ```typescript
-import { createAdcpServer, serve } from '@adcp/sdk';
+import { createAdcpServer, serve } from '@adcp/sdk/server/legacy/v5';
 
 serve(() => createAdcpServer({
   name: 'My Signals Agent',
@@ -62,7 +87,7 @@ npx @adcp/sdk@latest http://localhost:3001/mcp get_signals '{}'   # call get_sig
 The declarative way to build AdCP agents. You provide domain-grouped handler functions, and the framework handles schema validation, response formatting, account resolution, capabilities generation, and error catching.
 
 ```typescript
-import { createAdcpServer, serve } from '@adcp/sdk';
+import { createAdcpServer, serve } from '@adcp/sdk/server/legacy/v5';
 
 serve(() => createAdcpServer({
   name: 'My Publisher',
@@ -104,7 +129,7 @@ MCP is the default transport (`serve({ server: adcp })`). To additionally expose
 
 ```typescript
 import express from 'express';
-import { createAdcpServer, serve, createA2AAdapter } from '@adcp/sdk';
+import { createAdcpServer, serve, createA2AAdapter } from '@adcp/sdk/server/legacy/v5';
 
 const adcp = createAdcpServer({
   mediaBuy: { getProducts: async () => ({ products: [] }) },
@@ -337,7 +362,7 @@ The same validator runs on the `AdcpClient` side — storyboards and third-party
 If your agent receives signed requests from buyers, verify them using `requireAuthenticatedOrSigned()` — one call that bundles signature verification with credential fallback and `requiredFor` enforcement:
 
 ```typescript
-import { createAdcpServer, serve } from '@adcp/sdk';
+import { createAdcpServer, serve } from '@adcp/sdk/server/legacy/v5';
 import {
   verifySignatureAsAuthenticator,
   verifyApiKey,
@@ -517,7 +542,7 @@ Key storyboards for server-side builders:
 The `serve()` helper handles HTTP transport setup. Pass it a factory function that returns a configured `McpServer`:
 
 ```typescript
-import { createAdcpServer, serve } from '@adcp/sdk';
+import { createAdcpServer, serve } from '@adcp/sdk/server/legacy/v5';
 
 serve(() => createAdcpServer({ name: 'My Agent', version: '1.0.0', /* handlers */ }));
 serve(() => createAdcpServer({ /* ... */ }), { port: 8080 });          // custom port

package/docs/llms.txt

@@ -1,7 +1,7 @@
 # Ad Context Protocol (AdCP)
 
-> Generated at: 2026-04-28
-> Library: @adcp/sdk v5.21.1
+> Generated at: 2026-04-30
+> Library: @adcp/sdk v5.25.1
 > AdCP major version: 3
 > Canonical URL: https://adcontextprotocol.github.io/adcp-client/llms.txt
 
@@ -12,25 +12,36 @@ AdCP is an open protocol for AI agents to buy, manage, and optimize advertising
 ## Are you building a client or a server?
 
 - **Client** (calling existing agents): Continue reading — the Quick Start below is for you.
-- **Server** (implementing an agent that others call): Read `docs/guides/BUILD-AN-AGENT.md` instead. Minimal example:
+- **Server** (implementing an agent that others call): Read `docs/guides/BUILD-AN-AGENT.md` and `docs/migration-5.x-to-6.x.md`. v6 recommended path:
 
 ```typescript
-import { createTaskCapableServer, taskToolResponse, serve, GetSignalsRequestSchema } from '@adcp/sdk';
-
-function createAgent({ taskStore }) {
-  const server = createTaskCapableServer('My Agent', '1.0.0', { taskStore });
-  server.registerTool(
-    'get_signals',
-    { description: 'Discover segments.', inputSchema: GetSignalsRequestSchema.shape },
-    async (args) => taskToolResponse({ signals: [...], sandbox: true }, 'Found segments')
-  );
-  return server;
-}
-
-serve(createAgent); // http://localhost:3001/mcp
+import { serve } from '@adcp/sdk';
+import { createAdcpServerFromPlatform } from '@adcp/sdk/server';
+
+const platform = {
+  capabilities: {
+    specialisms: ['signal-marketplace'] as const,
+    creative_agents: [], channels: [], pricingModels: ['cpm'] as const, config: {},
+  },
+  statusMappers: {},
+  accounts: {
+    resolve: async () => ({ id: 'acc_1', ctx_metadata: {}, authInfo: { kind: 'api_key' } }),
+  },
+  signals: {
+    getSignals: async (req, ctx) => ({ signals: [/* ... */], sandbox: true }),
+    activateSignal: async (req, ctx) => ({ /* ... */ }),
+  },
+};
+
+serve(() => createAdcpServerFromPlatform(platform, {
+  name: 'My Signals Agent',
+  version: '1.0.0',
+})); // http://localhost:3001/mcp
 ```
 
-Low-level server (bypassing `createAdcpServer`)? Use `wrapEnvelope(inner, { replayed, context, operationId })` from `@adcp/sdk/server` to attach protocol envelope fields with the per-error-code allowlist applied (IDEMPOTENCY_CONFLICT drops `replayed`).
+Compile-time enforcement: `RequiredPlatformsFor<S>` catches missing specialism methods. Capability projection auto-derives `get_adcp_capabilities` blocks (`audience_targeting`, `conversion_tracking`, `compliance_testing.scenarios`, etc.). Idempotency, RFC 9421 signing, async tasks, status normalization, and sync-completion webhook auto-emit are framework-owned.
+
+Lower-level option: `createAdcpServer({ signals: { getSignals: ... } })` from `@adcp/sdk/server/legacy/v5` — handler-bag API. Still fully supported, the substrate the platform path calls into. Use when you need fine control over individual handlers, mid-migration from a v5 codebase, or custom-shaped tools the platform interface doesn't yet model. `wrapEnvelope(inner, { replayed, context, operationId })` from `@adcp/sdk/server` attaches protocol envelope fields with the per-error-code allowlist (IDEMPOTENCY_CONFLICT drops `replayed`).
 
 ## Quick Start (Client)
 

package/examples/README.md

@@ -54,7 +54,9 @@ ADCP_AGENTS_CONFIG='[{"id":"test-agent","name":"Test Agent","agent_uri":"https:/
 ```typescript
 import { ADCPMultiAgentClient, type AgentConfig } from '@adcp/sdk';
 
-const agents: AgentConfig[] = [/* your agents */];
+const agents: AgentConfig[] = [
+  /* your agents */
+];
 const client = new ADCPMultiAgentClient(agents);
 
 // Single agent operation