npm - @adcp/sdk - Versions diffs - 12.0.6 → 12.1.1 - Mend

@adcp/sdk 12.0.6 → 12.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1452) hide show

package/dist/lib/testing/types.d.mts CHANGED Viewed

@@ -3,12 +3,18 @@
  */
 import type { FormatReferenceStructuredObject as FormatID } from '../types/core.generated.mjs';
 import type { AdcpVersion } from '../version.mjs';
-import type { VersionEnvelopeMode } from '../protocols/index.mjs';
+import type { TransportOptions, VersionEnvelopeMode } from '../protocols/index.mjs';
 export type TestScenario = 'health_check' | 'discovery' | 'create_media_buy' | 'full_sales_flow' | 'reporting_flow' | 'creative_sync' | 'creative_inline' | 'creative_reference' | 'pricing_models' | 'creative_flow' | 'creative_lifecycle' | 'signals_flow' | 'error_handling' | 'validation' | 'pricing_edge_cases' | 'temporal_validation' | 'behavior_analysis' | 'response_consistency' | 'governance_property_lists' | 'governance_content_standards' | 'property_list_filters' | 'campaign_governance' | 'campaign_governance_denied' | 'campaign_governance_conditions' | 'campaign_governance_delivery' | 'seller_governance_context' | 'si_session_lifecycle' | 'si_availability' | 'si_handoff' | 'capability_discovery' | 'schema_compliance' | 'sync_audiences' | 'media_buy_lifecycle' | 'terminal_state_enforcement' | 'package_lifecycle' | 'error_codes' | 'error_structure' | 'error_transport' | 'deterministic_creative' | 'deterministic_media_buy' | 'deterministic_account' | 'deterministic_session' | 'deterministic_delivery' | 'deterministic_budget' | 'controller_validation' | 'brand_identity' | 'brand_rights_flow' | 'creative_approval';
 export interface TestOptions {
     protocol?: 'mcp' | 'a2a';
     /** Optional cancellation signal for discovery and storyboard helper calls. */
     signal?: AbortSignal;
+    /**
+     * Runtime-only transport configuration for discovery and every storyboard
+     * or compliance tool call. In particular, `fetchFn` lets hosted runners
+     * enforce a request-scoped network policy without replacing global fetch.
+     */
+    transport?: TransportOptions;
     /**
      * AdCP protocol version the test client should speak. Storyboard runners
      * set this from the compliance cache version instead of relying on the

package/dist/lib/testing/types.d.ts CHANGED Viewed

@@ -3,12 +3,18 @@
  */
 import type { FormatReferenceStructuredObject as FormatID } from '../types/core.generated';
 import type { AdcpVersion } from '../version';
-import type { VersionEnvelopeMode } from '../protocols';
+import type { TransportOptions, VersionEnvelopeMode } from '../protocols';
 export type TestScenario = 'health_check' | 'discovery' | 'create_media_buy' | 'full_sales_flow' | 'reporting_flow' | 'creative_sync' | 'creative_inline' | 'creative_reference' | 'pricing_models' | 'creative_flow' | 'creative_lifecycle' | 'signals_flow' | 'error_handling' | 'validation' | 'pricing_edge_cases' | 'temporal_validation' | 'behavior_analysis' | 'response_consistency' | 'governance_property_lists' | 'governance_content_standards' | 'property_list_filters' | 'campaign_governance' | 'campaign_governance_denied' | 'campaign_governance_conditions' | 'campaign_governance_delivery' | 'seller_governance_context' | 'si_session_lifecycle' | 'si_availability' | 'si_handoff' | 'capability_discovery' | 'schema_compliance' | 'sync_audiences' | 'media_buy_lifecycle' | 'terminal_state_enforcement' | 'package_lifecycle' | 'error_codes' | 'error_structure' | 'error_transport' | 'deterministic_creative' | 'deterministic_media_buy' | 'deterministic_account' | 'deterministic_session' | 'deterministic_delivery' | 'deterministic_budget' | 'controller_validation' | 'brand_identity' | 'brand_rights_flow' | 'creative_approval';
 export interface TestOptions {
     protocol?: 'mcp' | 'a2a';
     /** Optional cancellation signal for discovery and storyboard helper calls. */
     signal?: AbortSignal;
+    /**
+     * Runtime-only transport configuration for discovery and every storyboard
+     * or compliance tool call. In particular, `fetchFn` lets hosted runners
+     * enforce a request-scoped network policy without replacing global fetch.
+     */
+    transport?: TransportOptions;
     /**
      * AdCP protocol version the test client should speak. Storyboard runners
      * set this from the compliance cache version instead of relying on the

package/dist/lib/testing/types.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/testing/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,+BAA+B,IAAI,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAG3F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;~~AAGxD~~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"}
1	+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/testing/types.ts"],"names":[],"mappings":"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"}

package/dist/lib/testing/types.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../../src/lib/testing/types.ts"],"sourcesContent":["/*\n Types for AdCP Agent E2E Testing\n /\n\nimport type { FormatReferenceStructuredObject as FormatID } from '../types/core.generated';\nimport type { ControllerDetection } from './test-controller';\nimport type { WebhookReceiver } from './storyboard/webhook-receiver';\nimport type { AdcpVersion } from '../version';\nimport type { VersionEnvelopeMode } from '../protocols';\n\n// Test scenarios that can be run\nexport type TestScenario =\n \| 'health_check' // Just check if agent responds\n \| 'discovery' // get_products, list_creative_formats, list_authorized_properties\n \| 'create_media_buy' // Discovery + create a test media buy\n \| 'full_sales_flow' // Full lifecycle: discovery -> create -> update -> delivery\n \| 'reporting_flow' // Dedicated: create media buy -> get_media_buy_delivery validation\n \| 'creative_sync' // Test sync_creatives flow\n \| 'creative_inline' // Test inline creatives in create_media_buy\n \| 'creative_reference' // Build -> sync -> reference a creative via creative_ids\n \| 'pricing_models' // Test different pricing models the agent supports\n \| 'creative_flow' // Creative agent: list_formats -> build -> preview\n \| 'creative_lifecycle' // Creative agent: formats -> sync multiple -> list with/without snapshot -> build/preview\n \| 'signals_flow' // Signals agent: get_signals -> activate\n // Edge case testing scenarios\n \| 'error_handling' // Test agent returns proper error responses\n \| 'validation' // Test schema validation (invalid inputs should be rejected)\n \| 'pricing_edge_cases' // Test auction vs fixed pricing, min spend, bid_price requirements\n \| 'temporal_validation' // Test date/time ordering and format validation\n // Behavioral analysis scenarios\n \| 'behavior_analysis' // Analyze agent behavior: auth requirements, brief relevance, filtering\n // Response consistency scenarios\n \| 'response_consistency' // Check for schema errors, pagination bugs, data mismatches\n // v3 Governance protocol scenarios\n \| 'governance_property_lists' // Property list CRUD operations\n \| 'governance_content_standards' // Content standards lifecycle\n \| 'property_list_filters' // Property list filter round-trip: GARM, MFA, custom_tags, feature_requirements\n // v3 Campaign governance scenarios\n \| 'campaign_governance' // Full lifecycle: sync_plans -> check -> execute -> report outcome\n \| 'campaign_governance_denied' // Denied flow: over-budget, unauthorized market\n \| 'campaign_governance_conditions' // Conditions flow: apply conditions -> re-check\n \| 'campaign_governance_delivery' // Delivery monitoring with drift detection\n \| 'seller_governance_context' // Seller persistence of governance_context\n // v3 SI (Sponsored Intelligence) protocol scenarios\n \| 'si_session_lifecycle' // Full SI session: initiate -> messages -> terminate\n \| 'si_availability' // Check SI offering availability\n \| 'si_handoff' // ACP handoff flow: initiate -> purchase intent -> terminate with handoff_transaction\n // v3 Capability discovery\n \| 'capability_discovery' // Verify get_adcp_capabilities response\n // Schema compliance\n \| 'schema_compliance' // Validate v3 channel enum, pricing field names, format assets structure\n // Audience management\n \| 'sync_audiences' // Test CRM audience sync flow\n // State machine compliance\n \| 'media_buy_lifecycle' // Pause -> resume -> cancel state transitions\n \| 'terminal_state_enforcement' // Verify agents reject updates to terminal-state media buys\n \| 'package_lifecycle' // Package-level pause/resume independent of media buy status\n // Error compliance (transport error mapping spec)\n \| 'error_codes' // Validate standard AdCP error codes in responses\n \| 'error_structure' // Validate error JSON structure against error.json schema\n \| 'error_transport' // Validate transport binding (structuredContent, text fallback)\n // Deterministic state machine scenarios (require comply_test_controller)\n \| 'deterministic_creative' // Force creative status transitions via test controller\n \| 'deterministic_media_buy' // Force media buy status transitions via test controller\n \| 'deterministic_account' // Force account status transitions + operation gates\n \| 'deterministic_session' // Force SI session timeout/termination\n \| 'deterministic_delivery' // Simulate delivery data and verify reporting\n \| 'deterministic_budget' // Simulate budget spend and verify financials\n \| 'controller_validation' // Validate the test controller itself (error codes, edge cases)\n // Brand rights protocol scenarios\n \| 'brand_identity' // Brand identity discovery (public and authorized access tiers)\n \| 'brand_rights_flow' // Brand rights: get_rights -> acquire_rights lifecycle\n \| 'creative_approval'; // Creative approval workflow for brand compliance\n\nexport interface TestOptions {\n // Protocol to use for testing (default: 'mcp')\n protocol?: 'mcp' \| 'a2a';\n /* Optional cancellation signal for discovery and storyboard helper calls. /\n signal?: AbortSignal;\n /\n AdCP protocol version the test client should speak. Storyboard runners\n * set this from the compliance cache version instead of relying on the\n * installed package default.\n /\n adcpVersion?: AdcpVersion \| (string & {});\n /\n Optional wire-only AdCP version envelope override. Validation and schema\n * selection continue to use `adcpVersion`; request envelopes use this value.\n * Intended for hosted stable-line badges backed by prerelease caches.\n /\n wireAdcpVersion?: AdcpVersion \| (string & {});\n /\n Version-envelope emission mode. Defaults to `auto`; 3.0 storyboards emit\n * the legacy major marker only, while 3.1 storyboards also emit the exact\n * `adcp_version` marker. Compliance discovery may negotiate `major-only`\n * for strict pre-3.1 agents.\n /\n versionEnvelope?: VersionEnvelopeMode;\n /\n External schema bundle root used for request/response validation during\n * storyboard and compliance runs. The root is registered against\n * `adcpVersion` (or the storyboard/compliance version when omitted).\n /\n schemaRoot?: string;\n /* Custom User-Agent string sent with all outbound requests /\n userAgent?: string;\n // Brand reference for product discovery (preferred over brand_manifest)\n brand?: { domain: string; brand_id?: string };\n // Custom brief for product discovery\n brief?: string;\n // Budget for test media buy (default: 1000)\n budget?: number;\n // Specific format IDs to test\n format_ids?: string[];\n // Test session ID for isolation\n test_session_id?: string;\n // Channels to focus on (if not specified, tests all agent supports)\n channels?: string[];\n // Specific pricing models to test\n pricing_models?: string[];\n /\n Authentication for agents that require it.\n \n - `bearer`: raw token sent as `Authorization: Bearer <token>`.\n * - `basic`: cleartext `username` and `password`, encoded internally.\n * - `oauth`: saved OAuth tokens (access_token + refresh_token). MCP only.\n * The library auto-refreshes on 401. Obtain tokens interactively via\n * `adcp --save-auth <alias> --oauth`, then pass the saved blob here for\n * non-interactive reuse.\n * - `oauth_client_credentials`: RFC 6749 §4.4 machine-to-machine flow.\n * The library exchanges the secret for a fresh access token before each\n * call (cached while valid). Supply `tokens` to seed the cache; omit to\n * exchange on first call.\n /\n auth?:\n \| { type: 'bearer'; token: string }\n \| { type: 'basic'; username: string; password: string }\n \| {\n type: 'oauth';\n tokens: import('../types/adcp').AgentOAuthTokens;\n client?: import('../types/adcp').AgentOAuthClient;\n }\n \| {\n type: 'oauth_client_credentials';\n credentials: import('../types/adcp').AgentOAuthClientCredentials;\n tokens?: import('../types/adcp').AgentOAuthTokens;\n };\n /\n Extra HTTP headers applied to every outbound request to the agent.\n * Forwarded into `AgentConfig.headers`, so MCP and A2A transports both\n * see them. `Authorization` and `x-adcp-auth` are reserved — auth wins.\n \n Typical use: tenant-routing headers (`x-adcp-tenant`, `Apx-Incoming-Host`)\n * for multi-tenant agents fronted by a reverse proxy. The CLI exposes these\n * via `-H KEY=VALUE` (repeatable) and persists them in `~/.adcp/config.json`.\n /\n headers?: Record<string, string>;\n // Brand manifest for creative testing\n brand_manifest?: {\n name: string;\n url?: string;\n tagline?: string;\n logos?: Array<{\n url: string;\n orientation?: 'square' \| 'horizontal' \| 'vertical' \| 'stacked';\n background?: 'dark-bg' \| 'light-bg' \| 'transparent-bg';\n variant?: 'primary' \| 'secondary' \| 'icon' \| 'wordmark' \| 'full-lockup';\n tags?: string[];\n usage?: string;\n width?: number;\n height?: number;\n }>;\n colors?: Record<string, string>;\n tone?: {\n voice?: string;\n attributes?: string[];\n dos?: string[];\n donts?: string[];\n };\n assets?: Array<{\n asset_id: string;\n asset_type: string;\n url: string;\n width?: number;\n height?: number;\n tags?: string[];\n }>;\n };\n // For creative testing: test multiple formats programmatically\n test_all_formats?: boolean;\n // For creative testing: max formats to test when test_all_formats is true\n max_formats_to_test?: number;\n // For signals testing: specific signal types to test\n signal_types?: string[];\n // For governance testing: name for test property list\n property_list_name?: string;\n // For governance testing: specific content standards to test\n content_standards_id?: string;\n // For SI testing: specific offering ID to test\n si_offering_id?: string;\n // For SI testing: initial conversation context\n si_context?: string;\n /\n Shared explicit account id for test scenarios that need an account-scoped\n * request. Domain-specific account ids below take precedence when provided.\n /\n account_id?: string;\n /\n For media-buy testing: account ID to use with get_products,\n * create_media_buy, sync_creatives, and related media-buy flows.\n /\n media_buy_account_id?: string;\n // For audience testing: account ID to use with sync_audiences\n audience_account_id?: string;\n // When true, use sandbox mode. For implicit accounts, uses the natural key with\n // sandbox: true. For explicit accounts, discovers sandbox accounts via list_accounts.\n sandbox?: boolean;\n /\n When true, the runner injects `ext.adcp.disable_sandbox: true` on every\n * outgoing request, signaling the agent under test to bypass any internal\n * sandbox routing (env-var fallbacks, brand-domain heuristics, fixture\n * substitutes) and exercise its real adapter path. Distinct from `sandbox`\n * (which sets `account.sandbox: false` — a value, not a routing hint).\n \n Honored by adopters who explicitly read `ext.adcp.disable_sandbox`.\n * Agents that don't recognize the field ignore it (per spec, `ext` is\n * accepted-without-error). The pair (sandbox=false + disable_sandbox=true)\n * is the strongest \"production path only\" signal the runner can send;\n * `--no-sandbox` on `adcp storyboard run` sets both. Issue #841.\n /\n disable_sandbox?: boolean;\n /\n Fictional-entity test-kit data loaded from `test-kits/<name>.yaml`.\n * Storyboard phases may skip based on fields here (e.g. `skip_if: \"!test_kit.auth.api_key\"`).\n /\n test_kit?: {\n auth?: {\n /* API key the runner presents on API-key probes. /\n api_key?: string;\n /* HTTP Basic credential the runner presents on Basic-auth probes. /\n basic?: {\n /* Username portion of the Basic credential. /\n username?: string;\n /* Password portion of the Basic credential. /\n password?: string;\n /* Unencoded `username:password` pair. /\n credentials?: string;\n };\n /\n Auth-required, read-only tool the runner uses for unauth + invalid-key probes.\n * Required whenever `auth` is declared — no default is substituted. Must be one of\n * the values in `PROBE_TASK_ALLOWLIST`. Kits that miss this or pick a task outside\n * the allowlist fail at `comply()` / `runStoryboard()` entry with\n * `TestKitValidationError`.\n /\n probe_task: string;\n };\n [key: string]: unknown;\n };\n /* @internal Pre-created client from comply() — avoids per-scenario MCP reconnection /\n _client?: unknown;\n /* @internal Pre-discovered profile from comply() — skips per-scenario discovery /\n _profile?: AgentProfile;\n /\n @internal Server-declared AdCP version learned during capability discovery.\n * Storyboard response validation uses this for version-skew compatibility\n * without forcing the transport client to pin a schema bundle that may not\n * ship with the installed SDK.\n /\n _serverAdcpVersion?: string;\n /* @internal Test controller capabilities from comply() — set when comply_test_controller detected /\n _controllerCapabilities?: ControllerDetection;\n /* @internal Pre-created webhook receiver, used for unit-test injection. When\n * present, the runner skips creating its own listener and does NOT close\n * the receiver after the run (caller-owned). Production callers pass\n * `webhook_receiver` instead. /\n _webhookReceiver?: WebhookReceiver;\n}\n\nexport interface TestStepResult {\n step: string;\n task?: string;\n passed: boolean;\n duration_ms: number;\n details?: string;\n error?: string;\n response_preview?: string;\n // Structured data for collectObservations() — decoupled from response_preview display\n observation_data?: Record<string, unknown>;\n // For tracking what was created (for cleanup or follow-up)\n created_id?: string;\n // Deprecation or other warnings\n warnings?: string[];\n /* True when the step was skipped (including re-graded branch-set peers). /\n skipped?: boolean;\n /* Canonical skip reason when `skipped` is true; maps to `RunnerSkipReason`. /\n skip_reason?: string;\n /\n Selection reason when a skipped-looking step was intentionally outside\n * the caller's requested run. Summary artifacts use this to keep\n * not-selected steps out of actionable skip-cause rollups.\n /\n selection_reason?: string;\n /\n Names the unmet runtime requirement when `skip_reason` is\n * `'requirement_unmet'` (per adcp-client#1626). Carries the same value\n * the storyboard authored in `Storyboard.requires`. Lets skip-cause\n * aggregators sub-group not-applicable scenarios per-requirement\n * without parsing the warning text. Absent for every other skip reason.\n /\n requirement?: string;\n}\n\nexport interface AgentProfile {\n name: string;\n tools: string[];\n channels?: string[];\n pricing_models?: string[];\n format_ids?: string[];\n delivery_types?: string[];\n // For creative agents\n supported_formats?: Array<{\n format_id: FormatID;\n name?: string;\n required_assets?: string[];\n optional_assets?: string[];\n }>;\n // For signals agents\n supported_signals?: Array<{\n signal_id: string;\n name?: string;\n type?: string;\n }>;\n // v3 capabilities\n adcp_version?: 'v2' \| 'v3';\n /\n AdCP major versions the agent declared in `get_adcp_capabilities.adcp.major_versions`.\n * Drives version-gated storyboard filtering so a v3.0 agent isn't failed against a\n * storyboard introduced in a later minor version.\n /\n adcp_major_versions?: number[];\n /\n Exact/release-precision versions from\n * `get_adcp_capabilities.adcp.supported_versions`.\n /\n adcp_supported_versions?: string[];\n /\n Seller's full AdCP build version from\n * `get_adcp_capabilities.adcp.build_version`.\n /\n adcp_build_version?: string;\n supported_protocols?: string[];\n /* Specialism claims from get_adcp_capabilities.specialisms /\n specialisms?: string[];\n supports_governance?: boolean;\n supports_si?: boolean;\n /\n Populated when the agent advertises `get_adcp_capabilities` but the call failed\n * or returned no data. Signals the compliance runner that the universal-only\n * result is due to a broken caps probe, not an agent that lacks v3 support.\n /\n capabilities_probe_error?: string;\n /\n Raw `get_adcp_capabilities` response body. Used by the storyboard runner to\n * evaluate `requires_capability` predicates (e.g. `adcp.idempotency.supported`)\n * that reference fields not extracted into the normalised profile shape above.\n /\n raw_capabilities?: unknown;\n /\n SDK version string the agent self-reported in `get_adcp_capabilities`, e.g.\n * `\"@adcp/client@5.14.0\"`. Populated opportunistically — absent for hand-rolled\n * agents that don't emit the field. Used by the storyboard runner to suffix\n * shape-drift hints when the reported version predates the recommended helper.\n /\n library_version?: string;\n}\n\nexport interface TestResult {\n agent_url: string;\n scenario: TestScenario;\n overall_passed: boolean;\n steps?: TestStepResult[];\n summary: string;\n total_duration_ms: number;\n tested_at: string;\n // Agent profile discovered during testing\n agent_profile?: AgentProfile;\n}\n\nexport interface SuiteResult {\n agent_url: string;\n agent_profile: AgentProfile;\n /* Scenarios that were run /\n scenarios_run: TestScenario[];\n /* Scenarios skipped because the agent does not advertise the required tools /\n scenarios_skipped: TestScenario[];\n results: TestResult[];\n /\n True only when at least one scenario ran and none failed.\n * False for both \"all failed\" and \"no applicable scenarios found\".\n /\n overall_passed: boolean;\n passed_count: number;\n failed_count: number;\n /* Wall-clock time including capability discovery and all scenario runs /\n total_duration_ms: number;\n tested_at: string;\n}\n\n// Generic task result from executeTask\nexport interface TaskResult {\n success: boolean;\n // eslint-disable-next-line @typescript-eslint/no-explicit-any -- response shape varies by tool; typed per-access in scenarios\n data?: any;\n error?: string;\n /* Structured AdCP error forwarded from the transport layer. Mirrors `TaskResultFailure.adcpError`. /\n adcp_error?: import('../core/ConversationTypes').AdcpErrorInfo;\n /\n Internal: which MCP extraction path produced `data`. Set by the response\n * unwrapper and the raw MCP probe so the storyboard runner can surface it\n * in its output contract. Consumers outside the runner should treat this\n * as implementation detail — it's NOT part of the public `AdCPResponse`.\n */\n _extraction_path?: 'structured_content' \| 'text_fallback' \| 'error' \| 'none';\n}\n\n// Logger interface for library use\nexport interface Logger {\n info: (context: object, message: string) => void;\n error: (context: object, message: string) => void;\n warn: (context: object, message: string) => void;\n debug: (context: object, message: string) => void;\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
1	+ {"version":3,"sources":["../../../src/lib/testing/types.ts"],"sourcesContent":["/*\n Types for AdCP Agent E2E Testing\n /\n\nimport type { FormatReferenceStructuredObject as FormatID } from '../types/core.generated';\nimport type { ControllerDetection } from './test-controller';\nimport type { WebhookReceiver } from './storyboard/webhook-receiver';\nimport type { AdcpVersion } from '../version';\nimport type { TransportOptions, VersionEnvelopeMode } from '../protocols';\n\n// Test scenarios that can be run\nexport type TestScenario =\n \| 'health_check' // Just check if agent responds\n \| 'discovery' // get_products, list_creative_formats, list_authorized_properties\n \| 'create_media_buy' // Discovery + create a test media buy\n \| 'full_sales_flow' // Full lifecycle: discovery -> create -> update -> delivery\n \| 'reporting_flow' // Dedicated: create media buy -> get_media_buy_delivery validation\n \| 'creative_sync' // Test sync_creatives flow\n \| 'creative_inline' // Test inline creatives in create_media_buy\n \| 'creative_reference' // Build -> sync -> reference a creative via creative_ids\n \| 'pricing_models' // Test different pricing models the agent supports\n \| 'creative_flow' // Creative agent: list_formats -> build -> preview\n \| 'creative_lifecycle' // Creative agent: formats -> sync multiple -> list with/without snapshot -> build/preview\n \| 'signals_flow' // Signals agent: get_signals -> activate\n // Edge case testing scenarios\n \| 'error_handling' // Test agent returns proper error responses\n \| 'validation' // Test schema validation (invalid inputs should be rejected)\n \| 'pricing_edge_cases' // Test auction vs fixed pricing, min spend, bid_price requirements\n \| 'temporal_validation' // Test date/time ordering and format validation\n // Behavioral analysis scenarios\n \| 'behavior_analysis' // Analyze agent behavior: auth requirements, brief relevance, filtering\n // Response consistency scenarios\n \| 'response_consistency' // Check for schema errors, pagination bugs, data mismatches\n // v3 Governance protocol scenarios\n \| 'governance_property_lists' // Property list CRUD operations\n \| 'governance_content_standards' // Content standards lifecycle\n \| 'property_list_filters' // Property list filter round-trip: GARM, MFA, custom_tags, feature_requirements\n // v3 Campaign governance scenarios\n \| 'campaign_governance' // Full lifecycle: sync_plans -> check -> execute -> report outcome\n \| 'campaign_governance_denied' // Denied flow: over-budget, unauthorized market\n \| 'campaign_governance_conditions' // Conditions flow: apply conditions -> re-check\n \| 'campaign_governance_delivery' // Delivery monitoring with drift detection\n \| 'seller_governance_context' // Seller persistence of governance_context\n // v3 SI (Sponsored Intelligence) protocol scenarios\n \| 'si_session_lifecycle' // Full SI session: initiate -> messages -> terminate\n \| 'si_availability' // Check SI offering availability\n \| 'si_handoff' // ACP handoff flow: initiate -> purchase intent -> terminate with handoff_transaction\n // v3 Capability discovery\n \| 'capability_discovery' // Verify get_adcp_capabilities response\n // Schema compliance\n \| 'schema_compliance' // Validate v3 channel enum, pricing field names, format assets structure\n // Audience management\n \| 'sync_audiences' // Test CRM audience sync flow\n // State machine compliance\n \| 'media_buy_lifecycle' // Pause -> resume -> cancel state transitions\n \| 'terminal_state_enforcement' // Verify agents reject updates to terminal-state media buys\n \| 'package_lifecycle' // Package-level pause/resume independent of media buy status\n // Error compliance (transport error mapping spec)\n \| 'error_codes' // Validate standard AdCP error codes in responses\n \| 'error_structure' // Validate error JSON structure against error.json schema\n \| 'error_transport' // Validate transport binding (structuredContent, text fallback)\n // Deterministic state machine scenarios (require comply_test_controller)\n \| 'deterministic_creative' // Force creative status transitions via test controller\n \| 'deterministic_media_buy' // Force media buy status transitions via test controller\n \| 'deterministic_account' // Force account status transitions + operation gates\n \| 'deterministic_session' // Force SI session timeout/termination\n \| 'deterministic_delivery' // Simulate delivery data and verify reporting\n \| 'deterministic_budget' // Simulate budget spend and verify financials\n \| 'controller_validation' // Validate the test controller itself (error codes, edge cases)\n // Brand rights protocol scenarios\n \| 'brand_identity' // Brand identity discovery (public and authorized access tiers)\n \| 'brand_rights_flow' // Brand rights: get_rights -> acquire_rights lifecycle\n \| 'creative_approval'; // Creative approval workflow for brand compliance\n\nexport interface TestOptions {\n // Protocol to use for testing (default: 'mcp')\n protocol?: 'mcp' \| 'a2a';\n /* Optional cancellation signal for discovery and storyboard helper calls. /\n signal?: AbortSignal;\n /\n Runtime-only transport configuration for discovery and every storyboard\n * or compliance tool call. In particular, `fetchFn` lets hosted runners\n * enforce a request-scoped network policy without replacing global fetch.\n /\n transport?: TransportOptions;\n /\n AdCP protocol version the test client should speak. Storyboard runners\n * set this from the compliance cache version instead of relying on the\n * installed package default.\n /\n adcpVersion?: AdcpVersion \| (string & {});\n /\n Optional wire-only AdCP version envelope override. Validation and schema\n * selection continue to use `adcpVersion`; request envelopes use this value.\n * Intended for hosted stable-line badges backed by prerelease caches.\n /\n wireAdcpVersion?: AdcpVersion \| (string & {});\n /\n Version-envelope emission mode. Defaults to `auto`; 3.0 storyboards emit\n * the legacy major marker only, while 3.1 storyboards also emit the exact\n * `adcp_version` marker. Compliance discovery may negotiate `major-only`\n * for strict pre-3.1 agents.\n /\n versionEnvelope?: VersionEnvelopeMode;\n /\n External schema bundle root used for request/response validation during\n * storyboard and compliance runs. The root is registered against\n * `adcpVersion` (or the storyboard/compliance version when omitted).\n /\n schemaRoot?: string;\n /* Custom User-Agent string sent with all outbound requests /\n userAgent?: string;\n // Brand reference for product discovery (preferred over brand_manifest)\n brand?: { domain: string; brand_id?: string };\n // Custom brief for product discovery\n brief?: string;\n // Budget for test media buy (default: 1000)\n budget?: number;\n // Specific format IDs to test\n format_ids?: string[];\n // Test session ID for isolation\n test_session_id?: string;\n // Channels to focus on (if not specified, tests all agent supports)\n channels?: string[];\n // Specific pricing models to test\n pricing_models?: string[];\n /\n Authentication for agents that require it.\n \n - `bearer`: raw token sent as `Authorization: Bearer <token>`.\n * - `basic`: cleartext `username` and `password`, encoded internally.\n * - `oauth`: saved OAuth tokens (access_token + refresh_token). MCP only.\n * The library auto-refreshes on 401. Obtain tokens interactively via\n * `adcp --save-auth <alias> --oauth`, then pass the saved blob here for\n * non-interactive reuse.\n * - `oauth_client_credentials`: RFC 6749 §4.4 machine-to-machine flow.\n * The library exchanges the secret for a fresh access token before each\n * call (cached while valid). Supply `tokens` to seed the cache; omit to\n * exchange on first call.\n /\n auth?:\n \| { type: 'bearer'; token: string }\n \| { type: 'basic'; username: string; password: string }\n \| {\n type: 'oauth';\n tokens: import('../types/adcp').AgentOAuthTokens;\n client?: import('../types/adcp').AgentOAuthClient;\n }\n \| {\n type: 'oauth_client_credentials';\n credentials: import('../types/adcp').AgentOAuthClientCredentials;\n tokens?: import('../types/adcp').AgentOAuthTokens;\n };\n /\n Extra HTTP headers applied to every outbound request to the agent.\n * Forwarded into `AgentConfig.headers`, so MCP and A2A transports both\n * see them. `Authorization` and `x-adcp-auth` are reserved — auth wins.\n \n Typical use: tenant-routing headers (`x-adcp-tenant`, `Apx-Incoming-Host`)\n * for multi-tenant agents fronted by a reverse proxy. The CLI exposes these\n * via `-H KEY=VALUE` (repeatable) and persists them in `~/.adcp/config.json`.\n /\n headers?: Record<string, string>;\n // Brand manifest for creative testing\n brand_manifest?: {\n name: string;\n url?: string;\n tagline?: string;\n logos?: Array<{\n url: string;\n orientation?: 'square' \| 'horizontal' \| 'vertical' \| 'stacked';\n background?: 'dark-bg' \| 'light-bg' \| 'transparent-bg';\n variant?: 'primary' \| 'secondary' \| 'icon' \| 'wordmark' \| 'full-lockup';\n tags?: string[];\n usage?: string;\n width?: number;\n height?: number;\n }>;\n colors?: Record<string, string>;\n tone?: {\n voice?: string;\n attributes?: string[];\n dos?: string[];\n donts?: string[];\n };\n assets?: Array<{\n asset_id: string;\n asset_type: string;\n url: string;\n width?: number;\n height?: number;\n tags?: string[];\n }>;\n };\n // For creative testing: test multiple formats programmatically\n test_all_formats?: boolean;\n // For creative testing: max formats to test when test_all_formats is true\n max_formats_to_test?: number;\n // For signals testing: specific signal types to test\n signal_types?: string[];\n // For governance testing: name for test property list\n property_list_name?: string;\n // For governance testing: specific content standards to test\n content_standards_id?: string;\n // For SI testing: specific offering ID to test\n si_offering_id?: string;\n // For SI testing: initial conversation context\n si_context?: string;\n /\n Shared explicit account id for test scenarios that need an account-scoped\n * request. Domain-specific account ids below take precedence when provided.\n /\n account_id?: string;\n /\n For media-buy testing: account ID to use with get_products,\n * create_media_buy, sync_creatives, and related media-buy flows.\n /\n media_buy_account_id?: string;\n // For audience testing: account ID to use with sync_audiences\n audience_account_id?: string;\n // When true, use sandbox mode. For implicit accounts, uses the natural key with\n // sandbox: true. For explicit accounts, discovers sandbox accounts via list_accounts.\n sandbox?: boolean;\n /\n When true, the runner injects `ext.adcp.disable_sandbox: true` on every\n * outgoing request, signaling the agent under test to bypass any internal\n * sandbox routing (env-var fallbacks, brand-domain heuristics, fixture\n * substitutes) and exercise its real adapter path. Distinct from `sandbox`\n * (which sets `account.sandbox: false` — a value, not a routing hint).\n \n Honored by adopters who explicitly read `ext.adcp.disable_sandbox`.\n * Agents that don't recognize the field ignore it (per spec, `ext` is\n * accepted-without-error). The pair (sandbox=false + disable_sandbox=true)\n * is the strongest \"production path only\" signal the runner can send;\n * `--no-sandbox` on `adcp storyboard run` sets both. Issue #841.\n /\n disable_sandbox?: boolean;\n /\n Fictional-entity test-kit data loaded from `test-kits/<name>.yaml`.\n * Storyboard phases may skip based on fields here (e.g. `skip_if: \"!test_kit.auth.api_key\"`).\n /\n test_kit?: {\n auth?: {\n /* API key the runner presents on API-key probes. /\n api_key?: string;\n /* HTTP Basic credential the runner presents on Basic-auth probes. /\n basic?: {\n /* Username portion of the Basic credential. /\n username?: string;\n /* Password portion of the Basic credential. /\n password?: string;\n /* Unencoded `username:password` pair. /\n credentials?: string;\n };\n /\n Auth-required, read-only tool the runner uses for unauth + invalid-key probes.\n * Required whenever `auth` is declared — no default is substituted. Must be one of\n * the values in `PROBE_TASK_ALLOWLIST`. Kits that miss this or pick a task outside\n * the allowlist fail at `comply()` / `runStoryboard()` entry with\n * `TestKitValidationError`.\n /\n probe_task: string;\n };\n [key: string]: unknown;\n };\n /* @internal Pre-created client from comply() — avoids per-scenario MCP reconnection /\n _client?: unknown;\n /* @internal Pre-discovered profile from comply() — skips per-scenario discovery /\n _profile?: AgentProfile;\n /\n @internal Server-declared AdCP version learned during capability discovery.\n * Storyboard response validation uses this for version-skew compatibility\n * without forcing the transport client to pin a schema bundle that may not\n * ship with the installed SDK.\n /\n _serverAdcpVersion?: string;\n /* @internal Test controller capabilities from comply() — set when comply_test_controller detected /\n _controllerCapabilities?: ControllerDetection;\n /* @internal Pre-created webhook receiver, used for unit-test injection. When\n * present, the runner skips creating its own listener and does NOT close\n * the receiver after the run (caller-owned). Production callers pass\n * `webhook_receiver` instead. /\n _webhookReceiver?: WebhookReceiver;\n}\n\nexport interface TestStepResult {\n step: string;\n task?: string;\n passed: boolean;\n duration_ms: number;\n details?: string;\n error?: string;\n response_preview?: string;\n // Structured data for collectObservations() — decoupled from response_preview display\n observation_data?: Record<string, unknown>;\n // For tracking what was created (for cleanup or follow-up)\n created_id?: string;\n // Deprecation or other warnings\n warnings?: string[];\n /* True when the step was skipped (including re-graded branch-set peers). /\n skipped?: boolean;\n /* Canonical skip reason when `skipped` is true; maps to `RunnerSkipReason`. /\n skip_reason?: string;\n /\n Selection reason when a skipped-looking step was intentionally outside\n * the caller's requested run. Summary artifacts use this to keep\n * not-selected steps out of actionable skip-cause rollups.\n /\n selection_reason?: string;\n /\n Names the unmet runtime requirement when `skip_reason` is\n * `'requirement_unmet'` (per adcp-client#1626). Carries the same value\n * the storyboard authored in `Storyboard.requires`. Lets skip-cause\n * aggregators sub-group not-applicable scenarios per-requirement\n * without parsing the warning text. Absent for every other skip reason.\n /\n requirement?: string;\n}\n\nexport interface AgentProfile {\n name: string;\n tools: string[];\n channels?: string[];\n pricing_models?: string[];\n format_ids?: string[];\n delivery_types?: string[];\n // For creative agents\n supported_formats?: Array<{\n format_id: FormatID;\n name?: string;\n required_assets?: string[];\n optional_assets?: string[];\n }>;\n // For signals agents\n supported_signals?: Array<{\n signal_id: string;\n name?: string;\n type?: string;\n }>;\n // v3 capabilities\n adcp_version?: 'v2' \| 'v3';\n /\n AdCP major versions the agent declared in `get_adcp_capabilities.adcp.major_versions`.\n * Drives version-gated storyboard filtering so a v3.0 agent isn't failed against a\n * storyboard introduced in a later minor version.\n /\n adcp_major_versions?: number[];\n /\n Exact/release-precision versions from\n * `get_adcp_capabilities.adcp.supported_versions`.\n /\n adcp_supported_versions?: string[];\n /\n Seller's full AdCP build version from\n * `get_adcp_capabilities.adcp.build_version`.\n /\n adcp_build_version?: string;\n supported_protocols?: string[];\n /* Specialism claims from get_adcp_capabilities.specialisms /\n specialisms?: string[];\n supports_governance?: boolean;\n supports_si?: boolean;\n /\n Populated when the agent advertises `get_adcp_capabilities` but the call failed\n * or returned no data. Signals the compliance runner that the universal-only\n * result is due to a broken caps probe, not an agent that lacks v3 support.\n /\n capabilities_probe_error?: string;\n /\n Raw `get_adcp_capabilities` response body. Used by the storyboard runner to\n * evaluate `requires_capability` predicates (e.g. `adcp.idempotency.supported`)\n * that reference fields not extracted into the normalised profile shape above.\n /\n raw_capabilities?: unknown;\n /\n SDK version string the agent self-reported in `get_adcp_capabilities`, e.g.\n * `\"@adcp/client@5.14.0\"`. Populated opportunistically — absent for hand-rolled\n * agents that don't emit the field. Used by the storyboard runner to suffix\n * shape-drift hints when the reported version predates the recommended helper.\n /\n library_version?: string;\n}\n\nexport interface TestResult {\n agent_url: string;\n scenario: TestScenario;\n overall_passed: boolean;\n steps?: TestStepResult[];\n summary: string;\n total_duration_ms: number;\n tested_at: string;\n // Agent profile discovered during testing\n agent_profile?: AgentProfile;\n}\n\nexport interface SuiteResult {\n agent_url: string;\n agent_profile: AgentProfile;\n /* Scenarios that were run /\n scenarios_run: TestScenario[];\n /* Scenarios skipped because the agent does not advertise the required tools /\n scenarios_skipped: TestScenario[];\n results: TestResult[];\n /\n True only when at least one scenario ran and none failed.\n * False for both \"all failed\" and \"no applicable scenarios found\".\n /\n overall_passed: boolean;\n passed_count: number;\n failed_count: number;\n /* Wall-clock time including capability discovery and all scenario runs /\n total_duration_ms: number;\n tested_at: string;\n}\n\n// Generic task result from executeTask\nexport interface TaskResult {\n success: boolean;\n // eslint-disable-next-line @typescript-eslint/no-explicit-any -- response shape varies by tool; typed per-access in scenarios\n data?: any;\n error?: string;\n /* Structured AdCP error forwarded from the transport layer. Mirrors `TaskResultFailure.adcpError`. /\n adcp_error?: import('../core/ConversationTypes').AdcpErrorInfo;\n /\n Internal: which MCP extraction path produced `data`. Set by the response\n * unwrapper and the raw MCP probe so the storyboard runner can surface it\n * in its output contract. Consumers outside the runner should treat this\n * as implementation detail — it's NOT part of the public `AdCPResponse`.\n */\n _extraction_path?: 'structured_content' \| 'text_fallback' \| 'error' \| 'none';\n}\n\n// Logger interface for library use\nexport interface Logger {\n info: (context: object, message: string) => void;\n error: (context: object, message: string) => void;\n warn: (context: object, message: string) => void;\n debug: (context: object, message: string) => void;\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/lib/types/comply-test-controller.d.ts CHANGED Viewed

@@ -1891,7 +1891,55 @@ export interface CancellationPolicy {
         /**
          * Fee calculation method. 'percent_remaining': percentage of remaining uncommitted spend. 'full_commitment': buyer owes the full committed budget regardless of delivery. 'fixed_fee': flat monetary amount. 'none': no financial fee (cancellation with notice is free).
          */
-        type: 'percent_remaining' | 'full_commitment' | 'fixed_fee' | 'none';
+        type: 'percent_remaining';
+        /**
+         * Fee rate as a decimal proportion of remaining committed spend. Required when type is 'percent_remaining' (e.g., 0.5 means 50% of remaining spend).
+         * @minimum 0
+         * @maximum 1
+         */
+        rate: number;
+        /**
+         * Fixed fee amount in the buy's currency. Required when type is 'fixed_fee'.
+         * @minimum 0
+         */
+        amount?: number;
+    } | {
+        /**
+         * Fee calculation method. 'percent_remaining': percentage of remaining uncommitted spend. 'full_commitment': buyer owes the full committed budget regardless of delivery. 'fixed_fee': flat monetary amount. 'none': no financial fee (cancellation with notice is free).
+         */
+        type: 'full_commitment';
+        /**
+         * Fee rate as a decimal proportion of remaining committed spend. Required when type is 'percent_remaining' (e.g., 0.5 means 50% of remaining spend).
+         * @minimum 0
+         * @maximum 1
+         */
+        rate?: number;
+        /**
+         * Fixed fee amount in the buy's currency. Required when type is 'fixed_fee'.
+         * @minimum 0
+         */
+        amount?: number;
+    } | {
+        /**
+         * Fee calculation method. 'percent_remaining': percentage of remaining uncommitted spend. 'full_commitment': buyer owes the full committed budget regardless of delivery. 'fixed_fee': flat monetary amount. 'none': no financial fee (cancellation with notice is free).
+         */
+        type: 'fixed_fee';
+        /**
+         * Fee rate as a decimal proportion of remaining committed spend. Required when type is 'percent_remaining' (e.g., 0.5 means 50% of remaining spend).
+         * @minimum 0
+         * @maximum 1
+         */
+        rate?: number;
+        /**
+         * Fixed fee amount in the buy's currency. Required when type is 'fixed_fee'.
+         * @minimum 0
+         */
+        amount: number;
+    } | {
+        /**
+         * Fee calculation method. 'percent_remaining': percentage of remaining uncommitted spend. 'full_commitment': buyer owes the full committed budget regardless of delivery. 'fixed_fee': flat monetary amount. 'none': no financial fee (cancellation with notice is free).
+         */
+        type: 'none';
         /**
          * Fee rate as a decimal proportion of remaining committed spend. Required when type is 'percent_remaining' (e.g., 0.5 means 50% of remaining spend).
          * @minimum 0

package/dist/lib/types/core.generated.d.mts CHANGED Viewed

@@ -6598,7 +6598,55 @@ export interface CancellationPolicy {
         /**
          * Fee calculation method. 'percent_remaining': percentage of remaining uncommitted spend. 'full_commitment': buyer owes the full committed budget regardless of delivery. 'fixed_fee': flat monetary amount. 'none': no financial fee (cancellation with notice is free).
          */
-        type: 'percent_remaining' | 'full_commitment' | 'fixed_fee' | 'none';
+        type: 'percent_remaining';
+        /**
+         * Fee rate as a decimal proportion of remaining committed spend. Required when type is 'percent_remaining' (e.g., 0.5 means 50% of remaining spend).
+         * @minimum 0
+         * @maximum 1
+         */
+        rate: number;
+        /**
+         * Fixed fee amount in the buy's currency. Required when type is 'fixed_fee'.
+         * @minimum 0
+         */
+        amount?: number;
+    } | {
+        /**
+         * Fee calculation method. 'percent_remaining': percentage of remaining uncommitted spend. 'full_commitment': buyer owes the full committed budget regardless of delivery. 'fixed_fee': flat monetary amount. 'none': no financial fee (cancellation with notice is free).
+         */
+        type: 'full_commitment';
+        /**
+         * Fee rate as a decimal proportion of remaining committed spend. Required when type is 'percent_remaining' (e.g., 0.5 means 50% of remaining spend).
+         * @minimum 0
+         * @maximum 1
+         */
+        rate?: number;
+        /**
+         * Fixed fee amount in the buy's currency. Required when type is 'fixed_fee'.
+         * @minimum 0
+         */
+        amount?: number;
+    } | {
+        /**
+         * Fee calculation method. 'percent_remaining': percentage of remaining uncommitted spend. 'full_commitment': buyer owes the full committed budget regardless of delivery. 'fixed_fee': flat monetary amount. 'none': no financial fee (cancellation with notice is free).
+         */
+        type: 'fixed_fee';
+        /**
+         * Fee rate as a decimal proportion of remaining committed spend. Required when type is 'percent_remaining' (e.g., 0.5 means 50% of remaining spend).
+         * @minimum 0
+         * @maximum 1
+         */
+        rate?: number;
+        /**
+         * Fixed fee amount in the buy's currency. Required when type is 'fixed_fee'.
+         * @minimum 0
+         */
+        amount: number;
+    } | {
+        /**
+         * Fee calculation method. 'percent_remaining': percentage of remaining uncommitted spend. 'full_commitment': buyer owes the full committed budget regardless of delivery. 'fixed_fee': flat monetary amount. 'none': no financial fee (cancellation with notice is free).
+         */
+        type: 'none';
         /**
          * Fee rate as a decimal proportion of remaining committed spend. Required when type is 'percent_remaining' (e.g., 0.5 means 50% of remaining spend).
          * @minimum 0
@@ -16959,7 +17007,7 @@ export interface SyncCreativesRequest {
      */
     delete_missing?: boolean;
     /**
-     * When true, preview changes without applying them. Returns what would be created/updated/deleted.
+     * When true, rehearse this sync_creatives operation without applying it. Validates the actual trafficking request in the seller's current context, including library upsert semantics, creative IDs, assignments, account-scoped gates, and seller policies, then returns what would be created/updated/deleted. This is distinct from validate_input, which only validates manifest structure against canonical/product format targets.
      */
     dry_run?: boolean;
     validation_mode?: ValidationMode;
@@ -16968,7 +17016,7 @@ export interface SyncCreativesRequest {
     ext?: ExtensionObject;
 }
 /**
- * Request payload for the validate_input task. Lets buyers dry-run a creative manifest against canonical formats and/or specific products before committing to a render. Cheaper than preview_creative (no synthesis cost). Used by build_creative internally to validate inputs before producing output. For genuinely nondeterministic generative platforms (Veo/Sora/Runway-class) where predictive validation is impossible, the platform's own post-synthesis QA loop applies — validate_input is the predictable-case primitive.
+ * Request payload for the validate_input task. Lets buyers preflight a creative manifest against canonical formats and/or specific products before committing to a render or other expensive creative-production step. It validates manifest structure and target format constraints only: slot counts, asset types, parameter ranges, and format-shape constraints. It does not rehearse a seller's library mutation, creative_id upsert semantics, package assignments, account authorization, active-delivery protections, or other trafficking-time gates. When the question is final seller acceptance for a creative that is ready to traffic, call sync_creatives directly; use dry_run: true for a non-mutating rehearsal of that operation. Used by build_creative internally to validate inputs before producing output. For genuinely nondeterministic generative platforms (Veo/Sora/Runway-class) where predictive validation is impossible, the platform's own post-synthesis QA loop applies — validate_input is the predictable-case primitive.
  *
  * The `targets[]` array is a discriminated list of validation targets, mirroring the response shape on `validate-input-result.json#target`. Each entry has a `kind` (canonical | product | third_party_format) plus a kind-specific identifier. Discriminated-by-kind on both sides eliminates a wire-shape mismatch: a previous draft used `format_ids: string[]` for canonical names alongside `product_ids: string[]`, which collided with `Product.format_ids: FormatId[]` ({agent_url, id}) — codegen would emit the same field name with two different types. Discriminated `targets[]` makes the intent explicit and codegen-clean.
  */
@@ -17003,7 +17051,7 @@ export interface ThirdPartyFormatTarget {
     id: string;
 }
 /**
- * Response payload for the validate_input task. Returns per-target validation results — one entry per format_id or product_id requested. Each result carries a `result_kind` discriminator (`validated_pass` / `validated_fail` / `unvalidatable_nondeterministic`) so callers can branch on three meaningfully different outcomes. The `predicted` field on violations carries the platform's pre-flight estimate (e.g., predicted audio duration from text-length analysis), NOT the actual output — there is no protocol state for orphaned out-of-spec artifacts. For nondeterministic generative platforms (Veo / Sora / Runway-class with `synthesis_nondeterministic: true`), the result_kind is `unvalidatable_nondeterministic` — predictive validation is impossible, the platform's post-synthesis QA loop applies on `build_creative`, and out-of-spec output never reaches this surface (instead `build_creative` returns task_failed with synthesis_failed reason).
+ * Response payload for the validate_input task. Returns per-target manifest validation results — one entry per canonical, product, or third-party target requested. Each result carries a `result_kind` discriminator (`validated_pass` / `validated_fail` / `unvalidatable_nondeterministic`) so callers can branch on three meaningfully different outcomes. A pass means the manifest is structurally valid for that target; it does not mean a later sync_creatives call will be accepted, because trafficking-time gates such as account authorization, creative_id upsert state, package assignments, active-delivery protections, and seller review policy are outside validate_input's scope. The `predicted` field on violations carries the platform's pre-flight estimate (e.g., predicted audio duration from text-length analysis), NOT the actual output — there is no protocol state for orphaned out-of-spec artifacts. For nondeterministic generative platforms (Veo / Sora / Runway-class with `synthesis_nondeterministic: true`), the result_kind is `unvalidatable_nondeterministic` — predictive validation is impossible, the platform's post-synthesis QA loop applies on `build_creative`, and out-of-spec output never reaches this surface (instead `build_creative` returns task_failed with synthesis_failed reason).
  *
  * The `ValidateInputResult` type is split into its own schema (`/schemas/creative/validate-input-result.json`) rather than inlined here because the same per-target shape is intended for reuse by adjacent async-validation surfaces (planned: per-batch result envelopes on `build_creative` async paths, and asynchronous canonical-against-product validation in `sync_creatives`). Producers that only need the synchronous batch shape today MAY treat the split as YAGNI, but the schema reuse anchors the violation/retry shape so downstream surfaces don't drift.
  */
@@ -17027,7 +17075,7 @@ export type ValidateInputResponse = ProtocolEnvelope & {
 /**
  * Per-target result of a validate_input call. The `result_kind` discriminator (replacing the earlier boolean `ok`) lets buyers distinguish three meaningfully different outcomes:
  *
- * - `validated_pass` — manifest validates cleanly against the target. Buyers can submit with confidence.
+ * - `validated_pass` — manifest is structurally valid against the target. This is not seller trafficking acceptance; use `sync_creatives` or `sync_creatives` with `dry_run: true` for upload/update, account, assignment, policy, and lifecycle gates.
  * - `validated_fail` — manifest is structurally evaluable AND fails specific constraints. `violations[]` enumerates which. Buyers fix and retry.
  * - `unvalidatable_nondeterministic` — predictive validation is impossible because the target's production pipeline is genuinely nondeterministic (Veo / Sora / Runway-class formats with `synthesis_nondeterministic: true`). The platform's own post-synthesis QA loop applies; outcome is unknowable until `build_creative` runs. Buyers MUST plan for the QA-loop semantics: submission may return `task_failed` with a `synthesis_failed` reason if the QA loop exhausts. There is no protocol state for orphaned out-of-spec artifacts.
  *
@@ -21995,7 +22043,7 @@ export interface IdempotencySupported {
      */
     replay_ttl_seconds: number;
     /**
-     * Maximum lifetime in seconds of an in-flight idempotency row before the seller releases it per L1/security.mdx rule 9 (treat the in-flight attempt as failed if the handler does not complete within this bound). Buyer SDKs use this value to compute a retry budget when they see `IDEMPOTENCY_IN_FLIGHT` — cap individual retry waits at this value rather than the much-wider `replay_ttl_seconds` ceiling. Optional in 3.1 (additive declaration); SDKs that don't see the field fall back to rule 9's order-of-magnitude SHOULD heuristic. Required when `supported: true` in 4.0. MUST be no greater than `replay_ttl_seconds` (a bound larger than the replay window is vacuous — any retry past the TTL hits IDEMPOTENCY_EXPIRED regardless of in-flight state); validators MUST enforce this cross-field constraint at the test layer since JSON Schema cannot express field-relative bounds. A buyer that observes `error.details.retry_after` exceeding this value MAY treat that as a seller bug — the in-flight row cannot legitimately outlive the bound the seller declared.
+     * Maximum lifetime in seconds of an in-flight idempotency row before the seller releases it per L1/security.mdx rule 9 (treat the in-flight attempt as failed if the handler does not complete within this bound). Buyer SDKs use this value to compute a retry budget when they see `IDEMPOTENCY_IN_FLIGHT` — cap individual retry waits at this value rather than the much-wider `replay_ttl_seconds` ceiling. Optional in 3.1 (additive declaration); SDKs that don't see the field fall back to rule 9's order-of-magnitude SHOULD heuristic. Required when `supported: true` in 4.0. MUST be no greater than `replay_ttl_seconds` (a bound larger than the replay window is vacuous — any retry past the TTL hits IDEMPOTENCY_EXPIRED regardless of in-flight state); validators MUST enforce this cross-field constraint at the test layer since JSON Schema cannot express field-relative bounds. A buyer that observes top-level `error.retry_after` exceeding this value MAY treat that as a seller bug — the in-flight row cannot legitimately outlive the bound the seller declared.
      * @minimum 1
      * @maximum 604800
      */

package/dist/lib/types/core.generated.d.ts CHANGED Viewed

@@ -6598,7 +6598,55 @@ export interface CancellationPolicy {
         /**
          * Fee calculation method. 'percent_remaining': percentage of remaining uncommitted spend. 'full_commitment': buyer owes the full committed budget regardless of delivery. 'fixed_fee': flat monetary amount. 'none': no financial fee (cancellation with notice is free).
          */
-        type: 'percent_remaining' | 'full_commitment' | 'fixed_fee' | 'none';
+        type: 'percent_remaining';
+        /**
+         * Fee rate as a decimal proportion of remaining committed spend. Required when type is 'percent_remaining' (e.g., 0.5 means 50% of remaining spend).
+         * @minimum 0
+         * @maximum 1
+         */
+        rate: number;
+        /**
+         * Fixed fee amount in the buy's currency. Required when type is 'fixed_fee'.
+         * @minimum 0
+         */
+        amount?: number;
+    } | {
+        /**
+         * Fee calculation method. 'percent_remaining': percentage of remaining uncommitted spend. 'full_commitment': buyer owes the full committed budget regardless of delivery. 'fixed_fee': flat monetary amount. 'none': no financial fee (cancellation with notice is free).
+         */
+        type: 'full_commitment';
+        /**
+         * Fee rate as a decimal proportion of remaining committed spend. Required when type is 'percent_remaining' (e.g., 0.5 means 50% of remaining spend).
+         * @minimum 0
+         * @maximum 1
+         */
+        rate?: number;
+        /**
+         * Fixed fee amount in the buy's currency. Required when type is 'fixed_fee'.
+         * @minimum 0
+         */
+        amount?: number;
+    } | {
+        /**
+         * Fee calculation method. 'percent_remaining': percentage of remaining uncommitted spend. 'full_commitment': buyer owes the full committed budget regardless of delivery. 'fixed_fee': flat monetary amount. 'none': no financial fee (cancellation with notice is free).
+         */
+        type: 'fixed_fee';
+        /**
+         * Fee rate as a decimal proportion of remaining committed spend. Required when type is 'percent_remaining' (e.g., 0.5 means 50% of remaining spend).
+         * @minimum 0
+         * @maximum 1
+         */
+        rate?: number;
+        /**
+         * Fixed fee amount in the buy's currency. Required when type is 'fixed_fee'.
+         * @minimum 0
+         */
+        amount: number;
+    } | {
+        /**
+         * Fee calculation method. 'percent_remaining': percentage of remaining uncommitted spend. 'full_commitment': buyer owes the full committed budget regardless of delivery. 'fixed_fee': flat monetary amount. 'none': no financial fee (cancellation with notice is free).
+         */
+        type: 'none';
         /**
          * Fee rate as a decimal proportion of remaining committed spend. Required when type is 'percent_remaining' (e.g., 0.5 means 50% of remaining spend).
          * @minimum 0
@@ -16959,7 +17007,7 @@ export interface SyncCreativesRequest {
      */
     delete_missing?: boolean;
     /**
-     * When true, preview changes without applying them. Returns what would be created/updated/deleted.
+     * When true, rehearse this sync_creatives operation without applying it. Validates the actual trafficking request in the seller's current context, including library upsert semantics, creative IDs, assignments, account-scoped gates, and seller policies, then returns what would be created/updated/deleted. This is distinct from validate_input, which only validates manifest structure against canonical/product format targets.
      */
     dry_run?: boolean;
     validation_mode?: ValidationMode;
@@ -16968,7 +17016,7 @@ export interface SyncCreativesRequest {
     ext?: ExtensionObject;
 }
 /**
- * Request payload for the validate_input task. Lets buyers dry-run a creative manifest against canonical formats and/or specific products before committing to a render. Cheaper than preview_creative (no synthesis cost). Used by build_creative internally to validate inputs before producing output. For genuinely nondeterministic generative platforms (Veo/Sora/Runway-class) where predictive validation is impossible, the platform's own post-synthesis QA loop applies — validate_input is the predictable-case primitive.
+ * Request payload for the validate_input task. Lets buyers preflight a creative manifest against canonical formats and/or specific products before committing to a render or other expensive creative-production step. It validates manifest structure and target format constraints only: slot counts, asset types, parameter ranges, and format-shape constraints. It does not rehearse a seller's library mutation, creative_id upsert semantics, package assignments, account authorization, active-delivery protections, or other trafficking-time gates. When the question is final seller acceptance for a creative that is ready to traffic, call sync_creatives directly; use dry_run: true for a non-mutating rehearsal of that operation. Used by build_creative internally to validate inputs before producing output. For genuinely nondeterministic generative platforms (Veo/Sora/Runway-class) where predictive validation is impossible, the platform's own post-synthesis QA loop applies — validate_input is the predictable-case primitive.
  *
  * The `targets[]` array is a discriminated list of validation targets, mirroring the response shape on `validate-input-result.json#target`. Each entry has a `kind` (canonical | product | third_party_format) plus a kind-specific identifier. Discriminated-by-kind on both sides eliminates a wire-shape mismatch: a previous draft used `format_ids: string[]` for canonical names alongside `product_ids: string[]`, which collided with `Product.format_ids: FormatId[]` ({agent_url, id}) — codegen would emit the same field name with two different types. Discriminated `targets[]` makes the intent explicit and codegen-clean.
  */
@@ -17003,7 +17051,7 @@ export interface ThirdPartyFormatTarget {
     id: string;
 }
 /**
- * Response payload for the validate_input task. Returns per-target validation results — one entry per format_id or product_id requested. Each result carries a `result_kind` discriminator (`validated_pass` / `validated_fail` / `unvalidatable_nondeterministic`) so callers can branch on three meaningfully different outcomes. The `predicted` field on violations carries the platform's pre-flight estimate (e.g., predicted audio duration from text-length analysis), NOT the actual output — there is no protocol state for orphaned out-of-spec artifacts. For nondeterministic generative platforms (Veo / Sora / Runway-class with `synthesis_nondeterministic: true`), the result_kind is `unvalidatable_nondeterministic` — predictive validation is impossible, the platform's post-synthesis QA loop applies on `build_creative`, and out-of-spec output never reaches this surface (instead `build_creative` returns task_failed with synthesis_failed reason).
+ * Response payload for the validate_input task. Returns per-target manifest validation results — one entry per canonical, product, or third-party target requested. Each result carries a `result_kind` discriminator (`validated_pass` / `validated_fail` / `unvalidatable_nondeterministic`) so callers can branch on three meaningfully different outcomes. A pass means the manifest is structurally valid for that target; it does not mean a later sync_creatives call will be accepted, because trafficking-time gates such as account authorization, creative_id upsert state, package assignments, active-delivery protections, and seller review policy are outside validate_input's scope. The `predicted` field on violations carries the platform's pre-flight estimate (e.g., predicted audio duration from text-length analysis), NOT the actual output — there is no protocol state for orphaned out-of-spec artifacts. For nondeterministic generative platforms (Veo / Sora / Runway-class with `synthesis_nondeterministic: true`), the result_kind is `unvalidatable_nondeterministic` — predictive validation is impossible, the platform's post-synthesis QA loop applies on `build_creative`, and out-of-spec output never reaches this surface (instead `build_creative` returns task_failed with synthesis_failed reason).
  *
  * The `ValidateInputResult` type is split into its own schema (`/schemas/creative/validate-input-result.json`) rather than inlined here because the same per-target shape is intended for reuse by adjacent async-validation surfaces (planned: per-batch result envelopes on `build_creative` async paths, and asynchronous canonical-against-product validation in `sync_creatives`). Producers that only need the synchronous batch shape today MAY treat the split as YAGNI, but the schema reuse anchors the violation/retry shape so downstream surfaces don't drift.
  */
@@ -17027,7 +17075,7 @@ export type ValidateInputResponse = ProtocolEnvelope & {
 /**
  * Per-target result of a validate_input call. The `result_kind` discriminator (replacing the earlier boolean `ok`) lets buyers distinguish three meaningfully different outcomes:
  *
- * - `validated_pass` — manifest validates cleanly against the target. Buyers can submit with confidence.
+ * - `validated_pass` — manifest is structurally valid against the target. This is not seller trafficking acceptance; use `sync_creatives` or `sync_creatives` with `dry_run: true` for upload/update, account, assignment, policy, and lifecycle gates.
  * - `validated_fail` — manifest is structurally evaluable AND fails specific constraints. `violations[]` enumerates which. Buyers fix and retry.
  * - `unvalidatable_nondeterministic` — predictive validation is impossible because the target's production pipeline is genuinely nondeterministic (Veo / Sora / Runway-class formats with `synthesis_nondeterministic: true`). The platform's own post-synthesis QA loop applies; outcome is unknowable until `build_creative` runs. Buyers MUST plan for the QA-loop semantics: submission may return `task_failed` with a `synthesis_failed` reason if the QA loop exhausts. There is no protocol state for orphaned out-of-spec artifacts.
  *
@@ -21995,7 +22043,7 @@ export interface IdempotencySupported {
      */
     replay_ttl_seconds: number;
     /**
-     * Maximum lifetime in seconds of an in-flight idempotency row before the seller releases it per L1/security.mdx rule 9 (treat the in-flight attempt as failed if the handler does not complete within this bound). Buyer SDKs use this value to compute a retry budget when they see `IDEMPOTENCY_IN_FLIGHT` — cap individual retry waits at this value rather than the much-wider `replay_ttl_seconds` ceiling. Optional in 3.1 (additive declaration); SDKs that don't see the field fall back to rule 9's order-of-magnitude SHOULD heuristic. Required when `supported: true` in 4.0. MUST be no greater than `replay_ttl_seconds` (a bound larger than the replay window is vacuous — any retry past the TTL hits IDEMPOTENCY_EXPIRED regardless of in-flight state); validators MUST enforce this cross-field constraint at the test layer since JSON Schema cannot express field-relative bounds. A buyer that observes `error.details.retry_after` exceeding this value MAY treat that as a seller bug — the in-flight row cannot legitimately outlive the bound the seller declared.
+     * Maximum lifetime in seconds of an in-flight idempotency row before the seller releases it per L1/security.mdx rule 9 (treat the in-flight attempt as failed if the handler does not complete within this bound). Buyer SDKs use this value to compute a retry budget when they see `IDEMPOTENCY_IN_FLIGHT` — cap individual retry waits at this value rather than the much-wider `replay_ttl_seconds` ceiling. Optional in 3.1 (additive declaration); SDKs that don't see the field fall back to rule 9's order-of-magnitude SHOULD heuristic. Required when `supported: true` in 4.0. MUST be no greater than `replay_ttl_seconds` (a bound larger than the replay window is vacuous — any retry past the TTL hits IDEMPOTENCY_EXPIRED regardless of in-flight state); validators MUST enforce this cross-field constraint at the test layer since JSON Schema cannot express field-relative bounds. A buyer that observes top-level `error.retry_after` exceeding this value MAY treat that as a seller bug — the in-flight row cannot legitimately outlive the bound the seller declared.
      * @minimum 1
      * @maximum 604800
      */