@caelo-cms/shared 0.10.21 → 0.10.23

package/dist/ai-tools.d.ts

@@ -9,29 +9,26 @@
  * silent drops in the handler.
  */
 import { z } from "zod";
-/**
- * v0.6.2 — `position` argument shared across the three `add_module_to_*`
- * tools. Accepts either the literal string `"top"` / `"bottom"` OR a
- * 0..1000 integer index.
- *
- * The integer branch is `z.preprocess`-wrapped to coerce digit-only
- * strings (`"0"`, `"42"`) to numbers before the int check. The AI
- * recurrently passes JSON-quoted numbers (`"0"`) even though the tool
- * description explicitly says to use bare integers; the coercion
- * removes that ergonomic gotcha while still rejecting non-numeric
- * strings (`"abc"` → still fails the int check cleanly).
- */
-export declare const positionInputSchema: z.ZodUnion<readonly [z.ZodEnum<{
+export declare const positionInputSchema: z.ZodPreprocess<z.ZodUnion<readonly [z.ZodEnum<{
     top: "top";
     bottom: "bottom";
-}>, z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>]>;
+}>, z.ZodPreprocess<z.ZodNumber>]>>;
 export declare const editModuleToolInput: z.ZodObject<{
     moduleId: z.ZodString;
     displayName: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        chrome: "chrome";
+        hero: "hero";
+        content: "content";
+        cta: "cta";
+        utility: "utility";
+    }>>;
+    type: z.ZodOptional<z.ZodString>;
     html: z.ZodOptional<z.ZodString>;
     css: z.ZodOptional<z.ZodString>;
     js: z.ZodOptional<z.ZodString>;
-    fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    fields: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         name: z.ZodString;
         kind: z.ZodEnum<{
             number: "number";
@@ -44,7 +41,37 @@ export declare const editModuleToolInput: z.ZodObject<{
         }>;
         label: z.ZodString;
         default: z.ZodOptional<z.ZodUnknown>;
-    }, z.core.$strict>>>;
+    }, z.core.$strict>, z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"text-list">;
+        label: z.ZodString;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        default: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>, z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"link-list">;
+        label: z.ZodString;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        default: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            href: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>, z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"module">;
+        label: z.ZodString;
+        allowedModuleTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>, z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"module-list">;
+        label: z.ZodString;
+        allowedModuleTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>], "kind">>>;
+    bindThemeLiterals: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 /**
  * v0.4.0 — `set_page_module_content` AI tool. Fills the content values for
@@ -70,28 +97,66 @@ export declare const siteMemoryProposeToolInput: z.ZodObject<{
     body: z.ZodString;
     rationale: z.ZodString;
 }, z.core.$strict>;
+/**
+ * Progressive-disclosure skill loading. The `## Skills` system-prompt block
+ * lists each active skill's slug + description; when a task matches one or
+ * more, the model calls `load_skill({slugs})` to pull their full instructions
+ * into the conversation (they persist as a tool result for the rest of the
+ * chat, so each skill loads at most once).
+ *
+ * Takes a LIST, not a single slug, per CLAUDE.md §11: a load is a routine
+ * operation and every routine operation ships in bulk form, with n=1 as its
+ * smallest case rather than a separate singular tool. Loading three skills was
+ * three provider round-trips whose only output was one tool call each.
+ *
+ * Capped at 5: skills are task-scoped, and a model that wants more than a
+ * handful at once has almost certainly matched the index too loosely — each
+ * body is a sizeable injection into history.
+ */
+export declare const loadSkillToolInput: z.ZodObject<{
+    slugs: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type LoadSkillToolInput = z.infer<typeof loadSkillToolInput>;
 /**
  * The set of tools shipped in P5. Other phases extend by adding a new
  * entry; the dispatcher walks this map at registration time.
  */
 /**
- * P6.7.3 — `add_module_to_page` AI tool. Creates a new module and
- * inserts it into a target page's block at the requested position. The
- * AI passes html (and optionally css/js) and a sluggable displayName;
- * the tool generates a unique slug.
+ * The ONE `add_module` input — consolidates add_module_to_{page,layout,template}
+ * (audit #2). `target` picks the destination; `targetRef` is a slug OR a uuid
+ * (resolved server-side — a slug is friendlier for the AI to hold than a uuid).
+ * Same two modes as before: `moduleId` reuses an existing module (now for ALL
+ * three targets — layout used to be mint-only), or the authoring fields mint a
+ * new one (raw html is fine — moduleize turns it into a proper module). Exactly
+ * one mode, enforced by the shared superRefine.
  */
-export declare const addModuleToPageToolInput: z.ZodObject<{
-    pageId: z.ZodString;
+export declare const addModuleToolInput: z.ZodObject<{
+    target: z.ZodEnum<{
+        page: "page";
+        layout: "layout";
+        template: "template";
+    }>;
+    targetRef: z.ZodString;
     blockName: z.ZodString;
-    position: z.ZodUnion<readonly [z.ZodEnum<{
+    position: z.ZodPreprocess<z.ZodUnion<readonly [z.ZodEnum<{
         top: "top";
         bottom: "bottom";
-    }>, z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>]>;
-    displayName: z.ZodString;
-    html: z.ZodString;
+    }>, z.ZodPreprocess<z.ZodNumber>]>>;
+    moduleId: z.ZodOptional<z.ZodString>;
+    displayName: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        chrome: "chrome";
+        hero: "hero";
+        content: "content";
+        cta: "cta";
+        utility: "utility";
+    }>>;
+    type: z.ZodOptional<z.ZodString>;
+    html: z.ZodOptional<z.ZodString>;
     css: z.ZodOptional<z.ZodString>;
     js: z.ZodOptional<z.ZodString>;
-    fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    fields: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         name: z.ZodString;
         kind: z.ZodEnum<{
             number: "number";
@@ -104,40 +169,40 @@ export declare const addModuleToPageToolInput: z.ZodObject<{
         }>;
         label: z.ZodString;
         default: z.ZodOptional<z.ZodUnknown>;
-    }, z.core.$strict>>>;
-}, z.core.$strict>;
-/**
- * P6.7.3 — `add_module_to_template` AI tool. Same shape as
- * `add_module_to_page` but fans the new module out to every page using
- * the target template, inserting at the same block + position. Used
- * for "site-wide" content (a global footer, a header banner, etc.).
- */
-export declare const addModuleToTemplateToolInput: z.ZodObject<{
-    templateId: z.ZodString;
-    blockName: z.ZodString;
-    position: z.ZodUnion<readonly [z.ZodEnum<{
-        top: "top";
-        bottom: "bottom";
-    }>, z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>]>;
-    displayName: z.ZodString;
-    html: z.ZodString;
-    css: z.ZodOptional<z.ZodString>;
-    js: z.ZodOptional<z.ZodString>;
-    fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         name: z.ZodString;
-        kind: z.ZodEnum<{
-            number: "number";
-            boolean: "boolean";
-            text: "text";
-            richtext: "richtext";
-            url: "url";
-            image: "image";
-            link: "link";
-        }>;
+        kind: z.ZodLiteral<"text-list">;
         label: z.ZodString;
-        default: z.ZodOptional<z.ZodUnknown>;
-    }, z.core.$strict>>>;
-}, z.core.$strict>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        default: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>, z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"link-list">;
+        label: z.ZodString;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        default: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            href: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>, z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"module">;
+        label: z.ZodString;
+        allowedModuleTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>, z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"module-list">;
+        label: z.ZodString;
+        allowedModuleTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>], "kind">>>;
+    bindThemeLiterals: z.ZodOptional<z.ZodBoolean>;
+    values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+export type AddModuleToolInput = z.infer<typeof addModuleToolInput>;
 /**
  * v0.2.16 — `add_plugin_to_page` AI tool. Inserts a plugin's
  * `<div data-caelo-plugin>` placeholder into a page's block via a
@@ -152,16 +217,68 @@ export declare const addPluginToPageToolInput: z.ZodObject<{
     pageId: z.ZodString;
     pluginSlug: z.ZodString;
     blockName: z.ZodString;
-    position: z.ZodUnion<readonly [z.ZodEnum<{
+    position: z.ZodPreprocess<z.ZodUnion<readonly [z.ZodEnum<{
         top: "top";
         bottom: "bottom";
-    }>, z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>]>;
+    }>, z.ZodPreprocess<z.ZodNumber>]>>;
+}, z.core.$strict>;
+/**
+ * `list_content_instances` — browse the content library. The `placementCount`
+ * returned per row is a blast-radius affordance: the AI can decide whether
+ * to edit a shared instance (propagates everywhere) or fork it first.
+ */
+export declare const listContentInstancesToolInput: z.ZodObject<{
+    moduleId: z.ZodOptional<z.ZodString>;
+    slug: z.ZodOptional<z.ZodString>;
+    search: z.ZodOptional<z.ZodString>;
+    pageId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const getContentInstanceToolInput: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strict>;
+export declare const createContentInstanceToolInput: z.ZodObject<{
+    moduleId: z.ZodString;
+    slug: z.ZodOptional<z.ZodString>;
+    displayName: z.ZodOptional<z.ZodString>;
+    purpose: z.ZodOptional<z.ZodString>;
+    values: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+export declare const setContentInstanceValuesToolInput: z.ZodObject<{
+    id: z.ZodString;
+    values: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    expectedVersion: z.ZodOptional<z.ZodNumber>;
+    slug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    displayName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    purpose: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export declare const deleteContentInstanceToolInput: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strict>;
+export declare const setPlacementContentToolInput: z.ZodObject<{
+    pageId: z.ZodString;
+    blockName: z.ZodString;
+    position: z.ZodNumber;
+    contentInstanceId: z.ZodString;
+    syncMode: z.ZodEnum<{
+        synced: "synced";
+        unsynced: "unsynced";
+    }>;
+}, z.core.$strict>;
+export declare const forkPlacementContentToolInput: z.ZodObject<{
+    pageId: z.ZodString;
+    blockName: z.ZodString;
+    position: z.ZodNumber;
 }, z.core.$strict>;
-export declare const AI_TOOLS: readonly ["edit_module", "site_memory_propose", "add_module_to_page", "add_module_to_template", "create_page", "rename_page", "set_page_title", "change_page_slug", "delete_page", "remove_module_from_page", "set_structured_set", "update_theme", "add_module_to_layout", "remove_module_from_layout", "set_template_layout", "create_layout", "set_site_defaults", "duplicate_page", "change_template", "move_module", "reorder_module", "set_nav_menu", "add_plugin_to_page"];
+export declare const AI_TOOLS: readonly ["edit_module", "site_memory_propose", "add_module", "create_page", "update_pages_many", "delete_pages_many", "remove_module_from", "set_structured_set", "update_theme", "set_template_layout", "create_layout", "set_site_defaults", "duplicate_page", "repoint_page_template", "move_module", "reorder_module", "set_nav_menu", "add_plugin_to_page", "list_content_instances", "get_content_instance", "create_content_instance", "set_content_instance_values", "delete_content_instance", "set_placement_content", "fork_placement_content", "build_page", "create_content_instances", "set_page_module_content_many"];
 export type AiToolName = (typeof AI_TOOLS)[number];
-export type AddModuleToPageToolInput = z.infer<typeof addModuleToPageToolInput>;
-export type AddModuleToTemplateToolInput = z.infer<typeof addModuleToTemplateToolInput>;
 export type AddPluginToPageToolInput = z.infer<typeof addPluginToPageToolInput>;
+export type ListContentInstancesToolInput = z.infer<typeof listContentInstancesToolInput>;
+export type GetContentInstanceToolInput = z.infer<typeof getContentInstanceToolInput>;
+export type CreateContentInstanceToolInput = z.infer<typeof createContentInstanceToolInput>;
+export type SetContentInstanceValuesToolInput = z.infer<typeof setContentInstanceValuesToolInput>;
+export type DeleteContentInstanceToolInput = z.infer<typeof deleteContentInstanceToolInput>;
+export type SetPlacementContentToolInput = z.infer<typeof setPlacementContentToolInput>;
+export type ForkPlacementContentToolInput = z.infer<typeof forkPlacementContentToolInput>;
 /** Chat ops input shapes — used by the SvelteKit form actions. */
 export declare const chatCreateSessionInput: z.ZodObject<{
     title: z.ZodOptional<z.ZodString>;
@@ -170,15 +287,55 @@ export declare const chatCreateSessionInput: z.ZodObject<{
     subagentRole: z.ZodOptional<z.ZodString>;
     parentChatSessionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strict>;
+/**
+ * issue #190 — an operator-attached image riding a user chat message.
+ * References a media_assets row (the upload endpoint owns validation
+ * + storage); image/* only in v1 so the provider mapping is always an
+ * image part.
+ */
+export declare const chatAttachmentSchema: z.ZodObject<{
+    assetId: z.ZodOptional<z.ZodString>;
+    storageKey: z.ZodOptional<z.ZodString>;
+    mime: z.ZodEnum<{
+        "image/png": "image/png";
+        "image/jpeg": "image/jpeg";
+        "image/webp": "image/webp";
+        "image/gif": "image/gif";
+    }>;
+    alt: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ChatAttachment = z.infer<typeof chatAttachmentSchema>;
+/** issue #190 — attachments-per-message cap; bounds provider payload size. */
+export declare const CHAT_MAX_ATTACHMENTS = 4;
 export declare const chatSendMessageInput: z.ZodObject<{
     chatSessionId: z.ZodString;
-    content: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
     chips: z.ZodDefault<z.ZodArray<z.ZodObject<{
         moduleId: z.ZodString;
         selector: z.ZodString;
         label: z.ZodString;
     }, z.core.$strict>>>;
+    attachments: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        assetId: z.ZodOptional<z.ZodString>;
+        storageKey: z.ZodOptional<z.ZodString>;
+        mime: z.ZodEnum<{
+            "image/png": "image/png";
+            "image/jpeg": "image/jpeg";
+            "image/webp": "image/webp";
+            "image/gif": "image/gif";
+        }>;
+        alt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    origin: z.ZodOptional<z.ZodEnum<{
+        operator: "operator";
+        system: "system";
+    }>>;
     activePageId: z.ZodOptional<z.ZodString>;
+    resumeApproval: z.ZodOptional<z.ZodObject<{
+        approvalId: z.ZodString;
+        approved: z.ZodBoolean;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 export declare const chatRenameSessionInput: z.ZodObject<{
     chatSessionId: z.ZodString;
@@ -189,12 +346,13 @@ export declare const chatPublishInput: z.ZodObject<{
     entities: z.ZodOptional<z.ZodArray<z.ZodObject<{
         kind: z.ZodEnum<{
             module: "module";
-            template: "template";
             page: "page";
+            layout: "layout";
+            template: "template";
             pageLayout: "pageLayout";
             pageModuleContent: "pageModuleContent";
-            layout: "layout";
             structuredSet: "structuredSet";
+            theme: "theme";
         }>;
         entityId: z.ZodString;
     }, z.core.$strict>>>;
@@ -229,18 +387,6 @@ export declare const aiProvidersSetInput: z.ZodObject<{
     isActive: z.ZodDefault<z.ZodBoolean>;
     apiKey: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
-/**
- * P19 — `compose_from_import` AI tool input. Wraps
- * `imports.compose_from_run`. Single transaction synthesis: aggregates
- * theme tokens, creates one template bound to the default layout,
- * materialises every staged import_pages row into a draft page +
- * modules. Idempotent — pages already accepted skip cleanly.
- */
-export declare const composeFromImportToolInput: z.ZodObject<{
-    runId: z.ZodString;
-    templateSlug: z.ZodOptional<z.ZodString>;
-    includeImportPageIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strict>;
 /**
  * Input for `ai_providers.clear_key` — Owner-only NULLs the encrypted
  * triplet so the resolver falls back to the env-var path for that
@@ -255,17 +401,6 @@ export declare const aiProvidersClearKeyInput: z.ZodObject<{
         "local-openai-compat": "local-openai-compat";
     }>;
 }, z.core.$strict>;
-export declare const createPageToolInput: z.ZodObject<{
-    name: z.ZodString;
-    title: z.ZodString;
-    slug: z.ZodString;
-    locale: z.ZodDefault<z.ZodString>;
-    templateId: z.ZodOptional<z.ZodString>;
-    status: z.ZodDefault<z.ZodEnum<{
-        draft: "draft";
-        published: "published";
-    }>>;
-}, z.core.$strict>;
 /**
  * P18 AI-completeness — `create_template` AI tool input. Wraps
  * `templates.create` (widened to AI in this pass per CLAUDE.md §11
@@ -278,89 +413,40 @@ export declare const createTemplateToolInput: z.ZodObject<{
     html: z.ZodString;
     css: z.ZodDefault<z.ZodString>;
     layoutId: z.ZodOptional<z.ZodString>;
+    blocks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        position: z.ZodNumber;
+    }, z.core.$strip>>>;
 }, z.core.$strict>;
-export declare const renamePageToolInput: z.ZodObject<{
-    pageId: z.ZodString;
-    newName: z.ZodString;
-}, z.core.$strict>;
-export declare const setPageTitleToolInput: z.ZodObject<{
-    pageId: z.ZodString;
-    newTitle: z.ZodString;
-}, z.core.$strict>;
-export declare const changePageSlugToolInput: z.ZodObject<{
-    pageId: z.ZodString;
-    newSlug: z.ZodString;
-    redirectFromOld: z.ZodDefault<z.ZodEnum<{
-        auto: "auto";
-        skip: "skip";
-    }>>;
-}, z.core.$strict>;
-export declare const deletePageToolInput: z.ZodObject<{
-    pageId: z.ZodString;
-    disposition: z.ZodEnum<{
-        404: "404";
-        redirect: "redirect";
+/**
+ * The ONE remove-module input — `target` picks page vs layout, `targetRef` is a
+ * slug OR a uuid (resolved server-side). Mirrors `add_module` so placement and
+ * un-placement share one shape. (No `template` target: there is no
+ * remove_module_from_template, matching the add-side history.)
+ */
+export declare const removeModuleFromToolInput: z.ZodObject<{
+    target: z.ZodEnum<{
+        page: "page";
+        layout: "layout";
     }>;
-    redirectTo: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
-export declare const removeModuleFromPageToolInput: z.ZodObject<{
-    pageId: z.ZodString;
+    targetRef: z.ZodString;
     moduleId: z.ZodString;
 }, z.core.$strict>;
+export type RemoveModuleFromToolInput = z.infer<typeof removeModuleFromToolInput>;
 export declare const setStructuredSetToolInput: z.ZodObject<{
     kind: z.ZodEnum<{
+        "link-list": "link-list";
+        theme: "theme";
         "nav-menu": "nav-menu";
         taxonomy: "taxonomy";
-        theme: "theme";
         tags: "tags";
-        "link-list": "link-list";
+        "language-selector": "language-selector";
     }>;
     slug: z.ZodString;
     displayName: z.ZodString;
     items: z.ZodArray<z.ZodUnknown>;
 }, z.core.$strict>;
-export declare const updateThemeToolInput: z.ZodObject<{
-    tokens: z.ZodRecord<z.ZodString, z.ZodString>;
-}, z.core.$strict>;
-/**
- * P6.7.6 — layout-layer tools. Layouts are site-wide chrome (header /
- * footer / nav) that wraps every page on every template bound to the
- * layout. `add_module_to_layout` reaches every page across the site
- * with one call; `set_template_layout` re-points a template's chrome.
- * `create_layout` and `set_site_defaults` are Owner-only at the op
- * level — AI calls reject with ActorScopeRejected and the chat surfaces
- * the permission requirement.
- */
-export declare const addModuleToLayoutToolInput: z.ZodObject<{
-    layoutSlug: z.ZodString;
-    blockName: z.ZodString;
-    position: z.ZodUnion<readonly [z.ZodEnum<{
-        top: "top";
-        bottom: "bottom";
-    }>, z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>]>;
-    displayName: z.ZodString;
-    html: z.ZodString;
-    css: z.ZodOptional<z.ZodString>;
-    js: z.ZodOptional<z.ZodString>;
-    fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        name: z.ZodString;
-        kind: z.ZodEnum<{
-            number: "number";
-            boolean: "boolean";
-            text: "text";
-            richtext: "richtext";
-            url: "url";
-            image: "image";
-            link: "link";
-        }>;
-        label: z.ZodString;
-        default: z.ZodOptional<z.ZodUnknown>;
-    }, z.core.$strict>>>;
-}, z.core.$strict>;
-export declare const removeModuleFromLayoutToolInput: z.ZodObject<{
-    layoutSlug: z.ZodString;
-    moduleId: z.ZodString;
-}, z.core.$strict>;
 export declare const setTemplateLayoutToolInput: z.ZodObject<{
     templateId: z.ZodString;
     layoutSlug: z.ZodString;
@@ -394,7 +480,7 @@ export declare const duplicatePageToolInput: z.ZodObject<{
     targetTemplateId: z.ZodOptional<z.ZodString>;
     locale: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
-export declare const changeTemplateToolInput: z.ZodObject<{
+export declare const repointPageTemplateToolInput: z.ZodObject<{
     pageId: z.ZodString;
     newTemplateId: z.ZodString;
     orphanDisposition: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -408,10 +494,10 @@ export declare const moveModuleToolInput: z.ZodObject<{
     pageId: z.ZodString;
     moduleId: z.ZodString;
     toBlockName: z.ZodString;
-    position: z.ZodUnion<readonly [z.ZodEnum<{
+    position: z.ZodPreprocess<z.ZodUnion<readonly [z.ZodEnum<{
         top: "top";
         bottom: "bottom";
-    }>, z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>]>;
+    }>, z.ZodPreprocess<z.ZodNumber>]>>;
 }, z.core.$strict>;
 export declare const reorderModuleToolInput: z.ZodObject<{
     pageId: z.ZodString;
@@ -421,18 +507,6 @@ export declare const reorderModuleToolInput: z.ZodObject<{
         down: "down";
     }>, z.ZodNumber]>;
 }, z.core.$strict>;
-/**
- * Convenience wrapper over `set_structured_set` for the `nav-menu`
- * kind specifically. Users say "edit the menu", not "set the
- * structured set kind=nav-menu" — this maps natural language to the
- * right tool. Items shape matches `navMenuItem` from
- * @caelo-cms/shared/structured-sets.
- */
-export declare const setNavMenuToolInput: z.ZodObject<{
-    slug: z.ZodString;
-    displayName: z.ZodString;
-    items: z.ZodArray<z.ZodUnknown>;
-}, z.core.$strict>;
 /**
  * P7 — `find_media`. Searches the media library by alt-text /
  * filename / mime. Returns up to `limit` matches with the WebP-800
@@ -444,11 +518,11 @@ export declare const setNavMenuToolInput: z.ZodObject<{
 export declare const findMediaToolInput: z.ZodObject<{
     query: z.ZodOptional<z.ZodString>;
     mime: z.ZodOptional<z.ZodEnum<{
-        "image/jpeg": "image/jpeg";
         "image/png": "image/png";
+        "image/jpeg": "image/jpeg";
         "image/webp": "image/webp";
-        "image/avif": "image/avif";
         "image/gif": "image/gif";
+        "image/avif": "image/avif";
         "image/svg+xml": "image/svg+xml";
         "application/pdf": "application/pdf";
         "video/mp4": "video/mp4";
@@ -456,6 +530,18 @@ export declare const findMediaToolInput: z.ZodObject<{
     limit: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 export type FindMediaToolInput = z.infer<typeof findMediaToolInput>;
+/**
+ * run #10 D4 — `regenerate_media_variants`. Recovery tool for the
+ * staging generator's "media references unresolved" failure: re-runs
+ * the image pipeline for the named assets (or every asset with an
+ * incomplete ladder) and reports per-asset what was added or why
+ * nothing could be.
+ */
+export declare const regenerateMediaVariantsToolInput: z.ZodObject<{
+    assetIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    allMissing: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+export type RegenerateMediaVariantsToolInput = z.infer<typeof regenerateMediaVariantsToolInput>;
 /**
  * P7 — `set_media_alt`. AI may improve a11y on an existing asset
  * without a human round-trip (e.g. when the editor uploaded an image
@@ -467,6 +553,34 @@ export declare const setMediaAltToolInput: z.ZodObject<{
     alt: z.ZodString;
 }, z.core.$strict>;
 export type SetMediaAltToolInput = z.infer<typeof setMediaAltToolInput>;
+/**
+ * 0184 — `set_home_page`. AI designates a page as the site homepage (per
+ * locale, the locale root). Records `locales.home_page_id`; the page keeps
+ * its own slug but resolves to `/`.
+ */
+export declare const setHomePageToolInput: z.ZodObject<{
+    pageId: z.ZodString;
+    locale: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type SetHomePageToolInput = z.infer<typeof setHomePageToolInput>;
+/**
+ * 0181 — `set_media_source`. AI records an asset's provenance (source
+ * kind + origin detail) and licence when known. All fields but the
+ * assetId are optional; the op COALESCEs so omitted fields stay
+ * unchanged.
+ */
+export declare const setMediaSourceToolInput: z.ZodObject<{
+    assetId: z.ZodString;
+    sourceKind: z.ZodOptional<z.ZodEnum<{
+        upload: "upload";
+        ai_generated: "ai_generated";
+        imported: "imported";
+        external: "external";
+    }>>;
+    sourceDetail: z.ZodOptional<z.ZodString>;
+    license: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type SetMediaSourceToolInput = z.infer<typeof setMediaSourceToolInput>;
 /**
  * P8 — `set_page_seo`. Manual / panel writes to the per-page SEO
  * sidecar. AI calls this only on explicit user intent
@@ -544,14 +658,6 @@ export type BulkCreateRedirectsToolInput = z.infer<typeof bulkCreateRedirectsToo
  * `status='published'`. Use the bulk form for "publish all drafts" or
  * any N>1 flip — saves N round-trips + N snapshot writes + N audit rows.
  */
-export declare const setPageStatusToolInput: z.ZodObject<{
-    pageId: z.ZodString;
-    status: z.ZodEnum<{
-        draft: "draft";
-        published: "published";
-    }>;
-}, z.core.$strict>;
-export type SetPageStatusToolInput = z.infer<typeof setPageStatusToolInput>;
 export declare const setPagesStatusManyToolInput: z.ZodObject<{
     pageIds: z.ZodArray<z.ZodString>;
     status: z.ZodEnum<{
@@ -577,16 +683,8 @@ export declare const bulkOptimizeSeoToolInput: z.ZodObject<{
 export type BulkOptimizeSeoToolInput = z.infer<typeof bulkOptimizeSeoToolInput>;
 export type EditModuleToolInput = z.infer<typeof editModuleToolInput>;
 export type SiteMemoryProposeToolInput = z.infer<typeof siteMemoryProposeToolInput>;
-export type CreatePageToolInput = z.infer<typeof createPageToolInput>;
 export type CreateTemplateToolInput = z.infer<typeof createTemplateToolInput>;
-export type ComposeFromImportToolInput = z.infer<typeof composeFromImportToolInput>;
-export type RenamePageToolInput = z.infer<typeof renamePageToolInput>;
-export type SetPageTitleToolInput = z.infer<typeof setPageTitleToolInput>;
-export type ChangePageSlugToolInput = z.infer<typeof changePageSlugToolInput>;
-export type DeletePageToolInput = z.infer<typeof deletePageToolInput>;
-export type RemoveModuleFromPageToolInput = z.infer<typeof removeModuleFromPageToolInput>;
 export type SetStructuredSetToolInput = z.infer<typeof setStructuredSetToolInput>;
-export type UpdateThemeToolInput = z.infer<typeof updateThemeToolInput>;
 export type ChatCreateSessionInput = z.infer<typeof chatCreateSessionInput>;
 export type ChatSendMessageInput = z.infer<typeof chatSendMessageInput>;
 export type ChatRenameSessionInput = z.infer<typeof chatRenameSessionInput>;
@@ -595,16 +693,13 @@ export type AiMemorySetInput = z.infer<typeof aiMemorySetInput>;
 export type AiMemoryReviewInput = z.infer<typeof aiMemoryReviewInput>;
 export type AiProvidersSetInput = z.infer<typeof aiProvidersSetInput>;
 export type AiProvidersClearKeyInput = z.infer<typeof aiProvidersClearKeyInput>;
-export type AddModuleToLayoutToolInput = z.infer<typeof addModuleToLayoutToolInput>;
-export type RemoveModuleFromLayoutToolInput = z.infer<typeof removeModuleFromLayoutToolInput>;
 export type SetTemplateLayoutToolInput = z.infer<typeof setTemplateLayoutToolInput>;
 export type CreateLayoutToolInput = z.infer<typeof createLayoutToolInput>;
 export type SetSiteDefaultsToolInput = z.infer<typeof setSiteDefaultsToolInput>;
 export type DuplicatePageToolInput = z.infer<typeof duplicatePageToolInput>;
-export type ChangeTemplateToolInput = z.infer<typeof changeTemplateToolInput>;
+export type RepointPageTemplateToolInput = z.infer<typeof repointPageTemplateToolInput>;
 export type MoveModuleToolInput = z.infer<typeof moveModuleToolInput>;
 export type ReorderModuleToolInput = z.infer<typeof reorderModuleToolInput>;
-export type SetNavMenuToolInput = z.infer<typeof setNavMenuToolInput>;
 export declare const proposeAddLocaleToolInput: z.ZodObject<{
     code: z.ZodString;
     displayName: z.ZodString;
@@ -721,41 +816,6 @@ export declare const bootstrapSiteScaffoldToolInput: z.ZodObject<{
     setAsDefaults: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 export type BootstrapSiteScaffoldToolInput = z.infer<typeof bootstrapSiteScaffoldToolInput>;
-/**
- * v0.6.0 W4 (deferred) — composite tool. Creates a page and attaches N
- * modules to its content block in one tool call, mirroring the way the
- * AI naturally describes a multi-section page: a title + a series of
- * sections, each with its own HTML/CSS. The handler runs the chain
- * server-side so the AI doesn't have to orchestrate create_page +
- * N×add_module_to_page across N+1 round-trips.
- *
- * `sections[]` are placed on the block named in `blockName` (default
- * `content`) in the order given.
- */
-export declare const composePageFromSpecToolInput: z.ZodObject<{
-    slug: z.ZodString;
-    name: z.ZodString;
-    title: z.ZodString;
-    locale: z.ZodOptional<z.ZodString>;
-    templateId: z.ZodOptional<z.ZodString>;
-    status: z.ZodOptional<z.ZodEnum<{
-        draft: "draft";
-        published: "published";
-    }>>;
-    blockName: z.ZodOptional<z.ZodString>;
-    sections: z.ZodArray<z.ZodObject<{
-        displayName: z.ZodString;
-        html: z.ZodString;
-        css: z.ZodOptional<z.ZodString>;
-        js: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-    seo: z.ZodOptional<z.ZodObject<{
-        metaDescription: z.ZodOptional<z.ZodString>;
-        ogImageAssetId: z.ZodOptional<z.ZodString>;
-        skipSeo: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strict>>;
-}, z.core.$strict>;
-export type ComposePageFromSpecToolInput = z.infer<typeof composePageFromSpecToolInput>;
 /**
  * v0.6.0 W4 (deferred) — composite revert. Undoes every snapshot tagged
  * with the given chat's branch_id. Per-entity revert ops handle the