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

package/dist/ai/providers/blocks/xai.js

@@ -29,59 +29,6 @@ export const xaiBlock = {
                     ],
                     label: 'Setup'
                 },
-                // 2. Provider Options tab
-                {
-                    fields: [
-                        {
-                            name: 'textProviderOptions',
-                            type: 'group',
-                            admin: {
-                                description: 'Default provider options for text generation models.'
-                            },
-                            fields: [
-                                {
-                                    name: 'temperature',
-                                    type: 'number',
-                                    defaultValue: 1.0,
-                                    label: 'Default Temperature',
-                                    max: 2.0,
-                                    min: 0.0
-                                },
-                                {
-                                    name: 'max_tokens',
-                                    type: 'number',
-                                    label: 'Max Tokens'
-                                },
-                                {
-                                    name: 'top_p',
-                                    type: 'number',
-                                    defaultValue: 1.0,
-                                    label: 'Top P',
-                                    max: 1.0,
-                                    min: 0.0
-                                },
-                                {
-                                    name: 'frequency_penalty',
-                                    type: 'number',
-                                    defaultValue: 0,
-                                    label: 'Frequency Penalty',
-                                    max: 2,
-                                    min: -2
-                                },
-                                {
-                                    name: 'presence_penalty',
-                                    type: 'number',
-                                    defaultValue: 0,
-                                    label: 'Presence Penalty',
-                                    max: 2,
-                                    min: -2
-                                }
-                            ],
-                            label: 'Text Provider Options'
-                        }
-                    ],
-                    label: 'Provider Options'
-                },
                 // 3. Models tab
                 {
                     fields: [

package/dist/ai/providers/blocks/xai.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/ai/providers/blocks/xai.ts"],"sourcesContent":["import type { Block } from 'payload'\n\nimport { XAIIcon } from '../icons.js'\n\nexport const xaiBlock: Block = {\n  slug: 'xai',\n  fields: [\n    {\n      type: 'tabs',\n      tabs: [\n        // 1. Setup tab\n        {\n          fields: [\n            {\n              name: 'enabled',\n              type: 'checkbox',\n              defaultValue: true,\n              label: 'Enabled',\n            },\n            {\n              name: 'apiKey',\n              type: 'text',\n              admin: {\n                components: {\n                  Field: '@ai-stack/payloadcms/client#EncryptedTextField',\n                },\n                description: 'Your xAI API key. Will be encrypted in the database.',\n              },\n              label: 'API Key',\n              required: true,\n            },\n          ],\n          label: 'Setup',\n        },\n\n        // 2. Provider Options tab\n        {\n          fields: [\n            {\n              name: 'textProviderOptions',\n              type: 'group',\n              admin: {\n                description: 'Default provider options for text generation models.',\n              },\n              fields: [\n                {\n                  name: 'temperature',\n                  type: 'number',\n                  defaultValue: 1.0,\n                  label: 'Default Temperature',\n                  max: 2.0,\n                  min: 0.0,\n                },\n                {\n                  name: 'max_tokens',\n                  type: 'number',\n                  label: 'Max Tokens',\n                },\n                {\n                  name: 'top_p',\n                  type: 'number',\n                  defaultValue: 1.0,\n                  label: 'Top P',\n                  max: 1.0,\n                  min: 0.0,\n                },\n                {\n                  name: 'frequency_penalty',\n                  type: 'number',\n                  defaultValue: 0,\n                  label: 'Frequency Penalty',\n                  max: 2,\n                  min: -2,\n                },\n                {\n                  name: 'presence_penalty',\n                  type: 'number',\n                  defaultValue: 0,\n                  label: 'Presence Penalty',\n                  max: 2,\n                  min: -2,\n                },\n              ],\n              label: 'Text Provider Options',\n            },\n          ],\n          label: 'Provider Options',\n        },\n\n        // 3. Models tab\n        {\n          fields: [\n            {\n              name: 'models',\n              type: 'array',\n              admin: {\n                components: {\n                  RowLabel: '@ai-stack/payloadcms/client#ModelRowLabel',\n                },\n                initCollapsed: true,\n              },\n              defaultValue: [\n                { id: 'grok-4', name: 'Grok 4', enabled: true, responseModalities: ['TEXT'], useCase: 'text' },\n                { id: 'grok-3', name: 'Grok 3', enabled: true, responseModalities: ['TEXT'], useCase: 'text' },\n                { id: 'grok-3-fast', name: 'Grok 3 Fast', enabled: true, responseModalities: ['TEXT'], useCase: 'text' },\n                { id: 'grok-2-1212', name: 'Grok 2', enabled: true, responseModalities: ['TEXT'], useCase: 'text' },\n                { id: 'grok-2-vision-1212', name: 'Grok 2 Vision', enabled: true, responseModalities: ['TEXT'], useCase: 'image' },\n                { id: 'grok-vision-beta', name: 'Grok Vision Beta', enabled: true, responseModalities: ['TEXT'], useCase: 'image' },\n              ],\n              fields: [\n                {\n                  type: 'row',\n                  fields: [\n                    {\n                      name: 'id',\n                      type: 'text',\n                      admin: { width: '33%' },\n                      label: 'Model ID',\n                      required: true,\n                    },\n                    {\n                      name: 'name',\n                      type: 'text',\n                      admin: { width: '33%' },\n                      label: 'Display Name',\n                      required: true,\n                    },\n                    {\n                      name: 'useCase',\n                      type: 'select',\n                      admin: { width: '33%' },\n                      dbName: 'xai-model-useCase',\n                      label: 'Use Case',\n                      options: [\n                        { label: 'Text Generation', value: 'text' },\n                        { label: 'Image Generation', value: 'image' },\n                      ],\n                      required: true,\n                    },\n                  ],\n                },\n                {\n                  name: 'responseModalities',\n                  type: 'select',\n                  admin: {\n                    description: 'Output capabilities of this model',\n                    width: '50%',\n                  },\n                  dbName: 'xai-model-modalities',\n                  hasMany: true,\n                  label: 'Response Modalities',\n                  options: [\n                    { label: 'Text', value: 'TEXT' },\n                    { label: 'Image', value: 'IMAGE' },\n                    { label: 'Audio', value: 'AUDIO' },\n                  ],\n                },\n                {\n                  name: 'enabled',\n                  type: 'checkbox',\n                  admin: {\n                    width: '50%',\n                  },\n                  defaultValue: true,\n                  label: 'Enabled',\n                },\n              ],\n              label: 'Available Models',\n            },\n          ],\n          label: 'Models',\n        },\n      ],\n    },\n  ],\n  imageURL: XAIIcon,\n  labels: {\n    plural: 'xAI Providers',\n    singular: 'xAI Grok',\n  },\n}\n\n"],"names":["XAIIcon","xaiBlock","slug","fields","type","tabs","name","defaultValue","label","admin","components","Field","description","required","max","min","RowLabel","initCollapsed","id","enabled","responseModalities","useCase","width","dbName","options","value","hasMany","imageURL","labels","plural","singular"],"mappings":"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"}
+{"version":3,"sources":["../../../../src/ai/providers/blocks/xai.ts"],"sourcesContent":["import type { Block } from 'payload'\n\nimport { XAIIcon } from '../icons.js'\n\nexport const xaiBlock: Block = {\n  slug: 'xai',\n  fields: [\n    {\n      type: 'tabs',\n      tabs: [\n        // 1. Setup tab\n        {\n          fields: [\n            {\n              name: 'enabled',\n              type: 'checkbox',\n              defaultValue: true,\n              label: 'Enabled',\n            },\n            {\n              name: 'apiKey',\n              type: 'text',\n              admin: {\n                components: {\n                  Field: '@ai-stack/payloadcms/client#EncryptedTextField',\n                },\n                description: 'Your xAI API key. Will be encrypted in the database.',\n              },\n              label: 'API Key',\n              required: true,\n            },\n          ],\n          label: 'Setup',\n        },\n\n        // 3. Models tab\n        {\n          fields: [\n            {\n              name: 'models',\n              type: 'array',\n              admin: {\n                components: {\n                  RowLabel: '@ai-stack/payloadcms/client#ModelRowLabel',\n                },\n                initCollapsed: true,\n              },\n              defaultValue: [\n                { id: 'grok-4', name: 'Grok 4', enabled: true, responseModalities: ['TEXT'], useCase: 'text' },\n                { id: 'grok-3', name: 'Grok 3', enabled: true, responseModalities: ['TEXT'], useCase: 'text' },\n                { id: 'grok-3-fast', name: 'Grok 3 Fast', enabled: true, responseModalities: ['TEXT'], useCase: 'text' },\n                { id: 'grok-2-1212', name: 'Grok 2', enabled: true, responseModalities: ['TEXT'], useCase: 'text' },\n                { id: 'grok-2-vision-1212', name: 'Grok 2 Vision', enabled: true, responseModalities: ['TEXT'], useCase: 'image' },\n                { id: 'grok-vision-beta', name: 'Grok Vision Beta', enabled: true, responseModalities: ['TEXT'], useCase: 'image' },\n              ],\n              fields: [\n                {\n                  type: 'row',\n                  fields: [\n                    {\n                      name: 'id',\n                      type: 'text',\n                      admin: { width: '33%' },\n                      label: 'Model ID',\n                      required: true,\n                    },\n                    {\n                      name: 'name',\n                      type: 'text',\n                      admin: { width: '33%' },\n                      label: 'Display Name',\n                      required: true,\n                    },\n                    {\n                      name: 'useCase',\n                      type: 'select',\n                      admin: { width: '33%' },\n                      dbName: 'xai-model-useCase',\n                      label: 'Use Case',\n                      options: [\n                        { label: 'Text Generation', value: 'text' },\n                        { label: 'Image Generation', value: 'image' },\n                      ],\n                      required: true,\n                    },\n                  ],\n                },\n                {\n                  name: 'responseModalities',\n                  type: 'select',\n                  admin: {\n                    description: 'Output capabilities of this model',\n                    width: '50%',\n                  },\n                  dbName: 'xai-model-modalities',\n                  hasMany: true,\n                  label: 'Response Modalities',\n                  options: [\n                    { label: 'Text', value: 'TEXT' },\n                    { label: 'Image', value: 'IMAGE' },\n                    { label: 'Audio', value: 'AUDIO' },\n                  ],\n                },\n                {\n                  name: 'enabled',\n                  type: 'checkbox',\n                  admin: {\n                    width: '50%',\n                  },\n                  defaultValue: true,\n                  label: 'Enabled',\n                },\n              ],\n              label: 'Available Models',\n            },\n          ],\n          label: 'Models',\n        },\n      ],\n    },\n  ],\n  imageURL: XAIIcon,\n  labels: {\n    plural: 'xAI Providers',\n    singular: 'xAI Grok',\n  },\n}\n"],"names":["XAIIcon","xaiBlock","slug","fields","type","tabs","name","defaultValue","label","admin","components","Field","description","required","RowLabel","initCollapsed","id","enabled","responseModalities","useCase","width","dbName","options","value","hasMany","imageURL","labels","plural","singular"],"mappings":"AAEA,SAASA,OAAO,QAAQ,cAAa;AAErC,OAAO,MAAMC,WAAkB;IAC7BC,MAAM;IACNC,QAAQ;QACN;YACEC,MAAM;YACNC,MAAM;gBACJ,eAAe;gBACf;oBACEF,QAAQ;wBACN;4BACEG,MAAM;4BACNF,MAAM;4BACNG,cAAc;4BACdC,OAAO;wBACT;wBACA;4BACEF,MAAM;4BACNF,MAAM;4BACNK,OAAO;gCACLC,YAAY;oCACVC,OAAO;gCACT;gCACAC,aAAa;4BACf;4BACAJ,OAAO;4BACPK,UAAU;wBACZ;qBACD;oBACDL,OAAO;gBACT;gBAEA,gBAAgB;gBAChB;oBACEL,QAAQ;wBACN;4BACEG,MAAM;4BACNF,MAAM;4BACNK,OAAO;gCACLC,YAAY;oCACVI,UAAU;gCACZ;gCACAC,eAAe;4BACjB;4BACAR,cAAc;gCACZ;oCAAES,IAAI;oCAAUV,MAAM;oCAAUW,SAAS;oCAAMC,oBAAoB;wCAAC;qCAAO;oCAAEC,SAAS;gCAAO;gCAC7F;oCAAEH,IAAI;oCAAUV,MAAM;oCAAUW,SAAS;oCAAMC,oBAAoB;wCAAC;qCAAO;oCAAEC,SAAS;gCAAO;gCAC7F;oCAAEH,IAAI;oCAAeV,MAAM;oCAAeW,SAAS;oCAAMC,oBAAoB;wCAAC;qCAAO;oCAAEC,SAAS;gCAAO;gCACvG;oCAAEH,IAAI;oCAAeV,MAAM;oCAAUW,SAAS;oCAAMC,oBAAoB;wCAAC;qCAAO;oCAAEC,SAAS;gCAAO;gCAClG;oCAAEH,IAAI;oCAAsBV,MAAM;oCAAiBW,SAAS;oCAAMC,oBAAoB;wCAAC;qCAAO;oCAAEC,SAAS;gCAAQ;gCACjH;oCAAEH,IAAI;oCAAoBV,MAAM;oCAAoBW,SAAS;oCAAMC,oBAAoB;wCAAC;qCAAO;oCAAEC,SAAS;gCAAQ;6BACnH;4BACDhB,QAAQ;gCACN;oCACEC,MAAM;oCACND,QAAQ;wCACN;4CACEG,MAAM;4CACNF,MAAM;4CACNK,OAAO;gDAAEW,OAAO;4CAAM;4CACtBZ,OAAO;4CACPK,UAAU;wCACZ;wCACA;4CACEP,MAAM;4CACNF,MAAM;4CACNK,OAAO;gDAAEW,OAAO;4CAAM;4CACtBZ,OAAO;4CACPK,UAAU;wCACZ;wCACA;4CACEP,MAAM;4CACNF,MAAM;4CACNK,OAAO;gDAAEW,OAAO;4CAAM;4CACtBC,QAAQ;4CACRb,OAAO;4CACPc,SAAS;gDACP;oDAAEd,OAAO;oDAAmBe,OAAO;gDAAO;gDAC1C;oDAAEf,OAAO;oDAAoBe,OAAO;gDAAQ;6CAC7C;4CACDV,UAAU;wCACZ;qCACD;gCACH;gCACA;oCACEP,MAAM;oCACNF,MAAM;oCACNK,OAAO;wCACLG,aAAa;wCACbQ,OAAO;oCACT;oCACAC,QAAQ;oCACRG,SAAS;oCACThB,OAAO;oCACPc,SAAS;wCACP;4CAAEd,OAAO;4CAAQe,OAAO;wCAAO;wCAC/B;4CAAEf,OAAO;4CAASe,OAAO;wCAAQ;wCACjC;4CAAEf,OAAO;4CAASe,OAAO;wCAAQ;qCAClC;gCACH;gCACA;oCACEjB,MAAM;oCACNF,MAAM;oCACNK,OAAO;wCACLW,OAAO;oCACT;oCACAb,cAAc;oCACdC,OAAO;gCACT;6BACD;4BACDA,OAAO;wBACT;qBACD;oBACDA,OAAO;gBACT;aACD;QACH;KACD;IACDiB,UAAUzB;IACV0B,QAAQ;QACNC,QAAQ;QACRC,UAAU;IACZ;AACF,EAAC"}

package/dist/ai/providers/index.d.ts

@@ -1,2 +1,2 @@
 export * from './registry.js';
-export type { ProviderId } from './registry.js';
+export type { ProviderId } from './types.js';

package/dist/ai/providers/index.js

@@ -1,6 +1,4 @@
 // Re-export everything from registry
 export * from './registry.js';
- // NOTE: Static TEXT_MODEL_OPTIONS and availableTextProviders have been removed
- // in favor of dynamic loading from AI Settings.
 
 //# sourceMappingURL=index.js.map

package/dist/ai/providers/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/ai/providers/index.ts"],"sourcesContent":["// Re-export everything from registry\nexport * from './registry.js'\n\n// Export types\nexport type { ProviderId } from './registry.js'\n\n// NOTE: Static TEXT_MODEL_OPTIONS and availableTextProviders have been removed\n// in favor of dynamic loading from AI Settings.\n\n\n"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,cAAc,gBAAe;CAK7B,+EAA+E;CAC/E,gDAAgD"}
+{"version":3,"sources":["../../../src/ai/providers/index.ts"],"sourcesContent":["// Re-export everything from registry\nexport * from './registry.js'\n\n// Export types\nexport type { ProviderId } from './types.js'\n"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,cAAc,gBAAe"}

package/dist/ai/providers/registry.d.ts

@@ -1,40 +1,36 @@
 import type { LanguageModel } from 'ai';
 import type { Payload } from 'payload';
-export type { ProviderId } from './types.js';
 import type { ProviderRegistry } from './types.js';
+export declare function toAISDKProviderOptions({ defaultsForUseCase, providerId, settingsOverride, }: {
+    defaultsForUseCase?: {
+        provider?: string;
+    };
+    providerId?: string;
+    settingsOverride?: Record<string, unknown>;
+}): Record<string, Record<string, any>> | undefined;
+export declare function invalidateProviderCache(): void;
 /**
- * Load provider registry from AI Settings (type-safe)
+ * Load provider registry from AI Settings (cached with TTL).
  */
 export declare function getProviderRegistry(payload: Payload): Promise<ProviderRegistry>;
 /**
- * Get global defaults from AI Settings
+ * Get global defaults from AI Settings (cached with TTL).
  */
 export declare function getGlobalDefaults(payload: Payload): Promise<{
-    image?: {
-        model: string;
-        options?: Record<string, any>;
-        provider: string;
-    };
-    text?: {
-        model: string;
-        options?: Record<string, any>;
-        provider: string;
-    };
-    tts?: {
-        model: string;
-        options?: Record<string, any>;
-        provider: string;
-        voice?: string;
-    };
-    video?: {
-        model: string;
-        options?: Record<string, any>;
-        provider: string;
-    };
+    image?: import("./types.js").UseCaseDefaults;
+    text?: import("./types.js").UseCaseDefaults;
+    tts?: import("./types.js").UseCaseDefaults;
+    video?: import("./types.js").UseCaseDefaults;
 }>;
 /**
- * Get language model (type-safe, async)
+ * Get language model (cached registry + single defaults call).
+ */
+export declare function getLanguageModel(payload: Payload, providerId?: string, modelId?: string, settingsOverride?: Record<string, unknown>): Promise<LanguageModel>;
+/**
+ * Get image model (cached registry + single defaults call).
+ */
+export declare function getImageModel(payload: Payload, providerId?: string, modelId?: string, isMultimodalText?: boolean, settingsOverride?: Record<string, unknown>): Promise<any>;
+/**
+ * Get TTS model (cached registry + single defaults call).
  */
-export declare function getLanguageModel(payload: Payload, providerId?: string, modelId?: string, options?: Record<string, any>): Promise<LanguageModel>;
-export declare function getImageModel(payload: Payload, providerId?: string, modelId?: string, options?: Record<string, any>, isMultimodalText?: boolean): Promise<any>;
-export declare function getTTSModel(payload: Payload, providerId?: string, modelId?: string, options?: Record<string, any>): Promise<any>;
+export declare function getTTSModel(payload: Payload, providerId?: string, modelId?: string, settingsOverride?: Record<string, unknown>): Promise<any>;

package/dist/ai/providers/registry.js

@@ -1,5 +1,68 @@
 import * as process from 'node:process';
-// Type-safe provider factory functions
+function isRecord(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+function resolveProviderOptions(settingsForUseCase) {
+    if (!settingsForUseCase) {
+        return {};
+    }
+    const provider = settingsForUseCase.provider;
+    if (provider) {
+        const allOptions = settingsForUseCase.providerOptions;
+        return allOptions?.[provider] || {};
+    }
+    return {};
+}
+function deepMergeOptions(base, override) {
+    const merged = {
+        ...base
+    };
+    for (const [key, value] of Object.entries(override)){
+        const current = merged[key];
+        if (current && value && typeof current === 'object' && typeof value === 'object' && !Array.isArray(current) && !Array.isArray(value)) {
+            merged[key] = deepMergeOptions(current, value);
+            continue;
+        }
+        merged[key] = value;
+    }
+    return merged;
+}
+function resolveEffectiveProviderOptions({ defaultsForUseCase, providerId, settingsOverride }) {
+    const preNormalizedOptions = providerId && isRecord(settingsOverride) && isRecord(settingsOverride[providerId]) ? settingsOverride[providerId] : {};
+    const globalDefaultOptions = defaultsForUseCase?.provider === providerId ? resolveProviderOptions(defaultsForUseCase) : {};
+    const overrideOptions = Object.keys(preNormalizedOptions).length > 0 ? preNormalizedOptions : settingsOverride?.provider === providerId ? resolveProviderOptions(settingsOverride) : {};
+    return deepMergeOptions(globalDefaultOptions, overrideOptions);
+}
+export function toAISDKProviderOptions({ defaultsForUseCase, providerId, settingsOverride }) {
+    if (!providerId) {
+        return undefined;
+    }
+    const resolved = resolveEffectiveProviderOptions({
+        defaultsForUseCase,
+        providerId,
+        settingsOverride
+    });
+    if (Object.keys(resolved).length === 0) {
+        return undefined;
+    }
+    return {
+        [providerId]: resolved
+    };
+}
+// ─── Cache layer ────────────────────────────────────────────────
+// Module-level caches with TTL to avoid redundant DB queries.
+// A single text-generation request previously triggered 3 findGlobal
+// calls; with this cache the DB is hit at most once per TTL window.
+const CACHE_TTL = 60_000 // 60 seconds
+;
+let registryCache = null;
+let defaultsCache = null;
+// Allow external invalidation (e.g. after saving AISettings)
+export function invalidateProviderCache() {
+    registryCache = null;
+    defaultsCache = null;
+}
+// ─── Provider factory functions ─────────────────────────────────
 const providerFactories = {
     anthropic: async (block)=>{
         const { createAnthropic } = await import('@ai-sdk/anthropic');
@@ -15,7 +78,6 @@ const providerFactories = {
     },
     fal: async (block)=>{
         const { fal } = await import('@ai-sdk/fal');
-        // Fal uses global instance, configure with apiKey
         process.env.FAL_KEY = block.apiKey;
         if (block.webhookSecret) {
             process.env.FAL_WEBHOOK_SECRET = block.webhookSecret;
@@ -37,7 +99,6 @@ const providerFactories = {
         });
     },
     'openai-compatible': async (block)=>{
-        console.log('OpenAI compatible, ', block);
         const { createOpenAICompatible } = await import('@ai-sdk/openai-compatible');
         return createOpenAICompatible({
             name: block.providerName,
@@ -52,14 +113,54 @@ const providerFactories = {
         });
     }
 };
-/**
- * Type guard to check provider block type
- */ function isProviderBlock(block, blockType) {
+// ─── Helpers ────────────────────────────────────────────────────
+function isProviderBlock(block, blockType) {
     return block.blockType === blockType;
 }
+function getFactoryForBlock(providerBlock) {
+    if (isProviderBlock(providerBlock, 'openai')) {
+        return ()=>providerFactories.openai(providerBlock);
+    }
+    if (isProviderBlock(providerBlock, 'anthropic')) {
+        return ()=>providerFactories.anthropic(providerBlock);
+    }
+    if (isProviderBlock(providerBlock, 'google')) {
+        return ()=>providerFactories.google(providerBlock);
+    }
+    if (isProviderBlock(providerBlock, 'xai')) {
+        return ()=>providerFactories.xai(providerBlock);
+    }
+    if (isProviderBlock(providerBlock, 'fal')) {
+        return ()=>providerFactories.fal(providerBlock);
+    }
+    if (isProviderBlock(providerBlock, 'elevenlabs')) {
+        return ()=>providerFactories.elevenlabs(providerBlock);
+    }
+    if (isProviderBlock(providerBlock, 'openai-compatible')) {
+        return ()=>providerFactories['openai-compatible'](providerBlock);
+    }
+    return undefined;
+}
 /**
- * Load provider registry from AI Settings (type-safe)
+ * Resolve the provider SDK instance, caching after first call.
+ */ async function resolveProviderInstance(provider) {
+    if (provider.instance) {
+        return provider.instance;
+    }
+    if (!provider.factory) {
+        throw new Error(`Provider ${provider.id} has no factory or instance`);
+    }
+    const instance = await provider.factory();
+    provider.instance = instance;
+    return instance;
+}
+// ─── Public API ─────────────────────────────────────────────────
+/**
+ * Load provider registry from AI Settings (cached with TTL).
  */ export async function getProviderRegistry(payload) {
+    if (registryCache && Date.now() - registryCache.timestamp < CACHE_TTL) {
+        return registryCache.data;
+    }
     const settings = await payload.findGlobal({
         slug: 'ai-providers',
         context: {
@@ -67,41 +168,17 @@ const providerFactories = {
         }
     });
     const registry = {};
-    // console.log('settings - >', JSON.stringify(settings, null, 2))
     for (const providerBlock of settings.providers || []){
         if (!providerBlock.enabled) {
             continue;
         }
         const { blockType } = providerBlock;
-        // Type-safe factory lookup and invocation
-        let factory;
-        if (isProviderBlock(providerBlock, 'openai')) {
-            factory = ()=>providerFactories.openai(providerBlock);
-        } else if (isProviderBlock(providerBlock, 'anthropic')) {
-            factory = ()=>providerFactories.anthropic(providerBlock);
-        } else if (isProviderBlock(providerBlock, 'google')) {
-            factory = ()=>providerFactories.google(providerBlock);
-        } else if (isProviderBlock(providerBlock, 'xai')) {
-            factory = ()=>providerFactories.xai(providerBlock);
-        } else if (isProviderBlock(providerBlock, 'fal')) {
-            factory = ()=>providerFactories.fal(providerBlock);
-        } else if (isProviderBlock(providerBlock, 'elevenlabs')) {
-            factory = ()=>providerFactories.elevenlabs(providerBlock);
-        } else if (isProviderBlock(providerBlock, 'openai-compatible')) {
-            factory = ()=>providerFactories['openai-compatible'](providerBlock);
-        }
+        const factory = getFactoryForBlock(providerBlock);
         if (!factory) {
-            console.warn(`No factory for provider: ${blockType}`);
+            payload.logger.warn(`— AI Plugin: No factory for provider: ${blockType}`);
             continue;
         }
-        // Filter enabled models only
         const enabledModels = providerBlock.models.filter((m)=>m.enabled);
-        // Extract provider options
-        const options = {
-            image: 'imageProviderOptions' in providerBlock ? providerBlock.imageProviderOptions : undefined,
-            text: 'textProviderOptions' in providerBlock ? providerBlock.textProviderOptions : undefined,
-            tts: 'ttsProviderOptions' in providerBlock ? providerBlock.ttsProviderOptions : undefined
-        };
         registry[blockType] = {
             id: blockType,
             name: 'providerName' in providerBlock ? providerBlock.providerName : blockType,
@@ -109,44 +186,49 @@ const providerFactories = {
             enabled: true,
             factory,
             instance: undefined,
-            models: enabledModels,
-            options
+            models: enabledModels
         };
     }
+    // Also cache defaults from the same settings fetch to save a second query
+    defaultsCache = {
+        data: settings.defaults,
+        timestamp: Date.now()
+    };
+    registryCache = {
+        data: registry,
+        timestamp: Date.now()
+    };
     return registry;
 }
 /**
- * Get global defaults from AI Settings
+ * Get global defaults from AI Settings (cached with TTL).
  */ export async function getGlobalDefaults(payload) {
+    if (defaultsCache && Date.now() - defaultsCache.timestamp < CACHE_TTL) {
+        return defaultsCache.data;
+    }
     const settings = await payload.findGlobal({
         slug: 'ai-providers'
     });
+    defaultsCache = {
+        data: settings.defaults,
+        timestamp: Date.now()
+    };
     return settings.defaults;
 }
 /**
- * Get language model (type-safe, async)
- */ export async function getLanguageModel(payload, providerId, modelId, options) {
-    if (!providerId || !modelId) {
-        const defaults = await getGlobalDefaults(payload);
-        if (!providerId) {
-            providerId = defaults?.text?.provider;
-        }
-        if (!modelId) {
-            modelId = defaults?.text?.model;
-        }
+ * Get language model (cached registry + single defaults call).
+ */ export async function getLanguageModel(payload, providerId, modelId, settingsOverride) {
+    const registry = await getProviderRegistry(payload);
+    const defaults = await getGlobalDefaults(payload);
+    if (!providerId) {
+        providerId = defaults?.text?.provider;
     }
-    // Extract global default options if we are using the default provider
-    let globalDefaultOptions = {};
-    if (providerId) {
-        const defaults = await getGlobalDefaults(payload);
-        if (defaults?.text?.provider === providerId) {
-            globalDefaultOptions = defaults?.text?.options || {};
-        }
+    if (!modelId) {
+        modelId = defaults?.text?.model;
     }
     if (!providerId || !modelId) {
         throw new Error('Provider and model must be specified or configured in defaults');
     }
-    const registry = await getProviderRegistry(payload);
     const provider = registry[providerId];
     if (!provider) {
         throw new Error(`Provider ${providerId} not found in registry`);
@@ -154,113 +236,77 @@ const providerFactories = {
     if (!provider.enabled) {
         throw new Error(`Provider ${providerId} is not enabled`);
     }
-    // We only support factory now for dynamic loading, instance is legacy/cache
-    let providerInstance;
-    if (provider.instance) {
-        providerInstance = provider.instance;
-    } else if (provider.factory) {
-        providerInstance = await provider.factory();
-    } else {
-        throw new Error(`Provider ${providerId} has no factory or instance`);
-    }
-    // Merge default settings with override options
-    const finalOptions = {
-        ...provider.options?.text || {},
-        ...globalDefaultOptions,
-        ...options || {}
-    };
-    return providerInstance(modelId, finalOptions);
+    const options = resolveEffectiveProviderOptions({
+        defaultsForUseCase: defaults?.text,
+        providerId,
+        settingsOverride
+    });
+    const providerInstance = await resolveProviderInstance(provider);
+    return providerInstance(modelId, options);
 }
-export async function getImageModel(payload, providerId, modelId, options, isMultimodalText) {
-    if (!providerId || !modelId) {
-        const defaults = await getGlobalDefaults(payload);
-        if (!providerId) {
-            providerId = defaults?.image?.provider;
-        }
-        if (!modelId) {
-            modelId = defaults?.image?.model;
-        }
+/**
+ * Get image model (cached registry + single defaults call).
+ */ export async function getImageModel(payload, providerId, modelId, isMultimodalText, settingsOverride) {
+    const registry = await getProviderRegistry(payload);
+    const defaults = await getGlobalDefaults(payload);
+    if (!providerId) {
+        providerId = defaults?.image?.provider;
     }
-    // Extract global default options if we are using the default provider
-    let globalDefaultOptions = {};
-    if (providerId) {
-        const defaults = await getGlobalDefaults(payload);
-        if (defaults?.image?.provider === providerId) {
-            globalDefaultOptions = defaults?.image?.options || {};
-        }
+    if (!modelId) {
+        modelId = defaults?.image?.model;
     }
     if (!providerId || !modelId) {
         throw new Error('Provider and model must be specified or configured in defaults');
     }
-    const registry = await getProviderRegistry(payload);
     const provider = registry[providerId];
     if (!provider) {
         throw new Error(`Provider ${providerId} not found`);
     }
-    // Merge default settings with override options
-    const finalOptions = {
-        ...provider.options?.image || {},
-        ...globalDefaultOptions,
-        ...options || {}
-    };
-    if (provider.instance) {
-        return provider.instance;
+    const options = resolveEffectiveProviderOptions({
+        defaultsForUseCase: defaults?.image,
+        providerId,
+        settingsOverride
+    });
+    const instance = await resolveProviderInstance(provider);
+    // Type-safe check for image support
+    if (!isMultimodalText && typeof instance === 'function' && 'image' in instance && typeof instance.image === 'function') {
+        return instance.image(modelId, options);
     }
-    if (provider.factory) {
-        const instance = await provider.factory();
-        // Type-safe check for image support
-        if (!isMultimodalText && typeof instance === 'function' && 'image' in instance && typeof instance.image === 'function') {
-            return instance.image(modelId, finalOptions);
-        }
-        // Also check if instance is an object with image method
-        if (typeof instance === 'object' && instance !== null && 'image' in instance && !isMultimodalText) {
-            return instance.image?.(modelId, finalOptions);
-        }
-        // Fallback for providers that might return the model directly or use the default factory
-        return typeof instance === 'function' ? instance(modelId, finalOptions) : instance;
+    // Also check if instance is an object with image method
+    if (typeof instance === 'object' && instance !== null && 'image' in instance && !isMultimodalText) {
+        return instance.image?.(modelId, options);
     }
-    throw new Error(`Invalid provider configuration for ${providerId}`);
+    // Fallback for providers that might return the model directly
+    return typeof instance === 'function' ? instance(modelId, options) : instance;
 }
-export async function getTTSModel(payload, providerId, modelId, options) {
-    if (!providerId || !modelId) {
-        const defaults = await getGlobalDefaults(payload);
-        if (!providerId) {
-            providerId = defaults?.tts?.provider;
-        }
-        if (!modelId) {
-            modelId = defaults?.tts?.model;
-        }
+/**
+ * Get TTS model (cached registry + single defaults call).
+ */ export async function getTTSModel(payload, providerId, modelId, settingsOverride) {
+    const registry = await getProviderRegistry(payload);
+    const defaults = await getGlobalDefaults(payload);
+    if (!providerId) {
+        providerId = defaults?.tts?.provider;
     }
-    // Extract global default options if we are using the default provider
-    let globalDefaultOptions = {};
-    if (providerId) {
-        const defaults = await getGlobalDefaults(payload);
-        if (defaults?.tts?.provider === providerId) {
-            globalDefaultOptions = defaults?.tts?.options || {};
-        }
+    if (!modelId) {
+        modelId = defaults?.tts?.model;
     }
     if (!providerId || !modelId) {
         throw new Error('Provider and model must be specified or configured in defaults');
     }
-    const registry = await getProviderRegistry(payload);
     const provider = registry[providerId];
     if (!provider) {
         throw new Error(`Provider ${providerId} not found`);
     }
-    // Merge default settings with override options
-    const finalOptions = {
-        ...provider.options?.tts || {},
-        ...globalDefaultOptions,
-        ...options || {}
-    };
-    if (provider.factory) {
-        const instance = await provider.factory();
-        if (instance?.speech) {
-            return instance.speech(modelId, finalOptions);
-        }
-        return typeof instance === 'function' ? instance(modelId, finalOptions) : instance;
+    const options = resolveEffectiveProviderOptions({
+        defaultsForUseCase: defaults?.tts,
+        providerId,
+        settingsOverride
+    });
+    const instance = await resolveProviderInstance(provider);
+    if (instance?.speech) {
+        return instance.speech(modelId, options);
     }
-    throw new Error(`Invalid provider configuration for ${providerId}`);
+    return typeof instance === 'function' ? instance(modelId, options) : instance;
 }
 
 //# sourceMappingURL=registry.js.map