@nextblock-cms/cortex 0.17.6 → 0.17.8

package/lib/ai-global-agent-site-tools.d.ts

@@ -0,0 +1,1153 @@
+import { CortexBuildSession, CortexSiteBrief } from './site-brief';
+import { z } from './zod-config';
+/**
+ * Site-level tools: the ones a "build me a website" request needs and no
+ * page-level tool provides.
+ *
+ *   get_site_overview     one read that grounds a whole-site plan
+ *   update_site_identity  title / description / keywords / copyright / logo pin
+ *   save_site_brief       persist what the client wants, for this and later chats
+ *   reset_site_content    remove the seeded NextBlock demo content (or everything)
+ *   start_site_build      ONE confirmation that approves a plan and opens a time-boxed
+ *                         build session in which the remaining steps run unattended
+ *   finish_site_build     close the session and mark the brief built
+ *
+ * Every executor runs with the service-role client, so role checks happen here
+ * (`requireActorRole`), never in RLS.
+ */
+type SiteToolContext = {
+    actorFromOrphanedToken?: boolean;
+    actorUserId?: string | null;
+    latestUserMessage?: string | null;
+    revalidatePath?: (path: string, type?: 'layout' | 'page') => void;
+    skipConfirmation?: boolean;
+    supabase?: {
+        from: (table: string) => any;
+    };
+};
+type SupabaseLike = {
+    from: (table: string) => any;
+};
+/**
+ * What a fresh install ships (libs/db/src/supabase/migrations/02004_baseline_seed.sql
+ * plus the FR posts in 02009). Seeded rows carry no marker column, but their
+ * translation groups are fixed UUIDs — the same handles the data-fix migrations
+ * key on — so they are the most reliable way to tell "NextBlock demo content"
+ * from something the operator wrote.
+ */
+export declare const NEXTBLOCK_SEED_TRANSLATION_GROUP_IDS: ReadonlySet<string>;
+/** Bundled demo images (served from /public, no storage object behind them). */
+export declare const NEXTBLOCK_SEED_MEDIA_OBJECT_KEYS: ReadonlySet<string>;
+export declare function readCortexSiteBrief(supabase: SupabaseLike): Promise<CortexSiteBrief | null>;
+export declare const saveSiteBriefInputSchema: z.ZodObject<{
+    brief: z.ZodObject<{
+        audience: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        brand: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            accent_color: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            color_scheme: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
+                light: "light";
+                dark: "dark";
+            }>>>;
+            font_style: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            logo_notes: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            primary_color: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            secondary_color: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            style_keywords: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+            tone: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        }, z.core.$strict>>>;
+        business_name: z.ZodOptional<z.ZodString>;
+        contact: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            address: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            email: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            hours: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            phone: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            social: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+                platform: z.ZodString;
+                url: z.ZodString;
+            }, z.core.$strict>>>>;
+        }, z.core.$strict>>>;
+        description: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        ecommerce: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            products_summary: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        goals: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        keep_existing_content: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        languages: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+        notes: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        pages: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodObject<{
+            purpose: z.ZodOptional<z.ZodString>;
+            sections: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            slug: z.ZodString;
+            title: z.ZodString;
+        }, z.core.$strict>>>>;
+        primary_language: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+        site_type: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+            other: "other";
+            "landing-page": "landing-page";
+            "multi-page": "multi-page";
+            blog: "blog";
+            store: "store";
+            portfolio: "portfolio";
+        }>>>;
+        status: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+            draft: "draft";
+            confirmed: "confirmed";
+            built: "built";
+        }>>>;
+        tagline: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        updated_at: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strict>;
+    mode: z.ZodDefault<z.ZodEnum<{
+        replace: "replace";
+        merge: "merge";
+    }>>;
+}, z.core.$strict>;
+export type SaveSiteBriefInput = z.input<typeof saveSiteBriefInputSchema>;
+export declare function executeSaveSiteBrief(input: SaveSiteBriefInput, context?: SiteToolContext): Promise<{
+    brief: {
+        business_name: string;
+        keep_existing_content: boolean;
+        languages: string[];
+        pages: {
+            slug: string;
+            title: string;
+            purpose?: string | undefined;
+            sections?: string[] | undefined;
+        }[];
+        primary_language: string;
+        site_type: "other" | "landing-page" | "multi-page" | "blog" | "store" | "portfolio";
+        status: "draft" | "confirmed" | "built";
+        audience?: string | undefined;
+        brand?: {
+            accent_color?: string | undefined;
+            color_scheme?: "light" | "dark" | undefined;
+            font_style?: string | undefined;
+            logo_notes?: string | undefined;
+            primary_color?: string | undefined;
+            secondary_color?: string | undefined;
+            style_keywords?: string[] | undefined;
+            tone?: string | undefined;
+        } | undefined;
+        contact?: {
+            address?: string | undefined;
+            email?: string | undefined;
+            hours?: string | undefined;
+            phone?: string | undefined;
+            social?: {
+                platform: string;
+                url: string;
+            }[] | undefined;
+        } | undefined;
+        description?: string | undefined;
+        ecommerce?: {
+            enabled: boolean;
+            products_summary?: string | undefined;
+        } | undefined;
+        goals?: string[] | undefined;
+        notes?: string | undefined;
+        tagline?: string | undefined;
+        updated_at?: string | undefined;
+    };
+    created: boolean;
+    mutationExecuted: boolean;
+    success: boolean;
+}>;
+export declare function readCortexBuildSession(supabase: SupabaseLike): Promise<CortexBuildSession | null>;
+/** The session the chat route may honour for this actor right now, or null. */
+export declare function resolveCortexBuildSession(supabase: SupabaseLike, actorUserId: string | null | undefined): Promise<CortexBuildSession | null>;
+export declare const getSiteOverviewInputSchema: z.ZodObject<{
+    includeMedia: z.ZodDefault<z.ZodBoolean>;
+    includeNavigation: z.ZodDefault<z.ZodBoolean>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export type GetSiteOverviewInput = z.input<typeof getSiteOverviewInputSchema>;
+type NavigationNode = {
+    children: NavigationNode[];
+    id: number;
+    label: string;
+    url: string;
+};
+export declare function executeGetSiteOverview(input: GetSiteOverviewInput, context?: SiteToolContext): Promise<{
+    brief: {
+        business_name: string;
+        keep_existing_content: boolean;
+        languages: string[];
+        pages: {
+            slug: string;
+            title: string;
+            purpose?: string | undefined;
+            sections?: string[] | undefined;
+        }[];
+        primary_language: string;
+        site_type: "other" | "landing-page" | "multi-page" | "blog" | "store" | "portfolio";
+        status: "draft" | "confirmed" | "built";
+        audience?: string | undefined;
+        brand?: {
+            accent_color?: string | undefined;
+            color_scheme?: "light" | "dark" | undefined;
+            font_style?: string | undefined;
+            logo_notes?: string | undefined;
+            primary_color?: string | undefined;
+            secondary_color?: string | undefined;
+            style_keywords?: string[] | undefined;
+            tone?: string | undefined;
+        } | undefined;
+        contact?: {
+            address?: string | undefined;
+            email?: string | undefined;
+            hours?: string | undefined;
+            phone?: string | undefined;
+            social?: {
+                platform: string;
+                url: string;
+            }[] | undefined;
+        } | undefined;
+        description?: string | undefined;
+        ecommerce?: {
+            enabled: boolean;
+            products_summary?: string | undefined;
+        } | undefined;
+        goals?: string[] | undefined;
+        notes?: string | undefined;
+        tagline?: string | undefined;
+        updated_at?: string | undefined;
+    } | null;
+    buildSession: {
+        expiresAt: string;
+        id: string;
+        summary: string;
+    } | null;
+    counts: {
+        customBlocks: number;
+        drafts: number;
+        media: number;
+        pages: number;
+        posts: number;
+        products: number;
+    };
+    customBlocks: {
+        fieldCount: any;
+        fields: any;
+        name: string;
+        slug: string;
+    }[];
+    drafts: {
+        parentId: number;
+        parentType: string;
+    }[];
+    homePage: {
+        blockCount: number;
+        id: number;
+        isHome: boolean;
+        isSeeded: boolean;
+        languageCode: string;
+        slug: string;
+        status: string;
+        title: string;
+        translationGroupId: string | null;
+    } | null;
+    identity: {
+        activeLogo: {
+            id: string;
+            isSeeded: boolean;
+            name: string;
+            objectKey: string | null;
+        } | null;
+        footerCopyright: {} | null;
+        footerShowAttribution: boolean;
+        siteDescription: unknown;
+        siteKeywords: unknown;
+        siteTitle: string;
+    };
+    languages: {
+        code: string;
+        id: number;
+        isActive: boolean;
+        isDefault: boolean;
+        name: string;
+    }[];
+    media: {
+        count: number;
+        sample: {
+            altText: any;
+            fileName: any;
+            id: string;
+            isSeeded: boolean;
+        }[] | undefined;
+        seededCount: number;
+    };
+    navigation: Record<"footer" | "header", Record<string, NavigationNode[]>> | null;
+    nextSteps: string[];
+    pages: {
+        blockCount: number;
+        id: number;
+        isHome: boolean;
+        isSeeded: boolean;
+        languageCode: string;
+        slug: string;
+        status: string;
+        title: string;
+        translationGroupId: string | null;
+    }[];
+    posts: {
+        blockCount: number;
+        id: number;
+        isSeeded: boolean;
+        languageCode: string;
+        publishedAt: any;
+        slug: string;
+        status: string;
+        title: string;
+        translationGroupId: string | null;
+    }[];
+    products: {
+        id: string;
+        languageCode: string;
+        slug: string;
+        status: string;
+        title: string;
+    }[];
+    seeded: {
+        anyPresent: boolean;
+        copyright: boolean;
+        logo: boolean;
+        media: number;
+        pages: number;
+        posts: number;
+        siteTitle: boolean;
+    };
+    success: boolean;
+    themes: {
+        colorScheme: string;
+        isActive: boolean;
+        isDefault: boolean;
+        name: string;
+        slug: string;
+    }[];
+}>;
+export declare const updateSiteIdentityInputSchema: z.ZodObject<{
+    active_logo_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    footer_copyright: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    footer_show_attribution: z.ZodOptional<z.ZodBoolean>;
+    site_description: z.ZodOptional<z.ZodString>;
+    site_keywords: z.ZodOptional<z.ZodString>;
+    site_title: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type UpdateSiteIdentityInput = z.input<typeof updateSiteIdentityInputSchema>;
+export declare function executeUpdateSiteIdentity(input: UpdateSiteIdentityInput, context?: SiteToolContext): Promise<{
+    confirmationPhrase: string;
+    mutationExecuted: boolean;
+    preview: Record<string, unknown>;
+    requiresConfirmation: boolean;
+    success: boolean;
+} | {
+    mutationExecuted: boolean;
+    success: boolean;
+    updatedKeys: string[];
+}>;
+export declare const resetSiteContentInputSchema: z.ZodObject<{
+    clearKeptPageBlocks: z.ZodDefault<z.ZodBoolean>;
+    dryRun: z.ZodDefault<z.ZodBoolean>;
+    keepLanguages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    keepPageSlugs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    onlySeeded: z.ZodDefault<z.ZodBoolean>;
+    scope: z.ZodDefault<z.ZodObject<{
+        customBlocks: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        identity: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        navigation: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        pages: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        posts: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        products: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        seededMedia: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ResetSiteContentInput = z.input<typeof resetSiteContentInputSchema>;
+export declare function executeResetSiteContent(input: ResetSiteContentInput, context?: SiteToolContext): Promise<{
+    confirmationPhrase: string;
+    mutationExecuted: boolean;
+    preview: Record<string, unknown>;
+    requiresConfirmation: boolean;
+    success: boolean;
+} | {
+    dryRun: boolean;
+    mutationExecuted: boolean;
+    nextSteps: string[];
+    success: boolean;
+    summary: {
+        blocksClearedOnPages: number;
+        customBlocks: number;
+        drafts: number;
+        identityCleared: boolean;
+        languagesDeactivated: string[];
+        logos: number;
+        media: number;
+        navigationItems: number;
+        pages: number;
+        pagesKept: string[];
+        posts: number;
+        products: number;
+    };
+    wouldDelete: {
+        pages: {
+            id: number;
+            slug: string;
+            languageCode: string;
+        }[];
+        posts: {
+            id: number;
+            slug: string;
+            languageCode: string;
+        }[];
+    };
+    deleted?: undefined;
+} | {
+    deleted: {
+        blocksClearedOnPages: number;
+        customBlocks: number;
+        drafts: number;
+        identityCleared: boolean;
+        languagesDeactivated: string[];
+        logos: number;
+        media: number;
+        navigationItems: number;
+        pages: number;
+        pagesKept: string[];
+        posts: number;
+        products: number;
+    };
+    mutationExecuted: boolean;
+    nextSteps: string[];
+    success: boolean;
+    dryRun?: undefined;
+    summary?: undefined;
+    wouldDelete?: undefined;
+}>;
+export declare const startSiteBuildInputSchema: z.ZodObject<{
+    brief: z.ZodOptional<z.ZodObject<{
+        audience: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        brand: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            accent_color: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            color_scheme: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
+                light: "light";
+                dark: "dark";
+            }>>>;
+            font_style: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            logo_notes: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            primary_color: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            secondary_color: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            style_keywords: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+            tone: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        }, z.core.$strict>>>;
+        business_name: z.ZodOptional<z.ZodString>;
+        contact: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            address: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            email: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            hours: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            phone: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            social: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+                platform: z.ZodString;
+                url: z.ZodString;
+            }, z.core.$strict>>>>;
+        }, z.core.$strict>>>;
+        description: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        ecommerce: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            products_summary: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        goals: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        keep_existing_content: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        languages: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+        notes: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        pages: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodObject<{
+            purpose: z.ZodOptional<z.ZodString>;
+            sections: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            slug: z.ZodString;
+            title: z.ZodString;
+        }, z.core.$strict>>>>;
+        primary_language: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+        site_type: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+            other: "other";
+            "landing-page": "landing-page";
+            "multi-page": "multi-page";
+            blog: "blog";
+            store: "store";
+            portfolio: "portfolio";
+        }>>>;
+        status: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+            draft: "draft";
+            confirmed: "confirmed";
+            built: "built";
+        }>>>;
+        tagline: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        updated_at: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strict>>;
+    durationMinutes: z.ZodDefault<z.ZodNumber>;
+    reset: z.ZodOptional<z.ZodObject<{
+        clearKeptPageBlocks: z.ZodDefault<z.ZodBoolean>;
+        dryRun: z.ZodDefault<z.ZodBoolean>;
+        keepLanguages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        keepPageSlugs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        onlySeeded: z.ZodDefault<z.ZodBoolean>;
+        scope: z.ZodDefault<z.ZodObject<{
+            customBlocks: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            identity: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            navigation: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            pages: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            posts: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            products: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            seededMedia: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    summary: z.ZodString;
+}, z.core.$strict>;
+export type StartSiteBuildInput = z.input<typeof startSiteBuildInputSchema>;
+export declare function executeStartSiteBuild(input: StartSiteBuildInput, context?: SiteToolContext): Promise<{
+    confirmationPhrase: string;
+    mutationExecuted: boolean;
+    preview: Record<string, unknown>;
+    requiresConfirmation: boolean;
+    success: boolean;
+} | {
+    brief: {
+        business_name: string;
+        keep_existing_content: boolean;
+        languages: string[];
+        pages: {
+            slug: string;
+            title: string;
+            purpose?: string | undefined;
+            sections?: string[] | undefined;
+        }[];
+        primary_language: string;
+        site_type: "other" | "landing-page" | "multi-page" | "blog" | "store" | "portfolio";
+        status: "draft" | "confirmed" | "built";
+        audience?: string | undefined;
+        brand?: {
+            accent_color?: string | undefined;
+            color_scheme?: "light" | "dark" | undefined;
+            font_style?: string | undefined;
+            logo_notes?: string | undefined;
+            primary_color?: string | undefined;
+            secondary_color?: string | undefined;
+            style_keywords?: string[] | undefined;
+            tone?: string | undefined;
+        } | undefined;
+        contact?: {
+            address?: string | undefined;
+            email?: string | undefined;
+            hours?: string | undefined;
+            phone?: string | undefined;
+            social?: {
+                platform: string;
+                url: string;
+            }[] | undefined;
+        } | undefined;
+        description?: string | undefined;
+        ecommerce?: {
+            enabled: boolean;
+            products_summary?: string | undefined;
+        } | undefined;
+        goals?: string[] | undefined;
+        notes?: string | undefined;
+        tagline?: string | undefined;
+        updated_at?: string | undefined;
+    } | null;
+    buildSession: {
+        expiresAt: string;
+        id: string;
+    };
+    continuePrompt: string;
+    mutationExecuted: boolean;
+    resetResult: Record<string, unknown> | null;
+    success: boolean;
+}>;
+export declare const finishSiteBuildInputSchema: z.ZodObject<{
+    outcome: z.ZodDefault<z.ZodEnum<{
+        built: "built";
+        stopped: "stopped";
+    }>>;
+    summary: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type FinishSiteBuildInput = z.input<typeof finishSiteBuildInputSchema>;
+export declare function executeFinishSiteBuild(input: FinishSiteBuildInput, context?: SiteToolContext): Promise<{
+    brief: {
+        business_name: string;
+        keep_existing_content: boolean;
+        languages: string[];
+        pages: {
+            slug: string;
+            title: string;
+            purpose?: string | undefined;
+            sections?: string[] | undefined;
+        }[];
+        primary_language: string;
+        site_type: "other" | "landing-page" | "multi-page" | "blog" | "store" | "portfolio";
+        status: "draft" | "confirmed" | "built";
+        audience?: string | undefined;
+        brand?: {
+            accent_color?: string | undefined;
+            color_scheme?: "light" | "dark" | undefined;
+            font_style?: string | undefined;
+            logo_notes?: string | undefined;
+            primary_color?: string | undefined;
+            secondary_color?: string | undefined;
+            style_keywords?: string[] | undefined;
+            tone?: string | undefined;
+        } | undefined;
+        contact?: {
+            address?: string | undefined;
+            email?: string | undefined;
+            hours?: string | undefined;
+            phone?: string | undefined;
+            social?: {
+                platform: string;
+                url: string;
+            }[] | undefined;
+        } | undefined;
+        description?: string | undefined;
+        ecommerce?: {
+            enabled: boolean;
+            products_summary?: string | undefined;
+        } | undefined;
+        goals?: string[] | undefined;
+        notes?: string | undefined;
+        tagline?: string | undefined;
+        updated_at?: string | undefined;
+    } | null;
+    buildSessionEnded: boolean;
+    hadSession: boolean;
+    mutationExecuted: boolean;
+    outcome: "built" | "stopped";
+    success: boolean;
+}>;
+export declare function createCortexSiteTools(context?: SiteToolContext): {
+    get_site_overview: import('ai').Tool<{
+        includeMedia: boolean;
+        includeNavigation: boolean;
+        limit: number;
+    }, {
+        brief: {
+            business_name: string;
+            keep_existing_content: boolean;
+            languages: string[];
+            pages: {
+                slug: string;
+                title: string;
+                purpose?: string | undefined;
+                sections?: string[] | undefined;
+            }[];
+            primary_language: string;
+            site_type: "other" | "landing-page" | "multi-page" | "blog" | "store" | "portfolio";
+            status: "draft" | "confirmed" | "built";
+            audience?: string | undefined;
+            brand?: {
+                accent_color?: string | undefined;
+                color_scheme?: "light" | "dark" | undefined;
+                font_style?: string | undefined;
+                logo_notes?: string | undefined;
+                primary_color?: string | undefined;
+                secondary_color?: string | undefined;
+                style_keywords?: string[] | undefined;
+                tone?: string | undefined;
+            } | undefined;
+            contact?: {
+                address?: string | undefined;
+                email?: string | undefined;
+                hours?: string | undefined;
+                phone?: string | undefined;
+                social?: {
+                    platform: string;
+                    url: string;
+                }[] | undefined;
+            } | undefined;
+            description?: string | undefined;
+            ecommerce?: {
+                enabled: boolean;
+                products_summary?: string | undefined;
+            } | undefined;
+            goals?: string[] | undefined;
+            notes?: string | undefined;
+            tagline?: string | undefined;
+            updated_at?: string | undefined;
+        } | null;
+        buildSession: {
+            expiresAt: string;
+            id: string;
+            summary: string;
+        } | null;
+        counts: {
+            customBlocks: number;
+            drafts: number;
+            media: number;
+            pages: number;
+            posts: number;
+            products: number;
+        };
+        customBlocks: {
+            fieldCount: any;
+            fields: any;
+            name: string;
+            slug: string;
+        }[];
+        drafts: {
+            parentId: number;
+            parentType: string;
+        }[];
+        homePage: {
+            blockCount: number;
+            id: number;
+            isHome: boolean;
+            isSeeded: boolean;
+            languageCode: string;
+            slug: string;
+            status: string;
+            title: string;
+            translationGroupId: string | null;
+        } | null;
+        identity: {
+            activeLogo: {
+                id: string;
+                isSeeded: boolean;
+                name: string;
+                objectKey: string | null;
+            } | null;
+            footerCopyright: {} | null;
+            footerShowAttribution: boolean;
+            siteDescription: unknown;
+            siteKeywords: unknown;
+            siteTitle: string;
+        };
+        languages: {
+            code: string;
+            id: number;
+            isActive: boolean;
+            isDefault: boolean;
+            name: string;
+        }[];
+        media: {
+            count: number;
+            sample: {
+                altText: any;
+                fileName: any;
+                id: string;
+                isSeeded: boolean;
+            }[] | undefined;
+            seededCount: number;
+        };
+        navigation: Record<"footer" | "header", Record<string, NavigationNode[]>> | null;
+        nextSteps: string[];
+        pages: {
+            blockCount: number;
+            id: number;
+            isHome: boolean;
+            isSeeded: boolean;
+            languageCode: string;
+            slug: string;
+            status: string;
+            title: string;
+            translationGroupId: string | null;
+        }[];
+        posts: {
+            blockCount: number;
+            id: number;
+            isSeeded: boolean;
+            languageCode: string;
+            publishedAt: any;
+            slug: string;
+            status: string;
+            title: string;
+            translationGroupId: string | null;
+        }[];
+        products: {
+            id: string;
+            languageCode: string;
+            slug: string;
+            status: string;
+            title: string;
+        }[];
+        seeded: {
+            anyPresent: boolean;
+            copyright: boolean;
+            logo: boolean;
+            media: number;
+            pages: number;
+            posts: number;
+            siteTitle: boolean;
+        };
+        success: boolean;
+        themes: {
+            colorScheme: string;
+            isActive: boolean;
+            isDefault: boolean;
+            name: string;
+            slug: string;
+        }[];
+    }>;
+    update_site_identity: import('ai').Tool<{
+        active_logo_id?: string | null | undefined;
+        footer_copyright?: Record<string, string> | undefined;
+        footer_show_attribution?: boolean | undefined;
+        site_description?: string | undefined;
+        site_keywords?: string | undefined;
+        site_title?: string | undefined;
+    }, {
+        confirmationPhrase: string;
+        mutationExecuted: boolean;
+        preview: Record<string, unknown>;
+        requiresConfirmation: boolean;
+        success: boolean;
+    } | {
+        mutationExecuted: boolean;
+        success: boolean;
+        updatedKeys: string[];
+    }>;
+    save_site_brief: import('ai').Tool<{
+        brief: {
+            audience?: string | undefined;
+            brand?: {
+                accent_color?: string | undefined;
+                color_scheme?: "light" | "dark" | undefined;
+                font_style?: string | undefined;
+                logo_notes?: string | undefined;
+                primary_color?: string | undefined;
+                secondary_color?: string | undefined;
+                style_keywords?: string[] | undefined;
+                tone?: string | undefined;
+            } | undefined;
+            business_name?: string | undefined;
+            contact?: {
+                address?: string | undefined;
+                email?: string | undefined;
+                hours?: string | undefined;
+                phone?: string | undefined;
+                social?: {
+                    platform: string;
+                    url: string;
+                }[] | undefined;
+            } | undefined;
+            description?: string | undefined;
+            ecommerce?: {
+                enabled: boolean;
+                products_summary?: string | undefined;
+            } | undefined;
+            goals?: string[] | undefined;
+            keep_existing_content?: boolean | undefined;
+            languages?: string[] | undefined;
+            notes?: string | undefined;
+            pages?: {
+                slug: string;
+                title: string;
+                purpose?: string | undefined;
+                sections?: string[] | undefined;
+            }[] | undefined;
+            primary_language?: string | undefined;
+            site_type?: "other" | "landing-page" | "multi-page" | "blog" | "store" | "portfolio" | undefined;
+            status?: "draft" | "confirmed" | "built" | undefined;
+            tagline?: string | undefined;
+            updated_at?: string | undefined;
+        };
+        mode: "replace" | "merge";
+    }, {
+        brief: {
+            business_name: string;
+            keep_existing_content: boolean;
+            languages: string[];
+            pages: {
+                slug: string;
+                title: string;
+                purpose?: string | undefined;
+                sections?: string[] | undefined;
+            }[];
+            primary_language: string;
+            site_type: "other" | "landing-page" | "multi-page" | "blog" | "store" | "portfolio";
+            status: "draft" | "confirmed" | "built";
+            audience?: string | undefined;
+            brand?: {
+                accent_color?: string | undefined;
+                color_scheme?: "light" | "dark" | undefined;
+                font_style?: string | undefined;
+                logo_notes?: string | undefined;
+                primary_color?: string | undefined;
+                secondary_color?: string | undefined;
+                style_keywords?: string[] | undefined;
+                tone?: string | undefined;
+            } | undefined;
+            contact?: {
+                address?: string | undefined;
+                email?: string | undefined;
+                hours?: string | undefined;
+                phone?: string | undefined;
+                social?: {
+                    platform: string;
+                    url: string;
+                }[] | undefined;
+            } | undefined;
+            description?: string | undefined;
+            ecommerce?: {
+                enabled: boolean;
+                products_summary?: string | undefined;
+            } | undefined;
+            goals?: string[] | undefined;
+            notes?: string | undefined;
+            tagline?: string | undefined;
+            updated_at?: string | undefined;
+        };
+        created: boolean;
+        mutationExecuted: boolean;
+        success: boolean;
+    }>;
+    reset_site_content: import('ai').Tool<{
+        clearKeptPageBlocks: boolean;
+        dryRun: boolean;
+        keepPageSlugs: string[];
+        onlySeeded: boolean;
+        scope: {
+            customBlocks?: boolean | undefined;
+            identity?: boolean | undefined;
+            navigation?: boolean | undefined;
+            pages?: boolean | undefined;
+            posts?: boolean | undefined;
+            products?: boolean | undefined;
+            seededMedia?: boolean | undefined;
+        };
+        keepLanguages?: string[] | undefined;
+    }, {
+        confirmationPhrase: string;
+        mutationExecuted: boolean;
+        preview: Record<string, unknown>;
+        requiresConfirmation: boolean;
+        success: boolean;
+    } | {
+        dryRun: boolean;
+        mutationExecuted: boolean;
+        nextSteps: string[];
+        success: boolean;
+        summary: {
+            blocksClearedOnPages: number;
+            customBlocks: number;
+            drafts: number;
+            identityCleared: boolean;
+            languagesDeactivated: string[];
+            logos: number;
+            media: number;
+            navigationItems: number;
+            pages: number;
+            pagesKept: string[];
+            posts: number;
+            products: number;
+        };
+        wouldDelete: {
+            pages: {
+                id: number;
+                slug: string;
+                languageCode: string;
+            }[];
+            posts: {
+                id: number;
+                slug: string;
+                languageCode: string;
+            }[];
+        };
+        deleted?: undefined;
+    } | {
+        deleted: {
+            blocksClearedOnPages: number;
+            customBlocks: number;
+            drafts: number;
+            identityCleared: boolean;
+            languagesDeactivated: string[];
+            logos: number;
+            media: number;
+            navigationItems: number;
+            pages: number;
+            pagesKept: string[];
+            posts: number;
+            products: number;
+        };
+        mutationExecuted: boolean;
+        nextSteps: string[];
+        success: boolean;
+        dryRun?: undefined;
+        summary?: undefined;
+        wouldDelete?: undefined;
+    }>;
+    start_site_build: import('ai').Tool<{
+        durationMinutes: number;
+        summary: string;
+        brief?: {
+            audience?: string | undefined;
+            brand?: {
+                accent_color?: string | undefined;
+                color_scheme?: "light" | "dark" | undefined;
+                font_style?: string | undefined;
+                logo_notes?: string | undefined;
+                primary_color?: string | undefined;
+                secondary_color?: string | undefined;
+                style_keywords?: string[] | undefined;
+                tone?: string | undefined;
+            } | undefined;
+            business_name?: string | undefined;
+            contact?: {
+                address?: string | undefined;
+                email?: string | undefined;
+                hours?: string | undefined;
+                phone?: string | undefined;
+                social?: {
+                    platform: string;
+                    url: string;
+                }[] | undefined;
+            } | undefined;
+            description?: string | undefined;
+            ecommerce?: {
+                enabled: boolean;
+                products_summary?: string | undefined;
+            } | undefined;
+            goals?: string[] | undefined;
+            keep_existing_content?: boolean | undefined;
+            languages?: string[] | undefined;
+            notes?: string | undefined;
+            pages?: {
+                slug: string;
+                title: string;
+                purpose?: string | undefined;
+                sections?: string[] | undefined;
+            }[] | undefined;
+            primary_language?: string | undefined;
+            site_type?: "other" | "landing-page" | "multi-page" | "blog" | "store" | "portfolio" | undefined;
+            status?: "draft" | "confirmed" | "built" | undefined;
+            tagline?: string | undefined;
+            updated_at?: string | undefined;
+        } | undefined;
+        reset?: {
+            clearKeptPageBlocks: boolean;
+            dryRun: boolean;
+            keepPageSlugs: string[];
+            onlySeeded: boolean;
+            scope: {
+                customBlocks?: boolean | undefined;
+                identity?: boolean | undefined;
+                navigation?: boolean | undefined;
+                pages?: boolean | undefined;
+                posts?: boolean | undefined;
+                products?: boolean | undefined;
+                seededMedia?: boolean | undefined;
+            };
+            keepLanguages?: string[] | undefined;
+        } | undefined;
+    }, {
+        confirmationPhrase: string;
+        mutationExecuted: boolean;
+        preview: Record<string, unknown>;
+        requiresConfirmation: boolean;
+        success: boolean;
+    } | {
+        brief: {
+            business_name: string;
+            keep_existing_content: boolean;
+            languages: string[];
+            pages: {
+                slug: string;
+                title: string;
+                purpose?: string | undefined;
+                sections?: string[] | undefined;
+            }[];
+            primary_language: string;
+            site_type: "other" | "landing-page" | "multi-page" | "blog" | "store" | "portfolio";
+            status: "draft" | "confirmed" | "built";
+            audience?: string | undefined;
+            brand?: {
+                accent_color?: string | undefined;
+                color_scheme?: "light" | "dark" | undefined;
+                font_style?: string | undefined;
+                logo_notes?: string | undefined;
+                primary_color?: string | undefined;
+                secondary_color?: string | undefined;
+                style_keywords?: string[] | undefined;
+                tone?: string | undefined;
+            } | undefined;
+            contact?: {
+                address?: string | undefined;
+                email?: string | undefined;
+                hours?: string | undefined;
+                phone?: string | undefined;
+                social?: {
+                    platform: string;
+                    url: string;
+                }[] | undefined;
+            } | undefined;
+            description?: string | undefined;
+            ecommerce?: {
+                enabled: boolean;
+                products_summary?: string | undefined;
+            } | undefined;
+            goals?: string[] | undefined;
+            notes?: string | undefined;
+            tagline?: string | undefined;
+            updated_at?: string | undefined;
+        } | null;
+        buildSession: {
+            expiresAt: string;
+            id: string;
+        };
+        continuePrompt: string;
+        mutationExecuted: boolean;
+        resetResult: Record<string, unknown> | null;
+        success: boolean;
+    }>;
+    finish_site_build: import('ai').Tool<{
+        outcome: "built" | "stopped";
+        summary?: string | undefined;
+    }, {
+        brief: {
+            business_name: string;
+            keep_existing_content: boolean;
+            languages: string[];
+            pages: {
+                slug: string;
+                title: string;
+                purpose?: string | undefined;
+                sections?: string[] | undefined;
+            }[];
+            primary_language: string;
+            site_type: "other" | "landing-page" | "multi-page" | "blog" | "store" | "portfolio";
+            status: "draft" | "confirmed" | "built";
+            audience?: string | undefined;
+            brand?: {
+                accent_color?: string | undefined;
+                color_scheme?: "light" | "dark" | undefined;
+                font_style?: string | undefined;
+                logo_notes?: string | undefined;
+                primary_color?: string | undefined;
+                secondary_color?: string | undefined;
+                style_keywords?: string[] | undefined;
+                tone?: string | undefined;
+            } | undefined;
+            contact?: {
+                address?: string | undefined;
+                email?: string | undefined;
+                hours?: string | undefined;
+                phone?: string | undefined;
+                social?: {
+                    platform: string;
+                    url: string;
+                }[] | undefined;
+            } | undefined;
+            description?: string | undefined;
+            ecommerce?: {
+                enabled: boolean;
+                products_summary?: string | undefined;
+            } | undefined;
+            goals?: string[] | undefined;
+            notes?: string | undefined;
+            tagline?: string | undefined;
+            updated_at?: string | undefined;
+        } | null;
+        buildSessionEnded: boolean;
+        hadSession: boolean;
+        mutationExecuted: boolean;
+        outcome: "built" | "stopped";
+        success: boolean;
+    }>;
+};
+export {};