@webiny/api-core 6.5.0-beta.1 → 6.5.0-beta.11

package/ApiCoreFeature.js

@@ -8,20 +8,24 @@ import { AdminUsersFeature } from "./features/users/AdminUsersFeature.js";
 import { IdpAuthenticatorFeature } from "./idp/feature.js";
 import { KeyValueStoreFeature } from "./features/keyValueStore/feature.js";
 import { BuildParamsFeature } from "./features/buildParams/feature.js";
+import { DebuggerFeature } from "./features/debugger/feature.js";
 import { EncryptionFeature } from "./features/encryption/feature.js";
 import { FeatureFlagsFeature } from "./features/featureFlags/feature.js";
 import { MaskerFeature } from "./features/masker/feature.js";
 import { AiFeature } from "./features/ai/feature.js";
+import { HttpClientFeature } from "./features/httpClient/feature.js";
 import { NullWebhookDispatcher } from "./features/webhooks/WebhookDispatcher/NullWebhookDispatcher.js";
 import { WebhookProviderFeature } from "./features/webhooks/index.js";
 const ApiCoreFeature = createFeature({
     name: "ApiCore",
     register (container, config) {
         MaskerFeature.register(container);
+        HttpClientFeature.register(container);
         AiFeature.register(container);
         LoggerFeature.register(container);
         EventPublisherFeature.register(container);
         BuildParamsFeature.register(container);
+        DebuggerFeature.register(container);
         EncryptionFeature.register(container);
         FeatureFlagsFeature.register(container);
         TenancyFeature.register(container, config.tenancyStorageOperations);

package/ApiCoreFeature.js.map

@@ -1 +1 @@
-{"version":3,"file":"ApiCoreFeature.js","sources":["../src/ApiCoreFeature.ts"],"sourcesContent":["import { createFeature } from \"@webiny/feature/api\";\nimport { Container } from \"@webiny/di\";\nimport { EventPublisherFeature } from \"~/features/eventPublisher/feature.js\";\nimport { LoggerFeature } from \"~/features/logger/feature.js\";\nimport { SecurityFeature } from \"~/features/security/SecurityFeature.js\";\nimport { SystemFeature } from \"~/features/system/SystemFeature.js\";\nimport { TenancyFeature } from \"./features/tenancy/TenancyFeature.js\";\nimport { AdminUsersFeature } from \"~/features/users/AdminUsersFeature.js\";\nimport type { ApiCoreStorageOperations } from \"~/types/core.js\";\nimport { IdpAuthenticatorFeature } from \"~/idp/feature.js\";\nimport { KeyValueStoreFeature } from \"~/features/keyValueStore/feature.js\";\nimport { BuildParamsFeature } from \"~/features/buildParams/feature.js\";\nimport { EncryptionFeature } from \"~/features/encryption/feature.js\";\nimport { FeatureFlagsFeature } from \"~/features/featureFlags/feature.js\";\nimport { MaskerFeature } from \"~/features/masker/feature.js\";\nimport { AiFeature } from \"~/features/ai/feature.js\";\nimport { NullWebhookDispatcher } from \"./features/webhooks/WebhookDispatcher/NullWebhookDispatcher.js\";\nimport { WebhookProviderFeature } from \"~/features/webhooks/index.js\";\n\nexport const ApiCoreFeature = createFeature({\n    name: \"ApiCore\",\n    register(container: Container, config: ApiCoreStorageOperations) {\n        // Register features\n        MaskerFeature.register(container);\n        AiFeature.register(container);\n        LoggerFeature.register(container);\n        EventPublisherFeature.register(container);\n        BuildParamsFeature.register(container);\n        EncryptionFeature.register(container);\n        FeatureFlagsFeature.register(container);\n        TenancyFeature.register(container, config.tenancyStorageOperations);\n        SecurityFeature.register(container, config.securityStorageOperations);\n        AdminUsersFeature.register(container, config.usersStorageOperations);\n        KeyValueStoreFeature.register(container, config.keyValueStorageOperations);\n        SystemFeature.register(container);\n        IdpAuthenticatorFeature.register(container);\n        container.register(NullWebhookDispatcher).inSingletonScope();\n        WebhookProviderFeature.register(container);\n    }\n});\n"],"names":["ApiCoreFeature","createFeature","container","config","MaskerFeature","AiFeature","LoggerFeature","EventPublisherFeature","BuildParamsFeature","EncryptionFeature","FeatureFlagsFeature","TenancyFeature","SecurityFeature","AdminUsersFeature","KeyValueStoreFeature","SystemFeature","IdpAuthenticatorFeature","NullWebhookDispatcher","WebhookProviderFeature"],"mappings":";;;;;;;;;;;;;;;;AAmBO,MAAMA,iBAAiBC,cAAc;IACxC,MAAM;IACN,UAASC,SAAoB,EAAEC,MAAgC;QAE3DC,cAAc,QAAQ,CAACF;QACvBG,UAAU,QAAQ,CAACH;QACnBI,cAAc,QAAQ,CAACJ;QACvBK,sBAAsB,QAAQ,CAACL;QAC/BM,mBAAmB,QAAQ,CAACN;QAC5BO,kBAAkB,QAAQ,CAACP;QAC3BQ,oBAAoB,QAAQ,CAACR;QAC7BS,eAAe,QAAQ,CAACT,WAAWC,OAAO,wBAAwB;QAClES,gBAAgB,QAAQ,CAACV,WAAWC,OAAO,yBAAyB;QACpEU,kBAAkB,QAAQ,CAACX,WAAWC,OAAO,sBAAsB;QACnEW,qBAAqB,QAAQ,CAACZ,WAAWC,OAAO,yBAAyB;QACzEY,cAAc,QAAQ,CAACb;QACvBc,wBAAwB,QAAQ,CAACd;QACjCA,UAAU,QAAQ,CAACe,uBAAuB,gBAAgB;QAC1DC,uBAAuB,QAAQ,CAAChB;IACpC;AACJ"}
+{"version":3,"file":"ApiCoreFeature.js","sources":["../src/ApiCoreFeature.ts"],"sourcesContent":["import { createFeature } from \"@webiny/feature/api\";\nimport { Container } from \"@webiny/di\";\nimport { EventPublisherFeature } from \"~/features/eventPublisher/feature.js\";\nimport { LoggerFeature } from \"~/features/logger/feature.js\";\nimport { SecurityFeature } from \"~/features/security/SecurityFeature.js\";\nimport { SystemFeature } from \"~/features/system/SystemFeature.js\";\nimport { TenancyFeature } from \"./features/tenancy/TenancyFeature.js\";\nimport { AdminUsersFeature } from \"~/features/users/AdminUsersFeature.js\";\nimport type { ApiCoreStorageOperations } from \"~/types/core.js\";\nimport { IdpAuthenticatorFeature } from \"~/idp/feature.js\";\nimport { KeyValueStoreFeature } from \"~/features/keyValueStore/feature.js\";\nimport { BuildParamsFeature } from \"~/features/buildParams/feature.js\";\nimport { DebuggerFeature } from \"~/features/debugger/feature.js\";\nimport { EncryptionFeature } from \"~/features/encryption/feature.js\";\nimport { FeatureFlagsFeature } from \"~/features/featureFlags/feature.js\";\nimport { MaskerFeature } from \"~/features/masker/feature.js\";\nimport { AiFeature } from \"~/features/ai/feature.js\";\nimport { HttpClientFeature } from \"~/features/httpClient/feature.js\";\nimport { NullWebhookDispatcher } from \"./features/webhooks/WebhookDispatcher/NullWebhookDispatcher.js\";\nimport { WebhookProviderFeature } from \"~/features/webhooks/index.js\";\n\nexport const ApiCoreFeature = createFeature({\n    name: \"ApiCore\",\n    register(container: Container, config: ApiCoreStorageOperations) {\n        // Register features\n        MaskerFeature.register(container);\n        HttpClientFeature.register(container);\n        AiFeature.register(container);\n        LoggerFeature.register(container);\n        EventPublisherFeature.register(container);\n        BuildParamsFeature.register(container);\n        DebuggerFeature.register(container);\n        EncryptionFeature.register(container);\n        FeatureFlagsFeature.register(container);\n        TenancyFeature.register(container, config.tenancyStorageOperations);\n        SecurityFeature.register(container, config.securityStorageOperations);\n        AdminUsersFeature.register(container, config.usersStorageOperations);\n        KeyValueStoreFeature.register(container, config.keyValueStorageOperations);\n        SystemFeature.register(container);\n        IdpAuthenticatorFeature.register(container);\n        container.register(NullWebhookDispatcher).inSingletonScope();\n        WebhookProviderFeature.register(container);\n    }\n});\n"],"names":["ApiCoreFeature","createFeature","container","config","MaskerFeature","HttpClientFeature","AiFeature","LoggerFeature","EventPublisherFeature","BuildParamsFeature","DebuggerFeature","EncryptionFeature","FeatureFlagsFeature","TenancyFeature","SecurityFeature","AdminUsersFeature","KeyValueStoreFeature","SystemFeature","IdpAuthenticatorFeature","NullWebhookDispatcher","WebhookProviderFeature"],"mappings":";;;;;;;;;;;;;;;;;;AAqBO,MAAMA,iBAAiBC,cAAc;IACxC,MAAM;IACN,UAASC,SAAoB,EAAEC,MAAgC;QAE3DC,cAAc,QAAQ,CAACF;QACvBG,kBAAkB,QAAQ,CAACH;QAC3BI,UAAU,QAAQ,CAACJ;QACnBK,cAAc,QAAQ,CAACL;QACvBM,sBAAsB,QAAQ,CAACN;QAC/BO,mBAAmB,QAAQ,CAACP;QAC5BQ,gBAAgB,QAAQ,CAACR;QACzBS,kBAAkB,QAAQ,CAACT;QAC3BU,oBAAoB,QAAQ,CAACV;QAC7BW,eAAe,QAAQ,CAACX,WAAWC,OAAO,wBAAwB;QAClEW,gBAAgB,QAAQ,CAACZ,WAAWC,OAAO,yBAAyB;QACpEY,kBAAkB,QAAQ,CAACb,WAAWC,OAAO,sBAAsB;QACnEa,qBAAqB,QAAQ,CAACd,WAAWC,OAAO,yBAAyB;QACzEc,cAAc,QAAQ,CAACf;QACvBgB,wBAAwB,QAAQ,CAAChB;QACjCA,UAAU,QAAQ,CAACiB,uBAAuB,gBAAgB;QAC1DC,uBAAuB,QAAQ,CAAClB;IACpC;AACJ"}

package/createApiCore.d.ts

@@ -4,4 +4,4 @@ export interface ApiCoreConfig {
     storageOperations: ApiCoreStorageOperations;
     testProjectLicense?: DecryptedWcpProjectLicense;
 }
-export declare const createApiCore: (config: ApiCoreConfig) => (import("@webiny/api/index.js").ContextPlugin<import("~/types/core.js").ApiCoreContext>[] | import("@webiny/api/index.js").ContextPlugin<import("~/types/core.js").ApiCoreContext> | import("@webiny/handler-graphql/index.js").GraphQLSchemaPlugin<import("@webiny/api/types.js").Context> | import("@webiny/handler/index.js").RegisterExtensionPlugin<import("@webiny/handler/types.js").Context>)[];
+export declare const createApiCore: (config: ApiCoreConfig) => (import("@webiny/api/index.js").ContextPlugin<import("~/types/core.js").ApiCoreContext>[] | import("@webiny/api/index.js").ContextPlugin<import("~/types/core.js").ApiCoreContext> | import("@webiny/handler-graphql/index.js").GraphQLSchemaPlugin<import("@webiny/api/types.js").Context> | import("@webiny/plugins/types.js").PluginCollection | import("@webiny/plugins/types.js").PluginFactory | import("@webiny/handler/index.js").RegisterExtensionPlugin<import("@webiny/handler/types.js").Context> | import("@webiny/plugins/types.js").Plugin<Record<string, any>>)[];

package/createApiCore.js

@@ -5,6 +5,7 @@ import { createSecurityContext } from "./legacy/security/createSecurityContext.j
 import { createAdminUsersContext } from "./legacy/users/createAdminUsersContext.js";
 import { createTenancyContext } from "./legacy/tenancy/createTenancyContext.js";
 import { createSystemGraphQL } from "./graphql/system/createSystemGraphQL.js";
+import { createDebuggerPlugins } from "./features/debugger/index.js";
 const createApiCore = (config)=>{
     const plugin = createRegisterExtensionPlugin((context)=>{
         ApiCoreFeature.register(context.container, config.storageOperations);
@@ -18,7 +19,8 @@ const createApiCore = (config)=>{
         createTenancyContext(),
         createSecurityContext(),
         createAdminUsersContext(),
-        createSystemGraphQL()
+        createSystemGraphQL(),
+        ...createDebuggerPlugins()
     ];
 };
 export { createApiCore };

package/createApiCore.js.map

@@ -1 +1 @@
-{"version":3,"file":"createApiCore.js","sources":["../src/createApiCore.ts"],"sourcesContent":["import { createRegisterExtensionPlugin } from \"@webiny/handler/plugins/RegisterExtensionPlugin.js\";\nimport { ApiCoreFeature } from \"./ApiCoreFeature.js\";\nimport type { DecryptedWcpProjectLicense } from \"@webiny/wcp/types.js\";\nimport { createWcpContext } from \"~/legacy/wcp/context.js\";\nimport { createSecurityContext } from \"~/legacy/security/createSecurityContext.js\";\nimport { createAdminUsersContext } from \"~/legacy/users/createAdminUsersContext.js\";\nimport { createTenancyContext } from \"~/legacy/tenancy/createTenancyContext.js\";\nimport { createSystemGraphQL } from \"~/graphql/system/createSystemGraphQL.js\";\nimport type { ApiCoreStorageOperations } from \"~/types/core.js\";\n\nexport interface ApiCoreConfig {\n    storageOperations: ApiCoreStorageOperations;\n    testProjectLicense?: DecryptedWcpProjectLicense;\n}\n\nexport const createApiCore = (config: ApiCoreConfig) => {\n    const plugin = createRegisterExtensionPlugin(context => {\n        ApiCoreFeature.register(context.container, config.storageOperations);\n    });\n    plugin.name = \"apiCore.extension\";\n\n    return [\n        plugin,\n        createWcpContext({ testProjectLicense: config.testProjectLicense }),\n        createTenancyContext(),\n        createSecurityContext(),\n        createAdminUsersContext(),\n        createSystemGraphQL()\n    ];\n};\n"],"names":["createApiCore","config","plugin","createRegisterExtensionPlugin","context","ApiCoreFeature","createWcpContext","createTenancyContext","createSecurityContext","createAdminUsersContext","createSystemGraphQL"],"mappings":";;;;;;;AAeO,MAAMA,gBAAgB,CAACC;IAC1B,MAAMC,SAASC,8BAA8BC,CAAAA;QACzCC,eAAe,QAAQ,CAACD,QAAQ,SAAS,EAAEH,OAAO,iBAAiB;IACvE;IACAC,OAAO,IAAI,GAAG;IAEd,OAAO;QACHA;QACAI,iBAAiB;YAAE,oBAAoBL,OAAO,kBAAkB;QAAC;QACjEM;QACAC;QACAC;QACAC;KACH;AACL"}
+{"version":3,"file":"createApiCore.js","sources":["../src/createApiCore.ts"],"sourcesContent":["import { createRegisterExtensionPlugin } from \"@webiny/handler/plugins/RegisterExtensionPlugin.js\";\nimport { ApiCoreFeature } from \"./ApiCoreFeature.js\";\nimport type { DecryptedWcpProjectLicense } from \"@webiny/wcp/types.js\";\nimport { createWcpContext } from \"~/legacy/wcp/context.js\";\nimport { createSecurityContext } from \"~/legacy/security/createSecurityContext.js\";\nimport { createAdminUsersContext } from \"~/legacy/users/createAdminUsersContext.js\";\nimport { createTenancyContext } from \"~/legacy/tenancy/createTenancyContext.js\";\nimport { createSystemGraphQL } from \"~/graphql/system/createSystemGraphQL.js\";\nimport type { ApiCoreStorageOperations } from \"~/types/core.js\";\nimport { createDebuggerPlugins } from \"~/features/debugger/index.js\";\n\nexport interface ApiCoreConfig {\n    storageOperations: ApiCoreStorageOperations;\n    testProjectLicense?: DecryptedWcpProjectLicense;\n}\n\nexport const createApiCore = (config: ApiCoreConfig) => {\n    const plugin = createRegisterExtensionPlugin(context => {\n        ApiCoreFeature.register(context.container, config.storageOperations);\n    });\n    plugin.name = \"apiCore.extension\";\n\n    return [\n        plugin,\n        createWcpContext({ testProjectLicense: config.testProjectLicense }),\n        createTenancyContext(),\n        createSecurityContext(),\n        createAdminUsersContext(),\n        createSystemGraphQL(),\n        ...createDebuggerPlugins()\n    ];\n};\n"],"names":["createApiCore","config","plugin","createRegisterExtensionPlugin","context","ApiCoreFeature","createWcpContext","createTenancyContext","createSecurityContext","createAdminUsersContext","createSystemGraphQL","createDebuggerPlugins"],"mappings":";;;;;;;;AAgBO,MAAMA,gBAAgB,CAACC;IAC1B,MAAMC,SAASC,8BAA8BC,CAAAA;QACzCC,eAAe,QAAQ,CAACD,QAAQ,SAAS,EAAEH,OAAO,iBAAiB;IACvE;IACAC,OAAO,IAAI,GAAG;IAEd,OAAO;QACHA;QACAI,iBAAiB;YAAE,oBAAoBL,OAAO,kBAAkB;QAAC;QACjEM;QACAC;QACAC;QACAC;WACGC;KACN;AACL"}

package/features/ai/Ai.js

@@ -4,6 +4,11 @@ import { Ai, AiConnectionFactory, AiModelRegistry, AiSdkFactory } from "./abstra
 import { mdbid } from "@webiny/utils/mdbid.js";
 import { EventPublisher } from "../eventPublisher/index.js";
 import { AiAfterGenerateTextEvent, AiBeforeGenerateTextEvent, AiBeforeStreamTextEvent, AiGenerateTextErrorEvent } from "./events.js";
+const withSupportedOptions = (options, model)=>{
+    if (void 0 === options.temperature || model.supports?.temperature === true) return options;
+    const { temperature: _temperature, ...rest } = options;
+    return rest;
+};
 class AiImpl {
     constructor(sdkFactories, connectionFactories, eventPublisher, modelRegistry){
         this.sdkFactories = sdkFactories;
@@ -14,8 +19,9 @@ class AiImpl {
         this.resolvedConnections = null;
     }
     async generateText(params) {
-        const { model, connection, ...rest } = params;
-        const resolvedModel = await this.resolveLanguageModel(model, connection);
+        const { model, connection, ...options } = params;
+        const { languageModel: resolvedModel, model: catalogModel } = await this.resolveLanguageModel(model, connection);
+        const rest = withSupportedOptions(options, catalogModel);
         const requestId = mdbid();
         await this.eventPublisher.publish(new AiBeforeGenerateTextEvent({
             requestId,
@@ -48,8 +54,9 @@ class AiImpl {
         }
     }
     async streamText(params) {
-        const { model, connection, ...rest } = params;
-        const resolvedModel = await this.resolveLanguageModel(model, connection);
+        const { model, connection, ...options } = params;
+        const { languageModel: resolvedModel, model: catalogModel } = await this.resolveLanguageModel(model, connection);
+        const rest = withSupportedOptions(options, catalogModel);
         await this.eventPublisher.publish(new AiBeforeStreamTextEvent({
             params
         }));
@@ -82,11 +89,14 @@ class AiImpl {
         const providerId = modelId.slice(0, slashIndex);
         const rawModelId = modelId.slice(slashIndex + 1);
         const models = await this.modelRegistry.listModels();
-        const found = models.some((m)=>m.providerId === providerId && m.modelId === rawModelId);
+        const found = models.find((m)=>m.providerId === providerId && m.modelId === rawModelId);
         if (!found) throw new Error(`Model "${modelId}" is not available. Use listModels() to see available models.`);
         const conn = await this.resolveConnection(providerId, connection);
         const sdk = await this.getSdk(conn);
-        return sdk.languageModel(rawModelId);
+        return {
+            languageModel: sdk.languageModel(rawModelId),
+            model: found
+        };
     }
     async getConnections() {
         if (!this.resolvedConnections) this.resolvedConnections = await Promise.all(this.connectionFactories.map((f)=>f.execute()));

package/features/ai/Ai.js.map

@@ -1 +1 @@
-{"version":3,"file":"features/ai/Ai.js","sources":["../../../src/features/ai/Ai.ts"],"sourcesContent":["import { createImplementation } from \"@webiny/feature/api\";\nimport { generateText } from \"ai\";\nimport { streamText } from \"ai\";\nimport { Ai as AiAbstraction } from \"./abstractions.js\";\nimport { AiSdkFactory } from \"./abstractions.js\";\nimport { AiConnectionFactory } from \"./abstractions.js\";\nimport { AiModelRegistry } from \"./abstractions.js\";\nimport type { AiGenerateTextParams, AiModel } from \"./abstractions.js\";\nimport type { AiStreamTextParams } from \"./abstractions.js\";\nimport type { IAiSdk } from \"./abstractions.js\";\nimport type { IAiConnection } from \"./abstractions.js\";\nimport type { IAiConnectionInline } from \"./abstractions.js\";\nimport type { LanguageModel } from \"ai\";\nimport { mdbid } from \"@webiny/utils/mdbid.js\";\nimport { EventPublisher } from \"~/features/eventPublisher/index.js\";\nimport {\n    AiBeforeGenerateTextEvent,\n    AiAfterGenerateTextEvent,\n    AiGenerateTextErrorEvent,\n    AiBeforeStreamTextEvent\n} from \"./events.js\";\n\nclass AiImpl implements AiAbstraction.Interface {\n    private sdkCache = new Map<string, IAiSdk>();\n    private resolvedConnections: IAiConnection[] | null = null;\n\n    constructor(\n        private readonly sdkFactories: AiSdkFactory.Interface[],\n        private readonly connectionFactories: AiConnectionFactory.Interface[],\n        private readonly eventPublisher: EventPublisher.Interface,\n        private readonly modelRegistry: AiModelRegistry.Interface\n    ) {}\n\n    async generateText(params: AiGenerateTextParams): ReturnType<typeof generateText> {\n        const { model, connection, ...rest } = params;\n        const resolvedModel = await this.resolveLanguageModel(model, connection);\n        const requestId = mdbid();\n\n        await this.eventPublisher.publish(new AiBeforeGenerateTextEvent({ requestId, params }));\n\n        const start = performance.now();\n\n        try {\n            const result = await generateText({ model: resolvedModel, ...rest } as Parameters<\n                typeof generateText\n            >[0]);\n\n            const duration = performance.now() - start;\n\n            await this.eventPublisher.publish(\n                new AiAfterGenerateTextEvent({ requestId, params, result, duration })\n            );\n\n            return result;\n        } catch (err) {\n            const duration = performance.now() - start;\n            const error = err instanceof Error ? err : new Error(String(err));\n\n            await this.eventPublisher.publish(\n                new AiGenerateTextErrorEvent({ requestId, params, error, duration })\n            );\n\n            throw err;\n        }\n    }\n\n    async streamText(params: AiStreamTextParams): Promise<ReturnType<typeof streamText>> {\n        const { model, connection, ...rest } = params;\n        const resolvedModel = await this.resolveLanguageModel(model, connection);\n\n        await this.eventPublisher.publish(new AiBeforeStreamTextEvent({ params }));\n\n        // Cast required: spreading the discriminated Prompt union loses its narrowing.\n        return streamText({ model: resolvedModel, ...rest } as Parameters<typeof streamText>[0]);\n    }\n\n    listModels(): Promise<AiModel[]> {\n        return this.modelRegistry.listModels();\n    }\n\n    async listModelsByConnections(): Promise<AiModel[]> {\n        const [connections, models] = await Promise.all([\n            this.getConnections(),\n            this.modelRegistry.listModels()\n        ]);\n        const connectedProviderIds = new Set(connections.map(c => c.sdkName));\n        return models.filter(m => connectedProviderIds.has(m.providerId));\n    }\n\n    async listModelsByConnection(connection: string | IAiConnectionInline): Promise<AiModel[]> {\n        const [conn, models] = await Promise.all([\n            this.resolveConnection(undefined, connection),\n            this.modelRegistry.listModels()\n        ]);\n        return models.filter(m => m.providerId === conn.sdkName);\n    }\n\n    private async resolveLanguageModel(\n        modelId: string,\n        connection?: string | IAiConnectionInline\n    ): Promise<LanguageModel> {\n        const slashIndex = modelId.indexOf(\"/\");\n        if (slashIndex === -1) {\n            throw new Error(\n                `Invalid model ID \"${modelId}\". Expected format: \"<providerId>/<modelId>\" (e.g. \"openai/gpt-4o\").`\n            );\n        }\n\n        const providerId = modelId.slice(0, slashIndex);\n        const rawModelId = modelId.slice(slashIndex + 1);\n\n        const models = await this.modelRegistry.listModels();\n        const found = models.some(m => m.providerId === providerId && m.modelId === rawModelId);\n        if (!found) {\n            throw new Error(\n                `Model \"${modelId}\" is not available. Use listModels() to see available models.`\n            );\n        }\n\n        const conn = await this.resolveConnection(providerId, connection);\n        const sdk = await this.getSdk(conn);\n        return sdk.languageModel(rawModelId);\n    }\n\n    private async getConnections(): Promise<IAiConnection[]> {\n        if (!this.resolvedConnections) {\n            this.resolvedConnections = await Promise.all(\n                this.connectionFactories.map(f => f.execute())\n            );\n        }\n        return this.resolvedConnections;\n    }\n\n    private async resolveConnection(\n        providerId: string | undefined,\n        connection?: string | IAiConnectionInline\n    ): Promise<IAiConnectionInline> {\n        if (typeof connection === \"object\") {\n            return connection;\n        }\n\n        const connections = await this.getConnections();\n\n        if (typeof connection === \"string\") {\n            const found = connections.find(c => c.id === connection);\n            if (!found) {\n                const known = connections.map(c => `\"${c.id}\"`).join(\", \");\n                throw new Error(\n                    `Unknown AI connection \"${connection}\". Registered connections: ${known}.`\n                );\n            }\n            return found;\n        }\n\n        const found = connections.find(c => c.sdkName === providerId);\n        if (!found) {\n            const known = connections.map(c => `\"${c.id}\" (${c.sdkName})`).join(\", \");\n            throw new Error(\n                `No AI connection found for provider \"${providerId}\". Registered connections: ${known}.`\n            );\n        }\n        return found;\n    }\n\n    private async getSdk(connection: IAiConnectionInline): Promise<IAiSdk> {\n        const cacheKey =\n            \"id\" in connection\n                ? (connection as IAiConnection).id\n                : `${connection.sdkName}:${connection.apiKey ?? \"__env__\"}`;\n\n        const cached = this.sdkCache.get(cacheKey);\n        if (cached) {\n            return cached;\n        }\n\n        const factory = this.sdkFactories.find(f => f.id === connection.sdkName);\n        if (!factory) {\n            const known = this.sdkFactories.map(f => `\"${f.id}\"`).join(\", \");\n            throw new Error(\n                `No AI SDK factory found for \"${connection.sdkName}\". Registered factories: ${known}.`\n            );\n        }\n\n        const sdk = await factory.execute(connection.apiKey);\n        this.sdkCache.set(cacheKey, sdk);\n        return sdk;\n    }\n}\n\nexport const Ai = createImplementation({\n    abstraction: AiAbstraction,\n    implementation: AiImpl,\n    dependencies: [\n        [AiSdkFactory, { multiple: true }],\n        [AiConnectionFactory, { multiple: true }],\n        EventPublisher,\n        AiModelRegistry\n    ]\n});\n"],"names":["AiImpl","sdkFactories","connectionFactories","eventPublisher","modelRegistry","Map","params","model","connection","rest","resolvedModel","requestId","mdbid","AiBeforeGenerateTextEvent","start","performance","result","generateText","duration","AiAfterGenerateTextEvent","err","error","Error","String","AiGenerateTextErrorEvent","AiBeforeStreamTextEvent","streamText","connections","models","Promise","connectedProviderIds","Set","c","m","conn","undefined","modelId","slashIndex","providerId","rawModelId","found","sdk","f","known","cacheKey","cached","factory","Ai","createImplementation","AiAbstraction","AiSdkFactory","AiConnectionFactory","EventPublisher","AiModelRegistry"],"mappings":"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"}
+{"version":3,"file":"features/ai/Ai.js","sources":["../../../src/features/ai/Ai.ts"],"sourcesContent":["import { createImplementation } from \"@webiny/feature/api\";\nimport { generateText } from \"ai\";\nimport { streamText } from \"ai\";\nimport { Ai as AiAbstraction } from \"./abstractions.js\";\nimport { AiSdkFactory } from \"./abstractions.js\";\nimport { AiConnectionFactory } from \"./abstractions.js\";\nimport { AiModelRegistry } from \"./abstractions.js\";\nimport type { AiGenerateTextParams, AiModel } from \"./abstractions.js\";\nimport type { AiStreamTextParams } from \"./abstractions.js\";\nimport type { IAiSdk } from \"./abstractions.js\";\nimport type { IAiConnection } from \"./abstractions.js\";\nimport type { IAiConnectionInline } from \"./abstractions.js\";\nimport type { LanguageModel } from \"ai\";\nimport { mdbid } from \"@webiny/utils/mdbid.js\";\nimport { EventPublisher } from \"~/features/eventPublisher/index.js\";\nimport {\n    AiBeforeGenerateTextEvent,\n    AiAfterGenerateTextEvent,\n    AiGenerateTextErrorEvent,\n    AiBeforeStreamTextEvent\n} from \"./events.js\";\n\n/**\n * Drops call options the model doesn't accept. Several current models reject `temperature` outright\n * (a 400, not a warning), so it is only sent when the catalog says the model supports it. No\n * information counts as unsupported: leaving it out costs some determinism, sending it can fail the\n * whole request.\n */\nconst withSupportedOptions = <T extends { temperature?: number }>(\n    options: T,\n    model: AiModel\n): T => {\n    if (options.temperature === undefined || model.supports?.temperature === true) {\n        return options;\n    }\n    const { temperature: _temperature, ...rest } = options;\n    return rest as T;\n};\n\nclass AiImpl implements AiAbstraction.Interface {\n    private sdkCache = new Map<string, IAiSdk>();\n    private resolvedConnections: IAiConnection[] | null = null;\n\n    constructor(\n        private readonly sdkFactories: AiSdkFactory.Interface[],\n        private readonly connectionFactories: AiConnectionFactory.Interface[],\n        private readonly eventPublisher: EventPublisher.Interface,\n        private readonly modelRegistry: AiModelRegistry.Interface\n    ) {}\n\n    async generateText(params: AiGenerateTextParams): ReturnType<typeof generateText> {\n        const { model, connection, ...options } = params;\n        const { languageModel: resolvedModel, model: catalogModel } =\n            await this.resolveLanguageModel(model, connection);\n        const rest = withSupportedOptions(options, catalogModel);\n        const requestId = mdbid();\n\n        await this.eventPublisher.publish(new AiBeforeGenerateTextEvent({ requestId, params }));\n\n        const start = performance.now();\n\n        try {\n            const result = await generateText({ model: resolvedModel, ...rest } as Parameters<\n                typeof generateText\n            >[0]);\n\n            const duration = performance.now() - start;\n\n            await this.eventPublisher.publish(\n                new AiAfterGenerateTextEvent({ requestId, params, result, duration })\n            );\n\n            return result;\n        } catch (err) {\n            const duration = performance.now() - start;\n            const error = err instanceof Error ? err : new Error(String(err));\n\n            await this.eventPublisher.publish(\n                new AiGenerateTextErrorEvent({ requestId, params, error, duration })\n            );\n\n            throw err;\n        }\n    }\n\n    async streamText(params: AiStreamTextParams): Promise<ReturnType<typeof streamText>> {\n        const { model, connection, ...options } = params;\n        const { languageModel: resolvedModel, model: catalogModel } =\n            await this.resolveLanguageModel(model, connection);\n        const rest = withSupportedOptions(options, catalogModel);\n\n        await this.eventPublisher.publish(new AiBeforeStreamTextEvent({ params }));\n\n        // Cast required: spreading the discriminated Prompt union loses its narrowing.\n        return streamText({ model: resolvedModel, ...rest } as Parameters<typeof streamText>[0]);\n    }\n\n    listModels(): Promise<AiModel[]> {\n        return this.modelRegistry.listModels();\n    }\n\n    async listModelsByConnections(): Promise<AiModel[]> {\n        const [connections, models] = await Promise.all([\n            this.getConnections(),\n            this.modelRegistry.listModels()\n        ]);\n        const connectedProviderIds = new Set(connections.map(c => c.sdkName));\n        return models.filter(m => connectedProviderIds.has(m.providerId));\n    }\n\n    async listModelsByConnection(connection: string | IAiConnectionInline): Promise<AiModel[]> {\n        const [conn, models] = await Promise.all([\n            this.resolveConnection(undefined, connection),\n            this.modelRegistry.listModels()\n        ]);\n        return models.filter(m => m.providerId === conn.sdkName);\n    }\n\n    private async resolveLanguageModel(\n        modelId: string,\n        connection?: string | IAiConnectionInline\n    ): Promise<{ languageModel: LanguageModel; model: AiModel }> {\n        const slashIndex = modelId.indexOf(\"/\");\n        if (slashIndex === -1) {\n            throw new Error(\n                `Invalid model ID \"${modelId}\". Expected format: \"<providerId>/<modelId>\" (e.g. \"openai/gpt-4o\").`\n            );\n        }\n\n        const providerId = modelId.slice(0, slashIndex);\n        const rawModelId = modelId.slice(slashIndex + 1);\n\n        const models = await this.modelRegistry.listModels();\n        const found = models.find(m => m.providerId === providerId && m.modelId === rawModelId);\n        if (!found) {\n            throw new Error(\n                `Model \"${modelId}\" is not available. Use listModels() to see available models.`\n            );\n        }\n\n        const conn = await this.resolveConnection(providerId, connection);\n        const sdk = await this.getSdk(conn);\n        return { languageModel: sdk.languageModel(rawModelId), model: found };\n    }\n\n    private async getConnections(): Promise<IAiConnection[]> {\n        if (!this.resolvedConnections) {\n            this.resolvedConnections = await Promise.all(\n                this.connectionFactories.map(f => f.execute())\n            );\n        }\n        return this.resolvedConnections;\n    }\n\n    private async resolveConnection(\n        providerId: string | undefined,\n        connection?: string | IAiConnectionInline\n    ): Promise<IAiConnectionInline> {\n        if (typeof connection === \"object\") {\n            return connection;\n        }\n\n        const connections = await this.getConnections();\n\n        if (typeof connection === \"string\") {\n            const found = connections.find(c => c.id === connection);\n            if (!found) {\n                const known = connections.map(c => `\"${c.id}\"`).join(\", \");\n                throw new Error(\n                    `Unknown AI connection \"${connection}\". Registered connections: ${known}.`\n                );\n            }\n            return found;\n        }\n\n        const found = connections.find(c => c.sdkName === providerId);\n        if (!found) {\n            const known = connections.map(c => `\"${c.id}\" (${c.sdkName})`).join(\", \");\n            throw new Error(\n                `No AI connection found for provider \"${providerId}\". Registered connections: ${known}.`\n            );\n        }\n        return found;\n    }\n\n    private async getSdk(connection: IAiConnectionInline): Promise<IAiSdk> {\n        const cacheKey =\n            \"id\" in connection\n                ? (connection as IAiConnection).id\n                : `${connection.sdkName}:${connection.apiKey ?? \"__env__\"}`;\n\n        const cached = this.sdkCache.get(cacheKey);\n        if (cached) {\n            return cached;\n        }\n\n        const factory = this.sdkFactories.find(f => f.id === connection.sdkName);\n        if (!factory) {\n            const known = this.sdkFactories.map(f => `\"${f.id}\"`).join(\", \");\n            throw new Error(\n                `No AI SDK factory found for \"${connection.sdkName}\". Registered factories: ${known}.`\n            );\n        }\n\n        const sdk = await factory.execute(connection.apiKey);\n        this.sdkCache.set(cacheKey, sdk);\n        return sdk;\n    }\n}\n\nexport const Ai = createImplementation({\n    abstraction: AiAbstraction,\n    implementation: AiImpl,\n    dependencies: [\n        [AiSdkFactory, { multiple: true }],\n        [AiConnectionFactory, { multiple: true }],\n        EventPublisher,\n        AiModelRegistry\n    ]\n});\n"],"names":["withSupportedOptions","options","model","undefined","_temperature","rest","AiImpl","sdkFactories","connectionFactories","eventPublisher","modelRegistry","Map","params","connection","resolvedModel","catalogModel","requestId","mdbid","AiBeforeGenerateTextEvent","start","performance","result","generateText","duration","AiAfterGenerateTextEvent","err","error","Error","String","AiGenerateTextErrorEvent","AiBeforeStreamTextEvent","streamText","connections","models","Promise","connectedProviderIds","Set","c","m","conn","modelId","slashIndex","providerId","rawModelId","found","sdk","f","known","cacheKey","cached","factory","Ai","createImplementation","AiAbstraction","AiSdkFactory","AiConnectionFactory","EventPublisher","AiModelRegistry"],"mappings":"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"}

package/features/ai/AiModelRegistry.d.ts

@@ -1,9 +1,11 @@
 import { AiModelRegistry as AiModelRegistryAbstraction } from "./abstractions.js";
 import { AiSdkFactory } from "./abstractions.js";
+import { AiModelCatalog } from "./abstractions.js";
 import type { AiModel } from "./abstractions.js";
 declare class AiModelRegistryImpl implements AiModelRegistryAbstraction.Interface {
     private readonly sdkFactories;
-    constructor(sdkFactories: AiSdkFactory.Interface[]);
+    private readonly catalog;
+    constructor(sdkFactories: AiSdkFactory.Interface[], catalog: AiModelCatalog.Interface);
     listModels(): Promise<AiModel[]>;
 }
 export declare const AiModelRegistry: typeof AiModelRegistryImpl & {

package/features/ai/AiModelRegistry.js

@@ -1,17 +1,25 @@
-import { AiModelRegistry, AiSdkFactory } from "./abstractions.js";
+import { AiModelCatalog, AiModelRegistry, AiSdkFactory } from "./abstractions.js";
 class AiModelRegistryImpl {
-    constructor(sdkFactories){
+    constructor(sdkFactories, catalog){
         this.sdkFactories = sdkFactories;
+        this.catalog = catalog;
     }
     async listModels() {
-        return this.sdkFactories.flatMap((factory)=>factory.models.map((m)=>({
+        const providers = await this.catalog.listProviders();
+        return this.sdkFactories.flatMap((factory)=>{
+            const provider = providers?.find((p)=>p.id === factory.id);
+            const providerName = provider?.name ?? factory.name;
+            const models = provider?.models ?? factory.models;
+            return models.map((m)=>({
                     providerId: factory.id,
-                    providerName: factory.name,
+                    providerName,
                     modelId: m.id,
                     modelName: m.name,
                     deprecated: m.deprecated,
-                    endOfLife: m.endOfLife
-                })));
+                    endOfLife: m.endOfLife,
+                    supports: m.supports
+                }));
+        });
     }
 }
 const AiModelRegistry_AiModelRegistry = AiModelRegistry.createImplementation({
@@ -22,7 +30,8 @@ const AiModelRegistry_AiModelRegistry = AiModelRegistry.createImplementation({
             {
                 multiple: true
             }
-        ]
+        ],
+        AiModelCatalog
     ]
 });
 export { AiModelRegistry_AiModelRegistry as AiModelRegistry };

package/features/ai/AiModelRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"features/ai/AiModelRegistry.js","sources":["../../../src/features/ai/AiModelRegistry.ts"],"sourcesContent":["import { AiModelRegistry as AiModelRegistryAbstraction } from \"./abstractions.js\";\nimport { AiSdkFactory } from \"./abstractions.js\";\nimport type { AiModel } from \"./abstractions.js\";\n\nclass AiModelRegistryImpl implements AiModelRegistryAbstraction.Interface {\n    constructor(private readonly sdkFactories: AiSdkFactory.Interface[]) {}\n\n    async listModels(): Promise<AiModel[]> {\n        return this.sdkFactories.flatMap(factory =>\n            factory.models.map(m => ({\n                providerId: factory.id,\n                providerName: factory.name,\n                modelId: m.id,\n                modelName: m.name,\n                deprecated: m.deprecated,\n                endOfLife: m.endOfLife\n            }))\n        );\n    }\n}\n\nexport const AiModelRegistry = AiModelRegistryAbstraction.createImplementation({\n    implementation: AiModelRegistryImpl,\n    dependencies: [[AiSdkFactory, { multiple: true }]]\n});\n"],"names":["AiModelRegistryImpl","sdkFactories","factory","m","AiModelRegistry","AiModelRegistryAbstraction","AiSdkFactory"],"mappings":";AAIA,MAAMA;IACF,YAA6BC,YAAsC,CAAE;aAAxCA,YAAY,GAAZA;IAAyC;IAEtE,MAAM,aAAiC;QACnC,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,CAACC,CAAAA,UAC7BA,QAAQ,MAAM,CAAC,GAAG,CAACC,CAAAA,IAAM;oBACrB,YAAYD,QAAQ,EAAE;oBACtB,cAAcA,QAAQ,IAAI;oBAC1B,SAASC,EAAE,EAAE;oBACb,WAAWA,EAAE,IAAI;oBACjB,YAAYA,EAAE,UAAU;oBACxB,WAAWA,EAAE,SAAS;gBAC1B;IAER;AACJ;AAEO,MAAMC,kCAAkBC,gBAAAA,oBAA+C,CAAC;IAC3E,gBAAgBL;IAChB,cAAc;QAAC;YAACM;YAAc;gBAAE,UAAU;YAAK;SAAE;KAAC;AACtD"}
+{"version":3,"file":"features/ai/AiModelRegistry.js","sources":["../../../src/features/ai/AiModelRegistry.ts"],"sourcesContent":["import { AiModelRegistry as AiModelRegistryAbstraction } from \"./abstractions.js\";\nimport { AiSdkFactory } from \"./abstractions.js\";\nimport { AiModelCatalog } from \"./abstractions.js\";\nimport type { AiModel } from \"./abstractions.js\";\n\nclass AiModelRegistryImpl implements AiModelRegistryAbstraction.Interface {\n    constructor(\n        private readonly sdkFactories: AiSdkFactory.Interface[],\n        private readonly catalog: AiModelCatalog.Interface\n    ) {}\n\n    async listModels(): Promise<AiModel[]> {\n        const providers = await this.catalog.listProviders();\n\n        /*\n         * A provider is only offered when an SDK factory can serve it. The catalog decides its\n         * models; a factory the catalog doesn't know (a custom SDK), or an unreachable catalog,\n         * falls back to the factory's own list.\n         */\n        return this.sdkFactories.flatMap(factory => {\n            const provider = providers?.find(p => p.id === factory.id);\n            const providerName = provider?.name ?? factory.name;\n            const models = provider?.models ?? factory.models;\n\n            return models.map(m => ({\n                providerId: factory.id,\n                providerName,\n                modelId: m.id,\n                modelName: m.name,\n                deprecated: m.deprecated,\n                endOfLife: m.endOfLife,\n                supports: m.supports\n            }));\n        });\n    }\n}\n\nexport const AiModelRegistry = AiModelRegistryAbstraction.createImplementation({\n    implementation: AiModelRegistryImpl,\n    dependencies: [[AiSdkFactory, { multiple: true }], AiModelCatalog]\n});\n"],"names":["AiModelRegistryImpl","sdkFactories","catalog","providers","factory","provider","p","providerName","models","m","AiModelRegistry","AiModelRegistryAbstraction","AiSdkFactory","AiModelCatalog"],"mappings":";AAKA,MAAMA;IACF,YACqBC,YAAsC,EACtCC,OAAiC,CACpD;aAFmBD,YAAY,GAAZA;aACAC,OAAO,GAAPA;IAClB;IAEH,MAAM,aAAiC;QACnC,MAAMC,YAAY,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa;QAOlD,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,CAACC,CAAAA;YAC7B,MAAMC,WAAWF,WAAW,KAAKG,CAAAA,IAAKA,EAAE,EAAE,KAAKF,QAAQ,EAAE;YACzD,MAAMG,eAAeF,UAAU,QAAQD,QAAQ,IAAI;YACnD,MAAMI,SAASH,UAAU,UAAUD,QAAQ,MAAM;YAEjD,OAAOI,OAAO,GAAG,CAACC,CAAAA,IAAM;oBACpB,YAAYL,QAAQ,EAAE;oBACtBG;oBACA,SAASE,EAAE,EAAE;oBACb,WAAWA,EAAE,IAAI;oBACjB,YAAYA,EAAE,UAAU;oBACxB,WAAWA,EAAE,SAAS;oBACtB,UAAUA,EAAE,QAAQ;gBACxB;QACJ;IACJ;AACJ;AAEO,MAAMC,kCAAkBC,gBAAAA,oBAA+C,CAAC;IAC3E,gBAAgBX;IAChB,cAAc;QAAC;YAACY;YAAc;gBAAE,UAAU;YAAK;SAAE;QAAEC;KAAe;AACtE"}

package/features/ai/DEVELOPERS.md

@@ -1,10 +1,49 @@
 # AI Models
 
-This directory contains the AI SDK factory implementations that define which models are available in Webiny's AI Powerups.
+This directory contains the AI SDK factory implementations that serve the models available in Webiny's AI Powerups.
+
+## Where the model list comes from
+
+`AiModelRegistry` takes the published catalog at `https://api.webiny.com/ai/models` (`RemoteAiModelCatalog`, overridable through `WCP_API_URL`) and intersects it with the registered SDK factories:
+
+- A catalog provider with no SDK factory is not offered. The SDK factory is the last gate.
+- For a provider that has a factory, the catalog's models and names replace the factory's own list.
+- A factory the catalog doesn't know (a custom SDK) keeps its own `models`.
+- If the catalog can't be loaded (timeout, error status, invalid body), every factory falls back to its own `models`.
+
+The catalog is cached for an hour per process. A failed load is retried after a minute. The first AI call on a cold Lambda waits for the fetch. If the catalog doesn't answer within 3 seconds, the fetch is aborted and the factories' own lists are used.
+
+So adding or deprecating a model for an existing provider is a catalog change and needs no release. The `*_MODELS` arrays below are the offline fallback; keep them roughly in sync.
+
+The catalog response looks like this. Dates are ISO strings. `supports` is kept (`tools`, `vision`, `temperature`), and fields the schema doesn't know (`api`, other `supports` keys, ...) are dropped:
+
+```json
+{
+  "providers": [
+    {
+      "id": "openai",
+      "name": "OpenAI",
+      "models": [
+        {
+          "id": "o3",
+          "name": "o3",
+          "deprecated": "2026-06-11",
+          "endOfLife": "2026-12-11",
+          "supports": { "tools": true, "vision": true, "temperature": false }
+        }
+      ]
+    }
+  ]
+}
+```
+
+A response that doesn't match the schema counts as a failed load, so one bad entry drops the whole catalog and every factory falls back to its own list.
+
+`Ai.generateText()` and `Ai.streamText()` send `temperature` only to a model whose `supports.temperature` is `true`. A model that says `false`, or says nothing (no `supports`, or a factory's fallback list), gets the call without it. Several current models reject `temperature` with a 400, so callers can always pass it and leave the decision to `Ai`.
 
 ## Selection criteria
 
-Every model listed in a factory **must** support:
+Every model in the catalog or in a factory **must** support:
 
 - **Tool/function calling** — AI Powerups relies on tools for structured output (content generation, entry comparison, image enrichment, etc.). Models without tool support will break these features at runtime.
 - **Chat/text generation** — only conversational models are listed; embedding, image-generation, TTS, and other specialized models are excluded.
@@ -21,7 +60,7 @@ Each model entry in `IAiSdkModel` supports two optional `Date` fields:
 
 Set these fields when the provider announces deprecation or end-of-life dates. The UI can use them to warn users about upcoming shutdowns or steer them toward replacements.
 
-When a model reaches its `endOfLife` date, remove it from the factory in the next release — keeping it would cause runtime failures.
+When a model reaches its `endOfLife` date, remove it from the catalog, which takes effect within an hour. Remove it from the factory in the next release too, or deployments that can't reach the catalog will keep offering a model that no longer works.
 
 ## Providers
 
@@ -100,27 +139,45 @@ Env var fallback: `WEBINY_API_GOOGLE_API_KEY`.
 
 Source: https://ai.google.dev/gemini-api/docs/deprecations
 
+### OpenRouter (`OpenRouterSdkFactory.ts`)
+
+OpenRouter is a gateway: one key reaches models from many vendors. Its model ids carry the vendor, so a stored model looks like `openrouter/anthropic/claude-sonnet-5.5`. `Ai` splits on the first slash, so the provider is `openrouter` and the rest goes to OpenRouter unchanged.
+
+The factory list is a short pick of each vendor's current models that support tool calling, not OpenRouter's whole catalog (a few hundred models, many without tools). Pick from `https://openrouter.ai/api/v1/models`, keeping entries whose `supported_parameters` includes `tools` and skipping the `:free` and `:batch` variants. OpenRouter publishes retirement dates as `expiration_date`; leave out models that have one coming up.
+
+`openrouter/auto` is OpenRouter's Auto Router: it picks the model per request, so the vendor that answers can change between calls. It's stored as `openrouter/openrouter/auto`. The catalog marks it as not accepting `temperature`, because some of the models it can pick reject it.
+
+Uses `@openrouter/ai-sdk-provider` rather than `@ai-sdk/openai` with a different base URL, so non-OpenAI models routed through it don't get OpenAI-only request options.
+
+Env var fallback: `WEBINY_API_OPENROUTER_API_KEY`.
+
+Source: https://openrouter.ai/models
+
 ## Adding a new model
 
 1. Verify the model supports tool/function calling.
-2. Add an entry to the `*_MODELS` array in the corresponding factory file. The `id` must match the provider's API model ID exactly.
-3. If the model has known deprecation or end-of-life dates, set `deprecated` and/or `endOfLife` as `new Date("YYYY-MM-DD")`.
-4. Update the table in this file.
+2. Add it to the catalog at `https://api.webiny.com/ai/models`. That is what users see.
+3. Add an entry to the `*_MODELS` array in the corresponding factory file. The `id` must match the provider's API model ID exactly.
+4. If the model has known deprecation or end-of-life dates, set `deprecated` and/or `endOfLife`: ISO strings (`"YYYY-MM-DD"`) in the catalog, `new Date("YYYY-MM-DD")` in the factory.
+5. Update the table in this file.
 
 ## Adding a new provider
 
-1. Create a new `<Provider>SdkFactory.ts` implementing `AiSdkFactory`.
+A new provider needs a release, because the catalog can only offer providers that have an SDK factory.
+
+1. Create a new `<Provider>SdkFactory.ts` implementing `AiSdkFactory`. Its `id` is the key the catalog matches on.
 2. Add the `@ai-sdk/<provider>` dependency via `yarn add` in `packages/api-core`.
 3. Register the factory in `feature.ts`.
-4. Update this file.
+4. Add the provider to the catalog under the same `id`. Until you do, the factory's own `models` are used.
+5. Update this file.
 
 ## Updating models
 
-Check the provider docs periodically and update the lists:
+Check the provider docs periodically and update the catalog first, then the factory lists:
 
 - **New models**: add to the top of the active section.
 - **Deprecated models**: set `deprecated` and `endOfLife` dates, move to the bottom of the array.
-- **End-of-life reached**: remove from the factory. Keeping a dead model causes runtime failures.
-- **Never remove a model before its end-of-life date** — users may have presets referencing it, and removing it breaks `ProvidersHandler` validation on save.
+- **End-of-life reached**: remove from the catalog and the factory. Keeping a dead model causes runtime failures.
+- **Never remove a model before its end-of-life date** — users may have presets referencing it, and removing it breaks `ProvidersHandler` validation on save. This matters more for the catalog than for the factory: `Ai` rejects any model the registry doesn't list, so dropping a model from the catalog breaks calls that use it in every deployment within the hour.
 
-Last updated: September 2026.
+Last updated: October 2026.

package/features/ai/OpenRouterSdkFactory.d.ts

@@ -0,0 +1,10 @@
+import { AiSdkFactory as AiSdkFactoryAbstraction } from "./abstractions.js";
+import type { IAiSdk, IAiSdkModel } from "./abstractions.js";
+declare class OpenRouterSdkFactoryImpl implements AiSdkFactoryAbstraction.Interface {
+    readonly id = "openrouter";
+    readonly name = "OpenRouter";
+    readonly models: IAiSdkModel[];
+    execute(apiKey?: string): Promise<IAiSdk>;
+}
+export declare const OpenRouterSdkFactory: import("@webiny/di").Implementation<typeof OpenRouterSdkFactoryImpl>;
+export {};

package/features/ai/OpenRouterSdkFactory.js

@@ -0,0 +1,112 @@
+import { createImplementation } from "@webiny/feature/api";
+import { AiSdkFactory } from "./abstractions.js";
+const OPENROUTER_MODELS = [
+    {
+        id: "openrouter/auto",
+        name: "OpenRouter: Auto Router"
+    },
+    {
+        id: "mistralai/mistral-large-4-0",
+        name: "Mistral: Mistral Large 4"
+    },
+    {
+        id: "openai/gpt-6.1-sol",
+        name: "OpenAI: GPT-6.1 Sol"
+    },
+    {
+        id: "anthropic/claude-sonnet-5.5",
+        name: "Anthropic: Claude Sonnet 5.5"
+    },
+    {
+        id: "qwen/qwen3.8-max-prime",
+        name: "Qwen: Qwen3.8 Max Prime"
+    },
+    {
+        id: "z-ai/glm-5.3-prime",
+        name: "Z.ai: GLM 5.3 Prime"
+    },
+    {
+        id: "openai/gpt-6-sol",
+        name: "OpenAI: GPT-6 Sol"
+    },
+    {
+        id: "openai/gpt-6-luna",
+        name: "OpenAI: GPT-6 Luna"
+    },
+    {
+        id: "anthropic/claude-opus-5.5",
+        name: "Anthropic: Claude Opus 5.5"
+    },
+    {
+        id: "x-ai/grok-4.7",
+        name: "SpaceXAI: Grok 4.7"
+    },
+    {
+        id: "deepseek/deepseek-v4.1-flash",
+        name: "DeepSeek: DeepSeek V4.1 Flash"
+    },
+    {
+        id: "openai/gpt-6-astra",
+        name: "OpenAI: GPT-6 Astra"
+    },
+    {
+        id: "google/gemini-3.8-flash",
+        name: "Google: Gemini 3.8 Flash"
+    },
+    {
+        id: "anthropic/claude-fable-5.1",
+        name: "Anthropic: Claude Fable 5.1"
+    },
+    {
+        id: "anthropic/claude-opus-5",
+        name: "Anthropic: Claude Opus 5"
+    },
+    {
+        id: "google/gemini-3.5-flash-lite",
+        name: "Google: Gemini 3.5 Flash Lite"
+    },
+    {
+        id: "moonshotai/kimi-k3",
+        name: "MoonshotAI: Kimi K3"
+    },
+    {
+        id: "openai/gpt-5.6-terra",
+        name: "OpenAI: GPT-5.6 Terra"
+    },
+    {
+        id: "anthropic/claude-sonnet-5",
+        name: "Anthropic: Claude Sonnet 5"
+    },
+    {
+        id: "openai/gpt-5.4-mini",
+        name: "OpenAI: GPT-5.4 Mini"
+    },
+    {
+        id: "anthropic/claude-haiku-4.5",
+        name: "Anthropic: Claude Haiku 4.5"
+    }
+];
+class OpenRouterSdkFactoryImpl {
+    async execute(apiKey) {
+        const { createOpenRouter } = await import("@openrouter/ai-sdk-provider");
+        const provider = createOpenRouter({
+            apiKey: apiKey ?? process.env.WEBINY_API_OPENROUTER_API_KEY
+        });
+        return {
+            languageModel: (modelId)=>provider.chat(modelId)
+        };
+    }
+    constructor(){
+        this.id = "openrouter";
+        this.name = "OpenRouter";
+        this.models = OPENROUTER_MODELS;
+    }
+}
+const OpenRouterSdkFactory = createImplementation({
+    abstraction: AiSdkFactory,
+    implementation: OpenRouterSdkFactoryImpl,
+    dependencies: []
+});
+export { OpenRouterSdkFactory };
+
+//# sourceMappingURL=OpenRouterSdkFactory.js.map

package/features/ai/OpenRouterSdkFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/ai/OpenRouterSdkFactory.js","sources":["../../../src/features/ai/OpenRouterSdkFactory.ts"],"sourcesContent":["import { createImplementation } from \"@webiny/feature/api\";\nimport { AiSdkFactory as AiSdkFactoryAbstraction } from \"./abstractions.js\";\nimport type { IAiSdk, IAiSdkModel } from \"./abstractions.js\";\n\n/*\n * OpenRouter model ids carry their own vendor prefix, so the composite Webiny id has two slashes:\n * \"openrouter/anthropic/claude-sonnet-5.5\". `Ai` splits on the first slash only, which leaves the\n * OpenRouter id intact.\n */\nconst OPENROUTER_MODELS: IAiSdkModel[] = [\n    // OpenRouter picks the model per request, so which vendor answers can change between calls.\n    { id: \"openrouter/auto\", name: \"OpenRouter: Auto Router\" },\n    { id: \"mistralai/mistral-large-4-0\", name: \"Mistral: Mistral Large 4\" },\n    { id: \"openai/gpt-6.1-sol\", name: \"OpenAI: GPT-6.1 Sol\" },\n    { id: \"anthropic/claude-sonnet-5.5\", name: \"Anthropic: Claude Sonnet 5.5\" },\n    { id: \"qwen/qwen3.8-max-prime\", name: \"Qwen: Qwen3.8 Max Prime\" },\n    { id: \"z-ai/glm-5.3-prime\", name: \"Z.ai: GLM 5.3 Prime\" },\n    { id: \"openai/gpt-6-sol\", name: \"OpenAI: GPT-6 Sol\" },\n    { id: \"openai/gpt-6-luna\", name: \"OpenAI: GPT-6 Luna\" },\n    { id: \"anthropic/claude-opus-5.5\", name: \"Anthropic: Claude Opus 5.5\" },\n    { id: \"x-ai/grok-4.7\", name: \"SpaceXAI: Grok 4.7\" },\n    { id: \"deepseek/deepseek-v4.1-flash\", name: \"DeepSeek: DeepSeek V4.1 Flash\" },\n    { id: \"openai/gpt-6-astra\", name: \"OpenAI: GPT-6 Astra\" },\n    { id: \"google/gemini-3.8-flash\", name: \"Google: Gemini 3.8 Flash\" },\n    { id: \"anthropic/claude-fable-5.1\", name: \"Anthropic: Claude Fable 5.1\" },\n    { id: \"anthropic/claude-opus-5\", name: \"Anthropic: Claude Opus 5\" },\n    { id: \"google/gemini-3.5-flash-lite\", name: \"Google: Gemini 3.5 Flash Lite\" },\n    { id: \"moonshotai/kimi-k3\", name: \"MoonshotAI: Kimi K3\" },\n    { id: \"openai/gpt-5.6-terra\", name: \"OpenAI: GPT-5.6 Terra\" },\n    { id: \"anthropic/claude-sonnet-5\", name: \"Anthropic: Claude Sonnet 5\" },\n    { id: \"openai/gpt-5.4-mini\", name: \"OpenAI: GPT-5.4 Mini\" },\n    { id: \"anthropic/claude-haiku-4.5\", name: \"Anthropic: Claude Haiku 4.5\" }\n];\n\nclass OpenRouterSdkFactoryImpl implements AiSdkFactoryAbstraction.Interface {\n    readonly id = \"openrouter\";\n    readonly name = \"OpenRouter\";\n    readonly models = OPENROUTER_MODELS;\n\n    async execute(apiKey?: string): Promise<IAiSdk> {\n        const { createOpenRouter } = await import(\"@openrouter/ai-sdk-provider\");\n        const provider = createOpenRouter({\n            apiKey: apiKey ?? process.env.WEBINY_API_OPENROUTER_API_KEY\n        });\n        return {\n            languageModel: modelId => provider.chat(modelId)\n        };\n    }\n}\n\nexport const OpenRouterSdkFactory = createImplementation({\n    abstraction: AiSdkFactoryAbstraction,\n    implementation: OpenRouterSdkFactoryImpl,\n    dependencies: []\n});\n"],"names":["OPENROUTER_MODELS","OpenRouterSdkFactoryImpl","apiKey","createOpenRouter","provider","process","modelId","OpenRouterSdkFactory","createImplementation","AiSdkFactoryAbstraction"],"mappings":";;AASA,MAAMA,oBAAmC;IAErC;QAAE,IAAI;QAAmB,MAAM;IAA0B;IACzD;QAAE,IAAI;QAA+B,MAAM;IAA2B;IACtE;QAAE,IAAI;QAAsB,MAAM;IAAsB;IACxD;QAAE,IAAI;QAA+B,MAAM;IAA+B;IAC1E;QAAE,IAAI;QAA0B,MAAM;IAA0B;IAChE;QAAE,IAAI;QAAsB,MAAM;IAAsB;IACxD;QAAE,IAAI;QAAoB,MAAM;IAAoB;IACpD;QAAE,IAAI;QAAqB,MAAM;IAAqB;IACtD;QAAE,IAAI;QAA6B,MAAM;IAA6B;IACtE;QAAE,IAAI;QAAiB,MAAM;IAAqB;IAClD;QAAE,IAAI;QAAgC,MAAM;IAAgC;IAC5E;QAAE,IAAI;QAAsB,MAAM;IAAsB;IACxD;QAAE,IAAI;QAA2B,MAAM;IAA2B;IAClE;QAAE,IAAI;QAA8B,MAAM;IAA8B;IACxE;QAAE,IAAI;QAA2B,MAAM;IAA2B;IAClE;QAAE,IAAI;QAAgC,MAAM;IAAgC;IAC5E;QAAE,IAAI;QAAsB,MAAM;IAAsB;IACxD;QAAE,IAAI;QAAwB,MAAM;IAAwB;IAC5D;QAAE,IAAI;QAA6B,MAAM;IAA6B;IACtE;QAAE,IAAI;QAAuB,MAAM;IAAuB;IAC1D;QAAE,IAAI;QAA8B,MAAM;IAA8B;CAC3E;AAED,MAAMC;IAKF,MAAM,QAAQC,MAAe,EAAmB;QAC5C,MAAM,EAAEC,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC;QAC1C,MAAMC,WAAWD,iBAAiB;YAC9B,QAAQD,UAAUG,QAAQ,GAAG,CAAC,6BAA6B;QAC/D;QACA,OAAO;YACH,eAAeC,CAAAA,UAAWF,SAAS,IAAI,CAACE;QAC5C;IACJ;;aAZS,EAAE,GAAG;aACL,IAAI,GAAG;aACP,MAAM,GAAGN;;AAWtB;AAEO,MAAMO,uBAAuBC,qBAAqB;IACrD,aAAaC;IACb,gBAAgBR;IAChB,cAAc,EAAE;AACpB"}

package/features/ai/RemoteAiModelCatalog.d.ts

@@ -0,0 +1,13 @@
+import { AiModelCatalog as AiModelCatalogAbstraction } from "./abstractions.js";
+import type { AiCatalogProvider } from "./abstractions.js";
+import { Logger } from "../../features/logger/index.js";
+import { HttpClient } from "../../features/httpClient/index.js";
+declare class RemoteAiModelCatalogImpl implements AiModelCatalogAbstraction.Interface {
+    private readonly httpClient;
+    private readonly logger;
+    constructor(httpClient: HttpClient.Interface, logger: Logger.Interface);
+    listProviders(): Promise<AiCatalogProvider[] | undefined>;
+    private fetchProviders;
+}
+export declare const RemoteAiModelCatalog: import("@webiny/di").Implementation<typeof RemoteAiModelCatalogImpl>;
+export {};

package/features/ai/RemoteAiModelCatalog.js

@@ -0,0 +1,74 @@
+import { z } from "zod";
+import { createImplementation } from "@webiny/feature/api";
+import { getWcpApiUrl } from "@webiny/wcp";
+import { AiModelCatalog } from "./abstractions.js";
+import { Logger } from "../logger/index.js";
+import { HttpClient } from "../httpClient/index.js";
+const FETCH_TIMEOUT_MS = 3000;
+const SUCCESS_TTL_MS = 3600000;
+const FAILURE_TTL_MS = 60000;
+const optionalDate = z.coerce.date().optional();
+const catalogSchema = z.object({
+    providers: z.array(z.object({
+        id: z.string(),
+        name: z.string(),
+        models: z.array(z.object({
+            id: z.string(),
+            name: z.string(),
+            deprecated: optionalDate,
+            endOfLife: optionalDate,
+            supports: z.object({
+                tools: z.boolean().optional(),
+                vision: z.boolean().optional(),
+                temperature: z.boolean().optional()
+            }).optional()
+        }))
+    }))
+});
+let cached;
+class RemoteAiModelCatalogImpl {
+    constructor(httpClient, logger){
+        this.httpClient = httpClient;
+        this.logger = logger;
+    }
+    listProviders() {
+        if (cached && cached.expiresAt > Date.now()) return cached.providers;
+        const entry = {
+            expiresAt: Date.now() + SUCCESS_TTL_MS,
+            providers: this.fetchProviders().then((providers)=>{
+                if (!providers) entry.expiresAt = Date.now() + FAILURE_TTL_MS;
+                return providers;
+            })
+        };
+        cached = entry;
+        return entry.providers;
+    }
+    async fetchProviders() {
+        const url = getWcpApiUrl("/ai/models");
+        const response = await this.httpClient.requestJson({
+            url,
+            timeoutMs: FETCH_TIMEOUT_MS
+        });
+        if (response.isFail()) return void this.logger.warn({
+            url,
+            error: response.error
+        }, "Failed to load AI models.");
+        const result = catalogSchema.safeParse(response.value);
+        if (!result.success) return void this.logger.warn({
+            url,
+            error: result.error
+        }, "Received invalid AI models.");
+        return result.data.providers;
+    }
+}
+const RemoteAiModelCatalog = createImplementation({
+    abstraction: AiModelCatalog,
+    implementation: RemoteAiModelCatalogImpl,
+    dependencies: [
+        HttpClient,
+        Logger
+    ]
+});
+export { RemoteAiModelCatalog };
+
+//# sourceMappingURL=RemoteAiModelCatalog.js.map