@adcp/sdk 12.0.0 → 12.0.2

package/dist/lib/testing/formatter.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/testing/formatter.ts"],"sourcesContent":["/**\n * Test result formatting for AdCP Agent E2E Testing\n */\n\nimport type { TestResult } from './types';\n\n/**\n * Format test results for display in Slack/chat\n */\nexport function formatTestResults(result: TestResult): string {\n  const statusEmoji = result.overall_passed ? '✅' : '❌';\n  let output = `## ${statusEmoji} Agent Test Results\\n\\n`;\n  output += `**Agent:** ${result.agent_url}\\n`;\n  output += `**Scenario:** ${result.scenario}\\n`;\n  output += `**Duration:** ${result.total_duration_ms}ms\\n`;\n  output += `**Result:** ${result.summary}\\n\\n`;\n\n  // Show agent profile if discovered\n  if (result.agent_profile) {\n    output += `### Agent Capabilities\\n`;\n    output += `- **Name:** ${result.agent_profile.name}\\n`;\n    output += `- **Tools:** ${result.agent_profile.tools.length}\\n`;\n    if (result.agent_profile.channels?.length) {\n      output += `- **Channels:** ${result.agent_profile.channels.join(', ')}\\n`;\n    }\n    if (result.agent_profile.pricing_models?.length) {\n      output += `- **Pricing Models:** ${result.agent_profile.pricing_models.join(', ')}\\n`;\n    }\n    if (result.agent_profile.supported_formats?.length) {\n      output += `- **Creative Formats:** ${result.agent_profile.supported_formats.length}\\n`;\n    }\n    if (result.agent_profile.supported_signals?.length) {\n      output += `- **Signals:** ${result.agent_profile.supported_signals.length}\\n`;\n    }\n    output += '\\n';\n  }\n\n  output += `### Test Steps\\n\\n`;\n\n  for (const step of result.steps ?? []) {\n    const stepEmoji = step.passed ? '✅' : '❌';\n    output += `${stepEmoji} **${step.step}**`;\n    if (step.task) {\n      output += ` (\\`${step.task}\\`)`;\n    }\n    output += ` - ${step.duration_ms}ms\\n`;\n\n    if (step.details) {\n      output += `   ${step.details}\\n`;\n    }\n\n    if (step.warnings && step.warnings.length > 0) {\n      for (const warning of step.warnings) {\n        output += `   ${warning}\\n`;\n      }\n    }\n\n    if (step.error) {\n      output += `   ⚠️ Error: ${step.error}\\n`;\n    }\n\n    if (step.response_preview && !step.error) {\n      output += `   \\`\\`\\`json\\n   ${step.response_preview.split('\\n').join('\\n   ')}\\n   \\`\\`\\`\\n`;\n    }\n\n    output += '\\n';\n  }\n\n  if (!result.overall_passed) {\n    output += `---\\n\\n`;\n    output += `💡 **Need help?** Ask me about specific errors or check the [AdCP documentation](https://adcontextprotocol.org/docs).\\n`;\n  }\n\n  return output;\n}\n\n/**\n * Format test results as JSON for programmatic use\n */\nexport function formatTestResultsJSON(result: TestResult): string {\n  return JSON.stringify(result, null, 2);\n}\n\n/**\n * Format test results as a compact summary\n */\nexport function formatTestResultsSummary(result: TestResult): string {\n  const statusEmoji = result.overall_passed ? '✅' : '❌';\n  const steps = result.steps ?? [];\n  const passedCount = steps.filter(s => s.passed).length;\n  const failedCount = steps.filter(s => !s.passed).length;\n  const warningCount = steps.filter(s => s.warnings && s.warnings.length > 0).length;\n\n  let summary = `${statusEmoji} ${result.scenario}: ${passedCount}/${steps.length} passed (${result.total_duration_ms}ms)`;\n  if (failedCount > 0) {\n    summary += ` - ${failedCount} failed`;\n  }\n  if (warningCount > 0) {\n    summary += ` - ⚠️ ${warningCount} warning(s)`;\n  }\n  return summary;\n}\n"],"mappings":";;;;;;AASO,SAAS,kBAAkB,QAA4B;AAC5D,QAAM,cAAc,OAAO,iBAAiB,WAAM;AAClD,MAAI,SAAS,MAAM,WAAW;AAAA;AAAA;AAC9B,YAAU,cAAc,OAAO,SAAS;AAAA;AACxC,YAAU,iBAAiB,OAAO,QAAQ;AAAA;AAC1C,YAAU,iBAAiB,OAAO,iBAAiB;AAAA;AACnD,YAAU,eAAe,OAAO,OAAO;AAAA;AAAA;AAGvC,MAAI,OAAO,eAAe;AACxB,cAAU;AAAA;AACV,cAAU,eAAe,OAAO,cAAc,IAAI;AAAA;AAClD,cAAU,gBAAgB,OAAO,cAAc,MAAM,MAAM;AAAA;AAC3D,QAAI,OAAO,cAAc,UAAU,QAAQ;AACzC,gBAAU,mBAAmB,OAAO,cAAc,SAAS,KAAK,IAAI,CAAC;AAAA;AAAA,IACvE;AACA,QAAI,OAAO,cAAc,gBAAgB,QAAQ;AAC/C,gBAAU,yBAAyB,OAAO,cAAc,eAAe,KAAK,IAAI,CAAC;AAAA;AAAA,IACnF;AACA,QAAI,OAAO,cAAc,mBAAmB,QAAQ;AAClD,gBAAU,2BAA2B,OAAO,cAAc,kBAAkB,MAAM;AAAA;AAAA,IACpF;AACA,QAAI,OAAO,cAAc,mBAAmB,QAAQ;AAClD,gBAAU,kBAAkB,OAAO,cAAc,kBAAkB,MAAM;AAAA;AAAA,IAC3E;AACA,cAAU;AAAA,EACZ;AAEA,YAAU;AAAA;AAAA;AAEV,aAAW,QAAQ,OAAO,SAAS,CAAC,GAAG;AACrC,UAAM,YAAY,KAAK,SAAS,WAAM;AACtC,cAAU,GAAG,SAAS,MAAM,KAAK,IAAI;AACrC,QAAI,KAAK,MAAM;AACb,gBAAU,OAAO,KAAK,IAAI;AAAA,IAC5B;AACA,cAAU,MAAM,KAAK,WAAW;AAAA;AAEhC,QAAI,KAAK,SAAS;AAChB,gBAAU,MAAM,KAAK,OAAO;AAAA;AAAA,IAC9B;AAEA,QAAI,KAAK,YAAY,KAAK,SAAS,SAAS,GAAG;AAC7C,iBAAW,WAAW,KAAK,UAAU;AACnC,kBAAU,MAAM,OAAO;AAAA;AAAA,MACzB;AAAA,IACF;AAEA,QAAI,KAAK,OAAO;AACd,gBAAU,0BAAgB,KAAK,KAAK;AAAA;AAAA,IACtC;AAEA,QAAI,KAAK,oBAAoB,CAAC,KAAK,OAAO;AACxC,gBAAU;AAAA,KAAqB,KAAK,iBAAiB,MAAM,IAAI,EAAE,KAAK,OAAO,CAAC;AAAA;AAAA;AAAA,IAChF;AAEA,cAAU;AAAA,EACZ;AAEA,MAAI,CAAC,OAAO,gBAAgB;AAC1B,cAAU;AAAA;AAAA;AACV,cAAU;AAAA;AAAA,EACZ;AAEA,SAAO;AACT;AAKO,SAAS,sBAAsB,QAA4B;AAChE,SAAO,KAAK,UAAU,QAAQ,MAAM,CAAC;AACvC;AAKO,SAAS,yBAAyB,QAA4B;AACnE,QAAM,cAAc,OAAO,iBAAiB,WAAM;AAClD,QAAM,QAAQ,OAAO,SAAS,CAAC;AAC/B,QAAM,cAAc,MAAM,OAAO,OAAK,EAAE,MAAM,EAAE;AAChD,QAAM,cAAc,MAAM,OAAO,OAAK,CAAC,EAAE,MAAM,EAAE;AACjD,QAAM,eAAe,MAAM,OAAO,OAAK,EAAE,YAAY,EAAE,SAAS,SAAS,CAAC,EAAE;AAE5E,MAAI,UAAU,GAAG,WAAW,IAAI,OAAO,QAAQ,KAAK,WAAW,IAAI,MAAM,MAAM,YAAY,OAAO,iBAAiB;AACnH,MAAI,cAAc,GAAG;AACnB,eAAW,MAAM,WAAW;AAAA,EAC9B;AACA,MAAI,eAAe,GAAG;AACpB,eAAW,mBAAS,YAAY;AAAA,EAClC;AACA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../../src/lib/testing/formatter.ts"],"sourcesContent":["/**\n * Test result formatting for AdCP Agent E2E Testing\n */\n\nimport type { TestResult } from './types';\n\n/**\n * Format test results for display in Slack/chat\n */\nexport function formatTestResults(result: TestResult): string {\n  const statusEmoji = result.overall_passed ? '✅' : '❌';\n  let output = `## ${statusEmoji} Agent Test Results\\n\\n`;\n  output += `**Agent:** ${result.agent_url}\\n`;\n  output += `**Scenario:** ${result.scenario}\\n`;\n  output += `**Duration:** ${result.total_duration_ms}ms\\n`;\n  output += `**Result:** ${result.summary}\\n\\n`;\n\n  // Show agent profile if discovered\n  if (result.agent_profile) {\n    output += `### Agent Capabilities\\n`;\n    output += `- **Name:** ${result.agent_profile.name}\\n`;\n    output += `- **Tools:** ${result.agent_profile.tools.length}\\n`;\n    if (result.agent_profile.channels?.length) {\n      output += `- **Channels:** ${result.agent_profile.channels.join(', ')}\\n`;\n    }\n    if (result.agent_profile.pricing_models?.length) {\n      output += `- **Pricing Models:** ${result.agent_profile.pricing_models.join(', ')}\\n`;\n    }\n    if (result.agent_profile.supported_formats?.length) {\n      output += `- **Creative Formats:** ${result.agent_profile.supported_formats.length}\\n`;\n    }\n    if (result.agent_profile.supported_signals?.length) {\n      output += `- **Signals:** ${result.agent_profile.supported_signals.length}\\n`;\n    }\n    output += '\\n';\n  }\n\n  output += `### Test Steps\\n\\n`;\n\n  for (const step of result.steps ?? []) {\n    const stepEmoji = step.passed ? '✅' : '❌';\n    output += `${stepEmoji} **${step.step}**`;\n    if (step.task) {\n      output += ` (\\`${step.task}\\`)`;\n    }\n    output += ` - ${step.duration_ms}ms\\n`;\n\n    if (step.details) {\n      output += `   ${step.details}\\n`;\n    }\n\n    if (step.warnings && step.warnings.length > 0) {\n      for (const warning of step.warnings) {\n        output += `   ${warning}\\n`;\n      }\n    }\n\n    if (step.error) {\n      output += `   ⚠️ Error: ${step.error}\\n`;\n    }\n\n    if (step.response_preview && !step.error) {\n      output += `   \\`\\`\\`json\\n   ${step.response_preview.split('\\n').join('\\n   ')}\\n   \\`\\`\\`\\n`;\n    }\n\n    output += '\\n';\n  }\n\n  if (!result.overall_passed) {\n    output += `---\\n\\n`;\n    output += `💡 **Need help?** Ask me about specific errors or check the [AdCP documentation](https://adcontextprotocol.org/docs).\\n`;\n  }\n\n  return output;\n}\n\n/**\n * Format test results as JSON for programmatic use\n */\nexport function formatTestResultsJSON(result: TestResult): string {\n  return JSON.stringify(result, null, 2);\n}\n\n/**\n * Format test results as a compact summary\n */\nexport function formatTestResultsSummary(result: TestResult): string {\n  const statusEmoji = result.overall_passed ? '✅' : '❌';\n  const steps = result.steps ?? [];\n  const passedCount = steps.filter(s => s.passed).length;\n  const failedCount = steps.filter(s => !s.passed).length;\n  const warningCount = steps.filter(s => s.warnings && s.warnings.length > 0).length;\n\n  let summary = `${statusEmoji} ${result.scenario}: ${passedCount}/${steps.length} passed (${result.total_duration_ms}ms)`;\n  if (failedCount > 0) {\n    summary += ` - ${failedCount} failed`;\n  }\n  if (warningCount > 0) {\n    summary += ` - ⚠️ ${warningCount} warning(s)`;\n  }\n  return summary;\n}\n"],"mappings":"AASO,SAAS,kBAAkB,QAA4B;AAC5D,QAAM,cAAc,OAAO,iBAAiB,WAAM;AAClD,MAAI,SAAS,MAAM,WAAW;AAAA;AAAA;AAC9B,YAAU,cAAc,OAAO,SAAS;AAAA;AACxC,YAAU,iBAAiB,OAAO,QAAQ;AAAA;AAC1C,YAAU,iBAAiB,OAAO,iBAAiB;AAAA;AACnD,YAAU,eAAe,OAAO,OAAO;AAAA;AAAA;AAGvC,MAAI,OAAO,eAAe;AACxB,cAAU;AAAA;AACV,cAAU,eAAe,OAAO,cAAc,IAAI;AAAA;AAClD,cAAU,gBAAgB,OAAO,cAAc,MAAM,MAAM;AAAA;AAC3D,QAAI,OAAO,cAAc,UAAU,QAAQ;AACzC,gBAAU,mBAAmB,OAAO,cAAc,SAAS,KAAK,IAAI,CAAC;AAAA;AAAA,IACvE;AACA,QAAI,OAAO,cAAc,gBAAgB,QAAQ;AAC/C,gBAAU,yBAAyB,OAAO,cAAc,eAAe,KAAK,IAAI,CAAC;AAAA;AAAA,IACnF;AACA,QAAI,OAAO,cAAc,mBAAmB,QAAQ;AAClD,gBAAU,2BAA2B,OAAO,cAAc,kBAAkB,MAAM;AAAA;AAAA,IACpF;AACA,QAAI,OAAO,cAAc,mBAAmB,QAAQ;AAClD,gBAAU,kBAAkB,OAAO,cAAc,kBAAkB,MAAM;AAAA;AAAA,IAC3E;AACA,cAAU;AAAA,EACZ;AAEA,YAAU;AAAA;AAAA;AAEV,aAAW,QAAQ,OAAO,SAAS,CAAC,GAAG;AACrC,UAAM,YAAY,KAAK,SAAS,WAAM;AACtC,cAAU,GAAG,SAAS,MAAM,KAAK,IAAI;AACrC,QAAI,KAAK,MAAM;AACb,gBAAU,OAAO,KAAK,IAAI;AAAA,IAC5B;AACA,cAAU,MAAM,KAAK,WAAW;AAAA;AAEhC,QAAI,KAAK,SAAS;AAChB,gBAAU,MAAM,KAAK,OAAO;AAAA;AAAA,IAC9B;AAEA,QAAI,KAAK,YAAY,KAAK,SAAS,SAAS,GAAG;AAC7C,iBAAW,WAAW,KAAK,UAAU;AACnC,kBAAU,MAAM,OAAO;AAAA;AAAA,MACzB;AAAA,IACF;AAEA,QAAI,KAAK,OAAO;AACd,gBAAU,0BAAgB,KAAK,KAAK;AAAA;AAAA,IACtC;AAEA,QAAI,KAAK,oBAAoB,CAAC,KAAK,OAAO;AACxC,gBAAU;AAAA,KAAqB,KAAK,iBAAiB,MAAM,IAAI,EAAE,KAAK,OAAO,CAAC;AAAA;AAAA;AAAA,IAChF;AAEA,cAAU;AAAA,EACZ;AAEA,MAAI,CAAC,OAAO,gBAAgB;AAC1B,cAAU;AAAA;AAAA;AACV,cAAU;AAAA;AAAA,EACZ;AAEA,SAAO;AACT;AAKO,SAAS,sBAAsB,QAA4B;AAChE,SAAO,KAAK,UAAU,QAAQ,MAAM,CAAC;AACvC;AAKO,SAAS,yBAAyB,QAA4B;AACnE,QAAM,cAAc,OAAO,iBAAiB,WAAM;AAClD,QAAM,QAAQ,OAAO,SAAS,CAAC;AAC/B,QAAM,cAAc,MAAM,OAAO,OAAK,EAAE,MAAM,EAAE;AAChD,QAAM,cAAc,MAAM,OAAO,OAAK,CAAC,EAAE,MAAM,EAAE;AACjD,QAAM,eAAe,MAAM,OAAO,OAAK,EAAE,YAAY,EAAE,SAAS,SAAS,CAAC,EAAE;AAE5E,MAAI,UAAU,GAAG,WAAW,IAAI,OAAO,QAAQ,KAAK,WAAW,IAAI,MAAM,MAAM,YAAY,OAAO,iBAAiB;AACnH,MAAI,cAAc,GAAG;AACnB,eAAW,MAAM,WAAW;AAAA,EAC9B;AACA,MAAI,eAAe,GAAG;AACpB,eAAW,mBAAS,YAAY;AAAA,EAClC;AACA,SAAO;AACT;","names":[]}

package/dist/lib/testing/index.mjs

@@ -1,9 +1,3 @@
-import { fileURLToPath as __adcpFileURLToPath } from 'node:url';
-import { dirname as __adcpDirname } from 'node:path';
-import { createRequire as __adcpCreateRequire } from 'node:module';
-const __filename = __adcpFileURLToPath(import.meta.url);
-const __dirname = __adcpDirname(__filename);
-const require = __adcpCreateRequire(import.meta.url);
 import {
   testAgent,
   testAgentA2A,

package/dist/lib/testing/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/testing/index.ts"],"sourcesContent":["// Test helpers for AdCP client library\n// Provides pre-configured test agents for examples and quick testing\n\nexport {\n  // Test agents (with auth)\n  testAgent,\n  testAgentA2A,\n  testAgentClient,\n  createTestAgent,\n  TEST_AGENT_TOKEN,\n  TEST_AGENT_MCP_CONFIG,\n  TEST_AGENT_A2A_CONFIG,\n  // Test agents (without auth - for demonstrating auth requirements)\n  testAgentNoAuth,\n  testAgentNoAuthA2A,\n  TEST_AGENT_NO_AUTH_MCP_CONFIG,\n  TEST_AGENT_NO_AUTH_A2A_CONFIG,\n  // Creative agents (MCP only - A2A not yet supported)\n  creativeAgent,\n} from './test-helpers';\n\n// E2E Agent Testing Framework\nexport {\n  testAgent as runAgentTests,\n  formatTestResults,\n  formatTestResultsJSON,\n  formatTestResultsSummary,\n  setAgentTesterLogger,\n  getLogger,\n  createTestClient,\n  runStep,\n  // Individual scenarios\n  testHealthCheck,\n  testDiscovery,\n  testCreateMediaBuy,\n  testFullSalesFlow,\n  testReportingFlow,\n  testCreativeSync,\n  testCreativeInline,\n  testCreativeFlow,\n  testSignalsFlow,\n  testErrorHandling,\n  testValidation,\n  testPricingEdgeCases,\n  testTemporalValidation,\n  testBehaviorAnalysis,\n  testResponseConsistency,\n  // v3 scenarios\n  testGovernancePropertyLists,\n  testGovernanceContentStandards,\n  testPropertyListFilters,\n  testSISessionLifecycle,\n  testSIAvailability,\n  testSIHandoff,\n  testCapabilityDiscovery,\n  testSyncAudiences,\n  resolveAccountForMediaBuy,\n  resolveAccountForAudiences,\n  testSchemaCompliance,\n  // State machine compliance\n  testMediaBuyLifecycle,\n  testTerminalStateEnforcement,\n  testPackageLifecycle,\n  // Deterministic state machine testing\n  testCreativeStateMachine,\n  testMediaBuyStateMachine,\n  testAccountStateMachine,\n  testSessionStateMachine,\n  testDeliverySimulation,\n  testBudgetSimulation,\n  testControllerValidation,\n  // Brand rights\n  testBrandRightsFlow,\n  hasBrandRightsTools,\n  // v3 helpers\n  hasGovernanceTools,\n  hasSITools,\n  likelySupportsV3,\n  // Suite orchestrator\n  testAllScenarios,\n  getApplicableScenarios,\n  SCENARIO_REQUIREMENTS,\n  DEFAULT_SCENARIOS,\n  formatSuiteResults,\n  formatSuiteResultsJSON,\n  // Types\n  type TestScenario,\n  type TestOptions,\n  type OrchestratorOptions,\n  type TestResult,\n  type SuiteResult,\n  type TestStepResult,\n  type AgentProfile,\n  type TaskResult,\n  type TestClient,\n  type Logger,\n} from './agent-tester';\n\n// Compliance assessment\nexport {\n  comply,\n  formatComplianceResults,\n  formatComplianceResultsJSON,\n  // Brief library\n  SAMPLE_BRIEFS,\n  getBriefById,\n  getBriefsByVertical,\n  // Types\n  type ComplyOptions,\n  type ComplianceTrack,\n  type TrackResult,\n  type TrackStatus,\n  type ComplianceResult,\n  type ComplianceSummary,\n  type AdvisoryObservation,\n  type ObservationSource,\n  type SampleBrief,\n} from './compliance';\n\n// Test stubs for compliance testing\nexport { GovernanceAgentStub } from './stubs';\nexport type { StubCallRecord } from './stubs';\n\n// Controller response assertion helpers\nexport { expectControllerError, expectControllerSuccess } from './controller-assertions';\nexport type { ControllerErrorWithDetail } from './controller-assertions';\n\n// Seller-side comply_test_controller scaffold\nexport { createComplyController } from './comply-controller';\nexport type {\n  ComplyController,\n  ComplyControllerConfig,\n  ComplyControllerContext,\n  ComplyControllerToolDefinition,\n  DirectiveAdapter,\n  ForceAccountStatusParams,\n  ForceAdapter,\n  ForceAudienceStatusParams,\n  ForceCatalogItemStatusParams,\n  ForceCreateMediaBuyArmParams,\n  ForceGetProductsArmParams,\n  ForceGetSignalsArmParams,\n  ForceCreativeStatusParams,\n  ForceMediaBuyStatusParams,\n  ForceSessionStatusParams,\n  ForceTaskCompletionParams,\n  SeedAccountParams,\n  SeedAdapter,\n  SeedBuyerAgentParams,\n  SeedCreativeFormatParams,\n  SeedCreativeParams,\n  SeedMediaBuyParams,\n  SeedPlanParams,\n  SeedPricingOptionParams,\n  SeedProductParams,\n  SimulateAdapter,\n  SimulateBudgetSpendParams,\n  SimulateDeliveryParams,\n} from './comply-controller';\n// Re-export the full `comply_test_controller` integration surface so sellers\n// wiring their own `TestControllerStore` against typed domain state\n// (MediaBuyState, CreativeState, PlanState, …) can import everything they need\n// from a single path. See `examples/seller-test-controller.ts` for the\n// end-to-end pattern.\nexport {\n  TestControllerError,\n  CONTROLLER_SCENARIOS,\n  DISCOVERY_ARM_SCENARIOS,\n  SEED_SCENARIOS,\n  SESSION_ENTRY_CAP,\n  createSeedFixtureCache,\n  enforceMapCap,\n  registerTestController,\n} from '../server/test-controller';\nexport type {\n  ControllerScenario,\n  SeedFixtureCache,\n  SeedScenario,\n  TestControllerStore,\n  TestControllerStoreFactory,\n  TestControllerStoreOrFactory,\n} from '../server/test-controller';\n// Status enums every controller implementer mutates. Re-exported here so a\n// seller wiring `forceMediaBuyStatus` / `forceCreativeStatus` doesn't have to\n// reach into `@adcp/sdk` root just for the literal unions.\nexport type { AccountStatus, CreativeStatus, MediaBuyStatus } from '../types/core.generated';\n\n// Seed fixture merge helpers (permissive defaults + storyboard overlay).\nexport {\n  mergeSeed,\n  overlayById,\n  mergeSeedProduct,\n  mergeSeedPricingOption,\n  mergeSeedCreative,\n  mergeSeedPlan,\n  mergeSeedMediaBuy,\n} from './seed-merge';\n\n// Test-controller bridge: seeded augmentation of read-side responses on sandbox\n// requests. Per-tool callbacks (`getSeededProducts`, `getSeededCreatives`,\n// `getSeededMediaBuys`, `getSeededAccounts`, `getSeededAccountFinancials`,\n// `getSeededCreativeFormats`) opt in by presence — see TestControllerBridge.\nexport {\n  isSandboxRequest,\n  mergeSeededProductsIntoResponse,\n  filterValidSeededProducts,\n  filterValidSeededCreatives,\n  filterValidSeededMediaBuys,\n  filterValidSeededAccounts,\n  filterValidSeededAccountFinancials,\n  filterValidSeededCreativeFormats,\n  mergeSeededCreativesIntoResponse,\n  mergeSeededMediaBuysIntoResponse,\n  mergeSeededAccountsIntoResponse,\n  mergeSeededCreativeFormatsIntoResponse,\n  pickSeededAccountFinancialsForRequest,\n  replaceAccountFinancialsIfSeeded,\n  bridgeFromTestControllerStore,\n  bridgeFromSessionStore,\n} from '../server/test-controller-bridge';\nexport type {\n  TestControllerBridge,\n  TestControllerBridgeContext,\n  BridgeFromSessionStoreOptions,\n  SeededCreative,\n  SeededMediaBuy,\n  SeededAccountFinancials,\n} from '../server/test-controller-bridge';\n\n// One-call harness for server-side agents — composes serve() +\n// seedComplianceFixtures + createWebhookReceiver + runStoryboard.\nexport { runAgainstLocalAgent } from './local-agent-runner';\nexport type { LocalAgentRunResult, PerStoryboardOverride, RunAgainstLocalAgentOptions } from './local-agent-runner';\n\n// External schema bundles for hosted compliance/certification runs.\nexport { registerExternalSchemaRoot, unregisterExternalSchemaRoot, withExternalSchemaRoot } from '../validation';\n\n// Storyboard-driven testing\nexport {\n  // Runner\n  runStoryboard,\n  runStoryboardStep,\n  applyAdcpVersionRunOptions,\n  applyStoryboardVersionOptions,\n  getFirstStepPreview,\n  // Parser (single-file load for spec evolution)\n  parseStoryboard,\n  loadStoryboardFile,\n  // Compliance cache: capability-driven resolution\n  getComplianceCacheDir,\n  loadComplianceIndex,\n  listBundles,\n  loadBundleStoryboards,\n  listAllComplianceStoryboards,\n  getComplianceStoryboardById,\n  findBundleById,\n  resolveBundleOrStoryboard,\n  resolveStoryboardsForCapabilities,\n  isComplianceVersionSupported,\n  CapabilityResolutionError,\n  // Task mapping\n  TASK_TO_METHOD,\n  executeStoryboardTask,\n  // Context\n  extractContext,\n  injectContext,\n  // Validations\n  runValidations,\n  resolvePath,\n  // Rate-limit trip/replay observer\n  RateLimitTripObserver,\n  RATE_LIMIT_TRIP_CONTRACT,\n  RATE_LIMIT_TRIP_DEFAULT_REPLAY_MAX_WAIT_SECONDS,\n  RATE_LIMIT_TRIP_MAX_ATTEMPTS_MAX,\n  RATE_LIMIT_TRIP_MAX_ATTEMPTS_MIN,\n  validateRateLimitTripSpec,\n  // Sandbox entities\n  getSandboxEntities,\n  getSandboxBrands,\n  getSandboxBrand,\n  isSandboxDomain,\n  clearSandboxCache,\n  // Assertion registry (adcontextprotocol/adcp#2639) — authors of invariant\n  // modules import these from `@adcp/sdk/testing` to register cross-step\n  // checks the runner will resolve from `storyboard.invariants: [...]`.\n  registerAssertion,\n  getAssertion,\n  listAssertions,\n  listDefaultAssertions,\n  clearAssertionRegistry,\n  resolveAssertions,\n  type AssertionSpec,\n  type AssertionContext,\n  type AssertionResult,\n  type RegisterAssertionOptions,\n  // Types\n  type Storyboard,\n  type StoryboardInvariants,\n  type StoryboardInvariantsObject,\n  type StepInvariantsObject,\n  type StoryboardPhase,\n  type StoryboardStep,\n  type RateLimitTripSpec,\n  type StoryboardValidation,\n  type RateLimitTripClient,\n  type RateLimitTripFailureCode,\n  type RateLimitTripObservation,\n  type RateLimitTripObserverOptions,\n  type RateLimitTripResponseSnapshot,\n  type RateLimitTripStructuredResult,\n  type RateLimitTripTaskOptions,\n  type StoryboardContext,\n  type StoryboardRunOptions,\n  type ValidationResult,\n  type StoryboardStepPreview,\n  type StoryboardStepResult,\n  type StoryboardStepHint,\n  type StoryboardStepHintBase,\n  type ContextValueRejectedHint,\n  type ShapeDriftHint,\n  type MissingRequiredFieldHint,\n  type FormatMismatchHint,\n  type MonotonicViolationHint,\n  type ContextProvenanceEntry,\n  type StoryboardPhaseResult,\n  type StoryboardResult,\n  type RunnerNotice,\n  type NoticeCode,\n  type NoticeSeverity,\n  type AgentCapabilities,\n  type BundleKind,\n  type BundleRef,\n  type CapabilityResolutionCode,\n  type ComplianceIndex,\n  type ComplianceIndexProtocol,\n  type ComplianceIndexSpecialism,\n  type ResolveOptions,\n  type ResolvedBundle,\n  type ResolvedStoryboards,\n  type SandboxBrand,\n  type SandboxAgent,\n  type SandboxEntities,\n  type BrandJson,\n  type AdagentsJson,\n  BrandJsonSchema,\n  AdagentsJsonSchema,\n} from './storyboard';\n"],"mappings":";;;;;;AAGA;AAAA,EAEE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,OACK;AAGP;AAAA,EACe,aAAbA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;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,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAYK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,OAWK;AAGP,SAAS,2BAA2B;AAIpC,SAAS,uBAAuB,+BAA+B;AAI/D,SAAS,8BAA8B;AAoCvC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAeP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAMP;AAAA,EACE;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,OACK;AAYP,SAAS,4BAA4B;AAIrC,SAAS,4BAA4B,8BAA8B,8BAA8B;AAGjG;AAAA,EAEE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAIA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAsDA;AAAA,EACA;AAAA,OACK;","names":["testAgent"]}
+{"version":3,"sources":["../../../src/lib/testing/index.ts"],"sourcesContent":["// Test helpers for AdCP client library\n// Provides pre-configured test agents for examples and quick testing\n\nexport {\n  // Test agents (with auth)\n  testAgent,\n  testAgentA2A,\n  testAgentClient,\n  createTestAgent,\n  TEST_AGENT_TOKEN,\n  TEST_AGENT_MCP_CONFIG,\n  TEST_AGENT_A2A_CONFIG,\n  // Test agents (without auth - for demonstrating auth requirements)\n  testAgentNoAuth,\n  testAgentNoAuthA2A,\n  TEST_AGENT_NO_AUTH_MCP_CONFIG,\n  TEST_AGENT_NO_AUTH_A2A_CONFIG,\n  // Creative agents (MCP only - A2A not yet supported)\n  creativeAgent,\n} from './test-helpers';\n\n// E2E Agent Testing Framework\nexport {\n  testAgent as runAgentTests,\n  formatTestResults,\n  formatTestResultsJSON,\n  formatTestResultsSummary,\n  setAgentTesterLogger,\n  getLogger,\n  createTestClient,\n  runStep,\n  // Individual scenarios\n  testHealthCheck,\n  testDiscovery,\n  testCreateMediaBuy,\n  testFullSalesFlow,\n  testReportingFlow,\n  testCreativeSync,\n  testCreativeInline,\n  testCreativeFlow,\n  testSignalsFlow,\n  testErrorHandling,\n  testValidation,\n  testPricingEdgeCases,\n  testTemporalValidation,\n  testBehaviorAnalysis,\n  testResponseConsistency,\n  // v3 scenarios\n  testGovernancePropertyLists,\n  testGovernanceContentStandards,\n  testPropertyListFilters,\n  testSISessionLifecycle,\n  testSIAvailability,\n  testSIHandoff,\n  testCapabilityDiscovery,\n  testSyncAudiences,\n  resolveAccountForMediaBuy,\n  resolveAccountForAudiences,\n  testSchemaCompliance,\n  // State machine compliance\n  testMediaBuyLifecycle,\n  testTerminalStateEnforcement,\n  testPackageLifecycle,\n  // Deterministic state machine testing\n  testCreativeStateMachine,\n  testMediaBuyStateMachine,\n  testAccountStateMachine,\n  testSessionStateMachine,\n  testDeliverySimulation,\n  testBudgetSimulation,\n  testControllerValidation,\n  // Brand rights\n  testBrandRightsFlow,\n  hasBrandRightsTools,\n  // v3 helpers\n  hasGovernanceTools,\n  hasSITools,\n  likelySupportsV3,\n  // Suite orchestrator\n  testAllScenarios,\n  getApplicableScenarios,\n  SCENARIO_REQUIREMENTS,\n  DEFAULT_SCENARIOS,\n  formatSuiteResults,\n  formatSuiteResultsJSON,\n  // Types\n  type TestScenario,\n  type TestOptions,\n  type OrchestratorOptions,\n  type TestResult,\n  type SuiteResult,\n  type TestStepResult,\n  type AgentProfile,\n  type TaskResult,\n  type TestClient,\n  type Logger,\n} from './agent-tester';\n\n// Compliance assessment\nexport {\n  comply,\n  formatComplianceResults,\n  formatComplianceResultsJSON,\n  // Brief library\n  SAMPLE_BRIEFS,\n  getBriefById,\n  getBriefsByVertical,\n  // Types\n  type ComplyOptions,\n  type ComplianceTrack,\n  type TrackResult,\n  type TrackStatus,\n  type ComplianceResult,\n  type ComplianceSummary,\n  type AdvisoryObservation,\n  type ObservationSource,\n  type SampleBrief,\n} from './compliance';\n\n// Test stubs for compliance testing\nexport { GovernanceAgentStub } from './stubs';\nexport type { StubCallRecord } from './stubs';\n\n// Controller response assertion helpers\nexport { expectControllerError, expectControllerSuccess } from './controller-assertions';\nexport type { ControllerErrorWithDetail } from './controller-assertions';\n\n// Seller-side comply_test_controller scaffold\nexport { createComplyController } from './comply-controller';\nexport type {\n  ComplyController,\n  ComplyControllerConfig,\n  ComplyControllerContext,\n  ComplyControllerToolDefinition,\n  DirectiveAdapter,\n  ForceAccountStatusParams,\n  ForceAdapter,\n  ForceAudienceStatusParams,\n  ForceCatalogItemStatusParams,\n  ForceCreateMediaBuyArmParams,\n  ForceGetProductsArmParams,\n  ForceGetSignalsArmParams,\n  ForceCreativeStatusParams,\n  ForceMediaBuyStatusParams,\n  ForceSessionStatusParams,\n  ForceTaskCompletionParams,\n  SeedAccountParams,\n  SeedAdapter,\n  SeedBuyerAgentParams,\n  SeedCreativeFormatParams,\n  SeedCreativeParams,\n  SeedMediaBuyParams,\n  SeedPlanParams,\n  SeedPricingOptionParams,\n  SeedProductParams,\n  SimulateAdapter,\n  SimulateBudgetSpendParams,\n  SimulateDeliveryParams,\n} from './comply-controller';\n// Re-export the full `comply_test_controller` integration surface so sellers\n// wiring their own `TestControllerStore` against typed domain state\n// (MediaBuyState, CreativeState, PlanState, …) can import everything they need\n// from a single path. See `examples/seller-test-controller.ts` for the\n// end-to-end pattern.\nexport {\n  TestControllerError,\n  CONTROLLER_SCENARIOS,\n  DISCOVERY_ARM_SCENARIOS,\n  SEED_SCENARIOS,\n  SESSION_ENTRY_CAP,\n  createSeedFixtureCache,\n  enforceMapCap,\n  registerTestController,\n} from '../server/test-controller';\nexport type {\n  ControllerScenario,\n  SeedFixtureCache,\n  SeedScenario,\n  TestControllerStore,\n  TestControllerStoreFactory,\n  TestControllerStoreOrFactory,\n} from '../server/test-controller';\n// Status enums every controller implementer mutates. Re-exported here so a\n// seller wiring `forceMediaBuyStatus` / `forceCreativeStatus` doesn't have to\n// reach into `@adcp/sdk` root just for the literal unions.\nexport type { AccountStatus, CreativeStatus, MediaBuyStatus } from '../types/core.generated';\n\n// Seed fixture merge helpers (permissive defaults + storyboard overlay).\nexport {\n  mergeSeed,\n  overlayById,\n  mergeSeedProduct,\n  mergeSeedPricingOption,\n  mergeSeedCreative,\n  mergeSeedPlan,\n  mergeSeedMediaBuy,\n} from './seed-merge';\n\n// Test-controller bridge: seeded augmentation of read-side responses on sandbox\n// requests. Per-tool callbacks (`getSeededProducts`, `getSeededCreatives`,\n// `getSeededMediaBuys`, `getSeededAccounts`, `getSeededAccountFinancials`,\n// `getSeededCreativeFormats`) opt in by presence — see TestControllerBridge.\nexport {\n  isSandboxRequest,\n  mergeSeededProductsIntoResponse,\n  filterValidSeededProducts,\n  filterValidSeededCreatives,\n  filterValidSeededMediaBuys,\n  filterValidSeededAccounts,\n  filterValidSeededAccountFinancials,\n  filterValidSeededCreativeFormats,\n  mergeSeededCreativesIntoResponse,\n  mergeSeededMediaBuysIntoResponse,\n  mergeSeededAccountsIntoResponse,\n  mergeSeededCreativeFormatsIntoResponse,\n  pickSeededAccountFinancialsForRequest,\n  replaceAccountFinancialsIfSeeded,\n  bridgeFromTestControllerStore,\n  bridgeFromSessionStore,\n} from '../server/test-controller-bridge';\nexport type {\n  TestControllerBridge,\n  TestControllerBridgeContext,\n  BridgeFromSessionStoreOptions,\n  SeededCreative,\n  SeededMediaBuy,\n  SeededAccountFinancials,\n} from '../server/test-controller-bridge';\n\n// One-call harness for server-side agents — composes serve() +\n// seedComplianceFixtures + createWebhookReceiver + runStoryboard.\nexport { runAgainstLocalAgent } from './local-agent-runner';\nexport type { LocalAgentRunResult, PerStoryboardOverride, RunAgainstLocalAgentOptions } from './local-agent-runner';\n\n// External schema bundles for hosted compliance/certification runs.\nexport { registerExternalSchemaRoot, unregisterExternalSchemaRoot, withExternalSchemaRoot } from '../validation';\n\n// Storyboard-driven testing\nexport {\n  // Runner\n  runStoryboard,\n  runStoryboardStep,\n  applyAdcpVersionRunOptions,\n  applyStoryboardVersionOptions,\n  getFirstStepPreview,\n  // Parser (single-file load for spec evolution)\n  parseStoryboard,\n  loadStoryboardFile,\n  // Compliance cache: capability-driven resolution\n  getComplianceCacheDir,\n  loadComplianceIndex,\n  listBundles,\n  loadBundleStoryboards,\n  listAllComplianceStoryboards,\n  getComplianceStoryboardById,\n  findBundleById,\n  resolveBundleOrStoryboard,\n  resolveStoryboardsForCapabilities,\n  isComplianceVersionSupported,\n  CapabilityResolutionError,\n  // Task mapping\n  TASK_TO_METHOD,\n  executeStoryboardTask,\n  // Context\n  extractContext,\n  injectContext,\n  // Validations\n  runValidations,\n  resolvePath,\n  // Rate-limit trip/replay observer\n  RateLimitTripObserver,\n  RATE_LIMIT_TRIP_CONTRACT,\n  RATE_LIMIT_TRIP_DEFAULT_REPLAY_MAX_WAIT_SECONDS,\n  RATE_LIMIT_TRIP_MAX_ATTEMPTS_MAX,\n  RATE_LIMIT_TRIP_MAX_ATTEMPTS_MIN,\n  validateRateLimitTripSpec,\n  // Sandbox entities\n  getSandboxEntities,\n  getSandboxBrands,\n  getSandboxBrand,\n  isSandboxDomain,\n  clearSandboxCache,\n  // Assertion registry (adcontextprotocol/adcp#2639) — authors of invariant\n  // modules import these from `@adcp/sdk/testing` to register cross-step\n  // checks the runner will resolve from `storyboard.invariants: [...]`.\n  registerAssertion,\n  getAssertion,\n  listAssertions,\n  listDefaultAssertions,\n  clearAssertionRegistry,\n  resolveAssertions,\n  type AssertionSpec,\n  type AssertionContext,\n  type AssertionResult,\n  type RegisterAssertionOptions,\n  // Types\n  type Storyboard,\n  type StoryboardInvariants,\n  type StoryboardInvariantsObject,\n  type StepInvariantsObject,\n  type StoryboardPhase,\n  type StoryboardStep,\n  type RateLimitTripSpec,\n  type StoryboardValidation,\n  type RateLimitTripClient,\n  type RateLimitTripFailureCode,\n  type RateLimitTripObservation,\n  type RateLimitTripObserverOptions,\n  type RateLimitTripResponseSnapshot,\n  type RateLimitTripStructuredResult,\n  type RateLimitTripTaskOptions,\n  type StoryboardContext,\n  type StoryboardRunOptions,\n  type ValidationResult,\n  type StoryboardStepPreview,\n  type StoryboardStepResult,\n  type StoryboardStepHint,\n  type StoryboardStepHintBase,\n  type ContextValueRejectedHint,\n  type ShapeDriftHint,\n  type MissingRequiredFieldHint,\n  type FormatMismatchHint,\n  type MonotonicViolationHint,\n  type ContextProvenanceEntry,\n  type StoryboardPhaseResult,\n  type StoryboardResult,\n  type RunnerNotice,\n  type NoticeCode,\n  type NoticeSeverity,\n  type AgentCapabilities,\n  type BundleKind,\n  type BundleRef,\n  type CapabilityResolutionCode,\n  type ComplianceIndex,\n  type ComplianceIndexProtocol,\n  type ComplianceIndexSpecialism,\n  type ResolveOptions,\n  type ResolvedBundle,\n  type ResolvedStoryboards,\n  type SandboxBrand,\n  type SandboxAgent,\n  type SandboxEntities,\n  type BrandJson,\n  type AdagentsJson,\n  BrandJsonSchema,\n  AdagentsJsonSchema,\n} from './storyboard';\n"],"mappings":"AAGA;AAAA,EAEE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,OACK;AAGP;AAAA,EACe,aAAbA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;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,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAYK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,OAWK;AAGP,SAAS,2BAA2B;AAIpC,SAAS,uBAAuB,+BAA+B;AAI/D,SAAS,8BAA8B;AAoCvC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAeP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAMP;AAAA,EACE;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,OACK;AAYP,SAAS,4BAA4B;AAIrC,SAAS,4BAA4B,8BAA8B,8BAA8B;AAGjG;AAAA,EAEE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAIA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAsDA;AAAA,EACA;AAAA,OACK;","names":["testAgent"]}

package/dist/lib/testing/local-agent-runner.mjs

@@ -1,9 +1,3 @@
-import { fileURLToPath as __adcpFileURLToPath } from 'node:url';
-import { dirname as __adcpDirname } from 'node:path';
-import { createRequire as __adcpCreateRequire } from 'node:module';
-const __filename = __adcpFileURLToPath(import.meta.url);
-const __dirname = __adcpDirname(__filename);
-const require = __adcpCreateRequire(import.meta.url);
 import { createServer as createNetProbe } from "node:net";
 import { InMemoryTaskStore } from "@modelcontextprotocol/sdk/experimental/tasks/stores/in-memory.js";
 import { ADCP_STATE_STORE } from "../server/adcp-server.mjs";

package/dist/lib/testing/local-agent-runner.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/testing/local-agent-runner.ts"],"sourcesContent":["/**\n * `runAgainstLocalAgent` — one-call compliance harness for server-side\n * AdCP agents.\n *\n * The 300-line \"spin up my Express-equivalent, seed fixtures, create a\n * webhook receiver, loop through storyboards, aggregate results\" loop\n * sellers keep hand-rolling collapses into:\n *\n * ```ts\n * const result = await runAgainstLocalAgent({\n *   createAgent: () => createAdcpServer({ ...myHandlers, stateStore }),\n *   capabilities: { supported_protocols: ['media-buy'], specialisms: ['sales-non-guaranteed'] },\n * });\n * ```\n *\n * What it composes:\n *   - {@link serve} on an ephemeral port (real HTTP transport — MCP\n *     wire-format bugs surface, unlike in-memory dispatch)\n *   - {@link seedComplianceFixtures} against the `AdcpServer` (skipped\n *     when the caller returns a raw `McpServer`)\n *   - Optional `createTestAuthorizationServer` for closed-loop OAuth\n *   - {@link runStoryboard} per applicable storyboard, with\n *     `webhook_receiver: { mode: 'loopback_mock' }` wired by default so\n *     the webhook-emission universal grades instead of skipping\n *\n * The caller's `createAgent` factory MUST close over a stable\n * `stateStore` so fixtures seeded once persist across requests. The\n * `serve()` contract calls the factory once per request — every call\n * needs to see the same store.\n *\n * What this helper does NOT do:\n *   - Start tunnels (use the CLI's `--webhook-receiver-auto-tunnel` when\n *     fronting a remote agent instead)\n *   - Mint tokens per-storyboard automatically — call\n *     `authorizationServer.issueToken()` in `onListening` and stash the\n *     result on `runStoryboardOptions.auth` when a flow needs one\n */\n\nimport { createServer as createNetProbe, type AddressInfo } from 'node:net';\nimport { InMemoryTaskStore } from '@modelcontextprotocol/sdk/experimental/tasks/stores/in-memory.js';\nimport type { TaskStore } from '@modelcontextprotocol/sdk/experimental/tasks/interfaces.js';\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { Server as HttpServer } from 'node:http';\nimport type { AdcpServer } from '../server/adcp-server';\nimport { ADCP_STATE_STORE } from '../server/adcp-server';\nimport { serve, type ServeContext, type ServeOptions, type ProtectedResourceMetadata } from '../server/serve';\nimport { seedComplianceFixtures, type SeedComplianceFixturesOptions } from '../compliance-fixtures';\nimport {\n  createTestAuthorizationServer,\n  type TestAuthorizationServer,\n  type TestAuthorizationServerOptions,\n} from '../compliance-fixtures/test-authorization-server';\nimport {\n  listAllComplianceStoryboards,\n  resolveBundleOrStoryboard,\n  resolveStoryboardsForCapabilities,\n  type AgentCapabilities,\n  type ResolveOptions,\n} from './storyboard/compliance';\nimport { runStoryboard } from './storyboard/runner';\nimport type { Storyboard, StoryboardResult, StoryboardRunOptions } from './storyboard/types';\n\nexport interface RunAgainstLocalAgentOptions {\n  /**\n   * Factory matching {@link serve}'s contract. Receives a {@link ServeContext}\n   * with a shared `taskStore` and returns either an `AdcpServer` or a raw\n   * `McpServer`. Called once per HTTP request plus once ahead of time by\n   * the helper to seed fixtures — the factory MUST close over a stable\n   * `stateStore` so every call sees the same data.\n   */\n  createAgent: (ctx: ServeContext) => AdcpServer | McpServer;\n\n  /**\n   * Which storyboards to run:\n   *   - `'all'` (default): every storyboard in the compliance cache\n   *   - `AgentCapabilities`: capability-driven resolution (the same\n   *     predicate the live assessment runner uses on an agent's own\n   *     `get_adcp_capabilities` response)\n   *   - `string[]`: storyboard or bundle ids\n   *   - `Storyboard[]`: already-loaded storyboards\n   */\n  storyboards?: 'all' | AgentCapabilities | string[] | Storyboard[];\n\n  /**\n   * Seed {@link COMPLIANCE_FIXTURES} into the `AdcpServer`'s state store\n   * before the first storyboard. Defaults to `true` when `createAgent`\n   * returns an `AdcpServer`; ignored when it returns a raw `McpServer`.\n   *\n   * Pass an options object to customize categories / overrides.\n   */\n  fixtures?: boolean | SeedComplianceFixturesOptions;\n\n  /**\n   * Host a loopback webhook receiver per storyboard so `expect_webhook*`\n   * steps grade instead of skipping. Defaults to `true`. Set `false` to\n   * skip, or supply a partial config to override defaults.\n   */\n  webhookReceiver?: boolean | StoryboardRunOptions['webhook_receiver'];\n\n  /**\n   * Stand up a test authorization server and advertise it via RFC 9728\n   * protected-resource metadata on the agent. Defaults to `false` — most\n   * sellers don't need OAuth in local loops. When enabled:\n   *\n   *   - Starts a {@link createTestAuthorizationServer}\n   *   - Passes `protectedResource: { authorization_servers: [AS.issuer] }`\n   *     and `publicUrl` to `serve()`\n   *   - Exposes `auth` on the `onListening` hook so callers can mint tokens\n   */\n  authorizationServer?: boolean | TestAuthorizationServerOptions;\n\n  /**\n   * Extra options forwarded to {@link serve}. `port`, `onListening`,\n   * `publicUrl`, `taskStore`, and `protectedResource` are managed by the\n   * helper and values passed here are ignored.\n   */\n  serveOptions?: Omit<ServeOptions, 'port' | 'onListening' | 'publicUrl' | 'protectedResource' | 'taskStore'>;\n\n  /**\n   * Forwarded to every `runStoryboard` call. `webhook_receiver` is set by\n   * the helper — use `webhookReceiver` at the top level to override.\n   *\n   * `allow_http` defaults to `true` when the helper is running against its\n   * own ephemeral `http://127.0.0.1:<port>/mcp` URL — the storyboard\n   * runner's SSRF guard would otherwise refuse to probe the in-process\n   * agent it just stood up. Pass `allow_http: false` here if you redirect\n   * storyboards to an external `https://` agent via\n   * `resolvePerStoryboard` and want loopback-protection back.\n   */\n  runStoryboardOptions?: Omit<StoryboardRunOptions, 'webhook_receiver'>;\n\n  /**\n   * Produce per-storyboard overrides, called once per storyboard right\n   * before `runStoryboard`. Return `undefined` (or an empty object) to use\n   * the defaults; otherwise:\n   *\n   *   - `agentUrl` — redirect this storyboard to a different URL than the\n   *     ephemeral `http://127.0.0.1:<port>/mcp` the helper bound. Useful\n   *     when one storyboard needs to hit a stricter sibling route (e.g.\n   *     `/mcp-strict` for the `signed_requests` storyboard) while the rest\n   *     stay on the sandbox mount.\n   *   - every other `StoryboardRunOptions` field is shallow-merged on top\n   *     of the run-level `runStoryboardOptions`. Common uses: per-\n   *     storyboard `test_kit`, `brand`, or `contracts` that vary with the\n   *     storyboard under test. `webhook_receiver` is owned by the helper's\n   *     `webhookReceiver` field and is typed out of the override shape —\n   *     the helper re-applies it after the merge so overrides can't stomp\n   *     the loopback mock.\n   *\n   * Returning a `Promise` is supported so callers can do async work per\n   * storyboard (load a test-kit YAML, mint a scoped token, fetch brand\n   * metadata). The helper awaits before issuing `runStoryboard`.\n   */\n  resolvePerStoryboard?: (\n    storyboard: Storyboard,\n    defaultAgentUrl: string\n  ) => PerStoryboardOverride | undefined | Promise<PerStoryboardOverride | undefined>;\n\n  /** Compliance cache overrides. */\n  compliance?: ResolveOptions;\n\n  /**\n   * Streaming callback fired after each storyboard completes. Useful for\n   * CLI progress output so implementors don't wait for the full aggregate.\n   */\n  onStoryboardComplete?: (result: StoryboardResult, index: number, total: number) => void;\n\n  /**\n   * Called once the agent is bound and fixtures are seeded. Receives the\n   * canonical agent URL plus (when enabled) the AS handle. Use it to mint\n   * tokens and stash them on `runStoryboardOptions.auth`, or to seed\n   * non-fixture state.\n   */\n  onListening?: (info: { agentUrl: string; auth?: TestAuthorizationServer }) => void | Promise<void>;\n\n  /**\n   * Stop after the first failing storyboard. Defaults to `false` — the\n   * helper runs every storyboard so every failure site is visible.\n   */\n  bail?: boolean;\n}\n\n/**\n * Per-storyboard override returned by {@link RunAgainstLocalAgentOptions.resolvePerStoryboard}.\n *\n * `agentUrl` redirects the storyboard to a different URL. Every other\n * `StoryboardRunOptions` field is shallow-merged on top of the run-level\n * defaults. `webhook_receiver` is intentionally omitted — the helper owns\n * that field via its `webhookReceiver` option and re-applies it after the\n * merge.\n */\nexport type PerStoryboardOverride = { agentUrl?: string } & Omit<Partial<StoryboardRunOptions>, 'webhook_receiver'>;\n\nexport interface LocalAgentRunResult {\n  /** True iff every storyboard passed (steps + assertions). */\n  overall_passed: boolean;\n  /** Canonical URL the helper mounted the agent at. */\n  agent_url: string;\n  /** Per-storyboard results, in run order. */\n  results: StoryboardResult[];\n  /** Storyboards skipped because the agent's capabilities place them out of scope. */\n  not_applicable: Array<{ storyboard_id: string; storyboard_title: string; reason: string }>;\n  /** Sum across all run storyboards. */\n  passed_count: number;\n  failed_count: number;\n  skipped_count: number;\n  total_duration_ms: number;\n}\n\n/**\n * True when `url` is an http:// (not https://) URL pointing at a loopback\n * host — used to decide whether the SSRF guard's HTTPS-only default can be\n * relaxed. Must be tight: a `http://` prefix alone is NOT sufficient (a\n * caller override could redirect to `http://attacker.example.com/mcp` and\n * inherit the allowance). Only `127.0.0.1`, `::1`, and `localhost` count.\n *\n * @internal\n */\nfunction isLoopbackHttpUrl(url: string): boolean {\n  try {\n    const parsed = new URL(url);\n    if (parsed.protocol !== 'http:') return false;\n    // `URL.hostname` wraps IPv6 literals in brackets (`[::1]`); strip them\n    // to match the bare forms typical in SSRF loopback checks.\n    const host = parsed.hostname.replace(/^\\[|\\]$/g, '').toLowerCase();\n    return host === '127.0.0.1' || host === '::1' || host === 'localhost';\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Run storyboards against an in-process AdCP agent. Handles lifecycle:\n * bind, seed, (optional) token issuance, loop, tear down.\n */\nexport async function runAgainstLocalAgent(options: RunAgainstLocalAgentOptions): Promise<LocalAgentRunResult> {\n  const startedAt = Date.now();\n  const mountPath = options.serveOptions?.path ?? '/mcp';\n  const taskStore: TaskStore = new InMemoryTaskStore();\n  // Bootstrap the factory once with a synthetic host so seeding and\n  // fixture preparation run before the server ever binds. `serve()` will\n  // pass the real per-request host when it calls the factory again.\n  const ctx: ServeContext = { taskStore, host: '' };\n\n  let auth: TestAuthorizationServer | undefined;\n  let httpServer: HttpServer | undefined;\n\n  try {\n    if (options.authorizationServer) {\n      const authOptions = typeof options.authorizationServer === 'object' ? options.authorizationServer : {};\n      auth = await createTestAuthorizationServer(authOptions);\n    }\n\n    // Bootstrap: call the factory once ahead of time to get an AdcpServer\n    // we can seed against. serve() will call the factory again for every\n    // real request — the user's stateStore closure guarantees seeds persist.\n    const bootstrapAgent = options.createAgent(ctx);\n    const bootstrapIsAdcp = isAdcpServer(bootstrapAgent);\n    if (bootstrapIsAdcp && options.fixtures !== false) {\n      const seedOptions = typeof options.fixtures === 'object' ? options.fixtures : {};\n      await seedComplianceFixtures(bootstrapAgent, seedOptions);\n    }\n    // Release the bootstrap instance so serve()'s per-request factory calls\n    // produce fresh servers. Closing is idempotent.\n    await bootstrapAgent.close();\n\n    const protectedResource: ProtectedResourceMetadata | undefined = auth\n      ? { authorization_servers: [auth.issuer] }\n      : undefined;\n    // For the common unauthenticated local-agent path, bind port 0 directly\n    // and read the assigned port after listen. This avoids the allocate-then-\n    // bind race where another parallel test can claim the probed port.\n    // OAuth protected-resource metadata still needs a publicUrl before\n    // serve() construction, so that path keeps the preallocated port.\n    const port = protectedResource ? await allocatePort() : 0;\n    const publicUrl = `http://127.0.0.1:${port}${mountPath}`;\n    let agentUrl = publicUrl;\n\n    httpServer = serve(options.createAgent, {\n      ...options.serveOptions,\n      taskStore,\n      port,\n      ...(protectedResource ? { protectedResource, publicUrl } : {}),\n      onListening: () => {\n        /* swallow the default console.log — callers can observe via onListening */\n      },\n    });\n\n    await waitForListening(httpServer);\n    if (!protectedResource) {\n      const address = httpServer.address();\n      if (!address || typeof address === 'string') {\n        throw new Error('runAgainstLocalAgent: local HTTP server did not expose a TCP address');\n      }\n      agentUrl = `http://127.0.0.1:${address.port}${mountPath}`;\n    }\n\n    if (options.onListening) {\n      await options.onListening({ agentUrl, auth });\n    }\n\n    const toRun = await resolveStoryboardSet(options);\n    const results: StoryboardResult[] = [];\n    let passed = 0;\n    let failed = 0;\n    let skipped = 0;\n\n    const webhookConfig = resolveWebhookReceiver(options.webhookReceiver);\n    const explicitAllowHttp = options.runStoryboardOptions?.allow_http;\n    const baseRunOptions: Omit<StoryboardRunOptions, 'webhook_receiver' | 'allow_http'> = {\n      ...(options.runStoryboardOptions ?? {}),\n    };\n    // `allow_http` is removed from baseRunOptions and recomputed per\n    // storyboard below — inheriting `true` across storyboards would let a\n    // `resolvePerStoryboard` override that redirected to a remote\n    // `http://...` URL bypass the SSRF guard and silently probe an\n    // attacker-controlled target with private-IP allowance.\n    delete (baseRunOptions as { allow_http?: unknown }).allow_http;\n\n    for (let i = 0; i < toRun.storyboards.length; i++) {\n      const sb = toRun.storyboards[i]!;\n      const override = (await options.resolvePerStoryboard?.(sb, agentUrl)) ?? undefined;\n      const { agentUrl: overrideUrl, ...overrideRunOptions } = override ?? {};\n      const storyboardUrl = overrideUrl ?? agentUrl;\n      // Tighten the SSRF-guard bypass: only auto-opt-in `allow_http` when\n      // THIS storyboard's URL is loopback-bound (what the helper owns).\n      // An override to `http://attacker.example.com/...` must not\n      // inherit the default — that would re-enable the private-IP\n      // allowance against attacker-controlled infrastructure.\n      const storyboardIsLoopbackHttp = isLoopbackHttpUrl(storyboardUrl);\n      const effectiveAllowHttp =\n        (overrideRunOptions as { allow_http?: boolean }).allow_http ?? explicitAllowHttp ?? storyboardIsLoopbackHttp;\n      // webhook_receiver is helper-owned — re-applied after the merge so\n      // overrides can't replace the loopback mock the helper promised.\n      const storyboardOptions: StoryboardRunOptions = {\n        ...baseRunOptions,\n        ...overrideRunOptions,\n        allow_http: effectiveAllowHttp,\n        ...(webhookConfig ? { webhook_receiver: webhookConfig } : {}),\n      };\n      const result = await runStoryboard(storyboardUrl, sb, storyboardOptions);\n      results.push(result);\n      passed += result.passed_count;\n      failed += result.failed_count;\n      skipped += result.skipped_count;\n      if (options.onStoryboardComplete) {\n        options.onStoryboardComplete(result, i, toRun.storyboards.length);\n      }\n      if (options.bail && !result.overall_passed) break;\n    }\n\n    return {\n      overall_passed: results.every(r => r.overall_passed),\n      agent_url: agentUrl,\n      results,\n      not_applicable: toRun.not_applicable,\n      passed_count: passed,\n      failed_count: failed,\n      skipped_count: skipped,\n      total_duration_ms: Date.now() - startedAt,\n    };\n  } finally {\n    await closeHttpServer(httpServer);\n    if (auth) await auth.close();\n  }\n}\n\n// ────────────────────────────────────────────────────────────\n// Helpers\n// ────────────────────────────────────────────────────────────\n\nfunction isAdcpServer(candidate: unknown): candidate is AdcpServer {\n  if (candidate == null || typeof candidate !== 'object') return false;\n  return typeof (candidate as Record<symbol, unknown>)[ADCP_STATE_STORE] === 'object';\n}\n\nfunction resolveWebhookReceiver(\n  option: RunAgainstLocalAgentOptions['webhookReceiver']\n): StoryboardRunOptions['webhook_receiver'] | undefined {\n  if (option === false) return undefined;\n  if (option === true || option === undefined) return { mode: 'loopback_mock' };\n  return option;\n}\n\nasync function resolveStoryboardSet(options: RunAgainstLocalAgentOptions): Promise<{\n  storyboards: Storyboard[];\n  not_applicable: Array<{ storyboard_id: string; storyboard_title: string; reason: string }>;\n}> {\n  const spec = options.storyboards ?? 'all';\n  const compliance = options.compliance ?? {};\n  if (spec === 'all') {\n    return { storyboards: listAllComplianceStoryboards(compliance), not_applicable: [] };\n  }\n  if (Array.isArray(spec)) {\n    if (spec.length === 0) return { storyboards: [], not_applicable: [] };\n    if (typeof spec[0] === 'object' && 'phases' in (spec[0] as Storyboard)) {\n      return { storyboards: spec as Storyboard[], not_applicable: [] };\n    }\n    const resolved: Storyboard[] = [];\n    const unknown: string[] = [];\n    for (const id of spec as string[]) {\n      const matches = resolveBundleOrStoryboard(id, compliance);\n      if (matches.length === 0) {\n        unknown.push(id);\n      } else {\n        resolved.push(...matches);\n      }\n    }\n    if (unknown.length > 0) {\n      throw new Error(\n        `runAgainstLocalAgent: unknown storyboard or bundle id(s): ${unknown.join(', ')}. ` +\n          `Run \\`adcp storyboard list\\` to see available ids.`\n      );\n    }\n    const seen = new Set<string>();\n    return {\n      storyboards: resolved.filter(sb => (seen.has(sb.id) ? false : (seen.add(sb.id), true))),\n      not_applicable: [],\n    };\n  }\n  const resolved = resolveStoryboardsForCapabilities(spec, compliance);\n  return {\n    storyboards: resolved.storyboards,\n    not_applicable: resolved.not_applicable.map(n => ({\n      storyboard_id: n.storyboard_id,\n      storyboard_title: n.storyboard_title,\n      reason: n.reason,\n    })),\n  };\n}\n\nfunction allocatePort(): Promise<number> {\n  return new Promise((resolve, reject) => {\n    const probe = createNetProbe();\n    probe.unref();\n    probe.on('error', reject);\n    probe.listen(0, '127.0.0.1', () => {\n      const { port } = probe.address() as AddressInfo;\n      probe.close(err => (err ? reject(err) : resolve(port)));\n    });\n  });\n}\n\nfunction waitForListening(server: HttpServer): Promise<void> {\n  if (server.listening) return Promise.resolve();\n  return new Promise<void>((resolve, reject) => {\n    const onListening = () => {\n      cleanup();\n      resolve();\n    };\n    const onError = (err: Error) => {\n      cleanup();\n      reject(err);\n    };\n    const cleanup = () => {\n      server.off('listening', onListening);\n      server.off('error', onError);\n    };\n    server.on('listening', onListening);\n    server.on('error', onError);\n  });\n}\n\nfunction closeHttpServer(server: HttpServer | undefined): Promise<void> {\n  if (!server) return Promise.resolve();\n  return new Promise<void>((resolve, reject) => {\n    server.closeAllConnections?.();\n    server.close(err => {\n      if (err && (err as NodeJS.ErrnoException).code !== 'ERR_SERVER_NOT_RUNNING') reject(err);\n      else resolve();\n    });\n  });\n}\n"],"mappings":"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","names":["resolved"]}
+{"version":3,"sources":["../../../src/lib/testing/local-agent-runner.ts"],"sourcesContent":["/**\n * `runAgainstLocalAgent` — one-call compliance harness for server-side\n * AdCP agents.\n *\n * The 300-line \"spin up my Express-equivalent, seed fixtures, create a\n * webhook receiver, loop through storyboards, aggregate results\" loop\n * sellers keep hand-rolling collapses into:\n *\n * ```ts\n * const result = await runAgainstLocalAgent({\n *   createAgent: () => createAdcpServer({ ...myHandlers, stateStore }),\n *   capabilities: { supported_protocols: ['media-buy'], specialisms: ['sales-non-guaranteed'] },\n * });\n * ```\n *\n * What it composes:\n *   - {@link serve} on an ephemeral port (real HTTP transport — MCP\n *     wire-format bugs surface, unlike in-memory dispatch)\n *   - {@link seedComplianceFixtures} against the `AdcpServer` (skipped\n *     when the caller returns a raw `McpServer`)\n *   - Optional `createTestAuthorizationServer` for closed-loop OAuth\n *   - {@link runStoryboard} per applicable storyboard, with\n *     `webhook_receiver: { mode: 'loopback_mock' }` wired by default so\n *     the webhook-emission universal grades instead of skipping\n *\n * The caller's `createAgent` factory MUST close over a stable\n * `stateStore` so fixtures seeded once persist across requests. The\n * `serve()` contract calls the factory once per request — every call\n * needs to see the same store.\n *\n * What this helper does NOT do:\n *   - Start tunnels (use the CLI's `--webhook-receiver-auto-tunnel` when\n *     fronting a remote agent instead)\n *   - Mint tokens per-storyboard automatically — call\n *     `authorizationServer.issueToken()` in `onListening` and stash the\n *     result on `runStoryboardOptions.auth` when a flow needs one\n */\n\nimport { createServer as createNetProbe, type AddressInfo } from 'node:net';\nimport { InMemoryTaskStore } from '@modelcontextprotocol/sdk/experimental/tasks/stores/in-memory.js';\nimport type { TaskStore } from '@modelcontextprotocol/sdk/experimental/tasks/interfaces.js';\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { Server as HttpServer } from 'node:http';\nimport type { AdcpServer } from '../server/adcp-server';\nimport { ADCP_STATE_STORE } from '../server/adcp-server';\nimport { serve, type ServeContext, type ServeOptions, type ProtectedResourceMetadata } from '../server/serve';\nimport { seedComplianceFixtures, type SeedComplianceFixturesOptions } from '../compliance-fixtures';\nimport {\n  createTestAuthorizationServer,\n  type TestAuthorizationServer,\n  type TestAuthorizationServerOptions,\n} from '../compliance-fixtures/test-authorization-server';\nimport {\n  listAllComplianceStoryboards,\n  resolveBundleOrStoryboard,\n  resolveStoryboardsForCapabilities,\n  type AgentCapabilities,\n  type ResolveOptions,\n} from './storyboard/compliance';\nimport { runStoryboard } from './storyboard/runner';\nimport type { Storyboard, StoryboardResult, StoryboardRunOptions } from './storyboard/types';\n\nexport interface RunAgainstLocalAgentOptions {\n  /**\n   * Factory matching {@link serve}'s contract. Receives a {@link ServeContext}\n   * with a shared `taskStore` and returns either an `AdcpServer` or a raw\n   * `McpServer`. Called once per HTTP request plus once ahead of time by\n   * the helper to seed fixtures — the factory MUST close over a stable\n   * `stateStore` so every call sees the same data.\n   */\n  createAgent: (ctx: ServeContext) => AdcpServer | McpServer;\n\n  /**\n   * Which storyboards to run:\n   *   - `'all'` (default): every storyboard in the compliance cache\n   *   - `AgentCapabilities`: capability-driven resolution (the same\n   *     predicate the live assessment runner uses on an agent's own\n   *     `get_adcp_capabilities` response)\n   *   - `string[]`: storyboard or bundle ids\n   *   - `Storyboard[]`: already-loaded storyboards\n   */\n  storyboards?: 'all' | AgentCapabilities | string[] | Storyboard[];\n\n  /**\n   * Seed {@link COMPLIANCE_FIXTURES} into the `AdcpServer`'s state store\n   * before the first storyboard. Defaults to `true` when `createAgent`\n   * returns an `AdcpServer`; ignored when it returns a raw `McpServer`.\n   *\n   * Pass an options object to customize categories / overrides.\n   */\n  fixtures?: boolean | SeedComplianceFixturesOptions;\n\n  /**\n   * Host a loopback webhook receiver per storyboard so `expect_webhook*`\n   * steps grade instead of skipping. Defaults to `true`. Set `false` to\n   * skip, or supply a partial config to override defaults.\n   */\n  webhookReceiver?: boolean | StoryboardRunOptions['webhook_receiver'];\n\n  /**\n   * Stand up a test authorization server and advertise it via RFC 9728\n   * protected-resource metadata on the agent. Defaults to `false` — most\n   * sellers don't need OAuth in local loops. When enabled:\n   *\n   *   - Starts a {@link createTestAuthorizationServer}\n   *   - Passes `protectedResource: { authorization_servers: [AS.issuer] }`\n   *     and `publicUrl` to `serve()`\n   *   - Exposes `auth` on the `onListening` hook so callers can mint tokens\n   */\n  authorizationServer?: boolean | TestAuthorizationServerOptions;\n\n  /**\n   * Extra options forwarded to {@link serve}. `port`, `onListening`,\n   * `publicUrl`, `taskStore`, and `protectedResource` are managed by the\n   * helper and values passed here are ignored.\n   */\n  serveOptions?: Omit<ServeOptions, 'port' | 'onListening' | 'publicUrl' | 'protectedResource' | 'taskStore'>;\n\n  /**\n   * Forwarded to every `runStoryboard` call. `webhook_receiver` is set by\n   * the helper — use `webhookReceiver` at the top level to override.\n   *\n   * `allow_http` defaults to `true` when the helper is running against its\n   * own ephemeral `http://127.0.0.1:<port>/mcp` URL — the storyboard\n   * runner's SSRF guard would otherwise refuse to probe the in-process\n   * agent it just stood up. Pass `allow_http: false` here if you redirect\n   * storyboards to an external `https://` agent via\n   * `resolvePerStoryboard` and want loopback-protection back.\n   */\n  runStoryboardOptions?: Omit<StoryboardRunOptions, 'webhook_receiver'>;\n\n  /**\n   * Produce per-storyboard overrides, called once per storyboard right\n   * before `runStoryboard`. Return `undefined` (or an empty object) to use\n   * the defaults; otherwise:\n   *\n   *   - `agentUrl` — redirect this storyboard to a different URL than the\n   *     ephemeral `http://127.0.0.1:<port>/mcp` the helper bound. Useful\n   *     when one storyboard needs to hit a stricter sibling route (e.g.\n   *     `/mcp-strict` for the `signed_requests` storyboard) while the rest\n   *     stay on the sandbox mount.\n   *   - every other `StoryboardRunOptions` field is shallow-merged on top\n   *     of the run-level `runStoryboardOptions`. Common uses: per-\n   *     storyboard `test_kit`, `brand`, or `contracts` that vary with the\n   *     storyboard under test. `webhook_receiver` is owned by the helper's\n   *     `webhookReceiver` field and is typed out of the override shape —\n   *     the helper re-applies it after the merge so overrides can't stomp\n   *     the loopback mock.\n   *\n   * Returning a `Promise` is supported so callers can do async work per\n   * storyboard (load a test-kit YAML, mint a scoped token, fetch brand\n   * metadata). The helper awaits before issuing `runStoryboard`.\n   */\n  resolvePerStoryboard?: (\n    storyboard: Storyboard,\n    defaultAgentUrl: string\n  ) => PerStoryboardOverride | undefined | Promise<PerStoryboardOverride | undefined>;\n\n  /** Compliance cache overrides. */\n  compliance?: ResolveOptions;\n\n  /**\n   * Streaming callback fired after each storyboard completes. Useful for\n   * CLI progress output so implementors don't wait for the full aggregate.\n   */\n  onStoryboardComplete?: (result: StoryboardResult, index: number, total: number) => void;\n\n  /**\n   * Called once the agent is bound and fixtures are seeded. Receives the\n   * canonical agent URL plus (when enabled) the AS handle. Use it to mint\n   * tokens and stash them on `runStoryboardOptions.auth`, or to seed\n   * non-fixture state.\n   */\n  onListening?: (info: { agentUrl: string; auth?: TestAuthorizationServer }) => void | Promise<void>;\n\n  /**\n   * Stop after the first failing storyboard. Defaults to `false` — the\n   * helper runs every storyboard so every failure site is visible.\n   */\n  bail?: boolean;\n}\n\n/**\n * Per-storyboard override returned by {@link RunAgainstLocalAgentOptions.resolvePerStoryboard}.\n *\n * `agentUrl` redirects the storyboard to a different URL. Every other\n * `StoryboardRunOptions` field is shallow-merged on top of the run-level\n * defaults. `webhook_receiver` is intentionally omitted — the helper owns\n * that field via its `webhookReceiver` option and re-applies it after the\n * merge.\n */\nexport type PerStoryboardOverride = { agentUrl?: string } & Omit<Partial<StoryboardRunOptions>, 'webhook_receiver'>;\n\nexport interface LocalAgentRunResult {\n  /** True iff every storyboard passed (steps + assertions). */\n  overall_passed: boolean;\n  /** Canonical URL the helper mounted the agent at. */\n  agent_url: string;\n  /** Per-storyboard results, in run order. */\n  results: StoryboardResult[];\n  /** Storyboards skipped because the agent's capabilities place them out of scope. */\n  not_applicable: Array<{ storyboard_id: string; storyboard_title: string; reason: string }>;\n  /** Sum across all run storyboards. */\n  passed_count: number;\n  failed_count: number;\n  skipped_count: number;\n  total_duration_ms: number;\n}\n\n/**\n * True when `url` is an http:// (not https://) URL pointing at a loopback\n * host — used to decide whether the SSRF guard's HTTPS-only default can be\n * relaxed. Must be tight: a `http://` prefix alone is NOT sufficient (a\n * caller override could redirect to `http://attacker.example.com/mcp` and\n * inherit the allowance). Only `127.0.0.1`, `::1`, and `localhost` count.\n *\n * @internal\n */\nfunction isLoopbackHttpUrl(url: string): boolean {\n  try {\n    const parsed = new URL(url);\n    if (parsed.protocol !== 'http:') return false;\n    // `URL.hostname` wraps IPv6 literals in brackets (`[::1]`); strip them\n    // to match the bare forms typical in SSRF loopback checks.\n    const host = parsed.hostname.replace(/^\\[|\\]$/g, '').toLowerCase();\n    return host === '127.0.0.1' || host === '::1' || host === 'localhost';\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Run storyboards against an in-process AdCP agent. Handles lifecycle:\n * bind, seed, (optional) token issuance, loop, tear down.\n */\nexport async function runAgainstLocalAgent(options: RunAgainstLocalAgentOptions): Promise<LocalAgentRunResult> {\n  const startedAt = Date.now();\n  const mountPath = options.serveOptions?.path ?? '/mcp';\n  const taskStore: TaskStore = new InMemoryTaskStore();\n  // Bootstrap the factory once with a synthetic host so seeding and\n  // fixture preparation run before the server ever binds. `serve()` will\n  // pass the real per-request host when it calls the factory again.\n  const ctx: ServeContext = { taskStore, host: '' };\n\n  let auth: TestAuthorizationServer | undefined;\n  let httpServer: HttpServer | undefined;\n\n  try {\n    if (options.authorizationServer) {\n      const authOptions = typeof options.authorizationServer === 'object' ? options.authorizationServer : {};\n      auth = await createTestAuthorizationServer(authOptions);\n    }\n\n    // Bootstrap: call the factory once ahead of time to get an AdcpServer\n    // we can seed against. serve() will call the factory again for every\n    // real request — the user's stateStore closure guarantees seeds persist.\n    const bootstrapAgent = options.createAgent(ctx);\n    const bootstrapIsAdcp = isAdcpServer(bootstrapAgent);\n    if (bootstrapIsAdcp && options.fixtures !== false) {\n      const seedOptions = typeof options.fixtures === 'object' ? options.fixtures : {};\n      await seedComplianceFixtures(bootstrapAgent, seedOptions);\n    }\n    // Release the bootstrap instance so serve()'s per-request factory calls\n    // produce fresh servers. Closing is idempotent.\n    await bootstrapAgent.close();\n\n    const protectedResource: ProtectedResourceMetadata | undefined = auth\n      ? { authorization_servers: [auth.issuer] }\n      : undefined;\n    // For the common unauthenticated local-agent path, bind port 0 directly\n    // and read the assigned port after listen. This avoids the allocate-then-\n    // bind race where another parallel test can claim the probed port.\n    // OAuth protected-resource metadata still needs a publicUrl before\n    // serve() construction, so that path keeps the preallocated port.\n    const port = protectedResource ? await allocatePort() : 0;\n    const publicUrl = `http://127.0.0.1:${port}${mountPath}`;\n    let agentUrl = publicUrl;\n\n    httpServer = serve(options.createAgent, {\n      ...options.serveOptions,\n      taskStore,\n      port,\n      ...(protectedResource ? { protectedResource, publicUrl } : {}),\n      onListening: () => {\n        /* swallow the default console.log — callers can observe via onListening */\n      },\n    });\n\n    await waitForListening(httpServer);\n    if (!protectedResource) {\n      const address = httpServer.address();\n      if (!address || typeof address === 'string') {\n        throw new Error('runAgainstLocalAgent: local HTTP server did not expose a TCP address');\n      }\n      agentUrl = `http://127.0.0.1:${address.port}${mountPath}`;\n    }\n\n    if (options.onListening) {\n      await options.onListening({ agentUrl, auth });\n    }\n\n    const toRun = await resolveStoryboardSet(options);\n    const results: StoryboardResult[] = [];\n    let passed = 0;\n    let failed = 0;\n    let skipped = 0;\n\n    const webhookConfig = resolveWebhookReceiver(options.webhookReceiver);\n    const explicitAllowHttp = options.runStoryboardOptions?.allow_http;\n    const baseRunOptions: Omit<StoryboardRunOptions, 'webhook_receiver' | 'allow_http'> = {\n      ...(options.runStoryboardOptions ?? {}),\n    };\n    // `allow_http` is removed from baseRunOptions and recomputed per\n    // storyboard below — inheriting `true` across storyboards would let a\n    // `resolvePerStoryboard` override that redirected to a remote\n    // `http://...` URL bypass the SSRF guard and silently probe an\n    // attacker-controlled target with private-IP allowance.\n    delete (baseRunOptions as { allow_http?: unknown }).allow_http;\n\n    for (let i = 0; i < toRun.storyboards.length; i++) {\n      const sb = toRun.storyboards[i]!;\n      const override = (await options.resolvePerStoryboard?.(sb, agentUrl)) ?? undefined;\n      const { agentUrl: overrideUrl, ...overrideRunOptions } = override ?? {};\n      const storyboardUrl = overrideUrl ?? agentUrl;\n      // Tighten the SSRF-guard bypass: only auto-opt-in `allow_http` when\n      // THIS storyboard's URL is loopback-bound (what the helper owns).\n      // An override to `http://attacker.example.com/...` must not\n      // inherit the default — that would re-enable the private-IP\n      // allowance against attacker-controlled infrastructure.\n      const storyboardIsLoopbackHttp = isLoopbackHttpUrl(storyboardUrl);\n      const effectiveAllowHttp =\n        (overrideRunOptions as { allow_http?: boolean }).allow_http ?? explicitAllowHttp ?? storyboardIsLoopbackHttp;\n      // webhook_receiver is helper-owned — re-applied after the merge so\n      // overrides can't replace the loopback mock the helper promised.\n      const storyboardOptions: StoryboardRunOptions = {\n        ...baseRunOptions,\n        ...overrideRunOptions,\n        allow_http: effectiveAllowHttp,\n        ...(webhookConfig ? { webhook_receiver: webhookConfig } : {}),\n      };\n      const result = await runStoryboard(storyboardUrl, sb, storyboardOptions);\n      results.push(result);\n      passed += result.passed_count;\n      failed += result.failed_count;\n      skipped += result.skipped_count;\n      if (options.onStoryboardComplete) {\n        options.onStoryboardComplete(result, i, toRun.storyboards.length);\n      }\n      if (options.bail && !result.overall_passed) break;\n    }\n\n    return {\n      overall_passed: results.every(r => r.overall_passed),\n      agent_url: agentUrl,\n      results,\n      not_applicable: toRun.not_applicable,\n      passed_count: passed,\n      failed_count: failed,\n      skipped_count: skipped,\n      total_duration_ms: Date.now() - startedAt,\n    };\n  } finally {\n    await closeHttpServer(httpServer);\n    if (auth) await auth.close();\n  }\n}\n\n// ────────────────────────────────────────────────────────────\n// Helpers\n// ────────────────────────────────────────────────────────────\n\nfunction isAdcpServer(candidate: unknown): candidate is AdcpServer {\n  if (candidate == null || typeof candidate !== 'object') return false;\n  return typeof (candidate as Record<symbol, unknown>)[ADCP_STATE_STORE] === 'object';\n}\n\nfunction resolveWebhookReceiver(\n  option: RunAgainstLocalAgentOptions['webhookReceiver']\n): StoryboardRunOptions['webhook_receiver'] | undefined {\n  if (option === false) return undefined;\n  if (option === true || option === undefined) return { mode: 'loopback_mock' };\n  return option;\n}\n\nasync function resolveStoryboardSet(options: RunAgainstLocalAgentOptions): Promise<{\n  storyboards: Storyboard[];\n  not_applicable: Array<{ storyboard_id: string; storyboard_title: string; reason: string }>;\n}> {\n  const spec = options.storyboards ?? 'all';\n  const compliance = options.compliance ?? {};\n  if (spec === 'all') {\n    return { storyboards: listAllComplianceStoryboards(compliance), not_applicable: [] };\n  }\n  if (Array.isArray(spec)) {\n    if (spec.length === 0) return { storyboards: [], not_applicable: [] };\n    if (typeof spec[0] === 'object' && 'phases' in (spec[0] as Storyboard)) {\n      return { storyboards: spec as Storyboard[], not_applicable: [] };\n    }\n    const resolved: Storyboard[] = [];\n    const unknown: string[] = [];\n    for (const id of spec as string[]) {\n      const matches = resolveBundleOrStoryboard(id, compliance);\n      if (matches.length === 0) {\n        unknown.push(id);\n      } else {\n        resolved.push(...matches);\n      }\n    }\n    if (unknown.length > 0) {\n      throw new Error(\n        `runAgainstLocalAgent: unknown storyboard or bundle id(s): ${unknown.join(', ')}. ` +\n          `Run \\`adcp storyboard list\\` to see available ids.`\n      );\n    }\n    const seen = new Set<string>();\n    return {\n      storyboards: resolved.filter(sb => (seen.has(sb.id) ? false : (seen.add(sb.id), true))),\n      not_applicable: [],\n    };\n  }\n  const resolved = resolveStoryboardsForCapabilities(spec, compliance);\n  return {\n    storyboards: resolved.storyboards,\n    not_applicable: resolved.not_applicable.map(n => ({\n      storyboard_id: n.storyboard_id,\n      storyboard_title: n.storyboard_title,\n      reason: n.reason,\n    })),\n  };\n}\n\nfunction allocatePort(): Promise<number> {\n  return new Promise((resolve, reject) => {\n    const probe = createNetProbe();\n    probe.unref();\n    probe.on('error', reject);\n    probe.listen(0, '127.0.0.1', () => {\n      const { port } = probe.address() as AddressInfo;\n      probe.close(err => (err ? reject(err) : resolve(port)));\n    });\n  });\n}\n\nfunction waitForListening(server: HttpServer): Promise<void> {\n  if (server.listening) return Promise.resolve();\n  return new Promise<void>((resolve, reject) => {\n    const onListening = () => {\n      cleanup();\n      resolve();\n    };\n    const onError = (err: Error) => {\n      cleanup();\n      reject(err);\n    };\n    const cleanup = () => {\n      server.off('listening', onListening);\n      server.off('error', onError);\n    };\n    server.on('listening', onListening);\n    server.on('error', onError);\n  });\n}\n\nfunction closeHttpServer(server: HttpServer | undefined): Promise<void> {\n  if (!server) return Promise.resolve();\n  return new Promise<void>((resolve, reject) => {\n    server.closeAllConnections?.();\n    server.close(err => {\n      if (err && (err as NodeJS.ErrnoException).code !== 'ERR_SERVER_NOT_RUNNING') reject(err);\n      else resolve();\n    });\n  });\n}\n"],"mappings":"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","names":["resolved"]}

package/dist/lib/testing/orchestrator.mjs

@@ -1,9 +1,3 @@
-import { fileURLToPath as __adcpFileURLToPath } from 'node:url';
-import { dirname as __adcpDirname } from 'node:path';
-import { createRequire as __adcpCreateRequire } from 'node:module';
-const __filename = __adcpFileURLToPath(import.meta.url);
-const __dirname = __adcpDirname(__filename);
-const require = __adcpCreateRequire(import.meta.url);
 import { testAgent } from "./agent-tester.mjs";
 import { getOrCreateClient, getOrDiscoverProfile } from "./client.mjs";
 const SCENARIO_REQUIREMENTS = {

package/dist/lib/testing/orchestrator.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/testing/orchestrator.ts"],"sourcesContent":["/**\n * Test Suite Orchestrator for AdCP Agents\n *\n * Discovers agent capabilities and runs all applicable test scenarios,\n * aggregating results into a single suite report.\n */\n\nimport { testAgent } from './agent-tester';\nimport { createTestClient, discoverAgentProfile, getOrCreateClient, getOrDiscoverProfile } from './client';\nimport type { TestScenario, TestOptions, TestResult, SuiteResult } from './types';\n\n/**\n * Minimum tools required for each scenario to be applicable.\n * ALL listed tools must be present in the agent's tool list.\n * Scenarios with an empty array are always applicable.\n *\n * @deprecated Use storyboard-driven testing via `runStoryboard()` instead.\n * Storyboards define required tools per step via `requires_tool` and per\n * storyboard via `required_tools`. See `src/lib/testing/storyboard/`.\n */\nexport const SCENARIO_REQUIREMENTS: Partial<Record<TestScenario, string[]>> = {\n  // Always applicable\n  health_check: [],\n  discovery: [],\n  capability_discovery: [],\n\n  // Requires media buy core tools\n  create_media_buy: ['get_products', 'create_media_buy'],\n  full_sales_flow: ['get_products', 'create_media_buy'],\n  reporting_flow: ['get_products', 'create_media_buy', 'get_media_buy_delivery'],\n  creative_inline: ['get_products', 'create_media_buy'],\n  creative_reference: ['get_products', 'create_media_buy', 'build_creative', 'sync_creatives'],\n  temporal_validation: ['get_products', 'create_media_buy'],\n  creative_sync: ['sync_creatives'],\n\n  // Requires get_products\n  pricing_edge_cases: ['get_products'],\n  pricing_models: ['get_products'],\n  // error_handling and validation use per-tool conditional guards internally;\n  // no top-level discovery tool required to run them.\n  error_handling: [],\n  validation: [],\n  behavior_analysis: ['get_products'],\n  response_consistency: ['get_products'],\n\n  // Requires creative agent tools\n  creative_flow: ['build_creative'],\n  creative_lifecycle: ['list_creative_formats'],\n\n  // Requires signals tools\n  signals_flow: ['get_signals'],\n\n  // Requires governance tools\n  governance_property_lists: ['create_property_list'],\n  governance_content_standards: ['list_content_standards'],\n  property_list_filters: ['create_property_list', 'get_property_list'],\n\n  // Requires campaign governance tools\n  campaign_governance: ['sync_plans', 'check_governance'],\n  campaign_governance_denied: ['sync_plans', 'check_governance'],\n  campaign_governance_conditions: ['sync_plans', 'check_governance'],\n  campaign_governance_delivery: ['check_governance'],\n\n  // Requires seller tools (governance context persistence)\n  seller_governance_context: ['get_products', 'create_media_buy', 'get_media_buys'],\n\n  // Requires SI tools\n  si_session_lifecycle: ['si_initiate_session'],\n  si_availability: ['si_get_offering'],\n  si_handoff: ['si_initiate_session', 'si_terminate_session'],\n\n  // Requires audience management tools\n  sync_audiences: ['sync_audiences'],\n\n  // State machine compliance\n  media_buy_lifecycle: ['get_products', 'create_media_buy', 'update_media_buy'],\n  terminal_state_enforcement: ['get_products', 'create_media_buy', 'update_media_buy'],\n  package_lifecycle: ['get_products', 'create_media_buy', 'update_media_buy'],\n\n  // Schema compliance — applies to any agent with a primary discovery tool.\n  // Internally branches on get_products vs get_signals; always applicable.\n  schema_compliance: [],\n\n  // Error compliance (requires create_media_buy to provoke errors)\n  error_codes: ['create_media_buy'],\n  error_structure: ['create_media_buy'],\n  error_transport: ['create_media_buy'],\n\n  // Requires brand rights tools\n  brand_identity: ['get_brand_identity'],\n  brand_rights_flow: ['get_rights', 'acquire_rights'],\n  creative_approval: ['creative_approval'],\n\n  // Deterministic state machine scenarios (require comply_test_controller)\n  deterministic_creative: ['comply_test_controller', 'sync_creatives'],\n  deterministic_media_buy: ['comply_test_controller', 'get_products', 'create_media_buy'],\n  deterministic_account: ['comply_test_controller', 'list_accounts'],\n  deterministic_session: ['comply_test_controller', 'si_initiate_session'],\n  deterministic_delivery: ['comply_test_controller', 'get_products', 'create_media_buy', 'get_media_buy_delivery'],\n  deterministic_budget: ['comply_test_controller', 'get_products', 'create_media_buy'],\n  controller_validation: ['comply_test_controller'],\n};\n\n/**\n * Default set of scenarios the orchestrator will attempt.\n * Excludes unimplemented scenarios and deduplicates coverage\n * (pricing_models is omitted since pricing_edge_cases covers the same ground).\n *\n * Deterministic scenarios (deterministic_*, controller_validation) are excluded here —\n * they are managed by the comply engine via TRACK_DEFINITIONS and only run when the\n * seller exposes comply_test_controller.\n *\n * @deprecated Use storyboard-driven testing via `runStoryboard()` instead.\n */\nexport const DEFAULT_SCENARIOS: readonly TestScenario[] = [\n  'health_check',\n  'discovery',\n  'capability_discovery',\n  'create_media_buy',\n  'full_sales_flow',\n  'creative_sync',\n  'creative_inline',\n  'creative_reference',\n  'pricing_edge_cases',\n  'error_handling',\n  'validation',\n  'temporal_validation',\n  'behavior_analysis',\n  'response_consistency',\n  'creative_flow',\n  'creative_lifecycle',\n  'signals_flow',\n  'governance_property_lists',\n  'governance_content_standards',\n  'property_list_filters',\n  'campaign_governance',\n  'campaign_governance_denied',\n  'campaign_governance_conditions',\n  'campaign_governance_delivery',\n  'seller_governance_context',\n  'si_session_lifecycle',\n  'si_availability',\n  'si_handoff',\n  'schema_compliance',\n  'sync_audiences',\n  'media_buy_lifecycle',\n  'terminal_state_enforcement',\n  'package_lifecycle',\n  'error_codes',\n  'error_structure',\n  'error_transport',\n  'brand_identity',\n  'brand_rights_flow',\n  'creative_approval',\n] as const;\n\n/**\n * Options for testAllScenarios(), extending single-scenario TestOptions\n * with an optional scenario filter.\n */\nexport interface OrchestratorOptions extends TestOptions {\n  /** Limit which scenarios to attempt (defaults to DEFAULT_SCENARIOS) */\n  scenarios?: TestScenario[];\n}\n\nfunction isApplicable(scenario: TestScenario, tools: string[]): boolean {\n  if (!(scenario in SCENARIO_REQUIREMENTS)) return false;\n  const requirements = SCENARIO_REQUIREMENTS[scenario]!;\n  return requirements.every(tool => tools.includes(tool));\n}\n\n/**\n * Return the subset of candidate scenarios that are applicable for an agent\n * with the given tool list.\n *\n * @param tools - Tool names from getAgentInfo()\n * @param filter - Scenarios to consider; defaults to DEFAULT_SCENARIOS\n */\nexport function getApplicableScenarios(tools: string[], filter?: readonly TestScenario[]): TestScenario[] {\n  const candidates = filter ?? DEFAULT_SCENARIOS;\n  return (candidates as TestScenario[]).filter(s => isApplicable(s, tools));\n}\n\n/**\n * Run all applicable test scenarios against an agent and return aggregated results.\n *\n * Scenarios are run sequentially. Each scenario re-uses the same TestOptions\n * (including auth, brand, etc.). The total duration includes the\n * initial capability discovery call.\n *\n * Note: testAllScenarios creates a client for capability discovery, then each\n * testAgent call creates its own client internally. This is intentional — testAgent\n * is designed as a standalone function and sharing state between scenarios could\n * cause cross-scenario interference.\n *\n * @deprecated Use `runStoryboard()` for storyboard-driven testing instead.\n * The comply() engine now uses storyboards as its primary testing surface.\n */\nexport async function testAllScenarios(agentUrl: string, options: OrchestratorOptions = {}): Promise<SuiteResult> {\n  const start = Date.now();\n  const { scenarios: scenarioFilter, ...testOptions } = options;\n\n  const effectiveOptions: TestOptions = {\n    ...testOptions,\n    sandbox: testOptions.sandbox !== false,\n    test_session_id: testOptions.test_session_id || `addie-suite-${Date.now()}`,\n  };\n\n  // Discover the agent's tools to determine which scenarios apply.\n  // If discovery fails (agent unreachable or rejects the request), return early\n  // rather than attempting scenarios with no tool information.\n  const client = getOrCreateClient(agentUrl, effectiveOptions);\n  const { profile, step: profileStep } = await getOrDiscoverProfile(client, effectiveOptions);\n  effectiveOptions._client = client;\n  effectiveOptions._profile = profile;\n\n  if (!profileStep.passed) {\n    return {\n      agent_url: agentUrl,\n      agent_profile: profile,\n      scenarios_run: [],\n      scenarios_skipped: [],\n      results: [],\n      overall_passed: false,\n      passed_count: 0,\n      failed_count: 0,\n      total_duration_ms: Date.now() - start,\n      tested_at: new Date().toISOString(),\n    };\n  }\n\n  const applicable = getApplicableScenarios(profile.tools, scenarioFilter);\n  const candidates: readonly TestScenario[] = scenarioFilter ?? DEFAULT_SCENARIOS;\n  const skipped = (candidates as TestScenario[]).filter(s => !applicable.includes(s));\n\n  // Run each applicable scenario sequentially\n  const results: TestResult[] = [];\n  for (const scenario of applicable) {\n    const result = await testAgent(agentUrl, scenario, effectiveOptions);\n    results.push(result);\n  }\n\n  const passedCount = results.filter(r => r.overall_passed).length;\n  const failedCount = results.filter(r => !r.overall_passed).length;\n\n  return {\n    agent_url: agentUrl,\n    agent_profile: profile,\n    scenarios_run: applicable,\n    scenarios_skipped: skipped,\n    results,\n    overall_passed: failedCount === 0 && passedCount > 0,\n    passed_count: passedCount,\n    failed_count: failedCount,\n    total_duration_ms: Date.now() - start,\n    tested_at: new Date().toISOString(),\n  };\n}\n\n/**\n * Format suite results as markdown for display in Slack/chat\n */\nexport function formatSuiteResults(suite: SuiteResult): string {\n  const statusEmoji = suite.overall_passed ? '✅' : '❌';\n  let output = `## ${statusEmoji} Agent Test Suite Results\\n\\n`;\n  output += `**Agent:** ${suite.agent_url}\\n`;\n  output += `**Agent Name:** ${suite.agent_profile.name}\\n`;\n  output += `**Duration:** ${suite.total_duration_ms}ms\\n`;\n  if (suite.scenarios_run.length === 0) {\n    output += `**Result:** No applicable scenarios found for this agent.\\n\\n`;\n  } else {\n    output += `**Result:** ${suite.passed_count} passed, ${suite.failed_count} failed out of ${suite.scenarios_run.length} scenario(s)\\n\\n`;\n  }\n\n  if (suite.scenarios_skipped.length > 0) {\n    output += `**Skipped (agent does not advertise required tools):** ${suite.scenarios_skipped.join(', ')}\\n\\n`;\n  }\n\n  output += `### Scenario Results\\n\\n`;\n  for (const result of suite.results) {\n    const emoji = result.overall_passed ? '✅' : '❌';\n    output += `${emoji} **${result.scenario}**: ${result.summary} (${result.total_duration_ms}ms)\\n`;\n\n    if (!result.overall_passed) {\n      const failedSteps = (result.steps ?? []).filter(s => !s.passed);\n      for (const step of failedSteps) {\n        output += `   ❌ **${step.step}**`;\n        if (step.task) {\n          output += ` (\\`${step.task}\\`)`;\n        }\n        output += ` - ${step.duration_ms}ms\\n`;\n        if (step.details) output += `      ${step.details}\\n`;\n        if (step.error) output += `      ⚠️ Error: ${step.error}\\n`;\n        if (step.response_preview) {\n          output +=\n            '\\n<details><summary>Diagnostic details</summary>\\n\\n```json\\n' +\n            step.response_preview +\n            '\\n```\\n\\n</details>\\n\\n';\n        }\n      }\n    }\n  }\n\n  return output;\n}\n\n/**\n * Format suite results as JSON\n */\nexport function formatSuiteResultsJSON(suite: SuiteResult): string {\n  return JSON.stringify(suite, null, 2);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/lib/testing/orchestrator.ts"],"sourcesContent":["/**\n * Test Suite Orchestrator for AdCP Agents\n *\n * Discovers agent capabilities and runs all applicable test scenarios,\n * aggregating results into a single suite report.\n */\n\nimport { testAgent } from './agent-tester';\nimport { createTestClient, discoverAgentProfile, getOrCreateClient, getOrDiscoverProfile } from './client';\nimport type { TestScenario, TestOptions, TestResult, SuiteResult } from './types';\n\n/**\n * Minimum tools required for each scenario to be applicable.\n * ALL listed tools must be present in the agent's tool list.\n * Scenarios with an empty array are always applicable.\n *\n * @deprecated Use storyboard-driven testing via `runStoryboard()` instead.\n * Storyboards define required tools per step via `requires_tool` and per\n * storyboard via `required_tools`. See `src/lib/testing/storyboard/`.\n */\nexport const SCENARIO_REQUIREMENTS: Partial<Record<TestScenario, string[]>> = {\n  // Always applicable\n  health_check: [],\n  discovery: [],\n  capability_discovery: [],\n\n  // Requires media buy core tools\n  create_media_buy: ['get_products', 'create_media_buy'],\n  full_sales_flow: ['get_products', 'create_media_buy'],\n  reporting_flow: ['get_products', 'create_media_buy', 'get_media_buy_delivery'],\n  creative_inline: ['get_products', 'create_media_buy'],\n  creative_reference: ['get_products', 'create_media_buy', 'build_creative', 'sync_creatives'],\n  temporal_validation: ['get_products', 'create_media_buy'],\n  creative_sync: ['sync_creatives'],\n\n  // Requires get_products\n  pricing_edge_cases: ['get_products'],\n  pricing_models: ['get_products'],\n  // error_handling and validation use per-tool conditional guards internally;\n  // no top-level discovery tool required to run them.\n  error_handling: [],\n  validation: [],\n  behavior_analysis: ['get_products'],\n  response_consistency: ['get_products'],\n\n  // Requires creative agent tools\n  creative_flow: ['build_creative'],\n  creative_lifecycle: ['list_creative_formats'],\n\n  // Requires signals tools\n  signals_flow: ['get_signals'],\n\n  // Requires governance tools\n  governance_property_lists: ['create_property_list'],\n  governance_content_standards: ['list_content_standards'],\n  property_list_filters: ['create_property_list', 'get_property_list'],\n\n  // Requires campaign governance tools\n  campaign_governance: ['sync_plans', 'check_governance'],\n  campaign_governance_denied: ['sync_plans', 'check_governance'],\n  campaign_governance_conditions: ['sync_plans', 'check_governance'],\n  campaign_governance_delivery: ['check_governance'],\n\n  // Requires seller tools (governance context persistence)\n  seller_governance_context: ['get_products', 'create_media_buy', 'get_media_buys'],\n\n  // Requires SI tools\n  si_session_lifecycle: ['si_initiate_session'],\n  si_availability: ['si_get_offering'],\n  si_handoff: ['si_initiate_session', 'si_terminate_session'],\n\n  // Requires audience management tools\n  sync_audiences: ['sync_audiences'],\n\n  // State machine compliance\n  media_buy_lifecycle: ['get_products', 'create_media_buy', 'update_media_buy'],\n  terminal_state_enforcement: ['get_products', 'create_media_buy', 'update_media_buy'],\n  package_lifecycle: ['get_products', 'create_media_buy', 'update_media_buy'],\n\n  // Schema compliance — applies to any agent with a primary discovery tool.\n  // Internally branches on get_products vs get_signals; always applicable.\n  schema_compliance: [],\n\n  // Error compliance (requires create_media_buy to provoke errors)\n  error_codes: ['create_media_buy'],\n  error_structure: ['create_media_buy'],\n  error_transport: ['create_media_buy'],\n\n  // Requires brand rights tools\n  brand_identity: ['get_brand_identity'],\n  brand_rights_flow: ['get_rights', 'acquire_rights'],\n  creative_approval: ['creative_approval'],\n\n  // Deterministic state machine scenarios (require comply_test_controller)\n  deterministic_creative: ['comply_test_controller', 'sync_creatives'],\n  deterministic_media_buy: ['comply_test_controller', 'get_products', 'create_media_buy'],\n  deterministic_account: ['comply_test_controller', 'list_accounts'],\n  deterministic_session: ['comply_test_controller', 'si_initiate_session'],\n  deterministic_delivery: ['comply_test_controller', 'get_products', 'create_media_buy', 'get_media_buy_delivery'],\n  deterministic_budget: ['comply_test_controller', 'get_products', 'create_media_buy'],\n  controller_validation: ['comply_test_controller'],\n};\n\n/**\n * Default set of scenarios the orchestrator will attempt.\n * Excludes unimplemented scenarios and deduplicates coverage\n * (pricing_models is omitted since pricing_edge_cases covers the same ground).\n *\n * Deterministic scenarios (deterministic_*, controller_validation) are excluded here —\n * they are managed by the comply engine via TRACK_DEFINITIONS and only run when the\n * seller exposes comply_test_controller.\n *\n * @deprecated Use storyboard-driven testing via `runStoryboard()` instead.\n */\nexport const DEFAULT_SCENARIOS: readonly TestScenario[] = [\n  'health_check',\n  'discovery',\n  'capability_discovery',\n  'create_media_buy',\n  'full_sales_flow',\n  'creative_sync',\n  'creative_inline',\n  'creative_reference',\n  'pricing_edge_cases',\n  'error_handling',\n  'validation',\n  'temporal_validation',\n  'behavior_analysis',\n  'response_consistency',\n  'creative_flow',\n  'creative_lifecycle',\n  'signals_flow',\n  'governance_property_lists',\n  'governance_content_standards',\n  'property_list_filters',\n  'campaign_governance',\n  'campaign_governance_denied',\n  'campaign_governance_conditions',\n  'campaign_governance_delivery',\n  'seller_governance_context',\n  'si_session_lifecycle',\n  'si_availability',\n  'si_handoff',\n  'schema_compliance',\n  'sync_audiences',\n  'media_buy_lifecycle',\n  'terminal_state_enforcement',\n  'package_lifecycle',\n  'error_codes',\n  'error_structure',\n  'error_transport',\n  'brand_identity',\n  'brand_rights_flow',\n  'creative_approval',\n] as const;\n\n/**\n * Options for testAllScenarios(), extending single-scenario TestOptions\n * with an optional scenario filter.\n */\nexport interface OrchestratorOptions extends TestOptions {\n  /** Limit which scenarios to attempt (defaults to DEFAULT_SCENARIOS) */\n  scenarios?: TestScenario[];\n}\n\nfunction isApplicable(scenario: TestScenario, tools: string[]): boolean {\n  if (!(scenario in SCENARIO_REQUIREMENTS)) return false;\n  const requirements = SCENARIO_REQUIREMENTS[scenario]!;\n  return requirements.every(tool => tools.includes(tool));\n}\n\n/**\n * Return the subset of candidate scenarios that are applicable for an agent\n * with the given tool list.\n *\n * @param tools - Tool names from getAgentInfo()\n * @param filter - Scenarios to consider; defaults to DEFAULT_SCENARIOS\n */\nexport function getApplicableScenarios(tools: string[], filter?: readonly TestScenario[]): TestScenario[] {\n  const candidates = filter ?? DEFAULT_SCENARIOS;\n  return (candidates as TestScenario[]).filter(s => isApplicable(s, tools));\n}\n\n/**\n * Run all applicable test scenarios against an agent and return aggregated results.\n *\n * Scenarios are run sequentially. Each scenario re-uses the same TestOptions\n * (including auth, brand, etc.). The total duration includes the\n * initial capability discovery call.\n *\n * Note: testAllScenarios creates a client for capability discovery, then each\n * testAgent call creates its own client internally. This is intentional — testAgent\n * is designed as a standalone function and sharing state between scenarios could\n * cause cross-scenario interference.\n *\n * @deprecated Use `runStoryboard()` for storyboard-driven testing instead.\n * The comply() engine now uses storyboards as its primary testing surface.\n */\nexport async function testAllScenarios(agentUrl: string, options: OrchestratorOptions = {}): Promise<SuiteResult> {\n  const start = Date.now();\n  const { scenarios: scenarioFilter, ...testOptions } = options;\n\n  const effectiveOptions: TestOptions = {\n    ...testOptions,\n    sandbox: testOptions.sandbox !== false,\n    test_session_id: testOptions.test_session_id || `addie-suite-${Date.now()}`,\n  };\n\n  // Discover the agent's tools to determine which scenarios apply.\n  // If discovery fails (agent unreachable or rejects the request), return early\n  // rather than attempting scenarios with no tool information.\n  const client = getOrCreateClient(agentUrl, effectiveOptions);\n  const { profile, step: profileStep } = await getOrDiscoverProfile(client, effectiveOptions);\n  effectiveOptions._client = client;\n  effectiveOptions._profile = profile;\n\n  if (!profileStep.passed) {\n    return {\n      agent_url: agentUrl,\n      agent_profile: profile,\n      scenarios_run: [],\n      scenarios_skipped: [],\n      results: [],\n      overall_passed: false,\n      passed_count: 0,\n      failed_count: 0,\n      total_duration_ms: Date.now() - start,\n      tested_at: new Date().toISOString(),\n    };\n  }\n\n  const applicable = getApplicableScenarios(profile.tools, scenarioFilter);\n  const candidates: readonly TestScenario[] = scenarioFilter ?? DEFAULT_SCENARIOS;\n  const skipped = (candidates as TestScenario[]).filter(s => !applicable.includes(s));\n\n  // Run each applicable scenario sequentially\n  const results: TestResult[] = [];\n  for (const scenario of applicable) {\n    const result = await testAgent(agentUrl, scenario, effectiveOptions);\n    results.push(result);\n  }\n\n  const passedCount = results.filter(r => r.overall_passed).length;\n  const failedCount = results.filter(r => !r.overall_passed).length;\n\n  return {\n    agent_url: agentUrl,\n    agent_profile: profile,\n    scenarios_run: applicable,\n    scenarios_skipped: skipped,\n    results,\n    overall_passed: failedCount === 0 && passedCount > 0,\n    passed_count: passedCount,\n    failed_count: failedCount,\n    total_duration_ms: Date.now() - start,\n    tested_at: new Date().toISOString(),\n  };\n}\n\n/**\n * Format suite results as markdown for display in Slack/chat\n */\nexport function formatSuiteResults(suite: SuiteResult): string {\n  const statusEmoji = suite.overall_passed ? '✅' : '❌';\n  let output = `## ${statusEmoji} Agent Test Suite Results\\n\\n`;\n  output += `**Agent:** ${suite.agent_url}\\n`;\n  output += `**Agent Name:** ${suite.agent_profile.name}\\n`;\n  output += `**Duration:** ${suite.total_duration_ms}ms\\n`;\n  if (suite.scenarios_run.length === 0) {\n    output += `**Result:** No applicable scenarios found for this agent.\\n\\n`;\n  } else {\n    output += `**Result:** ${suite.passed_count} passed, ${suite.failed_count} failed out of ${suite.scenarios_run.length} scenario(s)\\n\\n`;\n  }\n\n  if (suite.scenarios_skipped.length > 0) {\n    output += `**Skipped (agent does not advertise required tools):** ${suite.scenarios_skipped.join(', ')}\\n\\n`;\n  }\n\n  output += `### Scenario Results\\n\\n`;\n  for (const result of suite.results) {\n    const emoji = result.overall_passed ? '✅' : '❌';\n    output += `${emoji} **${result.scenario}**: ${result.summary} (${result.total_duration_ms}ms)\\n`;\n\n    if (!result.overall_passed) {\n      const failedSteps = (result.steps ?? []).filter(s => !s.passed);\n      for (const step of failedSteps) {\n        output += `   ❌ **${step.step}**`;\n        if (step.task) {\n          output += ` (\\`${step.task}\\`)`;\n        }\n        output += ` - ${step.duration_ms}ms\\n`;\n        if (step.details) output += `      ${step.details}\\n`;\n        if (step.error) output += `      ⚠️ Error: ${step.error}\\n`;\n        if (step.response_preview) {\n          output +=\n            '\\n<details><summary>Diagnostic details</summary>\\n\\n```json\\n' +\n            step.response_preview +\n            '\\n```\\n\\n</details>\\n\\n';\n        }\n      }\n    }\n  }\n\n  return output;\n}\n\n/**\n * Format suite results as JSON\n */\nexport function formatSuiteResultsJSON(suite: SuiteResult): string {\n  return JSON.stringify(suite, null, 2);\n}\n"],"mappings":"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","names":[]}

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

@@ -1,9 +1,3 @@
-import { fileURLToPath as __adcpFileURLToPath } from 'node:url';
-import { dirname as __adcpDirname } from 'node:path';
-import { createRequire as __adcpCreateRequire } from 'node:module';
-const __filename = __adcpFileURLToPath(import.meta.url);
-const __dirname = __adcpDirname(__filename);
-const require = __adcpCreateRequire(import.meta.url);
 const dtcSkincareBuyer = {
   id: "dtc_skincare_buyer",
   name: "Glow Lab \u2014 DTC Skincare",

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/testing/personas/index.ts"],"sourcesContent":["/**\n * Canonical buyer personas — typed, immutable test fixtures every\n * adopter would otherwise rewrite. Each persona carries enough identity\n * (brand domain, account_id, promoted_offering, brief) to drive the\n * common AdCP request shapes without surface-area surprises.\n *\n * Use when you want a deterministic buyer to drive an integration test\n * against your seller / signal / creative agent. Pair with the builder\n * helpers below to construct wire-shaped requests in one line.\n *\n * The four shipped personas span the verticals and budget classes most\n * sellers see: enterprise CTV, performance social, premium B2B, and\n * geo-targeted local. Adopters who need richer coverage extend the\n * pattern; this set intentionally stays small to keep the surface\n * stable through preview.\n *\n * Status: Preview / 6.0.\n *\n * @example\n * ```ts\n * import { dtcSkincareBuyer, buildGetProductsRequest } from '@adcp/sdk/testing/personas';\n *\n * const result = await server.dispatchTestRequest({\n *   method: 'tools/call',\n *   params: {\n *     name: 'get_products',\n *     arguments: buildGetProductsRequest(dtcSkincareBuyer),\n *   },\n * });\n * ```\n *\n * @public\n */\n\nimport type { AccountReference, BrandReference, GetProductsRequest } from '../../types/tools.generated';\n\n/**\n * A canonical buyer persona — brand identity + account fixture + brief\n * + budget shape. Typed `readonly` because personas are shared\n * fixtures: tests should mutate via the builder helpers (which clone\n * before adding overrides), never the persona object itself.\n *\n * @public\n */\nexport interface BuyerPersona {\n  /** Stable ID. Use this in test names + bug reports. */\n  readonly id: string;\n  /** Display name for test output. */\n  readonly name: string;\n  /** Vertical — same vocabulary as `SampleBrief.vertical`. */\n  readonly vertical: string;\n  /** Brand identity: domain hosts /.well-known/brand.json in real deployments. */\n  readonly brand: { readonly domain: string; readonly name: string };\n  /** Account ID this persona uses on the test seller. */\n  readonly account_id: string;\n  /** Single-line summary of what the buyer is selling — feeds `promoted_offering` on `get_products`. */\n  readonly promoted_offering: string;\n  /** Free-text brief — same shape as `SampleBrief.brief`, used by brief-driven sellers. */\n  readonly brief: string;\n  /** Total campaign budget hint. */\n  readonly budget: { readonly amount: number; readonly currency: string };\n  /** Channels this persona typically requests, in priority order. */\n  readonly channels: readonly string[];\n}\n\n/**\n * DTC ecommerce on a tight performance budget. Social-first, Gen-Z\n * audience, $50K test budget, performance pricing models preferred.\n * Mirrors the `dtc_skincare_genZ` SampleBrief.\n *\n * @public\n */\nexport const dtcSkincareBuyer: BuyerPersona = {\n  id: 'dtc_skincare_buyer',\n  name: 'Glow Lab — DTC Skincare',\n  vertical: 'Beauty & Personal Care',\n  brand: { domain: 'glowlab.example.com', name: 'Glow Lab' },\n  account_id: 'acc_glowlab',\n  promoted_offering: 'Glow Lab Vitamin C Serum + first-time-buyer 20% off',\n  brief:\n    'Direct-to-consumer skincare brand targeting Gen Z females (18-25). ' +\n    'Social-first campaign with UGC-style creative preferred. ' +\n    'Goal is driving trial purchases through a 20% off promo code. ' +\n    'Performance-oriented: need clear CPA/CPC pricing.',\n  budget: { amount: 50_000, currency: 'USD' },\n  channels: ['social', 'display'],\n};\n\n/**\n * Luxury automotive launch. High-impact video + premium display, $500K\n * Q3 flight, brand safety critical. Mirrors the `luxury_auto_ev`\n * SampleBrief.\n *\n * @public\n */\nexport const luxuryAutoBuyer: BuyerPersona = {\n  id: 'luxury_auto_buyer',\n  name: 'Velara Motors — EV Launch',\n  vertical: 'Automotive',\n  brand: { domain: 'velaramotors.example.com', name: 'Velara Motors' },\n  account_id: 'acc_velara',\n  promoted_offering: 'Velara V1 — luxury electric crossover SUV',\n  brief:\n    'Luxury automotive brand launching a new electric crossover SUV. ' +\n    'Targeting high-income households ($150K+ HHI), ages 30-55, in major US metros. ' +\n    'Need high-impact video and premium display placements. ' +\n    'Q3 flight (July-September). Key message: \"The future of luxury driving.\" ' +\n    'Brand safety is critical — no UGC or controversial adjacency.',\n  budget: { amount: 500_000, currency: 'USD' },\n  channels: ['olv', 'ctv', 'display'],\n};\n\n/**\n * Enterprise B2B SaaS awareness — premium publisher placements,\n * viewability benchmarks, $200K over six weeks. Mirrors the\n * `b2b_saas_awareness` SampleBrief.\n *\n * @public\n */\nexport const b2bSaasBuyer: BuyerPersona = {\n  id: 'b2b_saas_buyer',\n  name: 'Threadline — Workflow Platform',\n  vertical: 'Technology / B2B',\n  brand: { domain: 'threadline.example.com', name: 'Threadline' },\n  account_id: 'acc_threadline',\n  promoted_offering: 'Threadline workflow platform — annual enterprise plan',\n  brief:\n    'Enterprise SaaS company building brand awareness among IT decision-makers and C-suite executives. ' +\n    'Looking for premium editorial environments — business, technology, and finance publishers. ' +\n    'Display and native content placements preferred. CTV is acceptable if targeting is precise. ' +\n    'Viewability benchmarks are important — need 70%+ viewability guarantee.',\n  budget: { amount: 200_000, currency: 'USD' },\n  channels: ['display', 'ctv'],\n};\n\n/**\n * Regional QSR / restaurant chain — geo-targeted mobile + display\n * within radius, foot-traffic attribution. Mirrors the\n * `restaurant_local` SampleBrief.\n *\n * @public\n */\nexport const restaurantLocalBuyer: BuyerPersona = {\n  id: 'restaurant_local_buyer',\n  name: 'Anchor & Oak — Regional Chain',\n  vertical: 'QSR / Restaurant',\n  brand: { domain: 'anchorandoak.example.com', name: 'Anchor & Oak' },\n  account_id: 'acc_anchoroak',\n  promoted_offering: 'Anchor & Oak summer menu — promoted across 15 metros',\n  brief:\n    'Regional restaurant chain promoting a new menu launch across 15 metro areas. ' +\n    'Need geo-targeted mobile and display ads within 5-mile radius of each location. ' +\n    'Audio/podcast ads are also interesting if available. ' +\n    'Performance tracking: need foot traffic attribution or store visit metrics.',\n  budget: { amount: 75_000, currency: 'USD' },\n  channels: ['display', 'audio'],\n};\n\n/**\n * All shipped personas, in stable order. Adopters iterate this array\n * to run a scenario across every canonical buyer in one loop.\n *\n * @public\n */\nexport const ALL_PERSONAS: readonly BuyerPersona[] = [\n  dtcSkincareBuyer,\n  luxuryAutoBuyer,\n  b2bSaasBuyer,\n  restaurantLocalBuyer,\n];\n\n/**\n * Look up a persona by `id`. Returns `undefined` for unknown IDs —\n * test code asserting on a specific persona should narrow with a\n * non-null check.\n *\n * @public\n */\nexport function getPersonaById(id: string): BuyerPersona | undefined {\n  return ALL_PERSONAS.find(p => p.id === id);\n}\n\n// ---------------------------------------------------------------------------\n// Wire-shape builders\n// ---------------------------------------------------------------------------\n\n/**\n * Build an {@link AccountReference} pointing at the persona's account.\n * Discriminated-union narrowing concern: the wire shape allows\n * `account_id`, `brand`, or `brand + operator`. This builder always\n * returns the `account_id` arm — adopters who need the brand-arm shape\n * should compose `buildBrandReference(persona)` with their own operator.\n *\n * @public\n */\nexport function buildAccountReference(persona: BuyerPersona): AccountReference {\n  return { account_id: persona.account_id };\n}\n\n/**\n * Build a {@link BrandReference} from the persona's brand identity.\n * Domain is the canonical field; name is dropped (the wire spec doesn't\n * carry it on `BrandReference` — sellers resolve via brand.json).\n *\n * @public\n */\nexport function buildBrandReference(persona: BuyerPersona): BrandReference {\n  return { domain: persona.brand.domain };\n}\n\n/**\n * Build a wire-shaped {@link GetProductsRequest} keyed to this persona —\n * `buying_mode: 'brief'`, the persona's `brief` text, brand reference,\n * and account reference. Pass `overrides` to add `filters`,\n * `preferred_delivery_types`, `time_budget`, etc.\n *\n * @public\n */\nexport function buildGetProductsRequest(\n  persona: BuyerPersona,\n  overrides?: Partial<GetProductsRequest>\n): GetProductsRequest {\n  return {\n    buying_mode: 'brief',\n    brief: persona.brief,\n    brand: buildBrandReference(persona),\n    account: buildAccountReference(persona),\n    ...overrides,\n  };\n}\n"],"mappings":";;;;;;AAwEO,MAAM,mBAAiC;AAAA,EAC5C,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,UAAU;AAAA,EACV,OAAO,EAAE,QAAQ,uBAAuB,MAAM,WAAW;AAAA,EACzD,YAAY;AAAA,EACZ,mBAAmB;AAAA,EACnB,OACE;AAAA,EAIF,QAAQ,EAAE,QAAQ,KAAQ,UAAU,MAAM;AAAA,EAC1C,UAAU,CAAC,UAAU,SAAS;AAChC;AASO,MAAM,kBAAgC;AAAA,EAC3C,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,UAAU;AAAA,EACV,OAAO,EAAE,QAAQ,4BAA4B,MAAM,gBAAgB;AAAA,EACnE,YAAY;AAAA,EACZ,mBAAmB;AAAA,EACnB,OACE;AAAA,EAKF,QAAQ,EAAE,QAAQ,KAAS,UAAU,MAAM;AAAA,EAC3C,UAAU,CAAC,OAAO,OAAO,SAAS;AACpC;AASO,MAAM,eAA6B;AAAA,EACxC,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,UAAU;AAAA,EACV,OAAO,EAAE,QAAQ,0BAA0B,MAAM,aAAa;AAAA,EAC9D,YAAY;AAAA,EACZ,mBAAmB;AAAA,EACnB,OACE;AAAA,EAIF,QAAQ,EAAE,QAAQ,KAAS,UAAU,MAAM;AAAA,EAC3C,UAAU,CAAC,WAAW,KAAK;AAC7B;AASO,MAAM,uBAAqC;AAAA,EAChD,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,UAAU;AAAA,EACV,OAAO,EAAE,QAAQ,4BAA4B,MAAM,eAAe;AAAA,EAClE,YAAY;AAAA,EACZ,mBAAmB;AAAA,EACnB,OACE;AAAA,EAIF,QAAQ,EAAE,QAAQ,MAAQ,UAAU,MAAM;AAAA,EAC1C,UAAU,CAAC,WAAW,OAAO;AAC/B;AAQO,MAAM,eAAwC;AAAA,EACnD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AASO,SAAS,eAAe,IAAsC;AACnE,SAAO,aAAa,KAAK,OAAK,EAAE,OAAO,EAAE;AAC3C;AAeO,SAAS,sBAAsB,SAAyC;AAC7E,SAAO,EAAE,YAAY,QAAQ,WAAW;AAC1C;AASO,SAAS,oBAAoB,SAAuC;AACzE,SAAO,EAAE,QAAQ,QAAQ,MAAM,OAAO;AACxC;AAUO,SAAS,wBACd,SACA,WACoB;AACpB,SAAO;AAAA,IACL,aAAa;AAAA,IACb,OAAO,QAAQ;AAAA,IACf,OAAO,oBAAoB,OAAO;AAAA,IAClC,SAAS,sBAAsB,OAAO;AAAA,IACtC,GAAG;AAAA,EACL;AACF;","names":[]}
+{"version":3,"sources":["../../../../src/lib/testing/personas/index.ts"],"sourcesContent":["/**\n * Canonical buyer personas — typed, immutable test fixtures every\n * adopter would otherwise rewrite. Each persona carries enough identity\n * (brand domain, account_id, promoted_offering, brief) to drive the\n * common AdCP request shapes without surface-area surprises.\n *\n * Use when you want a deterministic buyer to drive an integration test\n * against your seller / signal / creative agent. Pair with the builder\n * helpers below to construct wire-shaped requests in one line.\n *\n * The four shipped personas span the verticals and budget classes most\n * sellers see: enterprise CTV, performance social, premium B2B, and\n * geo-targeted local. Adopters who need richer coverage extend the\n * pattern; this set intentionally stays small to keep the surface\n * stable through preview.\n *\n * Status: Preview / 6.0.\n *\n * @example\n * ```ts\n * import { dtcSkincareBuyer, buildGetProductsRequest } from '@adcp/sdk/testing/personas';\n *\n * const result = await server.dispatchTestRequest({\n *   method: 'tools/call',\n *   params: {\n *     name: 'get_products',\n *     arguments: buildGetProductsRequest(dtcSkincareBuyer),\n *   },\n * });\n * ```\n *\n * @public\n */\n\nimport type { AccountReference, BrandReference, GetProductsRequest } from '../../types/tools.generated';\n\n/**\n * A canonical buyer persona — brand identity + account fixture + brief\n * + budget shape. Typed `readonly` because personas are shared\n * fixtures: tests should mutate via the builder helpers (which clone\n * before adding overrides), never the persona object itself.\n *\n * @public\n */\nexport interface BuyerPersona {\n  /** Stable ID. Use this in test names + bug reports. */\n  readonly id: string;\n  /** Display name for test output. */\n  readonly name: string;\n  /** Vertical — same vocabulary as `SampleBrief.vertical`. */\n  readonly vertical: string;\n  /** Brand identity: domain hosts /.well-known/brand.json in real deployments. */\n  readonly brand: { readonly domain: string; readonly name: string };\n  /** Account ID this persona uses on the test seller. */\n  readonly account_id: string;\n  /** Single-line summary of what the buyer is selling — feeds `promoted_offering` on `get_products`. */\n  readonly promoted_offering: string;\n  /** Free-text brief — same shape as `SampleBrief.brief`, used by brief-driven sellers. */\n  readonly brief: string;\n  /** Total campaign budget hint. */\n  readonly budget: { readonly amount: number; readonly currency: string };\n  /** Channels this persona typically requests, in priority order. */\n  readonly channels: readonly string[];\n}\n\n/**\n * DTC ecommerce on a tight performance budget. Social-first, Gen-Z\n * audience, $50K test budget, performance pricing models preferred.\n * Mirrors the `dtc_skincare_genZ` SampleBrief.\n *\n * @public\n */\nexport const dtcSkincareBuyer: BuyerPersona = {\n  id: 'dtc_skincare_buyer',\n  name: 'Glow Lab — DTC Skincare',\n  vertical: 'Beauty & Personal Care',\n  brand: { domain: 'glowlab.example.com', name: 'Glow Lab' },\n  account_id: 'acc_glowlab',\n  promoted_offering: 'Glow Lab Vitamin C Serum + first-time-buyer 20% off',\n  brief:\n    'Direct-to-consumer skincare brand targeting Gen Z females (18-25). ' +\n    'Social-first campaign with UGC-style creative preferred. ' +\n    'Goal is driving trial purchases through a 20% off promo code. ' +\n    'Performance-oriented: need clear CPA/CPC pricing.',\n  budget: { amount: 50_000, currency: 'USD' },\n  channels: ['social', 'display'],\n};\n\n/**\n * Luxury automotive launch. High-impact video + premium display, $500K\n * Q3 flight, brand safety critical. Mirrors the `luxury_auto_ev`\n * SampleBrief.\n *\n * @public\n */\nexport const luxuryAutoBuyer: BuyerPersona = {\n  id: 'luxury_auto_buyer',\n  name: 'Velara Motors — EV Launch',\n  vertical: 'Automotive',\n  brand: { domain: 'velaramotors.example.com', name: 'Velara Motors' },\n  account_id: 'acc_velara',\n  promoted_offering: 'Velara V1 — luxury electric crossover SUV',\n  brief:\n    'Luxury automotive brand launching a new electric crossover SUV. ' +\n    'Targeting high-income households ($150K+ HHI), ages 30-55, in major US metros. ' +\n    'Need high-impact video and premium display placements. ' +\n    'Q3 flight (July-September). Key message: \"The future of luxury driving.\" ' +\n    'Brand safety is critical — no UGC or controversial adjacency.',\n  budget: { amount: 500_000, currency: 'USD' },\n  channels: ['olv', 'ctv', 'display'],\n};\n\n/**\n * Enterprise B2B SaaS awareness — premium publisher placements,\n * viewability benchmarks, $200K over six weeks. Mirrors the\n * `b2b_saas_awareness` SampleBrief.\n *\n * @public\n */\nexport const b2bSaasBuyer: BuyerPersona = {\n  id: 'b2b_saas_buyer',\n  name: 'Threadline — Workflow Platform',\n  vertical: 'Technology / B2B',\n  brand: { domain: 'threadline.example.com', name: 'Threadline' },\n  account_id: 'acc_threadline',\n  promoted_offering: 'Threadline workflow platform — annual enterprise plan',\n  brief:\n    'Enterprise SaaS company building brand awareness among IT decision-makers and C-suite executives. ' +\n    'Looking for premium editorial environments — business, technology, and finance publishers. ' +\n    'Display and native content placements preferred. CTV is acceptable if targeting is precise. ' +\n    'Viewability benchmarks are important — need 70%+ viewability guarantee.',\n  budget: { amount: 200_000, currency: 'USD' },\n  channels: ['display', 'ctv'],\n};\n\n/**\n * Regional QSR / restaurant chain — geo-targeted mobile + display\n * within radius, foot-traffic attribution. Mirrors the\n * `restaurant_local` SampleBrief.\n *\n * @public\n */\nexport const restaurantLocalBuyer: BuyerPersona = {\n  id: 'restaurant_local_buyer',\n  name: 'Anchor & Oak — Regional Chain',\n  vertical: 'QSR / Restaurant',\n  brand: { domain: 'anchorandoak.example.com', name: 'Anchor & Oak' },\n  account_id: 'acc_anchoroak',\n  promoted_offering: 'Anchor & Oak summer menu — promoted across 15 metros',\n  brief:\n    'Regional restaurant chain promoting a new menu launch across 15 metro areas. ' +\n    'Need geo-targeted mobile and display ads within 5-mile radius of each location. ' +\n    'Audio/podcast ads are also interesting if available. ' +\n    'Performance tracking: need foot traffic attribution or store visit metrics.',\n  budget: { amount: 75_000, currency: 'USD' },\n  channels: ['display', 'audio'],\n};\n\n/**\n * All shipped personas, in stable order. Adopters iterate this array\n * to run a scenario across every canonical buyer in one loop.\n *\n * @public\n */\nexport const ALL_PERSONAS: readonly BuyerPersona[] = [\n  dtcSkincareBuyer,\n  luxuryAutoBuyer,\n  b2bSaasBuyer,\n  restaurantLocalBuyer,\n];\n\n/**\n * Look up a persona by `id`. Returns `undefined` for unknown IDs —\n * test code asserting on a specific persona should narrow with a\n * non-null check.\n *\n * @public\n */\nexport function getPersonaById(id: string): BuyerPersona | undefined {\n  return ALL_PERSONAS.find(p => p.id === id);\n}\n\n// ---------------------------------------------------------------------------\n// Wire-shape builders\n// ---------------------------------------------------------------------------\n\n/**\n * Build an {@link AccountReference} pointing at the persona's account.\n * Discriminated-union narrowing concern: the wire shape allows\n * `account_id`, `brand`, or `brand + operator`. This builder always\n * returns the `account_id` arm — adopters who need the brand-arm shape\n * should compose `buildBrandReference(persona)` with their own operator.\n *\n * @public\n */\nexport function buildAccountReference(persona: BuyerPersona): AccountReference {\n  return { account_id: persona.account_id };\n}\n\n/**\n * Build a {@link BrandReference} from the persona's brand identity.\n * Domain is the canonical field; name is dropped (the wire spec doesn't\n * carry it on `BrandReference` — sellers resolve via brand.json).\n *\n * @public\n */\nexport function buildBrandReference(persona: BuyerPersona): BrandReference {\n  return { domain: persona.brand.domain };\n}\n\n/**\n * Build a wire-shaped {@link GetProductsRequest} keyed to this persona —\n * `buying_mode: 'brief'`, the persona's `brief` text, brand reference,\n * and account reference. Pass `overrides` to add `filters`,\n * `preferred_delivery_types`, `time_budget`, etc.\n *\n * @public\n */\nexport function buildGetProductsRequest(\n  persona: BuyerPersona,\n  overrides?: Partial<GetProductsRequest>\n): GetProductsRequest {\n  return {\n    buying_mode: 'brief',\n    brief: persona.brief,\n    brand: buildBrandReference(persona),\n    account: buildAccountReference(persona),\n    ...overrides,\n  };\n}\n"],"mappings":"AAwEO,MAAM,mBAAiC;AAAA,EAC5C,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,UAAU;AAAA,EACV,OAAO,EAAE,QAAQ,uBAAuB,MAAM,WAAW;AAAA,EACzD,YAAY;AAAA,EACZ,mBAAmB;AAAA,EACnB,OACE;AAAA,EAIF,QAAQ,EAAE,QAAQ,KAAQ,UAAU,MAAM;AAAA,EAC1C,UAAU,CAAC,UAAU,SAAS;AAChC;AASO,MAAM,kBAAgC;AAAA,EAC3C,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,UAAU;AAAA,EACV,OAAO,EAAE,QAAQ,4BAA4B,MAAM,gBAAgB;AAAA,EACnE,YAAY;AAAA,EACZ,mBAAmB;AAAA,EACnB,OACE;AAAA,EAKF,QAAQ,EAAE,QAAQ,KAAS,UAAU,MAAM;AAAA,EAC3C,UAAU,CAAC,OAAO,OAAO,SAAS;AACpC;AASO,MAAM,eAA6B;AAAA,EACxC,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,UAAU;AAAA,EACV,OAAO,EAAE,QAAQ,0BAA0B,MAAM,aAAa;AAAA,EAC9D,YAAY;AAAA,EACZ,mBAAmB;AAAA,EACnB,OACE;AAAA,EAIF,QAAQ,EAAE,QAAQ,KAAS,UAAU,MAAM;AAAA,EAC3C,UAAU,CAAC,WAAW,KAAK;AAC7B;AASO,MAAM,uBAAqC;AAAA,EAChD,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,UAAU;AAAA,EACV,OAAO,EAAE,QAAQ,4BAA4B,MAAM,eAAe;AAAA,EAClE,YAAY;AAAA,EACZ,mBAAmB;AAAA,EACnB,OACE;AAAA,EAIF,QAAQ,EAAE,QAAQ,MAAQ,UAAU,MAAM;AAAA,EAC1C,UAAU,CAAC,WAAW,OAAO;AAC/B;AAQO,MAAM,eAAwC;AAAA,EACnD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AASO,SAAS,eAAe,IAAsC;AACnE,SAAO,aAAa,KAAK,OAAK,EAAE,OAAO,EAAE;AAC3C;AAeO,SAAS,sBAAsB,SAAyC;AAC7E,SAAO,EAAE,YAAY,QAAQ,WAAW;AAC1C;AASO,SAAS,oBAAoB,SAAuC;AACzE,SAAO,EAAE,QAAQ,QAAQ,MAAM,OAAO;AACxC;AAUO,SAAS,wBACd,SACA,WACoB;AACpB,SAAO;AAAA,IACL,aAAa;AAAA,IACb,OAAO,QAAQ;AAAA,IACf,OAAO,oBAAoB,OAAO;AAAA,IAClC,SAAS,sBAAsB,OAAO;AAAA,IACtC,GAAG;AAAA,EACL;AACF;","names":[]}

package/dist/lib/testing/scenarios/brand-rights.mjs

@@ -1,9 +1,3 @@
-import { fileURLToPath as __adcpFileURLToPath } from 'node:url';
-import { dirname as __adcpDirname } from 'node:path';
-import { createRequire as __adcpCreateRequire } from 'node:module';
-const __filename = __adcpFileURLToPath(import.meta.url);
-const __dirname = __adcpDirname(__filename);
-const require = __adcpCreateRequire(import.meta.url);
 import { getOrCreateClient, runStep, getOrDiscoverProfile } from "../client.mjs";
 import { BRAND_RIGHTS_TOOLS } from "../../utils/capabilities.mjs";
 async function testBrandRightsFlow(agentUrl, options) {

package/dist/lib/testing/scenarios/brand-rights.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/testing/scenarios/brand-rights.ts"],"sourcesContent":["/**\n * Brand Rights Protocol Testing Scenarios (v3)\n *\n * Tests brand rights agent capabilities including:\n * - get_brand_identity -- retrieves brand identity information\n * - get_rights -- queries current rights associated with a brand\n * - acquire_rights -- initiates acquisition of brand rights\n */\n\nimport type { TestOptions, TestStepResult, AgentProfile, TaskResult } from '../types';\nimport { getOrCreateClient, runStep, getOrDiscoverProfile } from '../client';\nimport { BRAND_RIGHTS_TOOLS } from '../../utils/capabilities';\n\n/**\n * Test: Brand Rights Flow\n *\n * Flow: discover profile -> check brand rights tools -> get_rights -> acquire_rights\n */\nexport async function testBrandRightsFlow(\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 brand rights tools\n  const hasBrandRights = BRAND_RIGHTS_TOOLS.some(t => profile.tools.includes(t));\n  if (!hasBrandRights) {\n    steps.push({\n      step: 'Brand rights support check',\n      passed: false,\n      duration_ms: 0,\n      error: 'Agent does not support Brand Rights Protocol tools',\n      details: `Required tools: ${BRAND_RIGHTS_TOOLS.join(', ')}. Available: ${profile.tools.join(', ')}`,\n    });\n    return { steps, profile };\n  }\n\n  // Test: get_brand_identity\n  if (profile.tools.includes('get_brand_identity')) {\n    const { result, step } = await runStep<TaskResult>(\n      'Get brand identity: retrieve brand identity information',\n      'get_brand_identity',\n      async () =>\n        client.executeTask('get_brand_identity', {\n          type: 'get_brand_identity_request',\n          request_id: `e2e-brand-id-${Date.now()}`,\n          brand_domain: options.brand?.domain ?? 'example.com',\n          brand_id: options.brand?.brand_id,\n        }) as Promise<TaskResult>\n    );\n\n    if (result?.success && result?.data) {\n      const data = result.data as Record<string, unknown>;\n      step.details = `Brand identity returned for ${data['brand_name'] ?? data['brand_domain'] ?? 'unknown'}`;\n      step.response_preview = JSON.stringify(\n        {\n          request_id: data['request_id'],\n          brand_name: data['brand_name'],\n          brand_domain: data['brand_domain'],\n          has_guidelines: !!data['guidelines'],\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 = 'get_brand_identity not supported by this agent (expected for some agents)';\n      } else {\n        step.passed = false;\n        step.error = result.error || 'get_brand_identity failed';\n      }\n    }\n    steps.push(step);\n  }\n\n  // Test: get_rights\n  if (profile.tools.includes('get_rights')) {\n    const { result, step } = await runStep<TaskResult>(\n      'Get rights: query current brand rights',\n      'get_rights',\n      async () =>\n        client.executeTask('get_rights', {\n          type: 'get_rights_request',\n          request_id: `e2e-rights-${Date.now()}`,\n          brand_domain: options.brand?.domain ?? 'example.com',\n          brand_id: options.brand?.brand_id,\n        }) as Promise<TaskResult>\n    );\n\n    if (result?.success && result?.data) {\n      const data = result.data as Record<string, unknown>;\n      const rights = Array.isArray(data['rights']) ? data['rights'] : [];\n      step.details = `Get rights returned ${rights.length} right(s)`;\n      step.response_preview = JSON.stringify(\n        {\n          request_id: data['request_id'],\n          rights_count: rights.length,\n          has_expiration: rights.some((r: Record<string, unknown>) => !!r['expires_at']),\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 = 'get_rights not supported by this agent (expected for some agents)';\n      } else {\n        step.passed = false;\n        step.error = result.error || 'get_rights failed';\n      }\n    }\n    steps.push(step);\n  }\n\n  // Test: acquire_rights\n  if (profile.tools.includes('acquire_rights')) {\n    const { result, step } = await runStep<TaskResult>(\n      'Acquire rights: initiate brand rights acquisition',\n      'acquire_rights',\n      async () =>\n        client.executeTask('acquire_rights', {\n          type: 'acquire_rights_request',\n          request_id: `e2e-acquire-${Date.now()}`,\n          brand_domain: options.brand?.domain ?? 'example.com',\n          brand_id: options.brand?.brand_id,\n          rights_type: 'usage',\n        }) as Promise<TaskResult>\n    );\n\n    if (result?.success && result?.data) {\n      const data = result.data as Record<string, unknown>;\n      step.details = `Acquire rights returned status: ${data['status'] ?? 'unknown'}`;\n      step.response_preview = JSON.stringify(\n        {\n          request_id: data['request_id'],\n          status: data['status'],\n          rights_id: data['rights_id'],\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 = 'acquire_rights not supported by this agent (expected for some agents)';\n      } else {\n        step.passed = false;\n        step.error = result.error || 'acquire_rights failed';\n      }\n    }\n    steps.push(step);\n  }\n\n  return { steps, profile };\n}\n\n/**\n * Test: Brand Identity\n *\n * Tests get_brand_identity at public and authorized access tiers.\n */\nexport async function testBrandIdentity(\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_brand_identity')) {\n    steps.push({\n      step: 'Brand identity support check',\n      passed: false,\n      duration_ms: 0,\n      error: 'Agent does not support get_brand_identity',\n    });\n    return { steps, profile };\n  }\n\n  // Public access tier\n  const { result: publicResult, step: publicStep } = await runStep<TaskResult>(\n    'Get brand identity (public access)',\n    'get_brand_identity',\n    async () =>\n      client.executeTask('get_brand_identity', {\n        type: 'get_brand_identity_request',\n        request_id: `e2e-brand-pub-${Date.now()}`,\n        brand_domain: options.brand?.domain ?? 'example.com',\n      }) as Promise<TaskResult>\n  );\n\n  if (publicResult?.success && publicResult?.data) {\n    const data = publicResult.data as Record<string, unknown>;\n    publicStep.details = `Public identity returned for ${data['brand_name'] ?? data['brand_domain'] ?? 'unknown'}`;\n    publicStep.response_preview = JSON.stringify(\n      {\n        request_id: data['request_id'],\n        brand_name: data['brand_name'],\n        brand_domain: data['brand_domain'],\n        has_logos: Array.isArray(data['logos']) && (data['logos'] as unknown[]).length > 0,\n        has_colors: !!data['colors'],\n        has_tone: !!data['tone'],\n      },\n      null,\n      2\n    );\n  } else if (publicResult && !publicResult.success) {\n    publicStep.passed = false;\n    publicStep.error = publicResult.error || 'get_brand_identity (public) failed';\n  }\n  steps.push(publicStep);\n\n  // Authorized access tier (with brand_id if available)\n  if (options.brand?.brand_id) {\n    const { result: authResult, step: authStep } = await runStep<TaskResult>(\n      'Get brand identity (authorized access)',\n      'get_brand_identity',\n      async () =>\n        client.executeTask('get_brand_identity', {\n          type: 'get_brand_identity_request',\n          request_id: `e2e-brand-auth-${Date.now()}`,\n          brand_domain: options.brand?.domain ?? 'example.com',\n          brand_id: options.brand?.brand_id,\n        }) as Promise<TaskResult>\n    );\n\n    if (authResult?.success && authResult?.data) {\n      const data = authResult.data as Record<string, unknown>;\n      authStep.details = `Authorized identity returned for ${data['brand_name'] ?? 'unknown'}`;\n      authStep.response_preview = JSON.stringify(\n        {\n          request_id: data['request_id'],\n          brand_name: data['brand_name'],\n          access_tier: data['access_tier'],\n          has_guidelines: !!data['guidelines'],\n        },\n        null,\n        2\n      );\n    } else if (authResult && !authResult.success) {\n      authStep.passed = false;\n      authStep.error = authResult.error || 'get_brand_identity (authorized) failed';\n    }\n    steps.push(authStep);\n  }\n\n  return { steps, profile };\n}\n\n/**\n * Test: Creative Approval\n *\n * Tests the creative_approval workflow for brand compliance review.\n */\nexport async function testCreativeApproval(\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('creative_approval')) {\n    steps.push({\n      step: 'Creative approval support check',\n      passed: false,\n      duration_ms: 0,\n      error: 'Agent does not support creative_approval',\n    });\n    return { steps, profile };\n  }\n\n  // Submit a creative for brand approval\n  const { result, step } = await runStep<TaskResult>(\n    'Submit creative for brand approval',\n    'creative_approval',\n    async () =>\n      client.executeTask('creative_approval', {\n        type: 'creative_approval_request',\n        request_id: `e2e-approval-${Date.now()}`,\n        brand_domain: options.brand?.domain ?? 'example.com',\n        brand_id: options.brand?.brand_id,\n        creative: {\n          creative_id: `e2e-creative-${Date.now()}`,\n          format: 'display_300x250',\n          assets: [\n            {\n              asset_type: 'image',\n              url: 'https://example.com/test-creative-300x250.png',\n            },\n          ],\n        },\n      }) as Promise<TaskResult>\n  );\n\n  if (result?.success && result?.data) {\n    const data = result.data as Record<string, unknown>;\n    step.details = `Creative approval decision: ${data['decision'] ?? 'unknown'}`;\n    step.response_preview = JSON.stringify(\n      {\n        request_id: data['request_id'],\n        decision: data['decision'],\n        feedback: data['feedback'],\n        has_issues: Array.isArray(data['issues']) && (data['issues'] as unknown[]).length > 0,\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 = 'creative_approval not supported by this agent (expected for some agents)';\n    } else {\n      step.passed = false;\n      step.error = result.error || 'creative_approval failed';\n    }\n  }\n  steps.push(step);\n\n  return { steps, profile };\n}\n\n/**\n * Check if agent has any brand rights tools\n */\nexport function hasBrandRightsTools(tools: string[]): boolean {\n  return BRAND_RIGHTS_TOOLS.some(t => tools.includes(t));\n}\n"],"mappings":";;;;;;AAUA,SAAS,mBAAmB,SAAS,4BAA4B;AACjE,SAAS,0BAA0B;AAOnC,eAAsB,oBACpB,UACA,SAC8D;AAC9D,QAAM,QAA0B,CAAC;AACjC,QAAM,SAAS,kBAAkB,UAAU,OAAO;AAGlD,QAAM,EAAE,SAAS,MAAM,YAAY,IAAI,MAAM,qBAAqB,QAAQ,OAAO;AACjF,QAAM,KAAK,WAAW;AAEtB,MAAI,CAAC,YAAY,QAAQ;AACvB,WAAO,EAAE,OAAO,QAAQ;AAAA,EAC1B;AAGA,QAAM,iBAAiB,mBAAmB,KAAK,OAAK,QAAQ,MAAM,SAAS,CAAC,CAAC;AAC7E,MAAI,CAAC,gBAAgB;AACnB,UAAM,KAAK;AAAA,MACT,MAAM;AAAA,MACN,QAAQ;AAAA,MACR,aAAa;AAAA,MACb,OAAO;AAAA,MACP,SAAS,mBAAmB,mBAAmB,KAAK,IAAI,CAAC,gBAAgB,QAAQ,MAAM,KAAK,IAAI,CAAC;AAAA,IACnG,CAAC;AACD,WAAO,EAAE,OAAO,QAAQ;AAAA,EAC1B;AAGA,MAAI,QAAQ,MAAM,SAAS,oBAAoB,GAAG;AAChD,UAAM,EAAE,QAAQ,KAAK,IAAI,MAAM;AAAA,MAC7B;AAAA,MACA;AAAA,MACA,YACE,OAAO,YAAY,sBAAsB;AAAA,QACvC,MAAM;AAAA,QACN,YAAY,gBAAgB,KAAK,IAAI,CAAC;AAAA,QACtC,cAAc,QAAQ,OAAO,UAAU;AAAA,QACvC,UAAU,QAAQ,OAAO;AAAA,MAC3B,CAAC;AAAA,IACL;AAEA,QAAI,QAAQ,WAAW,QAAQ,MAAM;AACnC,YAAM,OAAO,OAAO;AACpB,WAAK,UAAU,+BAA+B,KAAK,YAAY,KAAK,KAAK,cAAc,KAAK,SAAS;AACrG,WAAK,mBAAmB,KAAK;AAAA,QAC3B;AAAA,UACE,YAAY,KAAK,YAAY;AAAA,UAC7B,YAAY,KAAK,YAAY;AAAA,UAC7B,cAAc,KAAK,cAAc;AAAA,UACjC,gBAAgB,CAAC,CAAC,KAAK,YAAY;AAAA,QACrC;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF,WAAW,UAAU,CAAC,OAAO,SAAS;AACpC,YAAM,QAAQ,OAAO,SAAS;AAC9B,UAAI,MAAM,SAAS,eAAe,KAAK,MAAM,SAAS,iBAAiB,GAAG;AACxE,aAAK,SAAS;AACd,aAAK,UAAU;AAAA,MACjB,OAAO;AACL,aAAK,SAAS;AACd,aAAK,QAAQ,OAAO,SAAS;AAAA,MAC/B;AAAA,IACF;AACA,UAAM,KAAK,IAAI;AAAA,EACjB;AAGA,MAAI,QAAQ,MAAM,SAAS,YAAY,GAAG;AACxC,UAAM,EAAE,QAAQ,KAAK,IAAI,MAAM;AAAA,MAC7B;AAAA,MACA;AAAA,MACA,YACE,OAAO,YAAY,cAAc;AAAA,QAC/B,MAAM;AAAA,QACN,YAAY,cAAc,KAAK,IAAI,CAAC;AAAA,QACpC,cAAc,QAAQ,OAAO,UAAU;AAAA,QACvC,UAAU,QAAQ,OAAO;AAAA,MAC3B,CAAC;AAAA,IACL;AAEA,QAAI,QAAQ,WAAW,QAAQ,MAAM;AACnC,YAAM,OAAO,OAAO;AACpB,YAAM,SAAS,MAAM,QAAQ,KAAK,QAAQ,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC;AACjE,WAAK,UAAU,uBAAuB,OAAO,MAAM;AACnD,WAAK,mBAAmB,KAAK;AAAA,QAC3B;AAAA,UACE,YAAY,KAAK,YAAY;AAAA,UAC7B,cAAc,OAAO;AAAA,UACrB,gBAAgB,OAAO,KAAK,CAAC,MAA+B,CAAC,CAAC,EAAE,YAAY,CAAC;AAAA,QAC/E;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF,WAAW,UAAU,CAAC,OAAO,SAAS;AACpC,YAAM,QAAQ,OAAO,SAAS;AAC9B,UAAI,MAAM,SAAS,eAAe,KAAK,MAAM,SAAS,iBAAiB,GAAG;AACxE,aAAK,SAAS;AACd,aAAK,UAAU;AAAA,MACjB,OAAO;AACL,aAAK,SAAS;AACd,aAAK,QAAQ,OAAO,SAAS;AAAA,MAC/B;AAAA,IACF;AACA,UAAM,KAAK,IAAI;AAAA,EACjB;AAGA,MAAI,QAAQ,MAAM,SAAS,gBAAgB,GAAG;AAC5C,UAAM,EAAE,QAAQ,KAAK,IAAI,MAAM;AAAA,MAC7B;AAAA,MACA;AAAA,MACA,YACE,OAAO,YAAY,kBAAkB;AAAA,QACnC,MAAM;AAAA,QACN,YAAY,eAAe,KAAK,IAAI,CAAC;AAAA,QACrC,cAAc,QAAQ,OAAO,UAAU;AAAA,QACvC,UAAU,QAAQ,OAAO;AAAA,QACzB,aAAa;AAAA,MACf,CAAC;AAAA,IACL;AAEA,QAAI,QAAQ,WAAW,QAAQ,MAAM;AACnC,YAAM,OAAO,OAAO;AACpB,WAAK,UAAU,mCAAmC,KAAK,QAAQ,KAAK,SAAS;AAC7E,WAAK,mBAAmB,KAAK;AAAA,QAC3B;AAAA,UACE,YAAY,KAAK,YAAY;AAAA,UAC7B,QAAQ,KAAK,QAAQ;AAAA,UACrB,WAAW,KAAK,WAAW;AAAA,QAC7B;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF,WAAW,UAAU,CAAC,OAAO,SAAS;AACpC,YAAM,QAAQ,OAAO,SAAS;AAC9B,UAAI,MAAM,SAAS,eAAe,KAAK,MAAM,SAAS,iBAAiB,GAAG;AACxE,aAAK,SAAS;AACd,aAAK,UAAU;AAAA,MACjB,OAAO;AACL,aAAK,SAAS;AACd,aAAK,QAAQ,OAAO,SAAS;AAAA,MAC/B;AAAA,IACF;AACA,UAAM,KAAK,IAAI;AAAA,EACjB;AAEA,SAAO,EAAE,OAAO,QAAQ;AAC1B;AAOA,eAAsB,kBACpB,UACA,SAC8D;AAC9D,QAAM,QAA0B,CAAC;AACjC,QAAM,SAAS,kBAAkB,UAAU,OAAO;AAElD,QAAM,EAAE,SAAS,MAAM,YAAY,IAAI,MAAM,qBAAqB,QAAQ,OAAO;AACjF,QAAM,KAAK,WAAW;AAEtB,MAAI,CAAC,YAAY,QAAQ;AACvB,WAAO,EAAE,OAAO,QAAQ;AAAA,EAC1B;AAEA,MAAI,CAAC,QAAQ,MAAM,SAAS,oBAAoB,GAAG;AACjD,UAAM,KAAK;AAAA,MACT,MAAM;AAAA,MACN,QAAQ;AAAA,MACR,aAAa;AAAA,MACb,OAAO;AAAA,IACT,CAAC;AACD,WAAO,EAAE,OAAO,QAAQ;AAAA,EAC1B;AAGA,QAAM,EAAE,QAAQ,cAAc,MAAM,WAAW,IAAI,MAAM;AAAA,IACvD;AAAA,IACA;AAAA,IACA,YACE,OAAO,YAAY,sBAAsB;AAAA,MACvC,MAAM;AAAA,MACN,YAAY,iBAAiB,KAAK,IAAI,CAAC;AAAA,MACvC,cAAc,QAAQ,OAAO,UAAU;AAAA,IACzC,CAAC;AAAA,EACL;AAEA,MAAI,cAAc,WAAW,cAAc,MAAM;AAC/C,UAAM,OAAO,aAAa;AAC1B,eAAW,UAAU,gCAAgC,KAAK,YAAY,KAAK,KAAK,cAAc,KAAK,SAAS;AAC5G,eAAW,mBAAmB,KAAK;AAAA,MACjC;AAAA,QACE,YAAY,KAAK,YAAY;AAAA,QAC7B,YAAY,KAAK,YAAY;AAAA,QAC7B,cAAc,KAAK,cAAc;AAAA,QACjC,WAAW,MAAM,QAAQ,KAAK,OAAO,CAAC,KAAM,KAAK,OAAO,EAAgB,SAAS;AAAA,QACjF,YAAY,CAAC,CAAC,KAAK,QAAQ;AAAA,QAC3B,UAAU,CAAC,CAAC,KAAK,MAAM;AAAA,MACzB;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF,WAAW,gBAAgB,CAAC,aAAa,SAAS;AAChD,eAAW,SAAS;AACpB,eAAW,QAAQ,aAAa,SAAS;AAAA,EAC3C;AACA,QAAM,KAAK,UAAU;AAGrB,MAAI,QAAQ,OAAO,UAAU;AAC3B,UAAM,EAAE,QAAQ,YAAY,MAAM,SAAS,IAAI,MAAM;AAAA,MACnD;AAAA,MACA;AAAA,MACA,YACE,OAAO,YAAY,sBAAsB;AAAA,QACvC,MAAM;AAAA,QACN,YAAY,kBAAkB,KAAK,IAAI,CAAC;AAAA,QACxC,cAAc,QAAQ,OAAO,UAAU;AAAA,QACvC,UAAU,QAAQ,OAAO;AAAA,MAC3B,CAAC;AAAA,IACL;AAEA,QAAI,YAAY,WAAW,YAAY,MAAM;AAC3C,YAAM,OAAO,WAAW;AACxB,eAAS,UAAU,oCAAoC,KAAK,YAAY,KAAK,SAAS;AACtF,eAAS,mBAAmB,KAAK;AAAA,QAC/B;AAAA,UACE,YAAY,KAAK,YAAY;AAAA,UAC7B,YAAY,KAAK,YAAY;AAAA,UAC7B,aAAa,KAAK,aAAa;AAAA,UAC/B,gBAAgB,CAAC,CAAC,KAAK,YAAY;AAAA,QACrC;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF,WAAW,cAAc,CAAC,WAAW,SAAS;AAC5C,eAAS,SAAS;AAClB,eAAS,QAAQ,WAAW,SAAS;AAAA,IACvC;AACA,UAAM,KAAK,QAAQ;AAAA,EACrB;AAEA,SAAO,EAAE,OAAO,QAAQ;AAC1B;AAOA,eAAsB,qBACpB,UACA,SAC8D;AAC9D,QAAM,QAA0B,CAAC;AACjC,QAAM,SAAS,kBAAkB,UAAU,OAAO;AAElD,QAAM,EAAE,SAAS,MAAM,YAAY,IAAI,MAAM,qBAAqB,QAAQ,OAAO;AACjF,QAAM,KAAK,WAAW;AAEtB,MAAI,CAAC,YAAY,QAAQ;AACvB,WAAO,EAAE,OAAO,QAAQ;AAAA,EAC1B;AAEA,MAAI,CAAC,QAAQ,MAAM,SAAS,mBAAmB,GAAG;AAChD,UAAM,KAAK;AAAA,MACT,MAAM;AAAA,MACN,QAAQ;AAAA,MACR,aAAa;AAAA,MACb,OAAO;AAAA,IACT,CAAC;AACD,WAAO,EAAE,OAAO,QAAQ;AAAA,EAC1B;AAGA,QAAM,EAAE,QAAQ,KAAK,IAAI,MAAM;AAAA,IAC7B;AAAA,IACA;AAAA,IACA,YACE,OAAO,YAAY,qBAAqB;AAAA,MACtC,MAAM;AAAA,MACN,YAAY,gBAAgB,KAAK,IAAI,CAAC;AAAA,MACtC,cAAc,QAAQ,OAAO,UAAU;AAAA,MACvC,UAAU,QAAQ,OAAO;AAAA,MACzB,UAAU;AAAA,QACR,aAAa,gBAAgB,KAAK,IAAI,CAAC;AAAA,QACvC,QAAQ;AAAA,QACR,QAAQ;AAAA,UACN;AAAA,YACE,YAAY;AAAA,YACZ,KAAK;AAAA,UACP;AAAA,QACF;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACL;AAEA,MAAI,QAAQ,WAAW,QAAQ,MAAM;AACnC,UAAM,OAAO,OAAO;AACpB,SAAK,UAAU,+BAA+B,KAAK,UAAU,KAAK,SAAS;AAC3E,SAAK,mBAAmB,KAAK;AAAA,MAC3B;AAAA,QACE,YAAY,KAAK,YAAY;AAAA,QAC7B,UAAU,KAAK,UAAU;AAAA,QACzB,UAAU,KAAK,UAAU;AAAA,QACzB,YAAY,MAAM,QAAQ,KAAK,QAAQ,CAAC,KAAM,KAAK,QAAQ,EAAgB,SAAS;AAAA,MACtF;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF,WAAW,UAAU,CAAC,OAAO,SAAS;AACpC,UAAM,QAAQ,OAAO,SAAS;AAC9B,QAAI,MAAM,SAAS,eAAe,KAAK,MAAM,SAAS,iBAAiB,GAAG;AACxE,WAAK,SAAS;AACd,WAAK,UAAU;AAAA,IACjB,OAAO;AACL,WAAK,SAAS;AACd,WAAK,QAAQ,OAAO,SAAS;AAAA,IAC/B;AAAA,EACF;AACA,QAAM,KAAK,IAAI;AAEf,SAAO,EAAE,OAAO,QAAQ;AAC1B;AAKO,SAAS,oBAAoB,OAA0B;AAC5D,SAAO,mBAAmB,KAAK,OAAK,MAAM,SAAS,CAAC,CAAC;AACvD;","names":[]}
+{"version":3,"sources":["../../../../src/lib/testing/scenarios/brand-rights.ts"],"sourcesContent":["/**\n * Brand Rights Protocol Testing Scenarios (v3)\n *\n * Tests brand rights agent capabilities including:\n * - get_brand_identity -- retrieves brand identity information\n * - get_rights -- queries current rights associated with a brand\n * - acquire_rights -- initiates acquisition of brand rights\n */\n\nimport type { TestOptions, TestStepResult, AgentProfile, TaskResult } from '../types';\nimport { getOrCreateClient, runStep, getOrDiscoverProfile } from '../client';\nimport { BRAND_RIGHTS_TOOLS } from '../../utils/capabilities';\n\n/**\n * Test: Brand Rights Flow\n *\n * Flow: discover profile -> check brand rights tools -> get_rights -> acquire_rights\n */\nexport async function testBrandRightsFlow(\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 brand rights tools\n  const hasBrandRights = BRAND_RIGHTS_TOOLS.some(t => profile.tools.includes(t));\n  if (!hasBrandRights) {\n    steps.push({\n      step: 'Brand rights support check',\n      passed: false,\n      duration_ms: 0,\n      error: 'Agent does not support Brand Rights Protocol tools',\n      details: `Required tools: ${BRAND_RIGHTS_TOOLS.join(', ')}. Available: ${profile.tools.join(', ')}`,\n    });\n    return { steps, profile };\n  }\n\n  // Test: get_brand_identity\n  if (profile.tools.includes('get_brand_identity')) {\n    const { result, step } = await runStep<TaskResult>(\n      'Get brand identity: retrieve brand identity information',\n      'get_brand_identity',\n      async () =>\n        client.executeTask('get_brand_identity', {\n          type: 'get_brand_identity_request',\n          request_id: `e2e-brand-id-${Date.now()}`,\n          brand_domain: options.brand?.domain ?? 'example.com',\n          brand_id: options.brand?.brand_id,\n        }) as Promise<TaskResult>\n    );\n\n    if (result?.success && result?.data) {\n      const data = result.data as Record<string, unknown>;\n      step.details = `Brand identity returned for ${data['brand_name'] ?? data['brand_domain'] ?? 'unknown'}`;\n      step.response_preview = JSON.stringify(\n        {\n          request_id: data['request_id'],\n          brand_name: data['brand_name'],\n          brand_domain: data['brand_domain'],\n          has_guidelines: !!data['guidelines'],\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 = 'get_brand_identity not supported by this agent (expected for some agents)';\n      } else {\n        step.passed = false;\n        step.error = result.error || 'get_brand_identity failed';\n      }\n    }\n    steps.push(step);\n  }\n\n  // Test: get_rights\n  if (profile.tools.includes('get_rights')) {\n    const { result, step } = await runStep<TaskResult>(\n      'Get rights: query current brand rights',\n      'get_rights',\n      async () =>\n        client.executeTask('get_rights', {\n          type: 'get_rights_request',\n          request_id: `e2e-rights-${Date.now()}`,\n          brand_domain: options.brand?.domain ?? 'example.com',\n          brand_id: options.brand?.brand_id,\n        }) as Promise<TaskResult>\n    );\n\n    if (result?.success && result?.data) {\n      const data = result.data as Record<string, unknown>;\n      const rights = Array.isArray(data['rights']) ? data['rights'] : [];\n      step.details = `Get rights returned ${rights.length} right(s)`;\n      step.response_preview = JSON.stringify(\n        {\n          request_id: data['request_id'],\n          rights_count: rights.length,\n          has_expiration: rights.some((r: Record<string, unknown>) => !!r['expires_at']),\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 = 'get_rights not supported by this agent (expected for some agents)';\n      } else {\n        step.passed = false;\n        step.error = result.error || 'get_rights failed';\n      }\n    }\n    steps.push(step);\n  }\n\n  // Test: acquire_rights\n  if (profile.tools.includes('acquire_rights')) {\n    const { result, step } = await runStep<TaskResult>(\n      'Acquire rights: initiate brand rights acquisition',\n      'acquire_rights',\n      async () =>\n        client.executeTask('acquire_rights', {\n          type: 'acquire_rights_request',\n          request_id: `e2e-acquire-${Date.now()}`,\n          brand_domain: options.brand?.domain ?? 'example.com',\n          brand_id: options.brand?.brand_id,\n          rights_type: 'usage',\n        }) as Promise<TaskResult>\n    );\n\n    if (result?.success && result?.data) {\n      const data = result.data as Record<string, unknown>;\n      step.details = `Acquire rights returned status: ${data['status'] ?? 'unknown'}`;\n      step.response_preview = JSON.stringify(\n        {\n          request_id: data['request_id'],\n          status: data['status'],\n          rights_id: data['rights_id'],\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 = 'acquire_rights not supported by this agent (expected for some agents)';\n      } else {\n        step.passed = false;\n        step.error = result.error || 'acquire_rights failed';\n      }\n    }\n    steps.push(step);\n  }\n\n  return { steps, profile };\n}\n\n/**\n * Test: Brand Identity\n *\n * Tests get_brand_identity at public and authorized access tiers.\n */\nexport async function testBrandIdentity(\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_brand_identity')) {\n    steps.push({\n      step: 'Brand identity support check',\n      passed: false,\n      duration_ms: 0,\n      error: 'Agent does not support get_brand_identity',\n    });\n    return { steps, profile };\n  }\n\n  // Public access tier\n  const { result: publicResult, step: publicStep } = await runStep<TaskResult>(\n    'Get brand identity (public access)',\n    'get_brand_identity',\n    async () =>\n      client.executeTask('get_brand_identity', {\n        type: 'get_brand_identity_request',\n        request_id: `e2e-brand-pub-${Date.now()}`,\n        brand_domain: options.brand?.domain ?? 'example.com',\n      }) as Promise<TaskResult>\n  );\n\n  if (publicResult?.success && publicResult?.data) {\n    const data = publicResult.data as Record<string, unknown>;\n    publicStep.details = `Public identity returned for ${data['brand_name'] ?? data['brand_domain'] ?? 'unknown'}`;\n    publicStep.response_preview = JSON.stringify(\n      {\n        request_id: data['request_id'],\n        brand_name: data['brand_name'],\n        brand_domain: data['brand_domain'],\n        has_logos: Array.isArray(data['logos']) && (data['logos'] as unknown[]).length > 0,\n        has_colors: !!data['colors'],\n        has_tone: !!data['tone'],\n      },\n      null,\n      2\n    );\n  } else if (publicResult && !publicResult.success) {\n    publicStep.passed = false;\n    publicStep.error = publicResult.error || 'get_brand_identity (public) failed';\n  }\n  steps.push(publicStep);\n\n  // Authorized access tier (with brand_id if available)\n  if (options.brand?.brand_id) {\n    const { result: authResult, step: authStep } = await runStep<TaskResult>(\n      'Get brand identity (authorized access)',\n      'get_brand_identity',\n      async () =>\n        client.executeTask('get_brand_identity', {\n          type: 'get_brand_identity_request',\n          request_id: `e2e-brand-auth-${Date.now()}`,\n          brand_domain: options.brand?.domain ?? 'example.com',\n          brand_id: options.brand?.brand_id,\n        }) as Promise<TaskResult>\n    );\n\n    if (authResult?.success && authResult?.data) {\n      const data = authResult.data as Record<string, unknown>;\n      authStep.details = `Authorized identity returned for ${data['brand_name'] ?? 'unknown'}`;\n      authStep.response_preview = JSON.stringify(\n        {\n          request_id: data['request_id'],\n          brand_name: data['brand_name'],\n          access_tier: data['access_tier'],\n          has_guidelines: !!data['guidelines'],\n        },\n        null,\n        2\n      );\n    } else if (authResult && !authResult.success) {\n      authStep.passed = false;\n      authStep.error = authResult.error || 'get_brand_identity (authorized) failed';\n    }\n    steps.push(authStep);\n  }\n\n  return { steps, profile };\n}\n\n/**\n * Test: Creative Approval\n *\n * Tests the creative_approval workflow for brand compliance review.\n */\nexport async function testCreativeApproval(\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('creative_approval')) {\n    steps.push({\n      step: 'Creative approval support check',\n      passed: false,\n      duration_ms: 0,\n      error: 'Agent does not support creative_approval',\n    });\n    return { steps, profile };\n  }\n\n  // Submit a creative for brand approval\n  const { result, step } = await runStep<TaskResult>(\n    'Submit creative for brand approval',\n    'creative_approval',\n    async () =>\n      client.executeTask('creative_approval', {\n        type: 'creative_approval_request',\n        request_id: `e2e-approval-${Date.now()}`,\n        brand_domain: options.brand?.domain ?? 'example.com',\n        brand_id: options.brand?.brand_id,\n        creative: {\n          creative_id: `e2e-creative-${Date.now()}`,\n          format: 'display_300x250',\n          assets: [\n            {\n              asset_type: 'image',\n              url: 'https://example.com/test-creative-300x250.png',\n            },\n          ],\n        },\n      }) as Promise<TaskResult>\n  );\n\n  if (result?.success && result?.data) {\n    const data = result.data as Record<string, unknown>;\n    step.details = `Creative approval decision: ${data['decision'] ?? 'unknown'}`;\n    step.response_preview = JSON.stringify(\n      {\n        request_id: data['request_id'],\n        decision: data['decision'],\n        feedback: data['feedback'],\n        has_issues: Array.isArray(data['issues']) && (data['issues'] as unknown[]).length > 0,\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 = 'creative_approval not supported by this agent (expected for some agents)';\n    } else {\n      step.passed = false;\n      step.error = result.error || 'creative_approval failed';\n    }\n  }\n  steps.push(step);\n\n  return { steps, profile };\n}\n\n/**\n * Check if agent has any brand rights tools\n */\nexport function hasBrandRightsTools(tools: string[]): boolean {\n  return BRAND_RIGHTS_TOOLS.some(t => tools.includes(t));\n}\n"],"mappings":"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","names":[]}

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

@@ -1,9 +1,3 @@
-import { fileURLToPath as __adcpFileURLToPath } from 'node:url';
-import { dirname as __adcpDirname } from 'node:path';
-import { createRequire as __adcpCreateRequire } from 'node:module';
-const __filename = __adcpFileURLToPath(import.meta.url);
-const __dirname = __adcpDirname(__filename);
-const require = __adcpCreateRequire(import.meta.url);
 import { getOrCreateClient, runStep, getOrDiscoverProfile } from "../client.mjs";
 import {
   buildSyntheticCapabilities,