@adcp/sdk 7.11.1 → 7.11.3

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

@@ -7,6 +7,8 @@
  * - runStoryboardStep(): run a single step (stateless, LLM-friendly)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyStoryboardVersionOptions = applyStoryboardVersionOptions;
+exports.applyAdcpVersionRunOptions = applyAdcpVersionRunOptions;
 exports.resolveCapabilityPath = resolveCapabilityPath;
 exports.evaluateCapabilityPredicate = evaluateCapabilityPredicate;
 exports.__redactSecretsForTest = __redactSecretsForTest;
@@ -39,6 +41,7 @@ const request_builder_1 = require("./request-builder");
 const client_2 = require("../client");
 const idempotency_1 = require("../../utils/idempotency");
 const schema_loader_1 = require("../../validation/schema-loader");
+const version_1 = require("../../version");
 const probes_1 = require("./probes");
 const test_kit_1 = require("./test-kit");
 const loader_1 = require("./loader");
@@ -65,6 +68,25 @@ const SKIP_DETAILS = {
 };
 const CONTROLLER_SEEDING_FAILED_DETAIL = 'Skipped: pre-flight comply_test_controller seeding failed; the agent was not populated with the storyboard fixtures the remaining phases depend on.';
 const OAUTH_NOT_ADVERTISED_DETAIL = 'Skipped: agent does not advertise OAuth — /.well-known/oauth-protected-resource returned 404 (RFC 9728 §3). API-key path must carry auth_mechanism_verified for this storyboard to pass.';
+function applyStoryboardVersionOptions(storyboard, options) {
+    return applyAdcpVersionRunOptions(storyboard.adcp_version, options);
+}
+function applyAdcpVersionRunOptions(defaultAdcpVersion, options) {
+    const adcpVersion = options.adcpVersion ?? defaultAdcpVersion;
+    if (adcpVersion === undefined)
+        return options;
+    const versionEnvelope = options.versionEnvelope ?? storyboardVersionEnvelopeMode(adcpVersion);
+    if (options.adcpVersion === adcpVersion && options.versionEnvelope === versionEnvelope)
+        return options;
+    return { ...options, adcpVersion, versionEnvelope };
+}
+function storyboardVersionEnvelopeMode(adcpVersion) {
+    const bundleKey = (0, schema_loader_1.resolveBundleKey)(adcpVersion);
+    const major = (0, version_1.parseAdcpMajorVersion)(bundleKey);
+    if (Number.isFinite(major) && major < 3)
+        return 'none';
+    return 'auto';
+}
 /**
  * Suffix appended to the skip detail when the sole-stateful-step exemption
  * fires (`not_applicable` / `missing_tool` / `missing_test_controller` on
@@ -170,12 +192,21 @@ function evaluateCapabilityPredicate(predicate, actual) {
     // a real spec-coverage gap (under-declared agent) rather than a behavior
     // the agent affirmatively refused. Skip ONLY when the agent declared a
     // value AND that value disagrees with the predicate.
+    //
+    // Exception: optional proposal lifecycle storyboards require an explicit
+    // seller opt-in. Absent support is equivalent to unsupported.
+    if (actual === undefined && isProposalLifecycleGate(predicate)) {
+        return `Capability predicate \`${predicate.path} === true\` not satisfied: ` + `agent did not declare support.`;
+    }
     if (actual !== undefined && actual !== predicate.equals) {
         return (`Capability predicate \`${predicate.path} === ${JSON.stringify(predicate.equals)}\` not satisfied: ` +
             `agent declared ${JSON.stringify(actual)}.`);
     }
     return null;
 }
+function isProposalLifecycleGate(predicate) {
+    return predicate.path === 'media_buy.supports_proposals' && predicate.equals === true;
+}
 function buildSkip(reason, detail) {
     return { reason, detail: detail ?? SKIP_DETAILS[reason] };
 }
@@ -571,6 +602,7 @@ function filterResponseHeaders(headers) {
  * empty on instance B.
  */
 async function runStoryboard(agentUrlOrUrls, storyboard, options = {}) {
+    options = applyStoryboardVersionOptions(storyboard, options);
     (0, test_kit_1.validateTestKit)(options.test_kit);
     // Enforce authoring-time branch_set invariants regardless of how the
     // storyboard reached us. YAML callers already ran these rules in
@@ -1342,9 +1374,9 @@ async function executeStoryboardPass(agentUrls, storyboard, options, dispatchOff
     // tests (e.g. `adcp.idempotency.supported: false`), skip the whole storyboard
     // rather than producing a cascade of misleading per-phase failures.
     if (storyboard.requires_capability) {
+        const cap = storyboard.requires_capability;
         const rawCaps = profile?.raw_capabilities;
         if (rawCaps !== undefined) {
-            const cap = storyboard.requires_capability;
             const actual = resolveCapabilityPath(rawCaps, cap.path);
             const unmetDetail = evaluateCapabilityPredicate(cap, actual);
             if (unmetDetail !== null) {
@@ -1356,6 +1388,19 @@ async function executeStoryboardPass(agentUrls, storyboard, options, dispatchOff
                 };
             }
         }
+        else if (isProposalLifecycleGate(cap) &&
+            profile !== undefined &&
+            !profile.tools.includes('get_adcp_capabilities')) {
+            const unmetDetail = evaluateCapabilityPredicate(cap, undefined);
+            if (unmetDetail !== null) {
+                if (!options._client)
+                    await (0, protocols_1.closeConnections)(options.protocol);
+                return {
+                    ...buildCapabilityUnsupportedResult(agentUrls, storyboard, unmetDetail),
+                    notices: preflightNotices,
+                };
+            }
+        }
     }
     // Enforce required_tools pre-flight gate: if the storyboard declares tools
     // that make it applicable (at least one must be present) and the agent
@@ -2558,6 +2603,7 @@ function summarizeStrictValidation(phases) {
  * Context is passed in and returned, enabling step-by-step orchestration.
  */
 async function runStoryboardStep(agentUrl, storyboard, stepId, options = {}) {
+    options = applyStoryboardVersionOptions(storyboard, options);
     (0, test_kit_1.validateTestKit)(options.test_kit);
     const client = (0, client_1.getOrCreateClient)(agentUrl, options);
     // Discover agent profile for standalone step execution. Captured so the
@@ -3245,6 +3291,8 @@ client, step, phaseId, context, allSteps, options, state) {
         const upstreamTraffic = await prefetchUpstreamTraffic(step.id, resolvedValidations, client, options, runState, requestStartIso);
         const vctx = {
             taskName: effectiveStep.task,
+            ...(options.adcpVersion && { adcpVersion: options.adcpVersion }),
+            ...(options._serverAdcpVersion && { responseAdcpVersion: options._serverAdcpVersion }),
             ...(taskResult && { taskResult }),
             ...(httpResult && { httpResult }),
             agentUrl: runState.agentUrl,
@@ -3634,6 +3682,8 @@ async function executeProbeStep(step, phaseId, context, allSteps, options, runSt
     }
     const vctx = {
         taskName: step.task,
+        ...(options.adcpVersion && { adcpVersion: options.adcpVersion }),
+        ...(options._serverAdcpVersion && { responseAdcpVersion: options._serverAdcpVersion }),
         httpResult,
         agentUrl: runState.agentUrl,
         contributions: runState.contributions,