@adcp/sdk 13.0.0-rc.13 → 13.0.0-rc.15

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

@@ -1259,7 +1259,7 @@ export interface paths {
         put?: never;
         /**
          * Request domain re-crawl
-         * @description Trigger an immediate re-crawl of a publisher domain after updating adagents.json. The crawl runs asynchronously in the accepting process — returns 202 immediately. The response `crawl_request_id` correlates accepted, running, completed, skipped, and failed lifecycle logs; a 202 does not by itself mean the mirror write completed.
+         * @description Persist a durable re-crawl request for a publisher domain after updating adagents.json. Returns 202 only after the request is committed to the queue. Use the returned `crawl_request_id` with the status endpoint to observe completion.
          *
          *     **Rate limits:** 5 minutes per domain, 30 requests per user per hour.
          */
@@ -1270,6 +1270,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/registry/crawl-request/{crawlRequestId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get publisher crawl request status
+         * @description Return the durable lifecycle for a publisher recrawl. Requesters may read their own requests; registry administrators may read any request.
+         */
+        get: operations["getCrawlRequest"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/registry/manager-revalidation-request": {
         parameters: {
             query?: never;
@@ -1385,7 +1405,7 @@ export interface paths {
         };
         /**
          * Get agent verification badge SVG
-         * @description Returns an SVG badge image for the specified agent and role. Shows 'AAO Verified | Sales Agent' (teal) when verified, or 'AAO Verified | Not Verified' (grey) when not. Cacheable, suitable for embedding in websites.
+         * @description Returns an SVG badge image for the specified agent and role. Shows the role-specific AgenticAdvertising.org Verified mark (teal) when verified, or 'Not Verified' (grey) when not. Cacheable and suitable for embedding in websites.
          */
         get: operations["getAgentBadgeSvg"];
         put?: never;
@@ -2544,9 +2564,15 @@ export interface components {
             monitoring_paused?: boolean;
             check_interval_hours?: number;
             verified?: boolean;
-            /** @description AdCP protocols the agent is AAO Verified for (e.g. media-buy, creative). Matches enums/adcp-protocol.json. */
-            verified_roles?: ("media-buy" | "signals" | "governance" | "creative" | "brand" | "sponsored-intelligence" | "measurement")[];
+            /** @description Canonical badge roles the agent is AgenticAdvertising.org Verified for (e.g. media-buy, creative). */
+            verified_roles?: components["schemas"]["BadgeRole"][];
+            /** @description Active AgenticAdvertising.org Verified AdCP releases for each verified role, keyed by canonical badge role and sorted newest-first (e.g. { media-buy: ['3.1', '3.0'] }). Use this when choosing a version-pinned badge URL. */
+            verified_role_versions?: {
+                [key: string]: string[];
+            };
         };
+        /** @enum {string} */
+        BadgeRole: "media-buy" | "creative" | "signals" | "governance" | "brand" | "sponsored-intelligence";
         PropertySummary: {
             total_count: number;
             count_by_type: {
@@ -3802,9 +3828,7 @@ export interface components {
             exclusive?: boolean;
             effective_from?: string;
             effective_until?: string;
-            signing_keys?: {
-                [key: string]: unknown;
-            }[];
+            signing_keys?: components["schemas"]["SigningKey"][] | null;
             evidence?: string;
             disputed?: boolean;
             created_by?: string | null;
@@ -3816,6 +3840,33 @@ export interface components {
         } & {
             [key: string]: unknown;
         };
+        SigningKey: {
+            /** @description Key identifier for selecting the correct signing key. */
+            kid: string;
+            /** @description JWK key type, such as 'OKP', 'EC', or 'RSA'. */
+            kty: string;
+            /** @description Expected signing algorithm for this key, such as 'EdDSA' or 'RS256'. */
+            alg?: string;
+            /** @description Optional JWK use value. Typically 'sig' for signing keys. */
+            use?: string;
+            /** @description Curve name for OKP or EC keys, such as 'Ed25519' or 'P-256'. */
+            crv?: string;
+            /** @description Base64url-encoded public key x coordinate or public key value for OKP keys. */
+            x?: string;
+            /** @description Base64url-encoded public key y coordinate for EC keys. */
+            y?: string;
+            /** @description Base64url-encoded RSA modulus. */
+            n?: string;
+            /** @description Base64url-encoded RSA public exponent. */
+            e?: string;
+            /**
+             * Format: date-time
+             * @description Optional revocation timestamp. When present, verifiers MUST reject any signature produced with this key whose signing epoch is at or after this timestamp. The key may continue to appear in the trust anchor during a grace period so caches that have not yet refreshed still find the key and can evaluate the revocation marker.
+             */
+            revoked_at?: string;
+        } & {
+            [key: string]: unknown;
+        };
         PublisherEventPayload: {
             /** @description Publisher domain whose adagents.json was discovered/changed; the routing key for publisher.* events. */
             publisher_domain?: string;
@@ -3927,11 +3978,7 @@ export interface components {
             verified_badges?: components["schemas"]["VerificationBadge"][];
         };
         VerificationBadge: {
-            /**
-             * @description AdCP protocol this badge covers (enums/adcp-protocol.json).
-             * @enum {string}
-             */
-            role: "media-buy" | "signals" | "governance" | "creative" | "brand" | "sponsored-intelligence" | "measurement";
+            role: components["schemas"]["BadgeRole"] & unknown;
             /** @description AdCP release this badge was issued against, MAJOR.MINOR (e.g. '3.0', '3.1'). Load-bearing for badge identity — pairs with the (agent_url, role, adcp_version) PK. */
             adcp_version: string;
             verified_at: string;
@@ -5921,6 +5968,23 @@ export interface operations {
                     };
                 };
             };
+            /** @description Publisher crawl is temporarily busy */
+            503: {
+                headers: {
+                    /** @description Seconds to wait before retrying */
+                    "Retry-After": string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                        /** @enum {string} */
+                        code: "publisher_crawl_busy";
+                        /** @description Seconds to wait before retrying */
+                        retry_after: number;
+                    };
+                };
+            };
         };
     };
     forceBrandCrawl: {
@@ -7706,6 +7770,8 @@ export interface operations {
                             created_at: string;
                             /** Format: date-time */
                             updated_at: string;
+                            /** @description Publisher-pinned JWK set (authorized_agents[*].signing_keys) from the source adagents.json. Consumers verifying inbound TMP signatures key on kid → JWK. Null when the publisher declared no keys; consumers fall back to the agent-hosted JWKS per spec R-2 (docs/governance/property/adagents.mdx). */
+                            signing_keys: components["schemas"]["SigningKey"][] | null;
                             override_applied: boolean;
                             override_reason: string | null;
                         }[];
@@ -7902,7 +7968,7 @@ export interface operations {
                         domain: string;
                         /**
                          * Format: uuid
-                         * @description Correlation ID for crawl lifecycle logs; acceptance is not completion.
+                         * @description Durable request ID for lifecycle logs and status lookup; acceptance is not completion.
                          */
                         crawl_request_id: string;
                     };
@@ -7939,16 +8005,102 @@ export interface operations {
                     };
                 };
             };
-            /** @description A full crawl is active; the request was not accepted */
+            /** @description The durable crawl queue is temporarily unavailable; the request was not accepted */
+            503: {
+                headers: {
+                    /** @description Seconds to wait before retrying */
+                    "Retry-After": string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                        /** @enum {string} */
+                        code: "crawl_queue_unavailable" | "crawl_queue_at_capacity";
+                        retry_after: number;
+                    };
+                };
+            };
+        };
+    };
+    getCrawlRequest: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                crawlRequestId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Durable crawl request lifecycle */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        crawl_request_id: string;
+                        domain: string;
+                        /** @enum {string} */
+                        status: "queued" | "running" | "deferred" | "retrying" | "completed" | "invalid" | "failed";
+                        attempts: number;
+                        max_attempts: number;
+                        /** Format: date-time */
+                        requested_at: string;
+                        /** Format: date-time */
+                        started_at: string | null;
+                        /** Format: date-time */
+                        last_attempted_at: string | null;
+                        /** Format: date-time */
+                        completed_at: string | null;
+                        /** Format: date-time */
+                        next_attempt_at: string | null;
+                        last_error_code: string | null;
+                    };
+                };
+            };
+            /** @description Invalid crawl request ID */
+            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 Crawl request not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Crawl status is temporarily unavailable */
             503: {
                 headers: {
+                    /** @description Seconds to wait before retrying */
+                    "Retry-After": string;
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": {
                         error: string;
                         /** @enum {string} */
-                        code: "crawl_temporarily_unavailable";
+                        code: "crawl_status_unavailable";
                         retry_after: number;
                     };
                 };
@@ -8191,6 +8343,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Verification status temporarily unavailable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
         };
     };
     getAgentBadgeSvg: {
@@ -8200,8 +8361,8 @@ export interface operations {
             path: {
                 /** @description URL-encoded agent URL */
                 encodedUrl: string;
-                /** @description Badge role (sales, buying, creative, governance, signals, measurement) */
-                role: string;
+                /** @description Canonical badge role */
+                role: components["schemas"]["BadgeRole"] & unknown;
             };
             cookie?: never;
         };
@@ -8216,12 +8377,20 @@ export interface operations {
                     "image/svg+xml": string;
                 };
             };
-            /** @description Invalid agent URL */
+            /** @description Invalid agent URL or role */
             400: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": {
+                        error: string;
+                        /** @enum {string} */
+                        code: "invalid_role";
+                        message: string;
+                        valid_roles: components["schemas"]["BadgeRole"][];
+                    } | components["schemas"]["Error"];
+                };
             };
             /** @description Server error */
             500: {
@@ -8230,6 +8399,15 @@ export interface operations {
                 };
                 content?: never;
             };
+            /** @description Badge status temporarily unavailable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
         };
     };
     getAgentBadgeEmbed: {
@@ -8239,8 +8417,8 @@ export interface operations {
             path: {
                 /** @description URL-encoded agent URL */
                 encodedUrl: string;
-                /** @description Badge role */
-                role: string;
+                /** @description Canonical badge role */
+                role: components["schemas"]["BadgeRole"] & unknown;
             };
             cookie?: never;
         };
@@ -8254,7 +8432,9 @@ export interface operations {
                 content: {
                     "application/json": {
                         agent_url: string;
-                        role: string;
+                        role: components["schemas"]["BadgeRole"];
+                        verified: boolean;
+                        adcp_version?: string;
                         badge_svg_url: string;
                         registry_url: string;
                         html: string;
@@ -8262,13 +8442,19 @@ export interface operations {
                     };
                 };
             };
-            /** @description Invalid agent URL */
+            /** @description Invalid agent URL or role */
             400: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["Error"];
+                    "application/json": {
+                        error: string;
+                        /** @enum {string} */
+                        code: "invalid_role";
+                        message: string;
+                        valid_roles: components["schemas"]["BadgeRole"][];
+                    } | components["schemas"]["Error"];
                 };
             };
             /** @description Server error */
@@ -8280,6 +8466,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Badge status temporarily unavailable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
         };
     };
     getAgentBadgeVersionedSvg: {
@@ -8289,8 +8484,8 @@ export interface operations {
             path: {
                 /** @description URL-encoded agent URL */
                 encodedUrl: string;
-                /** @description Badge role (media-buy, creative, signals, governance, brand, sponsored-intelligence) */
-                role: string;
+                /** @description Canonical badge role */
+                role: components["schemas"]["BadgeRole"] & unknown;
                 /** @description AdCP release as MAJOR.MINOR (e.g. '3.0', '3.1') */
                 version: string;
             };
@@ -8313,7 +8508,13 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["Error"];
+                    "application/json": {
+                        error: string;
+                        /** @enum {string} */
+                        code: "invalid_role";
+                        message: string;
+                        valid_roles: components["schemas"]["BadgeRole"][];
+                    } | components["schemas"]["Error"];
                 };
             };
             /** @description Server error */
@@ -8323,6 +8524,15 @@ export interface operations {
                 };
                 content?: never;
             };
+            /** @description Badge status temporarily unavailable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
         };
     };
     getAgentBadgeVersionedEmbed: {
@@ -8332,8 +8542,8 @@ export interface operations {
             path: {
                 /** @description URL-encoded agent URL */
                 encodedUrl: string;
-                /** @description Badge role */
-                role: string;
+                /** @description Canonical badge role */
+                role: components["schemas"]["BadgeRole"] & unknown;
                 /** @description AdCP release as MAJOR.MINOR */
                 version: string;
             };
@@ -8349,9 +8559,9 @@ export interface operations {
                 content: {
                     "application/json": {
                         agent_url: string;
-                        role: string;
+                        role: components["schemas"]["BadgeRole"];
                         verified: boolean;
-                        adcp_version?: string;
+                        adcp_version: string;
                         badge_svg_url: string;
                         registry_url: string;
                         html: string;
@@ -8365,7 +8575,13 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["Error"];
+                    "application/json": {
+                        error: string;
+                        /** @enum {string} */
+                        code: "invalid_role";
+                        message: string;
+                        valid_roles: components["schemas"]["BadgeRole"][];
+                    } | components["schemas"]["Error"];
                 };
             };
             /** @description Server error */
@@ -8377,6 +8593,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Badge status temporarily unavailable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
         };
     };
     getAgentStoryboardStatus: {