@caelo-cms/shared 0.2.2

package/dist/ai-tools.d.ts

@@ -0,0 +1,571 @@
+/**
+ * Zod schemas for the AI tools shipped in P5. Lives in @caelo-cms/shared so
+ * the provider abstraction (which streams tool-call args from the LLM)
+ * and the tool dispatcher (which validates + invokes the handler)
+ * import from a single source.
+ *
+ * `.strict()` on every input — the LLM occasionally hallucinates fields
+ * and we want a typed rejection at the Validator boundary, not silent
+ * silent drops in the handler.
+ */
+import { z } from "zod";
+export declare const editModuleToolInput: z.ZodObject<{
+    moduleId: z.ZodString;
+    displayName: z.ZodOptional<z.ZodString>;
+    html: z.ZodOptional<z.ZodString>;
+    css: z.ZodOptional<z.ZodString>;
+    js: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const siteMemoryProposeToolInput: z.ZodObject<{
+    slot: z.ZodEnum<{
+        purpose: "purpose";
+        "brand-voice": "brand-voice";
+        tone: "tone";
+        "banned-phrases": "banned-phrases";
+        instructions: "instructions";
+        glossary: "glossary";
+    }>;
+    body: z.ZodString;
+    rationale: z.ZodString;
+}, z.core.$strict>;
+/**
+ * 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.
+ */
+export declare const addModuleToPageToolInput: z.ZodObject<{
+    pageId: z.ZodString;
+    blockName: z.ZodString;
+    position: z.ZodUnion<readonly [z.ZodEnum<{
+        top: "top";
+        bottom: "bottom";
+    }>, z.ZodNumber]>;
+    displayName: z.ZodString;
+    html: z.ZodString;
+    css: z.ZodOptional<z.ZodString>;
+    js: z.ZodOptional<z.ZodString>;
+}, 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.ZodNumber]>;
+    displayName: z.ZodString;
+    html: z.ZodString;
+    css: z.ZodOptional<z.ZodString>;
+    js: z.ZodOptional<z.ZodString>;
+}, 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"];
+export type AiToolName = (typeof AI_TOOLS)[number];
+export type AddModuleToPageToolInput = z.infer<typeof addModuleToPageToolInput>;
+export type AddModuleToTemplateToolInput = z.infer<typeof addModuleToTemplateToolInput>;
+/** Chat ops input shapes — used by the SvelteKit form actions. */
+export declare const chatCreateSessionInput: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    pageId: z.ZodOptional<z.ZodString>;
+    templateId: z.ZodOptional<z.ZodString>;
+    subagentRole: z.ZodOptional<z.ZodString>;
+    parentChatSessionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export declare const chatSendMessageInput: z.ZodObject<{
+    chatSessionId: z.ZodString;
+    content: z.ZodString;
+    chips: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        moduleId: z.ZodString;
+        selector: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strict>>>;
+    activePageId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const chatRenameSessionInput: z.ZodObject<{
+    chatSessionId: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strict>;
+export declare const chatPublishInput: z.ZodObject<{
+    chatSessionId: z.ZodString;
+    entities: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            module: "module";
+            template: "template";
+            page: "page";
+            pageLayout: "pageLayout";
+        }>;
+        entityId: z.ZodString;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export declare const aiMemorySetInput: z.ZodObject<{
+    slot: z.ZodEnum<{
+        purpose: "purpose";
+        "brand-voice": "brand-voice";
+        tone: "tone";
+        "banned-phrases": "banned-phrases";
+        instructions: "instructions";
+        glossary: "glossary";
+    }>;
+    body: z.ZodString;
+}, z.core.$strict>;
+export declare const aiMemoryReviewInput: z.ZodObject<{
+    proposalId: z.ZodString;
+    decision: z.ZodEnum<{
+        accept: "accept";
+        reject: "reject";
+    }>;
+}, z.core.$strict>;
+export declare const aiProvidersSetInput: z.ZodObject<{
+    name: z.ZodEnum<{
+        anthropic: "anthropic";
+        openai: "openai";
+        google: "google";
+        "local-openai-compat": "local-openai-compat";
+    }>;
+    displayName: z.ZodString;
+    config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    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
+ * provider (or returns null if no env is set, which surfaces the
+ * "configure AI provider" UI banner).
+ */
+export declare const aiProvidersClearKeyInput: z.ZodObject<{
+    name: z.ZodEnum<{
+        anthropic: "anthropic";
+        openai: "openai";
+        google: "google";
+        "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
+ * default-AI-allowed scope). `layoutId` is optional; the op resolves to
+ * `site_defaults.default_layout_id` when omitted.
+ */
+export declare const createTemplateToolInput: z.ZodObject<{
+    slug: z.ZodString;
+    displayName: z.ZodString;
+    html: z.ZodString;
+    css: z.ZodDefault<z.ZodString>;
+    layoutId: z.ZodOptional<z.ZodString>;
+}, 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";
+    }>;
+    redirectTo: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const removeModuleFromPageToolInput: z.ZodObject<{
+    pageId: z.ZodString;
+    moduleId: z.ZodString;
+}, z.core.$strict>;
+export declare const setStructuredSetToolInput: z.ZodObject<{
+    kind: z.ZodEnum<{
+        "nav-menu": "nav-menu";
+        taxonomy: "taxonomy";
+        theme: "theme";
+        tags: "tags";
+        "link-list": "link-list";
+    }>;
+    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.ZodNumber]>;
+    displayName: z.ZodString;
+    html: z.ZodString;
+    css: z.ZodOptional<z.ZodString>;
+    js: z.ZodOptional<z.ZodString>;
+}, 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;
+}, z.core.$strict>;
+export declare const createLayoutToolInput: z.ZodObject<{
+    slug: z.ZodString;
+    displayName: z.ZodString;
+    html: z.ZodString;
+    css: z.ZodOptional<z.ZodString>;
+    blocks: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        position: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const setSiteDefaultsToolInput: z.ZodObject<{
+    defaultLayoutSlug: z.ZodOptional<z.ZodString>;
+    defaultTemplateSlug: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * P6.7.7 — content-ops follow-ups: clone a page, swap a page's
+ * template, reorder modules within a block, move a module across
+ * blocks. All wrap existing or new ops; the tool layer captures the
+ * user-facing intent (which the system prompt steers the AI toward).
+ */
+export declare const duplicatePageToolInput: z.ZodObject<{
+    sourcePageId: z.ZodString;
+    newSlug: z.ZodString;
+    newName: z.ZodOptional<z.ZodString>;
+    newTitle: z.ZodOptional<z.ZodString>;
+    targetTemplateId: z.ZodOptional<z.ZodString>;
+    locale: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const changeTemplateToolInput: z.ZodObject<{
+    pageId: z.ZodString;
+    newTemplateId: z.ZodString;
+    orphanDisposition: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"drop">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"preserve-as-block">;
+        blockName: z.ZodString;
+    }, z.core.$strict>], "kind">>;
+}, z.core.$strict>;
+export declare const moveModuleToolInput: z.ZodObject<{
+    pageId: z.ZodString;
+    moduleId: z.ZodString;
+    toBlockName: z.ZodString;
+    position: z.ZodUnion<readonly [z.ZodEnum<{
+        top: "top";
+        bottom: "bottom";
+    }>, z.ZodNumber]>;
+}, z.core.$strict>;
+export declare const reorderModuleToolInput: z.ZodObject<{
+    pageId: z.ZodString;
+    moduleId: z.ZodString;
+    direction: z.ZodUnion<readonly [z.ZodEnum<{
+        up: "up";
+        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
+ * URL pre-resolved (or `orig` for non-image kinds). The system prompt
+ * already lists recent + frequently-used media; this tool covers the
+ * "search for an image of a sunlit office" case where the asset isn't
+ * in the recent slice.
+ */
+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/webp": "image/webp";
+        "image/avif": "image/avif";
+        "image/gif": "image/gif";
+        "image/svg+xml": "image/svg+xml";
+        "application/pdf": "application/pdf";
+        "video/mp4": "video/mp4";
+    }>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export type FindMediaToolInput = z.infer<typeof findMediaToolInput>;
+/**
+ * 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
+ * with the default alt and the AI reads its content). Updates only
+ * the alt field on `media_assets`.
+ */
+export declare const setMediaAltToolInput: z.ZodObject<{
+    assetId: z.ZodString;
+    alt: z.ZodString;
+}, z.core.$strict>;
+export type SetMediaAltToolInput = z.infer<typeof setMediaAltToolInput>;
+/**
+ * P8 — `set_page_seo`. Manual / panel writes to the per-page SEO
+ * sidecar. AI calls this only on explicit user intent
+ * ("set the home meta description to ..."). Doesn't bump fingerprints
+ * (autofilled_at / optimized_at).
+ */
+export declare const setPageSeoToolInput: z.ZodObject<{
+    pageId: z.ZodString;
+    metaDescription: z.ZodOptional<z.ZodString>;
+    ogImageAssetId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    canonicalUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    noindex: z.ZodOptional<z.ZodBoolean>;
+    changefreq: z.ZodOptional<z.ZodEnum<{
+        never: "never";
+        always: "always";
+        hourly: "hourly";
+        daily: "daily";
+        weekly: "weekly";
+        monthly: "monthly";
+        yearly: "yearly";
+    }>>;
+    priority: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type SetPageSeoToolInput = z.infer<typeof setPageSeoToolInput>;
+/**
+ * P8 — `autofill_page_seo`. Fill-once. Refuses when the page's SEO
+ * was already autofilled. Triggered by the `seo-autofill` skill on
+ * the first-publish path.
+ */
+export declare const autofillPageSeoToolInput: z.ZodObject<{
+    pageId: z.ZodString;
+    metaDescription: z.ZodString;
+    ogImageAssetId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type AutofillPageSeoToolInput = z.infer<typeof autofillPageSeoToolInput>;
+/**
+ * P8 — `optimize_page_seo`. Explicit re-optimization. Always allowed.
+ * Takes optional context (keyword analysis / intent shifts / branding
+ * changes). The AI can call this across N pages in one chat turn —
+ * the resulting changes batch into one Publish-pill confirm.
+ */
+export declare const optimizePageSeoToolInput: z.ZodObject<{
+    pageId: z.ZodString;
+    metaDescription: z.ZodString;
+    ogImageAssetId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    context: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type OptimizePageSeoToolInput = z.infer<typeof optimizePageSeoToolInput>;
+/**
+ * P8 AI-first review pass — bulk variants. Per CLAUDE.md §11, bulk
+ * tools save round-trips when the AI knows it has N changes to make
+ * in a single turn. The handlers run inside one transaction so the
+ * batch is all-or-nothing.
+ */
+export declare const findRedirectsToolInput: z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+    statusCode: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<301>, z.ZodLiteral<302>, z.ZodLiteral<307>, z.ZodLiteral<308>, z.ZodLiteral<410>]>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export type FindRedirectsToolInput = z.infer<typeof findRedirectsToolInput>;
+export declare const bulkCreateRedirectsToolInput: z.ZodObject<{
+    redirects: z.ZodArray<z.ZodObject<{
+        fromPath: z.ZodString;
+        toPath: z.ZodString;
+        statusCode: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<301>, z.ZodLiteral<302>, z.ZodLiteral<307>, z.ZodLiteral<308>, z.ZodLiteral<410>]>>;
+    }, z.core.$strict>>;
+    upsert: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+export type BulkCreateRedirectsToolInput = z.infer<typeof bulkCreateRedirectsToolInput>;
+export declare const bulkDeleteRedirectsToolInput: z.ZodObject<{
+    redirectIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    fromPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    matches: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type BulkDeleteRedirectsToolInput = z.infer<typeof bulkDeleteRedirectsToolInput>;
+export declare const bulkOptimizeSeoToolInput: z.ZodObject<{
+    updates: z.ZodArray<z.ZodObject<{
+        pageId: z.ZodString;
+        metaDescription: z.ZodString;
+        ogImageAssetId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>;
+    context: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+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>;
+export type ChatPublishInput = z.infer<typeof chatPublishInput>;
+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 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;
+    urlStrategy: z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        subdirectory: "subdirectory";
+        subdomain: "subdomain";
+        domain: "domain";
+    }>>;
+    urlHost: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type ProposeAddLocaleToolInput = z.infer<typeof proposeAddLocaleToolInput>;
+export declare const proposeRemoveLocaleToolInput: z.ZodObject<{
+    code: z.ZodString;
+}, z.core.$strict>;
+export type ProposeRemoveLocaleToolInput = z.infer<typeof proposeRemoveLocaleToolInput>;
+export declare const proposeSetDefaultLocaleToolInput: z.ZodObject<{
+    code: z.ZodString;
+}, z.core.$strict>;
+export type ProposeSetDefaultLocaleToolInput = z.infer<typeof proposeSetDefaultLocaleToolInput>;
+export declare const proposeUpdateLocaleStrategyToolInput: z.ZodObject<{
+    code: z.ZodString;
+    urlStrategy: z.ZodEnum<{
+        none: "none";
+        subdirectory: "subdirectory";
+        subdomain: "subdomain";
+        domain: "domain";
+    }>;
+    urlHost: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type ProposeUpdateLocaleStrategyToolInput = z.infer<typeof proposeUpdateLocaleStrategyToolInput>;
+/**
+ * P10 — translation tool inputs. `translate_page` auto-dispatches
+ * Mode 1 / Mode 2 based on the variant's existing status — the AI
+ * sees one verb regardless of state. `start_translation_job` queues
+ * a bulk run.
+ */
+export declare const translatePageToolInput: z.ZodObject<{
+    pageId: z.ZodString;
+    targetLocale: z.ZodString;
+}, z.core.$strict>;
+export type TranslatePageToolInput = z.infer<typeof translatePageToolInput>;
+export declare const startTranslationJobToolInput: z.ZodObject<{
+    scope: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"all-stale">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"page">;
+        pageId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"locale">;
+        code: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"pages">;
+        pageIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>], "kind">;
+    capMicrocents: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strict>;
+export type StartTranslationJobToolInput = z.infer<typeof startTranslationJobToolInput>;
+/**
+ * P10A — `propose_skill`. AI drafts a new skill body (or revision) and
+ * queues it for Owner review. Per CLAUDE.md §2: skills augment the AI's
+ * own system prompt, so site-wide activation requires explicit Owner
+ * confirmation. The proposal lands in skill_proposals; Owner accepts
+ * (creates `skills` row at status='awaiting_activation') and then
+ * activates separately.
+ */
+export declare const proposeSkillToolInput: z.ZodObject<{
+    slug: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodDefault<z.ZodString>;
+    body: z.ZodString;
+    rationale: z.ZodString;
+    allowlistedTools: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    hints: z.ZodDefault<z.ZodObject<{
+        keywords: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        chipTrigger: z.ZodDefault<z.ZodBoolean>;
+        alwaysOn: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ProposeSkillToolInput = z.infer<typeof proposeSkillToolInput>;
+/**
+ * P11 — `submit_plugin`. AI submits a Tier 2 plugin for validation +
+ * Owner approval. CLAUDE.md §2 invariant: AI submits, human Owner
+ * activates. Tier 1 plugins ship via human PR + signed release; the AI
+ * tool surface cannot promote — the manifest field `tier` is forced
+ * to 2 by the handler.
+ */
+export declare const submitPluginToolInput: z.ZodObject<{
+    slug: z.ZodString;
+    version: z.ZodString;
+    manifest: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    source: z.ZodString;
+}, z.core.$strict>;
+export type SubmitPluginToolInput = z.infer<typeof submitPluginToolInput>;
+//# sourceMappingURL=ai-tools.d.ts.map

package/dist/ai-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-tools.d.ts","sourceRoot":"","sources":["../src/ai-tools.ts"],"names":[],"mappings":"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"}