@adcp/sdk 5.25.0 → 6.0.0

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

@@ -0,0 +1,190 @@
+"use strict";
+/**
+ * Canonical buyer personas — typed, immutable test fixtures every
+ * adopter would otherwise rewrite. Each persona carries enough identity
+ * (brand domain, account_id, promoted_offering, brief) to drive the
+ * common AdCP request shapes without surface-area surprises.
+ *
+ * Use when you want a deterministic buyer to drive an integration test
+ * against your seller / signal / creative agent. Pair with the builder
+ * helpers below to construct wire-shaped requests in one line.
+ *
+ * The four shipped personas span the verticals and budget classes most
+ * sellers see: enterprise CTV, performance social, premium B2B, and
+ * geo-targeted local. Adopters who need richer coverage extend the
+ * pattern; this set intentionally stays small to keep the surface
+ * stable through preview.
+ *
+ * Status: Preview / 6.0.
+ *
+ * @example
+ * ```ts
+ * import { dtcSkincareBuyer, buildGetProductsRequest } from '@adcp/sdk/testing/personas';
+ *
+ * const result = await server.dispatchTestRequest({
+ *   method: 'tools/call',
+ *   params: {
+ *     name: 'get_products',
+ *     arguments: buildGetProductsRequest(dtcSkincareBuyer),
+ *   },
+ * });
+ * ```
+ *
+ * @public
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALL_PERSONAS = exports.restaurantLocalBuyer = exports.b2bSaasBuyer = exports.luxuryAutoBuyer = exports.dtcSkincareBuyer = void 0;
+exports.getPersonaById = getPersonaById;
+exports.buildAccountReference = buildAccountReference;
+exports.buildBrandReference = buildBrandReference;
+exports.buildGetProductsRequest = buildGetProductsRequest;
+/**
+ * DTC ecommerce on a tight performance budget. Social-first, Gen-Z
+ * audience, $50K test budget, performance pricing models preferred.
+ * Mirrors the `dtc_skincare_genZ` SampleBrief.
+ *
+ * @public
+ */
+exports.dtcSkincareBuyer = {
+    id: 'dtc_skincare_buyer',
+    name: 'Glow Lab — DTC Skincare',
+    vertical: 'Beauty & Personal Care',
+    brand: { domain: 'glowlab.example.com', name: 'Glow Lab' },
+    account_id: 'acc_glowlab',
+    promoted_offering: 'Glow Lab Vitamin C Serum + first-time-buyer 20% off',
+    brief: 'Direct-to-consumer skincare brand targeting Gen Z females (18-25). ' +
+        'Social-first campaign with UGC-style creative preferred. ' +
+        'Goal is driving trial purchases through a 20% off promo code. ' +
+        'Performance-oriented: need clear CPA/CPC pricing.',
+    budget: { amount: 50_000, currency: 'USD' },
+    channels: ['social', 'display'],
+};
+/**
+ * Luxury automotive launch. High-impact video + premium display, $500K
+ * Q3 flight, brand safety critical. Mirrors the `luxury_auto_ev`
+ * SampleBrief.
+ *
+ * @public
+ */
+exports.luxuryAutoBuyer = {
+    id: 'luxury_auto_buyer',
+    name: 'Velara Motors — EV Launch',
+    vertical: 'Automotive',
+    brand: { domain: 'velaramotors.example.com', name: 'Velara Motors' },
+    account_id: 'acc_velara',
+    promoted_offering: 'Velara V1 — luxury electric crossover SUV',
+    brief: 'Luxury automotive brand launching a new electric crossover SUV. ' +
+        'Targeting high-income households ($150K+ HHI), ages 30-55, in major US metros. ' +
+        'Need high-impact video and premium display placements. ' +
+        'Q3 flight (July-September). Key message: "The future of luxury driving." ' +
+        'Brand safety is critical — no UGC or controversial adjacency.',
+    budget: { amount: 500_000, currency: 'USD' },
+    channels: ['olv', 'ctv', 'display'],
+};
+/**
+ * Enterprise B2B SaaS awareness — premium publisher placements,
+ * viewability benchmarks, $200K over six weeks. Mirrors the
+ * `b2b_saas_awareness` SampleBrief.
+ *
+ * @public
+ */
+exports.b2bSaasBuyer = {
+    id: 'b2b_saas_buyer',
+    name: 'Threadline — Workflow Platform',
+    vertical: 'Technology / B2B',
+    brand: { domain: 'threadline.example.com', name: 'Threadline' },
+    account_id: 'acc_threadline',
+    promoted_offering: 'Threadline workflow platform — annual enterprise plan',
+    brief: 'Enterprise SaaS company building brand awareness among IT decision-makers and C-suite executives. ' +
+        'Looking for premium editorial environments — business, technology, and finance publishers. ' +
+        'Display and native content placements preferred. CTV is acceptable if targeting is precise. ' +
+        'Viewability benchmarks are important — need 70%+ viewability guarantee.',
+    budget: { amount: 200_000, currency: 'USD' },
+    channels: ['display', 'ctv'],
+};
+/**
+ * Regional QSR / restaurant chain — geo-targeted mobile + display
+ * within radius, foot-traffic attribution. Mirrors the
+ * `restaurant_local` SampleBrief.
+ *
+ * @public
+ */
+exports.restaurantLocalBuyer = {
+    id: 'restaurant_local_buyer',
+    name: 'Anchor & Oak — Regional Chain',
+    vertical: 'QSR / Restaurant',
+    brand: { domain: 'anchorandoak.example.com', name: 'Anchor & Oak' },
+    account_id: 'acc_anchoroak',
+    promoted_offering: 'Anchor & Oak summer menu — promoted across 15 metros',
+    brief: 'Regional restaurant chain promoting a new menu launch across 15 metro areas. ' +
+        'Need geo-targeted mobile and display ads within 5-mile radius of each location. ' +
+        'Audio/podcast ads are also interesting if available. ' +
+        'Performance tracking: need foot traffic attribution or store visit metrics.',
+    budget: { amount: 75_000, currency: 'USD' },
+    channels: ['display', 'audio'],
+};
+/**
+ * All shipped personas, in stable order. Adopters iterate this array
+ * to run a scenario across every canonical buyer in one loop.
+ *
+ * @public
+ */
+exports.ALL_PERSONAS = [
+    exports.dtcSkincareBuyer,
+    exports.luxuryAutoBuyer,
+    exports.b2bSaasBuyer,
+    exports.restaurantLocalBuyer,
+];
+/**
+ * Look up a persona by `id`. Returns `undefined` for unknown IDs —
+ * test code asserting on a specific persona should narrow with a
+ * non-null check.
+ *
+ * @public
+ */
+function getPersonaById(id) {
+    return exports.ALL_PERSONAS.find(p => p.id === id);
+}
+// ---------------------------------------------------------------------------
+// Wire-shape builders
+// ---------------------------------------------------------------------------
+/**
+ * Build an {@link AccountReference} pointing at the persona's account.
+ * Discriminated-union narrowing concern: the wire shape allows
+ * `account_id`, `brand`, or `brand + operator`. This builder always
+ * returns the `account_id` arm — adopters who need the brand-arm shape
+ * should compose `buildBrandReference(persona)` with their own operator.
+ *
+ * @public
+ */
+function buildAccountReference(persona) {
+    return { account_id: persona.account_id };
+}
+/**
+ * Build a {@link BrandReference} from the persona's brand identity.
+ * Domain is the canonical field; name is dropped (the wire spec doesn't
+ * carry it on `BrandReference` — sellers resolve via brand.json).
+ *
+ * @public
+ */
+function buildBrandReference(persona) {
+    return { domain: persona.brand.domain };
+}
+/**
+ * Build a wire-shaped {@link GetProductsRequest} keyed to this persona —
+ * `buying_mode: 'brief'`, the persona's `brief` text, brand reference,
+ * and account reference. Pass `overrides` to add `filters`,
+ * `preferred_delivery_types`, `time_budget`, etc.
+ *
+ * @public
+ */
+function buildGetProductsRequest(persona, overrides) {
+    return {
+        buying_mode: 'brief',
+        brief: persona.brief,
+        brand: buildBrandReference(persona),
+        account: buildAccountReference(persona),
+        ...overrides,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/testing/personas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/testing/personas/index.ts"],"names":[],"mappings":"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"}

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

@@ -16,7 +16,7 @@ export type { CapturedWebhook, CreateWebhookReceiverOptions, RetryReplayPolicy,
 export { createRunnerVariables } from './context';
 export type { RunnerVariables } from './context';
 export { WEBHOOK_ASSERTION_TASKS } from './webhook-assertions';
-export { runStoryboard, runStoryboardStep, getFirstStepPreview, summarizeStrictValidation, listStrictOnlyFailures, resolveCapabilityPath, } from './runner';
+export { runStoryboard, runStoryboardStep, getFirstStepPreview, summarizeStrictValidation, listStrictOnlyFailures, resolveCapabilityPath, buildDiscoveryFailedResult, } from './runner';
 export { parseStoryboard, loadStoryboardFile } from './loader';
 export { getComplianceCacheDir, loadComplianceIndex, listBundles, loadBundleStoryboards, listAllComplianceStoryboards, getComplianceStoryboardById, findBundleById, resolveBundleOrStoryboard, resolveStoryboardsForCapabilities, CapabilityResolutionError, PROTOCOL_TO_PATH, } from './compliance';
 export type { AgentCapabilities, BundleKind, BundleRef, CapabilityResolutionCode, ComplianceIndex, ComplianceIndexProtocol, ComplianceIndexSpecialism, NotApplicableStoryboard, ResolveOptions, ResolvedBundle, ResolvedStoryboards, } from './compliance';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/storyboard/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/storyboard/index.ts"],"names":[],"mappings":"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"}

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

@@ -8,8 +8,8 @@
  * and is pulled into `compliance/cache/{version}/` via `npm run sync-schemas`.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AdagentsJsonSchema = exports.BrandJsonSchema = exports.PROBE_TASK_ALLOWLIST = exports.TestKitValidationError = exports.validateTestKit = exports.runValidations = exports.hasRequestBuilder = exports.buildRequest = exports.detectContextRejectionHints = exports.applyContextInputs = exports.applyContextOutputsWithProvenance = exports.applyContextOutputs = exports.injectContext = exports.extractContextWithProvenance = exports.extractContext = exports.CONTEXT_EXTRACTORS = exports.setPath = exports.resolvePath = exports.parsePath = exports.executeStoryboardTask = exports.TASK_TO_METHOD = exports.PROTOCOL_TO_PATH = exports.CapabilityResolutionError = exports.resolveStoryboardsForCapabilities = exports.resolveBundleOrStoryboard = exports.findBundleById = exports.getComplianceStoryboardById = exports.listAllComplianceStoryboards = exports.loadBundleStoryboards = exports.listBundles = exports.loadComplianceIndex = exports.getComplianceCacheDir = exports.loadStoryboardFile = exports.parseStoryboard = exports.resolveCapabilityPath = exports.listStrictOnlyFailures = exports.summarizeStrictValidation = exports.getFirstStepPreview = exports.runStoryboardStep = exports.runStoryboard = exports.WEBHOOK_ASSERTION_TASKS = exports.createRunnerVariables = exports.createWebhookReceiver = exports.resolveAssertions = exports.clearAssertionRegistry = exports.listDefaultAssertions = exports.listAssertions = exports.getAssertion = exports.registerAssertion = exports.WEBHOOK_IDEMPOTENCY_KEY_PATTERN = void 0;
-exports.clearSandboxCache = exports.isSandboxDomain = exports.getSandboxBrand = exports.getSandboxBrands = exports.getSandboxEntities = void 0;
+exports.BrandJsonSchema = exports.PROBE_TASK_ALLOWLIST = exports.TestKitValidationError = exports.validateTestKit = exports.runValidations = exports.hasRequestBuilder = exports.buildRequest = exports.detectContextRejectionHints = exports.applyContextInputs = exports.applyContextOutputsWithProvenance = exports.applyContextOutputs = exports.injectContext = exports.extractContextWithProvenance = exports.extractContext = exports.CONTEXT_EXTRACTORS = exports.setPath = exports.resolvePath = exports.parsePath = exports.executeStoryboardTask = exports.TASK_TO_METHOD = exports.PROTOCOL_TO_PATH = exports.CapabilityResolutionError = exports.resolveStoryboardsForCapabilities = exports.resolveBundleOrStoryboard = exports.findBundleById = exports.getComplianceStoryboardById = exports.listAllComplianceStoryboards = exports.loadBundleStoryboards = exports.listBundles = exports.loadComplianceIndex = exports.getComplianceCacheDir = exports.loadStoryboardFile = exports.parseStoryboard = exports.buildDiscoveryFailedResult = exports.resolveCapabilityPath = exports.listStrictOnlyFailures = exports.summarizeStrictValidation = exports.getFirstStepPreview = exports.runStoryboardStep = exports.runStoryboard = exports.WEBHOOK_ASSERTION_TASKS = exports.createRunnerVariables = exports.createWebhookReceiver = exports.resolveAssertions = exports.clearAssertionRegistry = exports.listDefaultAssertions = exports.listAssertions = exports.getAssertion = exports.registerAssertion = exports.WEBHOOK_IDEMPOTENCY_KEY_PATTERN = void 0;
+exports.clearSandboxCache = exports.isSandboxDomain = exports.getSandboxBrand = exports.getSandboxBrands = exports.getSandboxEntities = exports.AdagentsJsonSchema = void 0;
 // Side-effect import: registers the default cross-step assertions that
 // upstream storyboards reference by id (idempotency.conflict_no_payload_leak,
 // context.no_secret_echo, governance.denial_blocks_mutation). Without this
@@ -44,6 +44,7 @@ Object.defineProperty(exports, "getFirstStepPreview", { enumerable: true, get: f
 Object.defineProperty(exports, "summarizeStrictValidation", { enumerable: true, get: function () { return runner_1.summarizeStrictValidation; } });
 Object.defineProperty(exports, "listStrictOnlyFailures", { enumerable: true, get: function () { return runner_1.listStrictOnlyFailures; } });
 Object.defineProperty(exports, "resolveCapabilityPath", { enumerable: true, get: function () { return runner_1.resolveCapabilityPath; } });
+Object.defineProperty(exports, "buildDiscoveryFailedResult", { enumerable: true, get: function () { return runner_1.buildDiscoveryFailedResult; } });
 // Parser (single-file load for spec evolution / targeted testing)
 var loader_1 = require("./loader");
 Object.defineProperty(exports, "parseStoryboard", { enumerable: true, get: function () { return loader_1.parseStoryboard; } });

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/testing/storyboard/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;AAEH,uEAAuE;AACvE,8EAA8E;AAC9E,2EAA2E;AAC3E,uEAAuE;AACvE,4EAA4E;AAC5E,qEAAqE;AACrE,gCAA8B;AAqC9B,iCAA0D;AAAjD,wHAAA,+BAA+B,OAAA;AAExC,8DAA8D;AAC9D,2CAOsB;AANpB,+GAAA,iBAAiB,OAAA;AACjB,0GAAA,YAAY,OAAA;AACZ,4GAAA,cAAc,OAAA;AACd,mHAAA,qBAAqB,OAAA;AACrB,oHAAA,sBAAsB,OAAA;AACtB,+GAAA,iBAAiB,OAAA;AAInB,0FAA0F;AAC1F,uDAA2D;AAAlD,yHAAA,qBAAqB,OAAA;AAU9B,kFAAkF;AAClF,qCAAkD;AAAzC,gHAAA,qBAAqB,OAAA;AAG9B,iCAAiC;AACjC,2DAA+D;AAAtD,6HAAA,uBAAuB,OAAA;AAEhC,SAAS;AACT,mCAOkB;AANhB,uGAAA,aAAa,OAAA;AACb,2GAAA,iBAAiB,OAAA;AACjB,6GAAA,mBAAmB,OAAA;AACnB,mHAAA,yBAAyB,OAAA;AACzB,gHAAA,sBAAsB,OAAA;AACtB,+GAAA,qBAAqB,OAAA;AAGvB,kEAAkE;AAClE,mCAA+D;AAAtD,yGAAA,eAAe,OAAA;AAAE,4GAAA,kBAAkB,OAAA;AAE5C,iDAAiD;AACjD,2CAYsB;AAXpB,mHAAA,qBAAqB,OAAA;AACrB,iHAAA,mBAAmB,OAAA;AACnB,yGAAA,WAAW,OAAA;AACX,mHAAA,qBAAqB,OAAA;AACrB,0HAAA,4BAA4B,OAAA;AAC5B,yHAAA,2BAA2B,OAAA;AAC3B,4GAAA,cAAc,OAAA;AACd,uHAAA,yBAAyB,OAAA;AACzB,+HAAA,iCAAiC,OAAA;AACjC,uHAAA,yBAAyB,OAAA;AACzB,8GAAA,gBAAgB,OAAA;AAgBlB,eAAe;AACf,uCAAmE;AAA1D,0GAAA,cAAc,OAAA;AAAE,iHAAA,qBAAqB,OAAA;AAE9C,iBAAiB;AACjB,+BAAyD;AAAhD,iGAAA,SAAS,OAAA;AAAE,mGAAA,WAAW,OAAA;AAAE,+FAAA,OAAO,OAAA;AAExC,UAAU;AACV,qCAQmB;AAPjB,6GAAA,kBAAkB,OAAA;AAClB,yGAAA,cAAc,OAAA;AACd,uHAAA,4BAA4B,OAAA;AAC5B,wGAAA,aAAa,OAAA;AACb,8GAAA,mBAAmB,OAAA;AACnB,4HAAA,iCAAiC,OAAA;AACjC,6GAAA,kBAAkB,OAAA;AAIpB,wCAAwC;AACxC,qDAAgE;AAAvD,8HAAA,2BAA2B,OAAA;AAEpC,kBAAkB;AAClB,qDAAoE;AAA3D,+GAAA,YAAY,OAAA;AAAE,oHAAA,iBAAiB,OAAA;AAExC,cAAc;AACd,6CAA+C;AAAtC,6GAAA,cAAc,OAAA;AAEvB,iEAAiE;AACjE,wEAAwE;AACxE,qEAAqE;AACrE,qEAAqE;AAErE,6BAA6B;AAC7B,uCAA2F;AAAlF,2GAAA,eAAe,OAAA;AAAE,kHAAA,sBAAsB,OAAA;AAAE,gHAAA,oBAAoB,OAAA;AAItE,uFAA8F;AAArF,8HAAA,eAAe,OAAA;AAAE,iIAAA,kBAAkB,OAAA;AAE5C,uDAM4B;AAL1B,sHAAA,kBAAkB,OAAA;AAClB,oHAAA,gBAAgB,OAAA;AAChB,mHAAA,eAAe,OAAA;AACf,mHAAA,eAAe,OAAA;AACf,qHAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/testing/storyboard/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;AAEH,uEAAuE;AACvE,8EAA8E;AAC9E,2EAA2E;AAC3E,uEAAuE;AACvE,4EAA4E;AAC5E,qEAAqE;AACrE,gCAA8B;AAqC9B,iCAA0D;AAAjD,wHAAA,+BAA+B,OAAA;AAExC,8DAA8D;AAC9D,2CAOsB;AANpB,+GAAA,iBAAiB,OAAA;AACjB,0GAAA,YAAY,OAAA;AACZ,4GAAA,cAAc,OAAA;AACd,mHAAA,qBAAqB,OAAA;AACrB,oHAAA,sBAAsB,OAAA;AACtB,+GAAA,iBAAiB,OAAA;AAInB,0FAA0F;AAC1F,uDAA2D;AAAlD,yHAAA,qBAAqB,OAAA;AAU9B,kFAAkF;AAClF,qCAAkD;AAAzC,gHAAA,qBAAqB,OAAA;AAG9B,iCAAiC;AACjC,2DAA+D;AAAtD,6HAAA,uBAAuB,OAAA;AAEhC,SAAS;AACT,mCAQkB;AAPhB,uGAAA,aAAa,OAAA;AACb,2GAAA,iBAAiB,OAAA;AACjB,6GAAA,mBAAmB,OAAA;AACnB,mHAAA,yBAAyB,OAAA;AACzB,gHAAA,sBAAsB,OAAA;AACtB,+GAAA,qBAAqB,OAAA;AACrB,oHAAA,0BAA0B,OAAA;AAG5B,kEAAkE;AAClE,mCAA+D;AAAtD,yGAAA,eAAe,OAAA;AAAE,4GAAA,kBAAkB,OAAA;AAE5C,iDAAiD;AACjD,2CAYsB;AAXpB,mHAAA,qBAAqB,OAAA;AACrB,iHAAA,mBAAmB,OAAA;AACnB,yGAAA,WAAW,OAAA;AACX,mHAAA,qBAAqB,OAAA;AACrB,0HAAA,4BAA4B,OAAA;AAC5B,yHAAA,2BAA2B,OAAA;AAC3B,4GAAA,cAAc,OAAA;AACd,uHAAA,yBAAyB,OAAA;AACzB,+HAAA,iCAAiC,OAAA;AACjC,uHAAA,yBAAyB,OAAA;AACzB,8GAAA,gBAAgB,OAAA;AAgBlB,eAAe;AACf,uCAAmE;AAA1D,0GAAA,cAAc,OAAA;AAAE,iHAAA,qBAAqB,OAAA;AAE9C,iBAAiB;AACjB,+BAAyD;AAAhD,iGAAA,SAAS,OAAA;AAAE,mGAAA,WAAW,OAAA;AAAE,+FAAA,OAAO,OAAA;AAExC,UAAU;AACV,qCAQmB;AAPjB,6GAAA,kBAAkB,OAAA;AAClB,yGAAA,cAAc,OAAA;AACd,uHAAA,4BAA4B,OAAA;AAC5B,wGAAA,aAAa,OAAA;AACb,8GAAA,mBAAmB,OAAA;AACnB,4HAAA,iCAAiC,OAAA;AACjC,6GAAA,kBAAkB,OAAA;AAIpB,wCAAwC;AACxC,qDAAgE;AAAvD,8HAAA,2BAA2B,OAAA;AAEpC,kBAAkB;AAClB,qDAAoE;AAA3D,+GAAA,YAAY,OAAA;AAAE,oHAAA,iBAAiB,OAAA;AAExC,cAAc;AACd,6CAA+C;AAAtC,6GAAA,cAAc,OAAA;AAEvB,iEAAiE;AACjE,wEAAwE;AACxE,qEAAqE;AACrE,qEAAqE;AAErE,6BAA6B;AAC7B,uCAA2F;AAAlF,2GAAA,eAAe,OAAA;AAAE,kHAAA,sBAAsB,OAAA;AAAE,gHAAA,oBAAoB,OAAA;AAItE,uFAA8F;AAArF,8HAAA,eAAe,OAAA;AAAE,iIAAA,kBAAkB,OAAA;AAE5C,uDAM4B;AAL1B,sHAAA,kBAAkB,OAAA;AAClB,oHAAA,gBAAgB,OAAA;AAChB,mHAAA,eAAe,OAAA;AACf,mHAAA,eAAe,OAAA;AACf,qHAAA,iBAAiB,OAAA"}

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

@@ -6,6 +6,7 @@
  * - runStoryboardStep(): run a single step (stateless, LLM-friendly)
  */
 import type { Storyboard, StoryboardStep, StoryboardContext, StoryboardRunOptions, StoryboardResult, StoryboardPhaseResult, StoryboardStepResult, StoryboardStepPreview, StrictValidationSummary, SchemaValidationError } from './types';
+import type { TestStepResult } from '../types';
 /**
  * Walk a dotted key path (e.g. `"adcp.idempotency.supported"`) through a
  * nested object. Returns `undefined` when any segment is missing or the
@@ -34,6 +35,18 @@ export declare function __defaultAuthHeadersForRawProbeForTest(options: Storyboa
  * empty on instance B.
  */
 export declare function runStoryboard(agentUrlOrUrls: string | string[], storyboard: Storyboard, options?: StoryboardRunOptions): Promise<StoryboardResult>;
+/**
+ * Build a hard-failure StoryboardResult for when agent capability
+ * discovery (`get_agent_info` / MCP `tools/list`) failed. Surfacing
+ * discovery errors as a hard storyboard failure prevents the silent
+ * "X/X clean, 100% skipped" failure mode where transport / auth
+ * misconfiguration produced an empty `agentTools: []` and every step
+ * skipped with `missing_tool`.
+ *
+ * @public — exported for direct testing of the failure-result shape;
+ * called from `runStoryboard` when discovery throws.
+ */
+export declare function buildDiscoveryFailedResult(agentUrls: string[], storyboard: Storyboard, discoveryStep: TestStepResult): StoryboardResult;
 /**
  * Walk every response_schema validation and aggregate the strict/lenient
  * delta. Always returns a summary; `observable: false` signals "run had

package/dist/lib/testing/storyboard/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/storyboard/runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmDH,OAAO,KAAK,EAYV,UAAU,EACV,cAAc,EAEd,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAEhB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EAEtB,MAAM,SAAS,CAAC;AA0CjB;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAQ/E;AA4ID,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE9D;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAC1C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAEpC;AAED,wBAAgB,sCAAsC,CACpD,OAAO,EAAE,oBAAoB,GAC5B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAEpC;AAiDD;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,EACjC,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,gBAAgB,CAAC,CAuC3B;AAgzBD;;;;;;;;;;;;;;;;GAgBG;AACH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,qBAAqB,EAAE,GAC9B,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,qBAAqB,EAAE,CAAA;CAAE,CAAC,CA0B9G;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,uBAAuB,CA4BlG;AAMD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,oBAAoB,CAAC,CAiE/B;AAs7BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,oBAAoB,EAC7B,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwCzB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,cAAc,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB;AA8OD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,iBAAsB,GAC9B,qBAAqB,GAAG,SAAS,CAgBnC"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/storyboard/runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmDH,OAAO,KAAK,EAYV,UAAU,EACV,cAAc,EAEd,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAEhB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EAEtB,MAAM,SAAS,CAAC;AAEjB,OAAO,KAAK,EAA4B,cAAc,EAAE,MAAM,UAAU,CAAC;AAwCzE;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAQ/E;AAwJD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE9D;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAC1C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAEpC;AAED,wBAAgB,sCAAsC,CACpD,OAAO,EAAE,oBAAoB,GAC5B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAEpC;AAiDD;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,EACjC,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,gBAAgB,CAAC,CAuC3B;AA4DD;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,EAAE,EACnB,UAAU,EAAE,UAAU,EACtB,aAAa,EAAE,cAAc,GAC5B,gBAAgB,CA6ClB;AAizBD;;;;;;;;;;;;;;;;GAgBG;AACH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,qBAAqB,EAAE,GAC9B,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,qBAAqB,EAAE,CAAA;CAAE,CAAC,CA0B9G;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,uBAAuB,CA4BlG;AAMD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,oBAAoB,CAAC,CAsE/B;AA89BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,oBAAoB,EAC7B,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwCzB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,cAAc,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB;AA8OD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,iBAAsB,GAC9B,qBAAqB,GAAG,SAAS,CAgBnC"}

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

@@ -12,6 +12,7 @@ exports.__redactSecretsForTest = __redactSecretsForTest;
 exports.__filterResponseHeadersForTest = __filterResponseHeadersForTest;
 exports.__defaultAuthHeadersForRawProbeForTest = __defaultAuthHeadersForRawProbeForTest;
 exports.runStoryboard = runStoryboard;
+exports.buildDiscoveryFailedResult = buildDiscoveryFailedResult;
 exports.listStrictOnlyFailures = listStrictOnlyFailures;
 exports.summarizeStrictValidation = summarizeStrictValidation;
 exports.runStoryboardStep = runStoryboardStep;
@@ -88,6 +89,17 @@ function resolveCapabilityPath(raw, dottedPath) {
 function buildSkip(reason, detail) {
     return { reason, detail: detail ?? SKIP_DETAILS[reason] };
 }
+/**
+ * True for skip reasons that imply the step's state never materialized —
+ * the runner treats these as equivalent to a failed stateful step for
+ * cascade-skip purposes. Benign skips (peer branch took, OAuth wasn't
+ * advertised, controller seeding cascaded — all handled elsewhere) don't
+ * appear here. Accepts both the canonical `RunnerSkipReason` and the
+ * detailed variant so callers don't need to narrow before checking.
+ */
+function isMissingStateSkipReason(reason) {
+    return reason === 'missing_tool' || reason === 'missing_test_controller' || reason === 'not_applicable';
+}
 /**
  * Resolve each phase's branch-set membership, combining explicit
  * `branch_set: { id, semantics }` declarations with the implicit detection
@@ -383,6 +395,63 @@ function buildCapabilityUnsupportedResult(agentUrls, storyboard, detail) {
         },
     };
 }
+/**
+ * Build a hard-failure StoryboardResult for when agent capability
+ * discovery (`get_agent_info` / MCP `tools/list`) failed. Surfacing
+ * discovery errors as a hard storyboard failure prevents the silent
+ * "X/X clean, 100% skipped" failure mode where transport / auth
+ * misconfiguration produced an empty `agentTools: []` and every step
+ * skipped with `missing_tool`.
+ *
+ * @public — exported for direct testing of the failure-result shape;
+ * called from `runStoryboard` when discovery throws.
+ */
+function buildDiscoveryFailedResult(agentUrls, storyboard, discoveryStep) {
+    const detail = discoveryStep.error ?? 'Discovery failed (no agent tools advertised).';
+    const syntheticStep = {
+        storyboard_id: storyboard.id,
+        step_id: 'discovery_failed',
+        phase_id: 'discovery_failed',
+        title: 'Storyboard failed: agent capability discovery did not succeed',
+        task: '',
+        passed: false,
+        skipped: false,
+        duration_ms: discoveryStep.duration_ms,
+        validations: [],
+        context: {},
+        error: `Discovery failure: ${detail}. The runner refuses to proceed with empty agentTools — that mode produces silent "all clean" reports when the underlying transport / auth / network policy is broken. Fix the discovery error before re-running.`,
+        extraction: { path: 'none' },
+    };
+    return {
+        storyboard_id: storyboard.id,
+        storyboard_title: storyboard.title,
+        agent_url: agentUrls[0],
+        overall_passed: false,
+        phases: [
+            {
+                phase_id: 'discovery_failed',
+                phase_title: 'Discovery failed',
+                passed: false,
+                steps: [syntheticStep],
+                duration_ms: discoveryStep.duration_ms,
+            },
+        ],
+        context: {},
+        total_duration_ms: discoveryStep.duration_ms,
+        passed_count: 0,
+        failed_count: 1,
+        skipped_count: 0,
+        tested_at: new Date().toISOString(),
+        strict_validation_summary: {
+            observable: false,
+            checked: 0,
+            passed: 0,
+            failed: 0,
+            strict_only_failures: 0,
+            lenient_also_failed: 0,
+        },
+    };
+}
 /**
  * Build a minimal StoryboardResult for a storyboard skipped because the agent
  * does not advertise any of the tools listed in `required_tools`. The result
@@ -460,10 +529,26 @@ async function executeStoryboardPass(agentUrls, storyboard, options, dispatchOff
     let profile;
     if (!options._client) {
         const discovered = await (0, client_1.getOrDiscoverProfile)(clients[0], options);
+        // Discovery failure must surface as a HARD STORYBOARD FAILURE, not a
+        // silent empty `agentTools: []` that lets every step skip with
+        // `missing_tool`. The latter mode produces "X/X clean" summaries with
+        // 100% skipped — invisible CI failure when transport setup is broken
+        // (auth misconfig, MCP transport-fallback bugs, network policy, etc.).
+        // See: https://github.com/adcontextprotocol/adcp-client/issues/...
+        if (discovered.step.passed === false) {
+            if (!options._client)
+                await (0, protocols_1.closeConnections)(options.protocol);
+            return buildDiscoveryFailedResult(agentUrls, storyboard, discovered.step);
+        }
         profile = discovered.profile;
-        // Populate agentTools from discovered profile if not already set
+        // Populate agentTools and _profile from discovered profile if not already set.
+        // _profile is threaded into executeStep so capability-based skip gates
+        // (e.g. account-mode branching) can read raw_capabilities at step time.
         if (!options.agentTools && profile?.tools) {
-            options = { ...options, agentTools: profile.tools };
+            options = { ...options, agentTools: profile.tools, _profile: profile };
+        }
+        else if (profile && !options._profile) {
+            options = { ...options, _profile: profile };
         }
     }
     else {
@@ -533,6 +618,14 @@ async function executeStoryboardPass(agentUrls, storyboard, options, dispatchOff
     let passedCount = 0;
     let failedCount = 0;
     let skippedCount = 0;
+    // Stateful-cascade flags live at storyboard scope, NOT phase scope —
+    // cross-phase storyboards (e.g. signal_marketplace/governance_denied:
+    // setup in phases 1-2, consumption in phase 3) need the cascade to
+    // survive phase boundaries. Once a stateful step in any phase failed
+    // or skipped to materialize state, every downstream stateful step
+    // stays cascade-skipped regardless of which phase it lives in.
+    let statefulFailed = false;
+    let statefulSkipTrigger = null;
     // Step results whose failures the main loop added to failedCount. The
     // branch-set post-pass decrements only for entries that were actually
     // counted, so an optional phase that hit `presenceDetected` (a PRM 2xx
@@ -681,7 +774,10 @@ async function executeStoryboardPass(agentUrls, storyboard, options, dispatchOff
         const phaseStart = Date.now();
         const stepResults = [];
         let phasePassed = true;
-        let statefulFailed = false;
+        // `statefulFailed` and `statefulSkipTrigger` live at storyboard
+        // scope (declared above the phase loop) so the cascade survives
+        // cross-phase setup → assertion patterns. See declaration site for
+        // the rationale (signal_marketplace/governance_denied story).
         // PRM presence-probe state (adcp-client#677). `phaseAbsent` flips when
         // /.well-known/oauth-protected-resource returns 404 — subsequent steps
         // in this phase cascade-skip instead of failing their http_status:200
@@ -767,9 +863,15 @@ async function executeStoryboardPass(agentUrls, storyboard, options, dispatchOff
                 skippedCount++;
                 continue;
             }
-            // Skip remaining steps if a stateful dependency failed
+            // Skip remaining steps if a stateful dependency failed (or
+            // skipped for a missing-state reason). The detail message
+            // distinguishes the two so adopters reading the cascade know
+            // whether to look at a real failure or a structural mismatch
+            // (storyboard step requires a tool the agent doesn't advertise).
             if (statefulFailed && step.stateful) {
-                const detail = 'Skipped: prior stateful step failed.';
+                const detail = statefulSkipTrigger
+                    ? `Skipped: prior stateful step "${statefulSkipTrigger.stepId}" skipped (${statefulSkipTrigger.reason}); state never materialized.`
+                    : 'Skipped: prior stateful step failed.';
                 stepResults.push({
                     storyboard_id: storyboard.id,
                     step_id: step.id,
@@ -874,6 +976,26 @@ async function executeStoryboardPass(agentUrls, storyboard, options, dispatchOff
             if (result.skipped) {
                 skippedCount++;
                 context = result.context;
+                // Cascade-skip extension: a stateful step that SKIPS for a
+                // missing-state reason (`missing_tool`, `missing_test_controller`,
+                // `not_applicable`) is morally equivalent to a stateful step that
+                // failed — the state downstream steps depend on never
+                // materialized. Without this trip, a follow-up stateful step
+                // runs against absent state and surfaces a misleading
+                // assertion failure. Skips that imply state DID materialize via
+                // another path (`peer_branch_taken`, `controller_seeding_failed`
+                // — already handled by phase-level cascade, `oauth_not_advertised`
+                // — phase-absent path) deliberately don't trip the flag.
+                if (step.stateful && isMissingStateSkipReason(result.skip_reason)) {
+                    statefulFailed = true;
+                    // Record provenance for the cascade detail message. First trip
+                    // wins — subsequent triggers don't overwrite, since the cascade
+                    // text references the originating diagnostic (the leftmost
+                    // missing-state stateful step in the phase).
+                    if (statefulSkipTrigger === null) {
+                        statefulSkipTrigger = { stepId: step.id, reason: result.skip_reason ?? 'missing_tool' };
+                    }
+                }
             }
             else if (result.passed) {
                 context = result.context;
@@ -891,8 +1013,15 @@ async function executeStoryboardPass(agentUrls, storyboard, options, dispatchOff
                     failedCount++;
                     countedAsFailed.add(result);
                 }
-                if (step.stateful)
+                if (step.stateful) {
                     statefulFailed = true;
+                    // Real failure takes precedence over a prior skip-trigger in
+                    // the cascade detail message — failures are the worse
+                    // diagnostic, so downstream cascade-skipped steps should
+                    // reference the failure rather than the earlier benign-ish
+                    // missing-state skip.
+                    statefulSkipTrigger = null;
+                }
                 // In multi-instance mode, annotate the failure with the cross-instance
                 // attribution block so CI readers pattern-match it as a deployment bug.
                 if (isMultiInstance) {
@@ -1198,11 +1327,16 @@ async function runStoryboardStep(agentUrl, storyboard, stepId, options = {}) {
     const client = (0, client_1.getOrCreateClient)(agentUrl, options);
     // Discover agent profile for standalone step execution. Captured so the
     // executeStep call below can thread `library_version` through to
-    // shape-drift hint detection (issue #850).
+    // shape-drift hint detection (issue #850). Also threads _profile into
+    // options so capability-based skip gates in executeStep (e.g. account-mode
+    // branching) can read raw_capabilities, mirroring executeStoryboardPass.
     let profile;
     if (!options._client) {
         const discovered = await (0, client_1.getOrDiscoverProfile)(client, options);
         profile = discovered.profile;
+        if (profile && !options._profile) {
+            options = { ...options, _profile: profile };
+        }
     }
     else {
         profile = options._profile;
@@ -1315,6 +1449,44 @@ client, step, phaseId, context, allSteps, options, state) {
             extraction: { path: 'none' },
         };
     }
+    // Account-mode capability gate: sync_accounts is exclusive to implicit mode
+    // (require_operator_auth: false). When the seller declared explicit mode
+    // (require_operator_auth: true), sync_accounts does not apply — grade
+    // not_applicable rather than missing_tool so adopters can distinguish
+    // "your capability declaration says this path isn't yours" from "you forgot
+    // to implement a required tool."
+    //
+    // list_accounts is NOT gated here: it appears in audience_sync and other
+    // storyboard flows regardless of account mode, so it is always applicable.
+    //
+    // Requires _profile threaded from the discovery block in
+    // executeStoryboardPass or runStoryboardStep.
+    if (effectiveStep.task === 'sync_accounts') {
+        const rawCaps = options._profile?.raw_capabilities;
+        if (rawCaps !== undefined) {
+            const requireOperatorAuth = resolveCapabilityPath(rawCaps, 'account.require_operator_auth');
+            if (requireOperatorAuth === true) {
+                const detail = `Agent declared explicit account mode (require_operator_auth: true); ` +
+                    `sync_accounts is not applicable — list_accounts is the correct tool for this account shape.`;
+                const next = getNextStepPreview(step.id, allSteps, context, runState.runnerVars);
+                return {
+                    step_id: step.id,
+                    phase_id: phaseId,
+                    title: step.title,
+                    task: step.task,
+                    passed: true,
+                    skipped: true,
+                    skip_reason: 'not_applicable',
+                    skip: buildSkip('not_applicable', detail),
+                    duration_ms: 0,
+                    validations: [],
+                    context,
+                    next,
+                    extraction: { path: 'none' },
+                };
+            }
+        }
+    }
     // Skip if agent doesn't implement the tool this step calls.
     if (options.agentTools && !options.agentTools.includes(effectiveStep.task)) {
         const next = getNextStepPreview(step.id, allSteps, context, runState.runnerVars);