@hollware/core 0.5.0 → 0.8.0

package/dist/index.d.mts

@@ -1,4 +1,5 @@
 import * as z from "zod";
+import "@cfworker/json-schema";
 import { MarkdownDocument } from "comark";
 import { StandardJSONSchemaV1, StandardSchemaV1 } from "@standard-schema/spec";
 //#region src/markdown/types.d.ts
@@ -217,6 +218,14 @@ interface Contract<Frontmatter = Record<string, unknown>> {
   readonly phases?: readonly Phase[];
   /** What the rule asks for, as `describe_site` shows it to agents. */
   readonly description: string;
+  /**
+   * The rule of the catalog this contract is, with its parameters (ADR-033): what a site's
+   * definition stores for it. A contract of the site's own code has none.
+   */
+  readonly rule?: {
+    readonly name: string;
+    readonly params: Readonly<Record<string, unknown>>;
+  };
   /** The problems it finds; an empty list passes. */
   check(context: ContractContext<Frontmatter>): readonly ContractFinding[] | Promise<readonly ContractFinding[]>;
 }
@@ -303,7 +312,8 @@ interface SiteDefinition {
     readonly webhooks?: readonly {
       readonly name: string;
       readonly url: string;
-      readonly secret: string;
+      /** The Worker secret that signs; Hollware's own sealed one when it is left out. */
+      readonly secret?: string;
     }[];
     /** Tells IndexNow the URLs that changed; `key` names the Worker secret with the key. */
     readonly indexNow?: {
@@ -314,10 +324,11 @@ interface SiteDefinition {
 /** What `hollware.config.ts` exports. */
 interface HollwareConfig {
   /**
-   * The sites, by key. The key is the site's id in the database, so it never changes once
-   * content exists. v0.1 serves exactly one site per deployment.
+   * The sites of 0.x, by key: since ADR-033 the sites live in D1, and these move there on the
+   * first request of a deployment whose D1 has no definition for them. The key is the site's id
+   * in the database, so it never changes once content exists.
    */
-  readonly sites: Readonly<Record<string, SiteDefinition>>;
+  readonly sites?: Readonly<Record<string, SiteDefinition>>;
   /** How MCP clients and the admin get tokens (ADR-026). */
   readonly auth?: AuthDefinition;
 }
@@ -359,11 +370,14 @@ interface ResolvedSite {
   };
   readonly events: ResolvedEvents;
 }
-/** A webhook of a site; `secret` names the Worker secret that signs its deliveries. */
+/**
+ * A webhook of a site. `secret` names the Worker secret that signs its deliveries; `null` when the
+ * secret is Hollware's own, made by `make_webhook_secret` and sealed in the database (ADR-033).
+ */
 interface ResolvedWebhook {
   readonly name: string;
   readonly url: string;
-  readonly secret: string;
+  readonly secret: string | null;
 }
 /** Who hears about the publications of a site. */
 interface ResolvedEvents {
@@ -439,7 +453,7 @@ export declare const DEFAULT_MAX_MARKDOWN_BYTES = 524288;
  */
 export declare const MAX_MARKDOWN_BYTES_CEILING = 786432;
 declare namespace schemas_d_exports {
-  export { acknowledgedWarning, collectionDescription, collectionName, componentDescription, conflict, contractDescription, document, entry, entryId, entryStatus, entrySummary, format, locale, markdown, phase, publication, review, reviewId, reviewStatus, revisionId, searchMode, severity, siteDescription, slug, verdict, version, violation };
+  export { acknowledgedWarning, collectionDescription, collectionName, componentDescription, conflict, contractDescription, document, entry, entryId, entryStatus, entrySummary, format, locale, markdown, phase, publication, review, reviewComment, reviewId, reviewStatus, revisionId, searchMode, severity, siteDescription, slug, verdict, version, violation };
 }
 /**
  * The pieces the operation schemas share. Their descriptions become the JSON Schema that agents
@@ -526,6 +540,7 @@ declare const entrySummary: z.ZodObject<{
   tags: z.ZodArray<z.ZodString>;
   hasUnpublishedChanges: z.ZodBoolean;
   publishedAt: z.ZodNullable<z.ZodString>;
+  scheduledAt: z.ZodNullable<z.ZodString>;
   updatedAt: z.ZodString;
 }, z.core.$strip>;
 declare const publication: z.ZodObject<{
@@ -588,6 +603,7 @@ declare const entry: z.ZodObject<{
   tags: z.ZodArray<z.ZodString>;
   hasUnpublishedChanges: z.ZodBoolean;
   publishedAt: z.ZodNullable<z.ZodString>;
+  scheduledAt: z.ZodNullable<z.ZodString>;
   updatedAt: z.ZodString;
   revision: z.ZodString;
   verdict: z.ZodObject<{
@@ -694,6 +710,15 @@ declare const review: z.ZodObject<{
   decidedAt: z.ZodNullable<z.ZodString>;
   note: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
+/** A comment on a review (v0.6), by a person or by the agent of one. */
+declare const reviewComment: z.ZodObject<{
+  id: z.ZodString;
+  author: z.ZodString;
+  authorName: z.ZodNullable<z.ZodString>;
+  client: z.ZodNullable<z.ZodString>;
+  body: z.ZodString;
+  at: z.ZodString;
+}, z.core.$strip>;
 declare const conflict: z.ZodObject<{
   currentVersion: z.ZodNumber;
   headRevision: z.ZodString;
@@ -759,6 +784,7 @@ declare const siteDescription: z.ZodObject<{
   key: z.ZodString;
   locales: z.ZodArray<z.ZodString>;
   defaultLocale: z.ZodString;
+  url: z.ZodNullable<z.ZodString>;
   styleGuide: z.ZodNullable<z.ZodString>;
   collections: z.ZodArray<z.ZodObject<{
     name: z.ZodString;
@@ -827,6 +853,79 @@ export declare const REFUSAL_CONTRACT_IDS: readonly string[];
  */
 export declare function describeBuiltInContracts(): ContractDescription[];
 //#endregion
+//#region src/contracts/catalog.d.ts
+/** A rule of the catalog. */
+interface CatalogRule {
+  readonly name: string;
+  readonly description: string;
+  readonly params: z.ZodType<Readonly<Record<string, unknown>>>;
+  make(params: Readonly<Record<string, unknown>>, severity: Severity, id?: string): Contract<unknown>;
+}
+export declare const CATALOG: readonly CatalogRule[];
+/** A rule of the catalog by its name, or `undefined`. */
+export declare function catalogRule(name: string): CatalogRule | undefined;
+/** The catalog as `describe_site` shows it: each rule with the JSON Schema of its parameters. */
+export declare function describeCatalog(): {
+  name: string;
+  description: string;
+  params: Record<string, unknown>;
+}[];
+//#endregion
+//#region src/contracts/hash.d.ts
+/**
+ * `contractsHash` (ADR-004): what a revision was checked against, in a short string. A stored
+ * verdict says which rules it answered to, and a changed rule shows as another hash.
+ */
+/**
+ * JSON with the keys of every object in order and no spaces, so that equal values always give
+ * the same text. Arrays keep their order, which means something there. An `undefined` member is
+ * left out, as `JSON.stringify` does.
+ */
+export declare function canonicalJson(value: unknown): string;
+//#endregion
+//#region src/contracts/rules.d.ts
+/**
+ * The generic rules of the catalog (ADR-033): what a site asks of its entries without writing
+ * code, each one data with parameters. A rule reads a field of the frontmatter by its name, at
+ * the top of it; one that is absent or of another type is the schema's to report, so the rule
+ * passes it.
+ */
+interface RuleOptions {
+  readonly severity?: Severity;
+  /** The id of the contract, when a collection has this rule twice: `field-length` otherwise. */
+  readonly id?: string;
+}
+interface FieldLengthParams {
+  readonly field: string;
+  readonly min?: number;
+  readonly max?: number;
+  /** A field whose presence lifts the rule: a title may be long when a `seoTitle` is given. */
+  readonly unless?: string;
+}
+/** A text, or a list, of a field has between `min` and `max` characters or items. */
+declare function fieldLength(params: FieldLengthParams, options?: RuleOptions): Contract<unknown>;
+interface FieldPatternParams {
+  readonly field: string;
+  /** A regular expression (Unicode) the whole text must match. */
+  readonly pattern: string;
+  /** What the pattern asks for, in words: `a slug of lowercase words`. */
+  readonly description: string;
+}
+/** A text field matches a pattern. */
+declare function fieldPattern(params: FieldPatternParams, options?: RuleOptions): Contract<unknown>;
+interface RequiredToPublishParams {
+  readonly fields: readonly string[];
+}
+/** Fields a draft may lack and a published entry must have, with something in them. */
+declare function requiredToPublish(params: RequiredToPublishParams, options?: RuleOptions): Contract<unknown>;
+interface BannedWordsParams {
+  readonly words: readonly string[];
+  /** Why the words are out, for the fix: `the brand is spelled Hollware`. */
+  readonly reason?: string;
+}
+/** Words that may appear neither in a text field of the frontmatter nor in the body. */
+declare function bannedWords(params: BannedWordsParams, options?: RuleOptions): Contract<unknown>;
+//#endregion
 //#region src/contracts/opt-in.d.ts
 /**
  * The built-in contracts a collection opts into by listing them in its `contracts`, and the
@@ -836,6 +935,8 @@ export declare function describeBuiltInContracts(): ContractDescription[];
 interface BuiltInOptions {
   /** `error` unless given: an error blocks publishing, a warning has to be acknowledged. */
   readonly severity?: Severity;
+  /** The id of the contract, when a collection lists the rule twice; the rule's name otherwise. */
+  readonly id?: string;
 }
 /**
  * Every locale of the site has an entry in the translation group of this one. It reads the group
@@ -881,9 +982,13 @@ interface CustomContractOptions<Frontmatter> {
  */
 declare function custom<Frontmatter = Record<string, unknown>>(options: CustomContractOptions<Frontmatter>): Contract<Frontmatter>;
 export declare const contracts: {
+  readonly bannedWords: typeof bannedWords;
   readonly custom: typeof custom;
+  readonly fieldLength: typeof fieldLength;
+  readonly fieldPattern: typeof fieldPattern;
   readonly imagesHaveAlt: typeof imagesHaveAlt;
   readonly internalLinksResolve: typeof internalLinksResolve;
+  readonly requiredToPublish: typeof requiredToPublish;
   readonly translationPair: typeof translationPair;
 };
 //#endregion
@@ -1009,6 +1114,132 @@ export declare const SITE_KEY_MAX_LENGTH = 64;
 /** Whether a value is a site key: a string that fits `SITE_KEY_PATTERN` and is not too long. */
 export declare function isSiteKey(value: unknown): value is string;
 //#endregion
+//#region src/structure/compile.d.ts
+/** The definitions of the sites, read from D1 as JSON, checked and resolved. */
+export declare function compileSites(definitions: Readonly<Record<string, unknown>>): ResolvedConfig;
+//#endregion
+//#region src/structure/definition.d.ts
+export declare const ruleDefinition: z.ZodObject<{
+  rule: z.ZodString;
+  severity: z.ZodDefault<z.ZodEnum<{
+    error: "error";
+    warning: "warning";
+  }>>;
+  params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  id: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const componentDefinitionData: z.ZodObject<{
+  props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  description: z.ZodOptional<z.ZodString>;
+  example: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const collectionDefinitionData: z.ZodObject<{
+  schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  routes: z.ZodRecord<z.ZodString, z.ZodString>;
+  translationGroupField: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+  tagsField: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+  sortByField: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+  components: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+    props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    description: z.ZodOptional<z.ZodString>;
+    example: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>>;
+  rules: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    rule: z.ZodString;
+    severity: z.ZodDefault<z.ZodEnum<{
+      error: "error";
+      warning: "warning";
+    }>>;
+    params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    id: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>>;
+  maxMarkdownBytes: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+  styleGuide: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export declare const webhookDefinition: z.ZodObject<{
+  name: z.ZodString;
+  url: z.ZodString;
+  secret: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const siteDefinitionData: z.ZodObject<{
+  locales: z.ZodArray<z.ZodString>;
+  defaultLocale: z.ZodString;
+  url: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+  styleGuide: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+  cors: z.ZodDefault<z.ZodObject<{
+    origins: z.ZodArray<z.ZodString>;
+  }, z.core.$strict>>;
+  events: z.ZodDefault<z.ZodObject<{
+    webhooks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      url: z.ZodString;
+      secret: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    indexNow: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+      key: z.ZodString;
+    }, z.core.$strict>>>;
+  }, z.core.$strict>>;
+  collections: z.ZodRecord<z.ZodString, z.ZodObject<{
+    schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    routes: z.ZodRecord<z.ZodString, z.ZodString>;
+    translationGroupField: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    tagsField: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    sortByField: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    components: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+      props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+      description: z.ZodOptional<z.ZodString>;
+      example: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    rules: z.ZodDefault<z.ZodArray<z.ZodObject<{
+      rule: z.ZodString;
+      severity: z.ZodDefault<z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+      }>>;
+      params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+      id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    maxMarkdownBytes: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    styleGuide: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+  }, z.core.$strict>>;
+}, z.core.$strict>;
+type RuleDefinition = z.output<typeof ruleDefinition>;
+type CollectionDefinitionData = z.output<typeof collectionDefinitionData>;
+type SiteDefinitionData = z.output<typeof siteDefinitionData>;
+/** A definition as a person or an agent writes it, with the defaults left out. */
+type SiteDefinitionInput = z.input<typeof siteDefinitionData>;
+//#endregion
+//#region src/structure/from-config.d.ts
+/** Every site of the config as a definition, or a `ConfigError` with what keeps one from moving. */
+export declare function definitionsFromConfig(config: HollwareConfig): Record<string, SiteDefinitionInput>;
+//#endregion
+//#region src/structure/json-schema.d.ts
+/**
+ * A JSON Schema stored in D1 (ADR-033) as the schema of a collection or of a component's props:
+ * validated by `@cfworker/json-schema`, which runs in Workers without `eval`, and seen by the
+ * rest of Hollware as any Standard Schema, so that the schema contract, its fixes and
+ * `describe_site` treat it as they treat a Zod schema. It accepts the value as it is: a JSON
+ * Schema returns no other value than the one it checked.
+ */
+type JsonObject = Record<string, unknown>;
+/** A JSON Schema (draft 2020-12) as a schema of Hollware. */
+export declare function describedSchemaOf(schema: JsonObject): DescribedSchema;
+//#endregion
+//#region src/structure/presets.d.ts
+/**
+ * Where a new collection or site starts (ADR-033), in the admin and in `hollware init`: a blog, docs, or nothing. Each is a definition
+ * the person then changes, with a route per locale that the collection's name begins.
+ */
+type Definition = SiteDefinitionData;
+type CollectionDefinition$1 = CollectionDefinitionData;
+export declare const PRESETS: readonly ['blog', 'docs', 'empty'];
+type Preset = (typeof PRESETS)[number];
+/** The path of an entry in each locale: the default one at the root, the others under theirs. */
+export declare function routesFor(name: string, locales: readonly string[], defaultLocale: string): Record<string, string>;
+export declare function collectionPreset(preset: Preset, name: string, locales: readonly string[], defaultLocale: string): CollectionDefinition$1;
+/** A new site: its locales, and one collection from the preset. */
+export declare function sitePreset(preset: Preset, locales: readonly string[], defaultLocale: string): Definition;
+//#endregion
 //#region src/errors.d.ts
 /**
  * The errors of an operation that are none of its outcomes: the caller asked for something it
@@ -1064,8 +1295,11 @@ export declare const ID_PREFIXES: {
   readonly revision: 'rev';
   readonly revisionTag: 'tag';
   readonly review: 'rvw';
+  readonly reviewComment: 'rvc';
   readonly schedule: 'sch';
   readonly session: 'ses';
+  readonly siteChange: 'sit';
+  readonly siteSecret: 'sec';
   readonly token: 'tok';
   readonly user: 'usr';
 };
@@ -1179,6 +1413,7 @@ export declare const describeSite: OperationSpec<"describe_site", z.ZodObject<{}
     key: z.ZodString;
     locales: z.ZodArray<z.ZodString>;
     defaultLocale: z.ZodString;
+    url: z.ZodNullable<z.ZodString>;
     styleGuide: z.ZodNullable<z.ZodString>;
     collections: z.ZodArray<z.ZodObject<{
       name: z.ZodString;
@@ -1241,6 +1476,7 @@ export declare const listEntries: OperationSpec<"list_entries", z.ZodObject<{
     tags: z.ZodArray<z.ZodString>;
     hasUnpublishedChanges: z.ZodBoolean;
     publishedAt: z.ZodNullable<z.ZodString>;
+    scheduledAt: z.ZodNullable<z.ZodString>;
     updatedAt: z.ZodString;
   }, z.core.$strip>>;
   nextCursor: z.ZodNullable<z.ZodString>;
@@ -1281,6 +1517,7 @@ export declare const search: OperationSpec<"search", z.ZodObject<{
       tags: z.ZodArray<z.ZodString>;
       hasUnpublishedChanges: z.ZodBoolean;
       publishedAt: z.ZodNullable<z.ZodString>;
+      scheduledAt: z.ZodNullable<z.ZodString>;
       updatedAt: z.ZodString;
     }, z.core.$strip>;
     snippet: z.ZodString;
@@ -1319,6 +1556,7 @@ export declare const getEntry: OperationSpec<"get_entry", z.ZodObject<{
     tags: z.ZodArray<z.ZodString>;
     hasUnpublishedChanges: z.ZodBoolean;
     publishedAt: z.ZodNullable<z.ZodString>;
+    scheduledAt: z.ZodNullable<z.ZodString>;
     updatedAt: z.ZodString;
     revision: z.ZodString;
     verdict: z.ZodObject<{
@@ -1413,6 +1651,7 @@ export declare const getEntry: OperationSpec<"get_entry", z.ZodObject<{
     tags: z.ZodArray<z.ZodString>;
     hasUnpublishedChanges: z.ZodBoolean;
     publishedAt: z.ZodNullable<z.ZodString>;
+    scheduledAt: z.ZodNullable<z.ZodString>;
     updatedAt: z.ZodString;
   }, z.core.$strip>>>;
 }, z.core.$strip>>;
@@ -1440,6 +1679,7 @@ export declare const getTranslations: OperationSpec<"get_translations", z.ZodObj
     tags: z.ZodArray<z.ZodString>;
     hasUnpublishedChanges: z.ZodBoolean;
     publishedAt: z.ZodNullable<z.ZodString>;
+    scheduledAt: z.ZodNullable<z.ZodString>;
     updatedAt: z.ZodString;
   }, z.core.$strip>>>;
 }, z.core.$strip>>;
@@ -1469,6 +1709,7 @@ export declare const createDraft: OperationSpec<"create_draft", z.ZodObject<{
     tags: z.ZodArray<z.ZodString>;
     hasUnpublishedChanges: z.ZodBoolean;
     publishedAt: z.ZodNullable<z.ZodString>;
+    scheduledAt: z.ZodNullable<z.ZodString>;
     updatedAt: z.ZodString;
   }, z.core.$strip>>;
   verdict: z.ZodOptional<z.ZodObject<{
@@ -1530,6 +1771,7 @@ export declare const updateDraft: OperationSpec<"update_draft", z.ZodObject<{
     tags: z.ZodArray<z.ZodString>;
     hasUnpublishedChanges: z.ZodBoolean;
     publishedAt: z.ZodNullable<z.ZodString>;
+    scheduledAt: z.ZodNullable<z.ZodString>;
     updatedAt: z.ZodString;
   }, z.core.$strip>>;
   verdict: z.ZodOptional<z.ZodObject<{
@@ -1645,6 +1887,7 @@ export declare const publish: OperationSpec<"publish", z.ZodObject<{
     tags: z.ZodArray<z.ZodString>;
     hasUnpublishedChanges: z.ZodBoolean;
     publishedAt: z.ZodNullable<z.ZodString>;
+    scheduledAt: z.ZodNullable<z.ZodString>;
     updatedAt: z.ZodString;
   }, z.core.$strip>>;
   verdict: z.ZodOptional<z.ZodObject<{
@@ -1723,6 +1966,7 @@ export declare const unpublish: OperationSpec<"unpublish", z.ZodObject<{
     tags: z.ZodArray<z.ZodString>;
     hasUnpublishedChanges: z.ZodBoolean;
     publishedAt: z.ZodNullable<z.ZodString>;
+    scheduledAt: z.ZodNullable<z.ZodString>;
     updatedAt: z.ZodString;
   }, z.core.$strip>>;
 }, z.core.$strip>>;
@@ -1770,8 +2014,17 @@ export declare const listReviews: OperationSpec<"list_reviews", z.ZodObject<{
       tags: z.ZodArray<z.ZodString>;
       hasUnpublishedChanges: z.ZodBoolean;
       publishedAt: z.ZodNullable<z.ZodString>;
+      scheduledAt: z.ZodNullable<z.ZodString>;
       updatedAt: z.ZodString;
     }, z.core.$strip>;
+    comments: z.ZodArray<z.ZodObject<{
+      id: z.ZodString;
+      author: z.ZodString;
+      authorName: z.ZodNullable<z.ZodString>;
+      client: z.ZodNullable<z.ZodString>;
+      body: z.ZodString;
+      at: z.ZodString;
+    }, z.core.$strip>>;
   }, z.core.$strip>>;
 }, z.core.$strip>>;
 export declare const approveReview: OperationSpec<"approve_review", z.ZodObject<{
@@ -1821,6 +2074,7 @@ export declare const approveReview: OperationSpec<"approve_review", z.ZodObject<
     tags: z.ZodArray<z.ZodString>;
     hasUnpublishedChanges: z.ZodBoolean;
     publishedAt: z.ZodNullable<z.ZodString>;
+    scheduledAt: z.ZodNullable<z.ZodString>;
     updatedAt: z.ZodString;
   }, z.core.$strip>>;
   verdict: z.ZodOptional<z.ZodObject<{
@@ -1854,6 +2108,110 @@ export declare const approveReview: OperationSpec<"approve_review", z.ZodObject<
     contractsHash: z.ZodString;
   }, z.core.$strip>>;
 }, z.core.$strip>>;
+export declare const requestReview: OperationSpec<"request_review", z.ZodObject<{
+  id: z.ZodString;
+  version: z.ZodNumber;
+  acknowledgeWarnings: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    contract: z.ZodString;
+    path: z.ZodString;
+  }, z.core.$strip>>>;
+}, z.core.$strict>, z.ZodObject<{
+  outcome: z.ZodEnum<{
+    blocked: "blocked";
+    conflict: "conflict";
+    needs_acknowledgement: "needs_acknowledgement";
+    not_found: "not_found";
+    pending_review: "pending_review";
+  }>;
+  entry: z.ZodOptional<z.ZodObject<{
+    id: z.ZodString;
+    collection: z.ZodString;
+    locale: z.ZodString;
+    slug: z.ZodString;
+    translationGroup: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<{
+      draft: "draft";
+      published: "published";
+      scheduled: "scheduled";
+    }>;
+    version: z.ZodNumber;
+    frontmatter: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    tags: z.ZodArray<z.ZodString>;
+    hasUnpublishedChanges: z.ZodBoolean;
+    publishedAt: z.ZodNullable<z.ZodString>;
+    scheduledAt: z.ZodNullable<z.ZodString>;
+    updatedAt: z.ZodString;
+  }, z.core.$strip>>;
+  verdict: z.ZodOptional<z.ZodObject<{
+    ok: z.ZodBoolean;
+    phase: z.ZodEnum<{
+      publish: "publish";
+      write: "write";
+    }>;
+    errors: z.ZodArray<z.ZodObject<{
+      contract: z.ZodString;
+      severity: z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+      }>;
+      path: z.ZodString;
+      message: z.ZodString;
+      fix: z.ZodString;
+      line: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    warnings: z.ZodArray<z.ZodObject<{
+      contract: z.ZodString;
+      severity: z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+      }>;
+      path: z.ZodString;
+      message: z.ZodString;
+      fix: z.ZodString;
+      line: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    contractsHash: z.ZodString;
+  }, z.core.$strip>>;
+  conflict: z.ZodOptional<z.ZodObject<{
+    currentVersion: z.ZodNumber;
+    headRevision: z.ZodString;
+  }, z.core.$strip>>;
+  review: z.ZodOptional<z.ZodObject<{
+    id: z.ZodString;
+    entryId: z.ZodString;
+    revision: z.ZodString;
+    status: z.ZodEnum<{
+      approved: "approved";
+      cancelled: "cancelled";
+      changes_requested: "changes_requested";
+      pending: "pending";
+    }>;
+    requestedBy: z.ZodString;
+    requestedByName: z.ZodNullable<z.ZodString>;
+    requestedAt: z.ZodString;
+    decidedBy: z.ZodNullable<z.ZodString>;
+    decidedAt: z.ZodNullable<z.ZodString>;
+    note: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>>;
+export declare const commentReview: OperationSpec<"comment_review", z.ZodObject<{
+  id: z.ZodString;
+  body: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+  outcome: z.ZodEnum<{
+    commented: "commented";
+    not_found: "not_found";
+    not_pending: "not_pending";
+  }>;
+  comment: z.ZodOptional<z.ZodObject<{
+    id: z.ZodString;
+    author: z.ZodString;
+    authorName: z.ZodNullable<z.ZodString>;
+    client: z.ZodNullable<z.ZodString>;
+    body: z.ZodString;
+    at: z.ZodString;
+  }, z.core.$strip>>;
+}, z.core.$strip>>;
 export declare const requestChanges: OperationSpec<"request_changes", z.ZodObject<{
   id: z.ZodString;
   note: z.ZodString;
@@ -1909,6 +2267,7 @@ export declare const contentStats: OperationSpec<"content_stats", z.ZodObject<{
       tags: z.ZodArray<z.ZodString>;
       hasUnpublishedChanges: z.ZodBoolean;
       publishedAt: z.ZodNullable<z.ZodString>;
+      scheduledAt: z.ZodNullable<z.ZodString>;
       updatedAt: z.ZodString;
     }, z.core.$strip>>;
   }, z.core.$strip>>>;
@@ -1961,6 +2320,7 @@ export declare const OPERATIONS: readonly [OperationSpec<"approve_review", z.Zod
     tags: z.ZodArray<z.ZodString>;
     hasUnpublishedChanges: z.ZodBoolean;
     publishedAt: z.ZodNullable<z.ZodString>;
+    scheduledAt: z.ZodNullable<z.ZodString>;
     updatedAt: z.ZodString;
   }, z.core.$strip>>;
   verdict: z.ZodOptional<z.ZodObject<{
@@ -1993,6 +2353,23 @@ export declare const OPERATIONS: readonly [OperationSpec<"approve_review", z.Zod
     }, z.core.$strip>>;
     contractsHash: z.ZodString;
   }, z.core.$strip>>;
+}, z.core.$strip>>, OperationSpec<"comment_review", z.ZodObject<{
+  id: z.ZodString;
+  body: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+  outcome: z.ZodEnum<{
+    commented: "commented";
+    not_found: "not_found";
+    not_pending: "not_pending";
+  }>;
+  comment: z.ZodOptional<z.ZodObject<{
+    id: z.ZodString;
+    author: z.ZodString;
+    authorName: z.ZodNullable<z.ZodString>;
+    client: z.ZodNullable<z.ZodString>;
+    body: z.ZodString;
+    at: z.ZodString;
+  }, z.core.$strip>>;
 }, z.core.$strip>>, OperationSpec<"content_stats", z.ZodObject<{
   days: z.ZodDefault<z.ZodNumber>;
   limit: z.ZodDefault<z.ZodNumber>;
@@ -2021,6 +2398,7 @@ export declare const OPERATIONS: readonly [OperationSpec<"approve_review", z.Zod
       tags: z.ZodArray<z.ZodString>;
       hasUnpublishedChanges: z.ZodBoolean;
       publishedAt: z.ZodNullable<z.ZodString>;
+      scheduledAt: z.ZodNullable<z.ZodString>;
       updatedAt: z.ZodString;
     }, z.core.$strip>>;
   }, z.core.$strip>>>;
@@ -2050,6 +2428,7 @@ export declare const OPERATIONS: readonly [OperationSpec<"approve_review", z.Zod
     tags: z.ZodArray<z.ZodString>;
     hasUnpublishedChanges: z.ZodBoolean;
     publishedAt: z.ZodNullable<z.ZodString>;
+    scheduledAt: z.ZodNullable<z.ZodString>;
     updatedAt: z.ZodString;
   }, z.core.$strip>>;
   verdict: z.ZodOptional<z.ZodObject<{
@@ -2082,6 +2461,72 @@ export declare const OPERATIONS: readonly [OperationSpec<"approve_review", z.Zod
     }, z.core.$strip>>;
     contractsHash: z.ZodString;
   }, z.core.$strip>>;
+}, z.core.$strip>>, OperationSpec<"create_site", z.ZodObject<{
+  key: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+  definition: z.ZodObject<{
+    locales: z.ZodArray<z.ZodString>;
+    defaultLocale: z.ZodString;
+    url: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    styleGuide: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    cors: z.ZodDefault<z.ZodObject<{
+      origins: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    events: z.ZodDefault<z.ZodObject<{
+      webhooks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        url: z.ZodString;
+        secret: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>>>;
+      indexNow: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        key: z.ZodString;
+      }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    collections: z.ZodRecord<z.ZodString, z.ZodObject<{
+      schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+      routes: z.ZodRecord<z.ZodString, z.ZodString>;
+      translationGroupField: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+      tagsField: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+      sortByField: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+      components: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        description: z.ZodOptional<z.ZodString>;
+        example: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>>>;
+      rules: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        rule: z.ZodString;
+        severity: z.ZodDefault<z.ZodEnum<{
+          error: "error";
+          warning: "warning";
+        }>>;
+        params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        id: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>>>;
+      maxMarkdownBytes: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+      styleGuide: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>;
+  }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+  outcome: z.ZodEnum<{
+    created: "created";
+    invalid: "invalid";
+    taken: "taken";
+  }>;
+  version: z.ZodOptional<z.ZodNumber>;
+  problems: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    path: z.ZodString;
+    message: z.ZodString;
+    fix: z.ZodString;
+  }, z.core.$strip>>>;
+}, z.core.$strip>>, OperationSpec<"delete_site", z.ZodObject<{
+  key: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+  confirm: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>, z.ZodObject<{
+  outcome: z.ZodEnum<{
+    needs_confirmation: "needs_confirmation";
+    not_found: "not_found";
+    trashed: "trashed";
+  }>;
+  entries: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>>, OperationSpec<"describe_site", z.ZodObject<{}, z.core.$strict>, z.ZodObject<{
   outcome: z.ZodEnum<{
     ok: "ok";
@@ -2090,6 +2535,7 @@ export declare const OPERATIONS: readonly [OperationSpec<"approve_review", z.Zod
     key: z.ZodString;
     locales: z.ZodArray<z.ZodString>;
     defaultLocale: z.ZodString;
+    url: z.ZodNullable<z.ZodString>;
     styleGuide: z.ZodNullable<z.ZodString>;
     collections: z.ZodArray<z.ZodObject<{
       name: z.ZodString;
@@ -2152,6 +2598,7 @@ export declare const OPERATIONS: readonly [OperationSpec<"approve_review", z.Zod
     tags: z.ZodArray<z.ZodString>;
     hasUnpublishedChanges: z.ZodBoolean;
     publishedAt: z.ZodNullable<z.ZodString>;
+    scheduledAt: z.ZodNullable<z.ZodString>;
     updatedAt: z.ZodString;
     revision: z.ZodString;
     verdict: z.ZodObject<{
@@ -2246,8 +2693,62 @@ export declare const OPERATIONS: readonly [OperationSpec<"approve_review", z.Zod
     tags: z.ZodArray<z.ZodString>;
     hasUnpublishedChanges: z.ZodBoolean;
     publishedAt: z.ZodNullable<z.ZodString>;
+    scheduledAt: z.ZodNullable<z.ZodString>;
     updatedAt: z.ZodString;
   }, z.core.$strip>>>;
+}, z.core.$strip>>, OperationSpec<"get_structure", z.ZodObject<{}, z.core.$strict>, z.ZodObject<{
+  outcome: z.ZodEnum<{
+    ok: "ok";
+  }>;
+  site: z.ZodString;
+  version: z.ZodNumber;
+  definition: z.ZodObject<{
+    locales: z.ZodArray<z.ZodString>;
+    defaultLocale: z.ZodString;
+    url: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    styleGuide: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    cors: z.ZodDefault<z.ZodObject<{
+      origins: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    events: z.ZodDefault<z.ZodObject<{
+      webhooks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        url: z.ZodString;
+        secret: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>>>;
+      indexNow: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        key: z.ZodString;
+      }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    collections: z.ZodRecord<z.ZodString, z.ZodObject<{
+      schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+      routes: z.ZodRecord<z.ZodString, z.ZodString>;
+      translationGroupField: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+      tagsField: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+      sortByField: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+      components: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        description: z.ZodOptional<z.ZodString>;
+        example: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>>>;
+      rules: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        rule: z.ZodString;
+        severity: z.ZodDefault<z.ZodEnum<{
+          error: "error";
+          warning: "warning";
+        }>>;
+        params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        id: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>>>;
+      maxMarkdownBytes: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+      styleGuide: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>;
+  }, z.core.$strict>;
+  catalog: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  }, z.core.$strip>>;
 }, z.core.$strip>>, OperationSpec<"get_translations", z.ZodObject<{
   collection: z.ZodString;
   translationGroup: z.ZodString;
@@ -2272,6 +2773,7 @@ export declare const OPERATIONS: readonly [OperationSpec<"approve_review", z.Zod
     tags: z.ZodArray<z.ZodString>;
     hasUnpublishedChanges: z.ZodBoolean;
     publishedAt: z.ZodNullable<z.ZodString>;
+    scheduledAt: z.ZodNullable<z.ZodString>;
     updatedAt: z.ZodString;
   }, z.core.$strip>>>;
 }, z.core.$strip>>, OperationSpec<"list_entries", z.ZodObject<{
@@ -2305,6 +2807,7 @@ export declare const OPERATIONS: readonly [OperationSpec<"approve_review", z.Zod
     tags: z.ZodArray<z.ZodString>;
     hasUnpublishedChanges: z.ZodBoolean;
     publishedAt: z.ZodNullable<z.ZodString>;
+    scheduledAt: z.ZodNullable<z.ZodString>;
     updatedAt: z.ZodString;
   }, z.core.$strip>>;
   nextCursor: z.ZodNullable<z.ZodString>;
@@ -2352,9 +2855,27 @@ export declare const OPERATIONS: readonly [OperationSpec<"approve_review", z.Zod
       tags: z.ZodArray<z.ZodString>;
       hasUnpublishedChanges: z.ZodBoolean;
       publishedAt: z.ZodNullable<z.ZodString>;
+      scheduledAt: z.ZodNullable<z.ZodString>;
       updatedAt: z.ZodString;
     }, z.core.$strip>;
+    comments: z.ZodArray<z.ZodObject<{
+      id: z.ZodString;
+      author: z.ZodString;
+      authorName: z.ZodNullable<z.ZodString>;
+      client: z.ZodNullable<z.ZodString>;
+      body: z.ZodString;
+      at: z.ZodString;
+    }, z.core.$strip>>;
   }, z.core.$strip>>;
+}, z.core.$strip>>, OperationSpec<"make_webhook_secret", z.ZodObject<{
+  webhook: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+  outcome: z.ZodEnum<{
+    made: "made";
+    not_found: "not_found";
+    unavailable: "unavailable";
+  }>;
+  secret: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>>, OperationSpec<"publish", z.ZodObject<{
   id: z.ZodString;
   version: z.ZodNumber;
@@ -2393,6 +2914,7 @@ export declare const OPERATIONS: readonly [OperationSpec<"approve_review", z.Zod
     tags: z.ZodArray<z.ZodString>;
     hasUnpublishedChanges: z.ZodBoolean;
     publishedAt: z.ZodNullable<z.ZodString>;
+    scheduledAt: z.ZodNullable<z.ZodString>;
     updatedAt: z.ZodString;
   }, z.core.$strip>>;
   verdict: z.ZodOptional<z.ZodObject<{
@@ -2473,6 +2995,98 @@ export declare const OPERATIONS: readonly [OperationSpec<"approve_review", z.Zod
     decidedAt: z.ZodNullable<z.ZodString>;
     note: z.ZodNullable<z.ZodString>;
   }, z.core.$strip>>;
+}, z.core.$strip>>, OperationSpec<"request_review", z.ZodObject<{
+  id: z.ZodString;
+  version: z.ZodNumber;
+  acknowledgeWarnings: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    contract: z.ZodString;
+    path: z.ZodString;
+  }, z.core.$strip>>>;
+}, z.core.$strict>, z.ZodObject<{
+  outcome: z.ZodEnum<{
+    blocked: "blocked";
+    conflict: "conflict";
+    needs_acknowledgement: "needs_acknowledgement";
+    not_found: "not_found";
+    pending_review: "pending_review";
+  }>;
+  entry: z.ZodOptional<z.ZodObject<{
+    id: z.ZodString;
+    collection: z.ZodString;
+    locale: z.ZodString;
+    slug: z.ZodString;
+    translationGroup: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<{
+      draft: "draft";
+      published: "published";
+      scheduled: "scheduled";
+    }>;
+    version: z.ZodNumber;
+    frontmatter: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    tags: z.ZodArray<z.ZodString>;
+    hasUnpublishedChanges: z.ZodBoolean;
+    publishedAt: z.ZodNullable<z.ZodString>;
+    scheduledAt: z.ZodNullable<z.ZodString>;
+    updatedAt: z.ZodString;
+  }, z.core.$strip>>;
+  verdict: z.ZodOptional<z.ZodObject<{
+    ok: z.ZodBoolean;
+    phase: z.ZodEnum<{
+      publish: "publish";
+      write: "write";
+    }>;
+    errors: z.ZodArray<z.ZodObject<{
+      contract: z.ZodString;
+      severity: z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+      }>;
+      path: z.ZodString;
+      message: z.ZodString;
+      fix: z.ZodString;
+      line: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    warnings: z.ZodArray<z.ZodObject<{
+      contract: z.ZodString;
+      severity: z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+      }>;
+      path: z.ZodString;
+      message: z.ZodString;
+      fix: z.ZodString;
+      line: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    contractsHash: z.ZodString;
+  }, z.core.$strip>>;
+  conflict: z.ZodOptional<z.ZodObject<{
+    currentVersion: z.ZodNumber;
+    headRevision: z.ZodString;
+  }, z.core.$strip>>;
+  review: z.ZodOptional<z.ZodObject<{
+    id: z.ZodString;
+    entryId: z.ZodString;
+    revision: z.ZodString;
+    status: z.ZodEnum<{
+      approved: "approved";
+      cancelled: "cancelled";
+      changes_requested: "changes_requested";
+      pending: "pending";
+    }>;
+    requestedBy: z.ZodString;
+    requestedByName: z.ZodNullable<z.ZodString>;
+    requestedAt: z.ZodString;
+    decidedBy: z.ZodNullable<z.ZodString>;
+    decidedAt: z.ZodNullable<z.ZodString>;
+    note: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>>, OperationSpec<"restore_site", z.ZodObject<{
+  key: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+}, z.core.$strict>, z.ZodObject<{
+  outcome: z.ZodEnum<{
+    not_found: "not_found";
+    restored: "restored";
+  }>;
 }, z.core.$strip>>, OperationSpec<"search", z.ZodObject<{
   query: z.ZodString;
   collection: z.ZodOptional<z.ZodString>;
@@ -2509,11 +3123,69 @@ export declare const OPERATIONS: readonly [OperationSpec<"approve_review", z.Zod
       tags: z.ZodArray<z.ZodString>;
       hasUnpublishedChanges: z.ZodBoolean;
       publishedAt: z.ZodNullable<z.ZodString>;
+      scheduledAt: z.ZodNullable<z.ZodString>;
       updatedAt: z.ZodString;
     }, z.core.$strip>;
     snippet: z.ZodString;
     score: z.ZodNumber;
   }, z.core.$strip>>;
+}, z.core.$strip>>, OperationSpec<"set_collection", z.ZodObject<{
+  version: z.ZodNumber;
+  name: z.ZodString;
+  collection: z.ZodNullable<z.ZodObject<{
+    schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    routes: z.ZodRecord<z.ZodString, z.ZodString>;
+    translationGroupField: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    tagsField: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    sortByField: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    components: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+      props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+      description: z.ZodOptional<z.ZodString>;
+      example: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    rules: z.ZodDefault<z.ZodArray<z.ZodObject<{
+      rule: z.ZodString;
+      severity: z.ZodDefault<z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+      }>>;
+      params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+      id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    maxMarkdownBytes: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    styleGuide: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+  }, z.core.$strict>>;
+  confirm: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>, z.ZodObject<{
+  outcome: z.ZodEnum<{
+    conflict: "conflict";
+    invalid: "invalid";
+    needs_confirmation: "needs_confirmation";
+    unchanged: "unchanged";
+    updated: "updated";
+  }>;
+  version: z.ZodOptional<z.ZodNumber>;
+  problems: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    path: z.ZodString;
+    message: z.ZodString;
+    fix: z.ZodString;
+  }, z.core.$strip>>>;
+  impact: z.ZodOptional<z.ZodObject<{
+    removedCollections: z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      entries: z.ZodNumber;
+    }, z.core.$strip>>;
+    removedLocales: z.ZodArray<z.ZodObject<{
+      locale: z.ZodString;
+      entries: z.ZodNumber;
+    }, z.core.$strip>>;
+    refused: z.ZodArray<z.ZodObject<{
+      collection: z.ZodString;
+      entries: z.ZodNumber;
+      examples: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
+  currentVersion: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>>, OperationSpec<"unpublish", z.ZodObject<{
   id: z.ZodString;
 }, z.core.$strict>, z.ZodObject<{
@@ -2537,6 +3209,7 @@ export declare const OPERATIONS: readonly [OperationSpec<"approve_review", z.Zod
     tags: z.ZodArray<z.ZodString>;
     hasUnpublishedChanges: z.ZodBoolean;
     publishedAt: z.ZodNullable<z.ZodString>;
+    scheduledAt: z.ZodNullable<z.ZodString>;
     updatedAt: z.ZodString;
   }, z.core.$strip>>;
 }, z.core.$strip>>, OperationSpec<"update_draft", z.ZodObject<{
@@ -2567,6 +3240,7 @@ export declare const OPERATIONS: readonly [OperationSpec<"approve_review", z.Zod
     tags: z.ZodArray<z.ZodString>;
     hasUnpublishedChanges: z.ZodBoolean;
     publishedAt: z.ZodNullable<z.ZodString>;
+    scheduledAt: z.ZodNullable<z.ZodString>;
     updatedAt: z.ZodString;
   }, z.core.$strip>>;
   verdict: z.ZodOptional<z.ZodObject<{
@@ -2603,6 +3277,81 @@ export declare const OPERATIONS: readonly [OperationSpec<"approve_review", z.Zod
     currentVersion: z.ZodNumber;
     headRevision: z.ZodString;
   }, z.core.$strip>>;
+}, z.core.$strip>>, OperationSpec<"update_site", z.ZodObject<{
+  version: z.ZodNumber;
+  definition: z.ZodObject<{
+    locales: z.ZodArray<z.ZodString>;
+    defaultLocale: z.ZodString;
+    url: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    styleGuide: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    cors: z.ZodDefault<z.ZodObject<{
+      origins: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    events: z.ZodDefault<z.ZodObject<{
+      webhooks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        url: z.ZodString;
+        secret: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>>>;
+      indexNow: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        key: z.ZodString;
+      }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    collections: z.ZodRecord<z.ZodString, z.ZodObject<{
+      schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+      routes: z.ZodRecord<z.ZodString, z.ZodString>;
+      translationGroupField: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+      tagsField: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+      sortByField: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+      components: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        description: z.ZodOptional<z.ZodString>;
+        example: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>>>;
+      rules: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        rule: z.ZodString;
+        severity: z.ZodDefault<z.ZodEnum<{
+          error: "error";
+          warning: "warning";
+        }>>;
+        params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        id: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>>>;
+      maxMarkdownBytes: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+      styleGuide: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>;
+  }, z.core.$strict>;
+  confirm: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>, z.ZodObject<{
+  outcome: z.ZodEnum<{
+    conflict: "conflict";
+    invalid: "invalid";
+    needs_confirmation: "needs_confirmation";
+    unchanged: "unchanged";
+    updated: "updated";
+  }>;
+  version: z.ZodOptional<z.ZodNumber>;
+  problems: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    path: z.ZodString;
+    message: z.ZodString;
+    fix: z.ZodString;
+  }, z.core.$strip>>>;
+  impact: z.ZodOptional<z.ZodObject<{
+    removedCollections: z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      entries: z.ZodNumber;
+    }, z.core.$strip>>;
+    removedLocales: z.ZodArray<z.ZodObject<{
+      locale: z.ZodString;
+      entries: z.ZodNumber;
+    }, z.core.$strip>>;
+    refused: z.ZodArray<z.ZodObject<{
+      collection: z.ZodString;
+      entries: z.ZodNumber;
+      examples: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
+  currentVersion: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>>, OperationSpec<"validate", z.ZodObject<{
   collection: z.ZodString;
   locale: z.ZodString;
@@ -2738,7 +3487,42 @@ export declare function chunksOf(entry: {
   readonly document: EntryDocument;
 }): Chunk[];
 //#endregion
+//#region src/cache.d.ts
+/**
+ * The cache tags of Hollware's content (S8): one name for each thing a page can show, so that a
+ * site tags each page with what it read and purges, when an event says what changed, the pages
+ * that showed it. Hollware puts the tags an event invalidates in its payload; `@hollware/nuxt`
+ * tags its pages with the same functions. A tag is at most 1,024 characters of printable ASCII
+ * with no space or comma, which every cache that purges by tag takes.
+ *
+ * - `entry:<id>`: a page that shows the entry, its own or one that embeds it;
+ * - `list:<collection>:<locale>`: a page that lists the entries of a collection in a locale, and
+ *   `list:<collection>:*` one that lists them in every locale;
+ * - `group:<collection>:<group>`: a page that links to the translations of a group;
+ * - `site`: a page that shows the structure of the site, such as its navigation.
+ */
+export declare const SITE_TAG = "site";
+export declare function entryTag(id: string): string;
+export declare function listTag(collection: string, locale: string): string;
+export declare function groupTag(collection: string, group: string): string;
+/** The locale of a list of every locale. */
+export declare const EVERY_LOCALE = "*";
+/** What a summary of an entry says that tags derive from. */
+interface TaggedEntry {
+  readonly id: string;
+  readonly collection: string;
+  readonly locale: string;
+  readonly translationGroup: string | null;
+}
+/** The tags of a page that shows these entries, each its own. */
+export declare function tagsOfEntries(entries: readonly TaggedEntry[]): string[];
+/**
+ * The tags an event about an entry invalidates: the pages that show it, the lists of its
+ * collection in its locale and in every locale, and the pages that link to its translations.
+ */
+export declare function tagsOfChange(entry: TaggedEntry): string[];
+//#endregion
 //#region src/index.d.ts
 export declare const name = "@hollware/core";
 //#endregion
-export { type AcknowledgedWarning, type AuthDefinition, type BuiltInContractId, type BuiltInOptions, type Chunk, type CollectionDefinition, type ComponentDefinition, type ComponentUse, type ConfigProblem, type Contract, type ContractContext, type ContractDescription, type ContractFinding, type ContractText, type CustomContractOptions, type DescribedSchema, type DisallowedMarker, type Effect, type EntryDocument, type EntryFacts, type EntryLookup, type EntryRef, type ErrorCode, type ExtractedContent, type Heading, type HollwareConfig, type IdPrefix, type ImageRef, type LinkRef, type LinkTarget, type Operation, type OperationByName, type OperationName, type OperationSpec, type OutcomeInfo, type OutcomeOf, type Phase, type ProcessMarkdown, type ProcessMarkdownOptions, type ProcessResult, type ProcessedMarkdown, type RenderHtml, type ResolveConfig, type ResolvedAuth, type ResolvedCollection, type ResolvedConfig, type ResolvedSite, type RunContractsInput, type SchemaOutput, type Scope, type Severity, type SiteDefinition, type SiteDescription, type Verdict, type Violation, schemas_d_exports as schemas };
+export { type AcknowledgedWarning, type AuthDefinition, type BuiltInContractId, type BuiltInOptions, type CatalogRule, type Chunk, type CollectionDefinition, type CollectionDefinitionData, type ComponentDefinition, type ComponentUse, type ConfigProblem, type Contract, type ContractContext, type ContractDescription, type ContractFinding, type ContractText, type CustomContractOptions, type DescribedSchema, type DisallowedMarker, type Effect, type EntryDocument, type EntryFacts, type EntryLookup, type EntryRef, type ErrorCode, type ExtractedContent, type Heading, type HollwareConfig, type IdPrefix, type ImageRef, type LinkRef, type LinkTarget, type Operation, type OperationByName, type OperationName, type OperationSpec, type OutcomeInfo, type OutcomeOf, type Phase, type Preset, type ProcessMarkdown, type ProcessMarkdownOptions, type ProcessResult, type ProcessedMarkdown, type RenderHtml, type ResolveConfig, type ResolvedAuth, type ResolvedCollection, type ResolvedConfig, type ResolvedSite, type RuleDefinition, type RunContractsInput, type SchemaOutput, type Scope, type Severity, type SiteDefinition, type SiteDefinitionData, type SiteDefinitionInput, type SiteDescription, type TaggedEntry, type Verdict, type Violation, schemas_d_exports as schemas };