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

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

@@ -750,6 +750,86 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/registry/mirror-proposals": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List community mirror proposals
+         * @description List the caller's own community-mirror proposals. Registry moderators and AgenticAdvertising.org administrators see the review queue and may filter by status; their default is `pending`.
+         */
+        get: operations["listCommunityMirrorProposals"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/registry/mirror-proposals/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get community mirror proposal
+         * @description Fetch a proposal owned by the caller. Registry moderators and AgenticAdvertising.org administrators may fetch any proposal.
+         */
+        get: operations["getCommunityMirrorProposal"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/registry/mirror-proposals/{id}/approve": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Approve community mirror proposal
+         * @description Approve and atomically publish a pending proposal. Requires a registry moderator or AgenticAdvertising.org administrator.
+         */
+        post: operations["approveCommunityMirrorProposal"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/registry/mirror-proposals/{id}/reject": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Reject community mirror proposal
+         * @description Reject a pending proposal with reviewer notes. Requires a registry moderator or AgenticAdvertising.org administrator.
+         */
+        post: operations["rejectCommunityMirrorProposal"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/registry/mirrors": {
         parameters: {
             query?: never;
@@ -783,8 +863,8 @@ export interface paths {
          */
         get: operations["getCommunityMirror"];
         /**
-         * Publish community mirror
-         * @description Publish or update a catalog-only adagents.json community mirror. Requires a registry moderator or AgenticAdvertising.org admin. The service validates the assembled document against adagents.json, forces `authorized_agents: []`, regenerates `$schema` and `last_updated`, and updates derived publisher-domain catalog rows.
+         * Publish or propose community mirror
+         * @description Submit a catalog-only adagents.json community mirror. Registry moderators and AgenticAdvertising.org administrators publish immediately; other authenticated organization callers create or refresh a pending proposal and receive HTTP 202. Contributor proposals are limited to 1 MiB and 2,000 catalog items. The service validates the assembled document against adagents.json, forces `authorized_agents: []`, and regenerates `$schema` and `last_updated`.
          */
         put: operations["publishCommunityMirror"];
         post?: never;
@@ -2594,6 +2674,8 @@ export interface components {
                 display_name: string;
                 /** @description Canonical format discriminator, such as `image`, `video_hosted`, `native_in_feed`, or `custom`. */
                 format_kind: string;
+                /** @description Optional public HTTPS page where a human can inspect a sample render of this catalog format using publisher- or community-mirror-provided example assets. Informational only; this is not a renderer endpoint, buyer-asset preview, validation result, creative approval, proof of publisher acceptance, or live delivery guarantee. */
+                sample_render_url?: string;
                 /** @description Canonical format params from the publisher's adagents.json declaration. */
                 params?: {
                     [key: string]: unknown;
@@ -2719,19 +2801,37 @@ export interface components {
         } & {
             [key: string]: unknown;
         };
-        CommunityMirrorListResponse: {
-            mirrors: components["schemas"]["CommunityMirrorSummary"][];
+        CommunityMirrorProposalListResponse: {
+            proposals: components["schemas"]["CommunityMirrorProposalSummary"][];
             total: number;
         };
-        CommunityMirrorSummary: {
+        CommunityMirrorProposalSummary: {
+            /**
+             * Format: uuid
+             * @description Opaque identifier for the proposal.
+             * @example 4ec8bc86-6180-4d0e-aa72-9cbf402d3638
+             */
+            id: string;
             /**
              * @description Lowercase platform identifier, normalized by the service.
              * @example example_platform
              */
             platform: string;
             catalog_etag: string | null;
-            /** @description HTTPS successor document URL, when this mirror has been superseded. */
+            /** @description HTTPS URL. */
             superseded_by: string | null;
+            /** @description SHA-256 digest that reviewers must echo when approving or rejecting this exact revision. */
+            proposal_digest: string;
+            /** @description Digest of the public mirror state this proposal was reviewed against, or null when none existed. */
+            base_mirror_digest: string | null;
+            /** @enum {string} */
+            status: "pending" | "approved" | "rejected";
+            /** Format: date-time */
+            proposed_at: string;
+            /** Format: date-time */
+            reviewed_at: string | null;
+            /** Format: date-time */
+            published_at: string | null;
             /** Format: date-time */
             updated_at: string;
         };
@@ -2741,16 +2841,44 @@ export interface components {
             /** @description Seconds to wait before retrying. */
             retryAfter?: number;
         };
-        CommunityMirrorGetResponse: {
+        CommunityMirrorProposalGetResponse: {
+            proposal: components["schemas"]["CommunityMirrorProposal"];
+        };
+        CommunityMirrorProposal: {
+            /**
+             * Format: uuid
+             * @description Opaque identifier for the proposal.
+             * @example 4ec8bc86-6180-4d0e-aa72-9cbf402d3638
+             */
+            id: string;
             /**
              * @description Lowercase platform identifier, normalized by the service.
              * @example example_platform
              */
             platform: string;
+            adagents_json: components["schemas"]["CommunityMirrorAdagentsJson"];
             catalog_etag: string | null;
-            /** @description HTTPS successor document URL, when this mirror has been superseded. */
+            /** @description HTTPS URL. */
             superseded_by: string | null;
-            adagents_json: components["schemas"]["CommunityMirrorAdagentsJson"];
+            /** @description SHA-256 digest that reviewers must echo when approving or rejecting this exact revision. */
+            proposal_digest: string;
+            /** @description Digest of the public mirror state this proposal was reviewed against, or null when none existed. */
+            base_mirror_digest: string | null;
+            /** @enum {string} */
+            status: "pending" | "approved" | "rejected";
+            proposed_by_organization_id: string | null;
+            /**
+             * Format: email
+             * @description Contributor email, returned only to registry moderators and AgenticAdvertising.org administrators.
+             */
+            proposed_by_email?: string | null;
+            /** Format: date-time */
+            proposed_at: string;
+            /** Format: date-time */
+            reviewed_at: string | null;
+            review_notes: string | null;
+            /** Format: date-time */
+            published_at: string | null;
             /** Format: date-time */
             created_at: string;
             /** Format: date-time */
@@ -2791,6 +2919,14 @@ export interface components {
         } & {
             [key: string]: unknown;
         };
+        CommunityMirrorProposalApprovalResponse: components["schemas"]["CommunityMirrorPublishResponse"] & {
+            /**
+             * Format: uuid
+             * @description Opaque identifier for the proposal.
+             * @example 4ec8bc86-6180-4d0e-aa72-9cbf402d3638
+             */
+            proposal_id: string;
+        };
         CommunityMirrorPublishResponse: {
             /** @enum {boolean} */
             success: true;
@@ -2812,6 +2948,75 @@ export interface components {
             /** @description Validation details for request-body parse failures or adagents.json conformance errors. */
             details?: unknown[];
         };
+        CommunityMirrorProposalReviewRequest: {
+            /** @description SHA-256 digest that reviewers must echo when approving or rejecting this exact revision. */
+            proposal_digest: string;
+            review_notes?: string;
+        };
+        CommunityMirrorProposalDecisionResponse: {
+            /** @enum {boolean} */
+            success: true;
+            proposal: components["schemas"]["CommunityMirrorProposal"];
+        };
+        CommunityMirrorProposalRejectRequest: {
+            /** @description SHA-256 digest that reviewers must echo when approving or rejecting this exact revision. */
+            proposal_digest: string;
+            review_notes: string;
+        };
+        CommunityMirrorListResponse: {
+            mirrors: components["schemas"]["CommunityMirrorSummary"][];
+            total: number;
+        };
+        CommunityMirrorSummary: {
+            /**
+             * @description Lowercase platform identifier, normalized by the service.
+             * @example example_platform
+             */
+            platform: string;
+            catalog_etag: string | null;
+            /** @description HTTPS successor document URL, when this mirror has been superseded. */
+            superseded_by: string | null;
+            /** Format: date-time */
+            updated_at: string;
+        };
+        CommunityMirrorGetResponse: {
+            /**
+             * @description Lowercase platform identifier, normalized by the service.
+             * @example example_platform
+             */
+            platform: string;
+            catalog_etag: string | null;
+            /** @description HTTPS successor document URL, when this mirror has been superseded. */
+            superseded_by: string | null;
+            adagents_json: components["schemas"]["CommunityMirrorAdagentsJson"];
+            /** Format: date-time */
+            created_at: string;
+            /** Format: date-time */
+            updated_at: string;
+        };
+        CommunityMirrorProposalSubmissionResponse: {
+            /** @enum {boolean} */
+            success: true;
+            /** @enum {string} */
+            status: "pending";
+            /**
+             * Format: uuid
+             * @description Opaque identifier for the proposal.
+             * @example 4ec8bc86-6180-4d0e-aa72-9cbf402d3638
+             */
+            proposal_id: string;
+            /** @description SHA-256 digest that reviewers must echo when approving or rejecting this exact revision. */
+            proposal_digest: string;
+            /**
+             * @description Lowercase platform identifier, normalized by the service.
+             * @example example_platform
+             */
+            platform: string;
+            /** @description Authenticated API path for fetching proposal status and content. */
+            status_url: string;
+            /** Format: date-time */
+            submitted_at: string;
+        };
         /** @description Catalog-only adagents.json body for a community mirror. At least one of `formats`, `properties`, `placements`, `collections`, or `signals` must be present and non-empty. The service regenerates `$schema` and `last_updated` before persisting. */
         CommunityMirrorPublishRequest: ({
             catalog_etag?: string;
@@ -3759,7 +3964,7 @@ export interface components {
              * @description Stable rejection tag. UI maps this to operator-friendly prose.
              * @enum {string}
              */
-            code: "invalid_blob_shape" | "missing_field" | "invalid_field_type" | "field_too_long" | "invalid_url" | "invalid_env_reference" | "invalid_auth_method_value";
+            code: "invalid_blob_shape" | "missing_field" | "invalid_field_type" | "field_too_long" | "invalid_url" | "invalid_env_reference" | "invalid_auth_method_value" | "array_too_many" | "array_too_few" | "aggregate_too_long";
             /**
              * @description Field the UI should scroll to + highlight.
              * @enum {string}
@@ -5103,9 +5308,9 @@ export interface operations {
                 capabilities?: "true";
                 properties?: "true";
                 compliance?: "true";
-                /** @description Measurement-vendor filter: exact match on `measurement.metrics[].metric_id`. Repeatable (each value is OR'd within the param, AND'd with other filters). Implies `type=measurement`. */
+                /** @description Measurement-vendor filter: exact match on `measurement.metrics[].metric_id`. Repeatable; multiple values are AND'd (vendor must carry all named metrics). When combined with `accreditation`, a cross-product AND applies — each (metric_id, accreditation) pair must be covered by the same metrics element. Duplicate values are ignored. Maximum 20 unique values; maximum 100 cross-product pairs. Implies `type=measurement`. */
                 metric_id?: string | string[];
-                /** @description Measurement-vendor filter: exact match on `measurement.metrics[].accreditations[].accrediting_body` (e.g. `MRC`, `JIC`, `ARF`). Repeatable. Implies `type=measurement`. Accreditation claims are vendor-asserted; AAO does not independently verify (`verified_by_aao` is always `false` in the response). */
+                /** @description Measurement-vendor filter: exact match on `measurement.metrics[].accreditations[].accrediting_body` (e.g. `MRC`, `JIC`, `ARF`). Repeatable; multiple values are AND'd. When combined with `metric_id`, a cross-product AND applies — see `metric_id` description. Duplicate values are ignored. Maximum 20 unique values; maximum 100 cross-product pairs. Implies `type=measurement`. Accreditation claims are vendor-asserted; AAO does not independently verify (`verified_by_aao` is always `false` in the response). */
                 accreditation?: string | string[];
                 /** @description Measurement-vendor filter: case-insensitive substring match against `measurement.metrics[].metric_id`. v1 scope: metric_id only (description/standard search is a follow-up). Max 64 chars; SQL wildcard characters are escaped. Implies `type=measurement`. */
                 q?: string;
@@ -5829,6 +6034,322 @@ export interface operations {
             };
         };
     };
+    listCommunityMirrorProposals: {
+        parameters: {
+            query?: {
+                status?: "pending" | "approved" | "rejected";
+                /** @description Set to `true` for the cross-organization moderator queue; non-moderators receive 403. */
+                review_queue?: "true" | "false";
+                limit?: number;
+                offset?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Community mirror proposal list */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CommunityMirrorProposalListResponse"];
+                };
+            };
+            /** @description Invalid status */
+            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 Moderator access required for the review queue */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Rate limit exceeded */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RateLimitError"];
+                };
+            };
+            /** @description Failed to list proposals */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    getCommunityMirrorProposal: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Community mirror proposal */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CommunityMirrorProposalGetResponse"];
+                };
+            };
+            /** @description Invalid proposal identifier */
+            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 Proposal not found or not visible to the caller */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Rate limit exceeded */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RateLimitError"];
+                };
+            };
+            /** @description Failed to read proposal */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    approveCommunityMirrorProposal: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CommunityMirrorProposalReviewRequest"];
+            };
+        };
+        responses: {
+            /** @description Proposal approved and mirror published */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CommunityMirrorProposalApprovalResponse"];
+                };
+            };
+            /** @description Invalid identifier, review body, or stale schema conformance */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CommunityMirrorPublishError"];
+                };
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Reviewer role required */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Proposal not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Proposal changed after review, its base mirror is stale, or it was already reviewed */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Rate limit exceeded */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RateLimitError"];
+                };
+            };
+            /** @description Failed to approve proposal */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    rejectCommunityMirrorProposal: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CommunityMirrorProposalRejectRequest"];
+            };
+        };
+        responses: {
+            /** @description Proposal rejected */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CommunityMirrorProposalDecisionResponse"];
+                };
+            };
+            /** @description Invalid identifier or review body */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CommunityMirrorPublishError"];
+                };
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Reviewer role required */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Proposal not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Proposal changed after review or was already reviewed */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Rate limit exceeded */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RateLimitError"];
+                };
+            };
+            /** @description Failed to reject proposal */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
     listCommunityMirrors: {
         parameters: {
             query?: {
@@ -5956,6 +6477,15 @@ export interface operations {
                     "application/json": components["schemas"]["CommunityMirrorPublishResponse"];
                 };
             };
+            /** @description Community mirror proposal accepted for review */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CommunityMirrorProposalSubmissionResponse"];
+                };
+            };
             /** @description Invalid platform, request body, or adagents.json conformance failure */
             400: {
                 headers: {
@@ -5974,7 +6504,7 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Only registry moderators or AgenticAdvertising.org admins can manage community mirrors */
+            /** @description Organization context required for community proposals */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -5983,6 +6513,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Proposal body or catalog item count exceeds the contributor limit */
+            413: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Rate limit exceeded */
             429: {
                 headers: {
@@ -8429,8 +8968,8 @@ export interface operations {
                     client_secret: string;
                     /** @description Space-separated OAuth scope values. */
                     scope?: string;
-                    /** @description RFC 8707 resource indicator. */
-                    resource?: string;
+                    /** @description RFC 8707 resource indicator. Accepts a single URI string or an array of 1–8 URI strings for multi-resource authorization servers (Keycloak strict, AWS Cognito multi-RS). */
+                    resource?: string | string[];
                     /** @description Audience parameter for audience-validating authorization servers. */
                     audience?: string;
                     /**