@adcp/sdk 13.0.0-rc.3 → 13.0.0-rc.5

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

@@ -31,6 +31,8 @@ export interface paths {
          * @description Resolve a domain to its canonical brand identity. Follows brand.json redirects and returns the resolved brand with its house, architecture type, and optional manifest. The domain must be a bare DNS hostname.
          *
          *     A domain is authoritative for its own identity, so `source` tells you who published the record and `relationship_trust` tells you whether a brand-to-house relationship was confirmed by both sides. Only `mutual` and `inline` are reciprocated; treat everything else as a claim.
+         *     Record selection is deterministic: `hosted` > `brand_json` > `community` > `enriched`. `source` reports provenance only and must not be used as a substitute for `relationship_trust`.
+         *     The v3 hierarchy is one level deep. There is no ordered-chain endpoint: third-party verifiers use the reciprocated `house_domain` edge returned here. `claimed_house_domain` is unilateral and never extends trust.
          *
          *     **Rate limit:** 60 requests per minute per IP address.
          */
@@ -748,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;
@@ -781,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;
@@ -2110,21 +2192,29 @@ export interface components {
             keller_type?: "master" | "sub_brand" | "endorsed" | "independent";
             parent_brand?: string;
             house_domain?: string;
-            /** @description House the requested domain claims. One-sided until the named house names it back, so it never extends relationship trust on its own. */
+            /** @description House the requested domain claims. This field never extends trust on its own; `relationship_trust` reports whether the reciprocal declaration is current enough to do so. */
             claimed_house_domain?: string;
             house_name?: string;
             /**
-             * @description How the brand-to-house relationship was established. `inline`: the house's own document defines the brand. `mutual`: both sides publish the relationship — the trust-extending edge. `leaf_only`: the brand claims a house that has not reciprocated. `house_only`: a house claims the brand, which has not reciprocated. `standalone`: the brand claims no house. `unverifiable`: a claimed house could not be checked.
+             * @description How the brand-to-house relationship was established. `inline`: the house's own document defines the brand. `mutual`: both sides publish the relationship — the trust-extending edge. `leaf_only`: the brand claims a house whose reciprocal declaration is missing, not yet active, or too old to extend trust. `house_only`: a house claims the brand, which has not reciprocated. `standalone`: the brand claims no house. `unverifiable`: a claimed house could not be checked.
              * @enum {string}
              */
             relationship_trust?: "inline" | "mutual" | "leaf_only" | "house_only" | "standalone" | "unverifiable";
             /**
+             * Format: date-time
              * @description When both sides of a mutual relationship were last seen agreeing. Present only for `mutual`, and it does not advance while the house side is unreachable, so callers can apply their own edge-aging policy.
              * @example 2026-07-28T12:00:00Z
              */
             relationship_verified_at?: string;
+            /**
+             * Format: date-time
+             * @description When the house declared the relationship in `brand_refs[].effective_at`, or the resolver's durable first observation if the publisher omitted that field. Callers can apply a declaration-age ceiling independently of `relationship_verified_at`.
+             * @example 2026-01-29T12:00:00Z
+             */
+            relationship_declared_at?: string;
             /** @description Set when a pre-v3 document was promoted to a canonical v3 document for this response. Identity only — legacy relationship data is preserved opaquely, never promoted to a trust claim. */
             promoted_from_schema?: string;
+            /** @description Loss or ambiguity encountered while promoting a pre-v3 document. A `house` warning means the legacy house object was preserved only as opaque metadata and did not establish a trusted relationship. */
             migration_warnings?: {
                 field: string;
                 message: string;
@@ -2135,11 +2225,11 @@ export interface components {
                 [key: string]: unknown;
             };
             /**
-             * @description Where the record came from. `brand_json`: the domain's own /.well-known/brand.json. `hosted`: registered by an owner whose control of the domain was verified. `community`: contributed by a member. `enriched`: third-party enrichment.
+             * @description Provenance of the selected record, not relationship authorization. Deterministic precedence is `hosted` > `brand_json` > `community` > `enriched`; normal reads prefer the durable stored winner on a source tie, while `fresh=true` lets a successful live origin read win a tie. `brand_json`: the domain's own /.well-known/brand.json. `hosted`: registered by an owner whose control of the domain was verified. `community`: contributed by a member. `enriched`: third-party enrichment.
              * @enum {string}
              */
             source: "hosted" | "brand_json" | "community" | "enriched";
-            /** @description Live origin-validation diagnostics when fresh=true falls back to a stored registry record. */
+            /** @description This request's origin-validation diagnostics when `fresh=true` falls back to a stored registry record. Presence means the response is stored evidence, not a successful live-origin read. */
             live_brand_json?: {
                 valid: boolean;
                 url: string;
@@ -2709,19 +2799,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;
         };
@@ -2731,16 +2839,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 */
@@ -2781,6 +2917,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;
@@ -2802,6 +2946,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;
@@ -5819,6 +6032,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?: {
@@ -5946,6 +6475,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: {
@@ -5964,7 +6502,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;
@@ -5973,6 +6511,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: {
@@ -8845,10 +9392,15 @@ export interface operations {
                     /** @example acmecorp.com */
                     domain: string;
                     brand_name: string;
-                    /** @description Optional full brand.json draft to host in the registry */
+                    /** @description Optional full brand.json draft to host in the registry. Every recognized logo URL must be an absolute HTTPS URL of at most 2048 characters without userinfo credentials, backslashes, or markup-significant characters. The primary brand color must use #RRGGBB format. */
                     brand_json?: {
                         [key: string]: unknown;
                     };
+                    /**
+                     * Format: uri
+                     * @description Absolute HTTPS URL for the brand logo. Userinfo credentials, backslashes, and markup-significant characters are not allowed.
+                     * @example https://cdn.example.com/brand/logo.svg
+                     */
                     logo_url?: string;
                     brand_color?: string;
                 };