@ai-stack/payloadcms 3.76.0-beta.1 → 3.76.0-beta.3

package/dist/translations/translation-schema.json

@@ -1,16 +1,189 @@
 {
-  "type": "object",
-  "$schema": "http://json-schema.org/draft-04/schema#",
-  "additionalProperties": false,
-  "properties": {
-    "$schema": {
-      "type": "string"
+    "type": "object",
+    "$schema": "http://json-schema.org/draft-04/schema#",
+    "additionalProperties": false,
+    "properties": {
+        "$schema": {
+            "type": "string"
+        },
+        "ai-plugin": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+                "configDashboard": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                        "loadingConfiguration": {
+                            "type": "string"
+                        },
+                        "configureTitle": {
+                            "type": "string"
+                        },
+                        "configureSubtitle": {
+                            "type": "string"
+                        },
+                        "providers": {
+                            "type": "string"
+                        },
+                        "saveChanges": {
+                            "type": "string"
+                        },
+                        "saving": {
+                            "type": "string"
+                        },
+                        "selectCollectionsBody": {
+                            "type": "string"
+                        },
+                        "settingsSaved": {
+                            "type": "string"
+                        },
+                        "failedToSave": {
+                            "type": "string"
+                        },
+                        "errorSaving": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "actions": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                        "proofread": {
+                            "type": "string"
+                        },
+                        "rephrase": {
+                            "type": "string"
+                        },
+                        "translate": {
+                            "type": "string"
+                        },
+                        "expand": {
+                            "type": "string"
+                        },
+                        "summarize": {
+                            "type": "string"
+                        },
+                        "simplify": {
+                            "type": "string"
+                        },
+                        "compose": {
+                            "type": "string"
+                        },
+                        "settings": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "actionLoading": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                        "proofreading": {
+                            "type": "string"
+                        },
+                        "rephrasing": {
+                            "type": "string"
+                        },
+                        "translating": {
+                            "type": "string"
+                        },
+                        "expanding": {
+                            "type": "string"
+                        },
+                        "summarizing": {
+                            "type": "string"
+                        },
+                        "simplifying": {
+                            "type": "string"
+                        },
+                        "composing": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "general": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                        "search": {
+                            "type": "string"
+                        },
+                        "queued": {
+                            "type": "string"
+                        },
+                        "video": {
+                            "type": "string"
+                        },
+                        "loading": {
+                            "type": "string"
+                        },
+                        "clickToStop": {
+                            "type": "string"
+                        }
+                    }
+                }
+            }
+        },
+        "localization": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+                "selectedLocales": {
+                    "type": "string"
+                },
+                "selectLocaleToDuplicate": {
+                    "type": "string"
+                }
+            }
+        }
     },
+    "required": [
+        "ai-plugin"
+    ],
     "ai-plugin": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {}
+        "configDashboard": {
+            "loadingConfiguration": "Loading configuration...",
+            "configureTitle": "Let's configure your AI Plugin",
+            "configureSubtitle": "Set up the provider \u2192 Choose the content \u2192 Refine the behavior.",
+            "providers": "Providers",
+            "saveChanges": "Save Changes",
+            "saving": "Saving...",
+            "selectCollectionsBody": "Select the collections where AI features should be available, toggle them on or off, and save your changes.",
+            "settingsSaved": "Settings saved successfully",
+            "failedToSave": "Failed to save settings",
+            "errorSaving": "Error saving settings"
+        },
+        "actions": {
+            "proofread": "Proofread",
+            "rephrase": "Rephrase",
+            "translate": "Translate",
+            "expand": "Expand",
+            "summarize": "Summarize",
+            "simplify": "Simplify",
+            "compose": "Compose",
+            "settings": "Settings"
+        },
+        "actionLoading": {
+            "proofreading": "Proofreading",
+            "rephrasing": "Rephrasing",
+            "translating": "Translating",
+            "expanding": "Expanding",
+            "summarizing": "Summarizing",
+            "simplifying": "Simplifying",
+            "composing": "Composing"
+        },
+        "general": {
+            "search": "Search...",
+            "queued": "Queued",
+            "video": "Video",
+            "loading": "Loading...",
+            "clickToStop": "Click to stop"
+        }
+    },
+    "localization": {
+        "selectedLocales": "Selected locales",
+        "selectLocaleToDuplicate": "Select locale to duplicate"
     }
-  },
-  "required": ["ai-plugin"]
 }

package/dist/translations/uk.json

@@ -1,4 +1,47 @@
 {
-  "$schema": "./translation-schema.json",
-  "ai-plugin": {}
+    "$schema": "./translation-schema.json",
+    "ai-plugin": {
+        "configDashboard": {
+            "loadingConfiguration": "Завантаження конфігурації...",
+            "configureTitle": "Налаштуймо ваш AI-плагін",
+            "configureSubtitle": "Налаштуйте провайдера → Виберіть контент → Уточніть поведінку.",
+            "providers": "Провайдери",
+            "saveChanges": "Зберегти зміни",
+            "saving": "Збереження...",
+            "selectCollectionsBody": "Виберіть колекції, де мають бути доступні функції AI, увімкніть або вимкніть їх і збережіть зміни.",
+            "settingsSaved": "Налаштування успішно збережено",
+            "failedToSave": "Не вдалося зберегти налаштування",
+            "errorSaving": "Помилка під час збереження налаштувань"
+        },
+        "actions": {
+            "proofread": "Вичитка",
+            "rephrase": "Перефразувати",
+            "translate": "Перекласти",
+            "expand": "Розширити",
+            "summarize": "Підсумувати",
+            "simplify": "Спрощувати",
+            "compose": "Скласти",
+            "settings": "Налаштування"
+        },
+        "actionLoading": {
+            "proofreading": "Вичитка",
+            "rephrasing": "Перефразування",
+            "translating": "Переклад",
+            "expanding": "Розширення",
+            "summarizing": "Підсумування",
+            "simplifying": "Спрощення",
+            "composing": "Складання"
+        },
+        "general": {
+            "search": "Пошук...",
+            "queued": "У черзі",
+            "video": "Відео",
+            "loading": "Завантаження...",
+            "clickToStop": "Натисніть, щоб зупинити"
+        }
+    },
+    "localization": {
+        "selectedLocales": "Selected locales",
+        "selectLocaleToDuplicate": "Select locale to duplicate"
+    }
 }

package/dist/translations/zh.json

@@ -0,0 +1,47 @@
+{
+    "$schema": "./translation-schema.json",
+    "ai-plugin": {
+        "configDashboard": {
+            "loadingConfiguration": "正在加载配置...",
+            "configureTitle": "让我们配置你的 AI 插件",
+            "configureSubtitle": "设置提供商 → 选择内容 → 优化行为。",
+            "providers": "提供商",
+            "saveChanges": "保存更改",
+            "saving": "正在保存...",
+            "selectCollectionsBody": "选择需要启用 AI 功能的集合，开启或关闭它们并保存更改。",
+            "settingsSaved": "设置已成功保存",
+            "failedToSave": "保存设置失败",
+            "errorSaving": "保存设置时出错"
+        },
+        "actions": {
+            "proofread": "校对",
+            "rephrase": "改写",
+            "translate": "翻译",
+            "expand": "扩展",
+            "summarize": "总结",
+            "simplify": "简化",
+            "compose": "撰写",
+            "settings": "设置"
+        },
+        "actionLoading": {
+            "proofreading": "正在校对",
+            "rephrasing": "正在改写",
+            "translating": "正在翻译",
+            "expanding": "正在扩展",
+            "summarizing": "正在总结",
+            "simplifying": "正在简化",
+            "composing": "正在撰写"
+        },
+        "general": {
+            "search": "搜索...",
+            "queued": "排队中",
+            "video": "视频",
+            "loading": "正在加载...",
+            "clickToStop": "点击停止"
+        }
+    },
+    "localization": {
+        "selectedLocales": "Selected locales",
+        "selectLocaleToDuplicate": "Select locale to duplicate"
+    }
+}

package/dist/types.d.ts

@@ -1,8 +1,7 @@
 import type { GenerateObjectResult, ModelMessage } from 'ai';
 import type { JSONSchema } from 'openai/lib/jsonschema';
 import type { ImageGenerateParams } from 'openai/resources/images';
-import type { CollectionConfig, CollectionSlug, DataFromCollectionSlug, Endpoint, Field, File, GlobalConfig, GroupField, PayloadRequest, TypedCollection } from 'payload';
-import type { CSSProperties, MouseEventHandler } from 'react';
+import type { CollectionSlug, DataFromCollectionSlug, Endpoint, Field, File, GlobalConfig, GroupField, PayloadRequest, TypedCollection } from 'payload';
 import type { MediaResult } from './ai/core/index.js';
 import type { PLUGIN_INSTRUCTIONS_TABLE } from './defaults.js';
 export interface PluginConfigAccess {
@@ -46,6 +45,29 @@ export interface PluginConfig {
         nodes: JSONSchema[];
     };
     fields?: Field[];
+    /**
+     * Defines default provider and models to be selected
+     * when creating initial database records for Generation Defaults.
+     */
+    generationDefaults?: {
+        image?: {
+            model: string;
+            provider: string;
+        };
+        text?: {
+            model: string;
+            provider: string;
+        };
+        tts?: {
+            model: string;
+            provider: string;
+            voice?: string;
+        };
+        video?: {
+            model: string;
+            provider: string;
+        };
+    };
     generationModels?: ((defaultModels: GenerationModel[]) => GenerationModel[]) | GenerationModel[];
     globals?: {
         [key: GlobalConfig['slug']]: boolean;
@@ -53,14 +75,21 @@ export interface PluginConfig {
     interfaceName?: string;
     mediaUpload?: PluginConfigMediaUploadFunction;
     options?: PluginOptions;
-    overrideInstructions?: Partial<CollectionConfig>;
-    promptFields?: PromptField[];
+    overrideInstructions?: any;
+    promptFields?: any[];
+    prompts?: ActionPrompt[];
     /**
-     * Custom action prompts for AI text generation
-     * If not provided, uses default prompts
-     * You can access default prompts by importing { defaultPrompts } from '@ai-stack/payloadcms'
+     * Pre-configured options that get passed directly to AI SDK providers.
+     * This allows devs to define AI options safely via payload.config.ts.
      */
-    prompts?: ActionPrompt[];
+    providerOptions?: {
+        [key: string]: Record<string, any> | undefined;
+        anthropic?: Record<string, any>;
+        elevenlabs?: Record<string, any>;
+        fal?: Record<string, any>;
+        google?: Record<string, any>;
+        openai?: Record<string, any>;
+    };
     /**
      * Custom seed prompt function for generating field-specific prompts
      * If not provided, fields will have empty prompts by default
@@ -91,6 +120,7 @@ export type GenerateTextarea<T = any> = (args: {
 }) => Promise<string> | string;
 export interface Endpoints {
     fetchVoices?: Omit<Endpoint, 'root'>;
+    promptMentions: Endpoint;
     textarea: Omit<Endpoint, 'root'>;
     upload: Omit<Endpoint, 'root'>;
     videogenWebhook?: Omit<Endpoint, 'root'>;
@@ -122,26 +152,6 @@ export type SeedPromptResult = {
     system: string;
 } | false | undefined | void;
 export type SeedPromptFunction = (options: SeedPromptOptions) => Promise<SeedPromptResult> | SeedPromptResult;
-export type ActionMenuEvents = 'onCompose' | 'onExpand' | 'onProofread' | 'onRephrase' | 'onSettings' | 'onSimplify' | 'onSummarize' | 'onTone' | 'onTranslate';
-export type UseMenuEvents = {
-    [key in ActionMenuEvents]?: (data?: unknown) => void;
-};
-export type UseMenuOptions = {
-    isConfigAllowed: boolean;
-};
-export type BaseItemProps<T = any> = {
-    children?: React.ReactNode;
-    className?: string;
-    disabled?: boolean;
-    hideIcon?: boolean;
-    isActive?: boolean;
-    isMenu?: boolean;
-    onClick: (data?: unknown) => void;
-    onMouseEnter?: MouseEventHandler<T> | undefined;
-    onMouseLeave?: MouseEventHandler<T> | undefined;
-    style?: CSSProperties | undefined;
-    title?: string;
-};
 export type ImageReference = {
     data: Blob;
     name: string;
@@ -196,5 +206,31 @@ export type AfterGenerateHook<T = any> = (args: AfterGenerateArgs<T>) => Promise
 export interface AIFieldConfig {
     [key: string]: unknown;
     afterGenerate?: AfterGenerateHook[];
+    /**
+     * When true, the Compose button is always visible on this field,
+     * bypassing the focus-based show/hide system.
+     * Admin `disabled` in Instructions still takes priority.
+     */
+    alwaysShow?: boolean;
+    /**
+     * When true and the field hasMany, generated values are appended
+     * instead of replacing current field value(s).
+     */
+    appendGenerated?: boolean;
     beforeGenerate?: BeforeGenerateHook[];
+    /**
+     * Default hidden state for Compose in instructions.
+     * When true, Compose is hidden for this field.
+     */
+    disabled?: boolean;
+    /**
+     * Set to false to opt-out of compose button injection for this field.
+     * When false, no compose button is injected at build time.
+     * @default true (compose is auto-injected on supported field types)
+     */
+    enabled?: boolean;
+    /** Custom prompt template for this field */
+    prompt?: string;
+    /** Custom system prompt for this field */
+    system?: string;
 }

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type { GenerateObjectResult, ModelMessage } from 'ai'\nimport type { JSONSchema } from 'openai/lib/jsonschema'\nimport type { ImageGenerateParams } from 'openai/resources/images'\nimport type {\n  CollectionConfig,\n  CollectionSlug,\n  DataFromCollectionSlug,\n  Endpoint,\n  Field,\n  File,\n  GlobalConfig,\n  GroupField,\n  PayloadRequest,\n  TypedCollection,\n} from 'payload'\nimport type { CSSProperties, MouseEventHandler } from 'react'\n\nimport type { MediaResult } from './ai/core/index.js'\nimport type { PLUGIN_INSTRUCTIONS_TABLE } from './defaults.js'\n\nexport interface PluginConfigAccess {\n  /**\n   * Control access to AI generation features (generate text, images, audio)\n   * @default () => !!req.user (requires authentication)\n   */\n  generate?: ({ req }: { req: PayloadRequest }) => boolean | Promise<boolean>\n  /**\n   * Control access to AI settings/configuration\n   * @default () => !!req.user (requires authentication)\n   */\n  settings?: ({ req }: { req: PayloadRequest }) => boolean | Promise<boolean>\n}\n\nexport interface PluginOptions {\n  /**\n   * Provide local tags to filter language options from the Translate Menu\n   * Check for the available local tags,\n   * visit: https://www.npmjs.com/package/locale-codes\n   * Example: [\"en-US\", \"zh-SG\", \"zh-CN\", \"en\"]\n   */\n  enabledLanguages?: string[]\n}\n\nexport type PluginConfigMediaUploadFunction = (\n  result: MediaResult,\n  {\n    collection,\n    request,\n  }: {\n    collection: CollectionSlug\n    request: PayloadRequest\n  },\n) => Promise<DataFromCollectionSlug<CollectionSlug>>\n\nexport interface PluginConfig {\n  /**\n   * Access control configuration for AI features\n   * By default, all AI features require authentication\n   */\n  access?: PluginConfigAccess\n  debugging?: boolean\n  disableSponsorMessage?: boolean\n  editorConfig?: { nodes: JSONSchema[] }\n  fields?: Field[]\n  generationModels?: ((defaultModels: GenerationModel[]) => GenerationModel[]) | GenerationModel[]\n  globals?: {\n    [key: GlobalConfig['slug']]: boolean\n  }\n  interfaceName?: string\n  mediaUpload?: PluginConfigMediaUploadFunction\n  options?: PluginOptions\n  // Override the instructions collection config\n  overrideInstructions?: Partial<CollectionConfig>\n  promptFields?: PromptField[]\n  /**\n   * Custom action prompts for AI text generation\n   * If not provided, uses default prompts\n   * You can access default prompts by importing { defaultPrompts } from '@ai-stack/payloadcms'\n   */\n  prompts?: ActionPrompt[]\n  /**\n   * Custom seed prompt function for generating field-specific prompts\n   * If not provided, fields will have empty prompts by default\n   */\n  seedPrompts?: SeedPromptFunction\n  uploadCollectionSlug?: CollectionSlug\n}\n\nexport interface GenerationModel {\n  fields: string[]\n  generateText?: (prompt: string, system: string) => Promise<string>\n  handler?: (prompt: string, options: any) => File | Promise<any> | Response\n  id: string\n  name: string\n  output: 'audio' | 'file' | 'image' | 'json' | 'text' | 'video'\n  settings?: GroupField\n  supportsPromptOptimization?: boolean\n}\n\nexport interface GenerationConfig {\n  models: GenerationModel[]\n  provider: string\n}\n\nexport type GenerateTextarea<T = any> = (args: {\n  collectionSlug: CollectionSlug\n  doc: T\n  documentId?: number | string\n  locale?: string\n  options?: any\n}) => Promise<string> | string\n\nexport interface Endpoints {\n  fetchVoices?: Omit<Endpoint, 'root'>\n  textarea: Omit<Endpoint, 'root'>\n  upload: Omit<Endpoint, 'root'>\n  videogenWebhook?: Omit<Endpoint, 'root'>\n}\n\nexport type ActionMenuItems =\n  | 'Compose'\n  | 'Expand'\n  | 'Proofread'\n  | 'Rephrase'\n  | 'Settings'\n  | 'Simplify'\n  | 'Summarize'\n  | 'Tone'\n  | 'Translate'\n\nexport type ActionPromptOptions = {\n  layout?: string\n  locale?: string\n  prompt?: string\n  systemPrompt?: string\n}\n\nexport type ActionPrompt = {\n  layout?: (options?: ActionPromptOptions) => string\n  name: ActionMenuItems\n  system: (options: ActionPromptOptions) => string\n}\n\nexport type SeedPromptOptions = {\n  fieldLabel: string\n  fieldSchemaPaths: Record<string, any>\n  fieldType: string\n  path: string\n}\n\nexport type SeedPromptData = Omit<\n  TypedCollection[typeof PLUGIN_INSTRUCTIONS_TABLE],\n  'createdAt' | 'id' | 'updatedAt'\n>\n\nexport type SeedPromptResult =\n  | {\n      data?: SeedPromptData\n    }\n  | {\n      data?: SeedPromptData\n      prompt: string\n      system: string\n    }\n  | false\n  | undefined\n  | void\n\nexport type SeedPromptFunction = (\n  options: SeedPromptOptions,\n) => Promise<SeedPromptResult> | SeedPromptResult\n\nexport type ActionMenuEvents =\n  | 'onCompose'\n  | 'onExpand'\n  | 'onProofread'\n  | 'onRephrase'\n  | 'onSettings'\n  | 'onSimplify'\n  | 'onSummarize'\n  | 'onTone'\n  | 'onTranslate'\n\nexport type UseMenuEvents = {\n  [key in ActionMenuEvents]?: (data?: unknown) => void\n}\n\nexport type UseMenuOptions = {\n  isConfigAllowed: boolean\n}\n\nexport type BaseItemProps<T = any> = {\n  children?: React.ReactNode\n  className?: string\n  disabled?: boolean\n  hideIcon?: boolean\n  isActive?: boolean\n  isMenu?: boolean\n  onClick: (data?: unknown) => void\n  onMouseEnter?: MouseEventHandler<T> | undefined\n  onMouseLeave?: MouseEventHandler<T> | undefined\n  style?: CSSProperties | undefined\n  title?: string\n}\n\nexport type ImageReference = {\n  data: Blob\n  name: string\n  size: number\n  type: string\n  url: string\n}\n\nexport type GenerateImageParams = {\n  images?: ImageReference[]\n  size?: ImageGenerateParams['size']\n  style?: ImageGenerateParams['style']\n  version?: ImageGenerateParams['model']\n}\n\nexport type SerializedPromptField = {\n  collections?: CollectionSlug[]\n  name: string\n}\n\nexport type PromptFieldGetterContext = {\n  collection: CollectionSlug\n  type: string\n}\n\nexport type PromptField = {\n  // If not provided, the value will be returned from the data object as-is\n  getter?: (data: object, ctx: PromptFieldGetterContext) => Promise<string> | string\n} & SerializedPromptField\n\nexport interface BeforeGenerateArgs<T = any> {\n  doc: T\n  field: Field\n  headers: Record<string, string>\n  instructions: Record<string, unknown> // The instruction document\n  messages?: ModelMessage[]\n  payload: PayloadRequest['payload']\n  prompt: string\n  req: PayloadRequest\n  system: string\n}\n\nexport type BeforeGenerateResult = {\n  messages?: ModelMessage[]\n  prompt?: string\n  system?: string\n} | void\n\nexport type BeforeGenerateHook<T = any> = (\n  args: BeforeGenerateArgs<T>,\n) => BeforeGenerateResult | Promise<BeforeGenerateResult>\n\nexport interface AfterGenerateArgs<T = any> {\n  doc: T\n  field: Field\n  headers: Record<string, string>\n  instructions: Record<string, unknown>\n  payload: PayloadRequest['payload']\n  req: PayloadRequest\n  result: GenerateObjectResult<any> | MediaResult | string // depends on context\n}\n\nexport type AfterGenerateHook<T = any> = (args: AfterGenerateArgs<T>) => Promise<void> | void\n\n// Add to PluginConfig or a new interface if accessed via custom.ai\nexport interface AIFieldConfig {\n  [key: string]: unknown\n  afterGenerate?: AfterGenerateHook[]\n  beforeGenerate?: BeforeGenerateHook[]\n}\n"],"names":[],"mappings":"AA6QA,mEAAmE;AACnE,WAIC"}
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type { GenerateObjectResult, ModelMessage } from 'ai'\nimport type { JSONSchema } from 'openai/lib/jsonschema'\nimport type { ImageGenerateParams } from 'openai/resources/images'\nimport type {\n  CollectionConfig,\n  CollectionSlug,\n  DataFromCollectionSlug,\n  Endpoint,\n  Field,\n  File,\n  GlobalConfig,\n  GroupField,\n  PayloadRequest,\n  TypedCollection,\n} from 'payload'\n\nimport type { MediaResult } from './ai/core/index.js'\nimport type { PLUGIN_INSTRUCTIONS_TABLE } from './defaults.js'\n\nexport interface PluginConfigAccess {\n  /**\n   * Control access to AI generation features (generate text, images, audio)\n   * @default () => !!req.user (requires authentication)\n   */\n  generate?: ({ req }: { req: PayloadRequest }) => boolean | Promise<boolean>\n  /**\n   * Control access to AI settings/configuration\n   * @default () => !!req.user (requires authentication)\n   */\n  settings?: ({ req }: { req: PayloadRequest }) => boolean | Promise<boolean>\n}\n\nexport interface PluginOptions {\n  /**\n   * Provide local tags to filter language options from the Translate Menu\n   * Check for the available local tags,\n   * visit: https://www.npmjs.com/package/locale-codes\n   * Example: [\"en-US\", \"zh-SG\", \"zh-CN\", \"en\"]\n   */\n  enabledLanguages?: string[]\n}\n\nexport type PluginConfigMediaUploadFunction = (\n  result: MediaResult,\n  {\n    collection,\n    request,\n  }: {\n    collection: CollectionSlug\n    request: PayloadRequest\n  },\n) => Promise<DataFromCollectionSlug<CollectionSlug>>\n\nexport interface PluginConfig {\n  /**\n   * Access control configuration for AI features\n   * By default, all AI features require authentication\n   */\n  access?: PluginConfigAccess\n  debugging?: boolean\n  disableSponsorMessage?: boolean\n  editorConfig?: { nodes: JSONSchema[] }\n  fields?: Field[]\n  /**\n   * Defines default provider and models to be selected\n   * when creating initial database records for Generation Defaults.\n   */\n  generationDefaults?: {\n    image?: { model: string; provider: string }\n    text?: { model: string; provider: string }\n    tts?: { model: string; provider: string; voice?: string }\n    video?: { model: string; provider: string }\n  }\n  generationModels?: ((defaultModels: GenerationModel[]) => GenerationModel[]) | GenerationModel[]\n  globals?: {\n    [key: GlobalConfig['slug']]: boolean\n  }\n  interfaceName?: string\n  mediaUpload?: PluginConfigMediaUploadFunction\n  options?: PluginOptions\n  overrideInstructions?: any\n  promptFields?: any[]\n  prompts?: ActionPrompt[]\n  /**\n   * Pre-configured options that get passed directly to AI SDK providers.\n   * This allows devs to define AI options safely via payload.config.ts.\n   */\n  providerOptions?: {\n    [key: string]: Record<string, any> | undefined // generic fallback\n    anthropic?: Record<string, any>\n    elevenlabs?: Record<string, any>\n    fal?: Record<string, any>\n    google?: Record<string, any>\n    openai?: Record<string, any>\n  }\n  /**\n   * Custom seed prompt function for generating field-specific prompts\n   * If not provided, fields will have empty prompts by default\n   */\n  seedPrompts?: SeedPromptFunction\n  uploadCollectionSlug?: CollectionSlug\n}\n\nexport interface GenerationModel {\n  fields: string[]\n  generateText?: (prompt: string, system: string) => Promise<string>\n  handler?: (prompt: string, options: any) => File | Promise<any> | Response\n  id: string\n  name: string\n  output: 'audio' | 'file' | 'image' | 'json' | 'text' | 'video'\n  settings?: GroupField\n  supportsPromptOptimization?: boolean\n}\n\nexport interface GenerationConfig {\n  models: GenerationModel[]\n  provider: string\n}\n\nexport type GenerateTextarea<T = any> = (args: {\n  collectionSlug: CollectionSlug\n  doc: T\n  documentId?: number | string\n  locale?: string\n  options?: any\n}) => Promise<string> | string\n\nexport interface Endpoints {\n  fetchVoices?: Omit<Endpoint, 'root'>\n  promptMentions: Endpoint\n  textarea: Omit<Endpoint, 'root'>\n  upload: Omit<Endpoint, 'root'>\n  videogenWebhook?: Omit<Endpoint, 'root'>\n}\n\nexport type ActionMenuItems =\n  | 'Compose'\n  | 'Expand'\n  | 'Proofread'\n  | 'Rephrase'\n  | 'Settings'\n  | 'Simplify'\n  | 'Summarize'\n  | 'Tone'\n  | 'Translate'\n\nexport type ActionPromptOptions = {\n  layout?: string\n  locale?: string\n  prompt?: string\n  systemPrompt?: string\n}\n\nexport type ActionPrompt = {\n  layout?: (options?: ActionPromptOptions) => string\n  name: ActionMenuItems\n  system: (options: ActionPromptOptions) => string\n}\n\nexport type SeedPromptOptions = {\n  fieldLabel: string\n  fieldSchemaPaths: Record<string, any>\n  fieldType: string\n  path: string\n}\n\nexport type SeedPromptData = Omit<\n  TypedCollection[typeof PLUGIN_INSTRUCTIONS_TABLE],\n  'createdAt' | 'id' | 'updatedAt'\n>\n\nexport type SeedPromptResult =\n  | {\n      data?: SeedPromptData\n    }\n  | {\n      data?: SeedPromptData\n      prompt: string\n      system: string\n    }\n  | false\n  | undefined\n  | void\n\nexport type SeedPromptFunction = (\n  options: SeedPromptOptions,\n) => Promise<SeedPromptResult> | SeedPromptResult\n\nexport type ImageReference = {\n  data: Blob\n  name: string\n  size: number\n  type: string\n  url: string\n}\n\nexport type GenerateImageParams = {\n  images?: ImageReference[]\n  size?: ImageGenerateParams['size']\n  style?: ImageGenerateParams['style']\n  version?: ImageGenerateParams['model']\n}\n\nexport type SerializedPromptField = {\n  collections?: CollectionSlug[]\n  name: string\n}\n\nexport type PromptFieldGetterContext = {\n  collection: CollectionSlug\n  type: string\n}\n\nexport type PromptField = {\n  // If not provided, the value will be returned from the data object as-is\n  getter?: (data: object, ctx: PromptFieldGetterContext) => Promise<string> | string\n} & SerializedPromptField\n\nexport interface BeforeGenerateArgs<T = any> {\n  doc: T\n  field: Field\n  headers: Record<string, string>\n  instructions: Record<string, unknown> // The instruction document\n  messages?: ModelMessage[]\n  payload: PayloadRequest['payload']\n  prompt: string\n  req: PayloadRequest\n  system: string\n}\n\nexport type BeforeGenerateResult = {\n  messages?: ModelMessage[]\n  prompt?: string\n  system?: string\n} | void\n\nexport type BeforeGenerateHook<T = any> = (\n  args: BeforeGenerateArgs<T>,\n) => BeforeGenerateResult | Promise<BeforeGenerateResult>\n\nexport interface AfterGenerateArgs<T = any> {\n  doc: T\n  field: Field\n  headers: Record<string, string>\n  instructions: Record<string, unknown>\n  payload: PayloadRequest['payload']\n  req: PayloadRequest\n  result: GenerateObjectResult<any> | MediaResult | string // depends on context\n}\n\nexport type AfterGenerateHook<T = any> = (args: AfterGenerateArgs<T>) => Promise<void> | void\n\n// Add to PluginConfig or a new interface if accessed via custom.ai\nexport interface AIFieldConfig {\n  [key: string]: unknown\n  afterGenerate?: AfterGenerateHook[]\n  /**\n   * When true, the Compose button is always visible on this field,\n   * bypassing the focus-based show/hide system.\n   * Admin `disabled` in Instructions still takes priority.\n   */\n  alwaysShow?: boolean\n  /**\n   * When true and the field hasMany, generated values are appended\n   * instead of replacing current field value(s).\n   */\n  appendGenerated?: boolean\n  beforeGenerate?: BeforeGenerateHook[]\n  /**\n   * Default hidden state for Compose in instructions.\n   * When true, Compose is hidden for this field.\n   */\n  disabled?: boolean\n  /**\n   * Set to false to opt-out of compose button injection for this field.\n   * When false, no compose button is injected at build time.\n   * @default true (compose is auto-injected on supported field types)\n   */\n  enabled?: boolean\n  /** Custom prompt template for this field */\n  prompt?: string\n  /** Custom system prompt for this field */\n  system?: string\n}\n"],"names":[],"mappings":"AA4PA,mEAAmE;AACnE,WA8BC"}

package/dist/ui/Compose/Compose.js

@@ -1,12 +1,12 @@
 'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEditorConfigContext } from '@payloadcms/richtext-lexical/client';
-import { Popup, useField } from '@payloadcms/ui';
+import { Popup, useField, useTranslation } from '@payloadcms/ui';
 import React, { useCallback, useMemo, useState } from 'react';
 import { useInstructions } from '../../providers/InstructionsProvider/useInstructions.js';
-import { setSafeLexicalState } from '../../utilities/setSafeLexicalState.js';
+import { setSafeLexicalState } from '../../utilities/lexical/setSafeLexicalState.js';
 import { PluginIcon } from '../Icons/Icons.js';
-import styles from './compose.module.css';
+import styles from './compose.module.scss';
 import { useMenu } from './hooks/menu/useMenu.js';
 import { useActiveFieldTracking } from './hooks/useActiveFieldTracking.js';
 import { useGenerate } from './hooks/useGenerate.js';
@@ -18,96 +18,51 @@ export const Compose = ({ descriptionProps, forceVisible, instructionId, isConfi
     const { openDrawer } = useInstructions();
     // Initialize global active-field tracking
     useActiveFieldTracking();
+    const { t } = useTranslation();
     const [isProcessing, setIsProcessing] = useState(false);
     const { generate, isJobActive, isLoading, jobProgress, jobStatus, stop } = useGenerate({
         instructionId
     });
-    // Memoize menu event handlers to prevent recreation on every render
-    const onCompose = useCallback(()=>{
-        console.log('Composing...');
+    // Single factory for all action callbacks, eliminating duplication
+    const createAction = useCallback((action, params)=>{
         setIsProcessing(true);
         generate({
-            action: 'Compose'
+            action,
+            params
         }).catch((reason)=>{
-            console.error('Compose : ', reason);
+            console.error(`AI Plugin — ${action}:`, reason);
         }).finally(()=>{
             setIsProcessing(false);
         });
     }, [
         generate
     ]);
-    const onExpand = useCallback(()=>{
-        console.log('Expanding...');
-        generate({
-            action: 'Expand'
-        }).catch((reason)=>{
-            console.error('Compose : ', reason);
-        }).finally(()=>{
-            setIsProcessing(false);
-        });
-    }, [
-        generate
+    const onCompose = useCallback(()=>createAction('Compose'), [
+        createAction
     ]);
-    const onProofread = useCallback(()=>{
-        console.log('Proofreading...');
-        generate({
-            action: 'Proofread'
-        }).catch((reason)=>{
-            console.error('Compose : ', reason);
-        }).finally(()=>{
-            setIsProcessing(false);
-        });
-    }, [
-        generate
+    const onExpand = useCallback(()=>createAction('Expand'), [
+        createAction
     ]);
-    const onRephrase = useCallback(()=>{
-        console.log('Rephrasing...');
-        generate({
-            action: 'Rephrase'
-        }).catch((reason)=>{
-            console.error('Compose : ', reason);
-        }).finally(()=>{
-            setIsProcessing(false);
-        });
-    }, [
-        generate
+    const onProofread = useCallback(()=>createAction('Proofread'), [
+        createAction
     ]);
-    const onSimplify = useCallback(()=>{
-        console.log('Simplifying...');
-        generate({
-            action: 'Simplify'
-        }).catch((reason)=>{
-            console.error('Compose : ', reason);
-        }).finally(()=>{
-            setIsProcessing(false);
-        });
-    }, [
-        generate
+    const onRephrase = useCallback(()=>createAction('Rephrase'), [
+        createAction
     ]);
-    const onSummarize = useCallback(()=>{
-        console.log('Summarizing...');
-        generate({
-            action: 'Summarize'
-        }).catch((reason)=>{
-            console.error('Compose : ', reason);
-        }).finally(()=>{
-            setIsProcessing(false);
-        });
-    }, [
-        generate
+    const onSimplify = useCallback(()=>createAction('Simplify'), [
+        createAction
+    ]);
+    const onSummarize = useCallback(()=>createAction('Summarize'), [
+        createAction
     ]);
     const onTranslate = useCallback((data)=>{
-        console.log('Translating...');
-        generate({
-            action: 'Translate',
-            params: data
-        }).catch((reason)=>{
-            console.error('Compose : ', reason);
-        }).finally(()=>{
-            setIsProcessing(false);
-        });
+        // If the action is triggered directly via the button click,
+        // it passes a React SyntheticEvent which cannot (and should not) be stringified.
+        // We only want to pass data if it's the actual payload containing { locale }.
+        const isEvent = data && typeof data === 'object' && 'nativeEvent' in data;
+        return createAction('Translate', isEvent ? undefined : data);
     }, [
-        generate
+        createAction
     ]);
     const handleOpenSettings = useCallback(()=>{
         if (isConfigAllowed) {
@@ -190,14 +145,22 @@ export const Compose = ({ descriptionProps, forceVisible, instructionId, isConfi
             memoizedPopup,
             /*#__PURE__*/ _jsx(ActiveComponent, {
                 isLoading: isProcessing || isLoading || isJobActive,
-                loadingLabel: isJobActive ? jobStatus === 'running' ? `Video ${Math.max(0, Math.min(100, Math.round(jobProgress ?? 0)))}%` : jobStatus || 'Queued' : undefined,
+                loadingLabel: isJobActive ? jobStatus === 'running' ? `${t('ai-plugin:general:video')} ${Math.max(0, Math.min(100, Math.round(jobProgress ?? 0)))}%` : jobStatus || t('ai-plugin:general:queued') : undefined,
                 stop: stop
             }),
-            /*#__PURE__*/ _jsx(UndoRedoActions, {
-                onChange: (val)=>{
-                    setValue(val);
-                    setIfValueIsLexicalState(val);
-                }
+            /*#__PURE__*/ _jsx("div", {
+                style: {
+                    alignItems: 'center',
+                    display: 'flex',
+                    gap: '10px',
+                    marginLeft: 'auto'
+                },
+                children: /*#__PURE__*/ _jsx(UndoRedoActions, {
+                    onChange: (val)=>{
+                        setValue(val);
+                        setIfValueIsLexicalState(val);
+                    }
+                })
             })
         ]
     });