@adcp/sdk 7.10.2 → 7.11.1

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/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.map

@@ -1 +1 @@
-{"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;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;;;;;;;;;;;;;;;;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"}
+{"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

@@ -36,6 +36,7 @@ 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;
 /**
@@ -199,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.2";
+export declare const LIBRARY_VERSION = "7.11.1";
 /**
  * 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.2";
+    readonly library: "7.11.1";
     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-21T21:09:26.294Z";
+    readonly generatedAt: "2026-05-30T01:12:40.097Z";
 };
 /**
  * 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.2';
+exports.LIBRARY_VERSION = '7.11.1';
 /**
  * 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.2',
+    library: '7.11.1',
     adcp: '3.0.12',
     compatibleVersions: exports.COMPATIBLE_ADCP_VERSIONS,
-    generatedAt: '2026-05-21T21:09:26.294Z',
+    generatedAt: '2026-05-30T01:12:40.097Z',
 };
 /**
  * Get the AdCP specification version this library is built for

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adcp/sdk",
-  "version": "7.10.2",
+  "version": "7.11.1",
   "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