@adcp/sdk 6.8.0 → 6.9.0

package/dist/lib/server/socket-mode/conformance-client.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ * Adopter-facing Socket Mode client.
+ *
+ * Opens an outbound WebSocket from your dev/staging environment to a
+ * remote AdCP runner (typically Addie at agenticadvertising.org) and
+ * exposes your existing MCP `Server` over it. The remote runner can
+ * then drive `tools/list`, `tools/call`, etc. against your server
+ * exactly as if it had reached you over HTTP — no public DNS, no
+ * inbound exposure.
+ *
+ * Three-line integration:
+ *
+ * ```ts
+ * import { ConformanceClient } from '@adcp/sdk/server';
+ * import { mcpServer } from './my-mcp-server';
+ *
+ * const client = new ConformanceClient({
+ *   url: 'wss://addie.agenticadvertising.org/conformance/connect',
+ *   token: process.env.ADCP_CONFORMANCE_TOKEN!,
+ *   server: mcpServer,
+ * });
+ * await client.start();
+ * ```
+ *
+ * Reconnect: exponential backoff capped at 30s. Stop via `close()` to
+ * opt out of further reconnect attempts.
+ *
+ * Dev/staging only by design — production deployments must not expose
+ * `comply_test_controller` on any surface, including this channel.
+ * See [adcontextprotocol/adcp#3986](https://github.com/adcontextprotocol/adcp/issues/3986).
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConformanceClient = void 0;
+const ws_1 = __importDefault(require("ws"));
+const ws_transport_1 = require("./ws-transport");
+const RECONNECT_INITIAL_MS = 1000;
+const RECONNECT_MAX_MS = 30_000;
+class ConformanceClient {
+    status = 'idle';
+    socket;
+    transport;
+    stopped = false;
+    reconnectAttempt = 0;
+    opts;
+    constructor(opts) {
+        this.opts = { reconnect: true, ...opts };
+    }
+    async start() {
+        this.stopped = false;
+        await this.connect();
+    }
+    async close() {
+        this.stopped = true;
+        if (this.transport) {
+            await this.transport.close();
+        }
+        else if (this.socket) {
+            this.socket.close(1000, 'adopter close');
+        }
+        this.setStatus('idle');
+    }
+    getStatus() {
+        return this.status;
+    }
+    async connect() {
+        this.setStatus('connecting');
+        const url = new URL(this.opts.url);
+        url.searchParams.set('token', this.opts.token);
+        const socket = new ws_1.default(url.toString());
+        this.socket = socket;
+        const transport = new ws_transport_1.WebSocketTransport(socket);
+        this.transport = transport;
+        socket.once('close', () => {
+            this.setStatus('disconnected');
+            if (!this.stopped && this.opts.reconnect) {
+                void this.scheduleReconnect();
+            }
+        });
+        try {
+            await this.opts.server.connect(transport);
+            this.reconnectAttempt = 0;
+            this.setStatus('connected');
+        }
+        catch (err) {
+            this.setStatus('error', { error: err });
+            socket.close(1011, 'connect failed');
+            if (!this.stopped && this.opts.reconnect) {
+                void this.scheduleReconnect();
+            }
+            throw err;
+        }
+    }
+    async scheduleReconnect() {
+        this.reconnectAttempt += 1;
+        const delay = Math.min(RECONNECT_INITIAL_MS * 2 ** (this.reconnectAttempt - 1), RECONNECT_MAX_MS);
+        this.setStatus('connecting', { attempt: this.reconnectAttempt });
+        await new Promise(r => setTimeout(r, delay));
+        if (this.stopped)
+            return;
+        try {
+            await this.connect();
+        }
+        catch {
+            // setStatus already invoked; loop continues via the close handler
+        }
+    }
+    setStatus(status, detail) {
+        this.status = status;
+        this.opts.onStatus?.(status, detail);
+    }
+}
+exports.ConformanceClient = ConformanceClient;
+//# sourceMappingURL=conformance-client.js.map

package/dist/lib/server/socket-mode/conformance-client.js.map

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

package/dist/lib/server/socket-mode/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Socket Mode — outbound-WebSocket bridge so an adopter's MCP server
+ * can be reached by a remote runner without a public DNS / firewall
+ * hole. Slack Socket Mode pattern.
+ *
+ * Today the canonical consumer is Addie at agenticadvertising.org for
+ * conformance assistance during agent development. The transport is
+ * neutral — any third-party orchestrator that speaks the same handshake
+ * could terminate the other end.
+ *
+ * Dev/staging only — see `ConformanceClient` JSDoc for the policy.
+ */
+export { ConformanceClient, type ConformanceClientOptions, type ConformanceStatus } from './conformance-client';
+export { WebSocketTransport } from './ws-transport';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/server/socket-mode/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/server/socket-mode/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAChH,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/lib/server/socket-mode/index.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * Socket Mode — outbound-WebSocket bridge so an adopter's MCP server
+ * can be reached by a remote runner without a public DNS / firewall
+ * hole. Slack Socket Mode pattern.
+ *
+ * Today the canonical consumer is Addie at agenticadvertising.org for
+ * conformance assistance during agent development. The transport is
+ * neutral — any third-party orchestrator that speaks the same handshake
+ * could terminate the other end.
+ *
+ * Dev/staging only — see `ConformanceClient` JSDoc for the policy.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketTransport = exports.ConformanceClient = void 0;
+var conformance_client_1 = require("./conformance-client");
+Object.defineProperty(exports, "ConformanceClient", { enumerable: true, get: function () { return conformance_client_1.ConformanceClient; } });
+var ws_transport_1 = require("./ws-transport");
+Object.defineProperty(exports, "WebSocketTransport", { enumerable: true, get: function () { return ws_transport_1.WebSocketTransport; } });
+//# sourceMappingURL=index.js.map

package/dist/lib/server/socket-mode/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/server/socket-mode/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAEH,2DAAgH;AAAvG,uHAAA,iBAAiB,OAAA;AAC1B,+CAAoD;AAA3C,kHAAA,kBAAkB,OAAA"}

package/dist/lib/server/socket-mode/ws-transport.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Adopter-side MCP `Transport` over an outbound WebSocket.
+ *
+ * Wraps a `ws` Node WebSocket as the MCP SDK's `Transport` interface
+ * so an existing `Server` instance can be exposed bidirectionally over
+ * a single outbound connection.
+ *
+ * This is the building block for "Socket Mode" — see `ConformanceClient`
+ * for the high-level adopter-facing class.
+ */
+import WebSocket from 'ws';
+import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+import { type JSONRPCMessage } from '@modelcontextprotocol/sdk/types.js';
+export declare class WebSocketTransport implements Transport {
+    private readonly socket;
+    onclose?: () => void;
+    onerror?: (error: Error) => void;
+    onmessage?: (message: JSONRPCMessage) => void;
+    sessionId?: string;
+    private closed;
+    constructor(socket: WebSocket);
+    start(): Promise<void>;
+    send(message: JSONRPCMessage): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=ws-transport.d.ts.map

package/dist/lib/server/socket-mode/ws-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-transport.d.ts","sourceRoot":"","sources":["../../../../src/lib/server/socket-mode/ws-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,SAAS,MAAM,IAAI,CAAC;AAC3B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAE/F,qBAAa,kBAAmB,YAAW,SAAS;IAQtC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPnC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,OAAO,CAAC,MAAM,CAAS;gBAEM,MAAM,EAAE,SAAS;IAExC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwCtB,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAU7B"}

package/dist/lib/server/socket-mode/ws-transport.js

@@ -0,0 +1,93 @@
+"use strict";
+/**
+ * Adopter-side MCP `Transport` over an outbound WebSocket.
+ *
+ * Wraps a `ws` Node WebSocket as the MCP SDK's `Transport` interface
+ * so an existing `Server` instance can be exposed bidirectionally over
+ * a single outbound connection.
+ *
+ * This is the building block for "Socket Mode" — see `ConformanceClient`
+ * for the high-level adopter-facing class.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketTransport = void 0;
+const ws_1 = __importDefault(require("ws"));
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+class WebSocketTransport {
+    socket;
+    onclose;
+    onerror;
+    onmessage;
+    sessionId;
+    closed = false;
+    constructor(socket) {
+        this.socket = socket;
+    }
+    async start() {
+        this.socket.on('message', (data, isBinary) => {
+            if (isBinary) {
+                this.onerror?.(new Error('binary frames are not supported'));
+                return;
+            }
+            const text = data.toString('utf-8');
+            let parsed;
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch (err) {
+                this.onerror?.(new Error(`malformed JSON frame: ${err.message}`));
+                return;
+            }
+            const result = types_js_1.JSONRPCMessageSchema.safeParse(parsed);
+            if (!result.success) {
+                this.onerror?.(new Error(`malformed JSON-RPC message: ${result.error.message}`));
+                return;
+            }
+            this.onmessage?.(result.data);
+        });
+        this.socket.on('close', () => {
+            if (this.closed)
+                return;
+            this.closed = true;
+            this.onclose?.();
+        });
+        this.socket.on('error', err => {
+            this.onerror?.(err);
+        });
+        if (this.socket.readyState === ws_1.default.CONNECTING) {
+            await new Promise((resolve, reject) => {
+                this.socket.once('open', () => resolve());
+                this.socket.once('error', reject);
+            });
+        }
+    }
+    async send(message) {
+        if (this.closed)
+            throw new Error('transport closed');
+        return new Promise((resolve, reject) => {
+            this.socket.send(JSON.stringify(message), err => {
+                if (err)
+                    reject(err);
+                else
+                    resolve();
+            });
+        });
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        try {
+            this.socket.close(1000, 'transport closed');
+        }
+        catch {
+            // ignore
+        }
+        this.onclose?.();
+    }
+}
+exports.WebSocketTransport = WebSocketTransport;
+//# sourceMappingURL=ws-transport.js.map

package/dist/lib/server/socket-mode/ws-transport.js.map

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

package/dist/lib/testing/comply-controller.d.ts

@@ -44,7 +44,7 @@
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { ZodTypeAny } from 'zod';
-import { TOOL_INPUT_SHAPE, type SeedFixtureCache } from '../server/test-controller';
+import { TOOL_INPUT_SHAPE, type SeedFixtureCache, type UpstreamTrafficSuccessResponse } from '../server/test-controller';
 import { type AdcpServer } from '../server/adcp-server';
 import type { ComplyTestControllerResponse, ForcedDirectiveSuccess, SimulationSuccess, StateTransitionSuccess } from '../types/tools.generated';
 import type { AccountStatus, CreativeStatus, MediaBuyStatus } from '../types/core.generated';
@@ -143,6 +143,38 @@ export type ForceAdapter<P> = (params: P, ctx: ComplyControllerContext) => Promi
 export type DirectiveAdapter<P> = (params: P, ctx: ComplyControllerContext) => Promise<ForcedDirectiveSuccess> | ForcedDirectiveSuccess;
 /** Simulate adapters return a {@link SimulationSuccess}. */
 export type SimulateAdapter<P> = (params: P, ctx: ComplyControllerContext) => Promise<SimulationSuccess> | SimulationSuccess;
+/** Params for the `query_upstream_traffic` extension scenario (spec PR
+ * adcontextprotocol/adcp#3816). All fields optional; the recorder
+ * filters by these. */
+export interface QueryUpstreamTrafficParams {
+    since_timestamp?: string;
+    endpoint_pattern?: string;
+    limit?: number;
+}
+/** Adapter for the `query_upstream_traffic` extension scenario. Returns
+ * the recorded upstream HTTP calls produced during the current
+ * storyboard step — the runner consults this for `check: upstream_traffic`
+ * validations. Adopters typically delegate to the reference recorder
+ * middleware shipped at `@adcp/sdk/upstream-recorder`:
+ *
+ * ```ts
+ * complyTest: {
+ *   queryUpstreamTraffic: (params, _ctx) => {
+ *     const result = recorder.query({
+ *       principal: RECORDER_PRINCIPAL,
+ *       ...(params.since_timestamp !== undefined && { sinceTimestamp: params.since_timestamp }),
+ *       ...(params.endpoint_pattern !== undefined && { endpointPattern: params.endpoint_pattern }),
+ *       ...(params.limit !== undefined && { limit: params.limit }),
+ *     });
+ *     return toQueryUpstreamTrafficResponse(result);
+ *   },
+ * }
+ * ```
+ *
+ * The principal MUST match between record-time (`runWithPrincipal`) and
+ * query-time, or the recorder returns zero rows per cross-tenant
+ * isolation. */
+export type QueryUpstreamTrafficAdapter = (params: QueryUpstreamTrafficParams, ctx: ComplyControllerContext) => Promise<UpstreamTrafficSuccessResponse> | UpstreamTrafficSuccessResponse;
 export interface ComplyControllerConfig {
     /** Per-request gate. Return `false` to reject with `FORBIDDEN` — suitable
      * for tenants flagged as production, accounts not marked sandbox, or
@@ -190,6 +222,15 @@ export interface ComplyControllerConfig {
         delivery?: SimulateAdapter<SimulateDeliveryParams>;
         budget_spend?: SimulateAdapter<SimulateBudgetSpendParams>;
     };
+    /**
+     * `query_upstream_traffic` adapter (spec PR adcontextprotocol/adcp#3816).
+     * Returns the recorded upstream HTTP calls produced during the current
+     * storyboard step so the runner can grade `check: upstream_traffic`
+     * validations. Adopters typically wire the reference recorder from
+     * `@adcp/sdk/upstream-recorder`. When omitted, the scenario reports as
+     * `not_applicable` per the runner's normal capability discovery.
+     */
+    queryUpstreamTraffic?: QueryUpstreamTrafficAdapter;
     /** Override the seed idempotency cache (e.g., to scope by tenant or
      * persist across restarts). Defaults to an unbounded in-memory cache. */
     seedCache?: SeedFixtureCache;

package/dist/lib/testing/comply-controller.d.ts.map

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

package/dist/lib/testing/comply-controller.js

@@ -58,7 +58,7 @@ function controllerError(code, detail) {
  * `handleTestControllerRequest` returns `UNKNOWN_SCENARIO` for the rest. */
 function buildStore(config, ctx) {
     const store = {};
-    const { seed, force, simulate } = config;
+    const { seed, force, simulate, queryUpstreamTraffic } = config;
     if (seed?.product) {
         store.seedProduct = async (productId, fixture) => {
             await seed.product({ product_id: productId, fixture: fixture ?? {} }, ctx);
@@ -113,6 +113,9 @@ function buildStore(config, ctx) {
     if (simulate?.budget_spend) {
         store.simulateBudgetSpend = params => Promise.resolve(simulate.budget_spend(params, ctx));
     }
+    if (queryUpstreamTraffic) {
+        store.queryUpstreamTraffic = params => Promise.resolve(queryUpstreamTraffic(params, ctx));
+    }
     return store;
 }
 /** The set of force_* / simulate_* scenarios a config advertises via
@@ -135,6 +138,15 @@ function advertisedScenarios(config) {
         out.push(test_controller_1.CONTROLLER_SCENARIOS.SIMULATE_DELIVERY);
     if (config.simulate?.budget_spend)
         out.push(test_controller_1.CONTROLLER_SCENARIOS.SIMULATE_BUDGET_SPEND);
+    // `query_upstream_traffic` is an extension scenario (spec PR
+    // adcontextprotocol/adcp#3816) — not yet in the schema cache's
+    // `ControllerScenario` enum, but the dispatcher accepts it under
+    // `TOOL_INPUT_SHAPE.scenario: z.string()`'s open-extension pattern.
+    // Cast through unknown until the schema lands, then this becomes a
+    // `CONTROLLER_SCENARIOS.QUERY_UPSTREAM_TRAFFIC` reference like the
+    // others above.
+    if (config.queryUpstreamTraffic)
+        out.push('query_upstream_traffic');
     return out;
 }
 /** Create a comply_test_controller scaffold from domain-grouped adapters. */

package/dist/lib/testing/comply-controller.js.map

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

package/dist/lib/testing/storyboard/request-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-builder.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/storyboard/request-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAwxBhE,wBAAgB,aAAa,CAC3B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,WAAW,EACpB,UAAU,CAAC,EAAE,eAAe,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4BzB;AAED,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE5D;AAQD,6DAA6D;AAC7D,eAAO,MAAM,YAAY,sBAAgB,CAAC;AAE1C,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,2BAAqB,CAAC"}
+{"version":3,"file":"request-builder.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/storyboard/request-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAgzBhE,wBAAgB,aAAa,CAC3B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,WAAW,EACpB,UAAU,CAAC,EAAE,eAAe,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4BzB;AAED,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE5D;AAQD,6DAA6D;AAC7D,eAAO,MAAM,YAAY,sBAAgB,CAAC;AAE1C,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,2BAAqB,CAAC"}

package/dist/lib/testing/storyboard/request-builder.js

@@ -63,6 +63,9 @@ const FALLBACK_CALLER_AGENT_URL = 'https://e2e-orchestrator.adcontextprotocol.or
 const FIXTURE_AWARE_ENRICHERS = new Set([
     'create_media_buy', // merges discovery-derived product_id / pricing_option_id INTO fixture packages[0]
     'comply_test_controller', // forces account.sandbox: true regardless of fixture
+    'update_media_buy', // resolves account via resolveAccount(options) so sandbox routing matches create_media_buy
+    'get_media_buys', // resolves account via resolveAccount(options) so sandbox routing matches create_media_buy
+    'get_media_buy_delivery', // resolves account via resolveAccount(options) so sandbox routing matches create_media_buy
 ]);
 /**
  * Placeholder identifiers that the upstream universal compliance
@@ -250,50 +253,70 @@ const REQUEST_ENRICHERS = {
         };
     },
     update_media_buy(step, context, options) {
-        // If the storyboard provides a sample_request, honor it — these requests
-        // are hand-authored to exercise specific seller behaviors (creative
-        // assignment, targeting overlay swaps, pause/resume/cancel, etc.) and the
-        // builder should not override the intent.
-        // `account` is required per bundled/media-buy/update-media-buy-request.json —
-        // sellers enforce governance and account resolution against it.
-        const request = {
-            account: context.account ?? (0, client_1.resolveAccount)(options),
-            media_buy_id: context.media_buy_id ?? 'unknown',
-        };
-        if (step.id.includes('pause')) {
-            request.paused = true;
-        }
-        else if (step.id.includes('resume')) {
-            request.paused = false;
-        }
-        else if (step.id.includes('cancel')) {
-            request.canceled = true;
+        // Fixture-aware: spread the storyboard's sample_request first so hand-authored
+        // intent (targeting_overlay swaps, creative assignments, pause/resume/cancel)
+        // is preserved verbatim, then force `account` to the harness-resolved value so
+        // sandbox routing matches create_media_buy's namespace on every round-trip
+        // (otherwise the fixture's account silently routes update writes to a different
+        // partition than the create wrote to, and a subsequent get_media_buys reading
+        // from the create-time partition surfaces stale data — see adcp-client#1505).
+        const fixtureFields = step.sample_request
+            ? (0, context_1.injectContext)({ ...step.sample_request }, context)
+            : {};
+        const request = { ...fixtureFields };
+        request.account = context.account ?? (0, client_1.resolveAccount)(options);
+        if (request.media_buy_id === undefined) {
+            request.media_buy_id = context.media_buy_id ?? 'unknown';
         }
-        else {
-            request.packages = [
-                {
-                    package_id: context.package_id ?? 'unknown',
-                    budget: 2000,
-                },
-            ];
+        // No sample_request: fall back to step-id keyword inference so legacy
+        // storyboards without an authored fixture still exercise sensible flows.
+        if (!step.sample_request) {
+            if (step.id.includes('pause')) {
+                request.paused = true;
+            }
+            else if (step.id.includes('resume')) {
+                request.paused = false;
+            }
+            else if (step.id.includes('cancel')) {
+                request.canceled = true;
+            }
+            else {
+                request.packages = [
+                    {
+                        package_id: context.package_id ?? 'unknown',
+                        budget: 2000,
+                    },
+                ];
+            }
         }
         return request;
     },
-    get_media_buys(_step, context, _options) {
-        // media_buy_ids is optional per the request schema; omitting it returns
-        // the broad/paginated set. Inject only when context carries a real ID
-        // so storyboards exercising the list path don't reach the agent with a
-        // synthesized lookup that filters out every result.
-        if (context.media_buy_id == null)
-            return {};
-        return { media_buy_ids: [context.media_buy_id] };
-    },
-    get_media_buy_delivery(_step, context, _options) {
-        // Same omission rule as get_media_buys — media_buy_ids is optional on
-        // get_media_buy_delivery's request schema.
-        if (context.media_buy_id == null)
-            return {};
-        return { media_buy_ids: [context.media_buy_id] };
+    get_media_buys(step, context, options) {
+        // Spread fixture fields so storyboards can author filters, status, pagination, etc.
+        // account is always overridden by the harness-resolved value so sandbox routing
+        // matches create_media_buy's namespace on every round-trip.
+        const fixtureFields = step.sample_request
+            ? (0, context_1.injectContext)({ ...step.sample_request }, context)
+            : {};
+        const result = { ...fixtureFields };
+        result.account = context.account ?? (0, client_1.resolveAccount)(options);
+        if (context.media_buy_id != null && result.media_buy_ids === undefined) {
+            result.media_buy_ids = [context.media_buy_id];
+        }
+        return result;
+    },
+    get_media_buy_delivery(step, context, options) {
+        // Same account-resolution rule as get_media_buys — fixture fields preserved,
+        // account overridden by harness so sandbox routing matches create_media_buy.
+        const fixtureFields = step.sample_request
+            ? (0, context_1.injectContext)({ ...step.sample_request }, context)
+            : {};
+        const result = { ...fixtureFields };
+        result.account = context.account ?? (0, client_1.resolveAccount)(options);
+        if (context.media_buy_id != null && result.media_buy_ids === undefined) {
+            result.media_buy_ids = [context.media_buy_id];
+        }
+        return result;
     },
     // provide_performance_feedback intentionally has no builder — storyboard
     // sample_request is authoritative because the spec's oneOf requires a