@adcp/sdk 6.13.2 → 6.15.0

package/dist/lib/server/error-arm-tools.js

@@ -0,0 +1,219 @@
+"use strict";
+/**
+ * Per-AdCP-version registry of tool names whose response schema declares
+ * a typed Error arm — i.e. an arm of the top-level `oneOf` / `anyOf`
+ * whose `required` includes `"errors"`.
+ *
+ * The dispatcher uses this set to decide whether to auto-emit the
+ * payload-layer `errors[]` array alongside the envelope-layer
+ * `{adcp_error}` block on the failure path. Tools NOT in this set keep
+ * the envelope-only shape — surfacing `errors[]` on a tool whose
+ * response schema doesn't define it would add a key the schema
+ * doesn't expect.
+ *
+ * Built lazily at first use from the bundled schema cache (the same
+ * tree `schema-loader.ts` reads). The set is computed once per bundle
+ * key (`resolveBundleKey('3.0.0')` → `'3.0'`) and memoised — the schema
+ * tree is read-only at runtime, so a single scan is sufficient.
+ *
+ * Spec basis: `error-code.json#GOVERNANCE_DENIED` and
+ * `#GOVERNANCE_UNAVAILABLE` both prescribe "populate `errors[].code` in
+ * the payload AND `adcp_error.code` on the envelope per the two-layer
+ * model" for tasks whose response defines a typed Error arm but no
+ * structured rejection arm. RFC: `docs/proposals/adcperror-two-layer-emission.md`.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getToolsWithErrorArm = getToolsWithErrorArm;
+exports._resetErrorArmToolsCache = _resetErrorArmToolsCache;
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+const version_1 = require("../version");
+const schema_loader_1 = require("../validation/schema-loader");
+/**
+ * Resolve the schema-cache root for a given AdCP version.
+ *
+ * Mirrors `schema-loader.ts:resolveSchemaRoot` so the two-layer scan
+ * reads from the same directory the AJV validators compile against.
+ * Kept as a private duplicate (rather than exporting from schema-loader)
+ * to keep the schema-loader's public surface narrow — that module is
+ * about validators, not generic cache traversal.
+ *
+ * Returns `undefined` when no bundle exists for the version. The
+ * dispatcher gates on a non-empty set, so a missing bundle silently
+ * disables the auto-wrap (callers without schemas can't have tools to
+ * wrap anyway).
+ */
+function resolveBundledRoot(version) {
+    const key = (0, schema_loader_1.resolveBundleKey)(version);
+    // Built layout (dist): dist/lib/schemas-data/<bundle-key>/bundled
+    const distCandidate = path_1.default.join(__dirname, '..', 'schemas-data', key, 'bundled');
+    if ((0, fs_1.existsSync)(distCandidate))
+        return distCandidate;
+    // Source-tree layout (dev): schemas/cache/<exact-version>/bundled
+    const cacheRoot = path_1.default.join(__dirname, '..', '..', '..', 'schemas', 'cache');
+    const exactCandidate = path_1.default.join(cacheRoot, version, 'bundled');
+    if ((0, fs_1.existsSync)(exactCandidate))
+        return exactCandidate;
+    // Latest-patch fallback for stable minor pins (matches schema-loader).
+    const minorMatch = key.match(/^(\d+)\.(\d+)$/);
+    if (minorMatch && (0, fs_1.existsSync)(cacheRoot)) {
+        const [, major, minor] = minorMatch;
+        const prefix = `${major}.${minor}.`;
+        const cached = (0, fs_1.readdirSync)(cacheRoot, { withFileTypes: true })
+            .filter(e => e.isDirectory() &&
+            e.name.startsWith(prefix) &&
+            !e.name.endsWith('.previous') &&
+            /^\d+\.\d+\.\d+$/.test(e.name))
+            .map(e => ({ name: e.name, patch: parseInt(e.name.slice(prefix.length), 10) }))
+            .filter(c => Number.isFinite(c.patch))
+            .sort((a, b) => b.patch - a.patch);
+        if (cached.length > 0) {
+            return path_1.default.join(cacheRoot, cached[0].name, 'bundled');
+        }
+    }
+    return undefined;
+}
+/**
+ * Resolve a `oneOf`/`anyOf` arm one level of `$ref` indirection. Bundled
+ * schemas inline most refs but a few domains keep an extra hop into
+ * `$defs`/`definitions`.
+ */
+function resolveBranch(branch, rootSchema) {
+    if (!branch || typeof branch !== 'object')
+        return undefined;
+    const obj = branch;
+    const ref = obj.$ref;
+    if (typeof ref === 'string') {
+        const match = ref.match(/^#\/(\$defs|definitions)\/(.+)$/);
+        if (match && match[1] && match[2]) {
+            const root = rootSchema[match[1]];
+            const target = root?.[match[2]];
+            if (target && typeof target === 'object')
+                return target;
+        }
+        return undefined;
+    }
+    return obj;
+}
+/**
+ * Inspect a branch and, if it declares `required: [..., "errors", ...]`,
+ * return its descriptor (capturing any sibling `const`-typed required
+ * fields). Returns undefined for branches that don't require `errors[]`
+ * or for rejection arms (`AcquireRightsRejected` / `CreativeRejected`)
+ * which declare `not: { required: ["errors"] }` and explicitly forbid
+ * the two-layer wire (RFC § 1.2).
+ */
+function describeErrorArm(branch, rootSchema) {
+    const resolved = resolveBranch(branch, rootSchema);
+    if (!resolved)
+        return undefined;
+    const required = resolved.required;
+    if (!Array.isArray(required) || !required.includes('errors'))
+        return undefined;
+    const extraRequired = {};
+    const properties = resolved.properties;
+    if (properties) {
+        for (const fieldName of required) {
+            if (typeof fieldName !== 'string' || fieldName === 'errors')
+                continue;
+            const propSchema = properties[fieldName];
+            if (propSchema && 'const' in propSchema) {
+                extraRequired[fieldName] = propSchema.const;
+            }
+            // Required fields without a `const` discriminator (e.g. dynamic
+            // values) can't be auto-synthesised. The spec convention for
+            // Error arms is `errors[]` plus optional `success`/`response_type`
+            // constants — so far no tool requires anything else.
+        }
+    }
+    return { extraRequired: Object.freeze(extraRequired) };
+}
+/**
+ * Read every `*-response.json` under the bundled cache root and return
+ * a tool-name → descriptor map for tools whose top-level `oneOf`/`anyOf`
+ * declares an Error arm.
+ *
+ * Tool names are derived from the filename stem (`create-media-buy` →
+ * `create_media_buy`) to match the dispatcher's `toolName` key.
+ */
+function scanForErrorArmTools(bundledRoot) {
+    const map = new Map();
+    const files = [];
+    function walk(dir) {
+        if (!(0, fs_1.existsSync)(dir))
+            return;
+        for (const entry of (0, fs_1.readdirSync)(dir, { withFileTypes: true })) {
+            const full = path_1.default.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                walk(full);
+            }
+            else if (entry.isFile() && entry.name.endsWith('-response.json')) {
+                files.push(full);
+            }
+        }
+    }
+    walk(bundledRoot);
+    for (const file of files) {
+        let schema;
+        try {
+            schema = JSON.parse((0, fs_1.readFileSync)(file, 'utf-8'));
+        }
+        catch {
+            continue;
+        }
+        const branches = (schema.oneOf ?? schema.anyOf);
+        if (!Array.isArray(branches))
+            continue;
+        let descriptor;
+        for (const branch of branches) {
+            const candidate = describeErrorArm(branch, schema);
+            if (candidate) {
+                descriptor = candidate;
+                break;
+            }
+        }
+        if (!descriptor)
+            continue;
+        const base = path_1.default.basename(file, '-response.json');
+        const toolName = base.replace(/-/g, '_');
+        map.set(toolName, descriptor);
+    }
+    return map;
+}
+/** Memoised per-bundle-key result. Empty map when the bundle is missing. */
+const cachedMaps = new Map();
+/**
+ * Per-tool descriptors for tools whose response schema (at `version`)
+ * declares a top-level Error arm requiring `errors[]`. Dispatcher-side
+ * gate for two-layer auto-emission, plus the per-arm constants the
+ * dispatcher needs to set when synthesising the wrap.
+ *
+ * Scans the bundled schema cache lazily on first call per bundle key
+ * (one read per minor version per process). Returns a frozen, empty map
+ * when no schema bundle is reachable — the dispatcher early-returns on
+ * `map.size === 0`, so a missing bundle silently disables the wrap
+ * rather than breaking server startup.
+ */
+function getToolsWithErrorArm(version = version_1.ADCP_VERSION) {
+    const key = (0, schema_loader_1.resolveBundleKey)(version);
+    const cached = cachedMaps.get(key);
+    if (cached)
+        return cached;
+    const root = resolveBundledRoot(version);
+    if (!root) {
+        const empty = new Map();
+        cachedMaps.set(key, empty);
+        return empty;
+    }
+    const map = scanForErrorArmTools(root);
+    cachedMaps.set(key, map);
+    return map;
+}
+/** Test hook: clear the per-bundle-key cache. */
+function _resetErrorArmToolsCache() {
+    cachedMaps.clear();
+}
+//# sourceMappingURL=error-arm-tools.js.map

package/dist/lib/server/error-arm-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-arm-tools.js","sourceRoot":"","sources":["../../../src/lib/server/error-arm-tools.ts"],"names":[],"mappings":"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"}

package/dist/lib/server/errors.d.ts

@@ -109,6 +109,16 @@ export interface AdcpErrorResponse {
  * the envelope can't become a stolen-key read oracle. Codes without a
  * registered allowlist pass through unchanged.
  *
+ * **Two-layer wire shape.** This builder emits the envelope layer
+ * (`structuredContent.adcp_error`) only. For tools whose response
+ * schema declares a typed Error arm (`errors[]` required at the top
+ * level), the framework dispatcher synthesises the payload-layer
+ * `errors[]` from the same data at finalize time, so the wire carries
+ * both the envelope marker and the typed Error arm together — no
+ * adopter code change required. The list of affected tools is derived
+ * at server build from the bundled schema cache. RFC:
+ * `docs/proposals/adcperror-two-layer-emission.md`.
+ *
  * @example
  * ```typescript
  * import { adcpError } from '@adcp/sdk';

package/dist/lib/server/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/lib/server/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGtE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/E;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/E;AAED,MAAM,WAAW,iBAAiB;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,EAAE,IAAI,CAAC;IACd,iBAAiB,EAAE;QACjB,UAAU,EAAE,gBAAgB,CAAC;KAC9B,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,iBAAiB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,iBAAiB,CAuB/G"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/lib/server/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGtE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/E;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/E;AAED,MAAM,WAAW,iBAAiB;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,EAAE,IAAI,CAAC;IACd,iBAAiB,EAAE;QACjB,UAAU,EAAE,gBAAgB,CAAC;KAC9B,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,iBAAiB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,iBAAiB,CAuB/G"}

package/dist/lib/server/errors.js

@@ -26,6 +26,16 @@ const envelope_allowlist_1 = require("./envelope-allowlist");
  * the envelope can't become a stolen-key read oracle. Codes without a
  * registered allowlist pass through unchanged.
  *
+ * **Two-layer wire shape.** This builder emits the envelope layer
+ * (`structuredContent.adcp_error`) only. For tools whose response
+ * schema declares a typed Error arm (`errors[]` required at the top
+ * level), the framework dispatcher synthesises the payload-layer
+ * `errors[]` from the same data at finalize time, so the wire carries
+ * both the envelope marker and the typed Error arm together — no
+ * adopter code change required. The list of affected tools is derived
+ * at server build from the bundled schema cache. RFC:
+ * `docs/proposals/adcperror-two-layer-emission.md`.
+ *
  * @example
  * ```typescript
  * import { adcpError } from '@adcp/sdk';

package/dist/lib/server/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/lib/server/errors.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AA8HH,8BAuBC;AAnJD,sDAK8B;AAE9B,6DAAkE;AAoFlE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,SAAgB,SAAS,CAAC,IAAuC,EAAE,OAAyB;IAC1F,MAAM,QAAQ,GACZ,OAAO,CAAC,QAAQ;QAChB,CAAC,IAAA,iCAAmB,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,kCAAoB,CAAC,IAAyB,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAEtG,MAAM,UAAU,GAAqB;QACnC,IAAI;QACJ,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ;QACR,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QACtD,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;QACrE,GAAG,CAAC,OAAO,CAAC,WAAW,IAAI,IAAI,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;QACxE,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QACzD,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;KAC7D,CAAC;IAEF,MAAM,QAAQ,GAAG,uBAAuB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAE3D,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QAC3E,OAAO,EAAE,IAAI;QACb,iBAAiB,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE;KAC5C,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,uBAAuB,CAAC,IAAY,EAAE,OAAyB;IACtE,MAAM,SAAS,GAAG,+CAA0B,CAAC,IAAI,CAAC,CAAC;IACnD,IAAI,CAAC,SAAS;QAAE,OAAO,OAAO,CAAC;IAC/B,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC3C,CAAC;IACD,OAAO,GAAkC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/lib/server/errors.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAwIH,8BAuBC;AA7JD,sDAK8B;AAE9B,6DAAkE;AAoFlE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,SAAgB,SAAS,CAAC,IAAuC,EAAE,OAAyB;IAC1F,MAAM,QAAQ,GACZ,OAAO,CAAC,QAAQ;QAChB,CAAC,IAAA,iCAAmB,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,kCAAoB,CAAC,IAAyB,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAEtG,MAAM,UAAU,GAAqB;QACnC,IAAI;QACJ,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ;QACR,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QACtD,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;QACrE,GAAG,CAAC,OAAO,CAAC,WAAW,IAAI,IAAI,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;QACxE,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QACzD,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;KAC7D,CAAC;IAEF,MAAM,QAAQ,GAAG,uBAAuB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAE3D,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QAC3E,OAAO,EAAE,IAAI;QACb,iBAAiB,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE;KAC5C,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,uBAAuB,CAAC,IAAY,EAAE,OAAyB;IACtE,MAAM,SAAS,GAAG,+CAA0B,CAAC,IAAI,CAAC,CAAC;IACnD,IAAI,CAAC,SAAS;QAAE,OAAO,OAAO,CAAC;IAC/B,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC3C,CAAC;IACD,OAAO,GAAkC,CAAC;AAC5C,CAAC"}

package/dist/lib/server/wire-spec-fields.generated.d.ts

@@ -18,147 +18,147 @@ import type { AcquireRightsRequest, ActivateSignalRequest, BuildCreativeRequest,
  * pollution or shared-state mutation of the allowlist.
  */
 export declare const WIRE_SPEC_FIELDS: Readonly<{
-    /** schemas/cache/3.0.6/brand/acquire-rights-request.json */
+    /** schemas/cache/3.0.8/brand/acquire-rights-request.json */
     readonly AcquireRightsRequest: Readonly<{
         fields: readonly string[];
         __type: AcquireRightsRequest;
     }>;
-    /** schemas/cache/3.0.6/signals/activate-signal-request.json */
+    /** schemas/cache/3.0.8/signals/activate-signal-request.json */
     readonly ActivateSignalRequest: Readonly<{
         fields: readonly string[];
         __type: ActivateSignalRequest;
     }>;
-    /** schemas/cache/3.0.6/media-buy/build-creative-request.json */
+    /** schemas/cache/3.0.8/media-buy/build-creative-request.json */
     readonly BuildCreativeRequest: Readonly<{
         fields: readonly string[];
         __type: BuildCreativeRequest;
     }>;
-    /** schemas/cache/3.0.6/content-standards/calibrate-content-request.json */
+    /** schemas/cache/3.0.8/content-standards/calibrate-content-request.json */
     readonly CalibrateContentRequest: Readonly<{
         fields: readonly string[];
         __type: CalibrateContentRequest;
     }>;
-    /** schemas/cache/3.0.6/collection/create-collection-list-request.json */
+    /** schemas/cache/3.0.8/collection/create-collection-list-request.json */
     readonly CreateCollectionListRequest: Readonly<{
         fields: readonly string[];
         __type: CreateCollectionListRequest;
     }>;
-    /** schemas/cache/3.0.6/content-standards/create-content-standards-request.json */
+    /** schemas/cache/3.0.8/content-standards/create-content-standards-request.json */
     readonly CreateContentStandardsRequest: Readonly<{
         fields: readonly string[];
         __type: CreateContentStandardsRequest;
     }>;
-    /** schemas/cache/3.0.6/media-buy/create-media-buy-request.json */
+    /** schemas/cache/3.0.8/media-buy/create-media-buy-request.json */
     readonly CreateMediaBuyRequest: Readonly<{
         fields: readonly string[];
         __type: CreateMediaBuyRequest;
     }>;
-    /** schemas/cache/3.0.6/property/create-property-list-request.json */
+    /** schemas/cache/3.0.8/property/create-property-list-request.json */
     readonly CreatePropertyListRequest: Readonly<{
         fields: readonly string[];
         __type: CreatePropertyListRequest;
     }>;
-    /** schemas/cache/3.0.6/collection/delete-collection-list-request.json */
+    /** schemas/cache/3.0.8/collection/delete-collection-list-request.json */
     readonly DeleteCollectionListRequest: Readonly<{
         fields: readonly string[];
         __type: DeleteCollectionListRequest;
     }>;
-    /** schemas/cache/3.0.6/property/delete-property-list-request.json */
+    /** schemas/cache/3.0.8/property/delete-property-list-request.json */
     readonly DeletePropertyListRequest: Readonly<{
         fields: readonly string[];
         __type: DeletePropertyListRequest;
     }>;
-    /** schemas/cache/3.0.6/media-buy/get-media-buy-delivery-request.json */
+    /** schemas/cache/3.0.8/media-buy/get-media-buy-delivery-request.json */
     readonly GetMediaBuyDeliveryRequest: Readonly<{
         fields: readonly string[];
         __type: GetMediaBuyDeliveryRequest;
     }>;
-    /** schemas/cache/3.0.6/media-buy/log-event-request.json */
+    /** schemas/cache/3.0.8/media-buy/log-event-request.json */
     readonly LogEventRequest: Readonly<{
         fields: readonly string[];
         __type: LogEventRequest;
     }>;
-    /** schemas/cache/3.0.6/media-buy/provide-performance-feedback-request.json */
+    /** schemas/cache/3.0.8/media-buy/provide-performance-feedback-request.json */
     readonly ProvidePerformanceFeedbackRequest: Readonly<{
         fields: readonly string[];
         __type: ProvidePerformanceFeedbackRequest;
     }>;
-    /** schemas/cache/3.0.6/governance/report-plan-outcome-request.json */
+    /** schemas/cache/3.0.8/governance/report-plan-outcome-request.json */
     readonly ReportPlanOutcomeRequest: Readonly<{
         fields: readonly string[];
         __type: ReportPlanOutcomeRequest;
     }>;
-    /** schemas/cache/3.0.6/account/report-usage-request.json */
+    /** schemas/cache/3.0.8/account/report-usage-request.json */
     readonly ReportUsageRequest: Readonly<{
         fields: readonly string[];
         __type: ReportUsageRequest;
     }>;
-    /** schemas/cache/3.0.6/sponsored-intelligence/si-initiate-session-request.json */
+    /** schemas/cache/3.0.8/sponsored-intelligence/si-initiate-session-request.json */
     readonly SIInitiateSessionRequest: Readonly<{
         fields: readonly string[];
         __type: SIInitiateSessionRequest;
     }>;
-    /** schemas/cache/3.0.6/sponsored-intelligence/si-send-message-request.json */
+    /** schemas/cache/3.0.8/sponsored-intelligence/si-send-message-request.json */
     readonly SISendMessageRequest: Readonly<{
         fields: readonly string[];
         __type: SISendMessageRequest;
     }>;
-    /** schemas/cache/3.0.6/account/sync-accounts-request.json */
+    /** schemas/cache/3.0.8/account/sync-accounts-request.json */
     readonly SyncAccountsRequest: Readonly<{
         fields: readonly string[];
         __type: SyncAccountsRequest;
     }>;
-    /** schemas/cache/3.0.6/media-buy/sync-audiences-request.json */
+    /** schemas/cache/3.0.8/media-buy/sync-audiences-request.json */
     readonly SyncAudiencesRequest: Readonly<{
         fields: readonly string[];
         __type: SyncAudiencesRequest;
     }>;
-    /** schemas/cache/3.0.6/media-buy/sync-catalogs-request.json */
+    /** schemas/cache/3.0.8/media-buy/sync-catalogs-request.json */
     readonly SyncCatalogsRequest: Readonly<{
         fields: readonly string[];
         __type: SyncCatalogsRequest;
     }>;
-    /** schemas/cache/3.0.6/creative/sync-creatives-request.json */
+    /** schemas/cache/3.0.8/creative/sync-creatives-request.json */
     readonly SyncCreativesRequest: Readonly<{
         fields: readonly string[];
         __type: SyncCreativesRequest;
     }>;
-    /** schemas/cache/3.0.6/media-buy/sync-event-sources-request.json */
+    /** schemas/cache/3.0.8/media-buy/sync-event-sources-request.json */
     readonly SyncEventSourcesRequest: Readonly<{
         fields: readonly string[];
         __type: SyncEventSourcesRequest;
     }>;
-    /** schemas/cache/3.0.6/account/sync-governance-request.json */
+    /** schemas/cache/3.0.8/account/sync-governance-request.json */
     readonly SyncGovernanceRequest: Readonly<{
         fields: readonly string[];
         __type: SyncGovernanceRequest;
     }>;
-    /** schemas/cache/3.0.6/governance/sync-plans-request.json */
+    /** schemas/cache/3.0.8/governance/sync-plans-request.json */
     readonly SyncPlansRequest: Readonly<{
         fields: readonly string[];
         __type: SyncPlansRequest;
     }>;
-    /** schemas/cache/3.0.6/collection/update-collection-list-request.json */
+    /** schemas/cache/3.0.8/collection/update-collection-list-request.json */
     readonly UpdateCollectionListRequest: Readonly<{
         fields: readonly string[];
         __type: UpdateCollectionListRequest;
     }>;
-    /** schemas/cache/3.0.6/content-standards/update-content-standards-request.json */
+    /** schemas/cache/3.0.8/content-standards/update-content-standards-request.json */
     readonly UpdateContentStandardsRequest: Readonly<{
         fields: readonly string[];
         __type: UpdateContentStandardsRequest;
     }>;
-    /** schemas/cache/3.0.6/media-buy/update-media-buy-request.json */
+    /** schemas/cache/3.0.8/media-buy/update-media-buy-request.json */
     readonly UpdateMediaBuyRequest: Readonly<{
         fields: readonly string[];
         __type: UpdateMediaBuyRequest;
     }>;
-    /** schemas/cache/3.0.6/property/update-property-list-request.json */
+    /** schemas/cache/3.0.8/property/update-property-list-request.json */
     readonly UpdatePropertyListRequest: Readonly<{
         fields: readonly string[];
         __type: UpdatePropertyListRequest;
     }>;
-    /** schemas/cache/3.0.6/brand/update-rights-request.json */
+    /** schemas/cache/3.0.8/brand/update-rights-request.json */
     readonly UpdateRightsRequest: Readonly<{
         fields: readonly string[];
         __type: UpdateRightsRequest;