@nuxtseo/protocol 0.1.0

package/dist/v1/backlinks.d.ts

@@ -0,0 +1,1002 @@
+import type { z } from 'zod';
+export declare const backlinksSiteParamsSchema: z.ZodObject<{
+    siteId: z.ZodString;
+}, z.core.$strict>;
+export declare const backlinksPageQuerySchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    offset: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>;
+/**
+ * One inbound link whose destination is broken. `destinationStatus` is the
+ * status the destination answered with when the provider last checked, so a
+ * consumer can separate a 404 from a 5xx without refetching.
+ */
+export declare const recoverableBacklinkSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly id: z.ZodString;
+    readonly destinationUrl: z.ZodString;
+    readonly referringUrl: z.ZodString;
+    readonly referringDomain: z.ZodString;
+    readonly anchor: z.ZodNullable<z.ZodString>;
+    readonly destinationStatus: z.ZodNullable<z.ZodNumber>;
+    readonly domainRank: z.ZodNullable<z.ZodNumber>;
+    readonly pageRank: z.ZodNullable<z.ZodNumber>;
+    readonly dofollow: z.ZodNullable<z.ZodBoolean>;
+    readonly firstSeenAt: z.ZodNullable<z.ZodString>;
+    readonly lastSeenAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    readonly id: z.ZodString;
+    readonly destinationUrl: z.ZodString;
+    readonly referringUrl: z.ZodString;
+    readonly referringDomain: z.ZodString;
+    readonly anchor: z.ZodNullable<z.ZodString>;
+    readonly destinationStatus: z.ZodNullable<z.ZodNumber>;
+    readonly domainRank: z.ZodNullable<z.ZodNumber>;
+    readonly pageRank: z.ZodNullable<z.ZodNumber>;
+    readonly dofollow: z.ZodNullable<z.ZodBoolean>;
+    readonly firstSeenAt: z.ZodNullable<z.ZodString>;
+    readonly lastSeenAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>>;
+export declare const recoverableBacklinksDataSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly items: z.ZodArray<z.ZodObject<{
+        readonly id: z.ZodString;
+        readonly destinationUrl: z.ZodString;
+        readonly referringUrl: z.ZodString;
+        readonly referringDomain: z.ZodString;
+        readonly anchor: z.ZodNullable<z.ZodString>;
+        readonly destinationStatus: z.ZodNullable<z.ZodNumber>;
+        readonly domainRank: z.ZodNullable<z.ZodNumber>;
+        readonly pageRank: z.ZodNullable<z.ZodNumber>;
+        readonly dofollow: z.ZodNullable<z.ZodBoolean>;
+        readonly firstSeenAt: z.ZodNullable<z.ZodString>;
+        readonly lastSeenAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    readonly total: z.ZodNumber;
+    readonly limit: z.ZodNumber;
+    readonly offset: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    readonly items: z.ZodArray<z.ZodObject<{
+        readonly id: z.ZodString;
+        readonly destinationUrl: z.ZodString;
+        readonly referringUrl: z.ZodString;
+        readonly referringDomain: z.ZodString;
+        readonly anchor: z.ZodNullable<z.ZodString>;
+        readonly destinationStatus: z.ZodNullable<z.ZodNumber>;
+        readonly domainRank: z.ZodNullable<z.ZodNumber>;
+        readonly pageRank: z.ZodNullable<z.ZodNumber>;
+        readonly dofollow: z.ZodNullable<z.ZodBoolean>;
+        readonly firstSeenAt: z.ZodNullable<z.ZodString>;
+        readonly lastSeenAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    readonly total: z.ZodNumber;
+    readonly limit: z.ZodNumber;
+    readonly offset: z.ZodNumber;
+}, z.core.$strip>>;
+export declare const recoverableBacklinksResponseSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    data: z.ZodObject<{
+        readonly items: z.ZodArray<z.ZodObject<{
+            readonly id: z.ZodString;
+            readonly destinationUrl: z.ZodString;
+            readonly referringUrl: z.ZodString;
+            readonly referringDomain: z.ZodString;
+            readonly anchor: z.ZodNullable<z.ZodString>;
+            readonly destinationStatus: z.ZodNullable<z.ZodNumber>;
+            readonly domainRank: z.ZodNullable<z.ZodNumber>;
+            readonly pageRank: z.ZodNullable<z.ZodNumber>;
+            readonly dofollow: z.ZodNullable<z.ZodBoolean>;
+            readonly firstSeenAt: z.ZodNullable<z.ZodString>;
+            readonly lastSeenAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        readonly total: z.ZodNumber;
+        readonly limit: z.ZodNumber;
+        readonly offset: z.ZodNumber;
+    }, z.core.$strip>;
+    meta: z.ZodObject<{
+        requestId: z.ZodString;
+        version: z.ZodLiteral<"1.0">;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    data: z.ZodObject<{
+        readonly items: z.ZodArray<z.ZodObject<{
+            readonly id: z.ZodString;
+            readonly destinationUrl: z.ZodString;
+            readonly referringUrl: z.ZodString;
+            readonly referringDomain: z.ZodString;
+            readonly anchor: z.ZodNullable<z.ZodString>;
+            readonly destinationStatus: z.ZodNullable<z.ZodNumber>;
+            readonly domainRank: z.ZodNullable<z.ZodNumber>;
+            readonly pageRank: z.ZodNullable<z.ZodNumber>;
+            readonly dofollow: z.ZodNullable<z.ZodBoolean>;
+            readonly firstSeenAt: z.ZodNullable<z.ZodString>;
+            readonly lastSeenAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        readonly total: z.ZodNumber;
+        readonly limit: z.ZodNumber;
+        readonly offset: z.ZodNumber;
+    }, z.core.$strip>;
+    meta: z.ZodObject<{
+        requestId: z.ZodString;
+        version: z.ZodLiteral<"1.0">;
+    }, z.core.$loose>;
+}, z.core.$strip>>;
+export type RecoverableBacklinks = z.output<typeof recoverableBacklinksDataSchema.producer>;
+export declare const recoverableBacklinksOperation: {
+    readonly id: 'backlinks.recoverable';
+    readonly method: 'GET';
+    readonly path: '/api/v1/sites/{siteId}/backlinks/recoverable';
+    readonly visibility: 'public';
+    readonly semantics: {
+        readonly kind: 'query';
+        readonly sideEffects: 'none';
+        readonly retry: 'idempotent';
+        readonly readConsistency: 'primary';
+    };
+    readonly auth: {
+        readonly credentials: readonly ["session", "api_token"];
+        readonly scopes: readonly ["research:read"];
+        readonly minimumRole: 'viewer';
+        readonly ownership: 'site';
+    };
+    readonly request: {
+        readonly params: z.ZodObject<{
+            siteId: z.ZodString;
+        }, z.core.$strict>;
+        readonly query: z.ZodObject<{
+            limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+            offset: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+        }, z.core.$strict>;
+        readonly headers: null;
+        readonly body: null;
+    };
+    readonly responses: {
+        readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+            data: z.ZodObject<{
+                readonly items: z.ZodArray<z.ZodObject<{
+                    readonly id: z.ZodString;
+                    readonly destinationUrl: z.ZodString;
+                    readonly referringUrl: z.ZodString;
+                    readonly referringDomain: z.ZodString;
+                    readonly anchor: z.ZodNullable<z.ZodString>;
+                    readonly destinationStatus: z.ZodNullable<z.ZodNumber>;
+                    readonly domainRank: z.ZodNullable<z.ZodNumber>;
+                    readonly pageRank: z.ZodNullable<z.ZodNumber>;
+                    readonly dofollow: z.ZodNullable<z.ZodBoolean>;
+                    readonly firstSeenAt: z.ZodNullable<z.ZodString>;
+                    readonly lastSeenAt: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>>;
+                readonly total: z.ZodNumber;
+                readonly limit: z.ZodNumber;
+                readonly offset: z.ZodNumber;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+                requestId: z.ZodString;
+                version: z.ZodLiteral<"1.0">;
+            }, z.core.$strict>;
+        }, z.core.$strip>, z.ZodObject<{
+            data: z.ZodObject<{
+                readonly items: z.ZodArray<z.ZodObject<{
+                    readonly id: z.ZodString;
+                    readonly destinationUrl: z.ZodString;
+                    readonly referringUrl: z.ZodString;
+                    readonly referringDomain: z.ZodString;
+                    readonly anchor: z.ZodNullable<z.ZodString>;
+                    readonly destinationStatus: z.ZodNullable<z.ZodNumber>;
+                    readonly domainRank: z.ZodNullable<z.ZodNumber>;
+                    readonly pageRank: z.ZodNullable<z.ZodNumber>;
+                    readonly dofollow: z.ZodNullable<z.ZodBoolean>;
+                    readonly firstSeenAt: z.ZodNullable<z.ZodString>;
+                    readonly lastSeenAt: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>>;
+                readonly total: z.ZodNumber;
+                readonly limit: z.ZodNumber;
+                readonly offset: z.ZodNumber;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+                requestId: z.ZodString;
+                version: z.ZodLiteral<"1.0">;
+            }, z.core.$loose>;
+        }, z.core.$strip>>;
+    };
+    readonly errors: readonly ["invalid_request", "unauthorized", "auth_expired", "forbidden", "not_found", "rate_limited", "contract_violation", "internal_error"];
+    readonly errorResponse: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+        readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+                auth_expired: "auth_expired";
+                conflict: "conflict";
+                contract_violation: "contract_violation";
+                entitlement_required: "entitlement_required";
+                forbidden: "forbidden";
+                internal_error: "internal_error";
+                invalid_request: "invalid_request";
+                not_found: "not_found";
+                provider_unavailable: "provider_unavailable";
+                quota_exhausted: "quota_exhausted";
+                rate_limited: "rate_limited";
+                site_ambiguous: "site_ambiguous";
+                stale_evidence: "stale_evidence";
+                unauthorized: "unauthorized";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strict>;
+    }, z.core.$strip>, z.ZodObject<{
+        readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+                auth_expired: "auth_expired";
+                conflict: "conflict";
+                contract_violation: "contract_violation";
+                entitlement_required: "entitlement_required";
+                forbidden: "forbidden";
+                internal_error: "internal_error";
+                invalid_request: "invalid_request";
+                not_found: "not_found";
+                provider_unavailable: "provider_unavailable";
+                quota_exhausted: "quota_exhausted";
+                rate_limited: "rate_limited";
+                site_ambiguous: "site_ambiguous";
+                stale_evidence: "stale_evidence";
+                unauthorized: "unauthorized";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$loose>;
+    }, z.core.$strip>>;
+    readonly resources: {
+        readonly reads: readonly [{
+            readonly type: 'site.research';
+            readonly idFrom: 'params.siteId';
+        }];
+        readonly changes: readonly [];
+    };
+    readonly policy: {
+        readonly rate: {
+            readonly name: 'public-v1-fixed-window';
+            readonly limit: 50;
+            readonly windowSeconds: 60;
+        };
+        readonly idempotency: {
+            readonly _tag: 'none';
+        };
+        readonly entitlement: null;
+        readonly meter: null;
+    };
+    readonly lifecycle: {
+        readonly introduced: '1.1.0';
+    };
+    readonly docs: {
+        readonly summary: 'List recoverable Backlinks';
+        readonly description: 'Returns retained inbound links whose destination is broken, ranked by referring domain authority. Each item carries the referring URL and the destination URL, so a redirect can be written without a crawl. It never starts provider work and does not consume metered units.';
+        readonly tags: readonly ["Research"];
+        readonly examples: readonly [{
+            readonly request: {
+                readonly params: {
+                    readonly siteId: 'site_01JXYZ';
+                };
+                readonly query: {
+                    readonly limit: 100;
+                    readonly offset: 0;
+                };
+            };
+            readonly response: {
+                readonly status: 200;
+                readonly body: {
+                    readonly data: {
+                        readonly items: readonly [{
+                            readonly id: 'bl_01JXYZ';
+                            readonly destinationUrl: 'https://example.com/docs/utils';
+                            readonly referringUrl: 'https://news.example/posts/seo';
+                            readonly referringDomain: 'news.example';
+                            readonly anchor: 'Read the full documentation';
+                            readonly destinationStatus: 404;
+                            readonly domainRank: 529;
+                            readonly pageRank: 55;
+                            readonly dofollow: true;
+                            readonly firstSeenAt: '2026-02-09T20:43:50.000Z';
+                            readonly lastSeenAt: '2026-07-17T04:40:07.000Z';
+                        }];
+                        readonly total: 1;
+                        readonly limit: 100;
+                        readonly offset: 0;
+                    };
+                    readonly meta: {
+                        readonly requestId: 'req_01JXYZ';
+                        readonly version: '1.0';
+                    };
+                };
+            };
+        }];
+    };
+};
+export declare const backlinksV1Registry: import("./core.js").PublicV1Registry<{
+    readonly recoverable: {
+        readonly id: 'backlinks.recoverable';
+        readonly method: 'GET';
+        readonly path: '/api/v1/sites/{siteId}/backlinks/recoverable';
+        readonly visibility: 'public';
+        readonly semantics: {
+            readonly kind: 'query';
+            readonly sideEffects: 'none';
+            readonly retry: 'idempotent';
+            readonly readConsistency: 'primary';
+        };
+        readonly auth: {
+            readonly credentials: readonly ["session", "api_token"];
+            readonly scopes: readonly ["research:read"];
+            readonly minimumRole: 'viewer';
+            readonly ownership: 'site';
+        };
+        readonly request: {
+            readonly params: z.ZodObject<{
+                siteId: z.ZodString;
+            }, z.core.$strict>;
+            readonly query: z.ZodObject<{
+                limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+                offset: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+            }, z.core.$strict>;
+            readonly headers: null;
+            readonly body: null;
+        };
+        readonly responses: {
+            readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+                data: z.ZodObject<{
+                    readonly items: z.ZodArray<z.ZodObject<{
+                        readonly id: z.ZodString;
+                        readonly destinationUrl: z.ZodString;
+                        readonly referringUrl: z.ZodString;
+                        readonly referringDomain: z.ZodString;
+                        readonly anchor: z.ZodNullable<z.ZodString>;
+                        readonly destinationStatus: z.ZodNullable<z.ZodNumber>;
+                        readonly domainRank: z.ZodNullable<z.ZodNumber>;
+                        readonly pageRank: z.ZodNullable<z.ZodNumber>;
+                        readonly dofollow: z.ZodNullable<z.ZodBoolean>;
+                        readonly firstSeenAt: z.ZodNullable<z.ZodString>;
+                        readonly lastSeenAt: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>>;
+                    readonly total: z.ZodNumber;
+                    readonly limit: z.ZodNumber;
+                    readonly offset: z.ZodNumber;
+                }, z.core.$strip>;
+                meta: z.ZodObject<{
+                    requestId: z.ZodString;
+                    version: z.ZodLiteral<"1.0">;
+                }, z.core.$strict>;
+            }, z.core.$strip>, z.ZodObject<{
+                data: z.ZodObject<{
+                    readonly items: z.ZodArray<z.ZodObject<{
+                        readonly id: z.ZodString;
+                        readonly destinationUrl: z.ZodString;
+                        readonly referringUrl: z.ZodString;
+                        readonly referringDomain: z.ZodString;
+                        readonly anchor: z.ZodNullable<z.ZodString>;
+                        readonly destinationStatus: z.ZodNullable<z.ZodNumber>;
+                        readonly domainRank: z.ZodNullable<z.ZodNumber>;
+                        readonly pageRank: z.ZodNullable<z.ZodNumber>;
+                        readonly dofollow: z.ZodNullable<z.ZodBoolean>;
+                        readonly firstSeenAt: z.ZodNullable<z.ZodString>;
+                        readonly lastSeenAt: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>>;
+                    readonly total: z.ZodNumber;
+                    readonly limit: z.ZodNumber;
+                    readonly offset: z.ZodNumber;
+                }, z.core.$strip>;
+                meta: z.ZodObject<{
+                    requestId: z.ZodString;
+                    version: z.ZodLiteral<"1.0">;
+                }, z.core.$loose>;
+            }, z.core.$strip>>;
+        };
+        readonly errors: readonly ["invalid_request", "unauthorized", "auth_expired", "forbidden", "not_found", "rate_limited", "contract_violation", "internal_error"];
+        readonly errorResponse: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+            readonly error: z.ZodObject<{
+                code: z.ZodEnum<{
+                    auth_expired: "auth_expired";
+                    conflict: "conflict";
+                    contract_violation: "contract_violation";
+                    entitlement_required: "entitlement_required";
+                    forbidden: "forbidden";
+                    internal_error: "internal_error";
+                    invalid_request: "invalid_request";
+                    not_found: "not_found";
+                    provider_unavailable: "provider_unavailable";
+                    quota_exhausted: "quota_exhausted";
+                    rate_limited: "rate_limited";
+                    site_ambiguous: "site_ambiguous";
+                    stale_evidence: "stale_evidence";
+                    unauthorized: "unauthorized";
+                }>;
+                message: z.ZodString;
+                requestId: z.ZodString;
+                retryable: z.ZodBoolean;
+                details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strict>;
+        }, z.core.$strip>, z.ZodObject<{
+            readonly error: z.ZodObject<{
+                code: z.ZodEnum<{
+                    auth_expired: "auth_expired";
+                    conflict: "conflict";
+                    contract_violation: "contract_violation";
+                    entitlement_required: "entitlement_required";
+                    forbidden: "forbidden";
+                    internal_error: "internal_error";
+                    invalid_request: "invalid_request";
+                    not_found: "not_found";
+                    provider_unavailable: "provider_unavailable";
+                    quota_exhausted: "quota_exhausted";
+                    rate_limited: "rate_limited";
+                    site_ambiguous: "site_ambiguous";
+                    stale_evidence: "stale_evidence";
+                    unauthorized: "unauthorized";
+                }>;
+                message: z.ZodString;
+                requestId: z.ZodString;
+                retryable: z.ZodBoolean;
+                details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$loose>;
+        }, z.core.$strip>>;
+        readonly resources: {
+            readonly reads: readonly [{
+                readonly type: 'site.research';
+                readonly idFrom: 'params.siteId';
+            }];
+            readonly changes: readonly [];
+        };
+        readonly policy: {
+            readonly rate: {
+                readonly name: 'public-v1-fixed-window';
+                readonly limit: 50;
+                readonly windowSeconds: 60;
+            };
+            readonly idempotency: {
+                readonly _tag: 'none';
+            };
+            readonly entitlement: null;
+            readonly meter: null;
+        };
+        readonly lifecycle: {
+            readonly introduced: '1.1.0';
+        };
+        readonly docs: {
+            readonly summary: 'List recoverable Backlinks';
+            readonly description: 'Returns retained inbound links whose destination is broken, ranked by referring domain authority. Each item carries the referring URL and the destination URL, so a redirect can be written without a crawl. It never starts provider work and does not consume metered units.';
+            readonly tags: readonly ["Research"];
+            readonly examples: readonly [{
+                readonly request: {
+                    readonly params: {
+                        readonly siteId: 'site_01JXYZ';
+                    };
+                    readonly query: {
+                        readonly limit: 100;
+                        readonly offset: 0;
+                    };
+                };
+                readonly response: {
+                    readonly status: 200;
+                    readonly body: {
+                        readonly data: {
+                            readonly items: readonly [{
+                                readonly id: 'bl_01JXYZ';
+                                readonly destinationUrl: 'https://example.com/docs/utils';
+                                readonly referringUrl: 'https://news.example/posts/seo';
+                                readonly referringDomain: 'news.example';
+                                readonly anchor: 'Read the full documentation';
+                                readonly destinationStatus: 404;
+                                readonly domainRank: 529;
+                                readonly pageRank: 55;
+                                readonly dofollow: true;
+                                readonly firstSeenAt: '2026-02-09T20:43:50.000Z';
+                                readonly lastSeenAt: '2026-07-17T04:40:07.000Z';
+                            }];
+                            readonly total: 1;
+                            readonly limit: 100;
+                            readonly offset: 0;
+                        };
+                        readonly meta: {
+                            readonly requestId: 'req_01JXYZ';
+                            readonly version: '1.0';
+                        };
+                    };
+                };
+            }];
+        };
+    };
+}>;
+export declare const mentionsQuerySchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    includeFiltered: z.ZodDefault<z.ZodEnum<{
+        0: "0";
+        1: "1";
+    }>>;
+}, z.core.$strict>;
+export declare const mentionSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly id: z.ZodString;
+    readonly source: z.ZodString;
+    readonly url: z.ZodString;
+    readonly domain: z.ZodString;
+    readonly title: z.ZodNullable<z.ZodString>;
+    readonly snippet: z.ZodNullable<z.ZodString>;
+    readonly author: z.ZodNullable<z.ZodString>;
+    readonly authorHandle: z.ZodNullable<z.ZodString>;
+    readonly engagement: z.ZodNullable<z.ZodNumber>;
+    readonly sentiment: z.ZodNullable<z.ZodString>;
+    readonly domainRank: z.ZodNullable<z.ZodNumber>;
+    readonly publishedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    readonly id: z.ZodString;
+    readonly source: z.ZodString;
+    readonly url: z.ZodString;
+    readonly domain: z.ZodString;
+    readonly title: z.ZodNullable<z.ZodString>;
+    readonly snippet: z.ZodNullable<z.ZodString>;
+    readonly author: z.ZodNullable<z.ZodString>;
+    readonly authorHandle: z.ZodNullable<z.ZodString>;
+    readonly engagement: z.ZodNullable<z.ZodNumber>;
+    readonly sentiment: z.ZodNullable<z.ZodString>;
+    readonly domainRank: z.ZodNullable<z.ZodNumber>;
+    readonly publishedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>>;
+export declare const mentionsDataSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly items: z.ZodArray<z.ZodObject<{
+        readonly id: z.ZodString;
+        readonly source: z.ZodString;
+        readonly url: z.ZodString;
+        readonly domain: z.ZodString;
+        readonly title: z.ZodNullable<z.ZodString>;
+        readonly snippet: z.ZodNullable<z.ZodString>;
+        readonly author: z.ZodNullable<z.ZodString>;
+        readonly authorHandle: z.ZodNullable<z.ZodString>;
+        readonly engagement: z.ZodNullable<z.ZodNumber>;
+        readonly sentiment: z.ZodNullable<z.ZodString>;
+        readonly domainRank: z.ZodNullable<z.ZodNumber>;
+        readonly publishedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    readonly limit: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    readonly items: z.ZodArray<z.ZodObject<{
+        readonly id: z.ZodString;
+        readonly source: z.ZodString;
+        readonly url: z.ZodString;
+        readonly domain: z.ZodString;
+        readonly title: z.ZodNullable<z.ZodString>;
+        readonly snippet: z.ZodNullable<z.ZodString>;
+        readonly author: z.ZodNullable<z.ZodString>;
+        readonly authorHandle: z.ZodNullable<z.ZodString>;
+        readonly engagement: z.ZodNullable<z.ZodNumber>;
+        readonly sentiment: z.ZodNullable<z.ZodString>;
+        readonly domainRank: z.ZodNullable<z.ZodNumber>;
+        readonly publishedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    readonly limit: z.ZodNumber;
+}, z.core.$strip>>;
+export declare const mentionsResponseSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    data: z.ZodObject<{
+        readonly items: z.ZodArray<z.ZodObject<{
+            readonly id: z.ZodString;
+            readonly source: z.ZodString;
+            readonly url: z.ZodString;
+            readonly domain: z.ZodString;
+            readonly title: z.ZodNullable<z.ZodString>;
+            readonly snippet: z.ZodNullable<z.ZodString>;
+            readonly author: z.ZodNullable<z.ZodString>;
+            readonly authorHandle: z.ZodNullable<z.ZodString>;
+            readonly engagement: z.ZodNullable<z.ZodNumber>;
+            readonly sentiment: z.ZodNullable<z.ZodString>;
+            readonly domainRank: z.ZodNullable<z.ZodNumber>;
+            readonly publishedAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        readonly limit: z.ZodNumber;
+    }, z.core.$strip>;
+    meta: z.ZodObject<{
+        requestId: z.ZodString;
+        version: z.ZodLiteral<"1.0">;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    data: z.ZodObject<{
+        readonly items: z.ZodArray<z.ZodObject<{
+            readonly id: z.ZodString;
+            readonly source: z.ZodString;
+            readonly url: z.ZodString;
+            readonly domain: z.ZodString;
+            readonly title: z.ZodNullable<z.ZodString>;
+            readonly snippet: z.ZodNullable<z.ZodString>;
+            readonly author: z.ZodNullable<z.ZodString>;
+            readonly authorHandle: z.ZodNullable<z.ZodString>;
+            readonly engagement: z.ZodNullable<z.ZodNumber>;
+            readonly sentiment: z.ZodNullable<z.ZodString>;
+            readonly domainRank: z.ZodNullable<z.ZodNumber>;
+            readonly publishedAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        readonly limit: z.ZodNumber;
+    }, z.core.$strip>;
+    meta: z.ZodObject<{
+        requestId: z.ZodString;
+        version: z.ZodLiteral<"1.0">;
+    }, z.core.$loose>;
+}, z.core.$strip>>;
+export type Mentions = z.output<typeof mentionsDataSchema.producer>;
+export declare const mentionsListOperation: {
+    readonly id: 'mentions.list';
+    readonly method: 'GET';
+    readonly path: '/api/v1/sites/{siteId}/mentions';
+    readonly visibility: 'public';
+    readonly semantics: {
+        readonly kind: 'query';
+        readonly sideEffects: 'none';
+        readonly retry: 'idempotent';
+        readonly readConsistency: 'primary';
+    };
+    readonly auth: {
+        readonly credentials: readonly ["session", "api_token"];
+        readonly scopes: readonly ["research:read"];
+        readonly minimumRole: 'viewer';
+        readonly ownership: 'site';
+    };
+    readonly request: {
+        readonly params: z.ZodObject<{
+            siteId: z.ZodString;
+        }, z.core.$strict>;
+        readonly query: z.ZodObject<{
+            limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+            includeFiltered: z.ZodDefault<z.ZodEnum<{
+                0: "0";
+                1: "1";
+            }>>;
+        }, z.core.$strict>;
+        readonly headers: null;
+        readonly body: null;
+    };
+    readonly responses: {
+        readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+            data: z.ZodObject<{
+                readonly items: z.ZodArray<z.ZodObject<{
+                    readonly id: z.ZodString;
+                    readonly source: z.ZodString;
+                    readonly url: z.ZodString;
+                    readonly domain: z.ZodString;
+                    readonly title: z.ZodNullable<z.ZodString>;
+                    readonly snippet: z.ZodNullable<z.ZodString>;
+                    readonly author: z.ZodNullable<z.ZodString>;
+                    readonly authorHandle: z.ZodNullable<z.ZodString>;
+                    readonly engagement: z.ZodNullable<z.ZodNumber>;
+                    readonly sentiment: z.ZodNullable<z.ZodString>;
+                    readonly domainRank: z.ZodNullable<z.ZodNumber>;
+                    readonly publishedAt: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>>;
+                readonly limit: z.ZodNumber;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+                requestId: z.ZodString;
+                version: z.ZodLiteral<"1.0">;
+            }, z.core.$strict>;
+        }, z.core.$strip>, z.ZodObject<{
+            data: z.ZodObject<{
+                readonly items: z.ZodArray<z.ZodObject<{
+                    readonly id: z.ZodString;
+                    readonly source: z.ZodString;
+                    readonly url: z.ZodString;
+                    readonly domain: z.ZodString;
+                    readonly title: z.ZodNullable<z.ZodString>;
+                    readonly snippet: z.ZodNullable<z.ZodString>;
+                    readonly author: z.ZodNullable<z.ZodString>;
+                    readonly authorHandle: z.ZodNullable<z.ZodString>;
+                    readonly engagement: z.ZodNullable<z.ZodNumber>;
+                    readonly sentiment: z.ZodNullable<z.ZodString>;
+                    readonly domainRank: z.ZodNullable<z.ZodNumber>;
+                    readonly publishedAt: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>>;
+                readonly limit: z.ZodNumber;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+                requestId: z.ZodString;
+                version: z.ZodLiteral<"1.0">;
+            }, z.core.$loose>;
+        }, z.core.$strip>>;
+    };
+    readonly errors: readonly ["invalid_request", "unauthorized", "auth_expired", "forbidden", "not_found", "rate_limited", "contract_violation", "internal_error"];
+    readonly errorResponse: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+        readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+                auth_expired: "auth_expired";
+                conflict: "conflict";
+                contract_violation: "contract_violation";
+                entitlement_required: "entitlement_required";
+                forbidden: "forbidden";
+                internal_error: "internal_error";
+                invalid_request: "invalid_request";
+                not_found: "not_found";
+                provider_unavailable: "provider_unavailable";
+                quota_exhausted: "quota_exhausted";
+                rate_limited: "rate_limited";
+                site_ambiguous: "site_ambiguous";
+                stale_evidence: "stale_evidence";
+                unauthorized: "unauthorized";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strict>;
+    }, z.core.$strip>, z.ZodObject<{
+        readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+                auth_expired: "auth_expired";
+                conflict: "conflict";
+                contract_violation: "contract_violation";
+                entitlement_required: "entitlement_required";
+                forbidden: "forbidden";
+                internal_error: "internal_error";
+                invalid_request: "invalid_request";
+                not_found: "not_found";
+                provider_unavailable: "provider_unavailable";
+                quota_exhausted: "quota_exhausted";
+                rate_limited: "rate_limited";
+                site_ambiguous: "site_ambiguous";
+                stale_evidence: "stale_evidence";
+                unauthorized: "unauthorized";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$loose>;
+    }, z.core.$strip>>;
+    readonly resources: {
+        readonly reads: readonly [{
+            readonly type: 'site.research';
+            readonly idFrom: 'params.siteId';
+        }];
+        readonly changes: readonly [];
+    };
+    readonly policy: {
+        readonly rate: {
+            readonly name: 'public-v1-fixed-window';
+            readonly limit: 50;
+            readonly windowSeconds: 60;
+        };
+        readonly idempotency: {
+            readonly _tag: 'none';
+        };
+        readonly entitlement: null;
+        readonly meter: null;
+    };
+    readonly lifecycle: {
+        readonly introduced: '1.1.0';
+    };
+    readonly docs: {
+        readonly summary: 'List Mentions';
+        readonly description: 'Returns retained pages and posts that name the Site without linking to it, newest first. Dismissed and lost Mentions are excluded. Pass includeFiltered=1 to keep the ones AI triage marked a false positive. It never starts provider work and does not consume metered units.';
+        readonly tags: readonly ["Research"];
+        readonly examples: readonly [{
+            readonly request: {
+                readonly params: {
+                    readonly siteId: 'site_01JXYZ';
+                };
+                readonly query: {
+                    readonly limit: 100;
+                    readonly includeFiltered: '0';
+                };
+            };
+            readonly response: {
+                readonly status: 200;
+                readonly body: {
+                    readonly data: {
+                        readonly items: readonly [{
+                            readonly id: 'mn_01JXYZ';
+                            readonly source: 'hackernews';
+                            readonly url: 'https://news.ycombinator.com/item?id=1';
+                            readonly domain: 'news.ycombinator.com';
+                            readonly title: 'Show HN: a sitemap module';
+                            readonly snippet: 'We moved to example.com last week';
+                            readonly author: 'Ada Lovelace';
+                            readonly authorHandle: 'ada';
+                            readonly engagement: 142;
+                            readonly sentiment: 'positive';
+                            readonly domainRank: 812;
+                            readonly publishedAt: '2026-08-01T09:12:00.000Z';
+                        }];
+                        readonly limit: 100;
+                    };
+                    readonly meta: {
+                        readonly requestId: 'req_01JXYZ';
+                        readonly version: '1.0';
+                    };
+                };
+            };
+        }];
+    };
+};
+export declare const mentionsV1Registry: import("./core.js").PublicV1Registry<{
+    readonly list: {
+        readonly id: 'mentions.list';
+        readonly method: 'GET';
+        readonly path: '/api/v1/sites/{siteId}/mentions';
+        readonly visibility: 'public';
+        readonly semantics: {
+            readonly kind: 'query';
+            readonly sideEffects: 'none';
+            readonly retry: 'idempotent';
+            readonly readConsistency: 'primary';
+        };
+        readonly auth: {
+            readonly credentials: readonly ["session", "api_token"];
+            readonly scopes: readonly ["research:read"];
+            readonly minimumRole: 'viewer';
+            readonly ownership: 'site';
+        };
+        readonly request: {
+            readonly params: z.ZodObject<{
+                siteId: z.ZodString;
+            }, z.core.$strict>;
+            readonly query: z.ZodObject<{
+                limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+                includeFiltered: z.ZodDefault<z.ZodEnum<{
+                    0: "0";
+                    1: "1";
+                }>>;
+            }, z.core.$strict>;
+            readonly headers: null;
+            readonly body: null;
+        };
+        readonly responses: {
+            readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+                data: z.ZodObject<{
+                    readonly items: z.ZodArray<z.ZodObject<{
+                        readonly id: z.ZodString;
+                        readonly source: z.ZodString;
+                        readonly url: z.ZodString;
+                        readonly domain: z.ZodString;
+                        readonly title: z.ZodNullable<z.ZodString>;
+                        readonly snippet: z.ZodNullable<z.ZodString>;
+                        readonly author: z.ZodNullable<z.ZodString>;
+                        readonly authorHandle: z.ZodNullable<z.ZodString>;
+                        readonly engagement: z.ZodNullable<z.ZodNumber>;
+                        readonly sentiment: z.ZodNullable<z.ZodString>;
+                        readonly domainRank: z.ZodNullable<z.ZodNumber>;
+                        readonly publishedAt: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>>;
+                    readonly limit: z.ZodNumber;
+                }, z.core.$strip>;
+                meta: z.ZodObject<{
+                    requestId: z.ZodString;
+                    version: z.ZodLiteral<"1.0">;
+                }, z.core.$strict>;
+            }, z.core.$strip>, z.ZodObject<{
+                data: z.ZodObject<{
+                    readonly items: z.ZodArray<z.ZodObject<{
+                        readonly id: z.ZodString;
+                        readonly source: z.ZodString;
+                        readonly url: z.ZodString;
+                        readonly domain: z.ZodString;
+                        readonly title: z.ZodNullable<z.ZodString>;
+                        readonly snippet: z.ZodNullable<z.ZodString>;
+                        readonly author: z.ZodNullable<z.ZodString>;
+                        readonly authorHandle: z.ZodNullable<z.ZodString>;
+                        readonly engagement: z.ZodNullable<z.ZodNumber>;
+                        readonly sentiment: z.ZodNullable<z.ZodString>;
+                        readonly domainRank: z.ZodNullable<z.ZodNumber>;
+                        readonly publishedAt: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>>;
+                    readonly limit: z.ZodNumber;
+                }, z.core.$strip>;
+                meta: z.ZodObject<{
+                    requestId: z.ZodString;
+                    version: z.ZodLiteral<"1.0">;
+                }, z.core.$loose>;
+            }, z.core.$strip>>;
+        };
+        readonly errors: readonly ["invalid_request", "unauthorized", "auth_expired", "forbidden", "not_found", "rate_limited", "contract_violation", "internal_error"];
+        readonly errorResponse: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+            readonly error: z.ZodObject<{
+                code: z.ZodEnum<{
+                    auth_expired: "auth_expired";
+                    conflict: "conflict";
+                    contract_violation: "contract_violation";
+                    entitlement_required: "entitlement_required";
+                    forbidden: "forbidden";
+                    internal_error: "internal_error";
+                    invalid_request: "invalid_request";
+                    not_found: "not_found";
+                    provider_unavailable: "provider_unavailable";
+                    quota_exhausted: "quota_exhausted";
+                    rate_limited: "rate_limited";
+                    site_ambiguous: "site_ambiguous";
+                    stale_evidence: "stale_evidence";
+                    unauthorized: "unauthorized";
+                }>;
+                message: z.ZodString;
+                requestId: z.ZodString;
+                retryable: z.ZodBoolean;
+                details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strict>;
+        }, z.core.$strip>, z.ZodObject<{
+            readonly error: z.ZodObject<{
+                code: z.ZodEnum<{
+                    auth_expired: "auth_expired";
+                    conflict: "conflict";
+                    contract_violation: "contract_violation";
+                    entitlement_required: "entitlement_required";
+                    forbidden: "forbidden";
+                    internal_error: "internal_error";
+                    invalid_request: "invalid_request";
+                    not_found: "not_found";
+                    provider_unavailable: "provider_unavailable";
+                    quota_exhausted: "quota_exhausted";
+                    rate_limited: "rate_limited";
+                    site_ambiguous: "site_ambiguous";
+                    stale_evidence: "stale_evidence";
+                    unauthorized: "unauthorized";
+                }>;
+                message: z.ZodString;
+                requestId: z.ZodString;
+                retryable: z.ZodBoolean;
+                details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$loose>;
+        }, z.core.$strip>>;
+        readonly resources: {
+            readonly reads: readonly [{
+                readonly type: 'site.research';
+                readonly idFrom: 'params.siteId';
+            }];
+            readonly changes: readonly [];
+        };
+        readonly policy: {
+            readonly rate: {
+                readonly name: 'public-v1-fixed-window';
+                readonly limit: 50;
+                readonly windowSeconds: 60;
+            };
+            readonly idempotency: {
+                readonly _tag: 'none';
+            };
+            readonly entitlement: null;
+            readonly meter: null;
+        };
+        readonly lifecycle: {
+            readonly introduced: '1.1.0';
+        };
+        readonly docs: {
+            readonly summary: 'List Mentions';
+            readonly description: 'Returns retained pages and posts that name the Site without linking to it, newest first. Dismissed and lost Mentions are excluded. Pass includeFiltered=1 to keep the ones AI triage marked a false positive. It never starts provider work and does not consume metered units.';
+            readonly tags: readonly ["Research"];
+            readonly examples: readonly [{
+                readonly request: {
+                    readonly params: {
+                        readonly siteId: 'site_01JXYZ';
+                    };
+                    readonly query: {
+                        readonly limit: 100;
+                        readonly includeFiltered: '0';
+                    };
+                };
+                readonly response: {
+                    readonly status: 200;
+                    readonly body: {
+                        readonly data: {
+                            readonly items: readonly [{
+                                readonly id: 'mn_01JXYZ';
+                                readonly source: 'hackernews';
+                                readonly url: 'https://news.ycombinator.com/item?id=1';
+                                readonly domain: 'news.ycombinator.com';
+                                readonly title: 'Show HN: a sitemap module';
+                                readonly snippet: 'We moved to example.com last week';
+                                readonly author: 'Ada Lovelace';
+                                readonly authorHandle: 'ada';
+                                readonly engagement: 142;
+                                readonly sentiment: 'positive';
+                                readonly domainRank: 812;
+                                readonly publishedAt: '2026-08-01T09:12:00.000Z';
+                            }];
+                            readonly limit: 100;
+                        };
+                        readonly meta: {
+                            readonly requestId: 'req_01JXYZ';
+                            readonly version: '1.0';
+                        };
+                    };
+                };
+            }];
+        };
+    };
+}>;