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

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;
@@ -3802,9 +3822,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 +3834,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;
@@ -5921,6 +5966,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 +7768,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 +7966,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 +8003,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;
                     };
                 };

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

@@ -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;
@@ -3802,9 +3822,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 +3834,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;
@@ -5921,6 +5966,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 +7768,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 +7966,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 +8003,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;
                     };
                 };