@adcp/sdk 5.23.0

package/dist/lib/testing/scenarios/capabilities.js

@@ -0,0 +1,332 @@
+"use strict";
+/**
+ * Capability Discovery Testing Scenarios (v3)
+ *
+ * Tests agent capability discovery including:
+ * - get_adcp_capabilities (v3 agents)
+ * - Synthetic capability detection (v2 agents)
+ * - Protocol/tool cross-validation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testCapabilityDiscovery = testCapabilityDiscovery;
+exports.likelySupportsV3 = likelySupportsV3;
+const client_1 = require("../client");
+const capabilities_1 = require("../../utils/capabilities");
+/**
+ * Test: Capability Discovery
+ *
+ * Flow:
+ * 1. Discover agent profile (tools list)
+ * 2. If get_adcp_capabilities exists, call it and validate response
+ * 3. Cross-check reported protocols against available tools
+ * 4. For v2 agents, build synthetic capabilities and note v3 upgrade path
+ */
+async function testCapabilityDiscovery(agentUrl, options) {
+    const steps = [];
+    const client = (0, client_1.getOrCreateClient)(agentUrl, options);
+    // Discover agent profile
+    const { profile, step: profileStep } = await (0, client_1.getOrDiscoverProfile)(client, options);
+    steps.push(profileStep);
+    if (!profileStep.passed) {
+        return { steps, profile };
+    }
+    const hasGetCapabilities = profile.tools.includes('get_adcp_capabilities');
+    let capabilities;
+    if (hasGetCapabilities) {
+        // v3 agent: call get_adcp_capabilities
+        const { result, step } = await (0, client_1.runStep)('Get AdCP capabilities (v3)', 'get_adcp_capabilities', async () => client.getAdcpCapabilities({}));
+        if (result?.success && result?.data) {
+            capabilities = (0, capabilities_1.parseCapabilitiesResponse)(result.data);
+            profile.adcp_version = capabilities.version;
+            profile.adcp_major_versions = [...capabilities.majorVersions];
+            profile.supported_protocols = capabilities.protocols;
+            profile.supports_governance = capabilities.protocols.includes('governance');
+            profile.supports_si = capabilities.protocols.includes('sponsored_intelligence');
+            step.details = `v${capabilities.majorVersions.join('/')} agent with ${capabilities.protocols.length} protocol(s)`;
+            step.response_preview = JSON.stringify({
+                version: capabilities.version,
+                major_versions: capabilities.majorVersions,
+                protocols: capabilities.protocols,
+                features: capabilities.features,
+                extensions: capabilities.extensions,
+                publisher_domains: capabilities.publisherDomains?.slice(0, 3),
+                channels: capabilities.channels,
+            }, null, 2);
+            steps.push(step);
+            // Validate response structure
+            const { steps: validationSteps } = validateCapabilitiesResponse(result.data, profile.tools);
+            steps.push(...validationSteps);
+        }
+        else if (result && !result.success) {
+            step.passed = false;
+            step.error = result.error || 'get_adcp_capabilities failed';
+            steps.push(step);
+            // Fall back to synthetic capabilities
+            const toolInfos = profile.tools.map(name => ({ name }));
+            capabilities = (0, capabilities_1.buildSyntheticCapabilities)(toolInfos);
+            profile.adcp_version = 'v2';
+            profile.supported_protocols = capabilities.protocols;
+            steps.push({
+                step: 'Fallback to synthetic capabilities',
+                passed: true,
+                duration_ms: 0,
+                details: 'get_adcp_capabilities failed, using tool-based detection',
+            });
+        }
+        else {
+            // No result at all
+            const toolInfos = profile.tools.map(name => ({ name }));
+            capabilities = (0, capabilities_1.buildSyntheticCapabilities)(toolInfos);
+            profile.adcp_version = 'v2';
+            profile.supported_protocols = capabilities.protocols;
+            step.passed = false;
+            step.error = 'get_adcp_capabilities returned no data';
+            steps.push(step);
+        }
+    }
+    else {
+        // v2 agent: build synthetic capabilities
+        const toolInfos = profile.tools.map(name => ({ name }));
+        capabilities = (0, capabilities_1.buildSyntheticCapabilities)(toolInfos);
+        profile.adcp_version = 'v2';
+        profile.supported_protocols = capabilities.protocols;
+        profile.supports_governance = capabilities.protocols.includes('governance');
+        profile.supports_si = capabilities.protocols.includes('sponsored_intelligence');
+        steps.push({
+            step: 'Build synthetic capabilities (v2)',
+            task: undefined,
+            passed: true,
+            duration_ms: 0,
+            details: `Agent does not support get_adcp_capabilities. Detected ${capabilities.protocols.length} protocol(s) from tools.`,
+            response_preview: JSON.stringify({
+                version: capabilities.version,
+                protocols: capabilities.protocols,
+                features: capabilities.features,
+                _synthetic: true,
+            }, null, 2),
+        });
+        // Check for v3 upgrade potential
+        const v3ToolsPresent = [
+            ...capabilities_1.GOVERNANCE_TOOLS,
+            ...capabilities_1.SPONSORED_INTELLIGENCE_TOOLS,
+            ...capabilities_1.TRUSTED_MATCH_TOOLS,
+            ...capabilities_1.COMPLIANCE_TOOLS,
+        ].filter(t => profile.tools.includes(t));
+        if (v3ToolsPresent.length > 0) {
+            steps.push({
+                step: 'v3 upgrade potential detected',
+                passed: true,
+                duration_ms: 0,
+                details: `Agent has ${v3ToolsPresent.length} v3 tool(s) but missing get_adcp_capabilities`,
+                warnings: [
+                    `Consider implementing get_adcp_capabilities for better protocol discovery. v3 tools detected: ${v3ToolsPresent.join(', ')}`,
+                ],
+            });
+        }
+    }
+    // Cross-validate: check that reported protocols match available tools
+    const { steps: crossValidationSteps } = crossValidateProtocolsAndTools(capabilities, profile.tools);
+    steps.push(...crossValidationSteps);
+    return { steps, profile };
+}
+/**
+ * Validate the structure and content of a get_adcp_capabilities response
+ */
+function validateCapabilitiesResponse(response, tools) {
+    const steps = [];
+    // Check for required fields
+    const hasAdcp = response.adcp && Array.isArray(response.adcp.major_versions);
+    const hasProtocols = Array.isArray(response.supported_protocols);
+    steps.push({
+        step: 'Validate capabilities structure',
+        passed: hasAdcp && hasProtocols,
+        duration_ms: 0,
+        details: hasAdcp && hasProtocols
+            ? 'Response has required fields (adcp.major_versions, supported_protocols)'
+            : `Missing fields: ${!hasAdcp ? 'adcp.major_versions' : ''} ${!hasProtocols ? 'supported_protocols' : ''}`,
+    });
+    // Check for v3 version
+    if (hasAdcp) {
+        const majorVersions = response.adcp.major_versions;
+        const hasV3 = majorVersions.includes(3);
+        steps.push({
+            step: 'Check v3 support',
+            passed: true, // Not a failure if v2 only, just informational
+            duration_ms: 0,
+            details: hasV3
+                ? `Agent supports v3 (versions: ${majorVersions.join(', ')})`
+                : `Agent is v2 only (versions: ${majorVersions.join(', ')})`,
+        });
+    }
+    // Check media_buy features if media_buy protocol is supported
+    if (hasProtocols && response.supported_protocols.includes('media_buy')) {
+        const mediaBuy = response.media_buy;
+        const hasMediaBuyFeatures = mediaBuy?.features;
+        steps.push({
+            step: 'Validate media_buy features',
+            passed: true, // Features are optional
+            duration_ms: 0,
+            details: hasMediaBuyFeatures
+                ? `Features: inline_creative=${mediaBuy.features?.inline_creative_management}, property_list=${mediaBuy.features?.property_list_filtering}, content_standards=${mediaBuy.features?.content_standards}`
+                : 'No media_buy.features declared (all features assumed false)',
+        });
+    }
+    if (hasProtocols && response.supported_protocols.includes('creative')) {
+        const creative = response.creative;
+        const hasCreativeCapabilities = !!creative;
+        const creativeWarnings = [];
+        let creativePassed = hasCreativeCapabilities;
+        if (creative?.supports_generation && !tools.includes('build_creative')) {
+            creativePassed = false;
+            creativeWarnings.push('creative.supports_generation=true but build_creative is not advertised');
+        }
+        if (creative?.supports_transformation && !tools.includes('build_creative')) {
+            creativePassed = false;
+            creativeWarnings.push('creative.supports_transformation=true but build_creative is not advertised');
+        }
+        if (creative?.has_creative_library && !tools.includes('list_creatives')) {
+            creativePassed = false;
+            creativeWarnings.push('creative.has_creative_library=true but list_creatives is not advertised');
+        }
+        if (creative?.has_creative_library && !tools.includes('list_accounts') && !tools.includes('sync_accounts')) {
+            creativeWarnings.push('creative.has_creative_library=true but no account management tool is advertised (expected sync_accounts or list_accounts)');
+        }
+        steps.push({
+            step: 'Validate creative capabilities',
+            passed: creativePassed,
+            duration_ms: 0,
+            details: hasCreativeCapabilities
+                ? `Creative: generation=${creative?.supports_generation ?? false}, transformation=${creative?.supports_transformation ?? false}, compliance=${creative?.supports_compliance ?? false}, library=${creative?.has_creative_library ?? false}`
+                : 'creative is listed in supported_protocols but the creative capability block is missing',
+            warnings: creativeWarnings.length > 0 ? creativeWarnings : undefined,
+        });
+    }
+    if (response.account) {
+        const accountWarnings = [];
+        let accountPassed = true;
+        if (response.account.require_operator_auth && !tools.includes('list_accounts')) {
+            accountPassed = false;
+            accountWarnings.push('account.require_operator_auth=true but list_accounts is not advertised');
+        }
+        if (response.account.required_for_products &&
+            !tools.includes('list_accounts') &&
+            !tools.includes('sync_accounts')) {
+            accountPassed = false;
+            accountWarnings.push('account.required_for_products=true but no account management tool is advertised');
+        }
+        steps.push({
+            step: 'Validate account capabilities',
+            passed: accountPassed,
+            duration_ms: 0,
+            details: `Account model: require_operator_auth=${response.account.require_operator_auth ?? false}, required_for_products=${response.account.required_for_products ?? false}, sandbox=${response.account.sandbox ?? false}, supported_billing=${(response.account.supported_billing || []).join(', ') || '(none)'}`,
+            warnings: accountWarnings.length > 0 ? accountWarnings : undefined,
+        });
+    }
+    // Check extensions
+    const extensions = response.extensions_supported ?? [];
+    if (extensions.length > 0) {
+        steps.push({
+            step: 'Check extensions',
+            passed: true,
+            duration_ms: 0,
+            details: `Supported extensions: ${extensions.join(', ')}`,
+        });
+    }
+    return { steps };
+}
+/**
+ * Cross-validate that reported protocols match available tools
+ */
+function crossValidateProtocolsAndTools(capabilities, tools) {
+    const steps = [];
+    const issues = [];
+    const warnings = [];
+    const protocolToolMap = {
+        media_buy: capabilities_1.MEDIA_BUY_TOOLS,
+        signals: capabilities_1.SIGNALS_TOOLS,
+        governance: capabilities_1.GOVERNANCE_TOOLS,
+        creative: capabilities_1.CREATIVE_TOOLS,
+        sponsored_intelligence: capabilities_1.SPONSORED_INTELLIGENCE_TOOLS,
+        trusted_match: capabilities_1.TRUSTED_MATCH_TOOLS,
+        compliance: capabilities_1.COMPLIANCE_TOOLS,
+    };
+    // Check each reported protocol has at least one corresponding tool
+    const perProtocolDiffs = {};
+    for (const protocol of capabilities.protocols) {
+        const protocolTools = protocolToolMap[protocol] || [];
+        const matchingTools = protocolTools.filter(t => tools.includes(t));
+        const missingTools = protocolTools.filter(t => !tools.includes(t));
+        if (matchingTools.length === 0 && protocolTools.length > 0) {
+            issues.push(`Protocol '${protocol}' reported but no matching tools found. Expected one of: [${[...protocolTools].join(', ')}]`);
+            perProtocolDiffs[protocol] = {
+                expected: [...protocolTools],
+                found: [],
+                missing: [...protocolTools],
+            };
+        }
+        else if (missingTools.length > 0) {
+            // Partial coverage is a warning, not a failure — agents can legitimately
+            // implement a subset of tools within a protocol.
+            warnings.push(`Protocol '${protocol}' has partial tool coverage: missing [${missingTools.join(', ')}]`);
+            perProtocolDiffs[protocol] = {
+                expected: [...protocolTools],
+                found: [...matchingTools],
+                missing: missingTools,
+            };
+        }
+    }
+    // Check for tools that suggest protocols not reported.
+    // Only consider tools exclusive to a protocol — shared tools (those appearing
+    // in multiple protocol tool lists) don't indicate a specific unreported protocol.
+    const allProtocolTools = Object.values(protocolToolMap).flat();
+    const toolProtocolCount = new Map();
+    for (const tool of allProtocolTools) {
+        toolProtocolCount.set(tool, (toolProtocolCount.get(tool) || 0) + 1);
+    }
+    const unreportedProtocols = [];
+    for (const [protocol, expectedTools] of Object.entries(protocolToolMap)) {
+        if (!capabilities.protocols.includes(protocol)) {
+            // Only flag based on exclusive tools (not shared across protocols)
+            const exclusivePresent = expectedTools.filter(t => tools.includes(t) && toolProtocolCount.get(t) === 1);
+            if (exclusivePresent.length > 0) {
+                unreportedProtocols.push(protocol);
+                perProtocolDiffs[protocol] = {
+                    expected: [],
+                    found: [...exclusivePresent],
+                    missing: [],
+                };
+            }
+        }
+    }
+    if (unreportedProtocols.length > 0) {
+        issues.push(`Tools suggest unreported protocols: ${unreportedProtocols.map(p => `${p} (has: [${perProtocolDiffs[p].found.join(', ')}])`).join('; ')}`);
+    }
+    const allMessages = [...issues, ...warnings];
+    const hasDiffs = Object.keys(perProtocolDiffs).length > 0;
+    steps.push({
+        step: 'Cross-validate protocols and tools',
+        passed: issues.length === 0,
+        duration_ms: 0,
+        error: issues.length > 0 ? issues.join('; ') : undefined,
+        details: allMessages.length === 0 ? 'Reported protocols match available tools' : allMessages.join('; '),
+        warnings: warnings.length > 0 ? warnings : undefined,
+        response_preview: hasDiffs
+            ? JSON.stringify({
+                reported_protocols: capabilities.protocols,
+                per_protocol: perProtocolDiffs,
+            }, null, 2)
+            : undefined,
+    });
+    return { steps };
+}
+/**
+ * Check if agent likely supports v3 capabilities
+ */
+function likelySupportsV3(tools) {
+    return (tools.includes('get_adcp_capabilities') ||
+        capabilities_1.GOVERNANCE_TOOLS.some(t => tools.includes(t)) ||
+        capabilities_1.SPONSORED_INTELLIGENCE_TOOLS.some(t => tools.includes(t)) ||
+        capabilities_1.TRUSTED_MATCH_TOOLS.some(t => tools.includes(t)) ||
+        capabilities_1.COMPLIANCE_TOOLS.some(t => tools.includes(t)));
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/lib/testing/scenarios/capabilities.js.map

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

package/dist/lib/testing/scenarios/creative.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Creative Agent Testing Scenarios
+ *
+ * Tests creative agent capabilities including:
+ * - list_creative_formats / list_formats
+ * - build_creative
+ * - preview_creative
+ *
+ * Enhanced to:
+ * - Test multiple formats from the agent's actual catalog
+ * - Test with both required and optional assets
+ * - Validate preview renders
+ */
+import type { TestOptions, TestStepResult, AgentProfile } from '../types';
+/**
+ * Test: Creative Flow (for creative agents)
+ *
+ * Flow: list_formats -> build_creative (multiple formats) -> preview_creative (with assets)
+ */
+export declare function testCreativeFlow(agentUrl: string, options: TestOptions): Promise<{
+    steps: TestStepResult[];
+    profile?: AgentProfile;
+}>;
+/**
+ * Test: Creative Lifecycle
+ *
+ * Chains creative protocol operations end-to-end:
+ * 1. list_creative_formats → verify format schema
+ * 2. sync_creatives with multiple creatives → verify per-creative status
+ * 3. list_creatives (no snapshot) → verify basic fields
+ * 4. list_creatives (include_snapshot: true) → verify snapshot or snapshot_unavailable_reason
+ * 5. build_creative or preview_creative on synced creative → adapt to agent capabilities
+ */
+export declare function testCreativeLifecycle(agentUrl: string, options: TestOptions): Promise<{
+    steps: TestStepResult[];
+    profile?: AgentProfile;
+}>;
+//# sourceMappingURL=creative.d.ts.map

package/dist/lib/testing/scenarios/creative.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"creative.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/scenarios/creative.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,UAAU,CAAC;AAGtF;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,KAAK,EAAE,cAAc,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC,CA+J9D;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,KAAK,EAAE,cAAc,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC,CA6Q9D"}