@adcp/client 4.20.0 → 4.22.0

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

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * Shared JSON path utilities for storyboard context and validations.
+ *
+ * Parses dot-notation paths with array indexing (e.g., "accounts[0].account_id")
+ * into segment arrays, and resolves/sets values at those paths.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parsePath = parsePath;
+exports.resolvePath = resolvePath;
+exports.setPath = setPath;
+/**
+ * Parse a path string into segments.
+ * "accounts[0].account_id" → ["accounts", 0, "account_id"]
+ */
+function parsePath(path) {
+    const segments = [];
+    const re = /([^.\[\]]+)|\[(\d+)\]/g;
+    let match;
+    while ((match = re.exec(path)) !== null) {
+        if (match[2] !== undefined) {
+            segments.push(parseInt(match[2], 10));
+        }
+        else if (match[1] !== undefined) {
+            segments.push(match[1]);
+        }
+    }
+    return segments;
+}
+/**
+ * Resolve a dot-path with array indexing against an object.
+ *
+ * Examples:
+ *   "accounts[0].account_id" → obj.accounts[0].account_id
+ *   "formats[0].format_id.id" → obj.formats[0].format_id.id
+ *   "status" → obj.status
+ */
+function resolvePath(obj, path) {
+    if (obj === null || obj === undefined)
+        return undefined;
+    const segments = parsePath(path);
+    let current = obj;
+    for (const segment of segments) {
+        if (current === null || current === undefined)
+            return undefined;
+        if (typeof segment === 'number') {
+            if (!Array.isArray(current))
+                return undefined;
+            current = current[segment];
+        }
+        else {
+            if (typeof current !== 'object')
+                return undefined;
+            current = current[segment];
+        }
+    }
+    return current;
+}
+const FORBIDDEN_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
+function isPlainObject(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+/**
+ * Set a value at a dot-path with array indexing.
+ * Creates intermediate objects/arrays as needed.
+ * Guards against prototype pollution.
+ *
+ * "media_buy_ids[0]" → obj.media_buy_ids[0] = value
+ */
+function setPath(obj, path, value) {
+    const segments = parsePath(path);
+    let current = obj;
+    for (let i = 0; i < segments.length - 1; i++) {
+        const segment = segments[i];
+        const nextSegment = segments[i + 1];
+        if (typeof segment === 'number') {
+            if (!Array.isArray(current))
+                return;
+            if (current[segment] === undefined || current[segment] === null) {
+                current[segment] = typeof nextSegment === 'number' ? [] : {};
+            }
+            current = current[segment];
+        }
+        else {
+            if (FORBIDDEN_KEYS.has(segment))
+                return;
+            if (!isPlainObject(current))
+                return;
+            if (!Object.prototype.hasOwnProperty.call(current, segment) || current[segment] == null) {
+                Object.defineProperty(current, segment, {
+                    value: typeof nextSegment === 'number' ? [] : {},
+                    writable: true,
+                    enumerable: true,
+                    configurable: true,
+                });
+            }
+            current = current[segment];
+        }
+    }
+    const lastSegment = segments[segments.length - 1];
+    if (lastSegment === undefined)
+        return;
+    if (typeof lastSegment === 'number') {
+        if (Array.isArray(current)) {
+            current[lastSegment] = value;
+        }
+    }
+    else {
+        if (FORBIDDEN_KEYS.has(lastSegment))
+            return;
+        if (!isPlainObject(current))
+            return;
+        Object.defineProperty(current, lastSegment, {
+            value,
+            writable: true,
+            enumerable: true,
+            configurable: true,
+        });
+    }
+}
+//# sourceMappingURL=path.js.map

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

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

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

@@ -0,0 +1,28 @@
+/**
+ * Request builder for storyboard steps.
+ *
+ * Builds valid requests from discovered context rather than using
+ * raw sample_request YAML payloads. Each task has a builder that
+ * constructs a minimal valid request from the accumulated context
+ * (discovered products, accounts, formats, etc.) and TestOptions.
+ *
+ * sample_request from YAML is used only as documentation and as a
+ * fallback when no builder exists for a task.
+ */
+import type { TestOptions } from '../types';
+import type { StoryboardContext, StoryboardStep } from './types';
+/**
+ * Build a request for a storyboard step.
+ *
+ * Priority:
+ * 1. User-provided --request override (from StoryboardRunOptions)
+ * 2. Request builder for the task (builds from context + options)
+ * 3. sample_request from YAML with context injection (fallback)
+ * 4. Empty object
+ */
+export declare function buildRequest(step: StoryboardStep, context: StoryboardContext, options: TestOptions): Record<string, unknown>;
+/**
+ * Check if a request builder exists for a task.
+ */
+export declare function hasRequestBuilder(taskName: string): boolean;
+//# sourceMappingURL=request-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"request-builder.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/storyboard/request-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAoYjE;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,WAAW,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE3D"}

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

@@ -0,0 +1,410 @@
+"use strict";
+/**
+ * Request builder for storyboard steps.
+ *
+ * Builds valid requests from discovered context rather than using
+ * raw sample_request YAML payloads. Each task has a builder that
+ * constructs a minimal valid request from the accumulated context
+ * (discovered products, accounts, formats, etc.) and TestOptions.
+ *
+ * sample_request from YAML is used only as documentation and as a
+ * fallback when no builder exists for a task.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildRequest = buildRequest;
+exports.hasRequestBuilder = hasRequestBuilder;
+const client_1 = require("../client");
+const REQUEST_BUILDERS = {
+    // ── Account & Audience ─────────────────────────────────
+    sync_accounts(_step, _context, options) {
+        return {
+            accounts: [
+                {
+                    brand: (0, client_1.resolveBrand)(options),
+                    operator: (0, client_1.resolveBrand)(options).domain,
+                    billing: 'operator',
+                    payment_terms: 'net_30',
+                },
+            ],
+        };
+    },
+    list_accounts(_step, _context, options) {
+        return {
+            brand: (0, client_1.resolveBrand)(options),
+        };
+    },
+    sync_audiences(_step, context, options) {
+        return {
+            account: context.account ?? (0, client_1.resolveAccount)(options),
+            audiences: [
+                {
+                    audience_id: `test-audience-${Date.now()}`,
+                    name: 'E2E Test Audience',
+                    identifiers: [
+                        {
+                            type: 'hashed_email',
+                            value: 'e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855',
+                        },
+                    ],
+                },
+            ],
+        };
+    },
+    // ── Product Discovery ──────────────────────────────────
+    get_products(step, context, options) {
+        // If the step is a "refine" step, build a refine request
+        if (step.sample_request?.buying_mode === 'refine' && context.products) {
+            return {
+                buying_mode: 'refine',
+                refine: [
+                    {
+                        scope: 'request',
+                        ask: 'Only guaranteed packages with premium placement.',
+                    },
+                ],
+                brand: (0, client_1.resolveBrand)(options),
+                account: context.account ?? (0, client_1.resolveAccount)(options),
+            };
+        }
+        return {
+            buying_mode: 'brief',
+            brief: options.brief || 'Show me all available advertising products across all channels',
+            brand: (0, client_1.resolveBrand)(options),
+        };
+    },
+    // ── Media Buy ──────────────────────────────────────────
+    create_media_buy(_step, context, options) {
+        const product = selectProduct(context);
+        const pricingOption = selectPricingOption(product);
+        const now = Date.now();
+        const startTime = new Date(now + 24 * 60 * 60 * 1000).toISOString();
+        const endTime = new Date(now + 8 * 24 * 60 * 60 * 1000).toISOString();
+        const pkg = {
+            product_id: product?.product_id ?? context.product_id ?? 'test-product',
+            budget: options.budget ?? Math.max(1000, pricingOption?.min_spend_per_package ?? 1000),
+        };
+        if (pricingOption?.pricing_option_id) {
+            pkg.pricing_option_id = pricingOption.pricing_option_id;
+        }
+        // Add bid_price for auction-based pricing
+        if (pricingOption?.pricing_model === 'auction' || pricingOption?.pricing_model === 'cpm') {
+            const floor = pricingOption?.floor_price ?? 5;
+            pkg.bid_price = Math.round(floor * 1.5 * 100) / 100;
+        }
+        return {
+            account: context.account ?? (0, client_1.resolveAccount)(options),
+            brand: (0, client_1.resolveBrand)(options),
+            start_time: startTime,
+            end_time: endTime,
+            packages: [pkg],
+        };
+    },
+    update_media_buy(step, context, _options) {
+        const request = {
+            media_buy_id: context.media_buy_id ?? 'unknown',
+        };
+        // Detect the intent from sample_request or step ID
+        if (step.sample_request?.action) {
+            request.action = step.sample_request.action;
+        }
+        else if (step.id.includes('pause')) {
+            request.action = 'pause';
+        }
+        else if (step.id.includes('resume')) {
+            request.action = 'resume';
+        }
+        else if (step.id.includes('cancel')) {
+            request.action = 'cancel';
+        }
+        else {
+            // Default: update budget
+            request.packages = [
+                {
+                    package_id: context.package_id,
+                    budget: 2000,
+                },
+            ];
+        }
+        return request;
+    },
+    get_media_buys(_step, context, _options) {
+        return {
+            media_buy_ids: [context.media_buy_id ?? 'unknown'],
+        };
+    },
+    get_media_buy_delivery(_step, context, _options) {
+        return {
+            media_buy_ids: [context.media_buy_id ?? 'unknown'],
+        };
+    },
+    provide_performance_feedback(_step, context, _options) {
+        return {
+            media_buy_id: context.media_buy_id ?? 'unknown',
+            feedback: {
+                satisfaction: 'positive',
+                notes: 'E2E test feedback',
+            },
+        };
+    },
+    // ── Creative ───────────────────────────────────────────
+    list_creative_formats() {
+        return {};
+    },
+    build_creative(_step, context, options) {
+        const format = selectFormat(context);
+        return {
+            target_format_id: format?.format_id ?? context.format_id ?? { agent_url: 'unknown', id: 'unknown' },
+            brand: (0, client_1.resolveBrand)(options),
+            message: 'Create a test advertisement for an e-commerce brand promoting a summer sale.',
+            quality: 'draft',
+            include_preview: true,
+        };
+    },
+    preview_creative(_step, context, _options) {
+        const format = selectFormat(context);
+        return {
+            request_type: 'single',
+            creative_manifest: {
+                format_id: format?.format_id ?? context.format_id ?? { agent_url: 'unknown', id: 'unknown' },
+                name: 'E2E Test Creative',
+                assets: {},
+            },
+        };
+    },
+    sync_creatives(_step, context, options) {
+        const format = selectFormat(context);
+        const formatId = format?.format_id ?? context.format_id ?? { agent_url: 'unknown', id: 'unknown' };
+        // Build assets as a record (not array) — keyed by asset role
+        const assets = {
+            primary: {
+                url: 'https://test-assets.adcontextprotocol.org/acme-outdoor/hero-master.jpg',
+                width: 1200,
+                height: 628,
+                format: 'image/jpeg',
+            },
+        };
+        return {
+            account: context.account ?? (0, client_1.resolveAccount)(options),
+            creatives: [
+                {
+                    creative_id: `test-creative-${Date.now()}`,
+                    name: 'E2E Test Creative',
+                    format_id: formatId,
+                    assets,
+                },
+            ],
+        };
+    },
+    list_creatives(_step, context, options) {
+        return {
+            account: context.account ?? (0, client_1.resolveAccount)(options),
+        };
+    },
+    // ── Signals ────────────────────────────────────────────
+    get_signals(_step, _context, options) {
+        return {
+            signal_spec: options.brief || 'Show me all available audience signals and segments',
+        };
+    },
+    activate_signal(_step, context, _options) {
+        const signal = selectSignal(context);
+        return {
+            signal_agent_segment_id: signal?.signal_agent_segment_id ?? context.signal_id ?? 'test-signal',
+            destinations: [
+                { type: 'platform', platform: 'dv360', account: 'test-dv360-account' },
+                { type: 'platform', platform: 'trade-desk', account: 'test-ttd-account' },
+            ],
+        };
+    },
+    // ── Capabilities ───────────────────────────────────────
+    get_adcp_capabilities() {
+        return {};
+    },
+    // ── Governance ─────────────────────────────────────────
+    sync_governance(_step, context, options) {
+        return {
+            accounts: [
+                {
+                    account: context.account ?? (0, client_1.resolveAccount)(options),
+                    governance_agents: [
+                        {
+                            url: 'https://governance.test.example.com',
+                            authentication: {
+                                schemes: ['Bearer'],
+                                credentials: 'test-governance-token',
+                            },
+                            categories: ['budget_authority', 'brand_policy'],
+                        },
+                    ],
+                },
+            ],
+        };
+    },
+    create_property_list(_step, _context, options) {
+        return {
+            name: options.property_list_name ?? `E2E Test List ${Date.now()}`,
+            description: 'Property list created by storyboard testing',
+            base_properties: {
+                include: [{ identifier_type: 'domain', identifier_value: 'test.example.com' }],
+            },
+            filters: {
+                garm_categories: { exclude: ['adult', 'arms'] },
+            },
+            brand_manifest: { name: (0, client_1.resolveBrand)(options).domain, url: `https://${(0, client_1.resolveBrand)(options).domain}` },
+        };
+    },
+    get_property_list(_step, context, _options) {
+        return {
+            list_id: context.property_list_id ?? 'unknown',
+            resolve: true,
+        };
+    },
+    update_property_list(_step, context, _options) {
+        return {
+            list_id: context.property_list_id ?? 'unknown',
+            description: 'Updated by storyboard testing',
+            base_properties: {
+                include: [
+                    { identifier_type: 'domain', identifier_value: 'test.example.com' },
+                    { identifier_type: 'domain', identifier_value: 'updated.example.com' },
+                ],
+            },
+        };
+    },
+    list_property_lists() {
+        return {};
+    },
+    delete_property_list(_step, context, _options) {
+        return {
+            list_id: context.property_list_id ?? 'unknown',
+        };
+    },
+    list_content_standards() {
+        return {};
+    },
+    get_content_standards(_step, context, _options) {
+        return {
+            content_standards_id: context.content_standards_id ?? 'unknown',
+        };
+    },
+    sync_plans(_step, context, options) {
+        return {
+            account: context.account ?? (0, client_1.resolveAccount)(options),
+            plans: [
+                {
+                    plan_id: `test-plan-${Date.now()}`,
+                    name: 'E2E Test Plan',
+                    budget: { total: options.budget ?? 10000, currency: 'USD' },
+                },
+            ],
+        };
+    },
+    // ── Sponsored Intelligence ─────────────────────────────
+    si_get_offering(_step, _context, options) {
+        return {
+            offering_id: options.si_offering_id ?? 'e2e-test-offering',
+            context: options.si_context ?? 'E2E testing - checking SI offering availability',
+            identity: {
+                principal: (0, client_1.resolveAuthPrincipal)(options) ?? 'e2e-test-principal',
+                device_id: 'e2e-test-device',
+            },
+        };
+    },
+    si_initiate_session(_step, context, options) {
+        return {
+            offering_id: context.offering_id ?? options.si_offering_id ?? 'e2e-test-offering',
+            offering_token: context.offering_token,
+            identity: {
+                principal: (0, client_1.resolveAuthPrincipal)(options) ?? 'e2e-test-principal',
+                device_id: 'e2e-test-device',
+            },
+            context: options.si_context ?? 'E2E test session',
+            placement: 'e2e-test',
+            supported_capabilities: {
+                modalities: { conversational: true, rich_media: true },
+            },
+        };
+    },
+    si_send_message(_step, context, _options) {
+        return {
+            session_id: context.session_id ?? 'unknown',
+            message: 'Tell me more about this product.',
+        };
+    },
+    si_terminate_session(_step, context, _options) {
+        return {
+            session_id: context.session_id ?? 'unknown',
+        };
+    },
+    // ── Test Controller ────────────────────────────────────
+    comply_test_controller(step, context, _options) {
+        // The test controller request is highly step-specific.
+        // Use sample_request from YAML since it defines the exact scenario/state.
+        if (step.sample_request) {
+            return { ...step.sample_request };
+        }
+        return {
+            scenario: context.controller_scenario ?? 'list_scenarios',
+        };
+    },
+};
+/**
+ * Build a request for a storyboard step.
+ *
+ * Priority:
+ * 1. User-provided --request override (from StoryboardRunOptions)
+ * 2. Request builder for the task (builds from context + options)
+ * 3. sample_request from YAML with context injection (fallback)
+ * 4. Empty object
+ */
+function buildRequest(step, context, options) {
+    const builder = REQUEST_BUILDERS[step.task];
+    if (builder) {
+        return builder(step, context, options);
+    }
+    // No builder — fall through to sample_request (handled by runner)
+    return {};
+}
+/**
+ * Check if a request builder exists for a task.
+ */
+function hasRequestBuilder(taskName) {
+    return taskName in REQUEST_BUILDERS;
+}
+// ────────────────────────────────────────────────────────────
+// Selection helpers: pick the best item from discovered data
+// ────────────────────────────────────────────────────────────
+function selectProduct(context) {
+    const products = context.products;
+    if (!products?.length)
+        return undefined;
+    // Prefer products with guaranteed delivery and pricing options
+    const withPricing = products.filter(p => {
+        const opts = p.pricing_options;
+        return opts && opts.length > 0;
+    });
+    return withPricing[0] ?? products[0];
+}
+function selectPricingOption(product) {
+    if (!product)
+        return undefined;
+    const options = product.pricing_options;
+    if (!options?.length)
+        return undefined;
+    // Prefer fixed pricing (cpm, flat) over auction
+    const fixed = options.filter(o => o.pricing_model === 'cpm' || o.pricing_model === 'flat');
+    return fixed[0] ?? options[0];
+}
+function selectFormat(context) {
+    const formats = context.formats;
+    if (!formats?.length)
+        return undefined;
+    return formats[0];
+}
+function selectSignal(context) {
+    const signals = context.signals;
+    if (!signals?.length)
+        return undefined;
+    return signals[0];
+}
+//# sourceMappingURL=request-builder.js.map

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

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

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

@@ -0,0 +1,24 @@
+/**
+ * Storyboard execution engine.
+ *
+ * Two entry points:
+ * - runStoryboard(): run all phases/steps sequentially
+ * - runStoryboardStep(): run a single step (stateless, LLM-friendly)
+ */
+import type { Storyboard, StoryboardContext, StoryboardRunOptions, StoryboardResult, StoryboardStepResult, StoryboardStepPreview } from './types';
+/**
+ * Run an entire storyboard against an agent.
+ */
+export declare function runStoryboard(agentUrl: string, storyboard: Storyboard, options?: StoryboardRunOptions): Promise<StoryboardResult>;
+/**
+ * Run a single storyboard step.
+ *
+ * This is the core primitive for stateless, LLM-friendly execution.
+ * Context is passed in and returned, enabling step-by-step orchestration.
+ */
+export declare function runStoryboardStep(agentUrl: string, storyboard: Storyboard, stepId: string, options?: StoryboardRunOptions): Promise<StoryboardStepResult>;
+/**
+ * Get a preview of the first step in a storyboard (for showing what will happen).
+ */
+export declare function getFirstStepPreview(storyboard: Storyboard, context?: StoryboardContext): StoryboardStepPreview | undefined;
+//# sourceMappingURL=runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/storyboard/runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,EACV,UAAU,EAEV,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAEhB,oBAAoB,EACpB,qBAAqB,EAEtB,MAAM,SAAS,CAAC;AAMjB;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,gBAAgB,CAAC,CA8F3B;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,CA2B/B;AA4JD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,iBAAsB,GAC9B,qBAAqB,GAAG,SAAS,CAgBnC"}