@adcp/client 4.9.0 → 4.10.0

package/dist/lib/testing/compliance/briefs.js

@@ -0,0 +1,157 @@
+"use strict";
+/**
+ * Sample Brief Library for Convince Assessment
+ *
+ * Curated briefs across verticals, objectives, and constraints.
+ * Each brief includes evaluation hints that guide the AI assessor
+ * on what a strong response looks like.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SAMPLE_BRIEFS = void 0;
+exports.getBriefById = getBriefById;
+exports.getBriefsByVertical = getBriefsByVertical;
+exports.SAMPLE_BRIEFS = [
+    {
+        id: 'luxury_auto_ev',
+        name: 'Luxury Auto EV Launch',
+        vertical: 'Automotive',
+        brief: 'Luxury automotive brand launching a new electric crossover SUV. ' +
+            'Targeting high-income households ($150K+ HHI), ages 30-55, in major US metros. ' +
+            'Need high-impact video and premium display placements. ' +
+            '$500,000 budget, Q3 flight (July-September). ' +
+            'Key message: "The future of luxury driving." Brand safety is critical — no UGC or controversial adjacency.',
+        evaluation_hints: 'Strong response returns both video AND display products (the brief explicitly asks for both). ' +
+            'Products should reference auto/luxury vertical targeting or premium audience segments. ' +
+            'Pricing should make sense for a $500K budget. ' +
+            'Products with audience targeting fields populated score higher. ' +
+            'Weak response: only one format, generic descriptions, no audience data.',
+        budget_context: '$500,000 total campaign budget',
+        expected_channels: ['display', 'olv', 'ctv'],
+    },
+    {
+        id: 'dtc_skincare_genZ',
+        name: 'DTC Skincare Gen Z Sprint',
+        vertical: 'Beauty & Personal Care',
+        brief: 'Direct-to-consumer skincare brand targeting Gen Z females (18-25). ' +
+            'Social-first campaign with UGC-style creative preferred. ' +
+            '$50,000 test budget, 2-week sprint. ' +
+            'Goal is driving trial purchases through a 20% off promo code. ' +
+            'Performance-oriented: need clear CPA/CPC pricing.',
+        evaluation_hints: 'Strong response returns products with performance pricing models (CPC, CPA) — not just CPM. ' +
+            'Social or native placements are ideal given the brief. ' +
+            'Products should be appropriate for a $50K test budget (not enterprise minimums). ' +
+            'Audience targeting for younger demographics is a plus. ' +
+            'Weak response: only premium CPM products, high minimums, no performance options.',
+        budget_context: '$50,000 test budget',
+        expected_channels: ['social', 'display'],
+    },
+    {
+        id: 'b2b_saas_awareness',
+        name: 'B2B SaaS Brand Awareness',
+        vertical: 'Technology / B2B',
+        brief: 'Enterprise SaaS company building brand awareness among IT decision-makers and C-suite executives. ' +
+            'Looking for premium editorial environments — business, technology, and finance publishers. ' +
+            '$200,000 budget over 6 weeks. ' +
+            'Display and native content placements preferred. CTV is acceptable if targeting is precise. ' +
+            'Viewability benchmarks are important — need 70%+ viewability guarantee.',
+        evaluation_hints: 'Strong response returns products with premium publisher placements (not just programmatic remnant). ' +
+            'Products mentioning B2B audience segments, professional targeting, or contextual targeting score higher. ' +
+            'Viewability guarantees or benchmarks in the product metadata are valuable. ' +
+            'Native content placements alongside editorial content are ideal. ' +
+            'Weak response: generic display products with no premium differentiation.',
+        budget_context: '$200,000 over 6 weeks',
+        expected_channels: ['display', 'ctv'],
+    },
+    {
+        id: 'restaurant_local',
+        name: 'Restaurant Chain Local Promotion',
+        vertical: 'QSR / Restaurant',
+        brief: 'Regional restaurant chain promoting a new menu launch across 15 metro areas. ' +
+            'Need geo-targeted mobile and display ads within 5-mile radius of each location. ' +
+            '$75,000 budget, 3-week flight. ' +
+            'Audio/podcast ads are also interesting if available. ' +
+            'Performance tracking: need foot traffic attribution or store visit metrics.',
+        evaluation_hints: 'Strong response returns products with geo-targeting capabilities at the metro or zip level. ' +
+            'Mobile-specific products score higher given the local intent. ' +
+            'Audio/podcast products show catalog breadth. ' +
+            'Products with attribution/measurement capabilities (foot traffic, store visits) are very valuable. ' +
+            'Weak response: national-only products with no geo-targeting capability.',
+        budget_context: '$75,000 across 15 metros',
+        expected_channels: ['display', 'streaming_audio', 'podcast', 'dooh'],
+    },
+    {
+        id: 'streaming_ctv_entertainment',
+        name: 'Streaming Service CTV Campaign',
+        vertical: 'Entertainment / Media',
+        brief: 'Major streaming service promoting original content launch. ' +
+            'CTV and OLV-focused campaign targeting cord-cutters ages 18-49. ' +
+            '$1,000,000 budget, 4-week premiere window. ' +
+            'Need non-skippable pre-roll and mid-roll video placements. ' +
+            'Frequency cap of 3x/week per household. ' +
+            'Must support VAST 4.2 tags.',
+        evaluation_hints: 'Strong response returns CTV and OLV products with clear video format specifications. ' +
+            'Products should mention non-skip capabilities, VAST support, or programmatic video standards. ' +
+            'Frequency capping capability in the product metadata is important. ' +
+            'Premium/long-form video inventory scores higher than short-form. ' +
+            'Weak response: display-only products, no video inventory, no mention of VAST/video specs.',
+        budget_context: '$1,000,000 premiere campaign',
+        expected_channels: ['ctv', 'olv'],
+    },
+    {
+        id: 'ecommerce_holiday',
+        name: 'E-Commerce Holiday Retargeting',
+        vertical: 'Retail / E-Commerce',
+        brief: 'E-commerce retailer running holiday retargeting campaign. ' +
+            'Targeting past site visitors and cart abandoners with dynamic product ads. ' +
+            '$150,000 budget across Black Friday through Cyber Monday (5 days). ' +
+            'Need dynamic creative optimization and product feed integration. ' +
+            'Pricing: CPC or CPA preferred for direct response.',
+        evaluation_hints: 'Strong response returns products supporting dynamic creative, retargeting audiences, or product feed integration. ' +
+            'CPC/CPA pricing models are better fits than CPM for this performance brief. ' +
+            'Products with audience targeting or first-party data capabilities score higher. ' +
+            'Short flight window means products should support fast activation. ' +
+            'Weak response: awareness-only products, no performance pricing, no dynamic creative capabilities.',
+        budget_context: '$150,000 over 5 days (intensive)',
+        expected_channels: ['display', 'social'],
+    },
+    {
+        id: 'pharma_awareness',
+        name: 'Pharmaceutical HCP Campaign',
+        vertical: 'Healthcare / Pharma',
+        brief: 'Pharmaceutical company promoting a new treatment to healthcare professionals (HCPs). ' +
+            'Targeting physicians, pharmacists, and nurse practitioners in oncology. ' +
+            'Need endemic medical publisher placements — JAMA, Medscape, WebMD Pro. ' +
+            '$300,000 budget, 8-week awareness flight. ' +
+            'Strict regulatory compliance: all ads must include ISI (Important Safety Information). ' +
+            'No programmatic open exchange — direct or PMP only.',
+        evaluation_hints: 'Strong response returns products on medical/healthcare publisher inventory with HCP targeting. ' +
+            'Direct or PMP deal types (not open exchange) match the brief requirements. ' +
+            'Products mentioning compliance, regulatory support, or ISI handling score higher. ' +
+            'Endemic publisher inventory is more valuable than general programmatic for this brief. ' +
+            'Weak response: open exchange programmatic with no vertical targeting or compliance features.',
+        budget_context: '$300,000 over 8 weeks',
+        expected_channels: ['display'],
+    },
+    {
+        id: 'small_budget_test',
+        name: 'Small Budget Performance Test',
+        vertical: 'General',
+        brief: 'Small business testing digital advertising for the first time. ' +
+            '$5,000 total budget, 2-week test. ' +
+            'Looking for the most efficient way to drive website traffic. ' +
+            'Open to any format or channel. Needs clear reporting.',
+        evaluation_hints: 'Strong response returns accessible products with low minimums that work at $5K scale. ' +
+            'CPC pricing is ideal for traffic-driving goals. ' +
+            'Products should be actionable without complex setup. ' +
+            'Showing variety of options at accessible price points demonstrates good catalog design. ' +
+            'Weak response: enterprise-only products with $50K minimums, or no products at this budget level.',
+        budget_context: '$5,000 total (very small)',
+    },
+];
+function getBriefById(id) {
+    return exports.SAMPLE_BRIEFS.find(b => b.id === id);
+}
+function getBriefsByVertical(vertical) {
+    return exports.SAMPLE_BRIEFS.filter(b => b.vertical.toLowerCase().includes(vertical.toLowerCase()));
+}
+//# sourceMappingURL=briefs.js.map

package/dist/lib/testing/compliance/briefs.js.map

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

package/dist/lib/testing/compliance/comply.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Compliance Engine
+ *
+ * Runs all applicable capability tracks against an agent
+ * and reports results for every track — never stops at the first failure.
+ */
+import type { TestOptions } from '../types';
+import type { ComplianceTrack, ComplianceResult } from './types';
+export interface ComplyOptions extends TestOptions {
+    /** Only run specific tracks (default: all applicable) */
+    tracks?: ComplianceTrack[];
+}
+/**
+ * Run compliance assessment against an agent.
+ * Assesses all applicable tracks independently — never stops at first failure.
+ */
+export declare function comply(agentUrl: string, options?: ComplyOptions): Promise<ComplianceResult>;
+/**
+ * Format compliance results for terminal display.
+ */
+export declare function formatComplianceResults(result: ComplianceResult): string;
+/**
+ * Format compliance results as JSON.
+ */
+export declare function formatComplianceResultsJSON(result: ComplianceResult): string;
+//# sourceMappingURL=comply.d.ts.map

package/dist/lib/testing/compliance/comply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comply.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/compliance/comply.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAgB,WAAW,EAA4B,MAAM,UAAU,CAAC;AACpF,OAAO,KAAK,EACV,eAAe,EAGf,gBAAgB,EAGjB,MAAM,SAAS,CAAC;AA0OjB,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD,yDAAyD;IACzD,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyLrG;AA4BD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CA+ExE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAE5E"}