@adcp/sdk 14.0.0-rc.49 → 14.0.0-rc.50

package/dist/lib/testing/storyboard/request-signing/vector-loader.mjs

@@ -2,6 +2,17 @@ import { existsSync, readFileSync, readdirSync } from "fs";
 import { basename, join } from "path";
 import { getComplianceCacheDir } from "../compliance.mjs";
 import { CONTRACT_IDS } from "./types.mjs";
+function selectRequestSigningVectors(loaded, signingProfileVersion) {
+  const profile = signingProfileVersion ? loaded.profiles[signingProfileVersion] : void 0;
+  if (!signingProfileVersion) return { positive: loaded.positive, negative: loaded.negative };
+  if (!profile)
+    throw new Error(`Request-signing profile ${signingProfileVersion} is unavailable in ${loaded.sourceDir}`);
+  return profile;
+}
+function signingProfileForAdcpVersion(version) {
+  const match = /^(\d+)\.(\d+)/.exec(version ?? "");
+  return match && Number(match[1]) === 3 && Number(match[2]) === 2 ? "3.2" : void 0;
+}
 const ERROR_CODES = /* @__PURE__ */ new Set([
   "request_signature_required",
   "request_signature_header_malformed",
@@ -247,5 +258,7 @@ export {
   __resetVectorCache,
   findKey,
   loadRequestSigningKeys,
-  loadRequestSigningVectors
+  loadRequestSigningVectors,
+  selectRequestSigningVectors,
+  signingProfileForAdcpVersion
 };

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

@@ -879,11 +879,6 @@ function validateAgentsMap(agentUrlOrUrls, storyboard, options) {
       "runStoryboard: `agents` is incompatible with `_client` override. A single client cannot serve multiple agents; per-agent clients are constructed from the map."
     );
   }
-  if (storyboard.prerequisites?.controller_seeding === true && options.skip_controller_seeding !== true) {
-    throw new Error(
-      "runStoryboard: `agents` + `prerequisites.controller_seeding: true` is not yet supported. Controller seeding currently targets a single tenant; cross-tenant seed routing is a follow-up. Pre-seed each tenant out-of-band and pass `skip_controller_seeding: true` to opt out of the runner-side seeding loop."
-    );
-  }
   const firstArgEmpty = agentUrlOrUrls === "" || Array.isArray(agentUrlOrUrls) && agentUrlOrUrls.length === 0;
   if (!firstArgEmpty) {
     throw new Error(
@@ -891,6 +886,24 @@ function validateAgentsMap(agentUrlOrUrls, storyboard, options) {
     );
   }
 }
+function fixtureOwnerTask(scenario) {
+  switch (scenario) {
+    case "seed_account":
+    case "seed_buyer_agent":
+      return "sync_accounts";
+    case "seed_product":
+    case "seed_pricing_option":
+      return "get_products";
+    case "seed_creative_format":
+      return "list_creative_formats";
+    case "seed_creative":
+      return "sync_creatives";
+    case "seed_plan":
+      return "sync_plans";
+    case "seed_media_buy":
+      return "get_media_buys";
+  }
+}
 function buildCapabilityUnsupportedResult(agentUrls, storyboard, detail) {
   const syntheticStep = {
     storyboard_id: storyboard.id,
@@ -1943,13 +1956,35 @@ async function executeStoryboardPass(agentUrls, storyboard, options, dispatchOff
         options,
         context,
         clients[0],
-        routingContext ? (task) => {
-          if (!options.agentTools?.includes(task))
-            return { client: clients[0], options: { ...options, agentTools: [] } };
+        routingContext ? (task, call) => {
+          if (storyboard.prerequisites?.controller_seeding !== true) {
+            if (!options.agentTools?.includes(task)) {
+              return { client: clients[0], options: { ...options, agentTools: [] } };
+            }
+            const selected2 = dispatch.nextFor({
+              id: `__fixture_resolution_${task}__`,
+              title: `Fixture resolution via ${task}`,
+              task
+            });
+            return { client: selected2.client, options: selected2.options };
+          }
+          const ownerTask = call ? fixtureOwnerTask(call.scenario) : task;
+          const matching = storyboard.phases.flatMap(
+            (phase) => phase.steps.filter((step) => step.task === ownerTask && step.agent !== void 0)
+          );
+          const keys = [...new Set(matching.map((step) => step.agent))];
+          if (keys.length > 1) {
+            throw new import_agent_routing.RoutingError(
+              `Fixture ${call?.step_id ?? task} has multiple owner routes [${keys.join(", ")}]. Disambiguate the storyboard topology before seeding (adcp-client#3047).`,
+              ownerTask,
+              "ambiguous fixture owner"
+            );
+          }
           const selected = dispatch.nextFor({
-            id: `__fixture_resolution_${task}__`,
-            title: `Fixture resolution via ${task}`,
-            task
+            id: `__fixture_resolution_${call?.step_id ?? task}__`,
+            title: `Fixture resolution via ${ownerTask}`,
+            task: ownerTask,
+            ...keys.length === 1 && { agent: keys[0] }
           });
           return { client: selected.client, options: selected.options };
         } : void 0

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

@@ -902,11 +902,6 @@ function validateAgentsMap(agentUrlOrUrls, storyboard, options) {
       "runStoryboard: `agents` is incompatible with `_client` override. A single client cannot serve multiple agents; per-agent clients are constructed from the map."
     );
   }
-  if (storyboard.prerequisites?.controller_seeding === true && options.skip_controller_seeding !== true) {
-    throw new Error(
-      "runStoryboard: `agents` + `prerequisites.controller_seeding: true` is not yet supported. Controller seeding currently targets a single tenant; cross-tenant seed routing is a follow-up. Pre-seed each tenant out-of-band and pass `skip_controller_seeding: true` to opt out of the runner-side seeding loop."
-    );
-  }
   const firstArgEmpty = agentUrlOrUrls === "" || Array.isArray(agentUrlOrUrls) && agentUrlOrUrls.length === 0;
   if (!firstArgEmpty) {
     throw new Error(
@@ -914,6 +909,24 @@ function validateAgentsMap(agentUrlOrUrls, storyboard, options) {
     );
   }
 }
+function fixtureOwnerTask(scenario) {
+  switch (scenario) {
+    case "seed_account":
+    case "seed_buyer_agent":
+      return "sync_accounts";
+    case "seed_product":
+    case "seed_pricing_option":
+      return "get_products";
+    case "seed_creative_format":
+      return "list_creative_formats";
+    case "seed_creative":
+      return "sync_creatives";
+    case "seed_plan":
+      return "sync_plans";
+    case "seed_media_buy":
+      return "get_media_buys";
+  }
+}
 function buildCapabilityUnsupportedResult(agentUrls, storyboard, detail) {
   const syntheticStep = {
     storyboard_id: storyboard.id,
@@ -1966,13 +1979,35 @@ async function executeStoryboardPass(agentUrls, storyboard, options, dispatchOff
         options,
         context,
         clients[0],
-        routingContext ? (task) => {
-          if (!options.agentTools?.includes(task))
-            return { client: clients[0], options: { ...options, agentTools: [] } };
+        routingContext ? (task, call) => {
+          if (storyboard.prerequisites?.controller_seeding !== true) {
+            if (!options.agentTools?.includes(task)) {
+              return { client: clients[0], options: { ...options, agentTools: [] } };
+            }
+            const selected2 = dispatch.nextFor({
+              id: `__fixture_resolution_${task}__`,
+              title: `Fixture resolution via ${task}`,
+              task
+            });
+            return { client: selected2.client, options: selected2.options };
+          }
+          const ownerTask = call ? fixtureOwnerTask(call.scenario) : task;
+          const matching = storyboard.phases.flatMap(
+            (phase) => phase.steps.filter((step) => step.task === ownerTask && step.agent !== void 0)
+          );
+          const keys = [...new Set(matching.map((step) => step.agent))];
+          if (keys.length > 1) {
+            throw new RoutingError(
+              `Fixture ${call?.step_id ?? task} has multiple owner routes [${keys.join(", ")}]. Disambiguate the storyboard topology before seeding (adcp-client#3047).`,
+              ownerTask,
+              "ambiguous fixture owner"
+            );
+          }
           const selected = dispatch.nextFor({
-            id: `__fixture_resolution_${task}__`,
-            title: `Fixture resolution via ${task}`,
-            task
+            id: `__fixture_resolution_${call?.step_id ?? task}__`,
+            title: `Fixture resolution via ${ownerTask}`,
+            task: ownerTask,
+            ...keys.length === 1 && { agent: keys[0] }
           });
           return { client: selected.client, options: selected.options };
         } : void 0

package/dist/lib/testing/storyboard/seeding.d.mts

@@ -30,7 +30,7 @@ export declare const CONTROLLER_SEEDING_PHASE_ID = "__controller_seeding__";
  * importing it here would cross the testing ⇄ server module boundary. */
 type SeedScenario = 'seed_account' | 'seed_product' | 'seed_pricing_option' | 'seed_creative_format' | 'seed_creative' | 'seed_plan' | 'seed_media_buy';
 type BuyerAgentSeedScenario = 'seed_buyer_agent';
-interface SeedCall {
+export interface SeedCall {
     step_id: string;
     title: string;
     scenario: SeedScenario | BuyerAgentSeedScenario;
@@ -81,7 +81,7 @@ export interface ControllerSeedingResult {
  * not applicable (opt-out, no declaration, empty fixtures) so the runner can
  * treat a no-op identically to a non-seeding storyboard.
  */
-export declare function runControllerSeeding(client: TestClient, storyboard: Storyboard, options: StoryboardRunOptions, context: StoryboardContext, discoveryClient?: TestClient, resolveFixtureAgent?: (task: 'comply_test_controller' | 'get_products') => {
+export declare function runControllerSeeding(client: TestClient, storyboard: Storyboard, options: StoryboardRunOptions, context: StoryboardContext, discoveryClient?: TestClient, resolveFixtureAgent?: (task: 'comply_test_controller' | 'get_products', call?: SeedCall) => {
     client: TestClient;
     options: StoryboardRunOptions;
 }): Promise<ControllerSeedingResult | null>;

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

@@ -30,7 +30,7 @@ export declare const CONTROLLER_SEEDING_PHASE_ID = "__controller_seeding__";
  * importing it here would cross the testing ⇄ server module boundary. */
 type SeedScenario = 'seed_account' | 'seed_product' | 'seed_pricing_option' | 'seed_creative_format' | 'seed_creative' | 'seed_plan' | 'seed_media_buy';
 type BuyerAgentSeedScenario = 'seed_buyer_agent';
-interface SeedCall {
+export interface SeedCall {
     step_id: string;
     title: string;
     scenario: SeedScenario | BuyerAgentSeedScenario;
@@ -81,7 +81,7 @@ export interface ControllerSeedingResult {
  * not applicable (opt-out, no declaration, empty fixtures) so the runner can
  * treat a no-op identically to a non-seeding storyboard.
  */
-export declare function runControllerSeeding(client: TestClient, storyboard: Storyboard, options: StoryboardRunOptions, context: StoryboardContext, discoveryClient?: TestClient, resolveFixtureAgent?: (task: 'comply_test_controller' | 'get_products') => {
+export declare function runControllerSeeding(client: TestClient, storyboard: Storyboard, options: StoryboardRunOptions, context: StoryboardContext, discoveryClient?: TestClient, resolveFixtureAgent?: (task: 'comply_test_controller' | 'get_products', call?: SeedCall) => {
     client: TestClient;
     options: StoryboardRunOptions;
 }): Promise<ControllerSeedingResult | null>;

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

@@ -223,7 +223,10 @@ async function runControllerSeeding(client, storyboard, options, context, discov
     );
   }
   if (storyboard.prerequisites?.controller_seeding !== true) return null;
-  const controllerRouteTools = resolveFixtureAgent ? resolveFixtureAgent("comply_test_controller").options.agentTools : options.agentTools;
+  if (resolveFixtureAgent) {
+    return runRoutedControllerSeeding(storyboard, calls, context, resolveFixtureAgent);
+  }
+  const controllerRouteTools = options.agentTools;
   if (controllerRouteTools && !controllerRouteTools.includes("comply_test_controller")) {
     return buildMissingControllerResult(storyboard, calls, context);
   }
@@ -304,6 +307,78 @@ async function runControllerSeeding(client, storyboard, options, context, discov
     failedCount
   };
 }
+async function runRoutedControllerSeeding(storyboard, calls, context, resolveFixtureAgent) {
+  const start = Date.now();
+  const authoringError = buildAuthoringErrorResult(storyboard, calls, context, start);
+  if (authoringError) return authoringError;
+  const seedContext = { correlation_id: `${storyboardCorrelationPrefix(storyboard)}--__seeding__` };
+  const selected = calls.map((call) => ({ call, route: resolveFixtureAgent("comply_test_controller", call) }));
+  const missing = selected.find(({ route }) => route.options.agentTools?.includes("comply_test_controller") === false);
+  if (missing) {
+    return buildMissingControllerResult(storyboard, calls, context);
+  }
+  const scenarios = /* @__PURE__ */ new Map();
+  for (const { call, route } of selected) {
+    if (!scenarios.has(route.client)) {
+      scenarios.set(
+        route.client,
+        controllerScenarioSetFromOptions(route.options) ?? await fetchControllerScenarioSet(route.client, route.options, seedContext)
+      );
+    }
+    if (scenarios.get(route.client)?.has(call.scenario) === false) {
+      return buildUnsupportedSeedResult(
+        storyboard,
+        calls,
+        context,
+        call.scenario,
+        `The selected route did not advertise ${call.scenario}.`
+      );
+    }
+  }
+  const steps = [];
+  let passedCount = 0;
+  let failedCount = 0;
+  for (const [index, { call, route }] of selected.entries()) {
+    const result = await executeLegacySeedCall(route.client, storyboard, call, route.options, context, seedContext);
+    if (result.step.skip_reason === "fixture_unsatisfied") {
+      const unsupported = buildUnsupportedSeedResult(
+        storyboard,
+        selected.slice(index).map((item) => item.call),
+        context,
+        call.scenario,
+        result.step.skip?.detail
+      );
+      return {
+        ...unsupported,
+        phase: {
+          ...unsupported.phase,
+          passed: failedCount === 0,
+          steps: [...steps, ...unsupported.phase.steps],
+          duration_ms: Date.now() - start
+        },
+        allPassed: failedCount === 0,
+        passedCount,
+        failedCount,
+        seedUnsupported: failedCount === 0
+      };
+    }
+    steps.push(result.step);
+    if (result.step.passed) passedCount++;
+    else failedCount++;
+  }
+  return {
+    phase: {
+      phase_id: CONTROLLER_SEEDING_PHASE_ID,
+      phase_title: "Controller seeding (pre-flight)",
+      passed: failedCount === 0,
+      steps,
+      duration_ms: Date.now() - start
+    },
+    allPassed: failedCount === 0,
+    passedCount,
+    failedCount
+  };
+}
 async function runDeclaredFixtureResolution(seedClient, discoveryClient, storyboard, options, context, calls, resolveFixtureAgent) {
   const start = Date.now();
   const authoringErrorResult = buildAuthoringErrorResult(storyboard, calls, context, start);
@@ -338,9 +413,9 @@ async function runDeclaredFixtureResolution(seedClient, discoveryClient, storybo
   let seedPrepared = false;
   let discoveryPrepared = false;
   const controller = { missing: false, scenarios: null };
-  const prepareSeedAgent = async () => {
-    if (seedPrepared) return;
-    const selected = resolveFixtureAgent?.("comply_test_controller");
+  const prepareSeedAgent = async (call) => {
+    if (seedPrepared && !resolveFixtureAgent) return;
+    const selected = resolveFixtureAgent?.("comply_test_controller", call);
     if (selected) {
       seedClient = selected.client;
       seedOptions = selected.options;
@@ -352,9 +427,9 @@ async function runDeclaredFixtureResolution(seedClient, discoveryClient, storybo
     }
     seedPrepared = true;
   };
-  const prepareDiscoveryAgent = () => {
-    if (discoveryPrepared) return;
-    const selected = resolveFixtureAgent?.("get_products");
+  const prepareDiscoveryAgent = (call) => {
+    if (discoveryPrepared && !resolveFixtureAgent) return;
+    const selected = resolveFixtureAgent?.("get_products", call);
     if (selected) {
       discoveryClient = selected.client;
       discoveryOptions = selected.options;
@@ -362,7 +437,7 @@ async function runDeclaredFixtureResolution(seedClient, discoveryClient, storybo
     discoveryPrepared = true;
   };
   const legacyCalls = calls.filter((call) => resolutionSpecForCall(call, specByKey) === void 0);
-  if (legacyCalls.length > 0) {
+  if (legacyCalls.length > 0 && !resolveFixtureAgent) {
     await prepareSeedAgent();
     if (controller.missing) return buildMissingControllerResult(storyboard, legacyCalls, context);
     if (controller.scenarios) {
@@ -383,14 +458,34 @@ async function runDeclaredFixtureResolution(seedClient, discoveryClient, storybo
     return !spec || spec.strategies.includes("seed");
   });
   if (!resolveFixtureAgent && needsSeedStrategy && !seedPrepared) await prepareSeedAgent();
-  let catalogPromise;
-  const catalog = () => catalogPromise ??= discoverProductCatalog(discoveryClient, discoveryOptions, context);
+  const catalogs = /* @__PURE__ */ new Map();
+  const catalog = () => {
+    let promise = catalogs.get(discoveryClient);
+    if (!promise) {
+      promise = discoverProductCatalog(discoveryClient, discoveryOptions, context);
+      catalogs.set(discoveryClient, promise);
+    }
+    return promise;
+  };
   let passedCount = 0;
   let failedCount = 0;
   let fixtureUnsatisfied = false;
   for (const call of orderedCalls) {
     const spec = resolutionSpecForCall(call, specByKey);
     if (!spec) {
+      if (resolveFixtureAgent) {
+        await prepareSeedAgent(call);
+        if (controller.missing) return buildMissingControllerResult(storyboard, legacyCalls, context);
+        if (controller.scenarios && !controller.scenarios.has(call.scenario)) {
+          return buildUnsupportedSeedResult(
+            storyboard,
+            legacyCalls,
+            context,
+            call.scenario,
+            `The selected route did not advertise ${call.scenario}.`
+          );
+        }
+      }
       const legacy = await executeLegacySeedCall(seedClient, storyboard, call, seedOptions, context, seedContext);
       if (legacy.step.skip_reason === "fixture_unsatisfied") {
         return buildUnsupportedSeedResult(storyboard, legacyCalls, context, call.scenario, legacy.step.skip?.detail);
@@ -415,7 +510,7 @@ async function runDeclaredFixtureResolution(seedClient, discoveryClient, storybo
     }
     for (const strategy of parentUnavailable ? [] : spec.strategies) {
       if (strategy === "seed") {
-        await prepareSeedAgent();
+        await prepareSeedAgent(call);
         const advertised = controller.scenarios?.has(call.scenario);
         if (controller.missing || advertised === false) {
           attempts.push({
@@ -479,7 +574,7 @@ async function runDeclaredFixtureResolution(seedClient, discoveryClient, storybo
         }
       }
       if (strategy === "discover") {
-        prepareDiscoveryAgent();
+        prepareDiscoveryAgent(call);
         if (discoveryOptions.agentTools && !discoveryOptions.agentTools.includes("get_products")) {
           attempts.push({
             strategy,

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

@@ -203,7 +203,10 @@ async function runControllerSeeding(client, storyboard, options, context, discov
     );
   }
   if (storyboard.prerequisites?.controller_seeding !== true) return null;
-  const controllerRouteTools = resolveFixtureAgent ? resolveFixtureAgent("comply_test_controller").options.agentTools : options.agentTools;
+  if (resolveFixtureAgent) {
+    return runRoutedControllerSeeding(storyboard, calls, context, resolveFixtureAgent);
+  }
+  const controllerRouteTools = options.agentTools;
   if (controllerRouteTools && !controllerRouteTools.includes("comply_test_controller")) {
     return buildMissingControllerResult(storyboard, calls, context);
   }
@@ -284,6 +287,78 @@ async function runControllerSeeding(client, storyboard, options, context, discov
     failedCount
   };
 }
+async function runRoutedControllerSeeding(storyboard, calls, context, resolveFixtureAgent) {
+  const start = Date.now();
+  const authoringError = buildAuthoringErrorResult(storyboard, calls, context, start);
+  if (authoringError) return authoringError;
+  const seedContext = { correlation_id: `${storyboardCorrelationPrefix(storyboard)}--__seeding__` };
+  const selected = calls.map((call) => ({ call, route: resolveFixtureAgent("comply_test_controller", call) }));
+  const missing = selected.find(({ route }) => route.options.agentTools?.includes("comply_test_controller") === false);
+  if (missing) {
+    return buildMissingControllerResult(storyboard, calls, context);
+  }
+  const scenarios = /* @__PURE__ */ new Map();
+  for (const { call, route } of selected) {
+    if (!scenarios.has(route.client)) {
+      scenarios.set(
+        route.client,
+        controllerScenarioSetFromOptions(route.options) ?? await fetchControllerScenarioSet(route.client, route.options, seedContext)
+      );
+    }
+    if (scenarios.get(route.client)?.has(call.scenario) === false) {
+      return buildUnsupportedSeedResult(
+        storyboard,
+        calls,
+        context,
+        call.scenario,
+        `The selected route did not advertise ${call.scenario}.`
+      );
+    }
+  }
+  const steps = [];
+  let passedCount = 0;
+  let failedCount = 0;
+  for (const [index, { call, route }] of selected.entries()) {
+    const result = await executeLegacySeedCall(route.client, storyboard, call, route.options, context, seedContext);
+    if (result.step.skip_reason === "fixture_unsatisfied") {
+      const unsupported = buildUnsupportedSeedResult(
+        storyboard,
+        selected.slice(index).map((item) => item.call),
+        context,
+        call.scenario,
+        result.step.skip?.detail
+      );
+      return {
+        ...unsupported,
+        phase: {
+          ...unsupported.phase,
+          passed: failedCount === 0,
+          steps: [...steps, ...unsupported.phase.steps],
+          duration_ms: Date.now() - start
+        },
+        allPassed: failedCount === 0,
+        passedCount,
+        failedCount,
+        seedUnsupported: failedCount === 0
+      };
+    }
+    steps.push(result.step);
+    if (result.step.passed) passedCount++;
+    else failedCount++;
+  }
+  return {
+    phase: {
+      phase_id: CONTROLLER_SEEDING_PHASE_ID,
+      phase_title: "Controller seeding (pre-flight)",
+      passed: failedCount === 0,
+      steps,
+      duration_ms: Date.now() - start
+    },
+    allPassed: failedCount === 0,
+    passedCount,
+    failedCount
+  };
+}
 async function runDeclaredFixtureResolution(seedClient, discoveryClient, storyboard, options, context, calls, resolveFixtureAgent) {
   const start = Date.now();
   const authoringErrorResult = buildAuthoringErrorResult(storyboard, calls, context, start);
@@ -318,9 +393,9 @@ async function runDeclaredFixtureResolution(seedClient, discoveryClient, storybo
   let seedPrepared = false;
   let discoveryPrepared = false;
   const controller = { missing: false, scenarios: null };
-  const prepareSeedAgent = async () => {
-    if (seedPrepared) return;
-    const selected = resolveFixtureAgent?.("comply_test_controller");
+  const prepareSeedAgent = async (call) => {
+    if (seedPrepared && !resolveFixtureAgent) return;
+    const selected = resolveFixtureAgent?.("comply_test_controller", call);
     if (selected) {
       seedClient = selected.client;
       seedOptions = selected.options;
@@ -332,9 +407,9 @@ async function runDeclaredFixtureResolution(seedClient, discoveryClient, storybo
     }
     seedPrepared = true;
   };
-  const prepareDiscoveryAgent = () => {
-    if (discoveryPrepared) return;
-    const selected = resolveFixtureAgent?.("get_products");
+  const prepareDiscoveryAgent = (call) => {
+    if (discoveryPrepared && !resolveFixtureAgent) return;
+    const selected = resolveFixtureAgent?.("get_products", call);
     if (selected) {
       discoveryClient = selected.client;
       discoveryOptions = selected.options;
@@ -342,7 +417,7 @@ async function runDeclaredFixtureResolution(seedClient, discoveryClient, storybo
     discoveryPrepared = true;
   };
   const legacyCalls = calls.filter((call) => resolutionSpecForCall(call, specByKey) === void 0);
-  if (legacyCalls.length > 0) {
+  if (legacyCalls.length > 0 && !resolveFixtureAgent) {
     await prepareSeedAgent();
     if (controller.missing) return buildMissingControllerResult(storyboard, legacyCalls, context);
     if (controller.scenarios) {
@@ -363,14 +438,34 @@ async function runDeclaredFixtureResolution(seedClient, discoveryClient, storybo
     return !spec || spec.strategies.includes("seed");
   });
   if (!resolveFixtureAgent && needsSeedStrategy && !seedPrepared) await prepareSeedAgent();
-  let catalogPromise;
-  const catalog = () => catalogPromise ??= discoverProductCatalog(discoveryClient, discoveryOptions, context);
+  const catalogs = /* @__PURE__ */ new Map();
+  const catalog = () => {
+    let promise = catalogs.get(discoveryClient);
+    if (!promise) {
+      promise = discoverProductCatalog(discoveryClient, discoveryOptions, context);
+      catalogs.set(discoveryClient, promise);
+    }
+    return promise;
+  };
   let passedCount = 0;
   let failedCount = 0;
   let fixtureUnsatisfied = false;
   for (const call of orderedCalls) {
     const spec = resolutionSpecForCall(call, specByKey);
     if (!spec) {
+      if (resolveFixtureAgent) {
+        await prepareSeedAgent(call);
+        if (controller.missing) return buildMissingControllerResult(storyboard, legacyCalls, context);
+        if (controller.scenarios && !controller.scenarios.has(call.scenario)) {
+          return buildUnsupportedSeedResult(
+            storyboard,
+            legacyCalls,
+            context,
+            call.scenario,
+            `The selected route did not advertise ${call.scenario}.`
+          );
+        }
+      }
       const legacy = await executeLegacySeedCall(seedClient, storyboard, call, seedOptions, context, seedContext);
       if (legacy.step.skip_reason === "fixture_unsatisfied") {
         return buildUnsupportedSeedResult(storyboard, legacyCalls, context, call.scenario, legacy.step.skip?.detail);
@@ -395,7 +490,7 @@ async function runDeclaredFixtureResolution(seedClient, discoveryClient, storybo
     }
     for (const strategy of parentUnavailable ? [] : spec.strategies) {
       if (strategy === "seed") {
-        await prepareSeedAgent();
+        await prepareSeedAgent(call);
         const advertised = controller.scenarios?.has(call.scenario);
         if (controller.missing || advertised === false) {
           attempts.push({
@@ -459,7 +554,7 @@ async function runDeclaredFixtureResolution(seedClient, discoveryClient, storybo
         }
       }
       if (strategy === "discover") {
-        prepareDiscoveryAgent();
+        prepareDiscoveryAgent(call);
         if (discoveryOptions.agentTools && !discoveryOptions.agentTools.includes("get_products")) {
           attempts.push({
             strategy,

package/dist/lib/testing/storyboard/types.d.mts

@@ -30,7 +30,7 @@ export interface Storyboard {
     version: string;
     /**
      * AdCP compliance cache version this storyboard was loaded from, e.g.
-     * "3.1.18" or "3.2.0-rc.7". Injected by the local cache loader; not
+     * "3.1.24" or "3.2.0-rc.7". Injected by the local cache loader; not
      * authored in storyboard YAML.
      */
     adcp_version?: string;
@@ -239,6 +239,10 @@ export interface Storyboard {
          * + adcontextprotocol/adcp#2584 (seed_* scenarios). Opts-out per run via
          * `StoryboardRunOptions.skip_controller_seeding` (for agents that seed via
          * tests or HTTP admin rather than the MCP controller).
+         * In routed runs, each fixture uses the agent selected for its owning
+         * public tool (for example, products use `get_products`, plans use
+         * `sync_plans`). A step-level `agent` for that tool disambiguates its route;
+         * otherwise normal specialism routing and `default_agent` apply.
          */
         controller_seeding?: boolean;
     };

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

@@ -30,7 +30,7 @@ export interface Storyboard {
     version: string;
     /**
      * AdCP compliance cache version this storyboard was loaded from, e.g.
-     * "3.1.18" or "3.2.0-rc.7". Injected by the local cache loader; not
+     * "3.1.24" or "3.2.0-rc.7". Injected by the local cache loader; not
      * authored in storyboard YAML.
      */
     adcp_version?: string;
@@ -239,6 +239,10 @@ export interface Storyboard {
          * + adcontextprotocol/adcp#2584 (seed_* scenarios). Opts-out per run via
          * `StoryboardRunOptions.skip_controller_seeding` (for agents that seed via
          * tests or HTTP admin rather than the MCP controller).
+         * In routed runs, each fixture uses the agent selected for its owning
+         * public tool (for example, products use `get_products`, plans use
+         * `sync_plans`). A step-level `agent` for that tool disambiguates its route;
+         * otherwise normal specialism routing and `default_agent` apply.
          */
         controller_seeding?: boolean;
     };

package/dist/lib/testing/storyboard/validations.d.mts

@@ -197,7 +197,7 @@ export interface UpstreamTrafficQueryResult {
  */
 export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
 /** Capability semver emitted in run summaries and used for advisory expiry. */
-export declare const RUNNER_CAPABILITY_VERSION = "14.0.0-rc.49";
+export declare const RUNNER_CAPABILITY_VERSION = "14.0.0-rc.50";
 /** True when a failed validation contributes to the owning step's grade. */
 export declare function validationFailsStep(result: ValidationResult): boolean;
 /**

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

@@ -197,7 +197,7 @@ export interface UpstreamTrafficQueryResult {
  */
 export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
 /** Capability semver emitted in run summaries and used for advisory expiry. */
-export declare const RUNNER_CAPABILITY_VERSION = "14.0.0-rc.49";
+export declare const RUNNER_CAPABILITY_VERSION = "14.0.0-rc.50";
 /** True when a failed validation contributes to the owning step's grade. */
 export declare function validationFailsStep(result: ValidationResult): boolean;
 /**