@adcp/sdk 6.8.0 → 6.10.0

package/dist/lib/server/wire-spec-fields.generated.js

@@ -0,0 +1,172 @@
+"use strict";
+// AUTO-GENERATED by scripts/generate-wire-spec-fields.ts. DO NOT EDIT.
+// Source: schemas/cache/3.0.6/**/*-request.json
+// Generated at: 2026-05-04T09:00:00.000Z
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WIRE_SPEC_FIELDS = void 0;
+/**
+ * Wire-spec field allowlists per request type. The `fields` values
+ * are exact top-level property names from the AdCP request JSON
+ * schemas; `pickWireSpecFields(req, schemaName)` uses them to strip
+ * buyer-controlled args to schema-spec fields at the operational
+ * fan-out boundary. Drift between this map and the schemas is
+ * impossible by construction — both are emitted from the same
+ * codegen pass.
+ *
+ * The `__type` phantom is type-only (`null as unknown as T`) — it
+ * carries the wire-spec request shape so `pickWireSpecFields`'s
+ * return type narrows per `schemaName`. Runtime cost: one null
+ * property per entry.
+ *
+ * Arrays and entry objects are runtime-frozen via `Object.freeze`
+ * so a misbehaving dependency cannot widen the scrub via prototype
+ * pollution or shared-state mutation of the allowlist.
+ */
+exports.WIRE_SPEC_FIELDS = Object.freeze({
+    /** schemas/cache/3.0.6/brand/acquire-rights-request.json */
+    AcquireRightsRequest: Object.freeze({
+        fields: Object.freeze(["adcp_major_version", "buyer", "campaign", "context", "ext", "idempotency_key", "pricing_option_id", "push_notification_config", "revocation_webhook", "rights_id"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/signals/activate-signal-request.json */
+    ActivateSignalRequest: Object.freeze({
+        fields: Object.freeze(["account", "action", "adcp_major_version", "context", "destinations", "ext", "idempotency_key", "pricing_option_id", "signal_agent_segment_id"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/media-buy/build-creative-request.json */
+    BuildCreativeRequest: Object.freeze({
+        fields: Object.freeze(["account", "adcp_major_version", "brand", "concept_id", "context", "creative_id", "creative_manifest", "ext", "idempotency_key", "include_preview", "item_limit", "macro_values", "media_buy_id", "message", "package_id", "preview_inputs", "preview_output_format", "preview_quality", "quality", "target_format_id", "target_format_ids"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/content-standards/calibrate-content-request.json */
+    CalibrateContentRequest: Object.freeze({
+        fields: Object.freeze(["adcp_major_version", "artifact", "context", "ext", "idempotency_key", "standards_id"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/collection/create-collection-list-request.json */
+    CreateCollectionListRequest: Object.freeze({
+        fields: Object.freeze(["account", "adcp_major_version", "base_collections", "brand", "context", "description", "ext", "filters", "idempotency_key", "name"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/content-standards/create-content-standards-request.json */
+    CreateContentStandardsRequest: Object.freeze({
+        fields: Object.freeze(["adcp_major_version", "calibration_exemplars", "context", "ext", "idempotency_key", "policies", "registry_policy_ids", "scope"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/media-buy/create-media-buy-request.json */
+    CreateMediaBuyRequest: Object.freeze({
+        fields: Object.freeze(["account", "adcp_major_version", "advertiser_industry", "agency_estimate_number", "artifact_webhook", "brand", "context", "end_time", "ext", "idempotency_key", "invoice_recipient", "io_acceptance", "packages", "plan_id", "po_number", "proposal_id", "push_notification_config", "reporting_webhook", "start_time", "total_budget"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/property/create-property-list-request.json */
+    CreatePropertyListRequest: Object.freeze({
+        fields: Object.freeze(["account", "adcp_major_version", "base_properties", "brand", "context", "description", "ext", "filters", "idempotency_key", "name"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/collection/delete-collection-list-request.json */
+    DeleteCollectionListRequest: Object.freeze({
+        fields: Object.freeze(["account", "adcp_major_version", "context", "ext", "idempotency_key", "list_id"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/property/delete-property-list-request.json */
+    DeletePropertyListRequest: Object.freeze({
+        fields: Object.freeze(["account", "adcp_major_version", "context", "ext", "idempotency_key", "list_id"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/media-buy/get-media-buy-delivery-request.json */
+    GetMediaBuyDeliveryRequest: Object.freeze({
+        fields: Object.freeze(["account", "adcp_major_version", "attribution_window", "context", "end_date", "ext", "include_package_daily_breakdown", "media_buy_ids", "reporting_dimensions", "start_date", "status_filter"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/media-buy/log-event-request.json */
+    LogEventRequest: Object.freeze({
+        fields: Object.freeze(["adcp_major_version", "context", "event_source_id", "events", "ext", "idempotency_key", "test_event_code"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/media-buy/provide-performance-feedback-request.json */
+    ProvidePerformanceFeedbackRequest: Object.freeze({
+        fields: Object.freeze(["adcp_major_version", "context", "creative_id", "ext", "feedback_source", "idempotency_key", "measurement_period", "media_buy_id", "metric_type", "package_id", "performance_index"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/governance/report-plan-outcome-request.json */
+    ReportPlanOutcomeRequest: Object.freeze({
+        fields: Object.freeze(["adcp_major_version", "check_id", "context", "delivery", "error", "ext", "governance_context", "idempotency_key", "outcome", "plan_id", "purchase_type", "seller_response"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/account/report-usage-request.json */
+    ReportUsageRequest: Object.freeze({
+        fields: Object.freeze(["adcp_major_version", "context", "ext", "idempotency_key", "reporting_period", "usage"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/sponsored-intelligence/si-initiate-session-request.json */
+    SIInitiateSessionRequest: Object.freeze({
+        fields: Object.freeze(["adcp_major_version", "context", "ext", "idempotency_key", "identity", "intent", "media_buy_id", "offering_id", "offering_token", "placement", "supported_capabilities"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/sponsored-intelligence/si-send-message-request.json */
+    SISendMessageRequest: Object.freeze({
+        fields: Object.freeze(["action_response", "adcp_major_version", "context", "ext", "idempotency_key", "message", "session_id"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/account/sync-accounts-request.json */
+    SyncAccountsRequest: Object.freeze({
+        fields: Object.freeze(["accounts", "adcp_major_version", "context", "delete_missing", "dry_run", "ext", "idempotency_key", "push_notification_config"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/media-buy/sync-audiences-request.json */
+    SyncAudiencesRequest: Object.freeze({
+        fields: Object.freeze(["account", "adcp_major_version", "audiences", "context", "delete_missing", "ext", "idempotency_key"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/media-buy/sync-catalogs-request.json */
+    SyncCatalogsRequest: Object.freeze({
+        fields: Object.freeze(["account", "adcp_major_version", "catalog_ids", "catalogs", "context", "delete_missing", "dry_run", "ext", "idempotency_key", "push_notification_config", "validation_mode"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/creative/sync-creatives-request.json */
+    SyncCreativesRequest: Object.freeze({
+        fields: Object.freeze(["account", "adcp_major_version", "assignments", "context", "creative_ids", "creatives", "delete_missing", "dry_run", "ext", "idempotency_key", "push_notification_config", "validation_mode"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/media-buy/sync-event-sources-request.json */
+    SyncEventSourcesRequest: Object.freeze({
+        fields: Object.freeze(["account", "adcp_major_version", "context", "delete_missing", "event_sources", "ext", "idempotency_key"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/account/sync-governance-request.json */
+    SyncGovernanceRequest: Object.freeze({
+        fields: Object.freeze(["accounts", "adcp_major_version", "context", "ext", "idempotency_key"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/governance/sync-plans-request.json */
+    SyncPlansRequest: Object.freeze({
+        fields: Object.freeze(["adcp_major_version", "context", "ext", "idempotency_key", "plans"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/collection/update-collection-list-request.json */
+    UpdateCollectionListRequest: Object.freeze({
+        fields: Object.freeze(["account", "adcp_major_version", "base_collections", "brand", "context", "description", "ext", "filters", "idempotency_key", "list_id", "name", "webhook_url"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/content-standards/update-content-standards-request.json */
+    UpdateContentStandardsRequest: Object.freeze({
+        fields: Object.freeze(["adcp_major_version", "calibration_exemplars", "context", "ext", "idempotency_key", "policies", "registry_policy_ids", "scope", "standards_id"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/media-buy/update-media-buy-request.json */
+    UpdateMediaBuyRequest: Object.freeze({
+        fields: Object.freeze(["account", "adcp_major_version", "canceled", "cancellation_reason", "context", "end_time", "ext", "idempotency_key", "invoice_recipient", "media_buy_id", "new_packages", "packages", "paused", "push_notification_config", "reporting_webhook", "revision", "start_time"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/property/update-property-list-request.json */
+    UpdatePropertyListRequest: Object.freeze({
+        fields: Object.freeze(["account", "adcp_major_version", "base_properties", "brand", "context", "description", "ext", "filters", "idempotency_key", "list_id", "name", "webhook_url"]),
+        __type: null,
+    }),
+    /** schemas/cache/3.0.6/brand/update-rights-request.json */
+    UpdateRightsRequest: Object.freeze({
+        fields: Object.freeze(["adcp_major_version", "context", "end_date", "ext", "idempotency_key", "impression_cap", "paused", "pricing_option_id", "push_notification_config", "rights_id"]),
+        __type: null,
+    }),
+});
+//# sourceMappingURL=wire-spec-fields.generated.js.map

package/dist/lib/server/wire-spec-fields.generated.js.map

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

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

@@ -5,6 +5,8 @@
  */
 export { comply, computeOverallStatus, formatComplianceResults, formatComplianceResultsJSON } from './comply';
 export type { ComplyOptions } from './comply';
+export { buildComplianceSummary, buildCrashSummary, formatComplianceSummaryText, formatComplianceSummaryMarkdown, } from './summary';
+export type { ComplianceSummaryArtifact, ComplianceSummaryFailure, ComplianceSummaryFailureKind, BuildSummaryOptions, BuildCrashSummaryOptions, } from './summary';
 export { SAMPLE_BRIEFS, getBriefById, getBriefsByVertical } from './briefs';
 export type { ComplianceTrack, TrackResult, TrackStatus, OverallStatus, ComplianceFailure, ComplianceResult, ComplianceSummary, AdvisoryObservation, ObservationCategory, ObservationSeverity, SampleBrief, } from './types';
 //# sourceMappingURL=index.d.ts.map

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,EAAE,MAAM,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAC9G,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE5E,YAAY,EACV,eAAe,EACf,WAAW,EACX,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,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,EAAE,MAAM,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAC9G,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,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,GACZ,MAAM,SAAS,CAAC"}

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

@@ -5,12 +5,17 @@
  * comply → "Your agent works"  (deterministic, per-track)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getBriefsByVertical = exports.getBriefById = exports.SAMPLE_BRIEFS = exports.formatComplianceResultsJSON = exports.formatComplianceResults = exports.computeOverallStatus = exports.comply = void 0;
+exports.getBriefsByVertical = exports.getBriefById = exports.SAMPLE_BRIEFS = exports.formatComplianceSummaryMarkdown = exports.formatComplianceSummaryText = exports.buildCrashSummary = exports.buildComplianceSummary = exports.formatComplianceResultsJSON = exports.formatComplianceResults = exports.computeOverallStatus = exports.comply = void 0;
 var comply_1 = require("./comply");
 Object.defineProperty(exports, "comply", { enumerable: true, get: function () { return comply_1.comply; } });
 Object.defineProperty(exports, "computeOverallStatus", { enumerable: true, get: function () { return comply_1.computeOverallStatus; } });
 Object.defineProperty(exports, "formatComplianceResults", { enumerable: true, get: function () { return comply_1.formatComplianceResults; } });
 Object.defineProperty(exports, "formatComplianceResultsJSON", { enumerable: true, get: function () { return comply_1.formatComplianceResultsJSON; } });
+var summary_1 = require("./summary");
+Object.defineProperty(exports, "buildComplianceSummary", { enumerable: true, get: function () { return summary_1.buildComplianceSummary; } });
+Object.defineProperty(exports, "buildCrashSummary", { enumerable: true, get: function () { return summary_1.buildCrashSummary; } });
+Object.defineProperty(exports, "formatComplianceSummaryText", { enumerable: true, get: function () { return summary_1.formatComplianceSummaryText; } });
+Object.defineProperty(exports, "formatComplianceSummaryMarkdown", { enumerable: true, get: function () { return summary_1.formatComplianceSummaryMarkdown; } });
 var briefs_1 = require("./briefs");
 Object.defineProperty(exports, "SAMPLE_BRIEFS", { enumerable: true, get: function () { return briefs_1.SAMPLE_BRIEFS; } });
 Object.defineProperty(exports, "getBriefById", { enumerable: true, get: function () { return briefs_1.getBriefById; } });

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/testing/compliance/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,mCAA8G;AAArG,gGAAA,MAAM,OAAA;AAAE,8GAAA,oBAAoB,OAAA;AAAE,iHAAA,uBAAuB,OAAA;AAAE,qHAAA,2BAA2B,OAAA;AAG3F,mCAA4E;AAAnE,uGAAA,aAAa,OAAA;AAAE,sGAAA,YAAY,OAAA;AAAE,6GAAA,mBAAmB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/testing/compliance/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,mCAA8G;AAArG,gGAAA,MAAM,OAAA;AAAE,8GAAA,oBAAoB,OAAA;AAAE,iHAAA,uBAAuB,OAAA;AAAE,qHAAA,2BAA2B,OAAA;AAG3F,qCAKmB;AAJjB,iHAAA,sBAAsB,OAAA;AACtB,4GAAA,iBAAiB,OAAA;AACjB,sHAAA,2BAA2B,OAAA;AAC3B,0HAAA,+BAA+B,OAAA;AAUjC,mCAA4E;AAAnE,uGAAA,aAAa,OAAA;AAAE,sGAAA,YAAY,OAAA;AAAE,6GAAA,mBAAmB,OAAA"}

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

@@ -0,0 +1,77 @@
+/**
+ * Narrow, schema-stable summary artifact for compliance runs.
+ *
+ * `formatComplianceResultsJSON` serializes the full ComplianceResult — that
+ * shape evolves with the protocol. Downstream tooling (badges, Slack bots,
+ * dashboards) wants a thin contract: pass/fail counts and a flat list of
+ * failures with stable IDs. That's what this module provides.
+ *
+ * Three renderers:
+ *   - `buildComplianceSummary`        → ComplianceSummaryArtifact (the JSON contract)
+ *   - `formatComplianceSummaryText`   → stderr block with greppable `STORYBOARD-FAIL` prefix
+ *   - `formatComplianceSummaryMarkdown` → table for $GITHUB_STEP_SUMMARY
+ */
+import type { ComplianceResult, ComplianceTrack, OverallStatus } from './types';
+/**
+ * Stable, schema-versioned summary. Adopters depending on this shape should
+ * gate on `schema_version` and treat unknown fields as ignorable.
+ */
+export interface ComplianceSummaryArtifact {
+    schema_version: number;
+    agent_url: string;
+    sdk_version: string;
+    adcp_version: string;
+    overall_status: OverallStatus;
+    passed: number;
+    failed: number;
+    skipped: number;
+    total_duration_ms: number;
+    tested_at: string;
+    storyboards_executed: string[];
+    failures: ComplianceSummaryFailure[];
+}
+/**
+ * Discriminator for `reason`. Lets a Slack bot color-code or filter without
+ * regexing the reason string. Pinned at v1; new kinds are additive.
+ */
+export type ComplianceSummaryFailureKind = 'error' /** The step itself raised — network, transport, runtime exception. */ | 'validation' /** A storyboard validation check failed (schema, field_present, etc.). */ | 'expected_mismatch' /** No structured validation; reason derived from the step's `expected:` text. */ | 'unspecified'; /** Failure with no extractable reason — should be rare. */
+export interface ComplianceSummaryFailure {
+    track: ComplianceTrack;
+    storyboard_id: string;
+    step_id: string;
+    reason: string;
+    reason_kind: ComplianceSummaryFailureKind;
+}
+export interface BuildSummaryOptions {
+    sdkVersion: string;
+    adcpVersion: string;
+}
+export declare function buildComplianceSummary(result: ComplianceResult, opts: BuildSummaryOptions): ComplianceSummaryArtifact;
+/**
+ * stderr-style summary block. Always starts with `STORYBOARD-FAIL` (kebab,
+ * no spaces) on any hard-failing run, so CI scripts can `grep -q STORYBOARD-FAIL`
+ * regardless of how the workflow handles the exit code. `partial` runs render
+ * `STORYBOARD-PARTIAL` — distinct from both green and red so dashboards can
+ * surface "wired but unexercised" without false-alarming CI.
+ */
+export declare function formatComplianceSummaryText(s: ComplianceSummaryArtifact): string;
+/**
+ * Markdown for `$GITHUB_STEP_SUMMARY`. Renders in the PR UI summary panel,
+ * so reviewers see failures without opening the run log.
+ */
+export declare function formatComplianceSummaryMarkdown(s: ComplianceSummaryArtifact): string;
+/**
+ * Synthesize a summary artifact when the runner itself crashed before
+ * `comply()` produced a result (network down, capabilities parse error,
+ * auth handshake exception). Schema-stable on the same `schema_version: 1`
+ * contract so a Slack bot built against the artifact sees a valid payload
+ * — rather than nothing — precisely when the agent is broken hardest.
+ */
+export interface BuildCrashSummaryOptions extends BuildSummaryOptions {
+    agentUrl: string;
+    error: Error | string;
+    startedAt: string;
+    durationMs: number;
+}
+export declare function buildCrashSummary(opts: BuildCrashSummaryOptions): ComplianceSummaryArtifact;
+//# sourceMappingURL=summary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/compliance/summary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAqB,gBAAgB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAInG;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,aAAa,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,QAAQ,EAAE,wBAAwB,EAAE,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,MAAM,4BAA4B,GACpC,OAAO,CAAC,sEAAsE,GAC9E,YAAY,CAAC,0EAA0E,GACvF,mBAAmB,CAAC,iFAAiF,GACrG,aAAa,CAAC,CAAC,2DAA2D;AAE9E,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,eAAe,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,4BAA4B,CAAC;CAC3C;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,mBAAmB,GAAG,yBAAyB,CAerH;AA2CD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,yBAAyB,GAAG,MAAM,CAiChF;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,CAAC,EAAE,yBAAyB,GAAG,MAAM,CA4BpF;AASD;;;;;;GAMG;AACH,MAAM,WAAW,wBAAyB,SAAQ,mBAAmB;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,wBAAwB,GAAG,yBAAyB,CAwB3F"}

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

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * Narrow, schema-stable summary artifact for compliance runs.
+ *
+ * `formatComplianceResultsJSON` serializes the full ComplianceResult — that
+ * shape evolves with the protocol. Downstream tooling (badges, Slack bots,
+ * dashboards) wants a thin contract: pass/fail counts and a flat list of
+ * failures with stable IDs. That's what this module provides.
+ *
+ * Three renderers:
+ *   - `buildComplianceSummary`        → ComplianceSummaryArtifact (the JSON contract)
+ *   - `formatComplianceSummaryText`   → stderr block with greppable `STORYBOARD-FAIL` prefix
+ *   - `formatComplianceSummaryMarkdown` → table for $GITHUB_STEP_SUMMARY
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildComplianceSummary = buildComplianceSummary;
+exports.formatComplianceSummaryText = formatComplianceSummaryText;
+exports.formatComplianceSummaryMarkdown = formatComplianceSummaryMarkdown;
+exports.buildCrashSummary = buildCrashSummary;
+const SUMMARY_SCHEMA_VERSION = 1;
+function buildComplianceSummary(result, opts) {
+    return {
+        schema_version: SUMMARY_SCHEMA_VERSION,
+        agent_url: result.agent_url,
+        sdk_version: opts.sdkVersion,
+        adcp_version: opts.adcpVersion,
+        overall_status: result.overall_status,
+        passed: result.summary.steps_passed ?? 0,
+        failed: result.summary.steps_failed ?? 0,
+        skipped: result.summary.steps_skipped ?? 0,
+        total_duration_ms: result.total_duration_ms,
+        tested_at: result.tested_at,
+        storyboards_executed: result.storyboards_executed ?? [],
+        failures: (result.failures ?? []).map(toSummaryFailure),
+    };
+}
+function toSummaryFailure(f) {
+    const { reason, reason_kind } = deriveReason(f);
+    return {
+        track: f.track,
+        storyboard_id: f.storyboard_id,
+        step_id: f.step_id,
+        reason,
+        reason_kind,
+    };
+}
+const REASON_MAX_CHARS = 500;
+function deriveReason(f) {
+    if (f.error)
+        return { reason: truncate(f.error, REASON_MAX_CHARS), reason_kind: 'error' };
+    if (f.validation?.description) {
+        const desc = f.validation.description;
+        const ptr = f.validation.json_pointer ? ` at ${f.validation.json_pointer}` : '';
+        return { reason: truncate(`${desc}${ptr}`, REASON_MAX_CHARS), reason_kind: 'validation' };
+    }
+    if (f.expected) {
+        return { reason: truncate(f.expected.split('\n')[0], REASON_MAX_CHARS), reason_kind: 'expected_mismatch' };
+    }
+    return { reason: 'failed', reason_kind: 'unspecified' };
+}
+function truncate(s, max) {
+    return s.length > max ? `${s.slice(0, max - 1)}…` : s;
+}
+/**
+ * Hard-failure statuses — runs that should never look green to CI. `partial`
+ * is intentionally not in this set: it means some tracks ran silent (wired
+ * but unexercised), which is a reportable observation, not a CI block.
+ */
+const HARD_FAIL_STATUSES = new Set(['failing', 'unreachable', 'auth_required']);
+function isHardFail(s) {
+    return HARD_FAIL_STATUSES.has(s.overall_status) || s.failures.length > 0;
+}
+/**
+ * stderr-style summary block. Always starts with `STORYBOARD-FAIL` (kebab,
+ * no spaces) on any hard-failing run, so CI scripts can `grep -q STORYBOARD-FAIL`
+ * regardless of how the workflow handles the exit code. `partial` runs render
+ * `STORYBOARD-PARTIAL` — distinct from both green and red so dashboards can
+ * surface "wired but unexercised" without false-alarming CI.
+ */
+function formatComplianceSummaryText(s) {
+    const lines = [];
+    lines.push('');
+    lines.push(`──── Storyboard Summary ────`);
+    lines.push(`Agent:     ${s.agent_url}`);
+    lines.push(`SDK:       @adcp/sdk ${s.sdk_version} (AdCP ${s.adcp_version})`);
+    lines.push(`Status:    ${s.overall_status}`);
+    lines.push(`Steps:     ${s.passed} passed, ${s.failed} failed, ${s.skipped} skipped`);
+    lines.push(`Duration:  ${(s.total_duration_ms / 1000).toFixed(1)}s`);
+    lines.push('');
+    if (!isHardFail(s)) {
+        if (s.overall_status === 'passing') {
+            lines.push(`STORYBOARD-OK ${s.passed}/${s.passed + s.failed + s.skipped} steps passed`);
+        }
+        else {
+            // `partial` and `silent` — some tracks were wired but not exercised.
+            // Distinct marker so dashboards can surface this without lighting CI red.
+            lines.push(`STORYBOARD-PARTIAL ${s.passed} steps passed, run ended ${s.overall_status}`);
+        }
+        lines.push('');
+        return lines.join('\n');
+    }
+    if (s.failures.length === 0) {
+        lines.push(`STORYBOARD-FAIL run ended ${s.overall_status} with no graded steps`);
+    }
+    else {
+        lines.push(`STORYBOARD-FAIL ${s.failures.length} step(s):`);
+        for (const f of s.failures) {
+            lines.push(`  - ${f.storyboard_id}/${f.step_id} [${f.track}]: ${f.reason}`);
+        }
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Markdown for `$GITHUB_STEP_SUMMARY`. Renders in the PR UI summary panel,
+ * so reviewers see failures without opening the run log.
+ */
+function formatComplianceSummaryMarkdown(s) {
+    const lines = [];
+    const heading = !isHardFail(s)
+        ? s.overall_status === 'passing'
+            ? '✅ Storyboard run passed'
+            : `⚠️ Storyboard run ended ${s.overall_status} (wired but partly unexercised)`
+        : s.failures.length === 0
+            ? `❌ Storyboard run: ended ${s.overall_status} with no graded steps`
+            : `❌ Storyboard run: ${s.failures.length} failure(s)`;
+    lines.push(`## ${heading}`);
+    lines.push('');
+    lines.push(`- **Agent:** \`${s.agent_url}\``);
+    lines.push(`- **SDK:** \`@adcp/sdk ${s.sdk_version}\` (AdCP \`${s.adcp_version}\`)`);
+    lines.push(`- **Status:** \`${s.overall_status}\``);
+    lines.push(`- **Steps:** ${s.passed} passed, ${s.failed} failed, ${s.skipped} skipped`);
+    lines.push(`- **Duration:** ${(s.total_duration_ms / 1000).toFixed(1)}s`);
+    lines.push('');
+    if (s.failures.length > 0) {
+        lines.push('| Track | Storyboard | Step | Reason |');
+        lines.push('| --- | --- | --- | --- |');
+        for (const f of s.failures) {
+            lines.push(`| \`${f.track}\` | \`${f.storyboard_id}\` | \`${f.step_id}\` | ${escapeTableCell(f.reason)} |`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+function escapeTableCell(s) {
+    // Escape backslashes first so a `\|` in the input doesn't combine with
+    // the pipe-escape below and produce `\\|` (literal backslash + raw pipe,
+    // which breaks the table). Order matters: `\` → `\\` then `|` → `\|`.
+    return s.replace(/\\/g, '\\\\').replace(/\|/g, '\\|').replace(/\n/g, ' ');
+}
+function buildCrashSummary(opts) {
+    const message = opts.error instanceof Error ? opts.error.message : String(opts.error);
+    return {
+        schema_version: SUMMARY_SCHEMA_VERSION,
+        agent_url: opts.agentUrl,
+        sdk_version: opts.sdkVersion,
+        adcp_version: opts.adcpVersion,
+        overall_status: 'unreachable',
+        passed: 0,
+        failed: 1,
+        skipped: 0,
+        total_duration_ms: opts.durationMs,
+        tested_at: opts.startedAt,
+        storyboards_executed: [],
+        failures: [
+            {
+                track: 'core',
+                storyboard_id: 'pre-flight',
+                step_id: 'comply',
+                reason: message.length > 500 ? `${message.slice(0, 499)}…` : message,
+                reason_kind: 'error',
+            },
+        ],
+    };
+}
+//# sourceMappingURL=summary.js.map

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

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

package/dist/lib/testing/comply-controller.d.ts

@@ -44,7 +44,7 @@
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { ZodTypeAny } from 'zod';
-import { TOOL_INPUT_SHAPE, type SeedFixtureCache } from '../server/test-controller';
+import { TOOL_INPUT_SHAPE, type SeedFixtureCache, type UpstreamTrafficSuccessResponse } from '../server/test-controller';
 import { type AdcpServer } from '../server/adcp-server';
 import type { ComplyTestControllerResponse, ForcedDirectiveSuccess, SimulationSuccess, StateTransitionSuccess } from '../types/tools.generated';
 import type { AccountStatus, CreativeStatus, MediaBuyStatus } from '../types/core.generated';
@@ -143,6 +143,38 @@ export type ForceAdapter<P> = (params: P, ctx: ComplyControllerContext) => Promi
 export type DirectiveAdapter<P> = (params: P, ctx: ComplyControllerContext) => Promise<ForcedDirectiveSuccess> | ForcedDirectiveSuccess;
 /** Simulate adapters return a {@link SimulationSuccess}. */
 export type SimulateAdapter<P> = (params: P, ctx: ComplyControllerContext) => Promise<SimulationSuccess> | SimulationSuccess;
+/** Params for the `query_upstream_traffic` extension scenario (spec PR
+ * adcontextprotocol/adcp#3816). All fields optional; the recorder
+ * filters by these. */
+export interface QueryUpstreamTrafficParams {
+    since_timestamp?: string;
+    endpoint_pattern?: string;
+    limit?: number;
+}
+/** Adapter for the `query_upstream_traffic` extension scenario. Returns
+ * the recorded upstream HTTP calls produced during the current
+ * storyboard step — the runner consults this for `check: upstream_traffic`
+ * validations. Adopters typically delegate to the reference recorder
+ * middleware shipped at `@adcp/sdk/upstream-recorder`:
+ *
+ * ```ts
+ * complyTest: {
+ *   queryUpstreamTraffic: (params, _ctx) => {
+ *     const result = recorder.query({
+ *       principal: RECORDER_PRINCIPAL,
+ *       ...(params.since_timestamp !== undefined && { sinceTimestamp: params.since_timestamp }),
+ *       ...(params.endpoint_pattern !== undefined && { endpointPattern: params.endpoint_pattern }),
+ *       ...(params.limit !== undefined && { limit: params.limit }),
+ *     });
+ *     return toQueryUpstreamTrafficResponse(result);
+ *   },
+ * }
+ * ```
+ *
+ * The principal MUST match between record-time (`runWithPrincipal`) and
+ * query-time, or the recorder returns zero rows per cross-tenant
+ * isolation. */
+export type QueryUpstreamTrafficAdapter = (params: QueryUpstreamTrafficParams, ctx: ComplyControllerContext) => Promise<UpstreamTrafficSuccessResponse> | UpstreamTrafficSuccessResponse;
 export interface ComplyControllerConfig {
     /** Per-request gate. Return `false` to reject with `FORBIDDEN` — suitable
      * for tenants flagged as production, accounts not marked sandbox, or
@@ -190,6 +222,15 @@ export interface ComplyControllerConfig {
         delivery?: SimulateAdapter<SimulateDeliveryParams>;
         budget_spend?: SimulateAdapter<SimulateBudgetSpendParams>;
     };
+    /**
+     * `query_upstream_traffic` adapter (spec PR adcontextprotocol/adcp#3816).
+     * Returns the recorded upstream HTTP calls produced during the current
+     * storyboard step so the runner can grade `check: upstream_traffic`
+     * validations. Adopters typically wire the reference recorder from
+     * `@adcp/sdk/upstream-recorder`. When omitted, the scenario reports as
+     * `not_applicable` per the runner's normal capability discovery.
+     */
+    queryUpstreamTraffic?: QueryUpstreamTrafficAdapter;
     /** Override the seed idempotency cache (e.g., to scope by tenant or
      * persist across restarts). Defaults to an unbounded in-memory cache. */
     seedCache?: SeedFixtureCache;

package/dist/lib/testing/comply-controller.d.ts.map

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

package/dist/lib/testing/comply-controller.js

@@ -58,7 +58,7 @@ function controllerError(code, detail) {
  * `handleTestControllerRequest` returns `UNKNOWN_SCENARIO` for the rest. */
 function buildStore(config, ctx) {
     const store = {};
-    const { seed, force, simulate } = config;
+    const { seed, force, simulate, queryUpstreamTraffic } = config;
     if (seed?.product) {
         store.seedProduct = async (productId, fixture) => {
             await seed.product({ product_id: productId, fixture: fixture ?? {} }, ctx);
@@ -113,6 +113,9 @@ function buildStore(config, ctx) {
     if (simulate?.budget_spend) {
         store.simulateBudgetSpend = params => Promise.resolve(simulate.budget_spend(params, ctx));
     }
+    if (queryUpstreamTraffic) {
+        store.queryUpstreamTraffic = params => Promise.resolve(queryUpstreamTraffic(params, ctx));
+    }
     return store;
 }
 /** The set of force_* / simulate_* scenarios a config advertises via
@@ -135,6 +138,15 @@ function advertisedScenarios(config) {
         out.push(test_controller_1.CONTROLLER_SCENARIOS.SIMULATE_DELIVERY);
     if (config.simulate?.budget_spend)
         out.push(test_controller_1.CONTROLLER_SCENARIOS.SIMULATE_BUDGET_SPEND);
+    // `query_upstream_traffic` is an extension scenario (spec PR
+    // adcontextprotocol/adcp#3816) — not yet in the schema cache's
+    // `ControllerScenario` enum, but the dispatcher accepts it under
+    // `TOOL_INPUT_SHAPE.scenario: z.string()`'s open-extension pattern.
+    // Cast through unknown until the schema lands, then this becomes a
+    // `CONTROLLER_SCENARIOS.QUERY_UPSTREAM_TRAFFIC` reference like the
+    // others above.
+    if (config.queryUpstreamTraffic)
+        out.push('query_upstream_traffic');
     return out;
 }
 /** Create a comply_test_controller scaffold from domain-grouped adapters. */