@adcp/sdk 16.2.0 → 16.3.0

package/dist/lib/testing/storyboard/index.d.ts

@@ -16,9 +16,16 @@ export type { CapturedWebhook, CapturedWebhookChallenge, CreateWebhookReceiverOp
 export { createRunnerVariables } from './context';
 export type { RunnerVariables } from './context';
 export { WEBHOOK_ASSERTION_TASKS } from './webhook-assertions';
-export { runStoryboard, runStoryboardStep, applyAdcpVersionRunOptions, applyStoryboardVersionOptions, getFirstStepPreview, summarizeStrictValidation, listStrictOnlyFailures, resolveCapabilityPath, evaluateCapabilityPredicate, describeStoryboardCapabilityGates, buildDiscoveryFailedResult, } from './runner';
+export { prepareStoryboardFixtures, runStoryboard, runStoryboardStep, applyAdcpVersionRunOptions, applyStoryboardVersionOptions, getFirstStepPreview, summarizeStrictValidation, listStrictOnlyFailures, resolveCapabilityPath, evaluateCapabilityPredicate, describeStoryboardCapabilityGates, buildDiscoveryFailedResult, } from './runner';
 export { parseStoryboard, loadStoryboardFile, normalizeValidationOnlyTasks, VALIDATION_ONLY_TASK } from './loader';
-export { applyFixtureBindingsToRequest, buildFixtureResolutionSpecs, FixtureBindingRegistry, matchesFixtureRequirements, normalizeFixtureMatchExpression, validateFixtureResolutionDeclarations, } from './fixture-resolution';
+export { applyFixtureBindingsToRequest, buildFixtureResolutionSpecs, FixtureBindingRegistry, matchesFixtureRequirements, matchFixtureRequirementsWithWitness, normalizeFixtureContextOutputs, normalizeFixtureMatchExpression, validateFixtureResolutionDeclarations, } from './fixture-resolution';
+export type { FixtureContextOutput } from './types';
+export { COLLECTION_DIAGNOSTIC_LIMIT, COLLECTION_PAIR_LIMIT, COLLECTION_TARGETING_MODES, COLLECTION_WITNESS_KINDS, compareCollectionPairs, diffCollectionPairSets, evaluateCollectionSelection, formatCollectionPair, normalizeCollectionSelectionSelector, normalizeCollectionSelectors, productSatisfiesCollectionSelection, readCollectionWitness, summarizeCollectionPairs, } from './collection-selection';
+export type { ResolvedCollectionSelectionSelector, CollectionNormalizationCode, CollectionNormalizationFailure, CollectionNormalizationResult, CrossPublisherCollectionRelation, CollectionPair, CollectionSelectionEvaluation, CollectionSelectionSelector, CollectionSelectionWitness, CollectionSelectorObject, CollectionWitnessKind, CollectionWitnessReadResult, NormalizedCollectionSelectors, } from './collection-selection';
+export { isProtectedContextKey, PROTECTED_CONTEXT_PREFIX, ProtectedContextViolation } from './protected-context';
+export type { ProtectedContextViolationCode } from './protected-context';
+export { isTrustedPreparedFixtures, PREPARED_FIXTURES_CONTRACT_VERSION, PreparedStoryboardFixtures, withPreparedFixtures, } from './prepared-fixtures';
+export type { PreparedFixtureBinding, PreparedFixtureSelection, PreparedFixturesAuthorizer, PreparedFixturesDecision, PreparedFixturesDisposition, PreparedFixturesLookup, PreparedFixturesRefusal, PreparedFixturesRefusalCode, PreparedFixturesReference, PreparedSchemaArtifact, } from './prepared-fixtures';
 export { getComplianceCacheDir, getExternalSchemaRootForCompliance, loadComplianceIndex, listBundles, loadBundleStoryboards, listAllComplianceStoryboards, getComplianceStoryboardById, findBundleById, resolveBundleOrStoryboard, resolveStoryboardsForCapabilities, isComplianceVersionSupported, loadSpecialismDetail, listSpecialisms, CapabilityResolutionError, PROTOCOL_TO_PATH, UNBASELINED_SUPPORTED_PROTOCOLS, } from './compliance';
 export type { AgentCapabilities, BundleKind, BundleRef, CapabilityResolutionCode, ComplianceIndex, ComplianceIndexProtocol, ComplianceIndexSpecialism, NotApplicableStoryboard, ResolveOptions, ResolvedBundle, ResolvedStoryboards, SpecialismDetail, } from './compliance';
 export { TASK_TO_METHOD, executeStoryboardTask } from './task-map';

package/dist/lib/testing/storyboard/index.js

@@ -20,12 +20,20 @@ var storyboard_exports = {};
 __export(storyboard_exports, {
   AdagentsJsonSchema: () => import_wellknown_schemas.AdagentsJsonSchema,
   BrandJsonSchema: () => import_wellknown_schemas.BrandJsonSchema,
+  COLLECTION_DIAGNOSTIC_LIMIT: () => import_collection_selection.COLLECTION_DIAGNOSTIC_LIMIT,
+  COLLECTION_PAIR_LIMIT: () => import_collection_selection.COLLECTION_PAIR_LIMIT,
+  COLLECTION_TARGETING_MODES: () => import_collection_selection.COLLECTION_TARGETING_MODES,
+  COLLECTION_WITNESS_KINDS: () => import_collection_selection.COLLECTION_WITNESS_KINDS,
   CONTEXT_EXTRACTORS: () => import_context2.CONTEXT_EXTRACTORS,
   CapabilityResolutionError: () => import_compliance.CapabilityResolutionError,
   FixtureBindingRegistry: () => import_fixture_resolution.FixtureBindingRegistry,
   MCP_SESSION_PROBE_TASK: () => import_types2.MCP_SESSION_PROBE_TASK,
+  PREPARED_FIXTURES_CONTRACT_VERSION: () => import_prepared_fixtures.PREPARED_FIXTURES_CONTRACT_VERSION,
   PROBE_TASK_ALLOWLIST: () => import_test_kit.PROBE_TASK_ALLOWLIST,
+  PROTECTED_CONTEXT_PREFIX: () => import_protected_context.PROTECTED_CONTEXT_PREFIX,
   PROTOCOL_TO_PATH: () => import_compliance.PROTOCOL_TO_PATH,
+  PreparedStoryboardFixtures: () => import_prepared_fixtures.PreparedStoryboardFixtures,
+  ProtectedContextViolation: () => import_protected_context.ProtectedContextViolation,
   RATE_LIMIT_TRIP_CONTRACT: () => import_rate_limit_trip.RATE_LIMIT_TRIP_CONTRACT,
   RATE_LIMIT_TRIP_DEFAULT_REPLAY_MAX_WAIT_SECONDS: () => import_rate_limit_trip.RATE_LIMIT_TRIP_DEFAULT_REPLAY_MAX_WAIT_SECONDS,
   RATE_LIMIT_TRIP_MAX_ATTEMPTS_MAX: () => import_rate_limit_trip.RATE_LIMIT_TRIP_MAX_ATTEMPTS_MAX,
@@ -50,11 +58,14 @@ __export(storyboard_exports, {
   buildRequest: () => import_request_builder.buildRequest,
   clearAssertionRegistry: () => import_assertions.clearAssertionRegistry,
   clearSandboxCache: () => import_sandbox_entities.clearSandboxCache,
+  compareCollectionPairs: () => import_collection_selection.compareCollectionPairs,
   createRunnerVariables: () => import_context.createRunnerVariables,
   createWebhookReceiver: () => import_webhook_receiver.createWebhookReceiver,
   describeStoryboardCapabilityGates: () => import_runner.describeStoryboardCapabilityGates,
   detectContextRejectionHints: () => import_rejection_hints.detectContextRejectionHints,
+  diffCollectionPairSets: () => import_collection_selection.diffCollectionPairSets,
   evaluateCapabilityPredicate: () => import_runner.evaluateCapabilityPredicate,
+  evaluateCollectionSelection: () => import_collection_selection.evaluateCollectionSelection,
   executeStoryboardTask: () => import_task_map.executeStoryboardTask,
   expandCreativeAssetDirectives: () => import_creative_assets.expandCreativeAssetDirectives,
   extractContext: () => import_context2.extractContext,
@@ -62,6 +73,7 @@ __export(storyboard_exports, {
   extractTaskAdcpError: () => import_rate_limit_trip.extractTaskAdcpError,
   findBundleById: () => import_compliance.findBundleById,
   findUnresolvedCreativeAssetDirectives: () => import_creative_assets.findUnresolvedCreativeAssetDirectives,
+  formatCollectionPair: () => import_collection_selection.formatCollectionPair,
   getAssertion: () => import_assertions.getAssertion,
   getComplianceCacheDir: () => import_compliance.getComplianceCacheDir,
   getComplianceStoryboardById: () => import_compliance.getComplianceStoryboardById,
@@ -75,7 +87,9 @@ __export(storyboard_exports, {
   hasRequestBuilder: () => import_request_builder.hasRequestBuilder,
   injectContext: () => import_context2.injectContext,
   isComplianceVersionSupported: () => import_compliance.isComplianceVersionSupported,
+  isProtectedContextKey: () => import_protected_context.isProtectedContextKey,
   isSandboxDomain: () => import_sandbox_entities.isSandboxDomain,
+  isTrustedPreparedFixtures: () => import_prepared_fixtures.isTrustedPreparedFixtures,
   listAllComplianceStoryboards: () => import_compliance.listAllComplianceStoryboards,
   listAssertions: () => import_assertions.listAssertions,
   listBundles: () => import_compliance.listBundles,
@@ -87,12 +101,19 @@ __export(storyboard_exports, {
   loadOAuthMetadataGraphVectors: () => import_oauth_metadata_graph.loadOAuthMetadataGraphVectors,
   loadSpecialismDetail: () => import_compliance.loadSpecialismDetail,
   loadStoryboardFile: () => import_loader.loadStoryboardFile,
+  matchFixtureRequirementsWithWitness: () => import_fixture_resolution.matchFixtureRequirementsWithWitness,
   matchesFixtureRequirements: () => import_fixture_resolution.matchesFixtureRequirements,
+  normalizeCollectionSelectionSelector: () => import_collection_selection.normalizeCollectionSelectionSelector,
+  normalizeCollectionSelectors: () => import_collection_selection.normalizeCollectionSelectors,
+  normalizeFixtureContextOutputs: () => import_fixture_resolution.normalizeFixtureContextOutputs,
   normalizeFixtureMatchExpression: () => import_fixture_resolution.normalizeFixtureMatchExpression,
   normalizeOAuthResourceForComparison: () => import_oauth_metadata_graph.normalizeOAuthResourceForComparison,
   normalizeValidationOnlyTasks: () => import_loader.normalizeValidationOnlyTasks,
   parsePath: () => import_path.parsePath,
   parseStoryboard: () => import_loader.parseStoryboard,
+  prepareStoryboardFixtures: () => import_runner.prepareStoryboardFixtures,
+  productSatisfiesCollectionSelection: () => import_collection_selection.productSatisfiesCollectionSelection,
+  readCollectionWitness: () => import_collection_selection.readCollectionWitness,
   redactOAuthUrlForOutput: () => import_oauth_metadata_graph.redactOAuthUrlForOutput,
   registerAssertion: () => import_assertions.registerAssertion,
   resolveAssertions: () => import_assertions.resolveAssertions,
@@ -105,11 +126,13 @@ __export(storyboard_exports, {
   runStoryboardStep: () => import_runner.runStoryboardStep,
   runValidations: () => import_validations.runValidations,
   setPath: () => import_path.setPath,
+  summarizeCollectionPairs: () => import_collection_selection.summarizeCollectionPairs,
   summarizeStrictValidation: () => import_runner.summarizeStrictValidation,
   validateCreativeBuildProbeSpec: () => import_creative_build_probe.validateCreativeBuildProbeSpec,
   validateFixtureResolutionDeclarations: () => import_fixture_resolution.validateFixtureResolutionDeclarations,
   validateRateLimitTripSpec: () => import_rate_limit_trip.validateRateLimitTripSpec,
-  validateTestKit: () => import_test_kit.validateTestKit
+  validateTestKit: () => import_test_kit.validateTestKit,
+  withPreparedFixtures: () => import_prepared_fixtures.withPreparedFixtures
 });
 module.exports = __toCommonJS(storyboard_exports);
 var import_default_invariants = require('./default-invariants.js');
@@ -122,6 +145,9 @@ var import_webhook_assertions = require('./webhook-assertions.js');
 var import_runner = require('./runner.js');
 var import_loader = require('./loader.js');
 var import_fixture_resolution = require('./fixture-resolution.js');
+var import_collection_selection = require('./collection-selection.js');
+var import_protected_context = require('./protected-context.js');
+var import_prepared_fixtures = require('./prepared-fixtures.js');
 var import_compliance = require('./compliance.js');
 var import_task_map = require('./task-map.js');
 var import_creative_assets = require('./creative-assets.js');
@@ -141,12 +167,20 @@ var import_creative_build_probe = require('./creative-build-probe.js');
 0 && (module.exports = {
   AdagentsJsonSchema,
   BrandJsonSchema,
+  COLLECTION_DIAGNOSTIC_LIMIT,
+  COLLECTION_PAIR_LIMIT,
+  COLLECTION_TARGETING_MODES,
+  COLLECTION_WITNESS_KINDS,
   CONTEXT_EXTRACTORS,
   CapabilityResolutionError,
   FixtureBindingRegistry,
   MCP_SESSION_PROBE_TASK,
+  PREPARED_FIXTURES_CONTRACT_VERSION,
   PROBE_TASK_ALLOWLIST,
+  PROTECTED_CONTEXT_PREFIX,
   PROTOCOL_TO_PATH,
+  PreparedStoryboardFixtures,
+  ProtectedContextViolation,
   RATE_LIMIT_TRIP_CONTRACT,
   RATE_LIMIT_TRIP_DEFAULT_REPLAY_MAX_WAIT_SECONDS,
   RATE_LIMIT_TRIP_MAX_ATTEMPTS_MAX,
@@ -171,11 +205,14 @@ var import_creative_build_probe = require('./creative-build-probe.js');
   buildRequest,
   clearAssertionRegistry,
   clearSandboxCache,
+  compareCollectionPairs,
   createRunnerVariables,
   createWebhookReceiver,
   describeStoryboardCapabilityGates,
   detectContextRejectionHints,
+  diffCollectionPairSets,
   evaluateCapabilityPredicate,
+  evaluateCollectionSelection,
   executeStoryboardTask,
   expandCreativeAssetDirectives,
   extractContext,
@@ -183,6 +220,7 @@ var import_creative_build_probe = require('./creative-build-probe.js');
   extractTaskAdcpError,
   findBundleById,
   findUnresolvedCreativeAssetDirectives,
+  formatCollectionPair,
   getAssertion,
   getComplianceCacheDir,
   getComplianceStoryboardById,
@@ -196,7 +234,9 @@ var import_creative_build_probe = require('./creative-build-probe.js');
   hasRequestBuilder,
   injectContext,
   isComplianceVersionSupported,
+  isProtectedContextKey,
   isSandboxDomain,
+  isTrustedPreparedFixtures,
   listAllComplianceStoryboards,
   listAssertions,
   listBundles,
@@ -208,12 +248,19 @@ var import_creative_build_probe = require('./creative-build-probe.js');
   loadOAuthMetadataGraphVectors,
   loadSpecialismDetail,
   loadStoryboardFile,
+  matchFixtureRequirementsWithWitness,
   matchesFixtureRequirements,
+  normalizeCollectionSelectionSelector,
+  normalizeCollectionSelectors,
+  normalizeFixtureContextOutputs,
   normalizeFixtureMatchExpression,
   normalizeOAuthResourceForComparison,
   normalizeValidationOnlyTasks,
   parsePath,
   parseStoryboard,
+  prepareStoryboardFixtures,
+  productSatisfiesCollectionSelection,
+  readCollectionWitness,
   redactOAuthUrlForOutput,
   registerAssertion,
   resolveAssertions,
@@ -226,9 +273,11 @@ var import_creative_build_probe = require('./creative-build-probe.js');
   runStoryboardStep,
   runValidations,
   setPath,
+  summarizeCollectionPairs,
   summarizeStrictValidation,
   validateCreativeBuildProbeSpec,
   validateFixtureResolutionDeclarations,
   validateRateLimitTripSpec,
-  validateTestKit
+  validateTestKit,
+  withPreparedFixtures
 });

package/dist/lib/testing/storyboard/index.mjs

@@ -14,6 +14,7 @@ import { createWebhookReceiver } from "./webhook-receiver.mjs";
 import { createRunnerVariables } from "./context.mjs";
 import { WEBHOOK_ASSERTION_TASKS } from "./webhook-assertions.mjs";
 import {
+  prepareStoryboardFixtures,
   runStoryboard,
   runStoryboardStep,
   applyAdcpVersionRunOptions,
@@ -32,9 +33,33 @@ import {
   buildFixtureResolutionSpecs,
   FixtureBindingRegistry,
   matchesFixtureRequirements,
+  matchFixtureRequirementsWithWitness,
+  normalizeFixtureContextOutputs,
   normalizeFixtureMatchExpression,
   validateFixtureResolutionDeclarations
 } from "./fixture-resolution.mjs";
+import {
+  COLLECTION_DIAGNOSTIC_LIMIT,
+  COLLECTION_PAIR_LIMIT,
+  COLLECTION_TARGETING_MODES,
+  COLLECTION_WITNESS_KINDS,
+  compareCollectionPairs,
+  diffCollectionPairSets,
+  evaluateCollectionSelection,
+  formatCollectionPair,
+  normalizeCollectionSelectionSelector,
+  normalizeCollectionSelectors,
+  productSatisfiesCollectionSelection,
+  readCollectionWitness,
+  summarizeCollectionPairs
+} from "./collection-selection.mjs";
+import { isProtectedContextKey, PROTECTED_CONTEXT_PREFIX, ProtectedContextViolation } from "./protected-context.mjs";
+import {
+  isTrustedPreparedFixtures,
+  PREPARED_FIXTURES_CONTRACT_VERSION,
+  PreparedStoryboardFixtures,
+  withPreparedFixtures
+} from "./prepared-fixtures.mjs";
 import {
   getComplianceCacheDir,
   getExternalSchemaRootForCompliance,
@@ -99,12 +124,20 @@ import { resolveCreativeBuildProbe, validateCreativeBuildProbeSpec } from "./cre
 export {
   AdagentsJsonSchema,
   BrandJsonSchema,
+  COLLECTION_DIAGNOSTIC_LIMIT,
+  COLLECTION_PAIR_LIMIT,
+  COLLECTION_TARGETING_MODES,
+  COLLECTION_WITNESS_KINDS,
   CONTEXT_EXTRACTORS,
   CapabilityResolutionError,
   FixtureBindingRegistry,
   MCP_SESSION_PROBE_TASK,
+  PREPARED_FIXTURES_CONTRACT_VERSION,
   PROBE_TASK_ALLOWLIST,
+  PROTECTED_CONTEXT_PREFIX,
   PROTOCOL_TO_PATH,
+  PreparedStoryboardFixtures,
+  ProtectedContextViolation,
   RATE_LIMIT_TRIP_CONTRACT,
   RATE_LIMIT_TRIP_DEFAULT_REPLAY_MAX_WAIT_SECONDS,
   RATE_LIMIT_TRIP_MAX_ATTEMPTS_MAX,
@@ -129,11 +162,14 @@ export {
   buildRequest,
   clearAssertionRegistry,
   clearSandboxCache,
+  compareCollectionPairs,
   createRunnerVariables,
   createWebhookReceiver,
   describeStoryboardCapabilityGates,
   detectContextRejectionHints,
+  diffCollectionPairSets,
   evaluateCapabilityPredicate,
+  evaluateCollectionSelection,
   executeStoryboardTask,
   expandCreativeAssetDirectives,
   extractContext,
@@ -141,6 +177,7 @@ export {
   extractTaskAdcpError,
   findBundleById,
   findUnresolvedCreativeAssetDirectives,
+  formatCollectionPair,
   getAssertion,
   getComplianceCacheDir,
   getComplianceStoryboardById,
@@ -154,7 +191,9 @@ export {
   hasRequestBuilder,
   injectContext,
   isComplianceVersionSupported,
+  isProtectedContextKey,
   isSandboxDomain,
+  isTrustedPreparedFixtures,
   listAllComplianceStoryboards,
   listAssertions,
   listBundles,
@@ -166,12 +205,19 @@ export {
   loadOAuthMetadataGraphVectors,
   loadSpecialismDetail,
   loadStoryboardFile,
+  matchFixtureRequirementsWithWitness,
   matchesFixtureRequirements,
+  normalizeCollectionSelectionSelector,
+  normalizeCollectionSelectors,
+  normalizeFixtureContextOutputs,
   normalizeFixtureMatchExpression,
   normalizeOAuthResourceForComparison,
   normalizeValidationOnlyTasks,
   parsePath,
   parseStoryboard,
+  prepareStoryboardFixtures,
+  productSatisfiesCollectionSelection,
+  readCollectionWitness,
   redactOAuthUrlForOutput,
   registerAssertion,
   resolveAssertions,
@@ -184,9 +230,11 @@ export {
   runStoryboardStep,
   runValidations,
   setPath,
+  summarizeCollectionPairs,
   summarizeStrictValidation,
   validateCreativeBuildProbeSpec,
   validateFixtureResolutionDeclarations,
   validateRateLimitTripSpec,
-  validateTestKit
+  validateTestKit,
+  withPreparedFixtures
 };