@adcp/sdk 14.0.0-beta.8 → 14.0.0-beta.9

package/dist/lib/testing/compliance/index.d.mts

@@ -3,7 +3,7 @@
  *
  * comply → "Your agent works"  (deterministic, per-track)
  */
-export { comply, collectObservations, computeOverallStatus, formatComplianceResults, formatComplianceResultsJSON, } from './comply.mjs';
+export { comply, collectObservations, computeOverallStatus, formatComplianceResults, formatComplianceResultsJSON, rotateStoryboardsForOffset, } from './comply.mjs';
 export type { ComplyOptions } from './comply.mjs';
 export { buildComplianceSummary, buildCrashSummary, formatComplianceSummaryText, formatComplianceSummaryMarkdown, } from './summary.mjs';
 export type { ComplianceSummaryArtifact, ComplianceSummaryFailure, ComplianceSummaryFailureKind, BuildSummaryOptions, BuildCrashSummaryOptions, } from './summary.mjs';

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

@@ -3,7 +3,7 @@
  *
  * comply → "Your agent works"  (deterministic, per-track)
  */
-export { comply, collectObservations, computeOverallStatus, formatComplianceResults, formatComplianceResultsJSON, } from './comply';
+export { comply, collectObservations, computeOverallStatus, formatComplianceResults, formatComplianceResultsJSON, rotateStoryboardsForOffset, } from './comply';
 export type { ComplyOptions } from './comply';
 export { buildComplianceSummary, buildCrashSummary, formatComplianceSummaryText, formatComplianceSummaryMarkdown, } from './summary';
 export type { ComplianceSummaryArtifact, ComplianceSummaryFailure, ComplianceSummaryFailureKind, BuildSummaryOptions, BuildCrashSummaryOptions, } from './summary';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/compliance/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,MAAM,EACN,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,yBAAyB,EACzB,wBAAwB,EACxB,4BAA4B,EAC5B,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE5E,YAAY,EACV,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,GACZ,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/compliance/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,MAAM,EACN,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,yBAAyB,EACzB,wBAAwB,EACxB,4BAA4B,EAC5B,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE5E,YAAY,EACV,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,GACZ,MAAM,SAAS,CAAC"}

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

@@ -29,7 +29,8 @@ __export(compliance_exports, {
   formatComplianceSummaryMarkdown: () => import_summary.formatComplianceSummaryMarkdown,
   formatComplianceSummaryText: () => import_summary.formatComplianceSummaryText,
   getBriefById: () => import_briefs.getBriefById,
-  getBriefsByVertical: () => import_briefs.getBriefsByVertical
+  getBriefsByVertical: () => import_briefs.getBriefsByVertical,
+  rotateStoryboardsForOffset: () => import_comply.rotateStoryboardsForOffset
 });
 module.exports = __toCommonJS(compliance_exports);
 var import_comply = require('./comply.js');
@@ -48,6 +49,7 @@ var import_briefs = require('./briefs.js');
   formatComplianceSummaryMarkdown,
   formatComplianceSummaryText,
   getBriefById,
-  getBriefsByVertical
+  getBriefsByVertical,
+  rotateStoryboardsForOffset
 });
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/testing/compliance/index.ts"],"sourcesContent":["/**\n * AdCP Compliance Assessment\n *\n * comply → \"Your agent works\"  (deterministic, per-track)\n */\n\nexport {\n  comply,\n  collectObservations,\n  computeOverallStatus,\n  formatComplianceResults,\n  formatComplianceResultsJSON,\n} from './comply';\nexport type { ComplyOptions } from './comply';\n\nexport {\n  buildComplianceSummary,\n  buildCrashSummary,\n  formatComplianceSummaryText,\n  formatComplianceSummaryMarkdown,\n} from './summary';\nexport type {\n  ComplianceSummaryArtifact,\n  ComplianceSummaryFailure,\n  ComplianceSummaryFailureKind,\n  BuildSummaryOptions,\n  BuildCrashSummaryOptions,\n} from './summary';\n\nexport { SAMPLE_BRIEFS, getBriefById, getBriefsByVertical } from './briefs';\n\nexport type {\n  ComplianceTrack,\n  TrackResult,\n  TestedTrackEntry,\n  TrackStatus,\n  OverallStatus,\n  ComplianceFailure,\n  ComplianceResult,\n  ComplianceSummary,\n  AdvisoryObservation,\n  ObservationCategory,\n  ObservationSeverity,\n  ObservationSource,\n  SampleBrief,\n} from './types';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,oBAMO;AAGP,qBAKO;AASP,oBAAiE;","names":[]}
+{"version":3,"sources":["../../../../src/lib/testing/compliance/index.ts"],"sourcesContent":["/**\n * AdCP Compliance Assessment\n *\n * comply → \"Your agent works\"  (deterministic, per-track)\n */\n\nexport {\n  comply,\n  collectObservations,\n  computeOverallStatus,\n  formatComplianceResults,\n  formatComplianceResultsJSON,\n  rotateStoryboardsForOffset,\n} from './comply';\nexport type { ComplyOptions } from './comply';\n\nexport {\n  buildComplianceSummary,\n  buildCrashSummary,\n  formatComplianceSummaryText,\n  formatComplianceSummaryMarkdown,\n} from './summary';\nexport type {\n  ComplianceSummaryArtifact,\n  ComplianceSummaryFailure,\n  ComplianceSummaryFailureKind,\n  BuildSummaryOptions,\n  BuildCrashSummaryOptions,\n} from './summary';\n\nexport { SAMPLE_BRIEFS, getBriefById, getBriefsByVertical } from './briefs';\n\nexport type {\n  ComplianceTrack,\n  TrackResult,\n  TestedTrackEntry,\n  TrackStatus,\n  OverallStatus,\n  ComplianceFailure,\n  ComplianceResult,\n  ComplianceSummary,\n  AdvisoryObservation,\n  ObservationCategory,\n  ObservationSeverity,\n  ObservationSource,\n  SampleBrief,\n} from './types';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,oBAOO;AAGP,qBAKO;AASP,oBAAiE;","names":[]}

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

@@ -3,7 +3,8 @@ import {
   collectObservations,
   computeOverallStatus,
   formatComplianceResults,
-  formatComplianceResultsJSON
+  formatComplianceResultsJSON,
+  rotateStoryboardsForOffset
 } from "./comply.mjs";
 import {
   buildComplianceSummary,
@@ -24,6 +25,7 @@ export {
   formatComplianceSummaryMarkdown,
   formatComplianceSummaryText,
   getBriefById,
-  getBriefsByVertical
+  getBriefsByVertical,
+  rotateStoryboardsForOffset
 };
 //# sourceMappingURL=index.mjs.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/testing/compliance/index.ts"],"sourcesContent":["/**\n * AdCP Compliance Assessment\n *\n * comply → \"Your agent works\"  (deterministic, per-track)\n */\n\nexport {\n  comply,\n  collectObservations,\n  computeOverallStatus,\n  formatComplianceResults,\n  formatComplianceResultsJSON,\n} from './comply';\nexport type { ComplyOptions } from './comply';\n\nexport {\n  buildComplianceSummary,\n  buildCrashSummary,\n  formatComplianceSummaryText,\n  formatComplianceSummaryMarkdown,\n} from './summary';\nexport type {\n  ComplianceSummaryArtifact,\n  ComplianceSummaryFailure,\n  ComplianceSummaryFailureKind,\n  BuildSummaryOptions,\n  BuildCrashSummaryOptions,\n} from './summary';\n\nexport { SAMPLE_BRIEFS, getBriefById, getBriefsByVertical } from './briefs';\n\nexport type {\n  ComplianceTrack,\n  TrackResult,\n  TestedTrackEntry,\n  TrackStatus,\n  OverallStatus,\n  ComplianceFailure,\n  ComplianceResult,\n  ComplianceSummary,\n  AdvisoryObservation,\n  ObservationCategory,\n  ObservationSeverity,\n  ObservationSource,\n  SampleBrief,\n} from './types';\n"],"mappings":"AAMA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AASP,SAAS,eAAe,cAAc,2BAA2B;","names":[]}
+{"version":3,"sources":["../../../../src/lib/testing/compliance/index.ts"],"sourcesContent":["/**\n * AdCP Compliance Assessment\n *\n * comply → \"Your agent works\"  (deterministic, per-track)\n */\n\nexport {\n  comply,\n  collectObservations,\n  computeOverallStatus,\n  formatComplianceResults,\n  formatComplianceResultsJSON,\n  rotateStoryboardsForOffset,\n} from './comply';\nexport type { ComplyOptions } from './comply';\n\nexport {\n  buildComplianceSummary,\n  buildCrashSummary,\n  formatComplianceSummaryText,\n  formatComplianceSummaryMarkdown,\n} from './summary';\nexport type {\n  ComplianceSummaryArtifact,\n  ComplianceSummaryFailure,\n  ComplianceSummaryFailureKind,\n  BuildSummaryOptions,\n  BuildCrashSummaryOptions,\n} from './summary';\n\nexport { SAMPLE_BRIEFS, getBriefById, getBriefsByVertical } from './briefs';\n\nexport type {\n  ComplianceTrack,\n  TrackResult,\n  TestedTrackEntry,\n  TrackStatus,\n  OverallStatus,\n  ComplianceFailure,\n  ComplianceResult,\n  ComplianceSummary,\n  AdvisoryObservation,\n  ObservationCategory,\n  ObservationSeverity,\n  ObservationSource,\n  SampleBrief,\n} from './types';\n"],"mappings":"AAMA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AASP,SAAS,eAAe,cAAc,2BAA2B;","names":[]}

package/dist/lib/testing/storyboard/validations.d.mts

@@ -197,7 +197,7 @@ export interface UpstreamTrafficQueryResult {
  */
 export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
 /** Capability semver emitted in run summaries and used for advisory expiry. */
-export declare const RUNNER_CAPABILITY_VERSION = "14.0.0-beta.8";
+export declare const RUNNER_CAPABILITY_VERSION = "14.0.0-beta.9";
 /** True when a failed validation contributes to the owning step's grade. */
 export declare function validationFailsStep(result: ValidationResult): boolean;
 /**

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

@@ -197,7 +197,7 @@ export interface UpstreamTrafficQueryResult {
  */
 export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
 /** Capability semver emitted in run summaries and used for advisory expiry. */
-export declare const RUNNER_CAPABILITY_VERSION = "14.0.0-beta.8";
+export declare const RUNNER_CAPABILITY_VERSION = "14.0.0-beta.9";
 /** True when a failed validation contributes to the owning step's grade. */
 export declare function validationFailsStep(result: ValidationResult): boolean;
 /**

package/dist/lib/types/list-creatives.d.ts

@@ -1382,6 +1382,11 @@ export interface CpmPricing {
     ext?: ExtensionObject;
 }
 
+/**
+ * Aggregate approval state of a creative on a specific package. Mixed publisher or placement eligibility uses partially_approved plus approval_scopes on the assignment.
+ */
+export type CreativeApprovalStatus = 'pending_review' | 'approved' | 'partially_approved' | 'rejected';
+
 /**
  * Map of canonical asset-group or legacy asset identifiers to supplied creative assets. Values are either a single discriminated asset or a non-empty repeatable asset array.
  *
@@ -2026,6 +2031,38 @@ export interface ImageAsset {
     provenance?: Provenance;
 }
 
+/**
+ * A compact current seller assertion identifying a material risk or optimization opportunity that warrants buyer attention on the containing media buy, package, or package–creative relationship. An indicator is read-side state, not an error, warning, durable event record, authorization, executable action, or independently addressable resource. The responding seller is the source. Different sellers may use different methodologies for the same standard type; native scores, evaluation windows, suggested actions, deep links, and upstream attribution belong in ext.
+ */
+export interface Indicator {
+    type: IndicatorType;
+    /**
+     * When the seller first detected the current uninterrupted occurrence of this indicator. Keep this value stable while the condition remains present. If the condition clears and is later detected again, use the new detection time. Optional because some upstream platforms expose current assessments without an original detection timestamp.
+     */
+    detected_at?: string;
+    /**
+     * Optional narrower publisher or placement scope within the enclosing media buy, package, or package–creative assignment. Omit only when the seller evaluated and asserts the indicator across the whole enclosing resource/relationship. When partial indicators_evaluated_scope is declared, every returned indicator MUST include scope and every entry MUST fall within that coverage. This is scope, not source: the responding seller remains the source.
+     *
+     * @minItems 1
+     */
+    scope?: [IndicatorScope, ...IndicatorScope[]];
+    ext?: ExtensionObject;
+}
+
+/**
+ * Publisher or placement to which this approval outcome applies.
+ */
+export interface IndicatorScope {
+    /**
+     * Domain where the publisher's adagents.json is hosted.
+     */
+    publisher_domain: string;
+    /**
+     * Optional placement ID within publisher_domain. Omit to scope the assertion or evaluation to all delivery for the publisher in the enclosing object.
+     */
+    placement_id?: string;
+}
+
 /**
  * A seller-asserted material risk or optimization opportunity that currently warrants buyer attention on an AdCP resource relationship. AdCP standardizes the broad meaning of each value for the protocol release; it does not standardize or version the seller's detection methodology or prescribe a universal remedy.
  */
@@ -2180,10 +2217,47 @@ export interface ListedCreativeCanonicalFormatKind {
          * Bounded package assignment projection. Under assignment_projection: matching, contains only assignments carrying a requested indicator type; otherwise contains active assignments up to assignment_limit. The response ceiling is enforced via verifier_constraints rather than maxItems, so payloads from 3.1 sellers remain schema-valid.
          */
         assigned_packages?: {
-            indicator_types_evaluated?: ('creative_fatigue' | 'creative_quality_opportunity')[];
-            indicators?: {
+            /**
+             * Package identifier
+             */
+            package_id: string;
+            /**
+             * Media buy containing this package. A seller advertising list_creatives in media_buy.relationship_notifications.projection_tasks MUST include this field on every assignment row, including rows where indicators is omitted as unknown, so buyers can key and reread the relationship unambiguously when package IDs are reused across media buys.
+             */
+            media_buy_id?: string;
+            /**
+             * When this assignment was created
+             * @format date-time
+             */
+            assigned_date: string;
+            approval_status?: CreativeApprovalStatus;
+            /**
+             * Human-readable explanation when approval_status is rejected. Mirrors get_media_buys for the same relationship.
+             */
+            rejection_reason?: string;
+            /**
+             * Complete, disjoint publisher/placement approval partition when approval_status is partially_approved. A normalized scope appears once. For one publisher, use either one publisher-wide row or placement-specific rows, never both. Omit when one approval_status applies uniformly to the whole assignment. The same scoped outcomes are mirrored on get_media_buys.
+             */
+            approval_scopes?: ScopedCreativeApproval[];
+            /**
+             * Current seller indicators that are true for this creative in this package assignment. The package assignment supplies the default delivery scope; an indicator may narrow further with scope. Omitted means unknown or not evaluated. A present empty array means the seller completed the evaluation identified by indicators_evaluated_scope at indicators_as_of and asserts no current indicator in that evaluated scope.
+             */
+            indicators?: (Indicator & {
                 type?: 'creative_fatigue' | 'creative_quality_opportunity';
-            }[];
+            })[];
+            /**
+             * Indicator types covered by this assignment snapshot. Required whenever indicators is present; omitted types remain unknown.
+             */
+            indicator_types_evaluated?: (IndicatorType & ('creative_fatigue' | 'creative_quality_opportunity'))[];
+            /**
+             * When the seller last completed the evaluation represented by indicators for this relationship. Required whenever indicators is present, including an empty array.
+             * @format date-time
+             */
+            indicators_as_of?: string;
+            /**
+             * Optional publisher or placement scopes covered by this evaluation. Omit when indicators covers the whole package–creative assignment. When present, scopes not listed remain unknown; every returned indicator.scope entry MUST be contained by this set.
+             */
+            indicators_evaluated_scope?: IndicatorScope[];
         }[];
     };
     /**
@@ -2343,10 +2417,47 @@ export interface ListedCreativeNamedFormatReference {
          * Bounded package assignment projection. Under assignment_projection: matching, contains only assignments carrying a requested indicator type; otherwise contains active assignments up to assignment_limit. The response ceiling is enforced via verifier_constraints rather than maxItems, so payloads from 3.1 sellers remain schema-valid.
          */
         assigned_packages?: {
-            indicator_types_evaluated?: ('creative_fatigue' | 'creative_quality_opportunity')[];
-            indicators?: {
+            /**
+             * Package identifier
+             */
+            package_id: string;
+            /**
+             * Media buy containing this package. A seller advertising list_creatives in media_buy.relationship_notifications.projection_tasks MUST include this field on every assignment row, including rows where indicators is omitted as unknown, so buyers can key and reread the relationship unambiguously when package IDs are reused across media buys.
+             */
+            media_buy_id?: string;
+            /**
+             * When this assignment was created
+             * @format date-time
+             */
+            assigned_date: string;
+            approval_status?: CreativeApprovalStatus;
+            /**
+             * Human-readable explanation when approval_status is rejected. Mirrors get_media_buys for the same relationship.
+             */
+            rejection_reason?: string;
+            /**
+             * Complete, disjoint publisher/placement approval partition when approval_status is partially_approved. A normalized scope appears once. For one publisher, use either one publisher-wide row or placement-specific rows, never both. Omit when one approval_status applies uniformly to the whole assignment. The same scoped outcomes are mirrored on get_media_buys.
+             */
+            approval_scopes?: ScopedCreativeApproval[];
+            /**
+             * Current seller indicators that are true for this creative in this package assignment. The package assignment supplies the default delivery scope; an indicator may narrow further with scope. Omitted means unknown or not evaluated. A present empty array means the seller completed the evaluation identified by indicators_evaluated_scope at indicators_as_of and asserts no current indicator in that evaluated scope.
+             */
+            indicators?: (Indicator & {
                 type?: 'creative_fatigue' | 'creative_quality_opportunity';
-            }[];
+            })[];
+            /**
+             * Indicator types covered by this assignment snapshot. Required whenever indicators is present; omitted types remain unknown.
+             */
+            indicator_types_evaluated?: (IndicatorType & ('creative_fatigue' | 'creative_quality_opportunity'))[];
+            /**
+             * When the seller last completed the evaluation represented by indicators for this relationship. Required whenever indicators is present, including an empty array.
+             * @format date-time
+             */
+            indicators_as_of?: string;
+            /**
+             * Optional publisher or placement scopes covered by this evaluation. Omit when indicators covers the whole package–creative assignment. When present, scopes not listed remain unknown; every returned indicator.scope entry MUST be contained by this set.
+             */
+            indicators_evaluated_scope?: IndicatorScope[];
         }[];
     };
     /**
@@ -4258,6 +4369,18 @@ export type RightsConstraint = {} & {
  */
 export type ScanType = 'progressive' | 'interlaced';
 
+/**
+ * Approval outcome for one publisher or placement scope inside a package–creative assignment. Used when a multi-publisher package does not have one uniform approval outcome.
+ */
+export interface ScopedCreativeApproval {
+    scope: IndicatorScope;
+    approval_status: CreativeApprovalStatus & ('pending_review' | 'approved' | 'rejected');
+    /**
+     * Human-readable explanation when this scope is rejected.
+     */
+    rejection_reason?: string;
+}
+
 /**
  * Machine-readable reason a delivery snapshot was requested but could not be returned. Present only when include_snapshot was true and snapshot data is unavailable.
  */