@adcp/sdk 7.10.1 → 7.11.0

package/dist/lib/utils/signal-id-builders.d.ts

@@ -17,5 +17,24 @@ export declare const signalId: {
     readonly catalog: typeof catalogSignalId;
     readonly agent: typeof agentSignalId;
 };
+/**
+ * Return the segment identifier from a `SignalID`, independent of source.
+ * Both `catalog` and `agent` variants carry the segment identifier in `id`.
+ *
+ * @example
+ * getSignalId(signalId.catalog({ data_provider_domain: 'polk.com', id: 'likely_ev_buyers' }))
+ * // → 'likely_ev_buyers'
+ */
+export declare function getSignalId(sid: SignalID): string;
+/**
+ * Return the issuer identifier from a `SignalID`, independent of source.
+ * - `source: 'catalog'` → `data_provider_domain` (e.g. `'polk.com'`)
+ * - `source: 'agent'`   → `agent_url` (e.g. `'https://liveramp.com/.well-known/adcp/signals'`)
+ *
+ * @example
+ * getSignalIssuer(signalId.catalog({ data_provider_domain: 'polk.com', id: 'likely_ev_buyers' }))
+ * // → 'polk.com'
+ */
+export declare function getSignalIssuer(sid: SignalID): string;
 export {};
 //# sourceMappingURL=signal-id-builders.d.ts.map

package/dist/lib/utils/signal-id-builders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signal-id-builders.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/signal-id-builders.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,KAAK,aAAa,GAAG,OAAO,CAAC,QAAQ,EAAE;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC;AAC9D,KAAK,WAAW,GAAG,OAAO,CAAC,QAAQ,EAAE;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAC1D,KAAK,MAAM,CAAC,CAAC,EAAE,GAAG,SAAS,MAAM,IAAI,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG;IAAE,MAAM,EAAE,GAAG,CAAA;CAAE,CAAC;AAEzE,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,GAAG,MAAM,CAAC,aAAa,EAAE,SAAS,CAAC,CAEvG;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAE/F;AAED,qDAAqD;AACrD,eAAO,MAAM,QAAQ;;;CAGX,CAAC"}
+{"version":3,"file":"signal-id-builders.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/signal-id-builders.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,KAAK,aAAa,GAAG,OAAO,CAAC,QAAQ,EAAE;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC;AAC9D,KAAK,WAAW,GAAG,OAAO,CAAC,QAAQ,EAAE;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAC1D,KAAK,MAAM,CAAC,CAAC,EAAE,GAAG,SAAS,MAAM,IAAI,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG;IAAE,MAAM,EAAE,GAAG,CAAA;CAAE,CAAC;AAEzE,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,GAAG,MAAM,CAAC,aAAa,EAAE,SAAS,CAAC,CAEvG;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAE/F;AAED,qDAAqD;AACrD,eAAO,MAAM,QAAQ;;;CAGX,CAAC;AAEX;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAEjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAKrD"}

package/dist/lib/utils/signal-id-builders.js

@@ -8,6 +8,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.signalId = void 0;
 exports.catalogSignalId = catalogSignalId;
 exports.agentSignalId = agentSignalId;
+exports.getSignalId = getSignalId;
+exports.getSignalIssuer = getSignalIssuer;
 /** Build a `catalog`-variant `SignalID`. Verifiable via the providers adagents.json. */
 function catalogSignalId(fields) {
     return { ...fields, source: 'catalog' };
@@ -21,4 +23,32 @@ exports.signalId = {
     catalog: catalogSignalId,
     agent: agentSignalId,
 };
+/**
+ * Return the segment identifier from a `SignalID`, independent of source.
+ * Both `catalog` and `agent` variants carry the segment identifier in `id`.
+ *
+ * @example
+ * getSignalId(signalId.catalog({ data_provider_domain: 'polk.com', id: 'likely_ev_buyers' }))
+ * // → 'likely_ev_buyers'
+ */
+function getSignalId(sid) {
+    return sid.id;
+}
+/**
+ * Return the issuer identifier from a `SignalID`, independent of source.
+ * - `source: 'catalog'` → `data_provider_domain` (e.g. `'polk.com'`)
+ * - `source: 'agent'`   → `agent_url` (e.g. `'https://liveramp.com/.well-known/adcp/signals'`)
+ *
+ * @example
+ * getSignalIssuer(signalId.catalog({ data_provider_domain: 'polk.com', id: 'likely_ev_buyers' }))
+ * // → 'polk.com'
+ */
+function getSignalIssuer(sid) {
+    if (sid.source === 'catalog')
+        return sid.data_provider_domain;
+    if (sid.source === 'agent')
+        return sid.agent_url;
+    const _exhaustive = sid;
+    throw new Error(`Unhandled SignalID source: ${String(_exhaustive.source)}`);
+}
 //# sourceMappingURL=signal-id-builders.js.map

package/dist/lib/utils/signal-id-builders.js.map

@@ -1 +1 @@
-{"version":3,"file":"signal-id-builders.js","sourceRoot":"","sources":["../../../src/lib/utils/signal-id-builders.ts"],"names":[],"mappings":";AAAA,kEAAkE;AAClE,yEAAyE;AACzE,uEAAuE;AACvE,0EAA0E;AAC1E,2CAA2C;;;AAS3C,0CAEC;AAGD,sCAEC;AARD,wFAAwF;AACxF,SAAgB,eAAe,CAAC,MAAqC;IACnE,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAC1C,CAAC;AAED,mFAAmF;AACnF,SAAgB,aAAa,CAAC,MAAmC;IAC/D,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACxC,CAAC;AAED,qDAAqD;AACxC,QAAA,QAAQ,GAAG;IACtB,OAAO,EAAE,eAAe;IACxB,KAAK,EAAE,aAAa;CACZ,CAAC"}
+{"version":3,"file":"signal-id-builders.js","sourceRoot":"","sources":["../../../src/lib/utils/signal-id-builders.ts"],"names":[],"mappings":";AAAA,kEAAkE;AAClE,yEAAyE;AACzE,uEAAuE;AACvE,0EAA0E;AAC1E,2CAA2C;;;AAS3C,0CAEC;AAGD,sCAEC;AAgBD,kCAEC;AAWD,0CAKC;AA1CD,wFAAwF;AACxF,SAAgB,eAAe,CAAC,MAAqC;IACnE,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAC1C,CAAC;AAED,mFAAmF;AACnF,SAAgB,aAAa,CAAC,MAAmC;IAC/D,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACxC,CAAC;AAED,qDAAqD;AACxC,QAAA,QAAQ,GAAG;IACtB,OAAO,EAAE,eAAe;IACxB,KAAK,EAAE,aAAa;CACZ,CAAC;AAEX;;;;;;;GAOG;AACH,SAAgB,WAAW,CAAC,GAAa;IACvC,OAAO,GAAG,CAAC,EAAE,CAAC;AAChB,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,eAAe,CAAC,GAAa;IAC3C,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC,oBAAoB,CAAC;IAC9D,IAAI,GAAG,CAAC,MAAM,KAAK,OAAO;QAAE,OAAO,GAAG,CAAC,SAAS,CAAC;IACjD,MAAM,WAAW,GAAU,GAAG,CAAC;IAC/B,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,CAAE,WAAmC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACvG,CAAC"}

package/dist/lib/utils/tool-request-schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-request-schemas.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/tool-request-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,oBAAoB,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAkFnE,CAAC"}
+{"version":3,"file":"tool-request-schemas.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/tool-request-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,oBAAoB,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAqFnE,CAAC"}

package/dist/lib/utils/tool-request-schemas.js

@@ -60,6 +60,9 @@ exports.TOOL_REQUEST_SCHEMAS = {
     // Product discovery & media buy
     get_products: schemas.GetProductsRequestSchema,
     create_media_buy: withOptionalAccount(schemas.CreateMediaBuyRequestSchema),
+    // UpdateMediaBuyRequestSchema is annotated `z.ZodType<...>` (TS7056 workaround
+    // in scripts/generate-zod-from-ts.ts) rather than `z.ZodObject`. Cast back to
+    // ZodObject at the one site that needs it; runtime shape is unchanged.
     update_media_buy: withOptionalAccount(schemas.UpdateMediaBuyRequestSchema),
     get_media_buys: schemas.GetMediaBuysRequestSchema,
     get_media_buy_delivery: schemas.GetMediaBuyDeliveryRequestSchema,

package/dist/lib/utils/tool-request-schemas.js.map

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

package/dist/lib/v2/projection/canonical-properties.d.ts

@@ -1,8 +1,10 @@
 /**
  * Read structural properties off the canonical format schemas at
- * `schemas/cache/<version>/formats/canonical/<kind>.json`. The
- * projection layer needs `v1_translatable` per canonical to honor the
- * normative rule from `v1-canonical-mapping.json`:
+ * `dist/lib/schemas-data/<version>/formats/canonical/<kind>.json` in
+ * published tarballs, or `schemas/cache/<version>/formats/canonical/...`
+ * in a source checkout. The projection layer needs `v1_translatable`
+ * per canonical to honor the normative rule from
+ * `v1-canonical-mapping.json`:
  *
  *   > SDKs encountering `v1_translatable: false` on a canonical SHOULD
  *   > NOT emit `FORMAT_PROJECTION_FAILED` (which signals registry-

package/dist/lib/v2/projection/canonical-properties.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canonical-properties.d.ts","sourceRoot":"","sources":["../../../../src/lib/v2/projection/canonical-properties.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAoCnD;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAuB5E;AAED,gEAAgE;AAChE,wBAAgB,8BAA8B,IAAI,IAAI,CAGrD"}
+{"version":3,"file":"canonical-properties.d.ts","sourceRoot":"","sources":["../../../../src/lib/v2/projection/canonical-properties.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAmDnD;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAuB5E;AAED,gEAAgE;AAChE,wBAAgB,8BAA8B,IAAI,IAAI,CAGrD"}

package/dist/lib/v2/projection/canonical-properties.js

@@ -1,9 +1,11 @@
 "use strict";
 /**
  * Read structural properties off the canonical format schemas at
- * `schemas/cache/<version>/formats/canonical/<kind>.json`. The
- * projection layer needs `v1_translatable` per canonical to honor the
- * normative rule from `v1-canonical-mapping.json`:
+ * `dist/lib/schemas-data/<version>/formats/canonical/<kind>.json` in
+ * published tarballs, or `schemas/cache/<version>/formats/canonical/...`
+ * in a source checkout. The projection layer needs `v1_translatable`
+ * per canonical to honor the normative rule from
+ * `v1-canonical-mapping.json`:
  *
  *   > SDKs encountering `v1_translatable: false` on a canonical SHOULD
  *   > NOT emit `FORMAT_PROJECTION_FAILED` (which signals registry-
@@ -34,18 +36,33 @@ function loadCanonicalSchema(kind, cacheRoot) {
     return JSON.parse((0, fs_1.readFileSync)(file, 'utf-8'));
 }
 function findCacheRoot() {
-    // Track whichever 3.1+ cache the workspace has synced. `latest` is the
-    // last-resort candidate because in workspaces pinned to a 3.0.x GA it
-    // points at a cache that lacks canonical-format schemas — the loader
-    // would silently return `true` for every v1_translatable check and miss
-    // the 4 inherently-v2 canonicals.
-    const candidates = cache_versions_1.BETA_VERSIONS_TO_TRY.map(v => path_1.default.join(__dirname, '..', '..', '..', '..', 'schemas', 'cache', v));
+    // Resolution order:
+    //   1. Published-tarball path adjacent to the compiled loader —
+    //      `dist/lib/schemas-data/<version>/`. Populated by
+    //      `scripts/copy-schemas-to-dist.ts` during `build:lib`.
+    //   2. Source-tree path `schemas/cache/<version>/` relative to the
+    //      loader's source location. Used when running from a source
+    //      checkout (e.g. `tsx`, vitest) before `build:lib`.
+    //
+    // Within both, versions are tried in `BETA_VERSIONS_TO_TRY` order:
+    // current beta wins; older betas survive for adopters who haven't
+    // synced; `latest` is last-resort and skipped in dist (the symlink
+    // is intentionally not copied — adopters pinned to 3.0.x GA hit the
+    // throw below rather than silently picking up a v3.0 cache that
+    // lacks canonical-format schemas).
+    const candidates = [
+        ...cache_versions_1.BETA_VERSIONS_TO_TRY.map(v => path_1.default.join(__dirname, '..', '..', 'schemas-data', v)),
+        ...cache_versions_1.BETA_VERSIONS_TO_TRY.map(v => path_1.default.join(__dirname, '..', '..', '..', '..', 'schemas', 'cache', v)),
+    ];
     for (const c of candidates) {
         if ((0, fs_1.existsSync)(c))
             return c;
     }
-    throw new Error(`No 3.1+ schema cache found. Run \`npm run sync-schemas\` for a 3.1+ AdCP version. ` +
-        `Looked in: ${candidates.join(', ')}.`);
+    throw new Error(`No 3.1+ schema cache found. Looked in: ${candidates.join(', ')}. ` +
+        `This indicates a corrupted @adcp/sdk install or an SDK packaging regression — ` +
+        `please file an issue at https://github.com/adcontextprotocol/adcp-client/issues with ` +
+        `your install method (npm/yarn/pnpm) and Node version. ` +
+        `If you're working from a source checkout, run \`npm run sync-schemas:3.1-beta\` then \`npm run build:lib\`.`);
 }
 /**
  * Returns true when this canonical has a v1 named-format equivalent;

package/dist/lib/v2/projection/canonical-properties.js.map

@@ -1 +1 @@
-{"version":3,"file":"canonical-properties.js","sourceRoot":"","sources":["../../../../src/lib/v2/projection/canonical-properties.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;;;AAmDH,8DAuBC;AAGD,wEAGC;AA9ED,2BAA8C;AAC9C,gDAAwB;AAExB,qDAAwD;AAUxD,IAAI,KAAK,GAA6C,IAAI,CAAC;AAC3D,IAAI,WAAW,GAAmB,IAAI,CAAC;AAEvC,SAAS,mBAAmB,CAAC,IAAyB,EAAE,SAAiB;IACvE,MAAM,IAAI,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;IAC1E,IAAI,CAAC,IAAA,eAAU,EAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,IAAI,EAAE,OAAO,CAAC,CAAoB,CAAC;AACpE,CAAC;AAED,SAAS,aAAa;IACpB,uEAAuE;IACvE,sEAAsE;IACtE,qEAAqE;IACrE,wEAAwE;IACxE,kCAAkC;IAClC,MAAM,UAAU,GAAG,qCAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IACtH,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,IAAA,eAAU,EAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,MAAM,IAAI,KAAK,CACb,oFAAoF;QAClF,cAAc,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACzC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,yBAAyB,CAAC,IAAyB;IACjE,IAAI,KAAK,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;IAEtD,IAAI,KAAK,KAAK,IAAI;QAAE,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;IAEtC,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;IAElC,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAA8B,EAAE,SAAS,CAAC,CAAC;QAC5E,MAAM,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,eAAe,EAAE,OAAO,CAAC;QACtD,WAAW,GAAG,OAAO,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACpD,CAAC;IAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,OAAO,CAAC;IAC9D,MAAM,KAAK,GAAG,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC;IACrE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACvB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,gEAAgE;AAChE,SAAgB,8BAA8B;IAC5C,KAAK,GAAG,IAAI,CAAC;IACb,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC"}
+{"version":3,"file":"canonical-properties.js","sourceRoot":"","sources":["../../../../src/lib/v2/projection/canonical-properties.ts"],"names":[],"mappings":"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"}

package/dist/lib/v2/projection/constants.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Shared URL anchors for the v2 projection layer.
+ *
+ * Post-adcontextprotocol/adcp#4866, `creative.adcontextprotocol.org` is
+ * the canonical AAO (Ad Agents Open) host. We reuse it here as the
+ * `agent_url` base for synthesized v1 refs so projected values match
+ * seller-asserted fixtures byte-for-byte.
+ *
+ * This constant is NOT the `$ref`-resolution trust anchor — that role
+ * belongs to `DEFAULT_MIRROR_HOSTS` in `format-schema/sandbox-refs.ts`,
+ * which is an allowlist of *hostnames* gating HTTP fetches of
+ * `format_schema.uri` and `$ref` targets. Same host, distinct purposes:
+ * one is a fetch-time SSRF gate, the other is a content URL written
+ * into projected `V1FormatId.agent_url` values that are never fetched.
+ * Deriving one from the other would couple the SSRF gate to a
+ * presentation concern.
+ */
+/**
+ * Canonical AAO base URL used as `agent_url` in synthesized v1 format
+ * references. Registry synthesis is implementation-defined per the AdCP
+ * spec — this value is a best-effort fallback that mirrors the AAO
+ * reference agent URL, not a normative wire contract.
+ *
+ * @see {@link https://github.com/adcontextprotocol/adcp/issues/4866} —
+ * collapse to a single canonical AAO host.
+ */
+export declare const AAO_CANONICAL_AGENT_URL = "https://creative.adcontextprotocol.org/";
+//# sourceMappingURL=constants.d.ts.map

package/dist/lib/v2/projection/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/lib/v2/projection/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,4CAA4C,CAAC"}

package/dist/lib/v2/projection/constants.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * Shared URL anchors for the v2 projection layer.
+ *
+ * Post-adcontextprotocol/adcp#4866, `creative.adcontextprotocol.org` is
+ * the canonical AAO (Ad Agents Open) host. We reuse it here as the
+ * `agent_url` base for synthesized v1 refs so projected values match
+ * seller-asserted fixtures byte-for-byte.
+ *
+ * This constant is NOT the `$ref`-resolution trust anchor — that role
+ * belongs to `DEFAULT_MIRROR_HOSTS` in `format-schema/sandbox-refs.ts`,
+ * which is an allowlist of *hostnames* gating HTTP fetches of
+ * `format_schema.uri` and `$ref` targets. Same host, distinct purposes:
+ * one is a fetch-time SSRF gate, the other is a content URL written
+ * into projected `V1FormatId.agent_url` values that are never fetched.
+ * Deriving one from the other would couple the SSRF gate to a
+ * presentation concern.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AAO_CANONICAL_AGENT_URL = void 0;
+/**
+ * Canonical AAO base URL used as `agent_url` in synthesized v1 format
+ * references. Registry synthesis is implementation-defined per the AdCP
+ * spec — this value is a best-effort fallback that mirrors the AAO
+ * reference agent URL, not a normative wire contract.
+ *
+ * @see {@link https://github.com/adcontextprotocol/adcp/issues/4866} —
+ * collapse to a single canonical AAO host.
+ */
+exports.AAO_CANONICAL_AGENT_URL = 'https://creative.adcontextprotocol.org/';
+//# sourceMappingURL=constants.js.map

package/dist/lib/v2/projection/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/lib/v2/projection/constants.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AAEH;;;;;;;;GAQG;AACU,QAAA,uBAAuB,GAAG,yCAAyC,CAAC"}

package/dist/lib/v2/projection/registry.d.ts

@@ -1,6 +1,8 @@
 /**
  * Loader + reverse-lookup for the v1↔v2 canonical-format registry
- * (`schemas/cache/<version>/registries/v1-canonical-mapping.json`).
+ * (`dist/lib/schemas-data/<version>/registries/v1-canonical-mapping.json`
+ * in published tarballs; `schemas/cache/<version>/registries/...` in a
+ * source checkout).
  *
  * The spec authors the registry **forward** — given a v1 named format,
  * find the v2 canonical. v2 → v1 projection needs the inverse direction,
@@ -50,11 +52,19 @@ interface CanonicalMappingRegistry {
     mappings: RegistryEntry[];
 }
 /**
- * Load the registry from a known schema-cache version. Tries `3.1.0-beta.2`
- * first (current beta), then `3.1.0-beta.1`, then `3.1.0-beta.0`, then the
- * `latest` symlink — whichever ships `registries/v1-canonical-mapping.json`
- * is the source of truth. The pin floats deliberately so the registry tracks
- * whichever 3.1+ cache the workspace has synced.
+ * Load the registry from a known schema-cache version. Resolution order:
+ *
+ *   1. Caller-supplied `cacheRoot` (test hook / explicit pin).
+ *   2. Published-tarball path adjacent to the compiled loader —
+ *      `dist/lib/schemas-data/<version>/registries/v1-canonical-mapping.json`.
+ *      Populated by `scripts/copy-schemas-to-dist.ts` during `build:lib`.
+ *   3. Source-tree path `schemas/cache/<version>/registries/...` relative
+ *      to the loader's source location. Used when running from a source
+ *      checkout (e.g. `tsx`, vitest) before `build:lib`.
+ *
+ * Within (2) and (3), versions are tried in `BETA_VERSIONS_TO_TRY` order
+ * — current beta wins; older betas survive for adopters who haven't
+ * synced; `latest` is last-resort.
  *
  * Memoized — the registry is small and immutable per version.
  */

package/dist/lib/v2/projection/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/lib/v2/projection/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG/D,UAAU,sBAAsB;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE;QACX,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1B,UAAU,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAClD,CAAC;CACH;AAED,UAAU,aAAa;IACrB,UAAU,EAAE,sBAAsB,CAAC;IACnC,EAAE,EAAE;QACF,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,CAAC;IACF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,wBAAwB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAID;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,wBAAwB,CAiBzE;AAED,8CAA8C;AAC9C,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,mBAAmB,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAepF;AAQD;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,sBAAsB,GAAG,gBAAgB,GAAG,SAAS,CAkCrG;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,UAAU,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,mBAAmB,CAgClH"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/lib/v2/projection/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAI/D,UAAU,sBAAsB;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE;QACX,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1B,UAAU,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAClD,CAAC;CACH;AAED,UAAU,aAAa;IACrB,UAAU,EAAE,sBAAsB,CAAC;IACnC,EAAE,EAAE;QACF,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,CAAC;IACF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,wBAAwB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,wBAAwB,CAyBzE;AAED,8CAA8C;AAC9C,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,mBAAmB,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAepF;AAQD;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,sBAAsB,GAAG,gBAAgB,GAAG,SAAS,CAkCrG;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,UAAU,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,mBAAmB,CAgClH"}

package/dist/lib/v2/projection/registry.js

@@ -1,7 +1,9 @@
 "use strict";
 /**
  * Loader + reverse-lookup for the v1↔v2 canonical-format registry
- * (`schemas/cache/<version>/registries/v1-canonical-mapping.json`).
+ * (`dist/lib/schemas-data/<version>/registries/v1-canonical-mapping.json`
+ * in published tarballs; `schemas/cache/<version>/registries/...` in a
+ * source checkout).
  *
  * The spec authors the registry **forward** — given a v1 named format,
  * find the v2 canonical. v2 → v1 projection needs the inverse direction,
@@ -34,14 +36,23 @@ exports.forwardLookupByStructural = forwardLookupByStructural;
 exports.reverseLookup = reverseLookup;
 const fs_1 = require("fs");
 const path_1 = __importDefault(require("path"));
+const constants_1 = require("./constants");
 const cache_versions_1 = require("./cache-versions");
 let cached = null;
 /**
- * Load the registry from a known schema-cache version. Tries `3.1.0-beta.2`
- * first (current beta), then `3.1.0-beta.1`, then `3.1.0-beta.0`, then the
- * `latest` symlink — whichever ships `registries/v1-canonical-mapping.json`
- * is the source of truth. The pin floats deliberately so the registry tracks
- * whichever 3.1+ cache the workspace has synced.
+ * Load the registry from a known schema-cache version. Resolution order:
+ *
+ *   1. Caller-supplied `cacheRoot` (test hook / explicit pin).
+ *   2. Published-tarball path adjacent to the compiled loader —
+ *      `dist/lib/schemas-data/<version>/registries/v1-canonical-mapping.json`.
+ *      Populated by `scripts/copy-schemas-to-dist.ts` during `build:lib`.
+ *   3. Source-tree path `schemas/cache/<version>/registries/...` relative
+ *      to the loader's source location. Used when running from a source
+ *      checkout (e.g. `tsx`, vitest) before `build:lib`.
+ *
+ * Within (2) and (3), versions are tried in `BETA_VERSIONS_TO_TRY` order
+ * — current beta wins; older betas survive for adopters who haven't
+ * synced; `latest` is last-resort.
  *
  * Memoized — the registry is small and immutable per version.
  */
@@ -50,7 +61,10 @@ function loadRegistry(cacheRoot) {
         return cached;
     const candidates = cacheRoot
         ? [path_1.default.join(cacheRoot, 'registries', 'v1-canonical-mapping.json')]
-        : cache_versions_1.BETA_VERSIONS_TO_TRY.map(v => path_1.default.join(__dirname, '..', '..', '..', '..', 'schemas', 'cache', v, 'registries', 'v1-canonical-mapping.json'));
+        : [
+            ...cache_versions_1.BETA_VERSIONS_TO_TRY.map(v => path_1.default.join(__dirname, '..', '..', 'schemas-data', v, 'registries', 'v1-canonical-mapping.json')),
+            ...cache_versions_1.BETA_VERSIONS_TO_TRY.map(v => path_1.default.join(__dirname, '..', '..', '..', '..', 'schemas', 'cache', v, 'registries', 'v1-canonical-mapping.json')),
+        ];
     for (const file of candidates) {
         if ((0, fs_1.existsSync)(file)) {
             cached = JSON.parse((0, fs_1.readFileSync)(file, 'utf-8'));
@@ -58,7 +72,10 @@ function loadRegistry(cacheRoot) {
         }
     }
     throw new Error(`v1-canonical-mapping.json not found. Looked in: ${candidates.join(', ')}. ` +
-        `Run \`npm run sync-schemas\` for a 3.1+ AdCP version.`);
+        `This indicates a corrupted @adcp/sdk install or an SDK packaging regression — ` +
+        `please file an issue at https://github.com/adcontextprotocol/adcp-client/issues with ` +
+        `your install method (npm/yarn/pnpm) and Node version. ` +
+        `If you're working from a source checkout, run \`npm run sync-schemas:3.1-beta\` then \`npm run build:lib\`.`);
 }
 /** Test hook: reset the memoized registry. */
 function _resetRegistryCache() {
@@ -183,13 +200,17 @@ function reverseLookup(canonical, params) {
 }
 /**
  * Synthesize a v1 format_id from a literal glob and the registry's recorded params.
- * Uses the AAO canonical agent_url base form with trailing slash, matching the
- * seller-asserted fixtures in the spec's reference set
- * (`creative.adcontextprotocol.org/`).
+ *
+ * Uses {@link AAO_CANONICAL_AGENT_URL} as the `agent_url` base. Note that this
+ * value is **non-normative**: the AdCP spec treats registry synthesis as
+ * implementation-defined, so the resulting `agent_url` is a best-effort
+ * fallback that mirrors the AAO reference agent, not a wire-truth value.
+ * Callers that require a seller-authoritative `agent_url` must use the
+ * `v1_format_ref` from the seller's response directly.
  */
 function synthesizeFormatIdFromGlob(glob, registryParams) {
     const out = {
-        agent_url: 'https://creative.adcontextprotocol.org/',
+        agent_url: constants_1.AAO_CANONICAL_AGENT_URL,
         id: glob,
     };
     if (typeof registryParams.width === 'number')

package/dist/lib/v2/projection/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../src/lib/v2/projection/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../src/lib/v2/projection/registry.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 = "7.10.1";
+export declare const LIBRARY_VERSION = "7.11.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.10.1";
+    readonly library: "7.11.0";
     readonly adcp: "3.0.12";
     readonly compatibleVersions: readonly ["v2.5", "v2.6", "v3", "3.0.0-beta.1", "3.0.0-beta.3", "3.1.0-beta.1", "3.1.0-beta.2", "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", "3.0.12"];
-    readonly generatedAt: "2026-05-21T16:37:35.328Z";
+    readonly generatedAt: "2026-05-22T10:05:34.016Z";
 };
 /**
  * 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.10.1';
+exports.LIBRARY_VERSION = '7.11.0';
 /**
  * AdCP specification version this library is built for
  */
@@ -55,10 +55,10 @@ exports.COMPATIBLE_ADCP_VERSIONS = [
  * Full version information
  */
 exports.VERSION_INFO = {
-    library: '7.10.1',
+    library: '7.11.0',
     adcp: '3.0.12',
     compatibleVersions: exports.COMPATIBLE_ADCP_VERSIONS,
-    generatedAt: '2026-05-21T16:37:35.328Z',
+    generatedAt: '2026-05-22T10:05:34.016Z',
 };
 /**
  * Get the AdCP specification version this library is built for

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adcp/sdk",
-  "version": "7.10.1",
+  "version": "7.11.0",
   "description": "AdCP SDK — client, server, and compliance harnesses for the AdContext Protocol (MCP + A2A)",
   "workspaces": [
     ".",

package/skills/SHAPE-GOTCHAS.md

@@ -87,6 +87,11 @@ signalId.agent({ agent_url: 'https://liveramp.com/.well-known/adcp/signals', id:
 A bare-string `signal_ids` filter is rejected by the request type as soon
 as you stop typing it as `any`.
 
+**Extract fields from a received `SignalID`:** use `getSignalId(sid)` (returns
+`id`) and `getSignalIssuer(sid)` (returns `data_provider_domain` or
+`agent_url`). Do not reach for `sid.catalog_id` or `sid.agent_id` — those
+fields do not exist and TypeScript will not always catch the error.
+
 ---
 
 ## 3. `VASTAsset` requires an embedded `delivery_type` discriminator