@adcp/sdk 14.0.0-rc.37 → 14.0.0-rc.39

package/dist/lib/types/tools.generated.d.mts

@@ -9013,7 +9013,7 @@ export type TargetingOverlayInput = TargetingUnknownAgeEligibilityConstraint & T
     geo_countries_exclude?: GeoCountriesExclude | null;
     geo_regions?: GeoRegions | null;
     geo_regions_exclude?: GeoRegionsExclude | null;
-    geo_metros?: TargetingGeoMetros;
+    geo_metros?: TargetingGeoMetrosInput;
     geo_metros_exclude?: GeoMetrosExclude | null;
     geo_postal_areas?: GeoPostalAreas | null;
     geo_postal_areas_exclude?: GeoPostalAreasExclude | null;
@@ -9041,17 +9041,17 @@ export type TargetingOverlayInput = TargetingUnknownAgeEligibilityConstraint & T
     placement_selection?: PlacementSelection | null;
     collection_selection?: TargetingCollectionSelection | null;
     age_restriction?: AgeRestriction | null;
-    device_platform?: [DevicePlatform, ...DevicePlatform[]] | null;
+    device_platform?: TargetingDevicePlatformsInput | null;
     device_platform_exclude?: DevicePlatformExclude | null;
-    device_type?: [DeviceType, ...DeviceType[]] | null;
+    device_type?: TargetingDeviceTypesInput | null;
     device_type_exclude?: DeviceTypeExclude | null;
     browser?: Browser | null;
     browser_exclude?: BrowserExclude | null;
     store_catchments?: StoreCatchments | null;
     geo_proximity?: GeoProximity | null;
-    language?: TargetingLanguages;
-    keyword_targets?: TargetingKeywords;
-    negative_keywords?: TargetingNegativeKeywords;
+    language?: TargetingLanguagesInput;
+    keyword_targets?: TargetingKeywordsInput;
+    negative_keywords?: TargetingNegativeKeywordsInput;
 };
 /**
  * Restrict delivery to specific countries. ISO 3166-1 alpha-2 codes (e.g., 'US', 'GB', 'DE').
@@ -9077,6 +9077,12 @@ export type GeoRegions = [string, ...string[]];
  * @minItems 1
  */
 export type GeoRegionsExclude = [string, ...string[]];
+/**
+ * Restrict delivery to specific metro areas. Each entry specifies the classification system and target values. Seller must declare supported systems in get_adcp_capabilities.
+ *
+ * @minItems 1
+ */
+export type TargetingGeoMetrosInput = [GeoMetro, ...GeoMetro[]] | null;
 /**
  * Exclude specific metro areas from delivery. Each entry specifies the classification system and excluded values. Seller must declare supported systems in get_adcp_capabilities.
  *
@@ -9144,12 +9150,24 @@ export type AudienceInclude = [string, ...string[]];
  * @minItems 1
  */
 export type AudienceExclude = [string, ...string[]];
+/**
+ * Restrict to specific platforms. Use for technical compatibility (app only works on iOS). Values from Sec-CH-UA-Platform standard, extended for CTV.
+ *
+ * @minItems 1
+ */
+export type TargetingDevicePlatformsInput = [DevicePlatform, ...DevicePlatform[]];
 /**
  * Exclude specific operating-system platforms from delivery. When a platform appears in both device_platform and device_platform_exclude, exclusion wins. Sellers MUST reject a request they cannot enforce rather than silently dropping the exclusion.
  *
  * @minItems 1
  */
 export type DevicePlatformExclude = [DevicePlatform, ...DevicePlatform[]];
+/**
+ * Restrict to specific device form factors. Use for campaigns targeting hardware categories rather than operating systems (e.g., mobile-only promotions, CTV campaigns).
+ *
+ * @minItems 1
+ */
+export type TargetingDeviceTypesInput = [DeviceType, ...DeviceType[]];
 /**
  * Exclude specific device form factors from delivery (e.g., exclude CTV for app-install campaigns).
  *
@@ -9211,6 +9229,47 @@ export type StoreCatchments = [
         catchment_ids?: [string, ...string[]];
     }[]
 ];
+/**
+ * Restrict to users with specific language preferences using canonical BCP 47 language ranges. Each buyer range is evaluated against a user's language-preference tag with RFC 4647 section 3.3.1 Basic Filtering: 'fr' matches 'fr', 'fr-CA', and 'fr-FR', while 'fr-CA' matches 'fr-CA' and more-specific descendants but not 'fr' or 'fr-FR'. Values use OR logic.
+ *
+ * @minItems 1
+ */
+export type TargetingLanguagesInput = [LanguageTag, ...LanguageTag[]] | null;
+/**
+ * Keyword targeting for search and retail media platforms. Restricts delivery to queries matching the specified keywords. Each keyword is identified by the tuple (keyword, match_type) — the same keyword string with different match types are distinct targets. Sellers SHOULD reject duplicate (keyword, match_type) pairs within a single request. Seller must declare support in get_adcp_capabilities.
+ *
+ * @minItems 1
+ */
+export type TargetingKeywordsInput = [
+    {
+        /**
+         * The keyword to target
+         */
+        keyword: string;
+        match_type: MatchType;
+        /**
+         * Per-keyword bid price, denominated in the same currency as the package's pricing option. Overrides the package-level bid_price for this keyword. Inherits the max_bid interpretation from the pricing option: when max_bid is true, this is the keyword's bid ceiling; when false, this is the exact bid. If omitted, the package bid_price applies.
+         */
+        bid_price?: number;
+    },
+    ...{
+        /**
+         * The keyword to target
+         */
+        keyword: string;
+        match_type: MatchType;
+        /**
+         * Per-keyword bid price, denominated in the same currency as the package's pricing option. Overrides the package-level bid_price for this keyword. Inherits the max_bid interpretation from the pricing option: when max_bid is true, this is the keyword's bid ceiling; when false, this is the exact bid. If omitted, the package bid_price applies.
+         */
+        bid_price?: number;
+    }[]
+] | null;
+/**
+ * Keywords to exclude from delivery. Queries matching these keywords will not trigger the ad. Each negative keyword is identified by the tuple (keyword, match_type). Seller must declare support in get_adcp_capabilities.
+ *
+ * @minItems 1
+ */
+export type TargetingNegativeKeywordsInput = [NegativeKeyword, ...NegativeKeyword[]] | null;
 /**
  * @minItems 1
  */

package/dist/lib/types/tools.generated.d.ts

@@ -9013,7 +9013,7 @@ export type TargetingOverlayInput = TargetingUnknownAgeEligibilityConstraint & T
     geo_countries_exclude?: GeoCountriesExclude | null;
     geo_regions?: GeoRegions | null;
     geo_regions_exclude?: GeoRegionsExclude | null;
-    geo_metros?: TargetingGeoMetros;
+    geo_metros?: TargetingGeoMetrosInput;
     geo_metros_exclude?: GeoMetrosExclude | null;
     geo_postal_areas?: GeoPostalAreas | null;
     geo_postal_areas_exclude?: GeoPostalAreasExclude | null;
@@ -9041,17 +9041,17 @@ export type TargetingOverlayInput = TargetingUnknownAgeEligibilityConstraint & T
     placement_selection?: PlacementSelection | null;
     collection_selection?: TargetingCollectionSelection | null;
     age_restriction?: AgeRestriction | null;
-    device_platform?: [DevicePlatform, ...DevicePlatform[]] | null;
+    device_platform?: TargetingDevicePlatformsInput | null;
     device_platform_exclude?: DevicePlatformExclude | null;
-    device_type?: [DeviceType, ...DeviceType[]] | null;
+    device_type?: TargetingDeviceTypesInput | null;
     device_type_exclude?: DeviceTypeExclude | null;
     browser?: Browser | null;
     browser_exclude?: BrowserExclude | null;
     store_catchments?: StoreCatchments | null;
     geo_proximity?: GeoProximity | null;
-    language?: TargetingLanguages;
-    keyword_targets?: TargetingKeywords;
-    negative_keywords?: TargetingNegativeKeywords;
+    language?: TargetingLanguagesInput;
+    keyword_targets?: TargetingKeywordsInput;
+    negative_keywords?: TargetingNegativeKeywordsInput;
 };
 /**
  * Restrict delivery to specific countries. ISO 3166-1 alpha-2 codes (e.g., 'US', 'GB', 'DE').
@@ -9077,6 +9077,12 @@ export type GeoRegions = [string, ...string[]];
  * @minItems 1
  */
 export type GeoRegionsExclude = [string, ...string[]];
+/**
+ * Restrict delivery to specific metro areas. Each entry specifies the classification system and target values. Seller must declare supported systems in get_adcp_capabilities.
+ *
+ * @minItems 1
+ */
+export type TargetingGeoMetrosInput = [GeoMetro, ...GeoMetro[]] | null;
 /**
  * Exclude specific metro areas from delivery. Each entry specifies the classification system and excluded values. Seller must declare supported systems in get_adcp_capabilities.
  *
@@ -9144,12 +9150,24 @@ export type AudienceInclude = [string, ...string[]];
  * @minItems 1
  */
 export type AudienceExclude = [string, ...string[]];
+/**
+ * Restrict to specific platforms. Use for technical compatibility (app only works on iOS). Values from Sec-CH-UA-Platform standard, extended for CTV.
+ *
+ * @minItems 1
+ */
+export type TargetingDevicePlatformsInput = [DevicePlatform, ...DevicePlatform[]];
 /**
  * Exclude specific operating-system platforms from delivery. When a platform appears in both device_platform and device_platform_exclude, exclusion wins. Sellers MUST reject a request they cannot enforce rather than silently dropping the exclusion.
  *
  * @minItems 1
  */
 export type DevicePlatformExclude = [DevicePlatform, ...DevicePlatform[]];
+/**
+ * Restrict to specific device form factors. Use for campaigns targeting hardware categories rather than operating systems (e.g., mobile-only promotions, CTV campaigns).
+ *
+ * @minItems 1
+ */
+export type TargetingDeviceTypesInput = [DeviceType, ...DeviceType[]];
 /**
  * Exclude specific device form factors from delivery (e.g., exclude CTV for app-install campaigns).
  *
@@ -9211,6 +9229,47 @@ export type StoreCatchments = [
         catchment_ids?: [string, ...string[]];
     }[]
 ];
+/**
+ * Restrict to users with specific language preferences using canonical BCP 47 language ranges. Each buyer range is evaluated against a user's language-preference tag with RFC 4647 section 3.3.1 Basic Filtering: 'fr' matches 'fr', 'fr-CA', and 'fr-FR', while 'fr-CA' matches 'fr-CA' and more-specific descendants but not 'fr' or 'fr-FR'. Values use OR logic.
+ *
+ * @minItems 1
+ */
+export type TargetingLanguagesInput = [LanguageTag, ...LanguageTag[]] | null;
+/**
+ * Keyword targeting for search and retail media platforms. Restricts delivery to queries matching the specified keywords. Each keyword is identified by the tuple (keyword, match_type) — the same keyword string with different match types are distinct targets. Sellers SHOULD reject duplicate (keyword, match_type) pairs within a single request. Seller must declare support in get_adcp_capabilities.
+ *
+ * @minItems 1
+ */
+export type TargetingKeywordsInput = [
+    {
+        /**
+         * The keyword to target
+         */
+        keyword: string;
+        match_type: MatchType;
+        /**
+         * Per-keyword bid price, denominated in the same currency as the package's pricing option. Overrides the package-level bid_price for this keyword. Inherits the max_bid interpretation from the pricing option: when max_bid is true, this is the keyword's bid ceiling; when false, this is the exact bid. If omitted, the package bid_price applies.
+         */
+        bid_price?: number;
+    },
+    ...{
+        /**
+         * The keyword to target
+         */
+        keyword: string;
+        match_type: MatchType;
+        /**
+         * Per-keyword bid price, denominated in the same currency as the package's pricing option. Overrides the package-level bid_price for this keyword. Inherits the max_bid interpretation from the pricing option: when max_bid is true, this is the keyword's bid ceiling; when false, this is the exact bid. If omitted, the package bid_price applies.
+         */
+        bid_price?: number;
+    }[]
+] | null;
+/**
+ * Keywords to exclude from delivery. Queries matching these keywords will not trigger the ad. Each negative keyword is identified by the tuple (keyword, match_type). Seller must declare support in get_adcp_capabilities.
+ *
+ * @minItems 1
+ */
+export type TargetingNegativeKeywordsInput = [NegativeKeyword, ...NegativeKeyword[]] | null;
 /**
  * @minItems 1
  */

package/dist/lib/types/update-media-buy.d.ts

@@ -9090,6 +9090,20 @@ export interface TargetingCollectionList {
  */
 export type TargetingCollectionSelection = SelectedCollections | ProductDefaultCollections;
 
+/**
+ * Restrict to specific platforms. Use for technical compatibility (app only works on iOS). Values from Sec-CH-UA-Platform standard, extended for CTV.
+ *
+ * @minItems 1
+ */
+export type TargetingDevicePlatformsInput = [DevicePlatform, ...DevicePlatform[]];
+
+/**
+ * Restrict to specific device form factors. Use for campaigns targeting hardware categories rather than operating systems (e.g., mobile-only promotions, CTV campaigns).
+ *
+ * @minItems 1
+ */
+export type TargetingDeviceTypesInput = [DeviceType, ...DeviceType[]];
+
 /**
  * Frequency capping settings for package-level application. Two types of frequency control can be used independently or together: suppress enforces a cooldown between consecutive exposures; max_impressions + per + window caps total exposures per entity in a time window. When both suppress and max_impressions are set, an impression is delivered only if both constraints permit it (AND semantics). At least one of suppress, suppress_minutes, or max_impressions must be set. Field location determines scope; this value has no scope discriminator. The MediaBuy root uses the narrower media-buy-frequency-cap schema, which permits maximum impressions only in 3.2.
  */
@@ -9124,6 +9138,13 @@ export type TargetingFrequencyCap = {} & {
  */
 export type TargetingGeoMetros = [GeoMetro, ...GeoMetro[]];
 
+/**
+ * Restrict delivery to specific metro areas. Each entry specifies the classification system and target values. Seller must declare supported systems in get_adcp_capabilities.
+ *
+ * @minItems 1
+ */
+export type TargetingGeoMetrosInput = [GeoMetro, ...GeoMetro[]] | null;
+
 /**
  * Keyword targeting for search and retail media platforms. Restricts delivery to queries matching the specified keywords. Each keyword is identified by the tuple (keyword, match_type) — the same keyword string with different match types are distinct targets. Sellers SHOULD reject duplicate (keyword, match_type) pairs within a single request. Seller must declare support in get_adcp_capabilities.
  *
@@ -9154,6 +9175,36 @@ export type TargetingKeywords = [
     }[]
 ];
 
+/**
+ * Keyword targeting for search and retail media platforms. Restricts delivery to queries matching the specified keywords. Each keyword is identified by the tuple (keyword, match_type) — the same keyword string with different match types are distinct targets. Sellers SHOULD reject duplicate (keyword, match_type) pairs within a single request. Seller must declare support in get_adcp_capabilities.
+ *
+ * @minItems 1
+ */
+export type TargetingKeywordsInput = [
+    {
+        /**
+         * The keyword to target
+         */
+        keyword: string;
+        match_type: MatchType;
+        /**
+         * Per-keyword bid price, denominated in the same currency as the package's pricing option. Overrides the package-level bid_price for this keyword. Inherits the max_bid interpretation from the pricing option: when max_bid is true, this is the keyword's bid ceiling; when false, this is the exact bid. If omitted, the package bid_price applies.
+         */
+        bid_price?: number;
+    },
+    ...{
+        /**
+         * The keyword to target
+         */
+        keyword: string;
+        match_type: MatchType;
+        /**
+         * Per-keyword bid price, denominated in the same currency as the package's pricing option. Overrides the package-level bid_price for this keyword. Inherits the max_bid interpretation from the pricing option: when max_bid is true, this is the keyword's bid ceiling; when false, this is the exact bid. If omitted, the package bid_price applies.
+         */
+        bid_price?: number;
+    }[]
+] | null;
+
 /**
  * Restrict to users with specific language preferences using canonical BCP 47 language ranges. Each buyer range is evaluated against a user's language-preference tag with RFC 4647 section 3.3.1 Basic Filtering: 'fr' matches 'fr', 'fr-CA', and 'fr-FR', while 'fr-CA' matches 'fr-CA' and more-specific descendants but not 'fr' or 'fr-FR'. Values use OR logic.
  *
@@ -9161,6 +9212,13 @@ export type TargetingKeywords = [
  */
 export type TargetingLanguages = [LanguageTag, ...LanguageTag[]];
 
+/**
+ * Restrict to users with specific language preferences using canonical BCP 47 language ranges. Each buyer range is evaluated against a user's language-preference tag with RFC 4647 section 3.3.1 Basic Filtering: 'fr' matches 'fr', 'fr-CA', and 'fr-FR', while 'fr-CA' matches 'fr-CA' and more-specific descendants but not 'fr' or 'fr-FR'. Values use OR logic.
+ *
+ * @minItems 1
+ */
+export type TargetingLanguagesInput = [LanguageTag, ...LanguageTag[]] | null;
+
 /**
  * Keywords to exclude from delivery. Queries matching these keywords will not trigger the ad. Each negative keyword is identified by the tuple (keyword, match_type). Seller must declare support in get_adcp_capabilities.
  *
@@ -9168,6 +9226,13 @@ export type TargetingLanguages = [LanguageTag, ...LanguageTag[]];
  */
 export type TargetingNegativeKeywords = [NegativeKeyword, ...NegativeKeyword[]];
 
+/**
+ * Keywords to exclude from delivery. Queries matching these keywords will not trigger the ad. Each negative keyword is identified by the tuple (keyword, match_type). Seller must declare support in get_adcp_capabilities.
+ *
+ * @minItems 1
+ */
+export type TargetingNegativeKeywordsInput = [NegativeKeyword, ...NegativeKeyword[]] | null;
+
 /**
  * Concrete delivery constraints the buyer expects to carry into create_media_buy. Buyers SHOULD use this field instead of putting equivalent exact targeting only in brief prose. Sellers evaluate these constraints during discovery and scope returned pricing and forecasts to the effective targeting. If a product cannot honor the request exactly, the seller may omit it or return a request-scoped configured product with Product targeting_resolution modifications. Absence of Product targeting_resolution means exact acceptance of this structured overlay; it does not confirm how targeting in the brief was interpreted. On refine, presence is complete replacement state for returned configurations; when omitted, each referenced product's bound targeting remains in force.
  */
@@ -9410,7 +9475,7 @@ export type TargetingOverlayInput = TargetingUnknownAgeEligibilityConstraint & T
     geo_countries_exclude?: GeoCountriesExclude | null;
     geo_regions?: GeoRegions | null;
     geo_regions_exclude?: GeoRegionsExclude | null;
-    geo_metros?: TargetingGeoMetros;
+    geo_metros?: TargetingGeoMetrosInput;
     geo_metros_exclude?: GeoMetrosExclude | null;
     geo_postal_areas?: GeoPostalAreas | null;
     geo_postal_areas_exclude?: GeoPostalAreasExclude | null;
@@ -9438,17 +9503,17 @@ export type TargetingOverlayInput = TargetingUnknownAgeEligibilityConstraint & T
     placement_selection?: PlacementSelection | null;
     collection_selection?: TargetingCollectionSelection | null;
     age_restriction?: AgeRestriction | null;
-    device_platform?: [DevicePlatform, ...DevicePlatform[]] | null;
+    device_platform?: TargetingDevicePlatformsInput | null;
     device_platform_exclude?: DevicePlatformExclude | null;
-    device_type?: [DeviceType, ...DeviceType[]] | null;
+    device_type?: TargetingDeviceTypesInput | null;
     device_type_exclude?: DeviceTypeExclude | null;
     browser?: Browser | null;
     browser_exclude?: BrowserExclude | null;
     store_catchments?: StoreCatchments | null;
     geo_proximity?: GeoProximity | null;
-    language?: TargetingLanguages;
-    keyword_targets?: TargetingKeywords;
-    negative_keywords?: TargetingNegativeKeywords;
+    language?: TargetingLanguagesInput;
+    keyword_targets?: TargetingKeywordsInput;
+    negative_keywords?: TargetingNegativeKeywordsInput;
 };
 
 /**

package/dist/lib/utils/redact-secrets.d.mts

@@ -24,7 +24,7 @@
  * Canonical secret-key pattern from the AdCP runner-output contract. Mirrors
  * the spec block: `Authorization`, `Credentials`, tokens, API keys,
  * passwords, secrets, OAuth refresh / access bearers, session tokens,
- * cookies. Case-insensitive.
+ * direct-continuation recovery keys, cookies. Case-insensitive.
  */
 export declare const SECRET_KEY_PATTERN: RegExp;
 export declare function normalizeSecretKeyPattern(pattern: RegExp): RegExp;

package/dist/lib/utils/redact-secrets.d.ts

@@ -24,7 +24,7 @@
  * Canonical secret-key pattern from the AdCP runner-output contract. Mirrors
  * the spec block: `Authorization`, `Credentials`, tokens, API keys,
  * passwords, secrets, OAuth refresh / access bearers, session tokens,
- * cookies. Case-insensitive.
+ * direct-continuation recovery keys, cookies. Case-insensitive.
  */
 export declare const SECRET_KEY_PATTERN: RegExp;
 export declare function normalizeSecretKeyPattern(pattern: RegExp): RegExp;

package/dist/lib/utils/redact-secrets.js

@@ -25,7 +25,7 @@ __export(redact_secrets_exports, {
 });
 module.exports = __toCommonJS(redact_secrets_exports);
 var import_json_depth = require('./json-depth.js');
-const SECRET_KEY_PATTERN = /^(authorization|credentials?|token|api[_-]?key|password|secret|client[_-]secret|refresh[_-]token|access[_-]token|bearer|session[_-]token|session[_-]id|offering[_-]token|cookie|set[_-]cookie)$/i;
+const SECRET_KEY_PATTERN = /^(authorization|credentials?|token|api[_-]?key|password|secret|client[_-]secret|refresh[_-]token|access[_-]token|bearer|session[_-]token|session[_-]id|offering[_-]token|recovery[_-]?key|cookie|set[_-]cookie)$/i;
 function normalizeSecretKeyPattern(pattern) {
   if (!/[gy]/.test(pattern.flags)) return pattern;
   return new RegExp(pattern.source, pattern.flags.replace(/[gy]/g, ""));

package/dist/lib/utils/redact-secrets.mjs

@@ -1,5 +1,5 @@
 import { MAX_JSON_DEPTH } from "./json-depth.mjs";
-const SECRET_KEY_PATTERN = /^(authorization|credentials?|token|api[_-]?key|password|secret|client[_-]secret|refresh[_-]token|access[_-]token|bearer|session[_-]token|session[_-]id|offering[_-]token|cookie|set[_-]cookie)$/i;
+const SECRET_KEY_PATTERN = /^(authorization|credentials?|token|api[_-]?key|password|secret|client[_-]secret|refresh[_-]token|access[_-]token|bearer|session[_-]token|session[_-]id|offering[_-]token|recovery[_-]?key|cookie|set[_-]cookie)$/i;
 function normalizeSecretKeyPattern(pattern) {
   if (!/[gy]/.test(pattern.flags)) return pattern;
   return new RegExp(pattern.source, pattern.flags.replace(/[gy]/g, ""));

package/dist/lib/v2/projection/cache-versions.d.mts

@@ -1,2 +1 @@
 export declare const SCHEMA_VERSIONS_TO_TRY: readonly string[];
-export declare const BETA_VERSIONS_TO_TRY: readonly string[];

package/dist/lib/v2/projection/cache-versions.d.ts

@@ -1,2 +1 @@
 export declare const SCHEMA_VERSIONS_TO_TRY: readonly string[];
-export declare const BETA_VERSIONS_TO_TRY: readonly string[];

package/dist/lib/v2/projection/cache-versions.js

@@ -18,7 +18,6 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var cache_versions_exports = {};
 __export(cache_versions_exports, {
-  BETA_VERSIONS_TO_TRY: () => BETA_VERSIONS_TO_TRY,
   SCHEMA_VERSIONS_TO_TRY: () => SCHEMA_VERSIONS_TO_TRY
 });
 module.exports = __toCommonJS(cache_versions_exports);
@@ -29,22 +28,9 @@ function projectionBundleKey(version) {
   const [, major, minor, , prerelease] = semver;
   return prerelease === void 0 ? `${major}.${minor}` : version;
 }
-const PROJECTION_SCHEMA_CACHE_CANDIDATES = [
-  import_version.ADCP_VERSION,
-  projectionBundleKey(import_version.ADCP_VERSION),
-  "3.1.0-rc.1",
-  "3.1.0-beta.7",
-  "3.1.0-beta.5",
-  "3.1.0-beta.3",
-  "3.1.0-beta.2",
-  "3.1.0-beta.1",
-  "3.1.0-beta.0",
-  "latest"
-];
+const PROJECTION_SCHEMA_CACHE_CANDIDATES = [import_version.ADCP_VERSION, projectionBundleKey(import_version.ADCP_VERSION), "3.1", "latest"];
 const SCHEMA_VERSIONS_TO_TRY = Array.from(new Set(PROJECTION_SCHEMA_CACHE_CANDIDATES));
-const BETA_VERSIONS_TO_TRY = SCHEMA_VERSIONS_TO_TRY;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  BETA_VERSIONS_TO_TRY,
   SCHEMA_VERSIONS_TO_TRY
 });

package/dist/lib/v2/projection/cache-versions.mjs

@@ -5,21 +5,8 @@ function projectionBundleKey(version) {
   const [, major, minor, , prerelease] = semver;
   return prerelease === void 0 ? `${major}.${minor}` : version;
 }
-const PROJECTION_SCHEMA_CACHE_CANDIDATES = [
-  ADCP_VERSION,
-  projectionBundleKey(ADCP_VERSION),
-  "3.1.0-rc.1",
-  "3.1.0-beta.7",
-  "3.1.0-beta.5",
-  "3.1.0-beta.3",
-  "3.1.0-beta.2",
-  "3.1.0-beta.1",
-  "3.1.0-beta.0",
-  "latest"
-];
+const PROJECTION_SCHEMA_CACHE_CANDIDATES = [ADCP_VERSION, projectionBundleKey(ADCP_VERSION), "3.1", "latest"];
 const SCHEMA_VERSIONS_TO_TRY = Array.from(new Set(PROJECTION_SCHEMA_CACHE_CANDIDATES));
-const BETA_VERSIONS_TO_TRY = SCHEMA_VERSIONS_TO_TRY;
 export {
-  BETA_VERSIONS_TO_TRY,
   SCHEMA_VERSIONS_TO_TRY
 };

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

@@ -44,8 +44,8 @@ function loadCanonicalSchema(kind, cacheRoot) {
 }
 function findCacheRoot() {
   const candidates = [
-    ...import_cache_versions.BETA_VERSIONS_TO_TRY.map((v) => import_path.default.join(__dirname, "..", "..", "schemas-data", v)),
-    ...import_cache_versions.BETA_VERSIONS_TO_TRY.map((v) => import_path.default.join(__dirname, "..", "..", "..", "..", "schemas", "cache", v))
+    ...import_cache_versions.SCHEMA_VERSIONS_TO_TRY.map((v) => import_path.default.join(__dirname, "..", "..", "schemas-data", v)),
+    ...import_cache_versions.SCHEMA_VERSIONS_TO_TRY.map((v) => import_path.default.join(__dirname, "..", "..", "..", "..", "schemas", "cache", v))
   ];
   for (const c of candidates) {
     if ((0, import_fs.existsSync)(c)) return c;

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

@@ -5,7 +5,7 @@ const __dirname = __adcpDirname(__adcpFileURLToPath(import.meta.url));
 const require2 = __adcpCreateRequire(import.meta.url);
 import { readFileSync, existsSync } from "fs";
 import path from "path";
-import { BETA_VERSIONS_TO_TRY } from "./cache-versions.mjs";
+import { SCHEMA_VERSIONS_TO_TRY } from "./cache-versions.mjs";
 let cache = null;
 let baseDefault = null;
 function loadCanonicalSchema(kind, cacheRoot) {
@@ -15,8 +15,8 @@ function loadCanonicalSchema(kind, cacheRoot) {
 }
 function findCacheRoot() {
   const candidates = [
-    ...BETA_VERSIONS_TO_TRY.map((v) => path.join(__dirname, "..", "..", "schemas-data", v)),
-    ...BETA_VERSIONS_TO_TRY.map((v) => path.join(__dirname, "..", "..", "..", "..", "schemas", "cache", v))
+    ...SCHEMA_VERSIONS_TO_TRY.map((v) => path.join(__dirname, "..", "..", "schemas-data", v)),
+    ...SCHEMA_VERSIONS_TO_TRY.map((v) => path.join(__dirname, "..", "..", "..", "..", "schemas", "cache", v))
   ];
   for (const c of candidates) {
     if (existsSync(c)) return c;

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

@@ -62,7 +62,7 @@ interface CanonicalMappingRegistry {
  *      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
+ * Within (2) and (3), versions are tried in `SCHEMA_VERSIONS_TO_TRY` order
  * — current pin/bundle wins; older prereleases survive for adopters who
  * haven't synced; `latest` is last-resort.
  *

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

@@ -62,7 +62,7 @@ interface CanonicalMappingRegistry {
  *      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
+ * Within (2) and (3), versions are tried in `SCHEMA_VERSIONS_TO_TRY` order
  * — current pin/bundle wins; older prereleases survive for adopters who
  * haven't synced; `latest` is last-resort.
  *

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

@@ -43,10 +43,10 @@ let cached = null;
 function loadRegistry(cacheRoot) {
   if (cached) return cached;
   const candidates = cacheRoot ? [import_path.default.join(cacheRoot, "registries", "v1-canonical-mapping.json")] : [
-    ...import_cache_versions.BETA_VERSIONS_TO_TRY.map(
+    ...import_cache_versions.SCHEMA_VERSIONS_TO_TRY.map(
       (v) => import_path.default.join(__dirname, "..", "..", "schemas-data", v, "registries", "v1-canonical-mapping.json")
     ),
-    ...import_cache_versions.BETA_VERSIONS_TO_TRY.map(
+    ...import_cache_versions.SCHEMA_VERSIONS_TO_TRY.map(
       (v) => import_path.default.join(__dirname, "..", "..", "..", "..", "schemas", "cache", v, "registries", "v1-canonical-mapping.json")
     )
   ];

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

@@ -6,15 +6,15 @@ const require2 = __adcpCreateRequire(import.meta.url);
 import { readFileSync, existsSync } from "fs";
 import path from "path";
 import { AAO_CANONICAL_AGENT_URL } from "./constants.mjs";
-import { BETA_VERSIONS_TO_TRY } from "./cache-versions.mjs";
+import { SCHEMA_VERSIONS_TO_TRY } from "./cache-versions.mjs";
 let cached = null;
 function loadRegistry(cacheRoot) {
   if (cached) return cached;
   const candidates = cacheRoot ? [path.join(cacheRoot, "registries", "v1-canonical-mapping.json")] : [
-    ...BETA_VERSIONS_TO_TRY.map(
+    ...SCHEMA_VERSIONS_TO_TRY.map(
       (v) => path.join(__dirname, "..", "..", "schemas-data", v, "registries", "v1-canonical-mapping.json")
     ),
-    ...BETA_VERSIONS_TO_TRY.map(
+    ...SCHEMA_VERSIONS_TO_TRY.map(
       (v) => path.join(__dirname, "..", "..", "..", "..", "schemas", "cache", v, "registries", "v1-canonical-mapping.json")
     )
   ];

package/dist/lib/validation/schema-loader.d.mts

@@ -135,7 +135,15 @@ export declare function getSchemaDocumentByRef(schemaRef: string, version?: stri
  * `core/mcp-webhook-payload.json`. Used by storyboard webhook assertions
  * whose payload schema is not tied to a tool request/response pair.
  */
-export declare function getSchemaValidatorByRef(schemaRef: string, version?: string, keywords?: ReadonlyArray<KeywordDefinition>): ValidateFunction | undefined;
+export declare function getSchemaValidatorByRef(schemaRef: string, version?: string, keywords?: ReadonlyArray<KeywordDefinition>, options?: {
+    allErrors?: boolean;
+}): ValidateFunction | undefined;
+/**
+ * Compile a tool schema without the response-root relaxation used by the SDK's
+ * live-wire validator. Kept in the loader so the public schema facade does not
+ * need access to loader file-system state.
+ */
+export declare function getCanonicalToolValidatorForVersion(toolName: string, direction: Direction, version?: string): ValidateFunction | undefined;
 /** List of (toolName, direction) pairs that have schemas. Used by tests. */
 export declare function listValidatorKeys(version?: string): string[];
 /**

package/dist/lib/validation/schema-loader.d.ts

@@ -135,7 +135,15 @@ export declare function getSchemaDocumentByRef(schemaRef: string, version?: stri
  * `core/mcp-webhook-payload.json`. Used by storyboard webhook assertions
  * whose payload schema is not tied to a tool request/response pair.
  */
-export declare function getSchemaValidatorByRef(schemaRef: string, version?: string, keywords?: ReadonlyArray<KeywordDefinition>): ValidateFunction | undefined;
+export declare function getSchemaValidatorByRef(schemaRef: string, version?: string, keywords?: ReadonlyArray<KeywordDefinition>, options?: {
+    allErrors?: boolean;
+}): ValidateFunction | undefined;
+/**
+ * Compile a tool schema without the response-root relaxation used by the SDK's
+ * live-wire validator. Kept in the loader so the public schema facade does not
+ * need access to loader file-system state.
+ */
+export declare function getCanonicalToolValidatorForVersion(toolName: string, direction: Direction, version?: string): ValidateFunction | undefined;
 /** List of (toolName, direction) pairs that have schemas. Used by tests. */
 export declare function listValidatorKeys(version?: string): string[];
 /**