@adcp/sdk 13.0.0-rc.6 → 13.0.0-rc.7

package/dist/lib/registry/types.generated.d.ts

@@ -400,7 +400,7 @@ export interface paths {
         };
         /**
          * List agents
-         * @description List all agents in the registry. Optionally enrich with health checks, capabilities, and property summaries via query parameters. Measurement-vendor filters (`metric_id`, `accreditation`, `q`) imply `type=measurement` when `type` is unset; an explicit `type` other than `measurement` returns 400.
+         * @description List all agents in the registry. Optionally enrich with health checks, capabilities, and property summaries via query parameters. Measurement-vendor filters (`metric_id`, `accreditation`, `q`) imply `type=measurement`. Canonical creative-capability filters (`format_kind`, `publisher_domain`, `format_option_id`, `capability_id`, `creative_operation`) match any endpoint exposing that creative surface, including mixed sales/creative agents; add an explicit `type` only to narrow by primary registry classification.
          */
         get: operations["listAgents"];
         put?: never;
@@ -946,8 +946,8 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get agent formats
-         * @description Fetch creative formats from a creative agent.
+         * Get creative-agent format capabilities
+         * @description Fetch get_adcp_capabilities creative.supported_formats[] from a creative agent.
          */
         get: operations["getAgentFormats"];
         put?: never;
@@ -1109,7 +1109,7 @@ export interface paths {
         };
         /**
          * Registry change feed
-         * @description Poll a cursor-based feed of registry changes. Events are ordered by UUID v7 event_id for monotonic cursor progression. The feed retains events for 90 days. The `freshness` object reports when the response was generated, the newest matching event currently visible to the feed, and the resulting feed lag.
+         * @description Poll a cursor-based feed of registry changes. Events are ordered by UUID v7 event_id for monotonic cursor progression. The feed retains events for 90 days. The `freshness` object reports when the response was generated, the newest matching event currently visible to the feed, and the resulting feed lag. `publisher.adagents_changed` covers semantic changes in every top-level catalog field, including formats-only and placements-only revisions; new 3.2 events identify them in `payload.changed_fields`.
          *
          *     Type filtering supports glob patterns: `property.*` matches `property.created`, `property.updated`, etc.
          */
@@ -2418,10 +2418,27 @@ export interface components {
                 can_list_properties: boolean;
             };
             creative_capabilities?: {
-                formats_supported: string[];
+                supported_formats: ({
+                    capability_id?: string;
+                    format: {
+                        format_kind: string;
+                        publisher_domain?: string;
+                        format_option_id?: string;
+                        params?: {
+                            [key: string]: unknown;
+                        };
+                    } & {
+                        [key: string]: unknown;
+                    };
+                    operations: ("build" | "validate" | "preview")[];
+                } & {
+                    [key: string]: unknown;
+                })[];
                 can_generate: boolean;
                 can_validate: boolean;
                 can_preview: boolean;
+            } & {
+                [key: string]: unknown;
             };
             signals_capabilities?: {
                 audience_types: string[];
@@ -2666,7 +2683,7 @@ export interface components {
                 /** @description Industry labels from brand.json when present. */
                 industries?: string[];
             };
-            /** @description Display-oriented summary of top-level adagents.json `formats[]`, normalized for publisher pages and agent discovery clients. Each entry preserves `format_kind`, `format_option_id`, and canonical params. */
+            /** @description Lossy display-oriented summary of top-level adagents.json `formats[]`, normalized for publisher pages and eligibility discovery. It preserves `format_kind`, `format_option_id`, params, property scope, preference, and experimental status, but omits `v1_format_ref`, `canonical_formats_only`, `applies_to_channels`, `publisher_domain`, and custom `format_shape`/`format_schema`. Fetch the canonical document at hosting.resolved_url (or hosting.expected_url when self-hosted) for creative validation. */
             formats?: {
                 /** @description Stable format option identifier from adagents.json `formats[]`. */
                 format_option_id?: string;
@@ -2689,6 +2706,32 @@ export interface components {
                 /** @description Whether this seller's format declaration is marked experimental. */
                 experimental?: boolean;
             }[];
+            /** @description Eligibility-oriented publisher placement summaries. Present only when the request includes `include=placements`; format references are resolved to canonical kind/params so callers can join property → placement → format without a second origin fetch. */
+            placements?: {
+                placement_id: string;
+                name: string;
+                description?: string;
+                property_ids?: string[];
+                property_tags?: string[];
+                collection_ids?: string[];
+                channels?: string[];
+                tags?: string[];
+                /** @description Placement format references resolved against the same response's top-level formats plus any inline canonical declarations. */
+                format_options?: {
+                    format_option_id?: string;
+                    /** @description Resolved canonical format kind accepted by this placement. */
+                    format_kind: string;
+                    /** @description Resolved canonical narrowing for this placement format. */
+                    params?: {
+                        [key: string]: unknown;
+                    };
+                }[];
+                /**
+                 * @description Publisher-origin placements are adagents_json; moderator-maintained catalog placements are community.
+                 * @enum {string}
+                 */
+                source: "adagents_json" | "community";
+            }[];
             authorized_agents: {
                 url: string;
                 authorized_for?: string;
@@ -3578,7 +3621,9 @@ export interface components {
             category_taxonomy?: string | null;
             tags?: string[];
             delivery_types?: string[];
+            /** @description Deprecated 3.x named-format profile projection. */
             format_ids?: string[];
+            format_kinds?: string[];
             property_count?: number;
             publisher_count?: number;
             has_tmp?: boolean;
@@ -3741,6 +3786,12 @@ export interface components {
             agent_count?: number;
             property_count?: number;
             collection_count?: number;
+            /** @description Number of top-level formats[] declarations after the revision. */
+            format_count?: number;
+            /** @description Number of top-level placements[] declarations after the revision. */
+            placement_count?: number;
+            /** @description Semantic top-level adagents.json fields changed by this revision, including formats or placements. Present on newly emitted 3.2 change events. */
+            changed_fields?: string[];
             discovery_method?: string;
             manager_domain?: string | null;
             source?: string;
@@ -5314,6 +5365,16 @@ export interface operations {
                 accreditation?: string | string[];
                 /** @description Measurement-vendor filter: case-insensitive substring match against `measurement.metrics[].metric_id`. v1 scope: metric_id only (description/standard search is a follow-up). Max 64 chars; SQL wildcard characters are escaped. Implies `type=measurement`. */
                 q?: string;
+                /** @description Canonical creative-capability filter: exact match on creative.supported_formats[].format.format_kind. Repeatable with OR semantics. Matches standalone creative agents and mixed-role endpoints. */
+                format_kind?: string | string[];
+                /** @description Canonical creative-capability filter: exact publisher_domain on the same supported-format entry. Pair with format_option_id to find endpoints claiming an exact publisher format. */
+                publisher_domain?: string;
+                /** @description Canonical creative-capability filter: exact publisher format_option_id on the same supported-format entry. */
+                format_option_id?: string;
+                /** @description Canonical creative-capability filter: exact endpoint-local creative.supported_formats[].capability_id. */
+                capability_id?: string;
+                /** @description Canonical creative-capability filter: required supported operation on the same format entry. Repeatable with OR semantics. */
+                creative_operation?: ("build" | "validate" | "preview") | ("build" | "validate" | "preview")[];
                 /** @description Filter to agents whose active badge covers the given verification axis. Repeat the parameter for AND semantics: ?verification_mode=spec&verification_mode=live returns only agents verified on both axes. */
                 verification_mode?: ("spec" | "live")[];
                 /** @description When true, filter to agents that hold any active verification badge. */
@@ -5682,6 +5743,8 @@ export interface operations {
         parameters: {
             query: {
                 domain: string;
+                /** @description Set to placements to include eligibility-oriented placement summaries with resolved canonical format options. */
+                include?: "placements";
             };
             header?: never;
             path?: never;
@@ -6759,7 +6822,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Creative formats */
+            /** @description Canonical creative capabilities */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -7457,8 +7520,8 @@ export interface operations {
                             categories: string[];
                             tags: string[];
                             delivery_types: string[];
-                            /** @description Creative format identifiers supported by this agent */
-                            format_ids: unknown[];
+                            /** @description Canonical format kinds present in this agent's indexed inventory profile */
+                            format_kinds: string[];
                             property_count: number;
                             publisher_count: number;
                             has_tmp: boolean;