@adcp/sdk 17.0.0-beta.0 → 17.0.0-beta.2

package/dist/lib/server/media-buy-store.mjs

@@ -1,6 +1,25 @@
 import { applyTargetingInput, resolveTargetingInput } from "../media-buy/targeting-input.mjs";
 import { scopedStore } from "./state-store.mjs";
 const DEFAULT_MEDIA_BUY_STORE_COLLECTION = "media_buys_targeting";
+const PACKAGE_IDENTITY_FIELDS = ["package_id", "product_id", "buyer_ref"];
+function compatibleIdentity(left, right) {
+  if (!left || !right) return false;
+  return PACKAGE_IDENTITY_FIELDS.every((key) => !left[key] || !right[key] || left[key] === right[key]);
+}
+function sharesIdentity(left, right) {
+  if (!left || !right) return false;
+  return compatibleIdentity(left, right) && PACKAGE_IDENTITY_FIELDS.some((key) => left[key] && left[key] === right[key]);
+}
+function matchContextPackage(requests, responses, index) {
+  const matches = requests.filter((request) => sharesIdentity(request, responses[index]));
+  if (matches.length === 1 && responses.filter((response) => sharesIdentity(matches[0], response)).length === 1) {
+    return matches[0];
+  }
+  if (requests.length === responses.length && requests.every((request, i) => compatibleIdentity(request, responses[i]))) {
+    return requests[index];
+  }
+  return void 0;
+}
 function createMediaBuyStore(options) {
   const collection = options.collection ?? DEFAULT_MEDIA_BUY_STORE_COLLECTION;
   function viewFor(accountId) {
@@ -18,8 +37,9 @@ function createMediaBuyStore(options) {
     async persistFromCreate(accountId, request, result) {
       const requestPackages = request.packages ?? [];
       const responsePackages = result.packages ?? [];
-      if (requestPackages.length === 0 || !result.media_buy_id) return;
-      const persistedPackages = [];
+      if (!result.media_buy_id) return;
+      const prior = await loadRecord(accountId, result.media_buy_id);
+      const byId = new Map((prior?.packages ?? []).map((pkg) => [pkg.package_id, { ...pkg }]));
       for (let i = 0; i < requestPackages.length; i++) {
         const reqPkg = requestPackages[i];
         if (!reqPkg?.targeting_overlay) continue;
@@ -30,12 +50,26 @@ function createMediaBuyStore(options) {
         if (!packageId) continue;
         const persistedOverlay = respPkg?.targeting_overlay ?? resolveTargetingInput(reqPkg.targeting_overlay);
         if (!persistedOverlay) continue;
-        persistedPackages.push({ package_id: packageId, targeting_overlay: persistedOverlay });
+        byId.set(packageId, { ...byId.get(packageId), package_id: packageId, targeting_overlay: persistedOverlay });
       }
-      if (persistedPackages.length === 0) return;
+      for (const [index, response] of responsePackages.entries()) {
+        if (!response.package_id) continue;
+        const context2 = matchContextPackage(requestPackages, responsePackages, index)?.context ?? response.context;
+        const stored = byId.get(response.package_id);
+        if (context2 !== void 0 && stored?.context === void 0) {
+          byId.set(response.package_id, {
+            ...stored,
+            package_id: response.package_id,
+            context: structuredClone(context2)
+          });
+        }
+      }
+      const context = prior?.context ?? request.context ?? result.context;
+      if (byId.size === 0 && context === void 0) return;
       await writeRecord(accountId, {
         media_buy_id: result.media_buy_id,
-        packages: persistedPackages
+        ...context !== void 0 ? { context: structuredClone(context) } : {},
+        packages: Array.from(byId.values())
       });
     },
     async mergeFromUpdate(accountId, mediaBuyId, patch) {
@@ -43,42 +77,56 @@ function createMediaBuyStore(options) {
         media_buy_id: mediaBuyId,
         packages: []
       };
-      const byId = new Map(prior.packages.map((p) => [p.package_id, p.targeting_overlay]));
+      const byId = new Map(prior.packages.map((p) => [p.package_id, { ...p }]));
       for (const pkg of patch.packages ?? []) {
         const packageId = pkg?.package_id;
         if (!packageId) continue;
         if (!("targeting_overlay" in pkg)) continue;
         const incoming = pkg.targeting_overlay;
         if (incoming === void 0) continue;
-        const merged = applyTargetingInput(byId.get(packageId), incoming);
-        if (merged) byId.set(packageId, merged);
-        else byId.delete(packageId);
+        const stored = byId.get(packageId);
+        const merged = applyTargetingInput(stored?.targeting_overlay, incoming);
+        if (merged) byId.set(packageId, { ...stored, package_id: packageId, targeting_overlay: merged });
+        else if (stored?.context !== void 0) {
+          byId.set(packageId, { package_id: packageId, context: stored.context });
+        } else byId.delete(packageId);
       }
       for (const pkg of patch.new_packages ?? []) {
         if (!pkg?.targeting_overlay || !pkg.package_id) continue;
         const resolved = resolveTargetingInput(pkg.targeting_overlay);
-        if (resolved) byId.set(pkg.package_id, resolved);
+        if (resolved)
+          byId.set(pkg.package_id, {
+            ...byId.get(pkg.package_id),
+            package_id: pkg.package_id,
+            targeting_overlay: resolved
+          });
       }
       await writeRecord(accountId, {
-        media_buy_id: mediaBuyId,
-        packages: Array.from(byId.entries()).map(([package_id, targeting_overlay]) => ({
-          package_id,
-          targeting_overlay
-        }))
+        ...prior,
+        packages: Array.from(byId.values())
       });
     },
     async backfill(accountId, result) {
       const buys = result.media_buys;
       if (!buys || buys.length === 0) return result;
       for (const buy of buys) {
-        if (!buy?.media_buy_id || !buy.packages) continue;
+        if (!buy?.media_buy_id) continue;
         const record = await loadRecord(accountId, buy.media_buy_id);
         if (!record) continue;
-        const overlayById = new Map(record.packages.map((p) => [p.package_id, p.targeting_overlay]));
-        for (const pkg of buy.packages) {
-          if (!pkg?.package_id || pkg.targeting_overlay !== void 0) continue;
-          const persisted = overlayById.get(pkg.package_id);
-          if (persisted) pkg.targeting_overlay = persisted;
+        if (buy.context === void 0 && record.context !== void 0) {
+          buy.context = structuredClone(record.context);
+        }
+        const byId = new Map(record.packages.map((p) => [p.package_id, p]));
+        for (const pkg of buy.packages ?? []) {
+          if (!pkg?.package_id) continue;
+          const persisted = byId.get(pkg.package_id);
+          if (!persisted) continue;
+          if (pkg.targeting_overlay === void 0 && persisted.targeting_overlay !== void 0) {
+            pkg.targeting_overlay = persisted.targeting_overlay;
+          }
+          if (pkg.context === void 0 && persisted.context !== void 0) {
+            pkg.context = structuredClone(persisted.context);
+          }
         }
       }
       return result;

package/dist/lib/server/notification-subscriptions/runtime.d.mts

@@ -1,7 +1,7 @@
 import type { WebhookAttemptSuppressionReason } from '../webhook-emitter.mjs';
 import type { NotificationSubscriptionConfigInput, NotificationSubscriptionView, NotificationSuppressionDisposition, PersistentNotificationRuntime, PersistentNotificationRuntimeOptions, StoredNotificationSubscription } from './types.mjs';
 export declare const CALLER_NOTIFICATION_TYPES: readonly ["capabilities.changed", "principal.changed"];
-export declare const ACCOUNT_NOTIFICATION_TYPES: readonly ["creative.status_changed", "creative.assignment_changed", "indicators.changed", "creative.purged", "account.status_changed", "account.change_recorded", "product.created", "product.updated", "product.priced", "product.removed", "signal.created", "signal.updated", "signal.priced", "signal.removed", "wholesale_feed.bulk_change", "reporting.delivery_ready", "reporting.status_changed", "reporting.ledger_changed"];
+export declare const ACCOUNT_NOTIFICATION_TYPES: readonly ["creative.status_changed", "creative.assignment_changed", "indicators.changed", "creative.purged", "account.status_changed", "account.change_recorded", "product.created", "product.updated", "product.priced", "product.removed", "signal.created", "signal.updated", "signal.priced", "signal.removed", "wholesale_feed.bulk_change", "collection_card.updated", "collection_card.removed", "collection_catalog.bulk_change", "proposal.created", "reporting.delivery_ready", "reporting.status_changed", "reporting.ledger_changed"];
 /**
  * Durable subscription control plane. The supplied emitter factory is called
  * exactly once with the runtime's mandatory live authorizer, preventing a

package/dist/lib/server/notification-subscriptions/runtime.d.ts

@@ -1,7 +1,7 @@
 import type { WebhookAttemptSuppressionReason } from '../webhook-emitter';
 import type { NotificationSubscriptionConfigInput, NotificationSubscriptionView, NotificationSuppressionDisposition, PersistentNotificationRuntime, PersistentNotificationRuntimeOptions, StoredNotificationSubscription } from './types';
 export declare const CALLER_NOTIFICATION_TYPES: readonly ["capabilities.changed", "principal.changed"];
-export declare const ACCOUNT_NOTIFICATION_TYPES: readonly ["creative.status_changed", "creative.assignment_changed", "indicators.changed", "creative.purged", "account.status_changed", "account.change_recorded", "product.created", "product.updated", "product.priced", "product.removed", "signal.created", "signal.updated", "signal.priced", "signal.removed", "wholesale_feed.bulk_change", "reporting.delivery_ready", "reporting.status_changed", "reporting.ledger_changed"];
+export declare const ACCOUNT_NOTIFICATION_TYPES: readonly ["creative.status_changed", "creative.assignment_changed", "indicators.changed", "creative.purged", "account.status_changed", "account.change_recorded", "product.created", "product.updated", "product.priced", "product.removed", "signal.created", "signal.updated", "signal.priced", "signal.removed", "wholesale_feed.bulk_change", "collection_card.updated", "collection_card.removed", "collection_catalog.bulk_change", "proposal.created", "reporting.delivery_ready", "reporting.status_changed", "reporting.ledger_changed"];
 /**
  * Durable subscription control plane. The supplied emitter factory is called
  * exactly once with the runtime's mandatory live authorizer, preventing a

package/dist/lib/server/notification-subscriptions/runtime.js

@@ -51,6 +51,10 @@ const ACCOUNT_NOTIFICATION_TYPES = Object.freeze([
   "signal.priced",
   "signal.removed",
   "wholesale_feed.bulk_change",
+  "collection_card.updated",
+  "collection_card.removed",
+  "collection_catalog.bulk_change",
+  "proposal.created",
   "reporting.delivery_ready",
   "reporting.status_changed",
   "reporting.ledger_changed"

package/dist/lib/server/notification-subscriptions/runtime.mjs

@@ -22,6 +22,10 @@ const ACCOUNT_NOTIFICATION_TYPES = Object.freeze([
   "signal.priced",
   "signal.removed",
   "wholesale_feed.bulk_change",
+  "collection_card.updated",
+  "collection_card.removed",
+  "collection_catalog.bulk_change",
+  "proposal.created",
   "reporting.delivery_ready",
   "reporting.status_changed",
   "reporting.ledger_changed"

package/dist/lib/server/responses.js

@@ -60,6 +60,7 @@ __export(responses_exports, {
 module.exports = __toCommonJS(responses_exports);
 var import_media_buy_helpers = require('./media-buy-helpers.js');
 var import_reporting_delivery_config = require('./reporting-delivery-config.js');
+var import_account_response_identity = require('./account-response-identity.js');
 const explicitResponseSummaries = /* @__PURE__ */ new WeakMap();
 function _getExplicitResponseSummary(response) {
   return explicitResponseSummaries.get(response);
@@ -124,7 +125,14 @@ function stripBusinessEntityBank(row, key) {
   return stripped;
 }
 function stripAccountWriteOnlyFields(account) {
-  const stripped = stripBusinessEntityBank(stripNotificationConfigSecrets(account), "billing_entity");
+  const {
+    destination_billing_entity: _destination,
+    authInfo: _authInfo,
+    ctx_metadata: _metadata,
+    ...responseFields
+  } = account;
+  const response = stripBusinessEntityBank(stripNotificationConfigSecrets(responseFields), "billing_entity");
+  const stripped = { ...response, ...(0, import_account_response_identity.projectAccountResponseIdentityFields)(response) };
   const reportingDeliveryConfigs = stripped.reporting_delivery_configs;
   if (reportingDeliveryConfigs === void 0) return stripped;
   return {

package/dist/lib/server/responses.mjs

@@ -1,5 +1,6 @@
 import { validActionsForStatus } from "./media-buy-helpers.mjs";
 import { projectReportingDeliveryConfigStates } from "./reporting-delivery-config.mjs";
+import { projectAccountResponseIdentityFields } from "./account-response-identity.mjs";
 const explicitResponseSummaries = /* @__PURE__ */ new WeakMap();
 function _getExplicitResponseSummary(response) {
   return explicitResponseSummaries.get(response);
@@ -64,7 +65,14 @@ function stripBusinessEntityBank(row, key) {
   return stripped;
 }
 function stripAccountWriteOnlyFields(account) {
-  const stripped = stripBusinessEntityBank(stripNotificationConfigSecrets(account), "billing_entity");
+  const {
+    destination_billing_entity: _destination,
+    authInfo: _authInfo,
+    ctx_metadata: _metadata,
+    ...responseFields
+  } = account;
+  const response = stripBusinessEntityBank(stripNotificationConfigSecrets(responseFields), "billing_entity");
+  const stripped = { ...response, ...projectAccountResponseIdentityFields(response) };
   const reportingDeliveryConfigs = stripped.reporting_delivery_configs;
   if (reportingDeliveryConfigs === void 0) return stripped;
   return {

package/dist/lib/signing/agent-fetch.d.mts

@@ -80,7 +80,7 @@ export interface BuildAgentSigningFetchOptions {
  *   1. Sign immediately when the payload carries webhook authentication.
  *   2. Resolve the AdCP operation and exact JSON-RPC protocol method.
  *   3. Consult each capability namespace independently; either can request
- *      signing. Legacy SDK task polls sign when the seller supports signing.
+ *      signing. SDK AdCP task polls sign when the seller supports signing.
  *   4. Resolve the seller's content-digest policy into a per-request toggle.
  *   5. Delegate to `createSigningFetch` with the decision baked in.
  */

package/dist/lib/signing/agent-fetch.d.ts

@@ -80,7 +80,7 @@ export interface BuildAgentSigningFetchOptions {
  *   1. Sign immediately when the payload carries webhook authentication.
  *   2. Resolve the AdCP operation and exact JSON-RPC protocol method.
  *   3. Consult each capability namespace independently; either can request
- *      signing. Legacy SDK task polls sign when the seller supports signing.
+ *      signing. SDK AdCP task polls sign when the seller supports signing.
  *   4. Resolve the seller's content-digest policy into a per-request toggle.
  *   5. Delegate to `createSigningFetch` with the decision baked in.
  */

package/dist/lib/signing/agent-fetch.js

@@ -157,13 +157,13 @@ function buildAgentSigningFetch(options) {
     }
     const operation = extractAdcpOperation(init?.body);
     if (operation === "get_adcp_capabilities" && (0, import_protocol_methods.hasUnsignedCapabilityBootstrap)(signing)) return false;
-    const isPollOperation = operation === "tasks_get" || operation === "tasks/get";
+    const isPollOperation = operation === "get_task_status" || operation === "tasks_get" || operation === "tasks/get";
     const methods = policyMethods ?? (isPollOperation ? jsonRpcMethodsForSigning(init?.body) : []);
     const profileCompatible = signing.profile === "web-bot-auth" ? (0, import_protocol_methods.signingListIncludes)(capability?.profiles, "web-bot-auth") : capability?.profiles === void 0 || (0, import_protocol_methods.signingListIncludes)(capability.profiles, "adcp/request-signing/v1");
-    const legacyPoll = profileCompatible && capability?.supported === true && (operation === "tasks_get" && methods.includes("tools/call") || operation === "tasks/get" && methods.some(
+    const signedPoll = profileCompatible && capability?.supported === true && ((operation === "tasks_get" || operation === "get_task_status") && methods.includes("tools/call") || (operation === "tasks/get" || operation === "get_task_status") && methods.some(
       (method) => ["message/send", "message/stream", "SendMessage", "SendStreamingMessage"].includes(method)
     ));
-    const sign = signing.profile === "web-bot-auth" && !!operation && (0, import_protocol_methods.signingListIncludes)(capability?.profiles, "web-bot-auth") || shouldSignOperation(operation, capability, signing) || methods.some((method) => shouldSignProtocolMethod(method, capability, signing)) || legacyPoll;
+    const sign = signing.profile === "web-bot-auth" && !!operation && (0, import_protocol_methods.signingListIncludes)(capability?.profiles, "web-bot-auth") || shouldSignOperation(operation, capability, signing) || methods.some((method) => shouldSignProtocolMethod(method, capability, signing)) || signedPoll;
     if (sign && signing.profile === "web-bot-auth" && !(0, import_protocol_methods.signingListIncludes)(capability?.profiles, "web-bot-auth"))
       throw new TypeError("Seller did not advertise the Web Bot Auth request signing profile");
     return sign;

package/dist/lib/signing/agent-fetch.mjs

@@ -139,13 +139,13 @@ function buildAgentSigningFetch(options) {
     }
     const operation = extractAdcpOperation(init?.body);
     if (operation === "get_adcp_capabilities" && hasUnsignedCapabilityBootstrap(signing)) return false;
-    const isPollOperation = operation === "tasks_get" || operation === "tasks/get";
+    const isPollOperation = operation === "get_task_status" || operation === "tasks_get" || operation === "tasks/get";
     const methods = policyMethods ?? (isPollOperation ? jsonRpcMethodsForSigning(init?.body) : []);
     const profileCompatible = signing.profile === "web-bot-auth" ? signingListIncludes(capability?.profiles, "web-bot-auth") : capability?.profiles === void 0 || signingListIncludes(capability.profiles, "adcp/request-signing/v1");
-    const legacyPoll = profileCompatible && capability?.supported === true && (operation === "tasks_get" && methods.includes("tools/call") || operation === "tasks/get" && methods.some(
+    const signedPoll = profileCompatible && capability?.supported === true && ((operation === "tasks_get" || operation === "get_task_status") && methods.includes("tools/call") || (operation === "tasks/get" || operation === "get_task_status") && methods.some(
       (method) => ["message/send", "message/stream", "SendMessage", "SendStreamingMessage"].includes(method)
     ));
-    const sign = signing.profile === "web-bot-auth" && !!operation && signingListIncludes(capability?.profiles, "web-bot-auth") || shouldSignOperation(operation, capability, signing) || methods.some((method) => shouldSignProtocolMethod(method, capability, signing)) || legacyPoll;
+    const sign = signing.profile === "web-bot-auth" && !!operation && signingListIncludes(capability?.profiles, "web-bot-auth") || shouldSignOperation(operation, capability, signing) || methods.some((method) => shouldSignProtocolMethod(method, capability, signing)) || signedPoll;
     if (sign && signing.profile === "web-bot-auth" && !signingListIncludes(capability?.profiles, "web-bot-auth"))
       throw new TypeError("Seller did not advertise the Web Bot Auth request signing profile");
     return sign;

package/dist/lib/testing/client.d.mts

@@ -89,6 +89,7 @@ schemaAdcpVersion?: string): Promise<{
     profile: AgentProfile;
     step: TestStepResult;
     caughtError?: unknown;
+    evidence?: TestStepResult;
 }>;
 /**
  * Discover what channels, pricing models, formats the agent supports

package/dist/lib/testing/client.d.ts

@@ -89,6 +89,7 @@ schemaAdcpVersion?: string): Promise<{
     profile: AgentProfile;
     step: TestStepResult;
     caughtError?: unknown;
+    evidence?: TestStepResult;
 }>;
 /**
  * Discover what channels, pricing models, formats the agent supports

package/dist/lib/testing/client.js

@@ -641,23 +641,24 @@ async function discoverAgentProfile(client, signal, schemaAdcpVersion) {
   }
   const failure = describeProfileDiscoveryFailure(profile);
   if (!step.passed || failure) {
-    const evidence = { ...step, ...failure ?? {}, passed: false, duration_ms: step.duration_ms };
-    evidence.error = (0, import_redact_credential_patterns.redactCredentialPatterns)(evidence.error ?? "Agent discovery failed", false).slice(
+    const evidence2 = { ...step, ...failure ?? {}, passed: false, duration_ms: step.duration_ms };
+    evidence2.error = (0, import_redact_credential_patterns.redactCredentialPatterns)(evidence2.error ?? "Agent discovery failed", false).slice(
       0,
       4096
     );
-    profile.capabilities_failure = evidence;
+    profile.capabilities_failure = evidence2;
   }
   if (!step.passed) step.error = (0, import_redact_credential_patterns.redactCredentialPatterns)(step.error ?? "Agent discovery failed", false);
   if (!failure && step.passed && (scopeKey === void 0 || scopeKey === client.getCapabilityEvidenceScope().scopeKey)) {
     seedTestClientSigningCapability(client, profile, schemaAdcpVersion);
   }
+  const evidence = step.passed && !failure ? { ...step } : void 0;
   if (step.passed && !failure) {
     delete step.request;
     delete step.response_record;
     delete step.adcp_error;
   }
-  return { profile, step, ...caughtError !== void 0 && { caughtError } };
+  return { profile, step, ...caughtError !== void 0 && { caughtError }, ...evidence && { evidence } };
 }
 async function discoverAgentCapabilities(client, profile, options) {
   const steps = [];
@@ -876,7 +877,7 @@ function validateResponseSchema(toolName, data, responseAdcpVersion) {
       warnings: [`No Zod schema registered for "${toolName}" \u2014 validation skipped`]
     };
   }
-  const compatData = data && typeof data === "object" && !Array.isArray(data) ? (0, import_envelope_status_compat.injectLegacyEnvelopeStatus)(data, { toolName }) : data;
+  const compatData = data && typeof data === "object" && !Array.isArray(data) ? (0, import_envelope_status_compat.injectLegacyEnvelopeStatus)(data, { toolName, adcpVersion: responseAdcpVersion }) : data;
   const result = schema.safeParse((0, import_response_schemas.prepareResponseForSchemaValidation)(toolName, compatData, responseAdcpVersion));
   if (result.success) {
     return {

package/dist/lib/testing/client.mjs

@@ -599,23 +599,24 @@ async function discoverAgentProfile(client, signal, schemaAdcpVersion) {
   }
   const failure = describeProfileDiscoveryFailure(profile);
   if (!step.passed || failure) {
-    const evidence = { ...step, ...failure ?? {}, passed: false, duration_ms: step.duration_ms };
-    evidence.error = redactCredentialPatterns(evidence.error ?? "Agent discovery failed", false).slice(
+    const evidence2 = { ...step, ...failure ?? {}, passed: false, duration_ms: step.duration_ms };
+    evidence2.error = redactCredentialPatterns(evidence2.error ?? "Agent discovery failed", false).slice(
       0,
       4096
     );
-    profile.capabilities_failure = evidence;
+    profile.capabilities_failure = evidence2;
   }
   if (!step.passed) step.error = redactCredentialPatterns(step.error ?? "Agent discovery failed", false);
   if (!failure && step.passed && (scopeKey === void 0 || scopeKey === client.getCapabilityEvidenceScope().scopeKey)) {
     seedTestClientSigningCapability(client, profile, schemaAdcpVersion);
   }
+  const evidence = step.passed && !failure ? { ...step } : void 0;
   if (step.passed && !failure) {
     delete step.request;
     delete step.response_record;
     delete step.adcp_error;
   }
-  return { profile, step, ...caughtError !== void 0 && { caughtError } };
+  return { profile, step, ...caughtError !== void 0 && { caughtError }, ...evidence && { evidence } };
 }
 async function discoverAgentCapabilities(client, profile, options) {
   const steps = [];
@@ -834,7 +835,7 @@ function validateResponseSchema(toolName, data, responseAdcpVersion) {
       warnings: [`No Zod schema registered for "${toolName}" \u2014 validation skipped`]
     };
   }
-  const compatData = data && typeof data === "object" && !Array.isArray(data) ? injectLegacyEnvelopeStatus(data, { toolName }) : data;
+  const compatData = data && typeof data === "object" && !Array.isArray(data) ? injectLegacyEnvelopeStatus(data, { toolName, adcpVersion: responseAdcpVersion }) : data;
   const result = schema.safeParse(prepareResponseForSchemaValidation(toolName, compatData, responseAdcpVersion));
   if (result.success) {
     return {

package/dist/lib/testing/storyboard/agent-routing.d.mts

@@ -1,5 +1,5 @@
 import type { TestClient } from '../client.mjs';
-import type { AgentProfile } from '../types.mjs';
+import type { AgentProfile, TestStepResult } from '../types.mjs';
 import { type AdcpProtocol } from '../../utils/capabilities.mjs';
 import type { AgentEntry, Storyboard, StoryboardRunOptions, StoryboardStep } from './types.mjs';
 /** Storyboard applicability is any-of; it does not authorize individual steps. */
@@ -18,6 +18,8 @@ export interface AgentRoutingContext {
     clients: Map<string, TestClient>;
     /** Per-agent discovered profile (`get_adcp_capabilities` result). */
     profiles: Map<string, AgentProfile>;
+    /** Actual discovery exchanges, retained separately from compact rollup steps. */
+    discoverySteps?: ReadonlyMap<string, TestStepResult>;
     /** Protocol → keys of agents that claim it. */
     protocolIndex: Map<AdcpProtocol, string[]>;
     /** Resolved (key → URL) for echo on the storyboard result. */
@@ -41,7 +43,8 @@ export declare class DiscoveryFailure extends Error {
     readonly agentKey: string;
     readonly url: string;
     readonly underlying: string;
-    constructor(message: string, agentKey: string, url: string, underlying: string);
+    readonly step?: TestStepResult | undefined;
+    constructor(message: string, agentKey: string, url: string, underlying: string, step?: TestStepResult | undefined);
 }
 /**
  * Discover every agent in the map in parallel and build the routing index.

package/dist/lib/testing/storyboard/agent-routing.d.ts

@@ -1,5 +1,5 @@
 import type { TestClient } from '../client';
-import type { AgentProfile } from '../types';
+import type { AgentProfile, TestStepResult } from '../types';
 import { type AdcpProtocol } from '../../utils/capabilities';
 import type { AgentEntry, Storyboard, StoryboardRunOptions, StoryboardStep } from './types';
 /** Storyboard applicability is any-of; it does not authorize individual steps. */
@@ -18,6 +18,8 @@ export interface AgentRoutingContext {
     clients: Map<string, TestClient>;
     /** Per-agent discovered profile (`get_adcp_capabilities` result). */
     profiles: Map<string, AgentProfile>;
+    /** Actual discovery exchanges, retained separately from compact rollup steps. */
+    discoverySteps?: ReadonlyMap<string, TestStepResult>;
     /** Protocol → keys of agents that claim it. */
     protocolIndex: Map<AdcpProtocol, string[]>;
     /** Resolved (key → URL) for echo on the storyboard result. */
@@ -41,7 +43,8 @@ export declare class DiscoveryFailure extends Error {
     readonly agentKey: string;
     readonly url: string;
     readonly underlying: string;
-    constructor(message: string, agentKey: string, url: string, underlying: string);
+    readonly step?: TestStepResult | undefined;
+    constructor(message: string, agentKey: string, url: string, underlying: string, step?: TestStepResult | undefined);
 }
 /**
  * Discover every agent in the map in parallel and build the routing index.

package/dist/lib/testing/storyboard/agent-routing.js

@@ -127,16 +127,18 @@ class RoutingError extends Error {
   hint;
 }
 class DiscoveryFailure extends Error {
-  constructor(message, agentKey, url, underlying) {
+  constructor(message, agentKey, url, underlying, step) {
     super(message);
     this.agentKey = agentKey;
     this.url = url;
     this.underlying = underlying;
+    this.step = step;
     this.name = "DiscoveryFailure";
   }
   agentKey;
   url;
   underlying;
+  step;
 }
 async function discoverAgentRouting(options) {
   const agents = options.agents;
@@ -150,6 +152,7 @@ async function discoverAgentRouting(options) {
     agentMap[key] = entry.url;
   }
   const profiles = /* @__PURE__ */ new Map();
+  const discoverySteps = /* @__PURE__ */ new Map();
   const discoveryFailures = [];
   if (options._routingProfiles) {
     for (const [key] of entries) {
@@ -162,6 +165,7 @@ async function discoverAgentRouting(options) {
     return {
       clients,
       profiles,
+      discoverySteps,
       protocolIndex: buildProtocolIndex(profiles),
       agentMap,
       discoveryFailures
@@ -171,8 +175,8 @@ async function discoverAgentRouting(options) {
     entries.map(async ([key, entry]) => {
       const perAgentOptions = buildAgentOptions(entry, options);
       try {
-        const { profile, step } = await (0, import_client.getOrDiscoverStoryboardProfile)(clients.get(key), perAgentOptions);
-        return { key, profile, step };
+        const { profile, step, evidence } = await (0, import_client.getOrDiscoverStoryboardProfile)(clients.get(key), perAgentOptions);
+        return { key, profile, step, evidence };
       } catch (err) {
         return {
           key,
@@ -180,6 +184,7 @@ async function discoverAgentRouting(options) {
           step: {
             step: "Discover agent capabilities",
             passed: false,
+            duration_ms: 0,
             error: scrubAuthSecrets(err?.message || String(err))
           }
         };
@@ -187,6 +192,7 @@ async function discoverAgentRouting(options) {
     })
   );
   for (const r of discoveryResults) {
+    discoverySteps.set(r.key, "evidence" in r && r.evidence ? r.evidence : r.step);
     if (!r.profile || r.step.passed === false) {
       const rawDetail = scrubAuthSecrets(r.step.error ?? "Discovery returned no profile.");
       const detail = rawDetail.length > 512 ? `${rawDetail.slice(0, 512)} \u2026(truncated)` : rawDetail;
@@ -194,7 +200,7 @@ async function discoverAgentRouting(options) {
       const message = resilient ? baseMessage : `${baseMessage}
 
 If this is hello-cluster / exploratory CI and you want unrelated storyboards to complete despite this failure, set \`StoryboardRunOptions.discovery_resilient: true\`. Do NOT set it in production \u2014 a topology with a broken tenant is a hard misconfiguration there.`;
-      const failure = new DiscoveryFailure(message, r.key, agents[r.key].url, detail);
+      const failure = new DiscoveryFailure(message, r.key, agents[r.key].url, detail, { ...r.step, error: detail });
       if (!resilient) throw failure;
       discoveryFailures.push(failure);
       continue;
@@ -204,6 +210,7 @@ If this is hello-cluster / exploratory CI and you want unrelated storyboards to
   return {
     clients,
     profiles,
+    discoverySteps,
     protocolIndex: buildProtocolIndex(profiles),
     agentMap,
     discoveryFailures

package/dist/lib/testing/storyboard/agent-routing.mjs

@@ -95,16 +95,18 @@ class RoutingError extends Error {
   hint;
 }
 class DiscoveryFailure extends Error {
-  constructor(message, agentKey, url, underlying) {
+  constructor(message, agentKey, url, underlying, step) {
     super(message);
     this.agentKey = agentKey;
     this.url = url;
     this.underlying = underlying;
+    this.step = step;
     this.name = "DiscoveryFailure";
   }
   agentKey;
   url;
   underlying;
+  step;
 }
 async function discoverAgentRouting(options) {
   const agents = options.agents;
@@ -118,6 +120,7 @@ async function discoverAgentRouting(options) {
     agentMap[key] = entry.url;
   }
   const profiles = /* @__PURE__ */ new Map();
+  const discoverySteps = /* @__PURE__ */ new Map();
   const discoveryFailures = [];
   if (options._routingProfiles) {
     for (const [key] of entries) {
@@ -130,6 +133,7 @@ async function discoverAgentRouting(options) {
     return {
       clients,
       profiles,
+      discoverySteps,
       protocolIndex: buildProtocolIndex(profiles),
       agentMap,
       discoveryFailures
@@ -139,8 +143,8 @@ async function discoverAgentRouting(options) {
     entries.map(async ([key, entry]) => {
       const perAgentOptions = buildAgentOptions(entry, options);
       try {
-        const { profile, step } = await getOrDiscoverStoryboardProfile(clients.get(key), perAgentOptions);
-        return { key, profile, step };
+        const { profile, step, evidence } = await getOrDiscoverStoryboardProfile(clients.get(key), perAgentOptions);
+        return { key, profile, step, evidence };
       } catch (err) {
         return {
           key,
@@ -148,6 +152,7 @@ async function discoverAgentRouting(options) {
           step: {
             step: "Discover agent capabilities",
             passed: false,
+            duration_ms: 0,
             error: scrubAuthSecrets(err?.message || String(err))
           }
         };
@@ -155,6 +160,7 @@ async function discoverAgentRouting(options) {
     })
   );
   for (const r of discoveryResults) {
+    discoverySteps.set(r.key, "evidence" in r && r.evidence ? r.evidence : r.step);
     if (!r.profile || r.step.passed === false) {
       const rawDetail = scrubAuthSecrets(r.step.error ?? "Discovery returned no profile.");
       const detail = rawDetail.length > 512 ? `${rawDetail.slice(0, 512)} \u2026(truncated)` : rawDetail;
@@ -162,7 +168,7 @@ async function discoverAgentRouting(options) {
       const message = resilient ? baseMessage : `${baseMessage}
 
 If this is hello-cluster / exploratory CI and you want unrelated storyboards to complete despite this failure, set \`StoryboardRunOptions.discovery_resilient: true\`. Do NOT set it in production \u2014 a topology with a broken tenant is a hard misconfiguration there.`;
-      const failure = new DiscoveryFailure(message, r.key, agents[r.key].url, detail);
+      const failure = new DiscoveryFailure(message, r.key, agents[r.key].url, detail, { ...r.step, error: detail });
       if (!resilient) throw failure;
       discoveryFailures.push(failure);
       continue;
@@ -172,6 +178,7 @@ If this is hello-cluster / exploratory CI and you want unrelated storyboards to
   return {
     clients,
     profiles,
+    discoverySteps,
     protocolIndex: buildProtocolIndex(profiles),
     agentMap,
     discoveryFailures