@adcp/sdk 12.1.1 → 13.0.0-rc.0

package/dist/lib/testing/scenarios/schema-compliance.js

@@ -189,7 +189,7 @@ async function testSchemaCompliance(agentUrl, options) {
     const { result: formatsResult, step: formatsStep } = await (0, import_client.runStep)(
       "Get creative formats (check assets structure)",
       "list_creative_formats",
-      async () => client.listCreativeFormats({})
+      async () => client.listCreativeFormatsLegacy({})
     );
     if (formatsResult?.success && formatsResult?.data) {
       steps.push((0, import_client.validateResponseSchema)("list_creative_formats", formatsResult.data));

package/dist/lib/testing/scenarios/schema-compliance.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/testing/scenarios/schema-compliance.ts"],"sourcesContent":["/**\n * Schema Compliance Testing\n *\n * Validates that an agent's responses use correct v3 field names and enum values.\n * Uses GET-only operations — no writes required.\n *\n * Checks:\n * - Channel enum values (hard fail on invalid values)\n * - Pricing field names: fixed_price (not fixed_rate), floor_price top-level\n * - Format assets: assets array with required boolean (not assets_required)\n */\n\nimport type { Product } from '../../types/core.generated';\nimport type {\n  GetProductsResponse,\n  GetSignalsResponse,\n  ListCreativeFormatsResponse,\n  Format,\n} from '../../types/tools.generated';\nimport type { TestOptions, TestStepResult, AgentProfile, TaskResult } from '../types';\nimport { getOrCreateClient, runStep, getOrDiscoverProfile, validateResponseSchema } from '../client';\n\n// v3 channel taxonomy — 19 channels\nconst V3_CHANNELS = new Set([\n  'display',\n  'olv',\n  'social',\n  'search',\n  'ctv',\n  'linear_tv',\n  'radio',\n  'streaming_audio',\n  'podcast',\n  'dooh',\n  'ooh',\n  'print',\n  'cinema',\n  'email',\n  'gaming',\n  'retail_media',\n  'influencer',\n  'affiliate',\n  'product_placement',\n]);\n\nexport async function testSchemaCompliance(\n  agentUrl: string,\n  options: TestOptions\n): Promise<{ steps: TestStepResult[]; profile?: AgentProfile }> {\n  const steps: TestStepResult[] = [];\n  const client = getOrCreateClient(agentUrl, options);\n\n  const { profile, step: profileStep } = await getOrDiscoverProfile(client, options);\n  steps.push(profileStep);\n\n  if (!profileStep.passed) {\n    return { steps, profile };\n  }\n\n  if (!profile.tools.includes('get_products') && !profile.tools.includes('get_signals')) {\n    // Path A: no supported discovery tool — skip field-shape checks gracefully\n    steps.push({\n      step: 'Schema compliance check support',\n      passed: true,\n      duration_ms: 0,\n      details: 'Agent does not advertise get_products or get_signals — discovery field-shape checks skipped',\n      warnings: ['Schema compliance: no supported discovery tool (get_products, get_signals) found; checks skipped'],\n    });\n    // Fall through to list_creative_formats check below\n  } else if (profile.tools.includes('get_signals') && !profile.tools.includes('get_products')) {\n    // Path B: signals agent — validate GetSignalsResponse schema and field semantics\n    const { result: signalsResult, step: signalsStep } = await runStep<TaskResult>(\n      'Get signals (schema compliance)',\n      'get_signals',\n      async () =>\n        client.getSignals({\n          signal_spec: options.brief || 'Schema compliance test — retrieve all available signals',\n        }) as Promise<TaskResult>\n    );\n\n    if (!signalsResult?.success || !signalsResult?.data) {\n      signalsStep.passed = false;\n      signalsStep.error = signalsResult?.error || 'get_signals returned no data';\n      steps.push(signalsStep);\n      return { steps, profile };\n    }\n    steps.push(signalsStep);\n\n    const signalsData = signalsResult.data as GetSignalsResponse;\n    // Zod schema validation covers required-field presence (signal_agent_segment_id, name, signal_type).\n    steps.push(validateResponseSchema('get_signals', signalsData));\n\n    const signals = signalsData.signals ?? [];\n    steps.push({\n      step: 'Validate signal required fields',\n      passed: true,\n      duration_ms: 0,\n      details:\n        signals.length === 0\n          ? 'Agent returned no signals — field-shape checks skipped'\n          : `${signals.length} signal(s) validated via schema check (signal_agent_segment_id, name, signal_type)`,\n      warnings:\n        signals.length === 0\n          ? ['No signals returned; cannot validate signal_agent_segment_id, name, signal_type fields']\n          : undefined,\n    });\n    // Fall through to list_creative_formats check below\n  } else {\n    // Path C: get_products present — existing product catalog checks\n    const { result: productsResult, step: productsStep } = await runStep<TaskResult>(\n      'Get products (schema compliance)',\n      'get_products',\n      async () =>\n        client.getProducts({\n          buying_mode: 'brief',\n          brief: options.brief || 'Schema compliance test — retrieve all available products',\n          brand: options.brand,\n        }) as Promise<TaskResult>\n    );\n\n    if (!productsResult?.success || !productsResult?.data) {\n      productsStep.passed = false;\n      productsStep.error = productsResult?.error || 'get_products returned no data';\n      steps.push(productsStep);\n      return { steps, profile };\n    }\n    steps.push(productsStep);\n\n    const data = productsResult.data as GetProductsResponse;\n    const products: Product[] = data.products || [];\n\n    // --- Zod schema validation (catches missing required fields + invalid enum values) ---\n    steps.push(validateResponseSchema('get_products', data));\n\n    if (products.length === 0) {\n      steps.push({\n        step: 'Schema compliance: no products to validate',\n        passed: true,\n        duration_ms: 0,\n        details: 'Agent returned no products — schema compliance checks skipped',\n        warnings: ['No products returned; cannot validate channel, pricing, or format field schemas'],\n      });\n      return { steps, profile };\n    }\n\n    // --- Channel enum validation (hard fail) ---\n    const invalidChannels: string[] = [];\n    const allChannels = new Set<string>();\n\n    for (const product of products) {\n      for (const channel of product.channels || []) {\n        allChannels.add(channel);\n        if (!V3_CHANNELS.has(channel)) {\n          invalidChannels.push(`\"${channel}\" in product ${product.product_id}`);\n        }\n      }\n    }\n\n    steps.push({\n      step: 'Validate channel enum values',\n      passed: invalidChannels.length === 0,\n      duration_ms: 0,\n      details:\n        invalidChannels.length === 0\n          ? `All ${allChannels.size} channel value(s) are valid v3 channels: ${Array.from(allChannels).join(', ')}`\n          : `Invalid channel values detected (not in v3 taxonomy): ${invalidChannels.join('; ')}`,\n      error:\n        invalidChannels.length > 0\n          ? `Channel enum violations: ${invalidChannels.join('; ')}. Valid channels: ${Array.from(V3_CHANNELS).join(', ')}`\n          : undefined,\n      response_preview: JSON.stringify(\n        {\n          channels_found: Array.from(allChannels),\n          invalid_channels: invalidChannels,\n        },\n        null,\n        2\n      ),\n    });\n\n    // --- Pricing field name validation (warn, not fail) ---\n    const pricingIssues: string[] = [];\n    const pricingChecked: string[] = [];\n    let fixedPriceFound = false;\n\n    for (const product of products) {\n      for (const option of product.pricing_options || []) {\n        const optionId = option.pricing_option_id || '(unknown)';\n        // Cast to Record for deprecated-field checks — compliance testing intentionally\n        // probes fields that may not exist on the generated PricingOption union\n        const raw = option as unknown as Record<string, unknown>;\n\n        // Check for deprecated fixed_rate field\n        if ('fixed_rate' in raw) {\n          pricingIssues.push(`pricing_option ${optionId} uses deprecated \"fixed_rate\" — should be \"fixed_price\"`);\n        }\n        if ('fixed_price' in raw) {\n          fixedPriceFound = true;\n          pricingChecked.push(optionId);\n        }\n\n        // Check for floor_price inside price_guidance (deprecated location)\n        const pg = raw.price_guidance as Record<string, unknown> | undefined;\n        if (pg && 'floor' in pg) {\n          pricingIssues.push(\n            `pricing_option ${optionId} has \"floor\" inside price_guidance — should be top-level \"floor_price\"`\n          );\n        }\n        if ('floor_price' in raw) {\n          pricingChecked.push(`${optionId} (floor_price)`);\n        }\n      }\n    }\n\n    const pricingPassed = pricingIssues.length === 0;\n    const pricingDetails =\n      pricingIssues.length > 0\n        ? `Pricing field issues: ${pricingIssues.join('; ')}`\n        : fixedPriceFound\n          ? `Pricing fields valid (checked ${pricingChecked.length} option(s))`\n          : 'No fixed-price products found to validate (agent may be auction-only — cannot confirm field names)';\n\n    steps.push({\n      step: 'Validate pricing field names',\n      passed: pricingPassed,\n      duration_ms: 0,\n      details: pricingDetails,\n      error: pricingIssues.length > 0 ? pricingIssues.join('; ') : undefined,\n      warnings:\n        !fixedPriceFound && pricingIssues.length === 0\n          ? [\n              'No fixed-price products found. If agent supports fixed pricing, verify it uses \"fixed_price\" (not \"fixed_rate\") and \"floor_price\" at the pricing option level (not inside price_guidance).',\n            ]\n          : undefined,\n      response_preview: JSON.stringify(\n        {\n          issues: pricingIssues,\n          options_checked: pricingChecked,\n        },\n        null,\n        2\n      ),\n    });\n  }\n\n  // --- Format assets structure (optional: list_creative_formats) ---\n  // Runs for all agent types that advertise list_creative_formats, regardless of discovery path\n  if (profile.tools.includes('list_creative_formats')) {\n    const { result: formatsResult, step: formatsStep } = await runStep<TaskResult>(\n      'Get creative formats (check assets structure)',\n      'list_creative_formats',\n      async () => client.listCreativeFormats({}) as Promise<TaskResult>\n    );\n\n    if (formatsResult?.success && formatsResult?.data) {\n      steps.push(validateResponseSchema('list_creative_formats', formatsResult.data));\n      const formatsData = formatsResult.data as ListCreativeFormatsResponse;\n      const formats: Format[] = formatsData.formats || [];\n      const assetsIssues: string[] = [];\n      let formatsChecked = 0;\n\n      for (const format of formats) {\n        formatsChecked++;\n        const formatIdStr = typeof format.format_id === 'object' ? format.format_id.id : String(format.format_id);\n        // Check for deprecated assets_required field\n        if ('assets_required' in format) {\n          assetsIssues.push(\n            `format ${formatIdStr} uses deprecated \"assets_required\" — should be \"assets\" array with \"required\" boolean`\n          );\n        }\n        // Validate assets array structure\n        if (Array.isArray(format.assets)) {\n          for (const asset of format.assets) {\n            if (!('required' in asset)) {\n              assetsIssues.push(`format ${formatIdStr} asset missing \"required\" boolean field`);\n            }\n          }\n        }\n      }\n\n      formatsStep.details =\n        assetsIssues.length === 0\n          ? `Format assets valid across ${formatsChecked} format(s)`\n          : `Format asset issues: ${assetsIssues.join('; ')}`;\n      formatsStep.passed = assetsIssues.length === 0;\n      formatsStep.error = assetsIssues.length > 0 ? assetsIssues.join('; ') : undefined;\n    }\n    steps.push(formatsStep);\n  }\n\n  return { steps, profile };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../src/lib/testing/scenarios/schema-compliance.ts"],"sourcesContent":["/**\n * Schema Compliance Testing\n *\n * Validates that an agent's responses use correct v3 field names and enum values.\n * Uses GET-only operations — no writes required.\n *\n * Checks:\n * - Channel enum values (hard fail on invalid values)\n * - Pricing field names: fixed_price (not fixed_rate), floor_price top-level\n * - Format assets: assets array with required boolean (not assets_required)\n */\n\nimport type { Product } from '../../types/core.generated';\nimport type {\n  GetProductsResponse,\n  GetSignalsResponse,\n  ListCreativeFormatsResponse,\n  Format,\n} from '../../types/tools.generated';\nimport type { TestOptions, TestStepResult, AgentProfile, TaskResult } from '../types';\nimport { getOrCreateClient, runStep, getOrDiscoverProfile, validateResponseSchema } from '../client';\n\n// v3 channel taxonomy — 19 channels\nconst V3_CHANNELS = new Set([\n  'display',\n  'olv',\n  'social',\n  'search',\n  'ctv',\n  'linear_tv',\n  'radio',\n  'streaming_audio',\n  'podcast',\n  'dooh',\n  'ooh',\n  'print',\n  'cinema',\n  'email',\n  'gaming',\n  'retail_media',\n  'influencer',\n  'affiliate',\n  'product_placement',\n]);\n\nexport async function testSchemaCompliance(\n  agentUrl: string,\n  options: TestOptions\n): Promise<{ steps: TestStepResult[]; profile?: AgentProfile }> {\n  const steps: TestStepResult[] = [];\n  const client = getOrCreateClient(agentUrl, options);\n\n  const { profile, step: profileStep } = await getOrDiscoverProfile(client, options);\n  steps.push(profileStep);\n\n  if (!profileStep.passed) {\n    return { steps, profile };\n  }\n\n  if (!profile.tools.includes('get_products') && !profile.tools.includes('get_signals')) {\n    // Path A: no supported discovery tool — skip field-shape checks gracefully\n    steps.push({\n      step: 'Schema compliance check support',\n      passed: true,\n      duration_ms: 0,\n      details: 'Agent does not advertise get_products or get_signals — discovery field-shape checks skipped',\n      warnings: ['Schema compliance: no supported discovery tool (get_products, get_signals) found; checks skipped'],\n    });\n    // Fall through to list_creative_formats check below\n  } else if (profile.tools.includes('get_signals') && !profile.tools.includes('get_products')) {\n    // Path B: signals agent — validate GetSignalsResponse schema and field semantics\n    const { result: signalsResult, step: signalsStep } = await runStep<TaskResult>(\n      'Get signals (schema compliance)',\n      'get_signals',\n      async () =>\n        client.getSignals({\n          signal_spec: options.brief || 'Schema compliance test — retrieve all available signals',\n        }) as Promise<TaskResult>\n    );\n\n    if (!signalsResult?.success || !signalsResult?.data) {\n      signalsStep.passed = false;\n      signalsStep.error = signalsResult?.error || 'get_signals returned no data';\n      steps.push(signalsStep);\n      return { steps, profile };\n    }\n    steps.push(signalsStep);\n\n    const signalsData = signalsResult.data as GetSignalsResponse;\n    // Zod schema validation covers required-field presence (signal_agent_segment_id, name, signal_type).\n    steps.push(validateResponseSchema('get_signals', signalsData));\n\n    const signals = signalsData.signals ?? [];\n    steps.push({\n      step: 'Validate signal required fields',\n      passed: true,\n      duration_ms: 0,\n      details:\n        signals.length === 0\n          ? 'Agent returned no signals — field-shape checks skipped'\n          : `${signals.length} signal(s) validated via schema check (signal_agent_segment_id, name, signal_type)`,\n      warnings:\n        signals.length === 0\n          ? ['No signals returned; cannot validate signal_agent_segment_id, name, signal_type fields']\n          : undefined,\n    });\n    // Fall through to list_creative_formats check below\n  } else {\n    // Path C: get_products present — existing product catalog checks\n    const { result: productsResult, step: productsStep } = await runStep<TaskResult>(\n      'Get products (schema compliance)',\n      'get_products',\n      async () =>\n        client.getProducts({\n          buying_mode: 'brief',\n          brief: options.brief || 'Schema compliance test — retrieve all available products',\n          brand: options.brand,\n        }) as Promise<TaskResult>\n    );\n\n    if (!productsResult?.success || !productsResult?.data) {\n      productsStep.passed = false;\n      productsStep.error = productsResult?.error || 'get_products returned no data';\n      steps.push(productsStep);\n      return { steps, profile };\n    }\n    steps.push(productsStep);\n\n    const data = productsResult.data as GetProductsResponse;\n    const products: Product[] = data.products || [];\n\n    // --- Zod schema validation (catches missing required fields + invalid enum values) ---\n    steps.push(validateResponseSchema('get_products', data));\n\n    if (products.length === 0) {\n      steps.push({\n        step: 'Schema compliance: no products to validate',\n        passed: true,\n        duration_ms: 0,\n        details: 'Agent returned no products — schema compliance checks skipped',\n        warnings: ['No products returned; cannot validate channel, pricing, or format field schemas'],\n      });\n      return { steps, profile };\n    }\n\n    // --- Channel enum validation (hard fail) ---\n    const invalidChannels: string[] = [];\n    const allChannels = new Set<string>();\n\n    for (const product of products) {\n      for (const channel of product.channels || []) {\n        allChannels.add(channel);\n        if (!V3_CHANNELS.has(channel)) {\n          invalidChannels.push(`\"${channel}\" in product ${product.product_id}`);\n        }\n      }\n    }\n\n    steps.push({\n      step: 'Validate channel enum values',\n      passed: invalidChannels.length === 0,\n      duration_ms: 0,\n      details:\n        invalidChannels.length === 0\n          ? `All ${allChannels.size} channel value(s) are valid v3 channels: ${Array.from(allChannels).join(', ')}`\n          : `Invalid channel values detected (not in v3 taxonomy): ${invalidChannels.join('; ')}`,\n      error:\n        invalidChannels.length > 0\n          ? `Channel enum violations: ${invalidChannels.join('; ')}. Valid channels: ${Array.from(V3_CHANNELS).join(', ')}`\n          : undefined,\n      response_preview: JSON.stringify(\n        {\n          channels_found: Array.from(allChannels),\n          invalid_channels: invalidChannels,\n        },\n        null,\n        2\n      ),\n    });\n\n    // --- Pricing field name validation (warn, not fail) ---\n    const pricingIssues: string[] = [];\n    const pricingChecked: string[] = [];\n    let fixedPriceFound = false;\n\n    for (const product of products) {\n      for (const option of product.pricing_options || []) {\n        const optionId = option.pricing_option_id || '(unknown)';\n        // Cast to Record for deprecated-field checks — compliance testing intentionally\n        // probes fields that may not exist on the generated PricingOption union\n        const raw = option as unknown as Record<string, unknown>;\n\n        // Check for deprecated fixed_rate field\n        if ('fixed_rate' in raw) {\n          pricingIssues.push(`pricing_option ${optionId} uses deprecated \"fixed_rate\" — should be \"fixed_price\"`);\n        }\n        if ('fixed_price' in raw) {\n          fixedPriceFound = true;\n          pricingChecked.push(optionId);\n        }\n\n        // Check for floor_price inside price_guidance (deprecated location)\n        const pg = raw.price_guidance as Record<string, unknown> | undefined;\n        if (pg && 'floor' in pg) {\n          pricingIssues.push(\n            `pricing_option ${optionId} has \"floor\" inside price_guidance — should be top-level \"floor_price\"`\n          );\n        }\n        if ('floor_price' in raw) {\n          pricingChecked.push(`${optionId} (floor_price)`);\n        }\n      }\n    }\n\n    const pricingPassed = pricingIssues.length === 0;\n    const pricingDetails =\n      pricingIssues.length > 0\n        ? `Pricing field issues: ${pricingIssues.join('; ')}`\n        : fixedPriceFound\n          ? `Pricing fields valid (checked ${pricingChecked.length} option(s))`\n          : 'No fixed-price products found to validate (agent may be auction-only — cannot confirm field names)';\n\n    steps.push({\n      step: 'Validate pricing field names',\n      passed: pricingPassed,\n      duration_ms: 0,\n      details: pricingDetails,\n      error: pricingIssues.length > 0 ? pricingIssues.join('; ') : undefined,\n      warnings:\n        !fixedPriceFound && pricingIssues.length === 0\n          ? [\n              'No fixed-price products found. If agent supports fixed pricing, verify it uses \"fixed_price\" (not \"fixed_rate\") and \"floor_price\" at the pricing option level (not inside price_guidance).',\n            ]\n          : undefined,\n      response_preview: JSON.stringify(\n        {\n          issues: pricingIssues,\n          options_checked: pricingChecked,\n        },\n        null,\n        2\n      ),\n    });\n  }\n\n  // --- Format assets structure (optional: list_creative_formats) ---\n  // Runs for all agent types that advertise list_creative_formats, regardless of discovery path\n  if (profile.tools.includes('list_creative_formats')) {\n    const { result: formatsResult, step: formatsStep } = await runStep<TaskResult>(\n      'Get creative formats (check assets structure)',\n      'list_creative_formats',\n      async () => client.listCreativeFormatsLegacy({}) as Promise<TaskResult>\n    );\n\n    if (formatsResult?.success && formatsResult?.data) {\n      steps.push(validateResponseSchema('list_creative_formats', formatsResult.data));\n      const formatsData = formatsResult.data as ListCreativeFormatsResponse;\n      const formats: Format[] = formatsData.formats || [];\n      const assetsIssues: string[] = [];\n      let formatsChecked = 0;\n\n      for (const format of formats) {\n        formatsChecked++;\n        const formatIdStr = typeof format.format_id === 'object' ? format.format_id.id : String(format.format_id);\n        // Check for deprecated assets_required field\n        if ('assets_required' in format) {\n          assetsIssues.push(\n            `format ${formatIdStr} uses deprecated \"assets_required\" — should be \"assets\" array with \"required\" boolean`\n          );\n        }\n        // Validate assets array structure\n        if (Array.isArray(format.assets)) {\n          for (const asset of format.assets) {\n            if (!('required' in asset)) {\n              assetsIssues.push(`format ${formatIdStr} asset missing \"required\" boolean field`);\n            }\n          }\n        }\n      }\n\n      formatsStep.details =\n        assetsIssues.length === 0\n          ? `Format assets valid across ${formatsChecked} format(s)`\n          : `Format asset issues: ${assetsIssues.join('; ')}`;\n      formatsStep.passed = assetsIssues.length === 0;\n      formatsStep.error = assetsIssues.length > 0 ? assetsIssues.join('; ') : undefined;\n    }\n    steps.push(formatsStep);\n  }\n\n  return { steps, profile };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAoBA,oBAAyF;AAGzF,MAAM,cAAc,oBAAI,IAAI;AAAA,EAC1B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,eAAsB,qBACpB,UACA,SAC8D;AAC9D,QAAM,QAA0B,CAAC;AACjC,QAAM,aAAS,iCAAkB,UAAU,OAAO;AAElD,QAAM,EAAE,SAAS,MAAM,YAAY,IAAI,UAAM,oCAAqB,QAAQ,OAAO;AACjF,QAAM,KAAK,WAAW;AAEtB,MAAI,CAAC,YAAY,QAAQ;AACvB,WAAO,EAAE,OAAO,QAAQ;AAAA,EAC1B;AAEA,MAAI,CAAC,QAAQ,MAAM,SAAS,cAAc,KAAK,CAAC,QAAQ,MAAM,SAAS,aAAa,GAAG;AAErF,UAAM,KAAK;AAAA,MACT,MAAM;AAAA,MACN,QAAQ;AAAA,MACR,aAAa;AAAA,MACb,SAAS;AAAA,MACT,UAAU,CAAC,kGAAkG;AAAA,IAC/G,CAAC;AAAA,EAEH,WAAW,QAAQ,MAAM,SAAS,aAAa,KAAK,CAAC,QAAQ,MAAM,SAAS,cAAc,GAAG;AAE3F,UAAM,EAAE,QAAQ,eAAe,MAAM,YAAY,IAAI,UAAM;AAAA,MACzD;AAAA,MACA;AAAA,MACA,YACE,OAAO,WAAW;AAAA,QAChB,aAAa,QAAQ,SAAS;AAAA,MAChC,CAAC;AAAA,IACL;AAEA,QAAI,CAAC,eAAe,WAAW,CAAC,eAAe,MAAM;AACnD,kBAAY,SAAS;AACrB,kBAAY,QAAQ,eAAe,SAAS;AAC5C,YAAM,KAAK,WAAW;AACtB,aAAO,EAAE,OAAO,QAAQ;AAAA,IAC1B;AACA,UAAM,KAAK,WAAW;AAEtB,UAAM,cAAc,cAAc;AAElC,UAAM,SAAK,sCAAuB,eAAe,WAAW,CAAC;AAE7D,UAAM,UAAU,YAAY,WAAW,CAAC;AACxC,UAAM,KAAK;AAAA,MACT,MAAM;AAAA,MACN,QAAQ;AAAA,MACR,aAAa;AAAA,MACb,SACE,QAAQ,WAAW,IACf,gEACA,GAAG,QAAQ,MAAM;AAAA,MACvB,UACE,QAAQ,WAAW,IACf,CAAC,wFAAwF,IACzF;AAAA,IACR,CAAC;AAAA,EAEH,OAAO;AAEL,UAAM,EAAE,QAAQ,gBAAgB,MAAM,aAAa,IAAI,UAAM;AAAA,MAC3D;AAAA,MACA;AAAA,MACA,YACE,OAAO,YAAY;AAAA,QACjB,aAAa;AAAA,QACb,OAAO,QAAQ,SAAS;AAAA,QACxB,OAAO,QAAQ;AAAA,MACjB,CAAC;AAAA,IACL;AAEA,QAAI,CAAC,gBAAgB,WAAW,CAAC,gBAAgB,MAAM;AACrD,mBAAa,SAAS;AACtB,mBAAa,QAAQ,gBAAgB,SAAS;AAC9C,YAAM,KAAK,YAAY;AACvB,aAAO,EAAE,OAAO,QAAQ;AAAA,IAC1B;AACA,UAAM,KAAK,YAAY;AAEvB,UAAM,OAAO,eAAe;AAC5B,UAAM,WAAsB,KAAK,YAAY,CAAC;AAG9C,UAAM,SAAK,sCAAuB,gBAAgB,IAAI,CAAC;AAEvD,QAAI,SAAS,WAAW,GAAG;AACzB,YAAM,KAAK;AAAA,QACT,MAAM;AAAA,QACN,QAAQ;AAAA,QACR,aAAa;AAAA,QACb,SAAS;AAAA,QACT,UAAU,CAAC,iFAAiF;AAAA,MAC9F,CAAC;AACD,aAAO,EAAE,OAAO,QAAQ;AAAA,IAC1B;AAGA,UAAM,kBAA4B,CAAC;AACnC,UAAM,cAAc,oBAAI,IAAY;AAEpC,eAAW,WAAW,UAAU;AAC9B,iBAAW,WAAW,QAAQ,YAAY,CAAC,GAAG;AAC5C,oBAAY,IAAI,OAAO;AACvB,YAAI,CAAC,YAAY,IAAI,OAAO,GAAG;AAC7B,0BAAgB,KAAK,IAAI,OAAO,gBAAgB,QAAQ,UAAU,EAAE;AAAA,QACtE;AAAA,MACF;AAAA,IACF;AAEA,UAAM,KAAK;AAAA,MACT,MAAM;AAAA,MACN,QAAQ,gBAAgB,WAAW;AAAA,MACnC,aAAa;AAAA,MACb,SACE,gBAAgB,WAAW,IACvB,OAAO,YAAY,IAAI,4CAA4C,MAAM,KAAK,WAAW,EAAE,KAAK,IAAI,CAAC,KACrG,yDAAyD,gBAAgB,KAAK,IAAI,CAAC;AAAA,MACzF,OACE,gBAAgB,SAAS,IACrB,4BAA4B,gBAAgB,KAAK,IAAI,CAAC,qBAAqB,MAAM,KAAK,WAAW,EAAE,KAAK,IAAI,CAAC,KAC7G;AAAA,MACN,kBAAkB,KAAK;AAAA,QACrB;AAAA,UACE,gBAAgB,MAAM,KAAK,WAAW;AAAA,UACtC,kBAAkB;AAAA,QACpB;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF,CAAC;AAGD,UAAM,gBAA0B,CAAC;AACjC,UAAM,iBAA2B,CAAC;AAClC,QAAI,kBAAkB;AAEtB,eAAW,WAAW,UAAU;AAC9B,iBAAW,UAAU,QAAQ,mBAAmB,CAAC,GAAG;AAClD,cAAM,WAAW,OAAO,qBAAqB;AAG7C,cAAM,MAAM;AAGZ,YAAI,gBAAgB,KAAK;AACvB,wBAAc,KAAK,kBAAkB,QAAQ,8DAAyD;AAAA,QACxG;AACA,YAAI,iBAAiB,KAAK;AACxB,4BAAkB;AAClB,yBAAe,KAAK,QAAQ;AAAA,QAC9B;AAGA,cAAM,KAAK,IAAI;AACf,YAAI,MAAM,WAAW,IAAI;AACvB,wBAAc;AAAA,YACZ,kBAAkB,QAAQ;AAAA,UAC5B;AAAA,QACF;AACA,YAAI,iBAAiB,KAAK;AACxB,yBAAe,KAAK,GAAG,QAAQ,gBAAgB;AAAA,QACjD;AAAA,MACF;AAAA,IACF;AAEA,UAAM,gBAAgB,cAAc,WAAW;AAC/C,UAAM,iBACJ,cAAc,SAAS,IACnB,yBAAyB,cAAc,KAAK,IAAI,CAAC,KACjD,kBACE,iCAAiC,eAAe,MAAM,gBACtD;AAER,UAAM,KAAK;AAAA,MACT,MAAM;AAAA,MACN,QAAQ;AAAA,MACR,aAAa;AAAA,MACb,SAAS;AAAA,MACT,OAAO,cAAc,SAAS,IAAI,cAAc,KAAK,IAAI,IAAI;AAAA,MAC7D,UACE,CAAC,mBAAmB,cAAc,WAAW,IACzC;AAAA,QACE;AAAA,MACF,IACA;AAAA,MACN,kBAAkB,KAAK;AAAA,QACrB;AAAA,UACE,QAAQ;AAAA,UACR,iBAAiB;AAAA,QACnB;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH;AAIA,MAAI,QAAQ,MAAM,SAAS,uBAAuB,GAAG;AACnD,UAAM,EAAE,QAAQ,eAAe,MAAM,YAAY,IAAI,UAAM;AAAA,MACzD;AAAA,MACA;AAAA,MACA,YAAY,OAAO,0BAA0B,CAAC,CAAC;AAAA,IACjD;AAEA,QAAI,eAAe,WAAW,eAAe,MAAM;AACjD,YAAM,SAAK,sCAAuB,yBAAyB,cAAc,IAAI,CAAC;AAC9E,YAAM,cAAc,cAAc;AAClC,YAAM,UAAoB,YAAY,WAAW,CAAC;AAClD,YAAM,eAAyB,CAAC;AAChC,UAAI,iBAAiB;AAErB,iBAAW,UAAU,SAAS;AAC5B;AACA,cAAM,cAAc,OAAO,OAAO,cAAc,WAAW,OAAO,UAAU,KAAK,OAAO,OAAO,SAAS;AAExG,YAAI,qBAAqB,QAAQ;AAC/B,uBAAa;AAAA,YACX,UAAU,WAAW;AAAA,UACvB;AAAA,QACF;AAEA,YAAI,MAAM,QAAQ,OAAO,MAAM,GAAG;AAChC,qBAAW,SAAS,OAAO,QAAQ;AACjC,gBAAI,EAAE,cAAc,QAAQ;AAC1B,2BAAa,KAAK,UAAU,WAAW,yCAAyC;AAAA,YAClF;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAEA,kBAAY,UACV,aAAa,WAAW,IACpB,8BAA8B,cAAc,eAC5C,wBAAwB,aAAa,KAAK,IAAI,CAAC;AACrD,kBAAY,SAAS,aAAa,WAAW;AAC7C,kBAAY,QAAQ,aAAa,SAAS,IAAI,aAAa,KAAK,IAAI,IAAI;AAAA,IAC1E;AACA,UAAM,KAAK,WAAW;AAAA,EACxB;AAEA,SAAO,EAAE,OAAO,QAAQ;AAC1B;","names":[]}

package/dist/lib/testing/scenarios/schema-compliance.mjs

@@ -166,7 +166,7 @@ async function testSchemaCompliance(agentUrl, options) {
     const { result: formatsResult, step: formatsStep } = await runStep(
       "Get creative formats (check assets structure)",
       "list_creative_formats",
-      async () => client.listCreativeFormats({})
+      async () => client.listCreativeFormatsLegacy({})
     );
     if (formatsResult?.success && formatsResult?.data) {
       steps.push(validateResponseSchema("list_creative_formats", formatsResult.data));

package/dist/lib/testing/scenarios/schema-compliance.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/testing/scenarios/schema-compliance.ts"],"sourcesContent":["/**\n * Schema Compliance Testing\n *\n * Validates that an agent's responses use correct v3 field names and enum values.\n * Uses GET-only operations — no writes required.\n *\n * Checks:\n * - Channel enum values (hard fail on invalid values)\n * - Pricing field names: fixed_price (not fixed_rate), floor_price top-level\n * - Format assets: assets array with required boolean (not assets_required)\n */\n\nimport type { Product } from '../../types/core.generated';\nimport type {\n  GetProductsResponse,\n  GetSignalsResponse,\n  ListCreativeFormatsResponse,\n  Format,\n} from '../../types/tools.generated';\nimport type { TestOptions, TestStepResult, AgentProfile, TaskResult } from '../types';\nimport { getOrCreateClient, runStep, getOrDiscoverProfile, validateResponseSchema } from '../client';\n\n// v3 channel taxonomy — 19 channels\nconst V3_CHANNELS = new Set([\n  'display',\n  'olv',\n  'social',\n  'search',\n  'ctv',\n  'linear_tv',\n  'radio',\n  'streaming_audio',\n  'podcast',\n  'dooh',\n  'ooh',\n  'print',\n  'cinema',\n  'email',\n  'gaming',\n  'retail_media',\n  'influencer',\n  'affiliate',\n  'product_placement',\n]);\n\nexport async function testSchemaCompliance(\n  agentUrl: string,\n  options: TestOptions\n): Promise<{ steps: TestStepResult[]; profile?: AgentProfile }> {\n  const steps: TestStepResult[] = [];\n  const client = getOrCreateClient(agentUrl, options);\n\n  const { profile, step: profileStep } = await getOrDiscoverProfile(client, options);\n  steps.push(profileStep);\n\n  if (!profileStep.passed) {\n    return { steps, profile };\n  }\n\n  if (!profile.tools.includes('get_products') && !profile.tools.includes('get_signals')) {\n    // Path A: no supported discovery tool — skip field-shape checks gracefully\n    steps.push({\n      step: 'Schema compliance check support',\n      passed: true,\n      duration_ms: 0,\n      details: 'Agent does not advertise get_products or get_signals — discovery field-shape checks skipped',\n      warnings: ['Schema compliance: no supported discovery tool (get_products, get_signals) found; checks skipped'],\n    });\n    // Fall through to list_creative_formats check below\n  } else if (profile.tools.includes('get_signals') && !profile.tools.includes('get_products')) {\n    // Path B: signals agent — validate GetSignalsResponse schema and field semantics\n    const { result: signalsResult, step: signalsStep } = await runStep<TaskResult>(\n      'Get signals (schema compliance)',\n      'get_signals',\n      async () =>\n        client.getSignals({\n          signal_spec: options.brief || 'Schema compliance test — retrieve all available signals',\n        }) as Promise<TaskResult>\n    );\n\n    if (!signalsResult?.success || !signalsResult?.data) {\n      signalsStep.passed = false;\n      signalsStep.error = signalsResult?.error || 'get_signals returned no data';\n      steps.push(signalsStep);\n      return { steps, profile };\n    }\n    steps.push(signalsStep);\n\n    const signalsData = signalsResult.data as GetSignalsResponse;\n    // Zod schema validation covers required-field presence (signal_agent_segment_id, name, signal_type).\n    steps.push(validateResponseSchema('get_signals', signalsData));\n\n    const signals = signalsData.signals ?? [];\n    steps.push({\n      step: 'Validate signal required fields',\n      passed: true,\n      duration_ms: 0,\n      details:\n        signals.length === 0\n          ? 'Agent returned no signals — field-shape checks skipped'\n          : `${signals.length} signal(s) validated via schema check (signal_agent_segment_id, name, signal_type)`,\n      warnings:\n        signals.length === 0\n          ? ['No signals returned; cannot validate signal_agent_segment_id, name, signal_type fields']\n          : undefined,\n    });\n    // Fall through to list_creative_formats check below\n  } else {\n    // Path C: get_products present — existing product catalog checks\n    const { result: productsResult, step: productsStep } = await runStep<TaskResult>(\n      'Get products (schema compliance)',\n      'get_products',\n      async () =>\n        client.getProducts({\n          buying_mode: 'brief',\n          brief: options.brief || 'Schema compliance test — retrieve all available products',\n          brand: options.brand,\n        }) as Promise<TaskResult>\n    );\n\n    if (!productsResult?.success || !productsResult?.data) {\n      productsStep.passed = false;\n      productsStep.error = productsResult?.error || 'get_products returned no data';\n      steps.push(productsStep);\n      return { steps, profile };\n    }\n    steps.push(productsStep);\n\n    const data = productsResult.data as GetProductsResponse;\n    const products: Product[] = data.products || [];\n\n    // --- Zod schema validation (catches missing required fields + invalid enum values) ---\n    steps.push(validateResponseSchema('get_products', data));\n\n    if (products.length === 0) {\n      steps.push({\n        step: 'Schema compliance: no products to validate',\n        passed: true,\n        duration_ms: 0,\n        details: 'Agent returned no products — schema compliance checks skipped',\n        warnings: ['No products returned; cannot validate channel, pricing, or format field schemas'],\n      });\n      return { steps, profile };\n    }\n\n    // --- Channel enum validation (hard fail) ---\n    const invalidChannels: string[] = [];\n    const allChannels = new Set<string>();\n\n    for (const product of products) {\n      for (const channel of product.channels || []) {\n        allChannels.add(channel);\n        if (!V3_CHANNELS.has(channel)) {\n          invalidChannels.push(`\"${channel}\" in product ${product.product_id}`);\n        }\n      }\n    }\n\n    steps.push({\n      step: 'Validate channel enum values',\n      passed: invalidChannels.length === 0,\n      duration_ms: 0,\n      details:\n        invalidChannels.length === 0\n          ? `All ${allChannels.size} channel value(s) are valid v3 channels: ${Array.from(allChannels).join(', ')}`\n          : `Invalid channel values detected (not in v3 taxonomy): ${invalidChannels.join('; ')}`,\n      error:\n        invalidChannels.length > 0\n          ? `Channel enum violations: ${invalidChannels.join('; ')}. Valid channels: ${Array.from(V3_CHANNELS).join(', ')}`\n          : undefined,\n      response_preview: JSON.stringify(\n        {\n          channels_found: Array.from(allChannels),\n          invalid_channels: invalidChannels,\n        },\n        null,\n        2\n      ),\n    });\n\n    // --- Pricing field name validation (warn, not fail) ---\n    const pricingIssues: string[] = [];\n    const pricingChecked: string[] = [];\n    let fixedPriceFound = false;\n\n    for (const product of products) {\n      for (const option of product.pricing_options || []) {\n        const optionId = option.pricing_option_id || '(unknown)';\n        // Cast to Record for deprecated-field checks — compliance testing intentionally\n        // probes fields that may not exist on the generated PricingOption union\n        const raw = option as unknown as Record<string, unknown>;\n\n        // Check for deprecated fixed_rate field\n        if ('fixed_rate' in raw) {\n          pricingIssues.push(`pricing_option ${optionId} uses deprecated \"fixed_rate\" — should be \"fixed_price\"`);\n        }\n        if ('fixed_price' in raw) {\n          fixedPriceFound = true;\n          pricingChecked.push(optionId);\n        }\n\n        // Check for floor_price inside price_guidance (deprecated location)\n        const pg = raw.price_guidance as Record<string, unknown> | undefined;\n        if (pg && 'floor' in pg) {\n          pricingIssues.push(\n            `pricing_option ${optionId} has \"floor\" inside price_guidance — should be top-level \"floor_price\"`\n          );\n        }\n        if ('floor_price' in raw) {\n          pricingChecked.push(`${optionId} (floor_price)`);\n        }\n      }\n    }\n\n    const pricingPassed = pricingIssues.length === 0;\n    const pricingDetails =\n      pricingIssues.length > 0\n        ? `Pricing field issues: ${pricingIssues.join('; ')}`\n        : fixedPriceFound\n          ? `Pricing fields valid (checked ${pricingChecked.length} option(s))`\n          : 'No fixed-price products found to validate (agent may be auction-only — cannot confirm field names)';\n\n    steps.push({\n      step: 'Validate pricing field names',\n      passed: pricingPassed,\n      duration_ms: 0,\n      details: pricingDetails,\n      error: pricingIssues.length > 0 ? pricingIssues.join('; ') : undefined,\n      warnings:\n        !fixedPriceFound && pricingIssues.length === 0\n          ? [\n              'No fixed-price products found. If agent supports fixed pricing, verify it uses \"fixed_price\" (not \"fixed_rate\") and \"floor_price\" at the pricing option level (not inside price_guidance).',\n            ]\n          : undefined,\n      response_preview: JSON.stringify(\n        {\n          issues: pricingIssues,\n          options_checked: pricingChecked,\n        },\n        null,\n        2\n      ),\n    });\n  }\n\n  // --- Format assets structure (optional: list_creative_formats) ---\n  // Runs for all agent types that advertise list_creative_formats, regardless of discovery path\n  if (profile.tools.includes('list_creative_formats')) {\n    const { result: formatsResult, step: formatsStep } = await runStep<TaskResult>(\n      'Get creative formats (check assets structure)',\n      'list_creative_formats',\n      async () => client.listCreativeFormats({}) as Promise<TaskResult>\n    );\n\n    if (formatsResult?.success && formatsResult?.data) {\n      steps.push(validateResponseSchema('list_creative_formats', formatsResult.data));\n      const formatsData = formatsResult.data as ListCreativeFormatsResponse;\n      const formats: Format[] = formatsData.formats || [];\n      const assetsIssues: string[] = [];\n      let formatsChecked = 0;\n\n      for (const format of formats) {\n        formatsChecked++;\n        const formatIdStr = typeof format.format_id === 'object' ? format.format_id.id : String(format.format_id);\n        // Check for deprecated assets_required field\n        if ('assets_required' in format) {\n          assetsIssues.push(\n            `format ${formatIdStr} uses deprecated \"assets_required\" — should be \"assets\" array with \"required\" boolean`\n          );\n        }\n        // Validate assets array structure\n        if (Array.isArray(format.assets)) {\n          for (const asset of format.assets) {\n            if (!('required' in asset)) {\n              assetsIssues.push(`format ${formatIdStr} asset missing \"required\" boolean field`);\n            }\n          }\n        }\n      }\n\n      formatsStep.details =\n        assetsIssues.length === 0\n          ? `Format assets valid across ${formatsChecked} format(s)`\n          : `Format asset issues: ${assetsIssues.join('; ')}`;\n      formatsStep.passed = assetsIssues.length === 0;\n      formatsStep.error = assetsIssues.length > 0 ? assetsIssues.join('; ') : undefined;\n    }\n    steps.push(formatsStep);\n  }\n\n  return { steps, profile };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../src/lib/testing/scenarios/schema-compliance.ts"],"sourcesContent":["/**\n * Schema Compliance Testing\n *\n * Validates that an agent's responses use correct v3 field names and enum values.\n * Uses GET-only operations — no writes required.\n *\n * Checks:\n * - Channel enum values (hard fail on invalid values)\n * - Pricing field names: fixed_price (not fixed_rate), floor_price top-level\n * - Format assets: assets array with required boolean (not assets_required)\n */\n\nimport type { Product } from '../../types/core.generated';\nimport type {\n  GetProductsResponse,\n  GetSignalsResponse,\n  ListCreativeFormatsResponse,\n  Format,\n} from '../../types/tools.generated';\nimport type { TestOptions, TestStepResult, AgentProfile, TaskResult } from '../types';\nimport { getOrCreateClient, runStep, getOrDiscoverProfile, validateResponseSchema } from '../client';\n\n// v3 channel taxonomy — 19 channels\nconst V3_CHANNELS = new Set([\n  'display',\n  'olv',\n  'social',\n  'search',\n  'ctv',\n  'linear_tv',\n  'radio',\n  'streaming_audio',\n  'podcast',\n  'dooh',\n  'ooh',\n  'print',\n  'cinema',\n  'email',\n  'gaming',\n  'retail_media',\n  'influencer',\n  'affiliate',\n  'product_placement',\n]);\n\nexport async function testSchemaCompliance(\n  agentUrl: string,\n  options: TestOptions\n): Promise<{ steps: TestStepResult[]; profile?: AgentProfile }> {\n  const steps: TestStepResult[] = [];\n  const client = getOrCreateClient(agentUrl, options);\n\n  const { profile, step: profileStep } = await getOrDiscoverProfile(client, options);\n  steps.push(profileStep);\n\n  if (!profileStep.passed) {\n    return { steps, profile };\n  }\n\n  if (!profile.tools.includes('get_products') && !profile.tools.includes('get_signals')) {\n    // Path A: no supported discovery tool — skip field-shape checks gracefully\n    steps.push({\n      step: 'Schema compliance check support',\n      passed: true,\n      duration_ms: 0,\n      details: 'Agent does not advertise get_products or get_signals — discovery field-shape checks skipped',\n      warnings: ['Schema compliance: no supported discovery tool (get_products, get_signals) found; checks skipped'],\n    });\n    // Fall through to list_creative_formats check below\n  } else if (profile.tools.includes('get_signals') && !profile.tools.includes('get_products')) {\n    // Path B: signals agent — validate GetSignalsResponse schema and field semantics\n    const { result: signalsResult, step: signalsStep } = await runStep<TaskResult>(\n      'Get signals (schema compliance)',\n      'get_signals',\n      async () =>\n        client.getSignals({\n          signal_spec: options.brief || 'Schema compliance test — retrieve all available signals',\n        }) as Promise<TaskResult>\n    );\n\n    if (!signalsResult?.success || !signalsResult?.data) {\n      signalsStep.passed = false;\n      signalsStep.error = signalsResult?.error || 'get_signals returned no data';\n      steps.push(signalsStep);\n      return { steps, profile };\n    }\n    steps.push(signalsStep);\n\n    const signalsData = signalsResult.data as GetSignalsResponse;\n    // Zod schema validation covers required-field presence (signal_agent_segment_id, name, signal_type).\n    steps.push(validateResponseSchema('get_signals', signalsData));\n\n    const signals = signalsData.signals ?? [];\n    steps.push({\n      step: 'Validate signal required fields',\n      passed: true,\n      duration_ms: 0,\n      details:\n        signals.length === 0\n          ? 'Agent returned no signals — field-shape checks skipped'\n          : `${signals.length} signal(s) validated via schema check (signal_agent_segment_id, name, signal_type)`,\n      warnings:\n        signals.length === 0\n          ? ['No signals returned; cannot validate signal_agent_segment_id, name, signal_type fields']\n          : undefined,\n    });\n    // Fall through to list_creative_formats check below\n  } else {\n    // Path C: get_products present — existing product catalog checks\n    const { result: productsResult, step: productsStep } = await runStep<TaskResult>(\n      'Get products (schema compliance)',\n      'get_products',\n      async () =>\n        client.getProducts({\n          buying_mode: 'brief',\n          brief: options.brief || 'Schema compliance test — retrieve all available products',\n          brand: options.brand,\n        }) as Promise<TaskResult>\n    );\n\n    if (!productsResult?.success || !productsResult?.data) {\n      productsStep.passed = false;\n      productsStep.error = productsResult?.error || 'get_products returned no data';\n      steps.push(productsStep);\n      return { steps, profile };\n    }\n    steps.push(productsStep);\n\n    const data = productsResult.data as GetProductsResponse;\n    const products: Product[] = data.products || [];\n\n    // --- Zod schema validation (catches missing required fields + invalid enum values) ---\n    steps.push(validateResponseSchema('get_products', data));\n\n    if (products.length === 0) {\n      steps.push({\n        step: 'Schema compliance: no products to validate',\n        passed: true,\n        duration_ms: 0,\n        details: 'Agent returned no products — schema compliance checks skipped',\n        warnings: ['No products returned; cannot validate channel, pricing, or format field schemas'],\n      });\n      return { steps, profile };\n    }\n\n    // --- Channel enum validation (hard fail) ---\n    const invalidChannels: string[] = [];\n    const allChannels = new Set<string>();\n\n    for (const product of products) {\n      for (const channel of product.channels || []) {\n        allChannels.add(channel);\n        if (!V3_CHANNELS.has(channel)) {\n          invalidChannels.push(`\"${channel}\" in product ${product.product_id}`);\n        }\n      }\n    }\n\n    steps.push({\n      step: 'Validate channel enum values',\n      passed: invalidChannels.length === 0,\n      duration_ms: 0,\n      details:\n        invalidChannels.length === 0\n          ? `All ${allChannels.size} channel value(s) are valid v3 channels: ${Array.from(allChannels).join(', ')}`\n          : `Invalid channel values detected (not in v3 taxonomy): ${invalidChannels.join('; ')}`,\n      error:\n        invalidChannels.length > 0\n          ? `Channel enum violations: ${invalidChannels.join('; ')}. Valid channels: ${Array.from(V3_CHANNELS).join(', ')}`\n          : undefined,\n      response_preview: JSON.stringify(\n        {\n          channels_found: Array.from(allChannels),\n          invalid_channels: invalidChannels,\n        },\n        null,\n        2\n      ),\n    });\n\n    // --- Pricing field name validation (warn, not fail) ---\n    const pricingIssues: string[] = [];\n    const pricingChecked: string[] = [];\n    let fixedPriceFound = false;\n\n    for (const product of products) {\n      for (const option of product.pricing_options || []) {\n        const optionId = option.pricing_option_id || '(unknown)';\n        // Cast to Record for deprecated-field checks — compliance testing intentionally\n        // probes fields that may not exist on the generated PricingOption union\n        const raw = option as unknown as Record<string, unknown>;\n\n        // Check for deprecated fixed_rate field\n        if ('fixed_rate' in raw) {\n          pricingIssues.push(`pricing_option ${optionId} uses deprecated \"fixed_rate\" — should be \"fixed_price\"`);\n        }\n        if ('fixed_price' in raw) {\n          fixedPriceFound = true;\n          pricingChecked.push(optionId);\n        }\n\n        // Check for floor_price inside price_guidance (deprecated location)\n        const pg = raw.price_guidance as Record<string, unknown> | undefined;\n        if (pg && 'floor' in pg) {\n          pricingIssues.push(\n            `pricing_option ${optionId} has \"floor\" inside price_guidance — should be top-level \"floor_price\"`\n          );\n        }\n        if ('floor_price' in raw) {\n          pricingChecked.push(`${optionId} (floor_price)`);\n        }\n      }\n    }\n\n    const pricingPassed = pricingIssues.length === 0;\n    const pricingDetails =\n      pricingIssues.length > 0\n        ? `Pricing field issues: ${pricingIssues.join('; ')}`\n        : fixedPriceFound\n          ? `Pricing fields valid (checked ${pricingChecked.length} option(s))`\n          : 'No fixed-price products found to validate (agent may be auction-only — cannot confirm field names)';\n\n    steps.push({\n      step: 'Validate pricing field names',\n      passed: pricingPassed,\n      duration_ms: 0,\n      details: pricingDetails,\n      error: pricingIssues.length > 0 ? pricingIssues.join('; ') : undefined,\n      warnings:\n        !fixedPriceFound && pricingIssues.length === 0\n          ? [\n              'No fixed-price products found. If agent supports fixed pricing, verify it uses \"fixed_price\" (not \"fixed_rate\") and \"floor_price\" at the pricing option level (not inside price_guidance).',\n            ]\n          : undefined,\n      response_preview: JSON.stringify(\n        {\n          issues: pricingIssues,\n          options_checked: pricingChecked,\n        },\n        null,\n        2\n      ),\n    });\n  }\n\n  // --- Format assets structure (optional: list_creative_formats) ---\n  // Runs for all agent types that advertise list_creative_formats, regardless of discovery path\n  if (profile.tools.includes('list_creative_formats')) {\n    const { result: formatsResult, step: formatsStep } = await runStep<TaskResult>(\n      'Get creative formats (check assets structure)',\n      'list_creative_formats',\n      async () => client.listCreativeFormatsLegacy({}) as Promise<TaskResult>\n    );\n\n    if (formatsResult?.success && formatsResult?.data) {\n      steps.push(validateResponseSchema('list_creative_formats', formatsResult.data));\n      const formatsData = formatsResult.data as ListCreativeFormatsResponse;\n      const formats: Format[] = formatsData.formats || [];\n      const assetsIssues: string[] = [];\n      let formatsChecked = 0;\n\n      for (const format of formats) {\n        formatsChecked++;\n        const formatIdStr = typeof format.format_id === 'object' ? format.format_id.id : String(format.format_id);\n        // Check for deprecated assets_required field\n        if ('assets_required' in format) {\n          assetsIssues.push(\n            `format ${formatIdStr} uses deprecated \"assets_required\" — should be \"assets\" array with \"required\" boolean`\n          );\n        }\n        // Validate assets array structure\n        if (Array.isArray(format.assets)) {\n          for (const asset of format.assets) {\n            if (!('required' in asset)) {\n              assetsIssues.push(`format ${formatIdStr} asset missing \"required\" boolean field`);\n            }\n          }\n        }\n      }\n\n      formatsStep.details =\n        assetsIssues.length === 0\n          ? `Format assets valid across ${formatsChecked} format(s)`\n          : `Format asset issues: ${assetsIssues.join('; ')}`;\n      formatsStep.passed = assetsIssues.length === 0;\n      formatsStep.error = assetsIssues.length > 0 ? assetsIssues.join('; ') : undefined;\n    }\n    steps.push(formatsStep);\n  }\n\n  return { steps, profile };\n}\n"],"mappings":"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","names":[]}

package/dist/lib/testing/scenarios/trusted-match.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trusted-match.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/scenarios/trusted-match.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,UAAU,CAAC;AAItF;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,KAAK,EAAE,cAAc,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC,CA4H9D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAE7D"}
+{"version":3,"file":"trusted-match.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/scenarios/trusted-match.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,UAAU,CAAC;AAItF;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,KAAK,EAAE,cAAc,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC,CA6H9D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAE7D"}

package/dist/lib/testing/scenarios/trusted-match.js

@@ -51,8 +51,9 @@ async function testTrustedMatchFlow(agentUrl, options) {
         type: "context_match_request",
         request_id: `e2e-ctx-${Date.now()}`,
         property_rid: "00000000-0000-7000-0000-000000000001",
-        property_type: "web",
+        property_type: "website",
         placement_id: "e2e-test-placement",
+        seller_agent_url: agentUrl,
         context_signals: {
           topics: ["632"],
           taxonomy_source: "iab",
@@ -100,8 +101,8 @@ async function testTrustedMatchFlow(agentUrl, options) {
       async () => client.executeTask("identity_match", {
         type: "identity_match_request",
         request_id: `e2e-id-${Date.now()}`,
-        user_token: "e2e-test-opaque-token",
-        uid_type: "publisher_first_party",
+        seller_agent_url: agentUrl,
+        identities: [{ user_token: "e2e-test-opaque-token", uid_type: "publisher_first_party" }],
         package_ids: ["e2e-test-package-001", "e2e-test-package-002"],
         consent: {
           gdpr: false

package/dist/lib/testing/scenarios/trusted-match.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/testing/scenarios/trusted-match.ts"],"sourcesContent":["/**\n * Trusted Match Protocol (TMP) Testing Scenarios (v3)\n *\n * Tests TMP agent capabilities including:\n * - context_match — evaluates packages against content context (no user identity)\n * - identity_match — evaluates user eligibility for packages using an opaque identity token (no page context)\n */\n\nimport type { TestOptions, TestStepResult, AgentProfile, TaskResult } from '../types';\nimport { getOrCreateClient, runStep, getOrDiscoverProfile } from '../client';\nimport { TRUSTED_MATCH_TOOLS } from '../../utils/capabilities';\n\n/**\n * Test: Trusted Match Flow\n *\n * Flow: discover profile -> check TMP tools -> context_match -> identity_match\n */\nexport async function testTrustedMatchFlow(\n  agentUrl: string,\n  options: TestOptions\n): Promise<{ steps: TestStepResult[]; profile?: AgentProfile }> {\n  const steps: TestStepResult[] = [];\n  const client = getOrCreateClient(agentUrl, options);\n\n  // Discover agent profile\n  const { profile, step: profileStep } = await getOrDiscoverProfile(client, options);\n  steps.push(profileStep);\n\n  if (!profileStep.passed) {\n    return { steps, profile };\n  }\n\n  // Check if agent supports any TMP tools\n  const hasTMP = TRUSTED_MATCH_TOOLS.some(t => profile.tools.includes(t));\n  if (!hasTMP) {\n    steps.push({\n      step: 'TMP support check',\n      passed: false,\n      duration_ms: 0,\n      error: 'Agent does not support Trusted Match Protocol tools',\n      details: `Required tools: ${TRUSTED_MATCH_TOOLS.join(', ')}. Available: ${profile.tools.join(', ')}`,\n    });\n    return { steps, profile };\n  }\n\n  // Test: context_match\n  if (profile.tools.includes('context_match')) {\n    const { result, step } = await runStep<TaskResult>(\n      'Context match: evaluate packages against page context',\n      'context_match',\n      async () =>\n        client.executeTask('context_match', {\n          type: 'context_match_request',\n          request_id: `e2e-ctx-${Date.now()}`,\n          property_rid: '00000000-0000-7000-0000-000000000001',\n          property_type: 'web',\n          placement_id: 'e2e-test-placement',\n          context_signals: {\n            topics: ['632'],\n            taxonomy_source: 'iab',\n            taxonomy_id: 7,\n            sentiment: 'positive',\n            keywords: ['technology', 'innovation'],\n            language: 'en',\n          },\n          geo: {\n            country: 'US',\n            region: 'US-CA',\n          },\n        }) as Promise<TaskResult>\n    );\n\n    if (result?.success && result?.data) {\n      const data = result.data as Record<string, unknown>;\n      const offers = Array.isArray(data['offers']) ? data['offers'] : [];\n      step.details = `Context match returned ${offers.length} offer(s)`;\n      step.response_preview = JSON.stringify(\n        {\n          request_id: data['request_id'],\n          offers_count: offers.length,\n          cache_ttl: data['cache_ttl'],\n          has_signals: !!data['signals'],\n        },\n        null,\n        2\n      );\n    } else if (result && !result.success) {\n      const error = result.error || '';\n      if (error.includes('not supported') || error.includes('not implemented')) {\n        step.passed = true;\n        step.details = 'Context match not supported by this agent (expected for some agents)';\n      } else {\n        step.passed = false;\n        step.error = result.error || 'context_match failed';\n      }\n    }\n    steps.push(step);\n  }\n\n  // Test: identity_match\n  if (profile.tools.includes('identity_match')) {\n    const { result, step } = await runStep<TaskResult>(\n      'Identity match: evaluate user eligibility for packages',\n      'identity_match',\n      async () =>\n        client.executeTask('identity_match', {\n          type: 'identity_match_request',\n          request_id: `e2e-id-${Date.now()}`,\n          user_token: 'e2e-test-opaque-token',\n          uid_type: 'publisher_first_party',\n          package_ids: ['e2e-test-package-001', 'e2e-test-package-002'],\n          consent: {\n            gdpr: false,\n          },\n        }) as Promise<TaskResult>\n    );\n\n    if (result?.success && result?.data) {\n      const data = result.data as Record<string, unknown>;\n      const eligibleIds = Array.isArray(data['eligible_package_ids']) ? data['eligible_package_ids'] : [];\n      step.details = `Identity match returned ${eligibleIds.length} eligible package(s)`;\n      step.response_preview = JSON.stringify(\n        {\n          request_id: data['request_id'],\n          eligible_package_ids: eligibleIds,\n          ttl_sec: data['ttl_sec'],\n        },\n        null,\n        2\n      );\n    } else if (result && !result.success) {\n      const error = result.error || '';\n      if (error.includes('not supported') || error.includes('not implemented')) {\n        step.passed = true;\n        step.details = 'Identity match not supported by this agent (expected for some agents)';\n      } else {\n        step.passed = false;\n        step.error = result.error || 'identity_match failed';\n      }\n    }\n    steps.push(step);\n  }\n\n  return { steps, profile };\n}\n\n/**\n * Check if agent has any TMP tools\n */\nexport function hasTrustedMatchTools(tools: string[]): boolean {\n  return TRUSTED_MATCH_TOOLS.some(t => tools.includes(t));\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../src/lib/testing/scenarios/trusted-match.ts"],"sourcesContent":["/**\n * Trusted Match Protocol (TMP) Testing Scenarios (v3)\n *\n * Tests TMP agent capabilities including:\n * - context_match — evaluates packages against content context (no user identity)\n * - identity_match — evaluates user eligibility for packages using an opaque identity token (no page context)\n */\n\nimport type { TestOptions, TestStepResult, AgentProfile, TaskResult } from '../types';\nimport { getOrCreateClient, runStep, getOrDiscoverProfile } from '../client';\nimport { TRUSTED_MATCH_TOOLS } from '../../utils/capabilities';\n\n/**\n * Test: Trusted Match Flow\n *\n * Flow: discover profile -> check TMP tools -> context_match -> identity_match\n */\nexport async function testTrustedMatchFlow(\n  agentUrl: string,\n  options: TestOptions\n): Promise<{ steps: TestStepResult[]; profile?: AgentProfile }> {\n  const steps: TestStepResult[] = [];\n  const client = getOrCreateClient(agentUrl, options);\n\n  // Discover agent profile\n  const { profile, step: profileStep } = await getOrDiscoverProfile(client, options);\n  steps.push(profileStep);\n\n  if (!profileStep.passed) {\n    return { steps, profile };\n  }\n\n  // Check if agent supports any TMP tools\n  const hasTMP = TRUSTED_MATCH_TOOLS.some(t => profile.tools.includes(t));\n  if (!hasTMP) {\n    steps.push({\n      step: 'TMP support check',\n      passed: false,\n      duration_ms: 0,\n      error: 'Agent does not support Trusted Match Protocol tools',\n      details: `Required tools: ${TRUSTED_MATCH_TOOLS.join(', ')}. Available: ${profile.tools.join(', ')}`,\n    });\n    return { steps, profile };\n  }\n\n  // Test: context_match\n  if (profile.tools.includes('context_match')) {\n    const { result, step } = await runStep<TaskResult>(\n      'Context match: evaluate packages against page context',\n      'context_match',\n      async () =>\n        client.executeTask('context_match', {\n          type: 'context_match_request',\n          request_id: `e2e-ctx-${Date.now()}`,\n          property_rid: '00000000-0000-7000-0000-000000000001',\n          property_type: 'website',\n          placement_id: 'e2e-test-placement',\n          seller_agent_url: agentUrl,\n          context_signals: {\n            topics: ['632'],\n            taxonomy_source: 'iab',\n            taxonomy_id: 7,\n            sentiment: 'positive',\n            keywords: ['technology', 'innovation'],\n            language: 'en',\n          },\n          geo: {\n            country: 'US',\n            region: 'US-CA',\n          },\n        }) as Promise<TaskResult>\n    );\n\n    if (result?.success && result?.data) {\n      const data = result.data as Record<string, unknown>;\n      const offers = Array.isArray(data['offers']) ? data['offers'] : [];\n      step.details = `Context match returned ${offers.length} offer(s)`;\n      step.response_preview = JSON.stringify(\n        {\n          request_id: data['request_id'],\n          offers_count: offers.length,\n          cache_ttl: data['cache_ttl'],\n          has_signals: !!data['signals'],\n        },\n        null,\n        2\n      );\n    } else if (result && !result.success) {\n      const error = result.error || '';\n      if (error.includes('not supported') || error.includes('not implemented')) {\n        step.passed = true;\n        step.details = 'Context match not supported by this agent (expected for some agents)';\n      } else {\n        step.passed = false;\n        step.error = result.error || 'context_match failed';\n      }\n    }\n    steps.push(step);\n  }\n\n  // Test: identity_match\n  if (profile.tools.includes('identity_match')) {\n    const { result, step } = await runStep<TaskResult>(\n      'Identity match: evaluate user eligibility for packages',\n      'identity_match',\n      async () =>\n        client.executeTask('identity_match', {\n          type: 'identity_match_request',\n          request_id: `e2e-id-${Date.now()}`,\n          seller_agent_url: agentUrl,\n          identities: [{ user_token: 'e2e-test-opaque-token', uid_type: 'publisher_first_party' }],\n          package_ids: ['e2e-test-package-001', 'e2e-test-package-002'],\n          consent: {\n            gdpr: false,\n          },\n        }) as Promise<TaskResult>\n    );\n\n    if (result?.success && result?.data) {\n      const data = result.data as Record<string, unknown>;\n      const eligibleIds = Array.isArray(data['eligible_package_ids']) ? data['eligible_package_ids'] : [];\n      step.details = `Identity match returned ${eligibleIds.length} eligible package(s)`;\n      step.response_preview = JSON.stringify(\n        {\n          request_id: data['request_id'],\n          eligible_package_ids: eligibleIds,\n          ttl_sec: data['ttl_sec'],\n        },\n        null,\n        2\n      );\n    } else if (result && !result.success) {\n      const error = result.error || '';\n      if (error.includes('not supported') || error.includes('not implemented')) {\n        step.passed = true;\n        step.details = 'Identity match not supported by this agent (expected for some agents)';\n      } else {\n        step.passed = false;\n        step.error = result.error || 'identity_match failed';\n      }\n    }\n    steps.push(step);\n  }\n\n  return { steps, profile };\n}\n\n/**\n * Check if agent has any TMP tools\n */\nexport function hasTrustedMatchTools(tools: string[]): boolean {\n  return TRUSTED_MATCH_TOOLS.some(t => tools.includes(t));\n}\n"],"mappings":"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","names":[]}

package/dist/lib/testing/scenarios/trusted-match.mjs

@@ -27,8 +27,9 @@ async function testTrustedMatchFlow(agentUrl, options) {
         type: "context_match_request",
         request_id: `e2e-ctx-${Date.now()}`,
         property_rid: "00000000-0000-7000-0000-000000000001",
-        property_type: "web",
+        property_type: "website",
         placement_id: "e2e-test-placement",
+        seller_agent_url: agentUrl,
         context_signals: {
           topics: ["632"],
           taxonomy_source: "iab",
@@ -76,8 +77,8 @@ async function testTrustedMatchFlow(agentUrl, options) {
       async () => client.executeTask("identity_match", {
         type: "identity_match_request",
         request_id: `e2e-id-${Date.now()}`,
-        user_token: "e2e-test-opaque-token",
-        uid_type: "publisher_first_party",
+        seller_agent_url: agentUrl,
+        identities: [{ user_token: "e2e-test-opaque-token", uid_type: "publisher_first_party" }],
         package_ids: ["e2e-test-package-001", "e2e-test-package-002"],
         consent: {
           gdpr: false

package/dist/lib/testing/scenarios/trusted-match.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/testing/scenarios/trusted-match.ts"],"sourcesContent":["/**\n * Trusted Match Protocol (TMP) Testing Scenarios (v3)\n *\n * Tests TMP agent capabilities including:\n * - context_match — evaluates packages against content context (no user identity)\n * - identity_match — evaluates user eligibility for packages using an opaque identity token (no page context)\n */\n\nimport type { TestOptions, TestStepResult, AgentProfile, TaskResult } from '../types';\nimport { getOrCreateClient, runStep, getOrDiscoverProfile } from '../client';\nimport { TRUSTED_MATCH_TOOLS } from '../../utils/capabilities';\n\n/**\n * Test: Trusted Match Flow\n *\n * Flow: discover profile -> check TMP tools -> context_match -> identity_match\n */\nexport async function testTrustedMatchFlow(\n  agentUrl: string,\n  options: TestOptions\n): Promise<{ steps: TestStepResult[]; profile?: AgentProfile }> {\n  const steps: TestStepResult[] = [];\n  const client = getOrCreateClient(agentUrl, options);\n\n  // Discover agent profile\n  const { profile, step: profileStep } = await getOrDiscoverProfile(client, options);\n  steps.push(profileStep);\n\n  if (!profileStep.passed) {\n    return { steps, profile };\n  }\n\n  // Check if agent supports any TMP tools\n  const hasTMP = TRUSTED_MATCH_TOOLS.some(t => profile.tools.includes(t));\n  if (!hasTMP) {\n    steps.push({\n      step: 'TMP support check',\n      passed: false,\n      duration_ms: 0,\n      error: 'Agent does not support Trusted Match Protocol tools',\n      details: `Required tools: ${TRUSTED_MATCH_TOOLS.join(', ')}. Available: ${profile.tools.join(', ')}`,\n    });\n    return { steps, profile };\n  }\n\n  // Test: context_match\n  if (profile.tools.includes('context_match')) {\n    const { result, step } = await runStep<TaskResult>(\n      'Context match: evaluate packages against page context',\n      'context_match',\n      async () =>\n        client.executeTask('context_match', {\n          type: 'context_match_request',\n          request_id: `e2e-ctx-${Date.now()}`,\n          property_rid: '00000000-0000-7000-0000-000000000001',\n          property_type: 'web',\n          placement_id: 'e2e-test-placement',\n          context_signals: {\n            topics: ['632'],\n            taxonomy_source: 'iab',\n            taxonomy_id: 7,\n            sentiment: 'positive',\n            keywords: ['technology', 'innovation'],\n            language: 'en',\n          },\n          geo: {\n            country: 'US',\n            region: 'US-CA',\n          },\n        }) as Promise<TaskResult>\n    );\n\n    if (result?.success && result?.data) {\n      const data = result.data as Record<string, unknown>;\n      const offers = Array.isArray(data['offers']) ? data['offers'] : [];\n      step.details = `Context match returned ${offers.length} offer(s)`;\n      step.response_preview = JSON.stringify(\n        {\n          request_id: data['request_id'],\n          offers_count: offers.length,\n          cache_ttl: data['cache_ttl'],\n          has_signals: !!data['signals'],\n        },\n        null,\n        2\n      );\n    } else if (result && !result.success) {\n      const error = result.error || '';\n      if (error.includes('not supported') || error.includes('not implemented')) {\n        step.passed = true;\n        step.details = 'Context match not supported by this agent (expected for some agents)';\n      } else {\n        step.passed = false;\n        step.error = result.error || 'context_match failed';\n      }\n    }\n    steps.push(step);\n  }\n\n  // Test: identity_match\n  if (profile.tools.includes('identity_match')) {\n    const { result, step } = await runStep<TaskResult>(\n      'Identity match: evaluate user eligibility for packages',\n      'identity_match',\n      async () =>\n        client.executeTask('identity_match', {\n          type: 'identity_match_request',\n          request_id: `e2e-id-${Date.now()}`,\n          user_token: 'e2e-test-opaque-token',\n          uid_type: 'publisher_first_party',\n          package_ids: ['e2e-test-package-001', 'e2e-test-package-002'],\n          consent: {\n            gdpr: false,\n          },\n        }) as Promise<TaskResult>\n    );\n\n    if (result?.success && result?.data) {\n      const data = result.data as Record<string, unknown>;\n      const eligibleIds = Array.isArray(data['eligible_package_ids']) ? data['eligible_package_ids'] : [];\n      step.details = `Identity match returned ${eligibleIds.length} eligible package(s)`;\n      step.response_preview = JSON.stringify(\n        {\n          request_id: data['request_id'],\n          eligible_package_ids: eligibleIds,\n          ttl_sec: data['ttl_sec'],\n        },\n        null,\n        2\n      );\n    } else if (result && !result.success) {\n      const error = result.error || '';\n      if (error.includes('not supported') || error.includes('not implemented')) {\n        step.passed = true;\n        step.details = 'Identity match not supported by this agent (expected for some agents)';\n      } else {\n        step.passed = false;\n        step.error = result.error || 'identity_match failed';\n      }\n    }\n    steps.push(step);\n  }\n\n  return { steps, profile };\n}\n\n/**\n * Check if agent has any TMP tools\n */\nexport function hasTrustedMatchTools(tools: string[]): boolean {\n  return TRUSTED_MATCH_TOOLS.some(t => tools.includes(t));\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../src/lib/testing/scenarios/trusted-match.ts"],"sourcesContent":["/**\n * Trusted Match Protocol (TMP) Testing Scenarios (v3)\n *\n * Tests TMP agent capabilities including:\n * - context_match — evaluates packages against content context (no user identity)\n * - identity_match — evaluates user eligibility for packages using an opaque identity token (no page context)\n */\n\nimport type { TestOptions, TestStepResult, AgentProfile, TaskResult } from '../types';\nimport { getOrCreateClient, runStep, getOrDiscoverProfile } from '../client';\nimport { TRUSTED_MATCH_TOOLS } from '../../utils/capabilities';\n\n/**\n * Test: Trusted Match Flow\n *\n * Flow: discover profile -> check TMP tools -> context_match -> identity_match\n */\nexport async function testTrustedMatchFlow(\n  agentUrl: string,\n  options: TestOptions\n): Promise<{ steps: TestStepResult[]; profile?: AgentProfile }> {\n  const steps: TestStepResult[] = [];\n  const client = getOrCreateClient(agentUrl, options);\n\n  // Discover agent profile\n  const { profile, step: profileStep } = await getOrDiscoverProfile(client, options);\n  steps.push(profileStep);\n\n  if (!profileStep.passed) {\n    return { steps, profile };\n  }\n\n  // Check if agent supports any TMP tools\n  const hasTMP = TRUSTED_MATCH_TOOLS.some(t => profile.tools.includes(t));\n  if (!hasTMP) {\n    steps.push({\n      step: 'TMP support check',\n      passed: false,\n      duration_ms: 0,\n      error: 'Agent does not support Trusted Match Protocol tools',\n      details: `Required tools: ${TRUSTED_MATCH_TOOLS.join(', ')}. Available: ${profile.tools.join(', ')}`,\n    });\n    return { steps, profile };\n  }\n\n  // Test: context_match\n  if (profile.tools.includes('context_match')) {\n    const { result, step } = await runStep<TaskResult>(\n      'Context match: evaluate packages against page context',\n      'context_match',\n      async () =>\n        client.executeTask('context_match', {\n          type: 'context_match_request',\n          request_id: `e2e-ctx-${Date.now()}`,\n          property_rid: '00000000-0000-7000-0000-000000000001',\n          property_type: 'website',\n          placement_id: 'e2e-test-placement',\n          seller_agent_url: agentUrl,\n          context_signals: {\n            topics: ['632'],\n            taxonomy_source: 'iab',\n            taxonomy_id: 7,\n            sentiment: 'positive',\n            keywords: ['technology', 'innovation'],\n            language: 'en',\n          },\n          geo: {\n            country: 'US',\n            region: 'US-CA',\n          },\n        }) as Promise<TaskResult>\n    );\n\n    if (result?.success && result?.data) {\n      const data = result.data as Record<string, unknown>;\n      const offers = Array.isArray(data['offers']) ? data['offers'] : [];\n      step.details = `Context match returned ${offers.length} offer(s)`;\n      step.response_preview = JSON.stringify(\n        {\n          request_id: data['request_id'],\n          offers_count: offers.length,\n          cache_ttl: data['cache_ttl'],\n          has_signals: !!data['signals'],\n        },\n        null,\n        2\n      );\n    } else if (result && !result.success) {\n      const error = result.error || '';\n      if (error.includes('not supported') || error.includes('not implemented')) {\n        step.passed = true;\n        step.details = 'Context match not supported by this agent (expected for some agents)';\n      } else {\n        step.passed = false;\n        step.error = result.error || 'context_match failed';\n      }\n    }\n    steps.push(step);\n  }\n\n  // Test: identity_match\n  if (profile.tools.includes('identity_match')) {\n    const { result, step } = await runStep<TaskResult>(\n      'Identity match: evaluate user eligibility for packages',\n      'identity_match',\n      async () =>\n        client.executeTask('identity_match', {\n          type: 'identity_match_request',\n          request_id: `e2e-id-${Date.now()}`,\n          seller_agent_url: agentUrl,\n          identities: [{ user_token: 'e2e-test-opaque-token', uid_type: 'publisher_first_party' }],\n          package_ids: ['e2e-test-package-001', 'e2e-test-package-002'],\n          consent: {\n            gdpr: false,\n          },\n        }) as Promise<TaskResult>\n    );\n\n    if (result?.success && result?.data) {\n      const data = result.data as Record<string, unknown>;\n      const eligibleIds = Array.isArray(data['eligible_package_ids']) ? data['eligible_package_ids'] : [];\n      step.details = `Identity match returned ${eligibleIds.length} eligible package(s)`;\n      step.response_preview = JSON.stringify(\n        {\n          request_id: data['request_id'],\n          eligible_package_ids: eligibleIds,\n          ttl_sec: data['ttl_sec'],\n        },\n        null,\n        2\n      );\n    } else if (result && !result.success) {\n      const error = result.error || '';\n      if (error.includes('not supported') || error.includes('not implemented')) {\n        step.passed = true;\n        step.details = 'Identity match not supported by this agent (expected for some agents)';\n      } else {\n        step.passed = false;\n        step.error = result.error || 'identity_match failed';\n      }\n    }\n    steps.push(step);\n  }\n\n  return { steps, profile };\n}\n\n/**\n * Check if agent has any TMP tools\n */\nexport function hasTrustedMatchTools(tools: string[]): boolean {\n  return TRUSTED_MATCH_TOOLS.some(t => tools.includes(t));\n}\n"],"mappings":"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","names":[]}

package/dist/lib/testing/storyboard/shape-drift-hints.d.mts

@@ -26,10 +26,9 @@ import type { ShapeDriftHint } from './types.mjs';
  * helper that builds the correct shape.
  *
  * Helper names aren't uniformly prefixed — `get_products` uses
- * `productsResponse` (no `get` prefix) while `get_media_buys` uses
- * `getMediaBuysResponse`. Names match the exports in
- * `src/lib/server/responses.ts` verbatim so a developer can grep
- * straight from the hint.
+ * `legacyProductsResponse` (no `get` prefix) while `get_media_buys` uses
+ * `legacyGetMediaBuysResponse`. Names match the explicit compatibility
+ * aliases on `@adcp/sdk/server`.
  */
 export declare const LIST_WRAPPER_TOOLS: Record<string, {
     wrapperKey: string;

package/dist/lib/testing/storyboard/shape-drift-hints.d.ts

@@ -26,10 +26,9 @@ import type { ShapeDriftHint } from './types';
  * helper that builds the correct shape.
  *
  * Helper names aren't uniformly prefixed — `get_products` uses
- * `productsResponse` (no `get` prefix) while `get_media_buys` uses
- * `getMediaBuysResponse`. Names match the exports in
- * `src/lib/server/responses.ts` verbatim so a developer can grep
- * straight from the hint.
+ * `legacyProductsResponse` (no `get` prefix) while `get_media_buys` uses
+ * `legacyGetMediaBuysResponse`. Names match the explicit compatibility
+ * aliases on `@adcp/sdk/server`.
  */
 export declare const LIST_WRAPPER_TOOLS: Record<string, {
     wrapperKey: string;

package/dist/lib/testing/storyboard/shape-drift-hints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shape-drift-hints.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/storyboard/shape-drift-hints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AA0C9C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAWrF,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE,CAKnH"}
+{"version":3,"file":"shape-drift-hints.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/storyboard/shape-drift-hints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AA0C9C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAWrF,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE,CAKnH"}

package/dist/lib/testing/storyboard/shape-drift-hints.js

@@ -23,19 +23,19 @@ __export(shape_drift_hints_exports, {
 });
 module.exports = __toCommonJS(shape_drift_hints_exports);
 const HELPER_MIN_VERSION = {
-  buildCreativeResponse: "5.14.0",
-  listCreativesResponse: "5.10.0",
-  listCreativeFormatsResponse: "5.10.0",
-  listAccountsResponse: "5.10.0",
-  productsResponse: "5.10.0",
-  getMediaBuysResponse: "5.10.0",
-  getSignalsResponse: "5.10.0",
-  listPropertyListsResponse: "5.10.0",
-  listCollectionListsResponse: "5.10.0",
-  listContentStandardsResponse: "5.10.0",
-  getPlanAuditLogsResponse: "5.10.0",
-  syncCreativesResponse: "5.10.0",
-  previewCreativeResponse: "5.10.0"
+  legacyBuildCreativeResponse: "13.0.0",
+  legacyListCreativesResponse: "13.0.0",
+  legacyListCreativeFormatsResponse: "13.0.0",
+  legacyListAccountsResponse: "13.0.0",
+  legacyProductsResponse: "13.0.0",
+  legacyGetMediaBuysResponse: "13.0.0",
+  legacyGetSignalsResponse: "13.0.0",
+  legacyListPropertyListsResponse: "13.0.0",
+  legacyListCollectionListsResponse: "13.0.0",
+  legacyListContentStandardsResponse: "13.0.0",
+  legacyGetPlanAuditLogsResponse: "13.0.0",
+  legacySyncCreativesResponse: "13.0.0",
+  legacyPreviewCreativeResponse: "13.0.0"
 };
 function semverLessThan(a, b) {
   const normalize = (v) => v.replace(/^.*@/, "").replace(/-.*$/, "");
@@ -47,16 +47,16 @@ function semverLessThan(a, b) {
   return aPatch < bPatch;
 }
 const LIST_WRAPPER_TOOLS = {
-  list_creatives: { wrapperKey: "creatives", helper: "listCreativesResponse" },
-  list_creative_formats: { wrapperKey: "formats", helper: "listCreativeFormatsResponse" },
-  list_accounts: { wrapperKey: "accounts", helper: "listAccountsResponse" },
-  get_products: { wrapperKey: "products", helper: "productsResponse" },
-  get_media_buys: { wrapperKey: "media_buys", helper: "getMediaBuysResponse" },
-  get_signals: { wrapperKey: "signals", helper: "getSignalsResponse" },
-  list_property_lists: { wrapperKey: "lists", helper: "listPropertyListsResponse" },
-  list_collection_lists: { wrapperKey: "lists", helper: "listCollectionListsResponse" },
-  list_content_standards: { wrapperKey: "standards", helper: "listContentStandardsResponse" },
-  get_plan_audit_logs: { wrapperKey: "plans", helper: "getPlanAuditLogsResponse" }
+  list_creatives: { wrapperKey: "creatives", helper: "legacyListCreativesResponse" },
+  list_creative_formats: { wrapperKey: "formats", helper: "legacyListCreativeFormatsResponse" },
+  list_accounts: { wrapperKey: "accounts", helper: "legacyListAccountsResponse" },
+  get_products: { wrapperKey: "products", helper: "legacyProductsResponse" },
+  get_media_buys: { wrapperKey: "media_buys", helper: "legacyGetMediaBuysResponse" },
+  get_signals: { wrapperKey: "signals", helper: "legacyGetSignalsResponse" },
+  list_property_lists: { wrapperKey: "lists", helper: "legacyListPropertyListsResponse" },
+  list_collection_lists: { wrapperKey: "lists", helper: "legacyListCollectionListsResponse" },
+  list_content_standards: { wrapperKey: "standards", helper: "legacyListContentStandardsResponse" },
+  get_plan_audit_logs: { wrapperKey: "plans", helper: "legacyGetPlanAuditLogsResponse" }
 };
 function detectShapeDriftHints(taskName, payload, libraryVersion) {
   const hint = detect(taskName, payload);
@@ -100,7 +100,7 @@ function detect(taskName, payload) {
         observed_variant: "platform_native_fields",
         expected_variant: "{ creative_manifest: { format_id, assets } }",
         instance_path: "",
-        message: `build_creative returned platform-native fields at the top level (${platformNativePresent.join(", ")}). Required: { creative_manifest: { format_id, assets } }. Use buildCreativeResponse() from @adcp/sdk/server.`
+        message: `build_creative returned platform-native fields at the top level (${platformNativePresent.join(", ")}). Required: { creative_manifest: { format_id, assets } }. Use legacyBuildCreativeResponse() from @adcp/sdk/server.`
       };
     }
   }
@@ -115,7 +115,7 @@ function detect(taskName, payload) {
         observed_variant: "per_item_shape",
         expected_variant: "{ creatives: [{ creative_id, action, ... }] }",
         instance_path: "",
-        message: `sync_creatives returned a single creative's inner shape at the top level (${perItemPresent.join(", ")}). Required: { creatives: [{ creative_id, action, ... }] } (or { errors: [...] } / { status: 'submitted', task_id }). Use syncCreativesResponse() from @adcp/sdk/server.`
+        message: `sync_creatives returned a single creative's inner shape at the top level (${perItemPresent.join(", ")}). Required: { creatives: [{ creative_id, action, ... }] } (or { errors: [...] } / { status: 'submitted', task_id }). Use legacySyncCreativesResponse() from @adcp/sdk/server.`
       };
     }
     const results = p.results;
@@ -129,7 +129,7 @@ function detect(taskName, payload) {
           observed_variant: "wrong_wrapper_key",
           expected_variant: "{ creatives: [{ creative_id, action, ... }] }",
           instance_path: "/results",
-          message: `sync_creatives returned { results: [...] } instead of { creatives: [...] } \u2014 wrong wrapper key. Required: { creatives: [{ creative_id, action, ... }] }. Use syncCreativesResponse() from @adcp/sdk/server.`
+          message: `sync_creatives returned { results: [...] } instead of { creatives: [...] } \u2014 wrong wrapper key. Required: { creatives: [{ creative_id, action, ... }] }. Use legacySyncCreativesResponse() from @adcp/sdk/server.`
         };
       }
     }
@@ -146,7 +146,7 @@ function detect(taskName, payload) {
         observed_variant: "raw_render_fields",
         expected_variant: "{ response_type: 'single', previews: [{ renders: [...] }], expires_at }",
         instance_path: "",
-        message: `preview_creative returned raw render fields at the top level (${driftSignal.join(", ")}). Required: { response_type: 'single', previews: [{ renders: [{ preview_url | preview_html }] }], expires_at }. Use previewCreativeResponse() from @adcp/sdk/server.`
+        message: `preview_creative returned raw render fields at the top level (${driftSignal.join(", ")}). Required: { response_type: 'single', previews: [{ renders: [{ preview_url | preview_html }] }], expires_at }. Use legacyPreviewCreativeResponse() from @adcp/sdk/server.`
       };
     }
   }

package/dist/lib/testing/storyboard/shape-drift-hints.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/testing/storyboard/shape-drift-hints.ts"],"sourcesContent":["/**\n * Structured shape-drift hint detection (issue #935).\n *\n * The runner emits one `ShapeDriftHint` per response when it recognizes a\n * common payload-shape mistake — bare arrays from list tools, platform-\n * native fields from `build_creative`, missing wrappers on `sync_creatives`\n * / `preview_creative`. Each hint carries the same prose the legacy\n * `detectShapeDriftHint` returned, plus structured fields (`tool`,\n * `observed_variant`, `expected_variant`, `instance_path`) so renderers\n * (CLI, Addie, JUnit, SARIF) can build per-case fix plans without re-\n * parsing the message.\n *\n * The string-only `detectShapeDriftHint` in `validations.ts` is a thin\n * shim over this detector — kept so existing unit tests and external\n * callers keep working, but the canonical path is structured.\n *\n * Fires unconditionally (regardless of step pass/fail) — same gate as\n * `ValidationResult.warning` carried previously. The caller (`runner.ts`)\n * merges the result into `StoryboardStepResult.hints[]`.\n */\nimport type { ShapeDriftHint } from './types';\n\n/**\n * Minimum @adcp/client version in which each server-side helper first shipped.\n * Used to suffix shape-drift hints when the agent reports an older SDK version.\n * Keys match the helper name referenced in the hint `message`.\n */\nconst HELPER_MIN_VERSION: Record<string, string> = {\n  buildCreativeResponse: '5.14.0',\n  listCreativesResponse: '5.10.0',\n  listCreativeFormatsResponse: '5.10.0',\n  listAccountsResponse: '5.10.0',\n  productsResponse: '5.10.0',\n  getMediaBuysResponse: '5.10.0',\n  getSignalsResponse: '5.10.0',\n  listPropertyListsResponse: '5.10.0',\n  listCollectionListsResponse: '5.10.0',\n  listContentStandardsResponse: '5.10.0',\n  getPlanAuditLogsResponse: '5.10.0',\n  syncCreativesResponse: '5.10.0',\n  previewCreativeResponse: '5.10.0',\n};\n\n/**\n * Compare two semver strings using numeric segment ordering.\n * Returns true when `a` is strictly less than `b`.\n * Handles `@adcp/client@X.Y.Z` format by stripping the package prefix.\n */\nfunction semverLessThan(a: string, b: string): boolean {\n  // Strip package prefix (e.g. \"@adcp/client@\") and pre-release suffix (e.g. \"-beta.1\")\n  const normalize = (v: string) => v.replace(/^.*@/, '').replace(/-.*$/, '');\n  const segs = (v: string) =>\n    normalize(v)\n      .split('.')\n      .map(s => parseInt(s, 10) || 0);\n  const [aMaj = 0, aMin = 0, aPatch = 0] = segs(a);\n  const [bMaj = 0, bMin = 0, bPatch = 0] = segs(b);\n  if (aMaj !== bMaj) return aMaj < bMaj;\n  if (aMin !== bMin) return aMin < bMin;\n  return aPatch < bPatch;\n}\n\n/**\n * List-shaped tools where handlers commonly return the bare inner array\n * (`[{...}]`) at the top level instead of wrapping it in the required\n * object envelope. Each entry names the wrapper key and the response\n * helper that builds the correct shape.\n *\n * Helper names aren't uniformly prefixed — `get_products` uses\n * `productsResponse` (no `get` prefix) while `get_media_buys` uses\n * `getMediaBuysResponse`. Names match the exports in\n * `src/lib/server/responses.ts` verbatim so a developer can grep\n * straight from the hint.\n */\nexport const LIST_WRAPPER_TOOLS: Record<string, { wrapperKey: string; helper: string }> = {\n  list_creatives: { wrapperKey: 'creatives', helper: 'listCreativesResponse' },\n  list_creative_formats: { wrapperKey: 'formats', helper: 'listCreativeFormatsResponse' },\n  list_accounts: { wrapperKey: 'accounts', helper: 'listAccountsResponse' },\n  get_products: { wrapperKey: 'products', helper: 'productsResponse' },\n  get_media_buys: { wrapperKey: 'media_buys', helper: 'getMediaBuysResponse' },\n  get_signals: { wrapperKey: 'signals', helper: 'getSignalsResponse' },\n  list_property_lists: { wrapperKey: 'lists', helper: 'listPropertyListsResponse' },\n  list_collection_lists: { wrapperKey: 'lists', helper: 'listCollectionListsResponse' },\n  list_content_standards: { wrapperKey: 'standards', helper: 'listContentStandardsResponse' },\n  get_plan_audit_logs: { wrapperKey: 'plans', helper: 'getPlanAuditLogsResponse' },\n};\n\n/**\n * Detect shape-drift and return the structured hints that apply (zero or\n * one — the detector emits at most one hint per response, but returns an\n * array so callers can spread it into `step.hints[]` without a guard).\n *\n * @param taskName — tool name (snake_case) the storyboard dispatched under\n * @param payload — raw response payload, after the runner's `_message`\n *   pre-strip. `unknown` rather than `Record<string, unknown>` so bare-\n *   array payloads are recognizable at the top level; object branches\n *   guard internally.\n * @param libraryVersion — optional SDK version string the agent self-reported\n *   in `get_adcp_capabilities` (e.g. `\"@adcp/client@4.16.2\"`). When present\n *   and below the helper's minimum version, the hint message is suffixed with\n *   an upgrade note so developers know to update their SDK dep.\n */\nexport function detectShapeDriftHints(taskName: string, payload: unknown, libraryVersion?: string): ShapeDriftHint[] {\n  const hint = detect(taskName, payload);\n  if (!hint) return [];\n  if (libraryVersion) hint.message = appendVersionSuffix(hint.message, libraryVersion);\n  return [hint];\n}\n\n/**\n * If the hint message references a helper that requires a minimum SDK\n * version and the agent's reported version is below it, append an upgrade\n * note to the message. Returns the message unchanged if no version data or\n * no match.\n */\nfunction appendVersionSuffix(message: string, libraryVersion: string): string {\n  // Skip non-numeric version strings (e.g. \"local-dev\") to avoid spurious suffixes\n  const stripped = libraryVersion.replace(/^.*@/, '').replace(/-.*$/, '');\n  if (!/^\\d+\\.\\d+/.test(stripped)) return message;\n  for (const [helper, minVersion] of Object.entries(HELPER_MIN_VERSION)) {\n    if (message.includes(helper) && semverLessThan(libraryVersion, minVersion)) {\n      return (\n        message +\n        ` (Note: your agent reports ${libraryVersion} — ${helper}() ships in @adcp/client ≥${minVersion}. Upgrade your SDK dep.)`\n      );\n    }\n  }\n  return message;\n}\n\nfunction detect(taskName: string, payload: unknown): ShapeDriftHint | undefined {\n  if (Array.isArray(payload)) {\n    const listMeta = LIST_WRAPPER_TOOLS[taskName];\n    if (!listMeta) return undefined;\n    return {\n      kind: 'shape_drift',\n      tool: taskName,\n      observed_variant: 'bare_array',\n      expected_variant: `{ ${listMeta.wrapperKey}: [...] }`,\n      instance_path: '',\n      message:\n        `${taskName} returned a bare array at the top level. ` +\n        `Required: { ${listMeta.wrapperKey}: [...] }. ` +\n        `Use ${listMeta.helper}() from @adcp/sdk/server.`,\n    };\n  }\n\n  if (typeof payload !== 'object' || payload === null) return undefined;\n  const p = payload as Record<string, unknown>;\n\n  if (taskName === 'build_creative') {\n    const hasManifest = 'creative_manifest' in p || 'creative_manifests' in p;\n    const platformNativeKeys = ['tag_url', 'creative_id', 'media_type', 'tag_type'];\n    const platformNativePresent = platformNativeKeys.filter(k => k in p);\n    if (!hasManifest && platformNativePresent.length > 0) {\n      return {\n        kind: 'shape_drift',\n        tool: taskName,\n        observed_variant: 'platform_native_fields',\n        expected_variant: '{ creative_manifest: { format_id, assets } }',\n        instance_path: '',\n        message:\n          `build_creative returned platform-native fields at the top level (${platformNativePresent.join(', ')}). ` +\n          `Required: { creative_manifest: { format_id, assets } }. ` +\n          `Use buildCreativeResponse() from @adcp/sdk/server.`,\n      };\n    }\n  }\n\n  if (taskName === 'sync_creatives') {\n    const hasValidWrapper = 'creatives' in p || 'errors' in p || 'task_id' in p;\n    const perItemKeys = ['creative_id', 'platform_id', 'action'];\n    const perItemPresent = perItemKeys.filter(k => k in p);\n    if (!hasValidWrapper && perItemPresent.length > 0) {\n      return {\n        kind: 'shape_drift',\n        tool: taskName,\n        observed_variant: 'per_item_shape',\n        expected_variant: '{ creatives: [{ creative_id, action, ... }] }',\n        instance_path: '',\n        message:\n          `sync_creatives returned a single creative's inner shape at the top level (${perItemPresent.join(', ')}). ` +\n          `Required: { creatives: [{ creative_id, action, ... }] } (or { errors: [...] } / { status: 'submitted', task_id }). ` +\n          `Use syncCreativesResponse() from @adcp/sdk/server.`,\n      };\n    }\n\n    const results = p.results;\n    if (!hasValidWrapper && Array.isArray(results) && results.length > 0) {\n      const firstRow = results[0];\n      const looksLikeCreativeRow =\n        firstRow != null && typeof firstRow === 'object' && ('creative_id' in firstRow || 'action' in firstRow);\n      if (looksLikeCreativeRow) {\n        return {\n          kind: 'shape_drift',\n          tool: taskName,\n          observed_variant: 'wrong_wrapper_key',\n          expected_variant: '{ creatives: [{ creative_id, action, ... }] }',\n          instance_path: '/results',\n          message:\n            `sync_creatives returned { results: [...] } instead of { creatives: [...] } — wrong wrapper key. ` +\n            `Required: { creatives: [{ creative_id, action, ... }] }. ` +\n            `Use syncCreativesResponse() from @adcp/sdk/server.`,\n        };\n      }\n    }\n  }\n\n  if (taskName === 'preview_creative') {\n    const hasValidWrapper = 'response_type' in p || 'previews' in p || 'results' in p;\n    const rawRenderKeys = ['preview_url', 'preview_html', 'interactive_url'];\n    const rawRenderPresent = rawRenderKeys.filter(k => k in p);\n    const driftSignal = rawRenderPresent.filter(k => k !== 'interactive_url');\n    if (!hasValidWrapper && driftSignal.length > 0) {\n      return {\n        kind: 'shape_drift',\n        tool: taskName,\n        observed_variant: 'raw_render_fields',\n        expected_variant: \"{ response_type: 'single', previews: [{ renders: [...] }], expires_at }\",\n        instance_path: '',\n        message:\n          `preview_creative returned raw render fields at the top level (${driftSignal.join(', ')}). ` +\n          `Required: { response_type: 'single', previews: [{ renders: [{ preview_url | preview_html }] }], expires_at }. ` +\n          `Use previewCreativeResponse() from @adcp/sdk/server.`,\n      };\n    }\n  }\n\n  return undefined;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../src/lib/testing/storyboard/shape-drift-hints.ts"],"sourcesContent":["/**\n * Structured shape-drift hint detection (issue #935).\n *\n * The runner emits one `ShapeDriftHint` per response when it recognizes a\n * common payload-shape mistake — bare arrays from list tools, platform-\n * native fields from `build_creative`, missing wrappers on `sync_creatives`\n * / `preview_creative`. Each hint carries the same prose the legacy\n * `detectShapeDriftHint` returned, plus structured fields (`tool`,\n * `observed_variant`, `expected_variant`, `instance_path`) so renderers\n * (CLI, Addie, JUnit, SARIF) can build per-case fix plans without re-\n * parsing the message.\n *\n * The string-only `detectShapeDriftHint` in `validations.ts` is a thin\n * shim over this detector — kept so existing unit tests and external\n * callers keep working, but the canonical path is structured.\n *\n * Fires unconditionally (regardless of step pass/fail) — same gate as\n * `ValidationResult.warning` carried previously. The caller (`runner.ts`)\n * merges the result into `StoryboardStepResult.hints[]`.\n */\nimport type { ShapeDriftHint } from './types';\n\n/**\n * Minimum @adcp/client version in which each server-side helper first shipped.\n * Used to suffix shape-drift hints when the agent reports an older SDK version.\n * Keys match the helper name referenced in the hint `message`.\n */\nconst HELPER_MIN_VERSION: Record<string, string> = {\n  legacyBuildCreativeResponse: '13.0.0',\n  legacyListCreativesResponse: '13.0.0',\n  legacyListCreativeFormatsResponse: '13.0.0',\n  legacyListAccountsResponse: '13.0.0',\n  legacyProductsResponse: '13.0.0',\n  legacyGetMediaBuysResponse: '13.0.0',\n  legacyGetSignalsResponse: '13.0.0',\n  legacyListPropertyListsResponse: '13.0.0',\n  legacyListCollectionListsResponse: '13.0.0',\n  legacyListContentStandardsResponse: '13.0.0',\n  legacyGetPlanAuditLogsResponse: '13.0.0',\n  legacySyncCreativesResponse: '13.0.0',\n  legacyPreviewCreativeResponse: '13.0.0',\n};\n\n/**\n * Compare two semver strings using numeric segment ordering.\n * Returns true when `a` is strictly less than `b`.\n * Handles `@adcp/client@X.Y.Z` format by stripping the package prefix.\n */\nfunction semverLessThan(a: string, b: string): boolean {\n  // Strip package prefix (e.g. \"@adcp/client@\") and pre-release suffix (e.g. \"-beta.1\")\n  const normalize = (v: string) => v.replace(/^.*@/, '').replace(/-.*$/, '');\n  const segs = (v: string) =>\n    normalize(v)\n      .split('.')\n      .map(s => parseInt(s, 10) || 0);\n  const [aMaj = 0, aMin = 0, aPatch = 0] = segs(a);\n  const [bMaj = 0, bMin = 0, bPatch = 0] = segs(b);\n  if (aMaj !== bMaj) return aMaj < bMaj;\n  if (aMin !== bMin) return aMin < bMin;\n  return aPatch < bPatch;\n}\n\n/**\n * List-shaped tools where handlers commonly return the bare inner array\n * (`[{...}]`) at the top level instead of wrapping it in the required\n * object envelope. Each entry names the wrapper key and the response\n * helper that builds the correct shape.\n *\n * Helper names aren't uniformly prefixed — `get_products` uses\n * `legacyProductsResponse` (no `get` prefix) while `get_media_buys` uses\n * `legacyGetMediaBuysResponse`. Names match the explicit compatibility\n * aliases on `@adcp/sdk/server`.\n */\nexport const LIST_WRAPPER_TOOLS: Record<string, { wrapperKey: string; helper: string }> = {\n  list_creatives: { wrapperKey: 'creatives', helper: 'legacyListCreativesResponse' },\n  list_creative_formats: { wrapperKey: 'formats', helper: 'legacyListCreativeFormatsResponse' },\n  list_accounts: { wrapperKey: 'accounts', helper: 'legacyListAccountsResponse' },\n  get_products: { wrapperKey: 'products', helper: 'legacyProductsResponse' },\n  get_media_buys: { wrapperKey: 'media_buys', helper: 'legacyGetMediaBuysResponse' },\n  get_signals: { wrapperKey: 'signals', helper: 'legacyGetSignalsResponse' },\n  list_property_lists: { wrapperKey: 'lists', helper: 'legacyListPropertyListsResponse' },\n  list_collection_lists: { wrapperKey: 'lists', helper: 'legacyListCollectionListsResponse' },\n  list_content_standards: { wrapperKey: 'standards', helper: 'legacyListContentStandardsResponse' },\n  get_plan_audit_logs: { wrapperKey: 'plans', helper: 'legacyGetPlanAuditLogsResponse' },\n};\n\n/**\n * Detect shape-drift and return the structured hints that apply (zero or\n * one — the detector emits at most one hint per response, but returns an\n * array so callers can spread it into `step.hints[]` without a guard).\n *\n * @param taskName — tool name (snake_case) the storyboard dispatched under\n * @param payload — raw response payload, after the runner's `_message`\n *   pre-strip. `unknown` rather than `Record<string, unknown>` so bare-\n *   array payloads are recognizable at the top level; object branches\n *   guard internally.\n * @param libraryVersion — optional SDK version string the agent self-reported\n *   in `get_adcp_capabilities` (e.g. `\"@adcp/client@4.16.2\"`). When present\n *   and below the helper's minimum version, the hint message is suffixed with\n *   an upgrade note so developers know to update their SDK dep.\n */\nexport function detectShapeDriftHints(taskName: string, payload: unknown, libraryVersion?: string): ShapeDriftHint[] {\n  const hint = detect(taskName, payload);\n  if (!hint) return [];\n  if (libraryVersion) hint.message = appendVersionSuffix(hint.message, libraryVersion);\n  return [hint];\n}\n\n/**\n * If the hint message references a helper that requires a minimum SDK\n * version and the agent's reported version is below it, append an upgrade\n * note to the message. Returns the message unchanged if no version data or\n * no match.\n */\nfunction appendVersionSuffix(message: string, libraryVersion: string): string {\n  // Skip non-numeric version strings (e.g. \"local-dev\") to avoid spurious suffixes\n  const stripped = libraryVersion.replace(/^.*@/, '').replace(/-.*$/, '');\n  if (!/^\\d+\\.\\d+/.test(stripped)) return message;\n  for (const [helper, minVersion] of Object.entries(HELPER_MIN_VERSION)) {\n    if (message.includes(helper) && semverLessThan(libraryVersion, minVersion)) {\n      return (\n        message +\n        ` (Note: your agent reports ${libraryVersion} — ${helper}() ships in @adcp/client ≥${minVersion}. Upgrade your SDK dep.)`\n      );\n    }\n  }\n  return message;\n}\n\nfunction detect(taskName: string, payload: unknown): ShapeDriftHint | undefined {\n  if (Array.isArray(payload)) {\n    const listMeta = LIST_WRAPPER_TOOLS[taskName];\n    if (!listMeta) return undefined;\n    return {\n      kind: 'shape_drift',\n      tool: taskName,\n      observed_variant: 'bare_array',\n      expected_variant: `{ ${listMeta.wrapperKey}: [...] }`,\n      instance_path: '',\n      message:\n        `${taskName} returned a bare array at the top level. ` +\n        `Required: { ${listMeta.wrapperKey}: [...] }. ` +\n        `Use ${listMeta.helper}() from @adcp/sdk/server.`,\n    };\n  }\n\n  if (typeof payload !== 'object' || payload === null) return undefined;\n  const p = payload as Record<string, unknown>;\n\n  if (taskName === 'build_creative') {\n    const hasManifest = 'creative_manifest' in p || 'creative_manifests' in p;\n    const platformNativeKeys = ['tag_url', 'creative_id', 'media_type', 'tag_type'];\n    const platformNativePresent = platformNativeKeys.filter(k => k in p);\n    if (!hasManifest && platformNativePresent.length > 0) {\n      return {\n        kind: 'shape_drift',\n        tool: taskName,\n        observed_variant: 'platform_native_fields',\n        expected_variant: '{ creative_manifest: { format_id, assets } }',\n        instance_path: '',\n        message:\n          `build_creative returned platform-native fields at the top level (${platformNativePresent.join(', ')}). ` +\n          `Required: { creative_manifest: { format_id, assets } }. ` +\n          `Use legacyBuildCreativeResponse() from @adcp/sdk/server.`,\n      };\n    }\n  }\n\n  if (taskName === 'sync_creatives') {\n    const hasValidWrapper = 'creatives' in p || 'errors' in p || 'task_id' in p;\n    const perItemKeys = ['creative_id', 'platform_id', 'action'];\n    const perItemPresent = perItemKeys.filter(k => k in p);\n    if (!hasValidWrapper && perItemPresent.length > 0) {\n      return {\n        kind: 'shape_drift',\n        tool: taskName,\n        observed_variant: 'per_item_shape',\n        expected_variant: '{ creatives: [{ creative_id, action, ... }] }',\n        instance_path: '',\n        message:\n          `sync_creatives returned a single creative's inner shape at the top level (${perItemPresent.join(', ')}). ` +\n          `Required: { creatives: [{ creative_id, action, ... }] } (or { errors: [...] } / { status: 'submitted', task_id }). ` +\n          `Use legacySyncCreativesResponse() from @adcp/sdk/server.`,\n      };\n    }\n\n    const results = p.results;\n    if (!hasValidWrapper && Array.isArray(results) && results.length > 0) {\n      const firstRow = results[0];\n      const looksLikeCreativeRow =\n        firstRow != null && typeof firstRow === 'object' && ('creative_id' in firstRow || 'action' in firstRow);\n      if (looksLikeCreativeRow) {\n        return {\n          kind: 'shape_drift',\n          tool: taskName,\n          observed_variant: 'wrong_wrapper_key',\n          expected_variant: '{ creatives: [{ creative_id, action, ... }] }',\n          instance_path: '/results',\n          message:\n            `sync_creatives returned { results: [...] } instead of { creatives: [...] } — wrong wrapper key. ` +\n            `Required: { creatives: [{ creative_id, action, ... }] }. ` +\n            `Use legacySyncCreativesResponse() from @adcp/sdk/server.`,\n        };\n      }\n    }\n  }\n\n  if (taskName === 'preview_creative') {\n    const hasValidWrapper = 'response_type' in p || 'previews' in p || 'results' in p;\n    const rawRenderKeys = ['preview_url', 'preview_html', 'interactive_url'];\n    const rawRenderPresent = rawRenderKeys.filter(k => k in p);\n    const driftSignal = rawRenderPresent.filter(k => k !== 'interactive_url');\n    if (!hasValidWrapper && driftSignal.length > 0) {\n      return {\n        kind: 'shape_drift',\n        tool: taskName,\n        observed_variant: 'raw_render_fields',\n        expected_variant: \"{ response_type: 'single', previews: [{ renders: [...] }], expires_at }\",\n        instance_path: '',\n        message:\n          `preview_creative returned raw render fields at the top level (${driftSignal.join(', ')}). ` +\n          `Required: { response_type: 'single', previews: [{ renders: [{ preview_url | preview_html }] }], expires_at }. ` +\n          `Use legacyPreviewCreativeResponse() from @adcp/sdk/server.`,\n      };\n    }\n  }\n\n  return undefined;\n}\n"],"mappings":"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","names":[]}