@nuxtseo/protocol 0.1.5 → 0.2.0

package/dist/v1/timeline.d.ts

@@ -317,60 +317,1397 @@ export declare const timelineEntriesOperation: {
         }];
     };
 };
+/**
+ * A user-picked calendar day is a reporting-day bucket, never an instant
+ * (ADR-0082). It stays `YYYY-MM-DD` text so the marker lands on the chosen day
+ * in every timezone.
+ */
+export declare const annotationDaySchema: z.ZodISODate;
+/** http(s) only: this value is rendered as a link in marker tooltips. */
+export declare const annotationLinkSchema: z.ZodString;
+export declare const annotationParamsSchema: z.ZodObject<{
+    siteId: z.ZodString;
+    annotationId: z.ZodString;
+}, z.core.$strict>;
+export declare const annotationCreateBodySchema: z.ZodObject<{
+    date: z.ZodISODate;
+    title: z.ZodString;
+    note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export declare const annotationUpdateBodySchema: z.ZodObject<{
+    date: z.ZodOptional<z.ZodISODate>;
+    title: z.ZodOptional<z.ZodString>;
+    note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export declare const annotationSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly id: z.ZodString;
+    readonly date: z.ZodString;
+    readonly title: z.ZodString;
+    readonly note: z.ZodNullable<z.ZodString>;
+    readonly url: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    readonly id: z.ZodString;
+    readonly date: z.ZodString;
+    readonly title: z.ZodString;
+    readonly note: z.ZodNullable<z.ZodString>;
+    readonly url: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>>;
+export declare const annotationListDataSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly annotations: z.ZodArray<z.ZodObject<{
+        readonly id: z.ZodString;
+        readonly date: z.ZodString;
+        readonly title: z.ZodString;
+        readonly note: z.ZodNullable<z.ZodString>;
+        readonly url: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    readonly total: z.ZodNumber;
+    readonly limit: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    readonly annotations: z.ZodArray<z.ZodObject<{
+        readonly id: z.ZodString;
+        readonly date: z.ZodString;
+        readonly title: z.ZodString;
+        readonly note: z.ZodNullable<z.ZodString>;
+        readonly url: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    readonly total: z.ZodNumber;
+    readonly limit: z.ZodNumber;
+}, z.core.$strip>>;
+export declare const annotationListResponseSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    data: z.ZodObject<{
+        readonly annotations: z.ZodArray<z.ZodObject<{
+            readonly id: z.ZodString;
+            readonly date: z.ZodString;
+            readonly title: z.ZodString;
+            readonly note: z.ZodNullable<z.ZodString>;
+            readonly url: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        readonly total: z.ZodNumber;
+        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 annotations: z.ZodArray<z.ZodObject<{
+            readonly id: z.ZodString;
+            readonly date: z.ZodString;
+            readonly title: z.ZodString;
+            readonly note: z.ZodNullable<z.ZodString>;
+            readonly url: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        readonly total: z.ZodNumber;
+        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 declare const annotationDataSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly annotation: z.ZodObject<{
+        readonly id: z.ZodString;
+        readonly date: z.ZodString;
+        readonly title: z.ZodString;
+        readonly note: z.ZodNullable<z.ZodString>;
+        readonly url: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    readonly annotation: z.ZodObject<{
+        readonly id: z.ZodString;
+        readonly date: z.ZodString;
+        readonly title: z.ZodString;
+        readonly note: z.ZodNullable<z.ZodString>;
+        readonly url: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>>;
+export declare const annotationResponseSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    data: z.ZodObject<{
+        readonly annotation: z.ZodObject<{
+            readonly id: z.ZodString;
+            readonly date: z.ZodString;
+            readonly title: z.ZodString;
+            readonly note: z.ZodNullable<z.ZodString>;
+            readonly url: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+    }, 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 annotation: z.ZodObject<{
+            readonly id: z.ZodString;
+            readonly date: z.ZodString;
+            readonly title: z.ZodString;
+            readonly note: z.ZodNullable<z.ZodString>;
+            readonly url: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    meta: z.ZodObject<{
+        requestId: z.ZodString;
+        version: z.ZodLiteral<"1.0">;
+    }, z.core.$loose>;
+}, z.core.$strip>>;
+export declare const annotationDeleteDataSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly annotationId: z.ZodString;
+    readonly deleted: z.ZodLiteral<true>;
+}, z.core.$strip>, z.ZodObject<{
+    readonly annotationId: z.ZodString;
+    readonly deleted: z.ZodLiteral<true>;
+}, z.core.$strip>>;
+export declare const annotationDeleteResponseSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    data: z.ZodObject<{
+        readonly annotationId: z.ZodString;
+        readonly deleted: z.ZodLiteral<true>;
+    }, 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 annotationId: z.ZodString;
+        readonly deleted: z.ZodLiteral<true>;
+    }, z.core.$strip>;
+    meta: z.ZodObject<{
+        requestId: z.ZodString;
+        version: z.ZodLiteral<"1.0">;
+    }, z.core.$loose>;
+}, z.core.$strip>>;
+export type Annotations = z.output<typeof annotationListDataSchema.producer>;
+export type Annotation = z.output<typeof annotationDataSchema.producer>;
+export type AnnotationDeleted = z.output<typeof annotationDeleteDataSchema.producer>;
+export type AnnotationCreateBody = z.input<typeof annotationCreateBodySchema>;
+export type AnnotationUpdateBody = z.input<typeof annotationUpdateBodySchema>;
+export declare const annotationListOperation: {
+    readonly id: 'timeline.annotations.list';
+    readonly method: 'GET';
+    readonly path: '/api/v1/sites/{siteId}/timeline/annotations';
+    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 ["timeline:read"];
+        readonly minimumRole: 'viewer';
+        readonly ownership: 'site';
+    };
+    readonly request: {
+        readonly params: z.ZodObject<{
+            siteId: z.ZodString;
+        }, z.core.$strict>;
+        readonly query: null;
+        readonly headers: null;
+        readonly body: null;
+    };
+    readonly responses: {
+        readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+            data: z.ZodObject<{
+                readonly annotations: z.ZodArray<z.ZodObject<{
+                    readonly id: z.ZodString;
+                    readonly date: z.ZodString;
+                    readonly title: z.ZodString;
+                    readonly note: z.ZodNullable<z.ZodString>;
+                    readonly url: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>>;
+                readonly total: z.ZodNumber;
+                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 annotations: z.ZodArray<z.ZodObject<{
+                    readonly id: z.ZodString;
+                    readonly date: z.ZodString;
+                    readonly title: z.ZodString;
+                    readonly note: z.ZodNullable<z.ZodString>;
+                    readonly url: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>>;
+                readonly total: z.ZodNumber;
+                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.timeline';
+            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.2.0';
+    };
+    readonly docs: {
+        readonly summary: 'List chart annotations';
+        readonly description: 'Returns this Site own chart annotations, oldest day first. These are the markers a person or an agent placed; detected events and releases are read through the Timeline instead. `limit` is the per-Site cap, not a paging window.';
+        readonly tags: readonly ["Timeline"];
+        readonly examples: readonly [{
+            readonly request: {
+                readonly params: {
+                    readonly siteId: 'site_01JXYZ';
+                };
+            };
+            readonly response: {
+                readonly status: 200;
+                readonly body: {
+                    readonly data: {
+                        readonly annotations: readonly [{
+                            readonly id: 'ann_01JXYZ';
+                            readonly date: '2026-07-30';
+                            readonly title: 'Shipped v3.2';
+                            readonly note: 'Canonical tags repaired across /docs';
+                            readonly url: 'https://github.com/owner/repo/releases/tag/v3.2.0';
+                        }];
+                        readonly total: 1;
+                        readonly limit: 100;
+                    };
+                    readonly meta: {
+                        readonly requestId: 'req_01JXYZ';
+                        readonly version: '1.0';
+                    };
+                };
+            };
+        }];
+    };
+};
+export declare const annotationCreateOperation: {
+    readonly id: 'timeline.annotations.create';
+    readonly method: 'POST';
+    readonly path: '/api/v1/sites/{siteId}/timeline/annotations';
+    readonly visibility: 'public';
+    readonly semantics: {
+        readonly kind: 'mutation';
+        readonly sideEffects: 'state';
+        readonly retry: 'never';
+        readonly readConsistency: null;
+    };
+    readonly auth: {
+        readonly credentials: readonly ['session', 'api_token'];
+        readonly scopes: readonly ['timeline:write'];
+        readonly minimumRole: 'member';
+        readonly ownership: 'site';
+    };
+    readonly request: {
+        readonly params: z.ZodObject<{
+            siteId: z.ZodString;
+        }, z.core.$strict>;
+        readonly query: null;
+        readonly headers: null;
+        readonly body: z.ZodObject<{
+            date: z.ZodISODate;
+            title: z.ZodString;
+            note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>;
+    };
+    readonly responses: {
+        readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+            data: z.ZodObject<{
+                readonly annotation: z.ZodObject<{
+                    readonly id: z.ZodString;
+                    readonly date: z.ZodString;
+                    readonly title: z.ZodString;
+                    readonly note: z.ZodNullable<z.ZodString>;
+                    readonly url: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>;
+            }, 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 annotation: z.ZodObject<{
+                    readonly id: z.ZodString;
+                    readonly date: z.ZodString;
+                    readonly title: z.ZodString;
+                    readonly note: z.ZodNullable<z.ZodString>;
+                    readonly url: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>;
+            }, 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", "conflict", "quota_exhausted", "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.timeline';
+            readonly idFrom: 'params.siteId';
+        }];
+        readonly changes: readonly [{
+            readonly type: 'site.timeline';
+            readonly idFrom: 'params.siteId';
+        }];
+    };
+    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.2.0';
+    };
+    readonly docs: {
+        readonly summary: 'Create a chart annotation';
+        readonly description: 'Places one dated marker on this Site charts. Mark the day work shipped, so the next traffic or ranking move has a cause beside it. The Site has a fixed annotation cap; when it is reached the request is rejected and stale markers must be deleted first.';
+        readonly tags: readonly ["Timeline"];
+        readonly examples: readonly [{
+            readonly request: {
+                readonly params: {
+                    readonly siteId: 'site_01JXYZ';
+                };
+                readonly body: {
+                    readonly date: '2026-07-30';
+                    readonly title: 'Shipped v3.2';
+                    readonly note: null;
+                    readonly url: null;
+                };
+            };
+            readonly response: {
+                readonly status: 200;
+                readonly body: {
+                    readonly data: {
+                        readonly annotation: {
+                            readonly id: 'ann_01JXYZ';
+                            readonly date: '2026-07-30';
+                            readonly title: 'Shipped v3.2';
+                            readonly note: null;
+                            readonly url: null;
+                        };
+                    };
+                    readonly meta: {
+                        readonly requestId: 'req_01JXYZ';
+                        readonly version: '1.0';
+                    };
+                };
+            };
+        }];
+    };
+};
+export declare const annotationUpdateOperation: {
+    readonly id: 'timeline.annotations.update';
+    readonly method: 'PATCH';
+    readonly path: '/api/v1/sites/{siteId}/timeline/annotations/{annotationId}';
+    readonly visibility: 'public';
+    readonly semantics: {
+        readonly kind: 'mutation';
+        readonly sideEffects: 'state';
+        readonly retry: 'never';
+        readonly readConsistency: null;
+    };
+    readonly auth: {
+        readonly credentials: readonly ['session', 'api_token'];
+        readonly scopes: readonly ['timeline:write'];
+        readonly minimumRole: 'member';
+        readonly ownership: 'site';
+    };
+    readonly request: {
+        readonly params: z.ZodObject<{
+            siteId: z.ZodString;
+            annotationId: z.ZodString;
+        }, z.core.$strict>;
+        readonly query: null;
+        readonly headers: null;
+        readonly body: z.ZodObject<{
+            date: z.ZodOptional<z.ZodISODate>;
+            title: z.ZodOptional<z.ZodString>;
+            note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>;
+    };
+    readonly responses: {
+        readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+            data: z.ZodObject<{
+                readonly annotation: z.ZodObject<{
+                    readonly id: z.ZodString;
+                    readonly date: z.ZodString;
+                    readonly title: z.ZodString;
+                    readonly note: z.ZodNullable<z.ZodString>;
+                    readonly url: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>;
+            }, 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 annotation: z.ZodObject<{
+                    readonly id: z.ZodString;
+                    readonly date: z.ZodString;
+                    readonly title: z.ZodString;
+                    readonly note: z.ZodNullable<z.ZodString>;
+                    readonly url: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>;
+            }, 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", "conflict", "quota_exhausted", "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.timeline';
+            readonly idFrom: 'params.siteId';
+        }];
+        readonly changes: readonly [{
+            readonly type: 'site.timeline';
+            readonly idFrom: 'params.siteId';
+        }];
+    };
+    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.2.0';
+    };
+    readonly docs: {
+        readonly summary: 'Update a chart annotation';
+        readonly description: 'Changes the day, title, note, or link of one annotation. Send only the fields that change. Pass null for note or url to clear it.';
+        readonly tags: readonly ["Timeline"];
+        readonly examples: readonly [{
+            readonly request: {
+                readonly params: {
+                    readonly siteId: 'site_01JXYZ';
+                    readonly annotationId: 'ann_01JXYZ';
+                };
+                readonly body: {
+                    readonly title: 'Shipped v3.2.1';
+                };
+            };
+            readonly response: {
+                readonly status: 200;
+                readonly body: {
+                    readonly data: {
+                        readonly annotation: {
+                            readonly id: 'ann_01JXYZ';
+                            readonly date: '2026-07-30';
+                            readonly title: 'Shipped v3.2.1';
+                            readonly note: null;
+                            readonly url: null;
+                        };
+                    };
+                    readonly meta: {
+                        readonly requestId: 'req_01JXYZ';
+                        readonly version: '1.0';
+                    };
+                };
+            };
+        }];
+    };
+};
+export declare const annotationDeleteOperation: {
+    readonly id: 'timeline.annotations.delete';
+    readonly method: 'DELETE';
+    readonly path: '/api/v1/sites/{siteId}/timeline/annotations/{annotationId}';
+    readonly visibility: 'public';
+    readonly semantics: {
+        readonly kind: 'mutation';
+        readonly sideEffects: 'state';
+        readonly retry: 'never';
+        readonly readConsistency: null;
+    };
+    readonly auth: {
+        readonly credentials: readonly ['session', 'api_token'];
+        readonly scopes: readonly ['timeline:write'];
+        readonly minimumRole: 'member';
+        readonly ownership: 'site';
+    };
+    readonly request: {
+        readonly params: z.ZodObject<{
+            siteId: z.ZodString;
+            annotationId: z.ZodString;
+        }, z.core.$strict>;
+        readonly query: null;
+        readonly headers: null;
+        readonly body: null;
+    };
+    readonly responses: {
+        readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+            data: z.ZodObject<{
+                readonly annotationId: z.ZodString;
+                readonly deleted: z.ZodLiteral<true>;
+            }, 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 annotationId: z.ZodString;
+                readonly deleted: z.ZodLiteral<true>;
+            }, 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", "conflict", "quota_exhausted", "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.timeline';
+            readonly idFrom: 'params.siteId';
+        }];
+        readonly changes: readonly [{
+            readonly type: 'site.timeline';
+            readonly idFrom: 'params.siteId';
+        }];
+    };
+    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.2.0';
+    };
+    readonly docs: {
+        readonly summary: 'Delete a chart annotation';
+        readonly description: 'Removes one annotation permanently. Deleting frees a slot against the per-Site cap.';
+        readonly tags: readonly ["Timeline"];
+        readonly examples: readonly [{
+            readonly request: {
+                readonly params: {
+                    readonly siteId: 'site_01JXYZ';
+                    readonly annotationId: 'ann_01JXYZ';
+                };
+            };
+            readonly response: {
+                readonly status: 200;
+                readonly body: {
+                    readonly data: {
+                        readonly annotationId: 'ann_01JXYZ';
+                        readonly deleted: true;
+                    };
+                    readonly meta: {
+                        readonly requestId: 'req_01JXYZ';
+                        readonly version: '1.0';
+                    };
+                };
+            };
+        }];
+    };
+};
 export declare const timelineV1Registry: import("./core.js").PublicV1Registry<{
     readonly entries: {
         readonly id: 'timeline.entries';
         readonly method: 'GET';
-        readonly path: '/api/v1/sites/{siteId}/timeline';
+        readonly path: '/api/v1/sites/{siteId}/timeline';
+        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 ['timeline:read'];
+            readonly minimumRole: 'viewer';
+            readonly ownership: 'site';
+        };
+        readonly request: {
+            readonly params: z.ZodObject<{
+                siteId: z.ZodString;
+            }, z.core.$strict>;
+            readonly query: z.ZodObject<{
+                kinds: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string[] | undefined, string | undefined>>;
+                feature: z.ZodOptional<z.ZodString>;
+                severity: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<("high" | "info" | "notable")[] | undefined, string | undefined>>;
+                since: z.ZodOptional<z.ZodString>;
+                limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+                cursor: z.ZodOptional<z.ZodString>;
+                includeClosed: z.ZodPipe<z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+                    false: "false";
+                    true: "true";
+                }>]>>, z.ZodTransform<boolean, "false" | "true" | boolean>>;
+            }, z.core.$strict>;
+            readonly headers: null;
+            readonly body: null;
+        };
+        readonly responses: {
+            readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+                data: z.ZodObject<{
+                    readonly entries: z.ZodArray<z.ZodObject<{
+                        readonly id: z.ZodString;
+                        readonly kind: z.ZodString;
+                        readonly severity: z.ZodNullable<z.ZodEnum<{
+                            high: "high";
+                            info: "info";
+                            notable: "notable";
+                        }>>;
+                        readonly occurredAt: z.ZodString;
+                        readonly rendered: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                        readonly payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                    }, z.core.$strip>>;
+                    readonly nextCursor: z.ZodNullable<z.ZodString>;
+                    readonly counts: z.ZodRecord<z.ZodString, 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 entries: z.ZodArray<z.ZodObject<{
+                        readonly id: z.ZodString;
+                        readonly kind: z.ZodString;
+                        readonly severity: z.ZodNullable<z.ZodEnum<{
+                            high: "high";
+                            info: "info";
+                            notable: "notable";
+                        }>>;
+                        readonly occurredAt: z.ZodString;
+                        readonly rendered: z.ZodNullable<z.ZodObject<{}, z.core.$loose>>;
+                        readonly payload: z.ZodObject<{}, z.core.$loose>;
+                    }, z.core.$strip>>;
+                    readonly nextCursor: z.ZodNullable<z.ZodString>;
+                    readonly counts: z.ZodRecord<z.ZodString, 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", "provider_unavailable", "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.timeline';
+                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.0.0';
+        };
+        readonly docs: {
+            readonly summary: 'Read the Timeline';
+            readonly description: 'What changed on this Site — Timeline Entries such as traffic drops, indexing changes, sitemap changes, rank shifts and deploys. Filter by kind, feature, severity and since; paginated with an opaque cursor.';
+            readonly tags: readonly ["Timeline"];
+            readonly examples: readonly [{
+                readonly request: {
+                    readonly params: {
+                        readonly siteId: 'site_01JXYZ';
+                    };
+                    readonly query: {
+                        readonly severity: 'high';
+                    };
+                };
+                readonly response: {
+                    readonly status: 200;
+                    readonly body: {
+                        readonly data: {
+                            readonly entries: readonly [{
+                                readonly id: 'timeline_01JXYZ';
+                                readonly kind: 'traffic.dropped';
+                                readonly severity: 'high';
+                                readonly occurredAt: '2026-08-10T01:30:00.000Z';
+                                readonly rendered: {
+                                    readonly label: 'Clicks dropped 42%';
+                                    readonly value: -0.42;
+                                    readonly direction: 'down';
+                                };
+                                readonly payload: {
+                                    readonly clicksDelta: -180;
+                                };
+                            }];
+                            readonly nextCursor: null;
+                            readonly counts: {
+                                readonly 'traffic.dropped': 1;
+                            };
+                        };
+                        readonly meta: {
+                            readonly requestId: 'req_01JXYZ';
+                            readonly version: '1.0';
+                        };
+                    };
+                };
+            }];
+        };
+    };
+    readonly listAnnotations: {
+        readonly id: 'timeline.annotations.list';
+        readonly method: 'GET';
+        readonly path: '/api/v1/sites/{siteId}/timeline/annotations';
+        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 ["timeline:read"];
+            readonly minimumRole: 'viewer';
+            readonly ownership: 'site';
+        };
+        readonly request: {
+            readonly params: z.ZodObject<{
+                siteId: z.ZodString;
+            }, z.core.$strict>;
+            readonly query: null;
+            readonly headers: null;
+            readonly body: null;
+        };
+        readonly responses: {
+            readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+                data: z.ZodObject<{
+                    readonly annotations: z.ZodArray<z.ZodObject<{
+                        readonly id: z.ZodString;
+                        readonly date: z.ZodString;
+                        readonly title: z.ZodString;
+                        readonly note: z.ZodNullable<z.ZodString>;
+                        readonly url: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>>;
+                    readonly total: z.ZodNumber;
+                    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 annotations: z.ZodArray<z.ZodObject<{
+                        readonly id: z.ZodString;
+                        readonly date: z.ZodString;
+                        readonly title: z.ZodString;
+                        readonly note: z.ZodNullable<z.ZodString>;
+                        readonly url: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>>;
+                    readonly total: z.ZodNumber;
+                    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.timeline';
+                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.2.0';
+        };
+        readonly docs: {
+            readonly summary: 'List chart annotations';
+            readonly description: 'Returns this Site own chart annotations, oldest day first. These are the markers a person or an agent placed; detected events and releases are read through the Timeline instead. `limit` is the per-Site cap, not a paging window.';
+            readonly tags: readonly ["Timeline"];
+            readonly examples: readonly [{
+                readonly request: {
+                    readonly params: {
+                        readonly siteId: 'site_01JXYZ';
+                    };
+                };
+                readonly response: {
+                    readonly status: 200;
+                    readonly body: {
+                        readonly data: {
+                            readonly annotations: readonly [{
+                                readonly id: 'ann_01JXYZ';
+                                readonly date: '2026-07-30';
+                                readonly title: 'Shipped v3.2';
+                                readonly note: 'Canonical tags repaired across /docs';
+                                readonly url: 'https://github.com/owner/repo/releases/tag/v3.2.0';
+                            }];
+                            readonly total: 1;
+                            readonly limit: 100;
+                        };
+                        readonly meta: {
+                            readonly requestId: 'req_01JXYZ';
+                            readonly version: '1.0';
+                        };
+                    };
+                };
+            }];
+        };
+    };
+    readonly createAnnotation: {
+        readonly id: 'timeline.annotations.create';
+        readonly method: 'POST';
+        readonly path: '/api/v1/sites/{siteId}/timeline/annotations';
+        readonly visibility: 'public';
+        readonly semantics: {
+            readonly kind: 'mutation';
+            readonly sideEffects: 'state';
+            readonly retry: 'never';
+            readonly readConsistency: null;
+        };
+        readonly auth: {
+            readonly credentials: readonly ['session', 'api_token'];
+            readonly scopes: readonly ['timeline:write'];
+            readonly minimumRole: 'member';
+            readonly ownership: 'site';
+        };
+        readonly request: {
+            readonly params: z.ZodObject<{
+                siteId: z.ZodString;
+            }, z.core.$strict>;
+            readonly query: null;
+            readonly headers: null;
+            readonly body: z.ZodObject<{
+                date: z.ZodISODate;
+                title: z.ZodString;
+                note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strict>;
+        };
+        readonly responses: {
+            readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+                data: z.ZodObject<{
+                    readonly annotation: z.ZodObject<{
+                        readonly id: z.ZodString;
+                        readonly date: z.ZodString;
+                        readonly title: z.ZodString;
+                        readonly note: z.ZodNullable<z.ZodString>;
+                        readonly url: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>;
+                }, 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 annotation: z.ZodObject<{
+                        readonly id: z.ZodString;
+                        readonly date: z.ZodString;
+                        readonly title: z.ZodString;
+                        readonly note: z.ZodNullable<z.ZodString>;
+                        readonly url: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>;
+                }, 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", "conflict", "quota_exhausted", "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.timeline';
+                readonly idFrom: 'params.siteId';
+            }];
+            readonly changes: readonly [{
+                readonly type: 'site.timeline';
+                readonly idFrom: 'params.siteId';
+            }];
+        };
+        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.2.0';
+        };
+        readonly docs: {
+            readonly summary: 'Create a chart annotation';
+            readonly description: 'Places one dated marker on this Site charts. Mark the day work shipped, so the next traffic or ranking move has a cause beside it. The Site has a fixed annotation cap; when it is reached the request is rejected and stale markers must be deleted first.';
+            readonly tags: readonly ["Timeline"];
+            readonly examples: readonly [{
+                readonly request: {
+                    readonly params: {
+                        readonly siteId: 'site_01JXYZ';
+                    };
+                    readonly body: {
+                        readonly date: '2026-07-30';
+                        readonly title: 'Shipped v3.2';
+                        readonly note: null;
+                        readonly url: null;
+                    };
+                };
+                readonly response: {
+                    readonly status: 200;
+                    readonly body: {
+                        readonly data: {
+                            readonly annotation: {
+                                readonly id: 'ann_01JXYZ';
+                                readonly date: '2026-07-30';
+                                readonly title: 'Shipped v3.2';
+                                readonly note: null;
+                                readonly url: null;
+                            };
+                        };
+                        readonly meta: {
+                            readonly requestId: 'req_01JXYZ';
+                            readonly version: '1.0';
+                        };
+                    };
+                };
+            }];
+        };
+    };
+    readonly updateAnnotation: {
+        readonly id: 'timeline.annotations.update';
+        readonly method: 'PATCH';
+        readonly path: '/api/v1/sites/{siteId}/timeline/annotations/{annotationId}';
         readonly visibility: 'public';
         readonly semantics: {
-            readonly kind: 'query';
-            readonly sideEffects: 'none';
-            readonly retry: 'idempotent';
-            readonly readConsistency: 'primary';
+            readonly kind: 'mutation';
+            readonly sideEffects: 'state';
+            readonly retry: 'never';
+            readonly readConsistency: null;
         };
         readonly auth: {
             readonly credentials: readonly ['session', 'api_token'];
-            readonly scopes: readonly ['timeline:read'];
-            readonly minimumRole: 'viewer';
+            readonly scopes: readonly ['timeline:write'];
+            readonly minimumRole: 'member';
             readonly ownership: 'site';
         };
         readonly request: {
             readonly params: z.ZodObject<{
                 siteId: z.ZodString;
+                annotationId: z.ZodString;
             }, z.core.$strict>;
-            readonly query: z.ZodObject<{
-                kinds: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string[] | undefined, string | undefined>>;
-                feature: z.ZodOptional<z.ZodString>;
-                severity: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<("high" | "info" | "notable")[] | undefined, string | undefined>>;
-                since: z.ZodOptional<z.ZodString>;
-                limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
-                cursor: z.ZodOptional<z.ZodString>;
-                includeClosed: z.ZodPipe<z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
-                    false: "false";
-                    true: "true";
-                }>]>>, z.ZodTransform<boolean, "false" | "true" | boolean>>;
-            }, z.core.$strict>;
+            readonly query: null;
             readonly headers: null;
-            readonly body: null;
+            readonly body: z.ZodObject<{
+                date: z.ZodOptional<z.ZodISODate>;
+                title: z.ZodOptional<z.ZodString>;
+                note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strict>;
         };
         readonly responses: {
             readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
                 data: z.ZodObject<{
-                    readonly entries: z.ZodArray<z.ZodObject<{
+                    readonly annotation: z.ZodObject<{
                         readonly id: z.ZodString;
-                        readonly kind: z.ZodString;
-                        readonly severity: z.ZodNullable<z.ZodEnum<{
-                            high: "high";
-                            info: "info";
-                            notable: "notable";
-                        }>>;
-                        readonly occurredAt: z.ZodString;
-                        readonly rendered: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-                        readonly payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-                    }, z.core.$strip>>;
-                    readonly nextCursor: z.ZodNullable<z.ZodString>;
-                    readonly counts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+                        readonly date: z.ZodString;
+                        readonly title: z.ZodString;
+                        readonly note: z.ZodNullable<z.ZodString>;
+                        readonly url: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>;
                 }, z.core.$strip>;
                 meta: z.ZodObject<{
                     requestId: z.ZodString;
@@ -378,20 +1715,13 @@ export declare const timelineV1Registry: import("./core.js").PublicV1Registry<{
                 }, z.core.$strict>;
             }, z.core.$strip>, z.ZodObject<{
                 data: z.ZodObject<{
-                    readonly entries: z.ZodArray<z.ZodObject<{
+                    readonly annotation: z.ZodObject<{
                         readonly id: z.ZodString;
-                        readonly kind: z.ZodString;
-                        readonly severity: z.ZodNullable<z.ZodEnum<{
-                            high: "high";
-                            info: "info";
-                            notable: "notable";
-                        }>>;
-                        readonly occurredAt: z.ZodString;
-                        readonly rendered: z.ZodNullable<z.ZodObject<{}, z.core.$loose>>;
-                        readonly payload: z.ZodObject<{}, z.core.$loose>;
-                    }, z.core.$strip>>;
-                    readonly nextCursor: z.ZodNullable<z.ZodString>;
-                    readonly counts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+                        readonly date: z.ZodString;
+                        readonly title: z.ZodString;
+                        readonly note: z.ZodNullable<z.ZodString>;
+                        readonly url: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>;
                 }, z.core.$strip>;
                 meta: z.ZodObject<{
                     requestId: z.ZodString;
@@ -399,7 +1729,7 @@ export declare const timelineV1Registry: import("./core.js").PublicV1Registry<{
                 }, z.core.$loose>;
             }, z.core.$strip>>;
         };
-        readonly errors: readonly ["invalid_request", "unauthorized", "auth_expired", "forbidden", "not_found", "rate_limited", "provider_unavailable", "contract_violation", "internal_error"];
+        readonly errors: readonly ["invalid_request", "unauthorized", "auth_expired", "forbidden", "not_found", "conflict", "quota_exhausted", "rate_limited", "contract_violation", "internal_error"];
         readonly errorResponse: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
             readonly error: z.ZodObject<{
                 code: z.ZodEnum<{
@@ -452,7 +1782,10 @@ export declare const timelineV1Registry: import("./core.js").PublicV1Registry<{
                 readonly type: 'site.timeline';
                 readonly idFrom: 'params.siteId';
             }];
-            readonly changes: readonly [];
+            readonly changes: readonly [{
+                readonly type: 'site.timeline';
+                readonly idFrom: 'params.siteId';
+            }];
         };
         readonly policy: {
             readonly rate: {
@@ -467,42 +1800,32 @@ export declare const timelineV1Registry: import("./core.js").PublicV1Registry<{
             readonly meter: null;
         };
         readonly lifecycle: {
-            readonly introduced: '1.0.0';
+            readonly introduced: '1.2.0';
         };
         readonly docs: {
-            readonly summary: 'Read the Timeline';
-            readonly description: 'What changed on this Site — Timeline Entries such as traffic drops, indexing changes, sitemap changes, rank shifts and deploys. Filter by kind, feature, severity and since; paginated with an opaque cursor.';
+            readonly summary: 'Update a chart annotation';
+            readonly description: 'Changes the day, title, note, or link of one annotation. Send only the fields that change. Pass null for note or url to clear it.';
             readonly tags: readonly ["Timeline"];
             readonly examples: readonly [{
                 readonly request: {
                     readonly params: {
                         readonly siteId: 'site_01JXYZ';
+                        readonly annotationId: 'ann_01JXYZ';
                     };
-                    readonly query: {
-                        readonly severity: 'high';
+                    readonly body: {
+                        readonly title: 'Shipped v3.2.1';
                     };
                 };
                 readonly response: {
                     readonly status: 200;
                     readonly body: {
                         readonly data: {
-                            readonly entries: readonly [{
-                                readonly id: 'timeline_01JXYZ';
-                                readonly kind: 'traffic.dropped';
-                                readonly severity: 'high';
-                                readonly occurredAt: '2026-08-10T01:30:00.000Z';
-                                readonly rendered: {
-                                    readonly label: 'Clicks dropped 42%';
-                                    readonly value: -0.42;
-                                    readonly direction: 'down';
-                                };
-                                readonly payload: {
-                                    readonly clicksDelta: -180;
-                                };
-                            }];
-                            readonly nextCursor: null;
-                            readonly counts: {
-                                readonly 'traffic.dropped': 1;
+                            readonly annotation: {
+                                readonly id: 'ann_01JXYZ';
+                                readonly date: '2026-07-30';
+                                readonly title: 'Shipped v3.2.1';
+                                readonly note: null;
+                                readonly url: null;
                             };
                         };
                         readonly meta: {
@@ -514,4 +1837,151 @@ export declare const timelineV1Registry: import("./core.js").PublicV1Registry<{
             }];
         };
     };
+    readonly deleteAnnotation: {
+        readonly id: 'timeline.annotations.delete';
+        readonly method: 'DELETE';
+        readonly path: '/api/v1/sites/{siteId}/timeline/annotations/{annotationId}';
+        readonly visibility: 'public';
+        readonly semantics: {
+            readonly kind: 'mutation';
+            readonly sideEffects: 'state';
+            readonly retry: 'never';
+            readonly readConsistency: null;
+        };
+        readonly auth: {
+            readonly credentials: readonly ['session', 'api_token'];
+            readonly scopes: readonly ['timeline:write'];
+            readonly minimumRole: 'member';
+            readonly ownership: 'site';
+        };
+        readonly request: {
+            readonly params: z.ZodObject<{
+                siteId: z.ZodString;
+                annotationId: z.ZodString;
+            }, z.core.$strict>;
+            readonly query: null;
+            readonly headers: null;
+            readonly body: null;
+        };
+        readonly responses: {
+            readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+                data: z.ZodObject<{
+                    readonly annotationId: z.ZodString;
+                    readonly deleted: z.ZodLiteral<true>;
+                }, 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 annotationId: z.ZodString;
+                    readonly deleted: z.ZodLiteral<true>;
+                }, 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", "conflict", "quota_exhausted", "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.timeline';
+                readonly idFrom: 'params.siteId';
+            }];
+            readonly changes: readonly [{
+                readonly type: 'site.timeline';
+                readonly idFrom: 'params.siteId';
+            }];
+        };
+        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.2.0';
+        };
+        readonly docs: {
+            readonly summary: 'Delete a chart annotation';
+            readonly description: 'Removes one annotation permanently. Deleting frees a slot against the per-Site cap.';
+            readonly tags: readonly ["Timeline"];
+            readonly examples: readonly [{
+                readonly request: {
+                    readonly params: {
+                        readonly siteId: 'site_01JXYZ';
+                        readonly annotationId: 'ann_01JXYZ';
+                    };
+                };
+                readonly response: {
+                    readonly status: 200;
+                    readonly body: {
+                        readonly data: {
+                            readonly annotationId: 'ann_01JXYZ';
+                            readonly deleted: true;
+                        };
+                        readonly meta: {
+                            readonly requestId: 'req_01JXYZ';
+                            readonly version: '1.0';
+                        };
+                    };
+                };
+            }];
+        };
+    };
 }>;