@adcp/sdk 9.7.0 → 10.0.1

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

@@ -2038,10 +2038,60 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/registry/catalog": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Browse the property catalog
+         * @description Browse the property fact-graph with filters. Cursor-paginated (opaque `cursor` → `next_cursor`). Each entry carries the property's identifiers. `property_rid` is a non-authoritative join/match handle, never an authorization credential.
+         */
+        get: operations["browseCatalog"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/registry/catalog/sync": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Sync catalog changes since a watermark
+         * @description Delta sync for local mirrors: returns catalog entries created/updated since `since` (a prior `server_timestamp`), capped at 10,000 per page. Pagination is by the returned `server_timestamp` watermark, distinct from browseCatalog's opaque cursor.
+         */
+        get: operations["syncCatalog"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
     schemas: {
+        BrandEventPayload: {
+            /** @description Brand domain; brand.* events are identified by entity_id (the brand) and carry hierarchy context here. */
+            domain?: string;
+            /** @description On brand.resolved/hierarchy_updated: the resolved brand chain (root → leaf). */
+            chain?: {
+                [key: string]: unknown;
+            }[];
+            ancestor_domains?: string[];
+            domains?: string[];
+        };
         ResolvedBrand: {
             /** @example acmecorp.com */
             canonical_id: string;
@@ -3035,6 +3085,408 @@ export interface components {
                 created_at: string;
             }[];
         };
+        RegistryFeedEvent: {
+            /** Format: uuid */
+            event_id: string;
+            /** @enum {string} */
+            event_type: "agent.discovered";
+            entity_type: string;
+            entity_id: string;
+            payload: components["schemas"]["AgentEventPayload"];
+            actor: string;
+            /** Format: date-time */
+            created_at: string;
+        } | {
+            /** Format: uuid */
+            event_id: string;
+            /** @enum {string} */
+            event_type: "agent.removed";
+            entity_type: string;
+            entity_id: string;
+            payload: components["schemas"]["AgentEventPayload"];
+            actor: string;
+            /** Format: date-time */
+            created_at: string;
+        } | {
+            /** Format: uuid */
+            event_id: string;
+            /** @enum {string} */
+            event_type: "agent.profile_updated";
+            entity_type: string;
+            entity_id: string;
+            payload: components["schemas"]["AgentEventPayload"];
+            actor: string;
+            /** Format: date-time */
+            created_at: string;
+        } | {
+            /** Format: uuid */
+            event_id: string;
+            /** @enum {string} */
+            event_type: "agent.compliance_changed";
+            entity_type: string;
+            entity_id: string;
+            payload: components["schemas"]["AgentEventPayload"];
+            actor: string;
+            /** Format: date-time */
+            created_at: string;
+        } | {
+            /** Format: uuid */
+            event_id: string;
+            /** @enum {string} */
+            event_type: "agent.verification_earned";
+            entity_type: string;
+            entity_id: string;
+            payload: components["schemas"]["AgentEventPayload"];
+            actor: string;
+            /** Format: date-time */
+            created_at: string;
+        } | {
+            /** Format: uuid */
+            event_id: string;
+            /** @enum {string} */
+            event_type: "agent.verification_lost";
+            entity_type: string;
+            entity_id: string;
+            payload: components["schemas"]["AgentEventPayload"];
+            actor: string;
+            /** Format: date-time */
+            created_at: string;
+        } | {
+            /** Format: uuid */
+            event_id: string;
+            /** @enum {string} */
+            event_type: "property.created";
+            entity_type: string;
+            entity_id: string;
+            payload: components["schemas"]["PropertyEventPayload"];
+            actor: string;
+            /** Format: date-time */
+            created_at: string;
+        } | {
+            /** Format: uuid */
+            event_id: string;
+            /** @enum {string} */
+            event_type: "property.updated";
+            entity_type: string;
+            entity_id: string;
+            payload: components["schemas"]["PropertyEventPayload"];
+            actor: string;
+            /** Format: date-time */
+            created_at: string;
+        } | {
+            /** Format: uuid */
+            event_id: string;
+            /** @enum {string} */
+            event_type: "property.merged";
+            entity_type: string;
+            entity_id: string;
+            payload: components["schemas"]["PropertyEventPayload"];
+            actor: string;
+            /** Format: date-time */
+            created_at: string;
+        } | {
+            /** Format: uuid */
+            event_id: string;
+            /** @enum {string} */
+            event_type: "property.stale";
+            entity_type: string;
+            entity_id: string;
+            payload: components["schemas"]["PropertyEventPayload"];
+            actor: string;
+            /** Format: date-time */
+            created_at: string;
+        } | {
+            /** Format: uuid */
+            event_id: string;
+            /** @enum {string} */
+            event_type: "property.reactivated";
+            entity_type: string;
+            entity_id: string;
+            payload: components["schemas"]["PropertyEventPayload"];
+            actor: string;
+            /** Format: date-time */
+            created_at: string;
+        } | {
+            /** Format: uuid */
+            event_id: string;
+            /** @enum {string} */
+            event_type: "collection.created";
+            entity_type: string;
+            entity_id: string;
+            payload: components["schemas"]["CollectionEventPayload"];
+            actor: string;
+            /** Format: date-time */
+            created_at: string;
+        } | {
+            /** Format: uuid */
+            event_id: string;
+            /** @enum {string} */
+            event_type: "collection.updated";
+            entity_type: string;
+            entity_id: string;
+            payload: components["schemas"]["CollectionEventPayload"];
+            actor: string;
+            /** Format: date-time */
+            created_at: string;
+        } | {
+            /** Format: uuid */
+            event_id: string;
+            /** @enum {string} */
+            event_type: "collection.merged";
+            entity_type: string;
+            entity_id: string;
+            payload: components["schemas"]["CollectionEventPayload"];
+            actor: string;
+            /** Format: date-time */
+            created_at: string;
+        } | {
+            /** Format: uuid */
+            event_id: string;
+            /** @enum {string} */
+            event_type: "collection.removed";
+            entity_type: string;
+            entity_id: string;
+            payload: components["schemas"]["CollectionEventPayload"];
+            actor: string;
+            /** Format: date-time */
+            created_at: string;
+        } | {
+            /** Format: uuid */
+            event_id: string;
+            /** @enum {string} */
+            event_type: "authorization.granted";
+            entity_type: string;
+            entity_id: string;
+            payload: components["schemas"]["AuthorizationEventPayload"];
+            actor: string;
+            /** Format: date-time */
+            created_at: string;
+        } | {
+            /** Format: uuid */
+            event_id: string;
+            /** @enum {string} */
+            event_type: "authorization.revoked";
+            entity_type: string;
+            entity_id: string;
+            payload: components["schemas"]["AuthorizationEventPayload"];
+            actor: string;
+            /** Format: date-time */
+            created_at: string;
+        } | {
+            /** Format: uuid */
+            event_id: string;
+            /** @enum {string} */
+            event_type: "authorization.modified";
+            entity_type: string;
+            entity_id: string;
+            payload: components["schemas"]["AuthorizationEventPayload"];
+            actor: string;
+            /** Format: date-time */
+            created_at: string;
+        } | {
+            /** Format: uuid */
+            event_id: string;
+            /** @enum {string} */
+            event_type: "publisher.adagents_changed";
+            entity_type: string;
+            entity_id: string;
+            payload: components["schemas"]["PublisherEventPayload"];
+            actor: string;
+            /** Format: date-time */
+            created_at: string;
+        } | {
+            /** Format: uuid */
+            event_id: string;
+            /** @enum {string} */
+            event_type: "publisher.adagents_discovered";
+            entity_type: string;
+            entity_id: string;
+            payload: components["schemas"]["PublisherEventPayload"];
+            actor: string;
+            /** Format: date-time */
+            created_at: string;
+        };
+        AgentEventPayload: {
+            /** @description Canonical agent URL; the routing key for agent.* events (agents span many publishers). */
+            agent_url: string;
+            name?: string;
+            type?: string;
+            channels?: string[];
+            property_types?: string[];
+            markets?: string[];
+            categories?: string[];
+            category_taxonomy?: string | null;
+            tags?: string[];
+            delivery_types?: string[];
+            format_ids?: string[];
+            property_count?: number;
+            publisher_count?: number;
+            has_tmp?: boolean;
+            updated_at?: string;
+            changed_fields?: string[];
+            /** @description On agent.profile_updated: the agent's refreshed inventory profile. */
+            inventory_profile?: {
+                [key: string]: unknown;
+            };
+            compliance_summary?: {
+                [key: string]: unknown;
+            };
+            /** @description On agent.compliance_changed: prior compliance/verification status. */
+            previous_status?: string;
+            /** @description On agent.compliance_changed: new compliance/verification status. */
+            current_status?: string;
+            /** @description On agent.compliance_changed: human-readable summary of the compliance transition. */
+            headline?: string | null;
+            /** @description On agent.compliance_changed: map of compliance track id to track status. */
+            tracks?: {
+                [key: string]: "pass" | "fail" | "partial" | "skip" | "silent" | "warning" | "unknown" | "skipped";
+            };
+            storyboards_passing?: number;
+            storyboards_total?: number;
+            storyboards?: ({
+                storyboard_id: string;
+                status: string;
+                steps_passed?: number;
+                steps_total?: number;
+            } & {
+                [key: string]: unknown;
+            })[];
+            /** @description On agent.verification_earned/lost: verified role affected by the badge transition. */
+            role?: string;
+            /** @description On agent.verification_earned: specialisms covered by the earned badge. */
+            verified_specialisms?: string[];
+            /** @description On agent.verification_lost: reason the badge was revoked. */
+            reason?: string;
+            /** @description On agent.verification_earned/lost: AdCP version the badge applies to, when known. */
+            adcp_version?: string;
+        } & {
+            [key: string]: unknown;
+        };
+        PropertyEventPayload: {
+            property_rid?: string;
+            /** @description Publisher domain that owns the property; the routing key for property.* events. */
+            publisher_domain?: string;
+            identifiers?: components["schemas"]["PropertyIdentifier"][];
+            classification?: string;
+            /** @enum {string} */
+            source?: "authoritative" | "enriched" | "contributed";
+            /** @description Optional full post-change property object when available. */
+            property?: {
+                [key: string]: unknown;
+            };
+            changed_fields?: string[];
+            /** @description On property.stale: last successful resolution timestamp. */
+            last_resolved_at?: string;
+            /** @description On property.reactivated: reactivation timestamp when available. */
+            reactivated_at?: string;
+            /** @description On property.stale: reason the property aged out of active resolution. */
+            reason?: string;
+            /** @description On property.merged: the RID merged away. */
+            alias_rid?: string;
+            /** @description On property.merged: the surviving RID. */
+            canonical_rid?: string;
+            evidence?: string;
+        } & {
+            [key: string]: unknown;
+        };
+        CollectionEventPayload: {
+            collection_rid?: string;
+            /** @description Publisher domain that owns the collection; the routing key for collection.* events. */
+            publisher_domain?: string;
+            collection_id?: string | null;
+            name?: string | null;
+            kind?: string | null;
+            source?: string;
+            status?: string;
+            /** @description Distribution identifiers; the per-identifier publisher_domain (e.g. youtube.com) is the distribution surface, distinct from the owning publisher_domain above. */
+            identifiers?: {
+                publisher_domain: string;
+                type: string;
+                value: string;
+            }[];
+            collection?: {
+                [key: string]: unknown;
+            };
+            changed_fields?: string[];
+            /** @description On collection.merged: the RID merged away. */
+            alias_rid?: string;
+            /** @description On collection.merged: the surviving RID. */
+            canonical_rid?: string;
+            evidence?: string;
+        } & {
+            [key: string]: unknown;
+        };
+        AuthorizationEventPayload: {
+            /**
+             * Format: uuid
+             * @description Registry authorization row id when the event is backed by a materialized effective authorization row.
+             */
+            id?: string;
+            agent_url: string;
+            /** @description Registry-canonicalized form of agent_url for equality checks. */
+            agent_url_canonical?: string;
+            /** @description Publisher domain the authorization applies to; the routing key for authorization.* events. */
+            publisher_domain: string;
+            /** @description Present on authorization.granted; authorization.revoked carries only agent_url + publisher_domain. */
+            authorization_type?: string;
+            authorized_for?: string | null;
+            property_ids?: string[];
+            property_tags?: string[];
+            properties?: {
+                [key: string]: unknown;
+            }[];
+            publisher_properties?: {
+                [key: string]: unknown;
+            }[];
+            /** @description Catalog property_rid for materialized per-property authorization rows. Null for publisher-wide rows. */
+            property_rid?: string | null;
+            /** @description Publisher-local property id for materialized per-property authorization rows. */
+            property_id_slug?: string | null;
+            placement_ids?: string[];
+            placement_tags?: string[];
+            collections?: ({
+                publisher_domain: string;
+                collection_ids: string[];
+            } & {
+                [key: string]: unknown;
+            })[];
+            countries?: string[];
+            delegation_type?: string;
+            exclusive?: boolean;
+            effective_from?: string;
+            effective_until?: string;
+            signing_keys?: {
+                [key: string]: unknown;
+            }[];
+            evidence?: string;
+            disputed?: boolean;
+            created_by?: string | null;
+            expires_at?: string | null;
+            created_at?: string | null;
+            updated_at?: string | null;
+            override_applied?: boolean;
+            override_reason?: string | null;
+        } & {
+            [key: string]: unknown;
+        };
+        PublisherEventPayload: {
+            /** @description Publisher domain whose adagents.json was discovered/changed; the routing key for publisher.* events. */
+            publisher_domain?: string;
+            /** @description Legacy alias for publisher_domain retained for early feed examples. */
+            domain?: string;
+            properties_added?: number;
+            properties_removed?: number;
+            agents_added?: string[];
+            agents_removed?: string[];
+            agent_count?: number;
+            property_count?: number;
+            collection_count?: number;
+            discovery_method?: string;
+            manager_domain?: string | null;
+            source?: string;
+        } & {
+            [key: string]: unknown;
+        };
         AgentComplianceDetail: {
             agent_url: string;
             /** @description Requested compliance target before alias resolution, e.g. 3.0 or 3.1-beta. Null for legacy rows before target recording. */
@@ -3528,6 +3980,41 @@ export interface components {
         } & {
             [key: string]: unknown;
         };
+        CatalogBrowseResponse: {
+            entries: components["schemas"]["CatalogBrowseEntry"][];
+            total: number;
+            /** @description Opaque cursor for the next page; null when exhausted. */
+            next_cursor: string | null;
+        };
+        CatalogBrowseEntry: {
+            property_rid: string;
+            property_id: string | null;
+            /** @example property */
+            classification: string;
+            /** @example adagents_json */
+            source: string;
+            /** @example active */
+            status: string;
+            identifiers: components["schemas"]["CatalogIdentifier"][];
+        };
+        CatalogSyncResponse: {
+            entries: components["schemas"]["CatalogSyncEntry"][];
+            /** @description Watermark to pass as `since` on the next sync (avoids clock skew). */
+            server_timestamp: string;
+            next_cursor: string | null;
+        };
+        CatalogSyncEntry: {
+            property_rid: string;
+            property_id: string | null;
+            classification: string;
+            source: string;
+            status: string;
+            adagents_url: string | null;
+            created_by: string | null;
+            created_at: string;
+            updated_at: string;
+            source_updated_at: string;
+        };
         AdagentsJson: {
             /** Format: uri */
             $schema?: string;
@@ -5995,21 +6482,7 @@ export interface operations {
                 };
                 content: {
                     "application/json": {
-                        events: {
-                            /** Format: uuid */
-                            event_id: string;
-                            /** @example property.created */
-                            event_type: string;
-                            /** @example property */
-                            entity_type: string;
-                            entity_id: string;
-                            payload: {
-                                [key: string]: unknown;
-                            };
-                            actor: string;
-                            /** Format: date-time */
-                            created_at: string;
-                        }[];
+                        events: components["schemas"]["RegistryFeedEvent"][];
                         /**
                          * Format: uuid
                          * @description Pass as cursor in the next request to continue polling
@@ -9238,6 +9711,74 @@ export interface operations {
             };
         };
     };
+    browseCatalog: {
+        parameters: {
+            query?: {
+                classification?: string;
+                source?: string;
+                status?: string;
+                identifier_type?: string;
+                search?: string;
+                /** @description Minimum lifetime resolve count (integer). */
+                min_resolves?: string;
+                /** @description ISO 8601 — only properties with resolve activity since this time. */
+                active_since?: string;
+                /** @description Page size (integer). */
+                limit?: string;
+                /** @description Opaque pagination cursor from a prior `next_cursor`. */
+                cursor?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Catalog page */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CatalogBrowseResponse"];
+                };
+            };
+        };
+    };
+    syncCatalog: {
+        parameters: {
+            query: {
+                /** @description Watermark from a prior response `server_timestamp` (required). */
+                since: string;
+                /** @description Page size, capped at 10,000. */
+                limit?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Catalog delta */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CatalogSyncResponse"];
+                };
+            };
+            /** @description Missing required `since` parameter */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
 }
 export type ResolvedBrand = components['schemas']['ResolvedBrand'];
 export type LocalizedName = components['schemas']['LocalizedName'];
@@ -9260,6 +9801,17 @@ export type PropertyActivity = components['schemas']['PropertyActivity'];
 export type PolicySummary = components['schemas']['PolicySummary'];
 export type Policy = components['schemas']['Policy'];
 export type PolicyHistory = components['schemas']['PolicyHistory'];
+export type RegistryFeedEvent = components['schemas']['RegistryFeedEvent'];
+export type AgentEventPayload = components['schemas']['AgentEventPayload'];
+export type PropertyEventPayload = components['schemas']['PropertyEventPayload'];
+export type CollectionEventPayload = components['schemas']['CollectionEventPayload'];
+export type AuthorizationEventPayload = components['schemas']['AuthorizationEventPayload'];
+export type PublisherEventPayload = components['schemas']['PublisherEventPayload'];
+export type BrandEventPayload = components['schemas']['BrandEventPayload'];
+export type CatalogBrowseResponse = components['schemas']['CatalogBrowseResponse'];
+export type CatalogBrowseEntry = components['schemas']['CatalogBrowseEntry'];
+export type CatalogSyncResponse = components['schemas']['CatalogSyncResponse'];
+export type CatalogSyncEntry = components['schemas']['CatalogSyncEntry'];
 export type AgentCompliance = components['schemas']['AgentCompliance'];
 export type AgentComplianceDetail = components['schemas']['AgentComplianceDetail'];
 export type StoryboardStatus = components['schemas']['StoryboardStatus'];