@webiny/api-core 6.4.12-beta.4 → 6.5.0-beta.0

package/ApiCoreFeature.js

@@ -8,7 +8,6 @@ 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";
@@ -23,7 +22,6 @@ const ApiCoreFeature = createFeature({
         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 { 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 { 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        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","AiFeature","LoggerFeature","EventPublisherFeature","BuildParamsFeature","DebuggerFeature","EncryptionFeature","FeatureFlagsFeature","TenancyFeature","SecurityFeature","AdminUsersFeature","KeyValueStoreFeature","SystemFeature","IdpAuthenticatorFeature","NullWebhookDispatcher","WebhookProviderFeature"],"mappings":";;;;;;;;;;;;;;;;;AAoBO,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,gBAAgB,QAAQ,CAACP;QACzBQ,kBAAkB,QAAQ,CAACR;QAC3BS,oBAAoB,QAAQ,CAACT;QAC7BU,eAAe,QAAQ,CAACV,WAAWC,OAAO,wBAAwB;QAClEU,gBAAgB,QAAQ,CAACX,WAAWC,OAAO,yBAAyB;QACpEW,kBAAkB,QAAQ,CAACZ,WAAWC,OAAO,sBAAsB;QACnEY,qBAAqB,QAAQ,CAACb,WAAWC,OAAO,yBAAyB;QACzEa,cAAc,QAAQ,CAACd;QACvBe,wBAAwB,QAAQ,CAACf;QACjCA,UAAU,QAAQ,CAACgB,uBAAuB,gBAAgB;QAC1DC,uBAAuB,QAAQ,CAACjB;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 { 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"}

package/createApiCore.d.ts

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

package/createApiCore.js

@@ -5,20 +5,22 @@ 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)=>[
-        createRegisterExtensionPlugin((context)=>{
-            ApiCoreFeature.register(context.container, config.storageOperations);
-        }),
+const createApiCore = (config)=>{
+    const plugin = createRegisterExtensionPlugin((context)=>{
+        ApiCoreFeature.register(context.container, config.storageOperations);
+    });
+    plugin.name = "apiCore.extension";
+    return [
+        plugin,
         createWcpContext({
             testProjectLicense: config.testProjectLicense
         }),
         createTenancyContext(),
         createSecurityContext(),
         createAdminUsersContext(),
-        createSystemGraphQL(),
-        ...createDebuggerPlugins()
+        createSystemGraphQL()
     ];
+};
 export { createApiCore };
 
 //# sourceMappingURL=createApiCore.js.map

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\";\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    return [\n        createRegisterExtensionPlugin(context => {\n            ApiCoreFeature.register(context.container, config.storageOperations);\n        }),\n        createWcpContext({ testProjectLicense: config.testProjectLicense }),\n        createTenancyContext(),\n        createSecurityContext(),\n        createAdminUsersContext(),\n        createSystemGraphQL(),\n        ...createDebuggerPlugins()\n    ];\n};\n"],"names":["createApiCore","config","createRegisterExtensionPlugin","context","ApiCoreFeature","createWcpContext","createTenancyContext","createSecurityContext","createAdminUsersContext","createSystemGraphQL","createDebuggerPlugins"],"mappings":";;;;;;;;AAgBO,MAAMA,gBAAgB,CAACC,SACnB;QACHC,8BAA8BC,CAAAA;YAC1BC,eAAe,QAAQ,CAACD,QAAQ,SAAS,EAAEF,OAAO,iBAAiB;QACvE;QACAI,iBAAiB;YAAE,oBAAoBJ,OAAO,kBAAkB;QAAC;QACjEK;QACAC;QACAC;QACAC;WACGC;KACN"}
+{"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"}

package/exports/api/security/api-key.d.ts

@@ -2,6 +2,7 @@ export { ApiKeyAfterCreateEventHandler, ApiKeyBeforeCreateEventHandler, CreateAp
 export { ApiKeyAfterDeleteEventHandler, ApiKeyBeforeDeleteEventHandler, DeleteApiKeyUseCase } from "../../../features/security/apiKeys/DeleteApiKey/index.js";
 export { GetApiKeyUseCase } from "../../../features/security/apiKeys/GetApiKey/index.js";
 export { GetApiKeyByTokenUseCase } from "../../../features/security/apiKeys/GetApiKeyByToken/index.js";
+export { GetApiKeyBySlugUseCase } from "../../../features/security/apiKeys/GetApiKeyBySlug/index.js";
 export { ListApiKeysUseCase } from "../../../features/security/apiKeys/ListApiKeys/index.js";
 export { ApiKeyAfterUpdateEventHandler, ApiKeyBeforeUpdateEventHandler, UpdateApiKeyUseCase } from "../../../features/security/apiKeys/UpdateApiKey/index.js";
 export { ApiKeyFactory } from "../../../features/security/apiKeys/shared/abstractions.js";

package/exports/api/security/api-key.js

@@ -2,6 +2,7 @@ export { ApiKeyAfterCreateEventHandler, ApiKeyBeforeCreateEventHandler, CreateAp
 export { ApiKeyAfterDeleteEventHandler, ApiKeyBeforeDeleteEventHandler, DeleteApiKeyUseCase } from "../../../features/security/apiKeys/DeleteApiKey/index.js";
 export { GetApiKeyUseCase } from "../../../features/security/apiKeys/GetApiKey/index.js";
 export { GetApiKeyByTokenUseCase } from "../../../features/security/apiKeys/GetApiKeyByToken/index.js";
+export { GetApiKeyBySlugUseCase } from "../../../features/security/apiKeys/GetApiKeyBySlug/index.js";
 export { ListApiKeysUseCase } from "../../../features/security/apiKeys/ListApiKeys/index.js";
 export { ApiKeyAfterUpdateEventHandler, ApiKeyBeforeUpdateEventHandler, UpdateApiKeyUseCase } from "../../../features/security/apiKeys/UpdateApiKey/index.js";
 export { ApiKeyFactory } from "../../../features/security/apiKeys/shared/abstractions.js";

package/exports/api.d.ts

@@ -1,4 +1,5 @@
-export { AiSdk, AiSdkFactory, AiConnectionFactory, Ai, AiModelRegistry } from "../features/ai/index.js";
+export { AiSdk, AiSdkFactory, AiSdkTool, AiConnectionFactory, Ai, AiModelRegistry } from "../features/ai/index.js";
+export type { IAiConnection, IAiConnectionInline } from "../features/ai/index.js";
 export { Logger } from "../features/logger/index.js";
 export { Encryption } from "../features/encryption/index.js";
 export { BuildParam, BuildParams } from "../features/buildParams/index.js";

package/exports/api.js

@@ -1,4 +1,4 @@
-export { Ai, AiConnectionFactory, AiModelRegistry, AiSdk, AiSdkFactory } from "../features/ai/index.js";
+export { Ai, AiConnectionFactory, AiModelRegistry, AiSdk, AiSdkFactory, AiSdkTool } from "../features/ai/index.js";
 export { Logger } from "../features/logger/index.js";
 export { Encryption } from "../features/encryption/index.js";
 export { BuildParam, BuildParams } from "../features/buildParams/index.js";

package/features/ai/Ai.d.ts

@@ -7,13 +7,15 @@ import { AiModelRegistry } from "./abstractions.js";
 import type { AiGenerateTextParams, AiModel } from "./abstractions.js";
 import type { AiStreamTextParams } from "./abstractions.js";
 import type { IAiConnectionInline } from "./abstractions.js";
+import { EventPublisher } from "../../features/eventPublisher/index.js";
 declare class AiImpl implements AiAbstraction.Interface {
     private readonly sdkFactories;
     private readonly connectionFactories;
+    private readonly eventPublisher;
     private readonly modelRegistry;
     private sdkCache;
     private resolvedConnections;
-    constructor(sdkFactories: AiSdkFactory.Interface[], connectionFactories: AiConnectionFactory.Interface[], modelRegistry: AiModelRegistry.Interface);
+    constructor(sdkFactories: AiSdkFactory.Interface[], connectionFactories: AiConnectionFactory.Interface[], eventPublisher: EventPublisher.Interface, modelRegistry: AiModelRegistry.Interface);
     generateText(params: AiGenerateTextParams): ReturnType<typeof generateText>;
     streamText(params: AiStreamTextParams): Promise<ReturnType<typeof streamText>>;
     listModels(): Promise<AiModel[]>;

package/features/ai/Ai.js

@@ -1,24 +1,58 @@
 import { createImplementation } from "@webiny/feature/api";
 import { generateText, streamText } from "ai";
 import { Ai, AiConnectionFactory, AiModelRegistry, AiSdkFactory } from "./abstractions.js";
+import { mdbid } from "@webiny/utils/mdbid.js";
+import { EventPublisher } from "../eventPublisher/index.js";
+import { AiAfterGenerateTextEvent, AiBeforeGenerateTextEvent, AiBeforeStreamTextEvent, AiGenerateTextErrorEvent } from "./events.js";
 class AiImpl {
-    constructor(sdkFactories, connectionFactories, modelRegistry){
+    constructor(sdkFactories, connectionFactories, eventPublisher, modelRegistry){
         this.sdkFactories = sdkFactories;
         this.connectionFactories = connectionFactories;
+        this.eventPublisher = eventPublisher;
         this.modelRegistry = modelRegistry;
         this.sdkCache = new Map();
         this.resolvedConnections = null;
     }
-    generateText(params) {
+    async generateText(params) {
         const { model, connection, ...rest } = params;
-        return this.resolveLanguageModel(model, connection).then((resolvedModel)=>generateText({
+        const resolvedModel = await this.resolveLanguageModel(model, connection);
+        const requestId = mdbid();
+        await this.eventPublisher.publish(new AiBeforeGenerateTextEvent({
+            requestId,
+            params
+        }));
+        const start = performance.now();
+        try {
+            const result = await generateText({
                 model: resolvedModel,
                 ...rest
+            });
+            const duration = performance.now() - start;
+            await this.eventPublisher.publish(new AiAfterGenerateTextEvent({
+                requestId,
+                params,
+                result,
+                duration
+            }));
+            return result;
+        } catch (err) {
+            const duration = performance.now() - start;
+            const error = err instanceof Error ? err : new Error(String(err));
+            await this.eventPublisher.publish(new AiGenerateTextErrorEvent({
+                requestId,
+                params,
+                error,
+                duration
             }));
+            throw err;
+        }
     }
     async streamText(params) {
         const { model, connection, ...rest } = params;
         const resolvedModel = await this.resolveLanguageModel(model, connection);
+        await this.eventPublisher.publish(new AiBeforeStreamTextEvent({
+            params
+        }));
         return streamText({
             model: resolvedModel,
             ...rest
@@ -106,6 +140,7 @@ const Ai_Ai = createImplementation({
                 multiple: true
             }
         ],
+        EventPublisher,
         AiModelRegistry
     ]
 });

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\";\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 modelRegistry: AiModelRegistry.Interface\n    ) {}\n\n    generateText(params: AiGenerateTextParams): ReturnType<typeof generateText> {\n        const { model, connection, ...rest } = params;\n        return this.resolveLanguageModel(model, connection).then(resolvedModel => {\n            // Cast required: spreading the discriminated Prompt union loses its narrowing.\n            return generateText({ model: resolvedModel, ...rest } as Parameters<\n                typeof generateText\n            >[0]);\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        // 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        // Validate the model is in the registry.\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        AiModelRegistry\n    ]\n});\n"],"names":["AiImpl","sdkFactories","connectionFactories","modelRegistry","Map","params","model","connection","rest","resolvedModel","generateText","streamText","connections","models","Promise","connectedProviderIds","Set","c","m","conn","undefined","modelId","slashIndex","Error","providerId","rawModelId","found","sdk","f","known","cacheKey","cached","factory","Ai","createImplementation","AiAbstraction","AiSdkFactory","AiConnectionFactory","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\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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"}

package/features/ai/AiModelRegistry.js

@@ -8,7 +8,9 @@ class AiModelRegistryImpl {
                     providerId: factory.id,
                     providerName: factory.name,
                     modelId: m.id,
-                    modelName: m.name
+                    modelName: m.name,
+                    deprecated: m.deprecated,
+                    endOfLife: m.endOfLife
                 })));
     }
 }

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            }))\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;gBACrB;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 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"}

package/features/ai/AnthropicSdkFactory.js

@@ -1,6 +1,30 @@
 import { createImplementation } from "@webiny/feature/api";
 import { AiSdkFactory } from "./abstractions.js";
 const ANTHROPIC_MODELS = [
+    {
+        id: "claude-fable-5-1",
+        name: "Claude Fable 5.1"
+    },
+    {
+        id: "claude-opus-5",
+        name: "Claude Opus 5"
+    },
+    {
+        id: "claude-sonnet-5",
+        name: "Claude Sonnet 5"
+    },
+    {
+        id: "claude-haiku-4-5",
+        name: "Claude Haiku 4.5"
+    },
+    {
+        id: "claude-fable-5",
+        name: "Claude Fable 5"
+    },
+    {
+        id: "claude-opus-4-8",
+        name: "Claude Opus 4.8"
+    },
     {
         id: "claude-opus-4-7",
         name: "Claude Opus 4.7"
@@ -20,10 +44,6 @@ const ANTHROPIC_MODELS = [
     {
         id: "claude-sonnet-4-5",
         name: "Claude Sonnet 4.5"
-    },
-    {
-        id: "claude-haiku-4-5",
-        name: "Claude Haiku 4.5"
     }
 ];
 class AnthropicSdkFactoryImpl {

package/features/ai/AnthropicSdkFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"features/ai/AnthropicSdkFactory.js","sources":["../../../src/features/ai/AnthropicSdkFactory.ts"],"sourcesContent":["import { createImplementation } from \"@webiny/feature/api\";\nimport { AiSdkFactory as AiSdkFactoryAbstraction } from \"./abstractions.js\";\nimport type { IAiSdk, IAiSdkModel } from \"./abstractions.js\";\n\nconst ANTHROPIC_MODELS: IAiSdkModel[] = [\n    { id: \"claude-opus-4-7\", name: \"Claude Opus 4.7\" },\n    { id: \"claude-opus-4-6\", name: \"Claude Opus 4.6\" },\n    { id: \"claude-opus-4-5\", name: \"Claude Opus 4.5\" },\n    { id: \"claude-sonnet-4-6\", name: \"Claude Sonnet 4.6\" },\n    { id: \"claude-sonnet-4-5\", name: \"Claude Sonnet 4.5\" },\n    { id: \"claude-haiku-4-5\", name: \"Claude Haiku 4.5\" }\n];\n\nclass AnthropicSdkFactoryImpl implements AiSdkFactoryAbstraction.Interface {\n    readonly id = \"anthropic\";\n    readonly name = \"Anthropic\";\n    readonly models = ANTHROPIC_MODELS;\n\n    async execute(apiKey?: string): Promise<IAiSdk> {\n        const { createAnthropic } = await import(\"@ai-sdk/anthropic\");\n        const provider = createAnthropic({\n            apiKey: apiKey ?? process.env.WEBINY_API_ANTHROPIC_API_KEY\n        });\n        return {\n            languageModel: modelId => provider.chat(modelId)\n        };\n    }\n}\n\nexport const AnthropicSdkFactory = createImplementation({\n    abstraction: AiSdkFactoryAbstraction,\n    implementation: AnthropicSdkFactoryImpl,\n    dependencies: []\n});\n"],"names":["ANTHROPIC_MODELS","AnthropicSdkFactoryImpl","apiKey","createAnthropic","provider","process","modelId","AnthropicSdkFactory","createImplementation","AiSdkFactoryAbstraction"],"mappings":";;AAIA,MAAMA,mBAAkC;IACpC;QAAE,IAAI;QAAmB,MAAM;IAAkB;IACjD;QAAE,IAAI;QAAmB,MAAM;IAAkB;IACjD;QAAE,IAAI;QAAmB,MAAM;IAAkB;IACjD;QAAE,IAAI;QAAqB,MAAM;IAAoB;IACrD;QAAE,IAAI;QAAqB,MAAM;IAAoB;IACrD;QAAE,IAAI;QAAoB,MAAM;IAAmB;CACtD;AAED,MAAMC;IAKF,MAAM,QAAQC,MAAe,EAAmB;QAC5C,MAAM,EAAEC,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC;QACzC,MAAMC,WAAWD,gBAAgB;YAC7B,QAAQD,UAAUG,QAAQ,GAAG,CAAC,4BAA4B;QAC9D;QACA,OAAO;YACH,eAAeC,CAAAA,UAAWF,SAAS,IAAI,CAACE;QAC5C;IACJ;;aAZS,EAAE,GAAG;aACL,IAAI,GAAG;aACP,MAAM,GAAGN;;AAWtB;AAEO,MAAMO,sBAAsBC,qBAAqB;IACpD,aAAaC;IACb,gBAAgBR;IAChB,cAAc,EAAE;AACpB"}
+{"version":3,"file":"features/ai/AnthropicSdkFactory.js","sources":["../../../src/features/ai/AnthropicSdkFactory.ts"],"sourcesContent":["import { createImplementation } from \"@webiny/feature/api\";\nimport { AiSdkFactory as AiSdkFactoryAbstraction } from \"./abstractions.js\";\nimport type { IAiSdk, IAiSdkModel } from \"./abstractions.js\";\n\nconst ANTHROPIC_MODELS: IAiSdkModel[] = [\n    { id: \"claude-fable-5-1\", name: \"Claude Fable 5.1\" },\n    { id: \"claude-opus-5\", name: \"Claude Opus 5\" },\n    { id: \"claude-sonnet-5\", name: \"Claude Sonnet 5\" },\n    { id: \"claude-haiku-4-5\", name: \"Claude Haiku 4.5\" },\n    { id: \"claude-fable-5\", name: \"Claude Fable 5\" },\n    { id: \"claude-opus-4-8\", name: \"Claude Opus 4.8\" },\n    { id: \"claude-opus-4-7\", name: \"Claude Opus 4.7\" },\n    { id: \"claude-opus-4-6\", name: \"Claude Opus 4.6\" },\n    { id: \"claude-opus-4-5\", name: \"Claude Opus 4.5\" },\n    { id: \"claude-sonnet-4-6\", name: \"Claude Sonnet 4.6\" },\n    { id: \"claude-sonnet-4-5\", name: \"Claude Sonnet 4.5\" }\n];\n\nclass AnthropicSdkFactoryImpl implements AiSdkFactoryAbstraction.Interface {\n    readonly id = \"anthropic\";\n    readonly name = \"Anthropic\";\n    readonly models = ANTHROPIC_MODELS;\n\n    async execute(apiKey?: string): Promise<IAiSdk> {\n        const { createAnthropic } = await import(\"@ai-sdk/anthropic\");\n        const provider = createAnthropic({\n            apiKey: apiKey ?? process.env.WEBINY_API_ANTHROPIC_API_KEY\n        });\n        return {\n            languageModel: modelId => provider.chat(modelId)\n        };\n    }\n}\n\nexport const AnthropicSdkFactory = createImplementation({\n    abstraction: AiSdkFactoryAbstraction,\n    implementation: AnthropicSdkFactoryImpl,\n    dependencies: []\n});\n"],"names":["ANTHROPIC_MODELS","AnthropicSdkFactoryImpl","apiKey","createAnthropic","provider","process","modelId","AnthropicSdkFactory","createImplementation","AiSdkFactoryAbstraction"],"mappings":";;AAIA,MAAMA,mBAAkC;IACpC;QAAE,IAAI;QAAoB,MAAM;IAAmB;IACnD;QAAE,IAAI;QAAiB,MAAM;IAAgB;IAC7C;QAAE,IAAI;QAAmB,MAAM;IAAkB;IACjD;QAAE,IAAI;QAAoB,MAAM;IAAmB;IACnD;QAAE,IAAI;QAAkB,MAAM;IAAiB;IAC/C;QAAE,IAAI;QAAmB,MAAM;IAAkB;IACjD;QAAE,IAAI;QAAmB,MAAM;IAAkB;IACjD;QAAE,IAAI;QAAmB,MAAM;IAAkB;IACjD;QAAE,IAAI;QAAmB,MAAM;IAAkB;IACjD;QAAE,IAAI;QAAqB,MAAM;IAAoB;IACrD;QAAE,IAAI;QAAqB,MAAM;IAAoB;CACxD;AAED,MAAMC;IAKF,MAAM,QAAQC,MAAe,EAAmB;QAC5C,MAAM,EAAEC,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC;QACzC,MAAMC,WAAWD,gBAAgB;YAC7B,QAAQD,UAAUG,QAAQ,GAAG,CAAC,4BAA4B;QAC9D;QACA,OAAO;YACH,eAAeC,CAAAA,UAAWF,SAAS,IAAI,CAACE;QAC5C;IACJ;;aAZS,EAAE,GAAG;aACL,IAAI,GAAG;aACP,MAAM,GAAGN;;AAWtB;AAEO,MAAMO,sBAAsBC,qBAAqB;IACpD,aAAaC;IACb,gBAAgBR;IAChB,cAAc,EAAE;AACpB"}

package/features/ai/DEVELOPERS.md

@@ -0,0 +1,126 @@
+# AI Models
+
+This directory contains the AI SDK factory implementations that define which models are available in Webiny's AI Powerups.
+
+## Selection criteria
+
+Every model listed 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.
+- **General availability** — preview-only models are excluded unless they fill a gap no GA model covers.
+
+Models are ordered newest-first within each factory. Deprecated models that still work via the provider API are kept at the bottom of the list so existing user presets don't break.
+
+## Model lifecycle
+
+Each model entry in `IAiSdkModel` supports two optional `Date` fields:
+
+- **`deprecated`** — the date the provider officially deprecated the model. The model still works but is no longer recommended.
+- **`endOfLife`** — the date the provider will shut down the model. After this date, API requests to the model will fail.
+
+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.
+
+## Providers
+
+### Anthropic (`AnthropicSdkFactory.ts`)
+
+All Anthropic models listed are **Active**. Anthropic commits to a "not sooner than" retirement date but does not deprecate models until closer to retirement.
+
+| Model ID            | Name              | Status          | Retirement (not sooner than) |
+| ------------------- | ----------------- | --------------- | ---------------------------- |
+| `claude-fable-5-1`  | Claude Fable 5.1  | Active          | September 1, 2027            |
+| `claude-opus-5`     | Claude Opus 5     | Active          | July 24, 2027                |
+| `claude-sonnet-5`   | Claude Sonnet 5   | Active          | June 30, 2027                |
+| `claude-haiku-4-5`  | Claude Haiku 4.5  | Active          | October 15, 2026             |
+| `claude-fable-5`    | Claude Fable 5    | Active (legacy) | June 9, 2027                 |
+| `claude-opus-4-8`   | Claude Opus 4.8   | Active (legacy) | May 28, 2027                 |
+| `claude-opus-4-7`   | Claude Opus 4.7   | Active (legacy) | April 16, 2027               |
+| `claude-opus-4-6`   | Claude Opus 4.6   | Active (legacy) | February 5, 2027             |
+| `claude-opus-4-5`   | Claude Opus 4.5   | Active (legacy) | November 24, 2026            |
+| `claude-sonnet-4-6` | Claude Sonnet 4.6 | Active (legacy) | February 17, 2027            |
+| `claude-sonnet-4-5` | Claude Sonnet 4.5 | Active (legacy) | September 29, 2026           |
+
+All Claude models support tool use. Env var fallback: `WEBINY_API_ANTHROPIC_API_KEY`.
+
+Source: https://platform.claude.com/docs/en/about-claude/model-deprecations
+
+### OpenAI (`OpenAiSdkFactory.ts`)
+
+| Model ID        | Name          | Status     | Deprecated     | End of life       |
+| --------------- | ------------- | ---------- | -------------- | ----------------- |
+| `gpt-6-astra`   | GPT-6 Astra   | Active     | —              | —                 |
+| `gpt-5.6-sol`   | GPT-5.6 Sol   | Active     | —              | —                 |
+| `gpt-5.6-terra` | GPT-5.6 Terra | Active     | —              | —                 |
+| `gpt-5.6-luna`  | GPT-5.6 Luna  | Active     | —              | —                 |
+| `gpt-5.5`       | GPT-5.5       | Active     | —              | —                 |
+| `gpt-5.5-pro`   | GPT-5.5 Pro   | Active     | —              | —                 |
+| `gpt-5.4`       | GPT-5.4       | Active     | —              | —                 |
+| `gpt-5.4-pro`   | GPT-5.4 Pro   | Active     | —              | —                 |
+| `gpt-5.4-mini`  | GPT-5.4 Mini  | Active     | —              | —                 |
+| `gpt-5.4-nano`  | GPT-5.4 Nano  | Active     | —              | —                 |
+| `gpt-5.2`       | GPT-5.2       | Active     | —              | —                 |
+| `gpt-5.2-pro`   | GPT-5.2 Pro   | Active     | —              | —                 |
+| `gpt-5`         | GPT-5         | Active     | —              | —                 |
+| `gpt-5-pro`     | GPT-5 Pro     | Active     | —              | —                 |
+| `gpt-5-mini`    | GPT-5 Mini    | Active     | —              | —                 |
+| `gpt-5-nano`    | GPT-5 Nano    | Active     | —              | —                 |
+| `gpt-4.1`       | GPT-4.1       | Active     | —              | —                 |
+| `gpt-4.1-mini`  | GPT-4.1 Mini  | Active     | —              | —                 |
+| `gpt-4o`        | GPT-4o        | Active     | —              | —                 |
+| `gpt-4o-mini`   | GPT-4o Mini   | Active     | —              | —                 |
+| `o3-pro`        | o3 Pro        | Deprecated | June 11, 2026  | December 11, 2026 |
+| `o3`            | o3            | Deprecated | June 11, 2026  | December 11, 2026 |
+| `gpt-4.1-nano`  | GPT-4.1 Nano  | Deprecated | April 22, 2026 | October 23, 2026  |
+| `o4-mini`       | o4 Mini       | Deprecated | April 22, 2026 | October 23, 2026  |
+
+All listed models support function calling. Env var fallback: `WEBINY_API_OPENAI_API_KEY`.
+
+Source: https://developers.openai.com/api/docs/deprecations
+
+### Google (`GoogleSdkFactory.ts`)
+
+| Model ID                | Name                  | Status | End of life |
+| ----------------------- | --------------------- | ------ | ----------- |
+| `gemini-3.8-flash`      | Gemini 3.8 Flash      | Active | —           |
+| `gemini-3.7-flash`      | Gemini 3.7 Flash      | Active | —           |
+| `gemini-3.6-flash`      | Gemini 3.6 Flash      | Active | —           |
+| `gemini-3.5-flash`      | Gemini 3.5 Flash      | Active | —           |
+| `gemini-3.5-flash-lite` | Gemini 3.5 Flash Lite | Active | —           |
+| `gemini-3.1-flash-lite` | Gemini 3.1 Flash Lite | Active | May 7, 2027 |
+| `gemini-2.5-pro`        | Gemini 2.5 Pro        | Active | —           |
+| `gemini-2.5-flash`      | Gemini 2.5 Flash      | Active | —           |
+| `gemini-2.5-flash-lite` | Gemini 2.5 Flash Lite | Active | —           |
+
+All listed models support function calling. `gemini-3.1-flash-lite` does not support streaming tool call arguments, but standard (non-streaming) function calling works.
+
+Env var fallback: `WEBINY_API_GOOGLE_API_KEY`.
+
+Source: https://ai.google.dev/gemini-api/docs/deprecations
+
+## 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.
+
+## Adding a new provider
+
+1. Create a new `<Provider>SdkFactory.ts` implementing `AiSdkFactory`.
+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.
+
+## Updating models
+
+Check the provider docs periodically and update the 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.
+
+Last updated: September 2026.

package/features/ai/GoogleSdkFactory.d.ts

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

package/features/ai/GoogleSdkFactory.js

@@ -0,0 +1,65 @@
+import { createImplementation } from "@webiny/feature/api";
+import { AiSdkFactory } from "./abstractions.js";
+const GOOGLE_MODELS = [
+    {
+        id: "gemini-3.8-flash",
+        name: "Gemini 3.8 Flash"
+    },
+    {
+        id: "gemini-3.7-flash",
+        name: "Gemini 3.7 Flash"
+    },
+    {
+        id: "gemini-3.6-flash",
+        name: "Gemini 3.6 Flash"
+    },
+    {
+        id: "gemini-3.5-flash",
+        name: "Gemini 3.5 Flash"
+    },
+    {
+        id: "gemini-3.5-flash-lite",
+        name: "Gemini 3.5 Flash Lite"
+    },
+    {
+        id: "gemini-3.1-flash-lite",
+        name: "Gemini 3.1 Flash Lite",
+        endOfLife: new Date("2027-05-07")
+    },
+    {
+        id: "gemini-2.5-pro",
+        name: "Gemini 2.5 Pro"
+    },
+    {
+        id: "gemini-2.5-flash",
+        name: "Gemini 2.5 Flash"
+    },
+    {
+        id: "gemini-2.5-flash-lite",
+        name: "Gemini 2.5 Flash Lite"
+    }
+];
+class GoogleSdkFactoryImpl {
+    async execute(apiKey) {
+        const { createGoogleGenerativeAI } = await import("@ai-sdk/google");
+        const provider = createGoogleGenerativeAI({
+            apiKey: apiKey ?? process.env.WEBINY_API_GOOGLE_API_KEY
+        });
+        return {
+            languageModel: (modelId)=>provider.chat(modelId)
+        };
+    }
+    constructor(){
+        this.id = "google";
+        this.name = "Google";
+        this.models = GOOGLE_MODELS;
+    }
+}
+const GoogleSdkFactory = createImplementation({
+    abstraction: AiSdkFactory,
+    implementation: GoogleSdkFactoryImpl,
+    dependencies: []
+});
+export { GoogleSdkFactory };
+
+//# sourceMappingURL=GoogleSdkFactory.js.map

package/features/ai/GoogleSdkFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/ai/GoogleSdkFactory.js","sources":["../../../src/features/ai/GoogleSdkFactory.ts"],"sourcesContent":["import { createImplementation } from \"@webiny/feature/api\";\nimport { AiSdkFactory as AiSdkFactoryAbstraction } from \"./abstractions.js\";\nimport type { IAiSdk, IAiSdkModel } from \"./abstractions.js\";\n\nconst GOOGLE_MODELS: IAiSdkModel[] = [\n    { id: \"gemini-3.8-flash\", name: \"Gemini 3.8 Flash\" },\n    { id: \"gemini-3.7-flash\", name: \"Gemini 3.7 Flash\" },\n    { id: \"gemini-3.6-flash\", name: \"Gemini 3.6 Flash\" },\n    { id: \"gemini-3.5-flash\", name: \"Gemini 3.5 Flash\" },\n    { id: \"gemini-3.5-flash-lite\", name: \"Gemini 3.5 Flash Lite\" },\n    {\n        id: \"gemini-3.1-flash-lite\",\n        name: \"Gemini 3.1 Flash Lite\",\n        endOfLife: new Date(\"2027-05-07\")\n    },\n    { id: \"gemini-2.5-pro\", name: \"Gemini 2.5 Pro\" },\n    { id: \"gemini-2.5-flash\", name: \"Gemini 2.5 Flash\" },\n    { id: \"gemini-2.5-flash-lite\", name: \"Gemini 2.5 Flash Lite\" }\n];\n\nclass GoogleSdkFactoryImpl implements AiSdkFactoryAbstraction.Interface {\n    readonly id = \"google\";\n    readonly name = \"Google\";\n    readonly models = GOOGLE_MODELS;\n\n    async execute(apiKey?: string): Promise<IAiSdk> {\n        const { createGoogleGenerativeAI } = await import(\"@ai-sdk/google\");\n        const provider = createGoogleGenerativeAI({\n            apiKey: apiKey ?? process.env.WEBINY_API_GOOGLE_API_KEY\n        });\n        return {\n            languageModel: modelId => provider.chat(modelId)\n        };\n    }\n}\n\nexport const GoogleSdkFactory = createImplementation({\n    abstraction: AiSdkFactoryAbstraction,\n    implementation: GoogleSdkFactoryImpl,\n    dependencies: []\n});\n"],"names":["GOOGLE_MODELS","Date","GoogleSdkFactoryImpl","apiKey","createGoogleGenerativeAI","provider","process","modelId","GoogleSdkFactory","createImplementation","AiSdkFactoryAbstraction"],"mappings":";;AAIA,MAAMA,gBAA+B;IACjC;QAAE,IAAI;QAAoB,MAAM;IAAmB;IACnD;QAAE,IAAI;QAAoB,MAAM;IAAmB;IACnD;QAAE,IAAI;QAAoB,MAAM;IAAmB;IACnD;QAAE,IAAI;QAAoB,MAAM;IAAmB;IACnD;QAAE,IAAI;QAAyB,MAAM;IAAwB;IAC7D;QACI,IAAI;QACJ,MAAM;QACN,WAAW,IAAIC,KAAK;IACxB;IACA;QAAE,IAAI;QAAkB,MAAM;IAAiB;IAC/C;QAAE,IAAI;QAAoB,MAAM;IAAmB;IACnD;QAAE,IAAI;QAAyB,MAAM;IAAwB;CAChE;AAED,MAAMC;IAKF,MAAM,QAAQC,MAAe,EAAmB;QAC5C,MAAM,EAAEC,wBAAwB,EAAE,GAAG,MAAM,MAAM,CAAC;QAClD,MAAMC,WAAWD,yBAAyB;YACtC,QAAQD,UAAUG,QAAQ,GAAG,CAAC,yBAAyB;QAC3D;QACA,OAAO;YACH,eAAeC,CAAAA,UAAWF,SAAS,IAAI,CAACE;QAC5C;IACJ;;aAZS,EAAE,GAAG;aACL,IAAI,GAAG;aACP,MAAM,GAAGP;;AAWtB;AAEO,MAAMQ,mBAAmBC,qBAAqB;IACjD,aAAaC;IACb,gBAAgBR;IAChB,cAAc,EAAE;AACpB"}