@nextblock-cms/cortex 0.13.1 → 0.13.2

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

@@ -7,10 +7,24 @@ type SupabaseLike = {
 type RevalidateFn = (path: string, type?: 'layout' | 'page') => void;
 type BlockContentValidator = (blockType: BlockType, content: Record<string, any>) => BlockValidationResult;
 type MenuKey = 'HEADER' | 'FOOTER';
+/**
+ * Imports an external image URL into the NextBlock media library and returns the
+ * new media row id (a UUID). Injected by the app (which owns storage + sharp);
+ * the lib can't import the app-side importer directly. Absent in tests/CLI.
+ */
+type ImportExternalImageFn = (input: {
+    url: string;
+    altText?: string;
+}) => Promise<{
+    id: string;
+} | {
+    error: string;
+}>;
 type ToolExecutionContext = {
     actorUserId?: string | null;
     cortexAiApiKey?: string | null;
     cortexAiModelSelection?: unknown;
+    importExternalImage?: ImportExternalImageFn;
     latestUserMessage?: string | null;
     pageContext?: CortexAiPageContext | null;
     revalidatePath?: RevalidateFn;
@@ -1965,6 +1979,231 @@ export declare function executeCmsActionPlan(input: z.input<typeof executeCmsAct
     success: boolean;
     summary: string | null;
 }>;
+export declare const fetchUrlContentInputSchema: z.ZodObject<{
+    maxChars: z.ZodDefault<z.ZodNumber>;
+    url: z.ZodString;
+}, z.core.$strict>;
+export type FetchUrlContentInput = z.input<typeof fetchUrlContentInputSchema>;
+export declare function executeFetchUrlContent(input: FetchUrlContentInput): Promise<{
+    message: string;
+    success: boolean;
+    url: string;
+    status?: undefined;
+    contentType?: undefined;
+    description?: undefined;
+    finalUrl?: undefined;
+    headings?: undefined;
+    text?: undefined;
+    title?: undefined;
+    truncated?: undefined;
+} | {
+    message: string;
+    status: number;
+    success: boolean;
+    url: string;
+    contentType?: undefined;
+    description?: undefined;
+    finalUrl?: undefined;
+    headings?: undefined;
+    text?: undefined;
+    title?: undefined;
+    truncated?: undefined;
+} | {
+    contentType: string;
+    message: string;
+    success: boolean;
+    url: string;
+    status?: undefined;
+    description?: undefined;
+    finalUrl?: undefined;
+    headings?: undefined;
+    text?: undefined;
+    title?: undefined;
+    truncated?: undefined;
+} | {
+    description: string;
+    finalUrl: string;
+    headings: string[];
+    success: boolean;
+    text: string;
+    title: string;
+    truncated: boolean;
+    url: string;
+    message?: undefined;
+    status?: undefined;
+    contentType?: undefined;
+}>;
+export declare const searchStockPhotosInputSchema: z.ZodObject<{
+    count: z.ZodDefault<z.ZodNumber>;
+    orientation: z.ZodOptional<z.ZodEnum<{
+        landscape: "landscape";
+        portrait: "portrait";
+        square: "square";
+    }>>;
+    query: z.ZodString;
+}, z.core.$strict>;
+export type SearchStockPhotosInput = z.input<typeof searchStockPhotosInputSchema>;
+type CortexAiStockPhotoProvider = {
+    apiKey: string;
+    provider: 'pexels' | 'unsplash';
+};
+/**
+ * Resolve ALL configured stock-photo providers, ordered by preference: Pexels
+ * first, then Unsplash. Each provider's key comes from an admin-stored, encrypted
+ * site_settings row (read via the service-role client) if present, else the
+ * PEXELS_API_KEY / UNSPLASH_ACCESS_KEY env var. The tool tries them in order,
+ * falling back to the next provider when one is rate-limited or errors.
+ *
+ * ai-config (which pulls in server-only secret crypto) is imported lazily so this
+ * module's static graph stays test-friendly; the DB branch only runs server-side.
+ */
+export declare function resolveCortexAiStockPhotoProviders(supabase?: SupabaseLike): Promise<CortexAiStockPhotoProvider[]>;
+/** The primary (first-preference) stock-photo provider, or null when none configured. */
+export declare function resolveCortexAiStockPhotoProvider(supabase?: SupabaseLike): Promise<CortexAiStockPhotoProvider | null>;
+/**
+ * Fire the Unsplash download-trigger endpoint for every Unsplash photo placed in
+ * the given blocks. Required by the Unsplash API Guidelines when a photo is used.
+ * Best-effort and fire-and-forget: it resolves the Unsplash key, dedupes, and
+ * never blocks or fails the mutation.
+ */
+export declare function maybeTriggerStockPhotoDownloads(blocks: Array<{
+    content?: unknown;
+} | null | undefined>, supabase?: SupabaseLike): Promise<void>;
+export declare function executeSearchStockPhotos(input: SearchStockPhotosInput, context?: ToolExecutionContext): Promise<{
+    message: string;
+    photos: never[];
+    success: boolean;
+    attemptedProviders?: undefined;
+    provider?: undefined;
+    query?: undefined;
+    usageGuidance?: undefined;
+} | {
+    attemptedProviders: string[];
+    photos: any;
+    provider: "pexels" | "unsplash";
+    query: string;
+    success: boolean;
+    usageGuidance: string;
+    message?: undefined;
+} | {
+    attemptedProviders: string[];
+    message: string;
+    photos: never[];
+    success: boolean;
+    provider?: undefined;
+    query?: undefined;
+    usageGuidance?: undefined;
+}>;
+export declare const rewritePageDraftInputSchema: z.ZodObject<{
+    contentType: z.ZodOptional<z.ZodEnum<{
+        product: "product";
+        page: "page";
+        post: "post";
+    }>>;
+    entityId: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    slug: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    blocks: z.ZodArray<z.ZodObject<{
+        blockType: z.ZodEnum<{
+            text: "text";
+            section: "section";
+            heading: "heading";
+            image: "image";
+            button: "button";
+            posts_grid: "posts_grid";
+            video_embed: "video_embed";
+            form: "form";
+            testimonial: "testimonial";
+            product_grid: "product_grid";
+            featured_product: "featured_product";
+            cart: "cart";
+            checkout: "checkout";
+            product_details: "product_details";
+        }>;
+        content: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        order: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    meta: z.ZodOptional<z.ZodObject<{
+        meta_description: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        meta_title: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        slug: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        status: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
+            draft: "draft";
+            published: "published";
+            archived: "archived";
+        }>>>;
+        title: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type RewritePageDraftInput = z.infer<typeof rewritePageDraftInputSchema>;
+export declare function executeRewritePageDraft(input: RewritePageDraftInput, context?: ToolExecutionContext): Promise<{
+    confirmationPhrase: string;
+    mutationExecuted: boolean;
+    preview: Record<string, unknown>;
+    requiresConfirmation: boolean;
+    success: boolean;
+} | {
+    blockCount: number;
+    contentType: "page" | "post";
+    draftPreviewPath: string | null;
+    editPath: string;
+    entityId: number;
+    isDraft: boolean;
+    mutationExecuted: boolean;
+    slug: string;
+    success: boolean;
+    title: string;
+}>;
+export declare const translatePageInputSchema: z.ZodObject<{
+    targetLanguageCode: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    translations: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>;
+export type TranslatePageInput = z.infer<typeof translatePageInputSchema>;
+export declare function executeTranslatePage(input: TranslatePageInput, context?: ToolExecutionContext): Promise<{
+    confirmationPhrase: string;
+    mutationExecuted: boolean;
+    preview: Record<string, unknown>;
+    requiresConfirmation: boolean;
+    success: boolean;
+} | {
+    isTranslation: boolean;
+    languageCode: string;
+}>;
+declare const setContentImagesInputSchema: z.ZodObject<{
+    images: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+type SetContentImagesInput = z.infer<typeof setContentImagesInputSchema>;
+/**
+ * Set the feature image (pages/posts) or the ordered image gallery (products)
+ * for the CURRENT CMS item. Each entry may be an existing media library id or an
+ * external image URL (imported automatically). The first entry is the feature /
+ * main image. For pages/posts only the first entry is used (they have a single
+ * feature image); for products every entry becomes a product_media row in order.
+ */
+export declare function executeSetContentImages(input: SetContentImagesInput, context?: ToolExecutionContext): Promise<{
+    confirmationPhrase: string;
+    mutationExecuted: boolean;
+    preview: Record<string, unknown>;
+    requiresConfirmation: boolean;
+    success: boolean;
+} | {
+    contentType: string;
+    entityId: string | number;
+    imageCount: number;
+    mutationExecuted: boolean;
+    slug: any;
+    success: boolean;
+    extraImagesIgnored?: undefined;
+} | {
+    contentType: "product" | "page" | "post";
+    entityId: string | number;
+    extraImagesIgnored: number;
+    imageCount: number;
+    mutationExecuted: boolean;
+    slug: any;
+    success: boolean;
+}>;
 export declare function createCortexGlobalAgentTools(context?: ToolExecutionContext): {
     fetch_ecommerce_stats: import('ai').Tool<{
         query: string;
@@ -2017,6 +2256,161 @@ export declare function createCortexGlobalAgentTools(context?: ToolExecutionCont
         }[];
         success: boolean;
     }>;
+    fetch_url_content: import('ai').Tool<{
+        maxChars: number;
+        url: string;
+    }, {
+        message: string;
+        success: boolean;
+        url: string;
+        status?: undefined;
+        contentType?: undefined;
+        description?: undefined;
+        finalUrl?: undefined;
+        headings?: undefined;
+        text?: undefined;
+        title?: undefined;
+        truncated?: undefined;
+    } | {
+        message: string;
+        status: number;
+        success: boolean;
+        url: string;
+        contentType?: undefined;
+        description?: undefined;
+        finalUrl?: undefined;
+        headings?: undefined;
+        text?: undefined;
+        title?: undefined;
+        truncated?: undefined;
+    } | {
+        contentType: string;
+        message: string;
+        success: boolean;
+        url: string;
+        status?: undefined;
+        description?: undefined;
+        finalUrl?: undefined;
+        headings?: undefined;
+        text?: undefined;
+        title?: undefined;
+        truncated?: undefined;
+    } | {
+        description: string;
+        finalUrl: string;
+        headings: string[];
+        success: boolean;
+        text: string;
+        title: string;
+        truncated: boolean;
+        url: string;
+        message?: undefined;
+        status?: undefined;
+        contentType?: undefined;
+    }>;
+    search_stock_photos: import('ai').Tool<{
+        count: number;
+        query: string;
+        orientation?: "landscape" | "portrait" | "square" | undefined;
+    }, {
+        message: string;
+        photos: never[];
+        success: boolean;
+        attemptedProviders?: undefined;
+        provider?: undefined;
+        query?: undefined;
+        usageGuidance?: undefined;
+    } | {
+        attemptedProviders: string[];
+        photos: any;
+        provider: "pexels" | "unsplash";
+        query: string;
+        success: boolean;
+        usageGuidance: string;
+        message?: undefined;
+    } | {
+        attemptedProviders: string[];
+        message: string;
+        photos: never[];
+        success: boolean;
+        provider?: undefined;
+        query?: undefined;
+        usageGuidance?: undefined;
+    }>;
+    rewrite_page_draft: import('ai').Tool<{
+        blocks: {
+            blockType: "text" | "section" | "heading" | "image" | "button" | "posts_grid" | "video_embed" | "form" | "testimonial" | "product_grid" | "featured_product" | "cart" | "checkout" | "product_details";
+            content: Record<string, unknown>;
+            order?: number | undefined;
+        }[];
+        contentType?: "product" | "page" | "post" | undefined;
+        entityId?: string | number | undefined;
+        slug?: string | undefined;
+        title?: string | undefined;
+        meta?: {
+            meta_description?: string | null | undefined;
+            meta_title?: string | null | undefined;
+            slug?: string | undefined;
+            status?: "draft" | "published" | "archived" | undefined;
+            title?: string | undefined;
+        } | undefined;
+    }, {
+        confirmationPhrase: string;
+        mutationExecuted: boolean;
+        preview: Record<string, unknown>;
+        requiresConfirmation: boolean;
+        success: boolean;
+    } | {
+        blockCount: number;
+        contentType: "page" | "post";
+        draftPreviewPath: string | null;
+        editPath: string;
+        entityId: number;
+        isDraft: boolean;
+        mutationExecuted: boolean;
+        slug: string;
+        success: boolean;
+        title: string;
+    }>;
+    translate_page: import('ai').Tool<{
+        targetLanguageCode: string;
+        translations: Record<string, string>;
+        title?: string | undefined;
+    }, {
+        confirmationPhrase: string;
+        mutationExecuted: boolean;
+        preview: Record<string, unknown>;
+        requiresConfirmation: boolean;
+        success: boolean;
+    } | {
+        isTranslation: boolean;
+        languageCode: string;
+    }>;
+    set_content_images: import('ai').Tool<{
+        images: string[];
+    }, {
+        confirmationPhrase: string;
+        mutationExecuted: boolean;
+        preview: Record<string, unknown>;
+        requiresConfirmation: boolean;
+        success: boolean;
+    } | {
+        contentType: string;
+        entityId: string | number;
+        imageCount: number;
+        mutationExecuted: boolean;
+        slug: any;
+        success: boolean;
+        extraImagesIgnored?: undefined;
+    } | {
+        contentType: "product" | "page" | "post";
+        entityId: string | number;
+        extraImagesIgnored: number;
+        imageCount: number;
+        mutationExecuted: boolean;
+        slug: any;
+        success: boolean;
+    }>;
     create_cms_page: import('ai').Tool<{
         status: "draft" | "published" | "archived";
         title: string;
@@ -3006,7 +3400,7 @@ export declare function createCortexGlobalAgentTools(context?: ToolExecutionCont
             description: string;
             primaryKey: readonly string[];
             readOnly: boolean;
-            table: "languages" | "pages" | "posts" | "products" | "profiles" | "coupons" | "orders" | "freemius_plans" | "media" | "navigation_items" | "product_variants" | "product_attributes" | "shipping_zones" | "product_attribute_terms" | "blocks" | "cortex_ai_db_mutation_audit" | "coupon_freemius_mappings" | "coupon_products" | "coupon_redemptions" | "currencies" | "freemius_pricing" | "inventory_items" | "logos" | "order_items" | "package_activations" | "page_revisions" | "post_revisions" | "product_media" | "shipping_zone_locations" | "shipping_zone_methods" | "site_settings" | "tax_rates" | "translations" | "user_addresses" | "variant_attribute_mapping";
+            table: "site_settings" | "languages" | "pages" | "posts" | "products" | "profiles" | "coupons" | "orders" | "freemius_plans" | "media" | "navigation_items" | "product_variants" | "product_attributes" | "shipping_zones" | "product_attribute_terms" | "blocks" | "cortex_ai_db_mutation_audit" | "coupon_freemius_mappings" | "coupon_products" | "coupon_redemptions" | "currencies" | "freemius_pricing" | "inventory_items" | "logos" | "order_items" | "package_activations" | "page_revisions" | "post_revisions" | "product_media" | "shipping_zone_locations" | "shipping_zone_methods" | "tax_rates" | "translations" | "user_addresses" | "variant_attribute_mapping";
         }[];
     }>;
     execute_database_action_plan: import('ai').Tool<{
@@ -3070,7 +3464,7 @@ export declare function createCortexGlobalAgentTools(context?: ToolExecutionCont
         sampleTargetIds: string[];
         success: boolean;
         summary: string;
-        table: "languages" | "pages" | "posts" | "products" | "profiles" | "coupons" | "orders" | "freemius_plans" | "media" | "navigation_items" | "product_variants" | "product_attributes" | "shipping_zones" | "product_attribute_terms" | "blocks" | "cortex_ai_db_mutation_audit" | "coupon_freemius_mappings" | "coupon_products" | "coupon_redemptions" | "currencies" | "freemius_pricing" | "inventory_items" | "logos" | "order_items" | "package_activations" | "page_revisions" | "post_revisions" | "product_media" | "shipping_zone_locations" | "shipping_zone_methods" | "site_settings" | "tax_rates" | "translations" | "user_addresses" | "variant_attribute_mapping";
+        table: "site_settings" | "languages" | "pages" | "posts" | "products" | "profiles" | "coupons" | "orders" | "freemius_plans" | "media" | "navigation_items" | "product_variants" | "product_attributes" | "shipping_zones" | "product_attribute_terms" | "blocks" | "cortex_ai_db_mutation_audit" | "coupon_freemius_mappings" | "coupon_products" | "coupon_redemptions" | "currencies" | "freemius_pricing" | "inventory_items" | "logos" | "order_items" | "package_activations" | "page_revisions" | "post_revisions" | "product_media" | "shipping_zone_locations" | "shipping_zone_methods" | "tax_rates" | "translations" | "user_addresses" | "variant_attribute_mapping";
         auditError?: string | undefined;
         affectedCount: number;
         auditLogged: boolean;
@@ -3079,7 +3473,7 @@ export declare function createCortexGlobalAgentTools(context?: ToolExecutionCont
         mutationExecuted: boolean;
         operation: "delete" | "update" | "insert" | "upsert";
         success: boolean;
-        table: "languages" | "pages" | "posts" | "products" | "profiles" | "coupons" | "orders" | "freemius_plans" | "media" | "navigation_items" | "product_variants" | "product_attributes" | "shipping_zones" | "product_attribute_terms" | "blocks" | "cortex_ai_db_mutation_audit" | "coupon_freemius_mappings" | "coupon_products" | "coupon_redemptions" | "currencies" | "freemius_pricing" | "inventory_items" | "logos" | "order_items" | "package_activations" | "page_revisions" | "post_revisions" | "product_media" | "shipping_zone_locations" | "shipping_zone_methods" | "site_settings" | "tax_rates" | "translations" | "user_addresses" | "variant_attribute_mapping";
+        table: "site_settings" | "languages" | "pages" | "posts" | "products" | "profiles" | "coupons" | "orders" | "freemius_plans" | "media" | "navigation_items" | "product_variants" | "product_attributes" | "shipping_zones" | "product_attribute_terms" | "blocks" | "cortex_ai_db_mutation_audit" | "coupon_freemius_mappings" | "coupon_products" | "coupon_redemptions" | "currencies" | "freemius_pricing" | "inventory_items" | "logos" | "order_items" | "package_activations" | "page_revisions" | "post_revisions" | "product_media" | "shipping_zone_locations" | "shipping_zone_methods" | "tax_rates" | "translations" | "user_addresses" | "variant_attribute_mapping";
         auditError?: string | undefined;
         auditLogged: boolean;
     }>;
@@ -3103,7 +3497,7 @@ export declare function createCortexGlobalAgentTools(context?: ToolExecutionCont
         offset: number;
         rows: unknown[];
         success: boolean;
-        table: "languages" | "pages" | "posts" | "products" | "profiles" | "coupons" | "orders" | "freemius_plans" | "media" | "navigation_items" | "product_variants" | "product_attributes" | "shipping_zones" | "product_attribute_terms" | "blocks" | "cortex_ai_db_mutation_audit" | "coupon_freemius_mappings" | "coupon_products" | "coupon_redemptions" | "currencies" | "freemius_pricing" | "inventory_items" | "logos" | "order_items" | "package_activations" | "page_revisions" | "post_revisions" | "product_media" | "shipping_zone_locations" | "shipping_zone_methods" | "site_settings" | "tax_rates" | "translations" | "user_addresses" | "variant_attribute_mapping";
+        table: "site_settings" | "languages" | "pages" | "posts" | "products" | "profiles" | "coupons" | "orders" | "freemius_plans" | "media" | "navigation_items" | "product_variants" | "product_attributes" | "shipping_zones" | "product_attribute_terms" | "blocks" | "cortex_ai_db_mutation_audit" | "coupon_freemius_mappings" | "coupon_products" | "coupon_redemptions" | "currencies" | "freemius_pricing" | "inventory_items" | "logos" | "order_items" | "package_activations" | "page_revisions" | "post_revisions" | "product_media" | "shipping_zone_locations" | "shipping_zone_methods" | "tax_rates" | "translations" | "user_addresses" | "variant_attribute_mapping";
     }>;
 };
 export {};