@adcp/client 4.20.0 → 4.21.0

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

@@ -511,75 +511,6 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/registry/feed": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Registry change feed
-         * @description Poll the catalog event feed. Returns events since the provided cursor,
-         *     ordered by UUID v7 event_id. Consumers save cursor and pass it on
-         *     the next poll. When has_more is false, the consumer is caught up.
-         *
-         *     Events are retained for 90 days. If the cursor refers to a deleted event,
-         *     cursor_expired is true and the client should re-bootstrap.
-         */
-        get: operations["getRegistryFeed"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/registry/agents/search": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Search agents by inventory profile
-         * @description Query the registry for agents matching a campaign profile. Returns a
-         *     ranked list with inventory profiles and match scores. All filters use
-         *     AND logic across dimensions; multiple values within a filter use OR.
-         */
-        get: operations["searchAgents"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/registry/crawl-request": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Request domain re-crawl
-         * @description Request immediate re-crawl of a domain's adagents.json. The requester
-         *     must be a member who owns the domain or an agent authorized for it.
-         *     Rate limited to one crawl per domain per 10 minutes.
-         */
-        post: operations["requestCrawl"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/api/adagents/validate": {
         parameters: {
             query?: never;
@@ -842,6 +773,70 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/registry/feed": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 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.
+         *
+         *     Type filtering supports glob patterns: `property.*` matches `property.created`, `property.updated`, etc.
+         */
+        get: operations["getRegistryFeed"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/registry/agents/search": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Search agent inventory profiles
+         * @description Search agents by inventory profile — channels, markets, content categories, property types, and more. Filters use AND across dimensions and OR within a dimension. Results are ranked by relevance score.
+         */
+        get: operations["searchAgentProfiles"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/registry/crawl-request": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Request domain re-crawl
+         * @description Trigger an immediate re-crawl of a publisher domain after updating adagents.json. The crawl runs asynchronously — returns 202 immediately.
+         *
+         *     **Rate limits:** 5 minutes per domain, 30 requests per user per hour.
+         */
+        post: operations["requestCrawl"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -1291,121 +1286,6 @@ export interface components {
                 created_at: string;
             }[];
         };
-        CatalogEvent: {
-            /**
-             * Format: uuid
-             * @description UUID v7, monotonically ordered
-             */
-            event_id: string;
-            /** @enum {string} */
-            event_type: "property.created" | "property.updated" | "property.merged" | "property.stale" | "property.reactivated" | "agent.discovered" | "agent.removed" | "agent.profile_updated" | "publisher.adagents_changed" | "authorization.granted" | "authorization.revoked";
-            /** @enum {string} */
-            entity_type: "property" | "agent" | "publisher" | "authorization";
-            /** @description property_rid, agent_url, or publisher_domain */
-            entity_id: string;
-            payload: {
-                [key: string]: unknown;
-            };
-            /** @description crawler, member_id, or system */
-            actor: string;
-            /** Format: date-time */
-            created_at: string;
-        };
-        FeedResponse: {
-            events: components["schemas"]["CatalogEvent"][];
-            /**
-             * Format: uuid
-             * @description Pass as cursor on next poll. Null when no events returned.
-             */
-            cursor: string | null;
-            has_more: boolean;
-            /** @description True when the provided cursor has been cleaned up. Client should re-bootstrap. */
-            cursor_expired?: boolean;
-        };
-        AgentInventoryProfile: {
-            /** @description Media channels: display, olv, ctv, dooh, etc. */
-            channels: string[];
-            /** @description Inventory surface types: website, mobile_app, ctv_app, etc. */
-            property_types: string[];
-            /** @description ISO 3166-1 alpha-2 country codes */
-            markets: string[];
-            /** @description IAB Content Taxonomy 3.0 categories */
-            categories: string[];
-            /** @default iab_content_3.0 */
-            category_taxonomy: string;
-            tags: string[];
-            /** @description guaranteed, non_guaranteed, etc. */
-            delivery_types: string[];
-            property_count: number;
-            publisher_count: number;
-            /** @description Whether the agent supports Trusted Match Protocol */
-            has_tmp: boolean;
-        };
-        AgentSearchResult: {
-            url: string;
-            name: string;
-            /** @enum {string} */
-            type: "creative" | "signals" | "sales" | "governance" | "si" | "unknown";
-            /** @enum {string} */
-            protocol?: "mcp" | "a2a";
-            /** @enum {string} */
-            source?: "registered" | "discovered";
-            member?: {
-                slug?: string;
-                display_name?: string;
-            };
-            inventory_profile: components["schemas"]["AgentInventoryProfile"];
-            match: {
-                score: number;
-                matched_filters: string[];
-            };
-        };
-        AgentSearchResponse: {
-            results: components["schemas"]["AgentSearchResult"][];
-            cursor?: string | null;
-            has_more: boolean;
-            filters_applied?: {
-                [key: string]: string[];
-            };
-        };
-        CrawlRequestResponse: {
-            /** @enum {string} */
-            status: "accepted" | "rate_limited";
-            domain: string;
-            /**
-             * Format: date-time
-             * @description Present when rate_limited
-             */
-            last_crawled?: string | null;
-            /** @description Seconds until next crawl allowed. Present when rate_limited. */
-            retry_after?: number | null;
-        };
-        /** @description Full authorization record from adagents.json, carried in authorization.granted/revoked event payloads. */
-        AuthorizationEntry: {
-            agent_url: string;
-            publisher_domain: string;
-            /** @enum {string} */
-            authorization_type: "full" | "property_ids" | "property_types" | "collections";
-            property_ids?: string[];
-            placement_ids?: string[];
-            collections?: {
-                publisher_domain: string;
-                collection_id: string;
-            }[];
-            /** @description ISO 3166-1 alpha-2 country codes */
-            countries?: string[];
-            /** @enum {string} */
-            delegation_type?: "direct" | "delegated";
-            exclusive?: boolean;
-            signing_keys?: {
-                algorithm: string;
-                public_key: string;
-            }[];
-            /** Format: date-time */
-            effective_from?: string | null;
-            /** Format: date-time */
-            effective_until?: string | null;
-        };
     };
     responses: never;
     parameters: never;
@@ -2382,136 +2262,6 @@ export interface operations {
             };
         };
     };
-    getRegistryFeed: {
-        parameters: {
-            query?: {
-                /** @description Last event_id processed. Omit for start of retention window. */
-                cursor?: string;
-                /** @description Comma-separated event types. Supports glob: property.*, authorization.* */
-                types?: string;
-                limit?: number;
-            };
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Feed events */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["FeedResponse"];
-                };
-            };
-            /** @description Authentication required */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-        };
-    };
-    searchAgents: {
-        parameters: {
-            query?: {
-                type?: "creative" | "signals" | "sales" | "governance" | "si";
-                /** @description Comma-separated media channels: ctv, olv, display, dooh */
-                channels?: string;
-                /** @description Comma-separated ISO 3166-1 alpha-2 codes: US, GB, CA */
-                markets?: string;
-                /** @description Comma-separated IAB categories: IAB-7, IAB-7-1 */
-                categories?: string;
-                /** @description Comma-separated: website, mobile_app, ctv_app */
-                property_types?: string;
-                /** @description Comma-separated property tags */
-                tags?: string;
-                /** @description Comma-separated: guaranteed, non_guaranteed */
-                delivery_types?: string;
-                /** @description Filter to agents supporting Trusted Match Protocol */
-                has_tmp?: boolean;
-                min_properties?: number;
-                sort?: "relevance" | "property_count" | "publisher_count";
-                limit?: number;
-                /** @description Pagination cursor from previous response */
-                cursor?: string;
-            };
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Search results */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["AgentSearchResponse"];
-                };
-            };
-            /** @description Authentication required */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-        };
-    };
-    requestCrawl: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": {
-                    /** @description Publisher domain to re-crawl */
-                    domain: string;
-                };
-            };
-        };
-        responses: {
-            /** @description Crawl accepted or rate limited */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["CrawlRequestResponse"];
-                };
-            };
-            /** @description Authentication required */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Rate limit exceeded */
-            429: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["CrawlRequestResponse"];
-                };
-            };
-        };
-    };
     validateAdagents: {
         parameters: {
             query?: never;
@@ -3082,6 +2832,233 @@ export interface operations {
             };
         };
     };
+    getRegistryFeed: {
+        parameters: {
+            query?: {
+                /** @description Resume after this event ID */
+                cursor?: string;
+                /** @description Comma-separated event type filters with glob support (e.g. property.*) */
+                types?: string;
+                /** @description Max events per page (default 100, max 10,000) */
+                limit?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Feed page */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                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;
+                        }[];
+                        /**
+                         * Format: uuid
+                         * @description Pass as cursor in the next request to continue polling
+                         */
+                        cursor: string | null;
+                        has_more: boolean;
+                    };
+                };
+            };
+            /** @description Invalid cursor format or type filter */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Cursor expired (older than 90-day retention window) */
+            410: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @enum {string} */
+                        error: "cursor_expired";
+                        message: string;
+                    };
+                };
+            };
+        };
+    };
+    searchAgentProfiles: {
+        parameters: {
+            query?: {
+                /** @description Comma-separated channel filter */
+                channels?: string;
+                /** @description Comma-separated property type filter */
+                property_types?: string;
+                /** @description Comma-separated market/country code filter */
+                markets?: string;
+                /** @description Comma-separated IAB content category filter */
+                categories?: string;
+                /** @description Comma-separated tag filter */
+                tags?: string;
+                /** @description Comma-separated delivery type filter */
+                delivery_types?: string;
+                /** @description Require TMP support */
+                has_tmp?: "true" | "false";
+                /** @description Minimum number of properties in inventory */
+                min_properties?: number | null;
+                /** @description Pagination cursor from a previous response */
+                cursor?: string;
+                /** @description Max results per page (default 50, max 200) */
+                limit?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Search results ranked by relevance */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        results: {
+                            /** Format: uri */
+                            agent_url: string;
+                            channels: string[];
+                            property_types: string[];
+                            markets: string[];
+                            categories: string[];
+                            tags: string[];
+                            delivery_types: string[];
+                            /** @description Creative format identifiers supported by this agent */
+                            format_ids: unknown[];
+                            property_count: number;
+                            publisher_count: number;
+                            has_tmp: boolean;
+                            category_taxonomy: string | null;
+                            relevance_score: number;
+                            matched_filters: string[];
+                            /** Format: date-time */
+                            updated_at: string;
+                        }[];
+                        cursor: string | null;
+                        has_more: boolean;
+                    };
+                };
+            };
+            /** @description Invalid cursor or parameter */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    requestCrawl: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": {
+                    /**
+                     * @description Publisher domain to re-crawl
+                     * @example examplepub.com
+                     */
+                    domain: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Crawl request accepted */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @enum {string} */
+                        message: "Crawl request accepted";
+                        domain: string;
+                    };
+                };
+            };
+            /** @description Invalid domain format, private IP, or unresolvable domain */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Rate limit exceeded */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                        /** @description Seconds to wait before retrying */
+                        retry_after: number;
+                    };
+                };
+            };
+        };
+    };
 }
 export type ResolvedBrand = components['schemas']['ResolvedBrand'];
 export type LocalizedName = components['schemas']['LocalizedName'];
@@ -3099,11 +3076,62 @@ export type AgentCapabilities = components['schemas']['AgentCapabilities'];
 export type PropertySummary = components['schemas']['PropertySummary'];
 export type FederatedPublisher = components['schemas']['FederatedPublisher'];
 export type DomainLookupResult = components['schemas']['DomainLookupResult'];
-export type CatalogEvent = components['schemas']['CatalogEvent'];
-export type FeedResponse = components['schemas']['FeedResponse'];
-export type AgentInventoryProfile = components['schemas']['AgentInventoryProfile'];
-export type AgentSearchResult = components['schemas']['AgentSearchResult'];
-export type AgentSearchResponse = components['schemas']['AgentSearchResponse'];
-export type CrawlRequestResponse = components['schemas']['CrawlRequestResponse'];
-export type AuthorizationEntry = components['schemas']['AuthorizationEntry'];
+export type BrandActivity = components['schemas']['BrandActivity'];
+export type PropertyActivity = components['schemas']['PropertyActivity'];
+export type PolicySummary = components['schemas']['PolicySummary'];
+export type Policy = components['schemas']['Policy'];
+export type PolicyHistory = components['schemas']['PolicyHistory'];
+/** A single event from the registry feed (inline in getRegistryFeed 200 response). */
+export type CatalogEvent = operations['getRegistryFeed']['responses']['200']['content']['application/json']['events'][number];
+/** Full response from GET /api/registry/feed. Includes optional cursor_expired for 410 handling. */
+export type FeedResponse = operations['getRegistryFeed']['responses']['200']['content']['application/json'] & {
+    /** Set to true by the client when the server returns 410 (cursor expired). */
+    cursor_expired?: boolean;
+};
+/** Raw search result from the searchAgentProfiles operation. */
+export type AgentProfileSearchResult = operations['searchAgentProfiles']['responses']['200']['content']['application/json']['results'][number];
+/** Full response from GET /api/registry/agents/search (raw operation type). */
+export type AgentProfileSearchResponse = operations['searchAgentProfiles']['responses']['200']['content']['application/json'];
+/** Response from POST /api/registry/crawl-request (202). */
+export type CrawlRequestResponse = operations['requestCrawl']['responses']['202']['content']['application/json'];
+/** Inventory profile for an agent (channels, markets, categories, etc.). */
+export type AgentInventoryProfile = {
+    channels: string[];
+    property_types: string[];
+    markets: string[];
+    categories: string[];
+    category_taxonomy: string | null;
+    tags: string[];
+    delivery_types: string[];
+    format_ids?: unknown[];
+    property_count: number;
+    publisher_count: number;
+    has_tmp: boolean;
+};
+/** An agent search result in the client-facing shape used by RegistrySync. */
+export type AgentSearchResult = {
+    url: string;
+    name: string;
+    type: string;
+    inventory_profile: AgentInventoryProfile;
+    match: {
+        score: number;
+        matched_filters: string[];
+    };
+};
+/** Response shape for the searchAgents client method. */
+export type AgentSearchResponse = {
+    results: AgentSearchResult[];
+    cursor: string | null;
+    has_more: boolean;
+};
+/** An authorization entry used by the sync module. Derived from authorization.granted event payloads. */
+export type AuthorizationEntry = {
+    agent_url: string;
+    publisher_domain: string;
+    authorization_type: string;
+    property_ids?: string[];
+    effective_from?: string;
+    effective_to?: string;
+};
 //# sourceMappingURL=types.generated.d.ts.map