@webiny/api-core 6.6.0-alpha.0 → 6.6.0-alpha.1

package/ApiCoreFeature.js

@@ -13,6 +13,8 @@ import { EncryptionFeature } from "./features/encryption/feature.js";
 import { HasherFeature } from "./features/hashing/feature.js";
 import { FeatureFlagsFeature } from "./features/featureFlags/feature.js";
 import { MaskerFeature } from "./features/masker/feature.js";
+import { StringFormatterFeature } from "./features/stringFormatter/feature.js";
+import { DateFormatterFeature } from "./features/dateFormatter/feature.js";
 import { AiFeature } from "./features/ai/feature.js";
 import { WcpFeature } from "./features/wcp/WcpFeature.js";
 import { NullWebhookDispatcher } from "./features/webhooks/WebhookDispatcher/NullWebhookDispatcher.js";
@@ -23,12 +25,15 @@ import { SecuritySchemaFactory } from "./graphql/security/SecuritySchemaFactory.
 import { UsersSchemaFactory } from "./graphql/users/UsersSchemaFactory.js";
 import { SystemSchemaFactory } from "./graphql/system/SystemSchemaFactory.js";
 import { WcpSchemaFactory } from "./graphql/wcp/WcpSchemaFactory.js";
+import { FeatureFlagsSchemaFactory } from "./graphql/featureFlags/FeatureFlagsSchemaFactory.js";
 const ApiCoreFeature = createFeature({
     name: "ApiCore",
     register (container, config = {}) {
         const storageOperations = container.resolve(ApiCoreStorageOperationsFactory).create();
         WcpFeature.register(container, config.wcpLicense);
         MaskerFeature.register(container);
+        StringFormatterFeature.register(container);
+        DateFormatterFeature.register(container);
         AiFeature.register(container);
         LoggerFeature.register(container);
         EventPublisherFeature.register(container);
@@ -50,6 +55,7 @@ const ApiCoreFeature = createFeature({
         container.register(UsersSchemaFactory);
         container.register(SystemSchemaFactory);
         container.register(WcpSchemaFactory);
+        container.register(FeatureFlagsSchemaFactory);
     }
 });
 export { ApiCoreFeature };

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 { ApiCoreConfig } from \"~/types/core.js\";\nimport { ApiCoreStorageOperationsFactory } from \"~/features/storageOperations/abstractions.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 { HasherFeature } from \"~/features/hashing/feature.js\";\nimport { FeatureFlagsFeature } from \"~/features/featureFlags/feature.js\";\nimport { MaskerFeature } from \"~/features/masker/feature.js\";\nimport { AiFeature } from \"~/features/ai/feature.js\";\nimport { WcpFeature } from \"~/features/wcp/WcpFeature.js\";\nimport { NullWebhookDispatcher } from \"./features/webhooks/WebhookDispatcher/NullWebhookDispatcher.js\";\nimport { WebhookProviderFeature } from \"~/features/webhooks/index.js\";\nimport { RequestContextFeature } from \"~/features/requestContext/index.js\";\nimport { ApiCoreSchemaFactory } from \"~/graphql/ApiCoreSchemaFactory.js\";\nimport { SecuritySchemaFactory } from \"~/graphql/security/SecuritySchemaFactory.js\";\nimport { UsersSchemaFactory } from \"~/graphql/users/UsersSchemaFactory.js\";\nimport { SystemSchemaFactory } from \"~/graphql/system/SystemSchemaFactory.js\";\nimport { WcpSchemaFactory } from \"~/graphql/wcp/WcpSchemaFactory.js\";\n\nexport const ApiCoreFeature = createFeature({\n    name: \"ApiCore\",\n    register(container: Container, config: ApiCoreConfig = {}) {\n        // Storage operations are built synchronously, here, from the adapter-provided factory —\n        // the same way for every event (no out-of-feature construction, no async initializer).\n        const storageOperations = container.resolve(ApiCoreStorageOperationsFactory).create();\n\n        // Register features\n        WcpFeature.register(container, config.wcpLicense);\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        HasherFeature.register(container);\n        FeatureFlagsFeature.register(container);\n        TenancyFeature.register(container, storageOperations.tenancyStorageOperations);\n        SecurityFeature.register(container, storageOperations.securityStorageOperations);\n        AdminUsersFeature.register(container, storageOperations.usersStorageOperations);\n        KeyValueStoreFeature.register(container, storageOperations.keyValueStorageOperations);\n        SystemFeature.register(container);\n        IdpAuthenticatorFeature.register(container);\n        RequestContextFeature.register(container);\n        container.register(NullWebhookDispatcher).inSingletonScope();\n        WebhookProviderFeature.register(container);\n\n        // Core API GraphQL schema: a base factory (root types + scalars) plus one\n        // CoreGraphQLSchemaFactory per domain.\n        container.register(ApiCoreSchemaFactory);\n        container.register(SecuritySchemaFactory);\n        container.register(UsersSchemaFactory);\n        container.register(SystemSchemaFactory);\n        container.register(WcpSchemaFactory);\n    }\n});\n"],"names":["ApiCoreFeature","createFeature","container","config","storageOperations","ApiCoreStorageOperationsFactory","WcpFeature","MaskerFeature","AiFeature","LoggerFeature","EventPublisherFeature","BuildParamsFeature","EncryptionFeature","HasherFeature","FeatureFlagsFeature","TenancyFeature","SecurityFeature","AdminUsersFeature","KeyValueStoreFeature","SystemFeature","IdpAuthenticatorFeature","RequestContextFeature","NullWebhookDispatcher","WebhookProviderFeature","ApiCoreSchemaFactory","SecuritySchemaFactory","UsersSchemaFactory","SystemSchemaFactory","WcpSchemaFactory"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA4BO,MAAMA,iBAAiBC,cAAc;IACxC,MAAM;IACN,UAASC,SAAoB,EAAEC,SAAwB,CAAC,CAAC;QAGrD,MAAMC,oBAAoBF,UAAU,OAAO,CAACG,iCAAiC,MAAM;QAGnFC,WAAW,QAAQ,CAACJ,WAAWC,OAAO,UAAU;QAChDI,cAAc,QAAQ,CAACL;QACvBM,UAAU,QAAQ,CAACN;QACnBO,cAAc,QAAQ,CAACP;QACvBQ,sBAAsB,QAAQ,CAACR;QAC/BS,mBAAmB,QAAQ,CAACT;QAC5BU,kBAAkB,QAAQ,CAACV;QAC3BW,cAAc,QAAQ,CAACX;QACvBY,oBAAoB,QAAQ,CAACZ;QAC7Ba,eAAe,QAAQ,CAACb,WAAWE,kBAAkB,wBAAwB;QAC7EY,gBAAgB,QAAQ,CAACd,WAAWE,kBAAkB,yBAAyB;QAC/Ea,kBAAkB,QAAQ,CAACf,WAAWE,kBAAkB,sBAAsB;QAC9Ec,qBAAqB,QAAQ,CAAChB,WAAWE,kBAAkB,yBAAyB;QACpFe,cAAc,QAAQ,CAACjB;QACvBkB,wBAAwB,QAAQ,CAAClB;QACjCmB,sBAAsB,QAAQ,CAACnB;QAC/BA,UAAU,QAAQ,CAACoB,uBAAuB,gBAAgB;QAC1DC,uBAAuB,QAAQ,CAACrB;QAIhCA,UAAU,QAAQ,CAACsB;QACnBtB,UAAU,QAAQ,CAACuB;QACnBvB,UAAU,QAAQ,CAACwB;QACnBxB,UAAU,QAAQ,CAACyB;QACnBzB,UAAU,QAAQ,CAAC0B;IACvB;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 { ApiCoreConfig } from \"~/types/core.js\";\nimport { ApiCoreStorageOperationsFactory } from \"~/features/storageOperations/abstractions.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 { HasherFeature } from \"~/features/hashing/feature.js\";\nimport { FeatureFlagsFeature } from \"~/features/featureFlags/feature.js\";\nimport { MaskerFeature } from \"~/features/masker/feature.js\";\nimport { StringFormatterFeature } from \"~/features/stringFormatter/feature.js\";\nimport { DateFormatterFeature } from \"~/features/dateFormatter/feature.js\";\nimport { AiFeature } from \"~/features/ai/feature.js\";\nimport { WcpFeature } from \"~/features/wcp/WcpFeature.js\";\nimport { NullWebhookDispatcher } from \"./features/webhooks/WebhookDispatcher/NullWebhookDispatcher.js\";\nimport { WebhookProviderFeature } from \"~/features/webhooks/index.js\";\nimport { RequestContextFeature } from \"~/features/requestContext/index.js\";\nimport { ApiCoreSchemaFactory } from \"~/graphql/ApiCoreSchemaFactory.js\";\nimport { SecuritySchemaFactory } from \"~/graphql/security/SecuritySchemaFactory.js\";\nimport { UsersSchemaFactory } from \"~/graphql/users/UsersSchemaFactory.js\";\nimport { SystemSchemaFactory } from \"~/graphql/system/SystemSchemaFactory.js\";\nimport { WcpSchemaFactory } from \"~/graphql/wcp/WcpSchemaFactory.js\";\nimport { FeatureFlagsSchemaFactory } from \"~/graphql/featureFlags/FeatureFlagsSchemaFactory.js\";\n\nexport const ApiCoreFeature = createFeature({\n    name: \"ApiCore\",\n    register(container: Container, config: ApiCoreConfig = {}) {\n        // Storage operations are built synchronously, here, from the adapter-provided factory —\n        // the same way for every event (no out-of-feature construction, no async initializer).\n        const storageOperations = container.resolve(ApiCoreStorageOperationsFactory).create();\n\n        // Register features\n        WcpFeature.register(container, config.wcpLicense);\n        MaskerFeature.register(container);\n        StringFormatterFeature.register(container);\n        DateFormatterFeature.register(container);\n        AiFeature.register(container);\n        LoggerFeature.register(container);\n        EventPublisherFeature.register(container);\n        BuildParamsFeature.register(container);\n        EncryptionFeature.register(container);\n        HasherFeature.register(container);\n        FeatureFlagsFeature.register(container);\n        TenancyFeature.register(container, storageOperations.tenancyStorageOperations);\n        SecurityFeature.register(container, storageOperations.securityStorageOperations);\n        AdminUsersFeature.register(container, storageOperations.usersStorageOperations);\n        KeyValueStoreFeature.register(container, storageOperations.keyValueStorageOperations);\n        SystemFeature.register(container);\n        IdpAuthenticatorFeature.register(container);\n        RequestContextFeature.register(container);\n        container.register(NullWebhookDispatcher).inSingletonScope();\n        WebhookProviderFeature.register(container);\n\n        // Core API GraphQL schema: a base factory (root types + scalars) plus one\n        // CoreGraphQLSchemaFactory per domain.\n        container.register(ApiCoreSchemaFactory);\n        container.register(SecuritySchemaFactory);\n        container.register(UsersSchemaFactory);\n        container.register(SystemSchemaFactory);\n        container.register(WcpSchemaFactory);\n        container.register(FeatureFlagsSchemaFactory);\n    }\n});\n"],"names":["ApiCoreFeature","createFeature","container","config","storageOperations","ApiCoreStorageOperationsFactory","WcpFeature","MaskerFeature","StringFormatterFeature","DateFormatterFeature","AiFeature","LoggerFeature","EventPublisherFeature","BuildParamsFeature","EncryptionFeature","HasherFeature","FeatureFlagsFeature","TenancyFeature","SecurityFeature","AdminUsersFeature","KeyValueStoreFeature","SystemFeature","IdpAuthenticatorFeature","RequestContextFeature","NullWebhookDispatcher","WebhookProviderFeature","ApiCoreSchemaFactory","SecuritySchemaFactory","UsersSchemaFactory","SystemSchemaFactory","WcpSchemaFactory","FeatureFlagsSchemaFactory"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BO,MAAMA,iBAAiBC,cAAc;IACxC,MAAM;IACN,UAASC,SAAoB,EAAEC,SAAwB,CAAC,CAAC;QAGrD,MAAMC,oBAAoBF,UAAU,OAAO,CAACG,iCAAiC,MAAM;QAGnFC,WAAW,QAAQ,CAACJ,WAAWC,OAAO,UAAU;QAChDI,cAAc,QAAQ,CAACL;QACvBM,uBAAuB,QAAQ,CAACN;QAChCO,qBAAqB,QAAQ,CAACP;QAC9BQ,UAAU,QAAQ,CAACR;QACnBS,cAAc,QAAQ,CAACT;QACvBU,sBAAsB,QAAQ,CAACV;QAC/BW,mBAAmB,QAAQ,CAACX;QAC5BY,kBAAkB,QAAQ,CAACZ;QAC3Ba,cAAc,QAAQ,CAACb;QACvBc,oBAAoB,QAAQ,CAACd;QAC7Be,eAAe,QAAQ,CAACf,WAAWE,kBAAkB,wBAAwB;QAC7Ec,gBAAgB,QAAQ,CAAChB,WAAWE,kBAAkB,yBAAyB;QAC/Ee,kBAAkB,QAAQ,CAACjB,WAAWE,kBAAkB,sBAAsB;QAC9EgB,qBAAqB,QAAQ,CAAClB,WAAWE,kBAAkB,yBAAyB;QACpFiB,cAAc,QAAQ,CAACnB;QACvBoB,wBAAwB,QAAQ,CAACpB;QACjCqB,sBAAsB,QAAQ,CAACrB;QAC/BA,UAAU,QAAQ,CAACsB,uBAAuB,gBAAgB;QAC1DC,uBAAuB,QAAQ,CAACvB;QAIhCA,UAAU,QAAQ,CAACwB;QACnBxB,UAAU,QAAQ,CAACyB;QACnBzB,UAAU,QAAQ,CAAC0B;QACnB1B,UAAU,QAAQ,CAAC2B;QACnB3B,UAAU,QAAQ,CAAC4B;QACnB5B,UAAU,QAAQ,CAAC6B;IACvB;AACJ"}

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/features/ai/Ai.d.ts

@@ -6,12 +6,14 @@ import { AiConnectionFactory } 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 sdkCache;
     private resolvedConnections;
-    constructor(sdkFactories: AiSdkFactory.Interface[], connectionFactories: AiConnectionFactory.Interface[]);
+    constructor(sdkFactories: AiSdkFactory.Interface[], connectionFactories: AiConnectionFactory.Interface[], eventPublisher: EventPublisher.Interface);
     generateText(params: AiGenerateTextParams): ReturnType<typeof generateText>;
     streamText(params: AiStreamTextParams): Promise<ReturnType<typeof streamText>>;
     listModels(): Promise<AiModel[]>;

package/features/ai/Ai.js

@@ -1,6 +1,9 @@
 import { createImplementation } from "@webiny/feature/api";
 import { generateText, streamText } from "ai";
 import { Ai, AiConnectionFactory, 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";
 function toAiModel(factory, modelId, modelName) {
     return {
         providerId: factory.id,
@@ -10,22 +13,53 @@ function toAiModel(factory, modelId, modelName) {
     };
 }
 class AiImpl {
-    constructor(sdkFactories, connectionFactories){
+    constructor(sdkFactories, connectionFactories, eventPublisher){
         this.sdkFactories = sdkFactories;
         this.connectionFactories = connectionFactories;
+        this.eventPublisher = eventPublisher;
         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
@@ -108,7 +142,8 @@ const Ai_Ai = createImplementation({
             {
                 multiple: true
             }
-        ]
+        ],
+        EventPublisher
     ]
 });
 export { Ai_Ai as Ai };

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 type { AiGenerateTextParams, AiModel, IAiSdkFactory } 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\nfunction toAiModel(factory: IAiSdkFactory, modelId: string, modelName: string): AiModel {\n    return {\n        providerId: factory.id,\n        providerName: factory.name,\n        modelId,\n        modelName\n    };\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    ) {}\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 Promise.resolve(\n            this.sdkFactories.flatMap(factory =>\n                factory.models.map(m => toAiModel(factory, m.id, m.name))\n            )\n        );\n    }\n\n    async listModelsByConnections(): Promise<AiModel[]> {\n        const connections = await this.getConnections();\n        return connections.flatMap(conn => {\n            const factory = this.sdkFactories.find(f => f.id === conn.sdkName);\n            if (!factory) {\n                return [];\n            }\n            return factory.models.map(m => toAiModel(factory, m.id, m.name));\n        });\n    }\n\n    async listModelsByConnection(connection: string | IAiConnectionInline): Promise<AiModel[]> {\n        const conn = await this.resolveConnection(undefined, connection);\n        const factory = this.sdkFactories.find(f => f.id === conn.sdkName);\n        if (!factory) {\n            return [];\n        }\n        return factory.models.map(m => toAiModel(factory, m.id, m.name));\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 modelName = modelId.slice(slashIndex + 1);\n\n        const conn = await this.resolveConnection(providerId, connection);\n        const sdk = await this.getSdk(conn);\n        return sdk.languageModel(modelName);\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    ]\n});\n"],"names":["toAiModel","factory","modelId","modelName","AiImpl","sdkFactories","connectionFactories","Map","params","model","connection","rest","resolvedModel","generateText","streamText","Promise","m","connections","conn","f","undefined","slashIndex","Error","providerId","sdk","found","c","known","cacheKey","cached","Ai","createImplementation","AiAbstraction","AiSdkFactory","AiConnectionFactory"],"mappings":";;;AAaA,SAASA,UAAUC,OAAsB,EAAEC,OAAe,EAAEC,SAAiB;IACzE,OAAO;QACH,YAAYF,QAAQ,EAAE;QACtB,cAAcA,QAAQ,IAAI;QAC1BC;QACAC;IACJ;AACJ;AAEA,MAAMC;IAIF,YACqBC,YAAsC,EACtCC,mBAAoD,CACvE;aAFmBD,YAAY,GAAZA;aACAC,mBAAmB,GAAnBA;aALb,QAAQ,GAAG,IAAIC;aACf,mBAAmB,GAA2B;IAKnD;IAEH,aAAaC,MAA4B,EAAmC;QACxE,MAAM,EAAEC,KAAK,EAAEC,UAAU,EAAE,GAAGC,MAAM,GAAGH;QACvC,OAAO,IAAI,CAAC,oBAAoB,CAACC,OAAOC,YAAY,IAAI,CAACE,CAAAA,gBAE9CC,aAAa;gBAAE,OAAOD;gBAAe,GAAGD,IAAI;YAAC;IAI5D;IAEA,MAAM,WAAWH,MAA0B,EAA0C;QACjF,MAAM,EAAEC,KAAK,EAAEC,UAAU,EAAE,GAAGC,MAAM,GAAGH;QACvC,MAAMI,gBAAgB,MAAM,IAAI,CAAC,oBAAoB,CAACH,OAAOC;QAE7D,OAAOI,WAAW;YAAE,OAAOF;YAAe,GAAGD,IAAI;QAAC;IACtD;IAEA,aAAiC;QAC7B,OAAOI,QAAQ,OAAO,CAClB,IAAI,CAAC,YAAY,CAAC,OAAO,CAACd,CAAAA,UACtBA,QAAQ,MAAM,CAAC,GAAG,CAACe,CAAAA,IAAKhB,UAAUC,SAASe,EAAE,EAAE,EAAEA,EAAE,IAAI;IAGnE;IAEA,MAAM,0BAA8C;QAChD,MAAMC,cAAc,MAAM,IAAI,CAAC,cAAc;QAC7C,OAAOA,YAAY,OAAO,CAACC,CAAAA;YACvB,MAAMjB,UAAU,IAAI,CAAC,YAAY,CAAC,IAAI,CAACkB,CAAAA,IAAKA,EAAE,EAAE,KAAKD,KAAK,OAAO;YACjE,IAAI,CAACjB,SACD,OAAO,EAAE;YAEb,OAAOA,QAAQ,MAAM,CAAC,GAAG,CAACe,CAAAA,IAAKhB,UAAUC,SAASe,EAAE,EAAE,EAAEA,EAAE,IAAI;QAClE;IACJ;IAEA,MAAM,uBAAuBN,UAAwC,EAAsB;QACvF,MAAMQ,OAAO,MAAM,IAAI,CAAC,iBAAiB,CAACE,QAAWV;QACrD,MAAMT,UAAU,IAAI,CAAC,YAAY,CAAC,IAAI,CAACkB,CAAAA,IAAKA,EAAE,EAAE,KAAKD,KAAK,OAAO;QACjE,IAAI,CAACjB,SACD,OAAO,EAAE;QAEb,OAAOA,QAAQ,MAAM,CAAC,GAAG,CAACe,CAAAA,IAAKhB,UAAUC,SAASe,EAAE,EAAE,EAAEA,EAAE,IAAI;IAClE;IAEA,MAAc,qBACVd,OAAe,EACfQ,UAAyC,EACnB;QACtB,MAAMW,aAAanB,QAAQ,OAAO,CAAC;QACnC,IAAImB,AAAe,OAAfA,YACA,MAAM,IAAIC,MACN,CAAC,kBAAkB,EAAEpB,QAAQ,oEAAoE,CAAC;QAI1G,MAAMqB,aAAarB,QAAQ,KAAK,CAAC,GAAGmB;QACpC,MAAMlB,YAAYD,QAAQ,KAAK,CAACmB,aAAa;QAE7C,MAAMH,OAAO,MAAM,IAAI,CAAC,iBAAiB,CAACK,YAAYb;QACtD,MAAMc,MAAM,MAAM,IAAI,CAAC,MAAM,CAACN;QAC9B,OAAOM,IAAI,aAAa,CAACrB;IAC7B;IAEA,MAAc,iBAA2C;QACrD,IAAI,CAAC,IAAI,CAAC,mBAAmB,EACzB,IAAI,CAAC,mBAAmB,GAAG,MAAMY,QAAQ,GAAG,CACxC,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAACI,CAAAA,IAAKA,EAAE,OAAO;QAGnD,OAAO,IAAI,CAAC,mBAAmB;IACnC;IAEA,MAAc,kBACVI,UAA8B,EAC9Bb,UAAyC,EACb;QAC5B,IAAI,AAAsB,YAAtB,OAAOA,YACP,OAAOA;QAGX,MAAMO,cAAc,MAAM,IAAI,CAAC,cAAc;QAE7C,IAAI,AAAsB,YAAtB,OAAOP,YAAyB;YAChC,MAAMe,QAAQR,YAAY,IAAI,CAACS,CAAAA,IAAKA,EAAE,EAAE,KAAKhB;YAC7C,IAAI,CAACe,OAAO;gBACR,MAAME,QAAQV,YAAY,GAAG,CAACS,CAAAA,IAAK,CAAC,CAAC,EAAEA,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;gBACrD,MAAM,IAAIJ,MACN,CAAC,uBAAuB,EAAEZ,WAAW,2BAA2B,EAAEiB,MAAM,CAAC,CAAC;YAElF;YACA,OAAOF;QACX;QAEA,MAAMA,QAAQR,YAAY,IAAI,CAACS,CAAAA,IAAKA,EAAE,OAAO,KAAKH;QAClD,IAAI,CAACE,OAAO;YACR,MAAME,QAAQV,YAAY,GAAG,CAACS,CAAAA,IAAK,CAAC,CAAC,EAAEA,EAAE,EAAE,CAAC,GAAG,EAAEA,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;YACpE,MAAM,IAAIJ,MACN,CAAC,qCAAqC,EAAEC,WAAW,2BAA2B,EAAEI,MAAM,CAAC,CAAC;QAEhG;QACA,OAAOF;IACX;IAEA,MAAc,OAAOf,UAA+B,EAAmB;QACnE,MAAMkB,WACF,QAAQlB,aACDA,WAA6B,EAAE,GAChC,GAAGA,WAAW,OAAO,CAAC,CAAC,EAAEA,WAAW,MAAM,IAAI,WAAW;QAEnE,MAAMmB,SAAS,IAAI,CAAC,QAAQ,CAAC,GAAG,CAACD;QACjC,IAAIC,QACA,OAAOA;QAGX,MAAM5B,UAAU,IAAI,CAAC,YAAY,CAAC,IAAI,CAACkB,CAAAA,IAAKA,EAAE,EAAE,KAAKT,WAAW,OAAO;QACvE,IAAI,CAACT,SAAS;YACV,MAAM0B,QAAQ,IAAI,CAAC,YAAY,CAAC,GAAG,CAACR,CAAAA,IAAK,CAAC,CAAC,EAAEA,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;YAC3D,MAAM,IAAIG,MACN,CAAC,6BAA6B,EAAEZ,WAAW,OAAO,CAAC,yBAAyB,EAAEiB,MAAM,CAAC,CAAC;QAE9F;QAEA,MAAMH,MAAM,MAAMvB,QAAQ,OAAO,CAACS,WAAW,MAAM;QACnD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAACkB,UAAUJ;QAC5B,OAAOA;IACX;AACJ;AAEO,MAAMM,QAAKC,qBAAqB;IACnC,aAAaC;IACb,gBAAgB5B;IAChB,cAAc;QACV;YAAC6B;YAAc;gBAAE,UAAU;YAAK;SAAE;QAClC;YAACC;YAAqB;gBAAE,UAAU;YAAK;SAAE;KAC5C;AACL"}
+{"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 type { AiGenerateTextParams, AiModel, IAiSdkFactory } 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\nfunction toAiModel(factory: IAiSdkFactory, modelId: string, modelName: string): AiModel {\n    return {\n        providerId: factory.id,\n        providerName: factory.name,\n        modelId,\n        modelName\n    };\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    ) {}\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 Promise.resolve(\n            this.sdkFactories.flatMap(factory =>\n                factory.models.map(m => toAiModel(factory, m.id, m.name))\n            )\n        );\n    }\n\n    async listModelsByConnections(): Promise<AiModel[]> {\n        const connections = await this.getConnections();\n        return connections.flatMap(conn => {\n            const factory = this.sdkFactories.find(f => f.id === conn.sdkName);\n            if (!factory) {\n                return [];\n            }\n            return factory.models.map(m => toAiModel(factory, m.id, m.name));\n        });\n    }\n\n    async listModelsByConnection(connection: string | IAiConnectionInline): Promise<AiModel[]> {\n        const conn = await this.resolveConnection(undefined, connection);\n        const factory = this.sdkFactories.find(f => f.id === conn.sdkName);\n        if (!factory) {\n            return [];\n        }\n        return factory.models.map(m => toAiModel(factory, m.id, m.name));\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 modelName = modelId.slice(slashIndex + 1);\n\n        const conn = await this.resolveConnection(providerId, connection);\n        const sdk = await this.getSdk(conn);\n        return sdk.languageModel(modelName);\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    ]\n});\n"],"names":["toAiModel","factory","modelId","modelName","AiImpl","sdkFactories","connectionFactories","eventPublisher","Map","params","model","connection","rest","resolvedModel","requestId","mdbid","AiBeforeGenerateTextEvent","start","performance","result","generateText","duration","AiAfterGenerateTextEvent","err","error","Error","String","AiGenerateTextErrorEvent","AiBeforeStreamTextEvent","streamText","Promise","m","connections","conn","f","undefined","slashIndex","providerId","sdk","found","c","known","cacheKey","cached","Ai","createImplementation","AiAbstraction","AiSdkFactory","AiConnectionFactory","EventPublisher"],"mappings":"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"}

package/features/ai/AnthropicSdkFactory.js

@@ -1,6 +1,18 @@
 import { createImplementation } from "@webiny/feature/api";
 import { AiSdkFactory } from "./abstractions.js";
 const ANTHROPIC_MODELS = [
+    {
+        id: "claude-opus-5",
+        name: "Claude Opus 5"
+    },
+    {
+        id: "claude-sonnet-5",
+        name: "Claude Sonnet 5"
+    },
+    {
+        id: "claude-fable-5",
+        name: "Claude Fable 5"
+    },
     {
         id: "claude-opus-4-7",
         name: "Claude Opus 4.7"

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-opus-5\", name: \"Claude Opus 5\" },\n    { id: \"claude-sonnet-5\", name: \"Claude Sonnet 5\" },\n    { id: \"claude-fable-5\", name: \"Claude Fable 5\" },\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;QAAiB,MAAM;IAAgB;IAC7C;QAAE,IAAI;QAAmB,MAAM;IAAkB;IACjD;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;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"}

package/features/ai/OpenAiSdkFactory.js

@@ -1,6 +1,22 @@
 import { createImplementation } from "@webiny/feature/api";
 import { AiSdkFactory } from "./abstractions.js";
 const OPENAI_MODELS = [
+    {
+        id: "gpt-5.6-sol",
+        name: "GPT-5.6 Sol"
+    },
+    {
+        id: "gpt-5.6-terra",
+        name: "GPT-5.6 Terra"
+    },
+    {
+        id: "gpt-5.6-luna",
+        name: "GPT-5.6 Luna"
+    },
+    {
+        id: "gpt-5.5",
+        name: "GPT-5.5"
+    },
     {
         id: "gpt-5.4",
         name: "GPT-5.4"

package/features/ai/OpenAiSdkFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"features/ai/OpenAiSdkFactory.js","sources":["../../../src/features/ai/OpenAiSdkFactory.ts"],"sourcesContent":["import { createImplementation } from \"@webiny/feature/api\";\nimport { AiSdkFactory as AiSdkFactoryAbstraction } from \"./abstractions.js\";\nimport type { IAiSdk, IAiSdkModel } from \"./abstractions.js\";\n\nconst OPENAI_MODELS: IAiSdkModel[] = [\n    { id: \"gpt-5.4\", name: \"GPT-5.4\" },\n    { id: \"gpt-5.4-mini\", name: \"GPT-5.4 Mini\" },\n    { id: \"gpt-5.4-nano\", name: \"GPT-5.4 Nano\" },\n    { id: \"gpt-5.4-pro\", name: \"GPT-5.4 Pro\" },\n    { id: \"gpt-5.3-chat-latest\", name: \"GPT-5.3 Chat\" },\n    { id: \"gpt-4.1\", name: \"GPT-4.1\" },\n    { id: \"gpt-4.1-mini\", name: \"GPT-4.1 Mini\" },\n    { id: \"gpt-4.1-nano\", name: \"GPT-4.1 Nano\" },\n    { id: \"gpt-4o\", name: \"GPT-4o\" },\n    { id: \"gpt-4o-mini\", name: \"GPT-4o Mini\" },\n    { id: \"o4-mini\", name: \"o4 Mini\" },\n    { id: \"o3\", name: \"o3\" }\n];\n\nclass OpenAiSdkFactoryImpl implements AiSdkFactoryAbstraction.Interface {\n    readonly id = \"openai\";\n    readonly name = \"OpenAI\";\n    readonly models = OPENAI_MODELS;\n\n    async execute(apiKey?: string): Promise<IAiSdk> {\n        const { createOpenAI } = await import(\"@ai-sdk/openai\");\n        const provider = createOpenAI({\n            apiKey: apiKey ?? process.env.WEBINY_API_OPENAI_API_KEY\n        });\n        return {\n            languageModel: modelId => provider.chat(modelId)\n        };\n    }\n}\n\nexport const OpenAiSdkFactory = createImplementation({\n    abstraction: AiSdkFactoryAbstraction,\n    implementation: OpenAiSdkFactoryImpl,\n    dependencies: []\n});\n"],"names":["OPENAI_MODELS","OpenAiSdkFactoryImpl","apiKey","createOpenAI","provider","process","modelId","OpenAiSdkFactory","createImplementation","AiSdkFactoryAbstraction"],"mappings":";;AAIA,MAAMA,gBAA+B;IACjC;QAAE,IAAI;QAAW,MAAM;IAAU;IACjC;QAAE,IAAI;QAAgB,MAAM;IAAe;IAC3C;QAAE,IAAI;QAAgB,MAAM;IAAe;IAC3C;QAAE,IAAI;QAAe,MAAM;IAAc;IACzC;QAAE,IAAI;QAAuB,MAAM;IAAe;IAClD;QAAE,IAAI;QAAW,MAAM;IAAU;IACjC;QAAE,IAAI;QAAgB,MAAM;IAAe;IAC3C;QAAE,IAAI;QAAgB,MAAM;IAAe;IAC3C;QAAE,IAAI;QAAU,MAAM;IAAS;IAC/B;QAAE,IAAI;QAAe,MAAM;IAAc;IACzC;QAAE,IAAI;QAAW,MAAM;IAAU;IACjC;QAAE,IAAI;QAAM,MAAM;IAAK;CAC1B;AAED,MAAMC;IAKF,MAAM,QAAQC,MAAe,EAAmB;QAC5C,MAAM,EAAEC,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC;QACtC,MAAMC,WAAWD,aAAa;YAC1B,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,GAAGN;;AAWtB;AAEO,MAAMO,mBAAmBC,qBAAqB;IACjD,aAAaC;IACb,gBAAgBR;IAChB,cAAc,EAAE;AACpB"}
+{"version":3,"file":"features/ai/OpenAiSdkFactory.js","sources":["../../../src/features/ai/OpenAiSdkFactory.ts"],"sourcesContent":["import { createImplementation } from \"@webiny/feature/api\";\nimport { AiSdkFactory as AiSdkFactoryAbstraction } from \"./abstractions.js\";\nimport type { IAiSdk, IAiSdkModel } from \"./abstractions.js\";\n\nconst OPENAI_MODELS: IAiSdkModel[] = [\n    { id: \"gpt-5.6-sol\", name: \"GPT-5.6 Sol\" },\n    { id: \"gpt-5.6-terra\", name: \"GPT-5.6 Terra\" },\n    { id: \"gpt-5.6-luna\", name: \"GPT-5.6 Luna\" },\n    { id: \"gpt-5.5\", name: \"GPT-5.5\" },\n    { id: \"gpt-5.4\", name: \"GPT-5.4\" },\n    { id: \"gpt-5.4-mini\", name: \"GPT-5.4 Mini\" },\n    { id: \"gpt-5.4-nano\", name: \"GPT-5.4 Nano\" },\n    { id: \"gpt-5.4-pro\", name: \"GPT-5.4 Pro\" },\n    { id: \"gpt-5.3-chat-latest\", name: \"GPT-5.3 Chat\" },\n    { id: \"gpt-4.1\", name: \"GPT-4.1\" },\n    { id: \"gpt-4.1-mini\", name: \"GPT-4.1 Mini\" },\n    { id: \"gpt-4.1-nano\", name: \"GPT-4.1 Nano\" },\n    { id: \"gpt-4o\", name: \"GPT-4o\" },\n    { id: \"gpt-4o-mini\", name: \"GPT-4o Mini\" },\n    { id: \"o4-mini\", name: \"o4 Mini\" },\n    { id: \"o3\", name: \"o3\" }\n];\n\nclass OpenAiSdkFactoryImpl implements AiSdkFactoryAbstraction.Interface {\n    readonly id = \"openai\";\n    readonly name = \"OpenAI\";\n    readonly models = OPENAI_MODELS;\n\n    async execute(apiKey?: string): Promise<IAiSdk> {\n        const { createOpenAI } = await import(\"@ai-sdk/openai\");\n        const provider = createOpenAI({\n            apiKey: apiKey ?? process.env.WEBINY_API_OPENAI_API_KEY\n        });\n        return {\n            languageModel: modelId => provider.chat(modelId)\n        };\n    }\n}\n\nexport const OpenAiSdkFactory = createImplementation({\n    abstraction: AiSdkFactoryAbstraction,\n    implementation: OpenAiSdkFactoryImpl,\n    dependencies: []\n});\n"],"names":["OPENAI_MODELS","OpenAiSdkFactoryImpl","apiKey","createOpenAI","provider","process","modelId","OpenAiSdkFactory","createImplementation","AiSdkFactoryAbstraction"],"mappings":";;AAIA,MAAMA,gBAA+B;IACjC;QAAE,IAAI;QAAe,MAAM;IAAc;IACzC;QAAE,IAAI;QAAiB,MAAM;IAAgB;IAC7C;QAAE,IAAI;QAAgB,MAAM;IAAe;IAC3C;QAAE,IAAI;QAAW,MAAM;IAAU;IACjC;QAAE,IAAI;QAAW,MAAM;IAAU;IACjC;QAAE,IAAI;QAAgB,MAAM;IAAe;IAC3C;QAAE,IAAI;QAAgB,MAAM;IAAe;IAC3C;QAAE,IAAI;QAAe,MAAM;IAAc;IACzC;QAAE,IAAI;QAAuB,MAAM;IAAe;IAClD;QAAE,IAAI;QAAW,MAAM;IAAU;IACjC;QAAE,IAAI;QAAgB,MAAM;IAAe;IAC3C;QAAE,IAAI;QAAgB,MAAM;IAAe;IAC3C;QAAE,IAAI;QAAU,MAAM;IAAS;IAC/B;QAAE,IAAI;QAAe,MAAM;IAAc;IACzC;QAAE,IAAI;QAAW,MAAM;IAAU;IACjC;QAAE,IAAI;QAAM,MAAM;IAAK;CAC1B;AAED,MAAMC;IAKF,MAAM,QAAQC,MAAe,EAAmB;QAC5C,MAAM,EAAEC,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC;QACtC,MAAMC,WAAWD,aAAa;YAC1B,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,GAAGN;;AAWtB;AAEO,MAAMO,mBAAmBC,qBAAqB;IACjD,aAAaC;IACb,gBAAgBR;IAChB,cAAc,EAAE;AACpB"}

package/features/ai/TextExtractor/DefaultTextExtractor.d.ts

@@ -0,0 +1,9 @@
+import { TextExtractor, type TextExtractorResult } from "./abstractions.js";
+declare class TextExtractorImpl implements TextExtractor.Interface {
+    canExtract(mimeType: string): boolean;
+    extract(buffer: Buffer, mimeType: string): Promise<TextExtractorResult>;
+}
+export declare const DefaultTextExtractor: typeof TextExtractorImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("./abstractions.js").ITextExtractor>;
+};
+export {};

package/features/ai/TextExtractor/DefaultTextExtractor.js

@@ -0,0 +1,28 @@
+import { TextExtractor } from "./abstractions.js";
+import { extractDocxText } from "./parsers/docxParser.js";
+const TEXT_MIME_PREFIX = "text/";
+const SUPPORTED_MIME_TYPES = new Set([
+    "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    "application/json"
+]);
+class TextExtractorImpl {
+    canExtract(mimeType) {
+        return mimeType.startsWith(TEXT_MIME_PREFIX) || SUPPORTED_MIME_TYPES.has(mimeType);
+    }
+    async extract(buffer, mimeType) {
+        if (mimeType.startsWith(TEXT_MIME_PREFIX) || "application/json" === mimeType) return {
+            text: buffer.toString("utf-8")
+        };
+        if ("application/vnd.openxmlformats-officedocument.wordprocessingml.document" === mimeType) return {
+            text: await extractDocxText(buffer)
+        };
+        throw new Error(`Unsupported MIME type: ${mimeType}`);
+    }
+}
+const DefaultTextExtractor = TextExtractor.createImplementation({
+    implementation: TextExtractorImpl,
+    dependencies: []
+});
+export { DefaultTextExtractor };
+
+//# sourceMappingURL=DefaultTextExtractor.js.map

package/features/ai/TextExtractor/DefaultTextExtractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/ai/TextExtractor/DefaultTextExtractor.js","sources":["../../../../src/features/ai/TextExtractor/DefaultTextExtractor.ts"],"sourcesContent":["import { TextExtractor, type TextExtractorResult } from \"./abstractions.js\";\nimport { extractDocxText } from \"./parsers/docxParser.js\";\n\nconst TEXT_MIME_PREFIX = \"text/\";\n\nconst SUPPORTED_MIME_TYPES = new Set([\n    \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\",\n    \"application/json\"\n]);\n\nclass TextExtractorImpl implements TextExtractor.Interface {\n    canExtract(mimeType: string): boolean {\n        return mimeType.startsWith(TEXT_MIME_PREFIX) || SUPPORTED_MIME_TYPES.has(mimeType);\n    }\n\n    async extract(buffer: Buffer, mimeType: string): Promise<TextExtractorResult> {\n        if (mimeType.startsWith(TEXT_MIME_PREFIX) || mimeType === \"application/json\") {\n            return { text: buffer.toString(\"utf-8\") };\n        }\n\n        if (\n            mimeType === \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\"\n        ) {\n            return { text: await extractDocxText(buffer) };\n        }\n\n        throw new Error(`Unsupported MIME type: ${mimeType}`);\n    }\n}\n\nexport const DefaultTextExtractor = TextExtractor.createImplementation({\n    implementation: TextExtractorImpl,\n    dependencies: []\n});\n"],"names":["TEXT_MIME_PREFIX","SUPPORTED_MIME_TYPES","Set","TextExtractorImpl","mimeType","buffer","extractDocxText","Error","DefaultTextExtractor","TextExtractor"],"mappings":";;AAGA,MAAMA,mBAAmB;AAEzB,MAAMC,uBAAuB,IAAIC,IAAI;IACjC;IACA;CACH;AAED,MAAMC;IACF,WAAWC,QAAgB,EAAW;QAClC,OAAOA,SAAS,UAAU,CAACJ,qBAAqBC,qBAAqB,GAAG,CAACG;IAC7E;IAEA,MAAM,QAAQC,MAAc,EAAED,QAAgB,EAAgC;QAC1E,IAAIA,SAAS,UAAU,CAACJ,qBAAqBI,AAAa,uBAAbA,UACzC,OAAO;YAAE,MAAMC,OAAO,QAAQ,CAAC;QAAS;QAG5C,IACID,AAAa,8EAAbA,UAEA,OAAO;YAAE,MAAM,MAAME,gBAAgBD;QAAQ;QAGjD,MAAM,IAAIE,MAAM,CAAC,uBAAuB,EAAEH,UAAU;IACxD;AACJ;AAEO,MAAMI,uBAAuBC,cAAc,oBAAoB,CAAC;IACnE,gBAAgBN;IAChB,cAAc,EAAE;AACpB"}

package/features/ai/TextExtractor/abstractions.d.ts

@@ -0,0 +1,12 @@
+export interface TextExtractorResult {
+    text: string;
+}
+export interface ITextExtractor {
+    canExtract(mimeType: string): boolean;
+    extract(buffer: Buffer, mimeType: string): Promise<TextExtractorResult>;
+}
+export declare const TextExtractor: import("@webiny/di").Abstraction<ITextExtractor>;
+export declare namespace TextExtractor {
+    type Interface = ITextExtractor;
+    type Result = TextExtractorResult;
+}

package/features/ai/TextExtractor/abstractions.js

@@ -0,0 +1,5 @@
+import { createAbstraction } from "@webiny/feature/api";
+const TextExtractor = createAbstraction("TextExtractor");
+export { TextExtractor };
+
+//# sourceMappingURL=abstractions.js.map

package/features/ai/TextExtractor/abstractions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/ai/TextExtractor/abstractions.js","sources":["../../../../src/features/ai/TextExtractor/abstractions.ts"],"sourcesContent":["import { createAbstraction } from \"@webiny/feature/api\";\n\nexport interface TextExtractorResult {\n    text: string;\n}\n\nexport interface ITextExtractor {\n    canExtract(mimeType: string): boolean;\n    extract(buffer: Buffer, mimeType: string): Promise<TextExtractorResult>;\n}\n\nexport const TextExtractor = createAbstraction<ITextExtractor>(\"TextExtractor\");\n\nexport namespace TextExtractor {\n    export type Interface = ITextExtractor;\n    export type Result = TextExtractorResult;\n}\n"],"names":["TextExtractor","createAbstraction"],"mappings":";AAWO,MAAMA,gBAAgBC,kBAAkC"}

package/features/ai/TextExtractor/index.d.ts

@@ -0,0 +1,3 @@
+export { TextExtractor } from "./abstractions.js";
+export type { ITextExtractor, TextExtractorResult } from "./abstractions.js";
+export { DefaultTextExtractor } from "./DefaultTextExtractor.js";

package/features/ai/TextExtractor/index.js

@@ -0,0 +1,2 @@
+export { TextExtractor } from "./abstractions.js";
+export { DefaultTextExtractor } from "./DefaultTextExtractor.js";

package/features/ai/TextExtractor/parsers/docxParser.d.ts

@@ -0,0 +1 @@
+export declare function extractDocxText(buffer: Buffer): Promise<string>;

package/features/ai/TextExtractor/parsers/docxParser.js

@@ -0,0 +1,111 @@
+import { inflateRawSync } from "node:zlib";
+async function extractDocxText(buffer) {
+    const xml = extractFileFromZip(buffer, "word/document.xml");
+    if (!xml) throw new Error("Invalid DOCX: word/document.xml not found.");
+    const stylesXml = extractFileFromZip(buffer, "word/styles.xml");
+    const styleMap = stylesXml ? buildStyleMap(stylesXml) : new Map();
+    return convertToMarkdown(xml, styleMap);
+}
+function buildStyleMap(stylesXml) {
+    const map = new Map();
+    const styleRegex = /<w:style\s[^>]*w:styleId="([^"]*)"[^>]*>[\s\S]*?<\/w:style>/g;
+    let match;
+    while(null !== (match = styleRegex.exec(stylesXml))){
+        const styleId = match[1];
+        const block = match[0];
+        const nameMatch = block.match(/<w:name\s+w:val="([^"]*)"/);
+        if (nameMatch) map.set(styleId, nameMatch[1]);
+    }
+    return map;
+}
+function getHeadingLevel(paragraphXml, styleMap) {
+    const styleMatch = paragraphXml.match(/<w:pStyle\s+w:val="([^"]*)"/);
+    if (!styleMatch) return 0;
+    const styleId = styleMatch[1];
+    const directMatch = styleId.match(/^[Hh]eading(\d)$/);
+    if (directMatch) return parseInt(directMatch[1], 10);
+    const styleName = styleMap.get(styleId) ?? "";
+    const nameMatch = styleName.match(/^[Hh]eading\s*(\d)$/);
+    if (nameMatch) return parseInt(nameMatch[1], 10);
+    if (/title/i.test(styleName) || /title/i.test(styleId)) return 1;
+    return 0;
+}
+function isListItem(paragraphXml) {
+    return /<w:numId\s/.test(paragraphXml);
+}
+function extractRunMarkdown(runXml) {
+    const textRegex = /<w:t(?:\s[^>]*)?>([^<]*)<\/w:t>/g;
+    const texts = [];
+    let match;
+    while(null !== (match = textRegex.exec(runXml)))texts.push(match[1]);
+    if (0 === texts.length) return "";
+    const text = texts.join("");
+    const isBold = /<w:b[\s/>]/.test(runXml) && !/<w:b\s+w:val="(false|0)"/.test(runXml);
+    const isItalic = /<w:i[\s/>]/.test(runXml) && !/<w:i\s+w:val="(false|0)"/.test(runXml);
+    if (isBold && isItalic) return `***${text}***`;
+    if (isBold) return `**${text}**`;
+    if (isItalic) return `*${text}*`;
+    return text;
+}
+function convertToMarkdown(xml, styleMap) {
+    const paragraphs = [];
+    const paragraphRegex = /<w:p[\s>][\s\S]*?<\/w:p>/g;
+    let paragraphMatch;
+    while(null !== (paragraphMatch = paragraphRegex.exec(xml))){
+        const paragraphXml = paragraphMatch[0];
+        const runRegex = /<w:r[\s>][\s\S]*?<\/w:r>/g;
+        const runs = [];
+        let runMatch;
+        while(null !== (runMatch = runRegex.exec(paragraphXml))){
+            const md = extractRunMarkdown(runMatch[0]);
+            if (md) runs.push(md);
+        }
+        if (0 === runs.length) continue;
+        let line = runs.join("");
+        const headingLevel = getHeadingLevel(paragraphXml, styleMap);
+        if (headingLevel > 0 && headingLevel <= 6) line = `${"#".repeat(headingLevel)} ${line}`;
+        else if (isListItem(paragraphXml)) line = `- ${line}`;
+        paragraphs.push(line);
+    }
+    return paragraphs.join("\n\n");
+}
+function extractFileFromZip(buffer, targetPath) {
+    const eocdOffset = findEocd(buffer);
+    if (-1 === eocdOffset) throw new Error("Invalid ZIP: End of Central Directory not found.");
+    const cdOffset = buffer.readUInt32LE(eocdOffset + 16);
+    const cdSize = buffer.readUInt32LE(eocdOffset + 12);
+    const cdEnd = cdOffset + cdSize;
+    let offset = cdOffset;
+    while(offset < cdEnd){
+        const sig = buffer.readUInt32LE(offset);
+        if (0x02014b50 !== sig) break;
+        const compressionMethod = buffer.readUInt16LE(offset + 10);
+        const compressedSize = buffer.readUInt32LE(offset + 20);
+        const fileNameLen = buffer.readUInt16LE(offset + 28);
+        const extraLen = buffer.readUInt16LE(offset + 30);
+        const commentLen = buffer.readUInt16LE(offset + 32);
+        const localHeaderOffset = buffer.readUInt32LE(offset + 42);
+        const fileName = buffer.toString("utf-8", offset + 46, offset + 46 + fileNameLen);
+        if (fileName === targetPath) return readLocalFile(buffer, localHeaderOffset, compressionMethod, compressedSize);
+        offset += 46 + fileNameLen + extraLen + commentLen;
+    }
+    return null;
+}
+function readLocalFile(buffer, offset, compressionMethod, compressedSize) {
+    const sig = buffer.readUInt32LE(offset);
+    if (0x04034b50 !== sig) throw new Error("Invalid ZIP: bad local file header.");
+    const localFileNameLen = buffer.readUInt16LE(offset + 26);
+    const localExtraLen = buffer.readUInt16LE(offset + 28);
+    const dataOffset = offset + 30 + localFileNameLen + localExtraLen;
+    const raw = buffer.subarray(dataOffset, dataOffset + compressedSize);
+    if (0 === compressionMethod) return raw.toString("utf-8");
+    if (8 === compressionMethod) return inflateRawSync(raw).toString("utf-8");
+    throw new Error(`Unsupported ZIP compression method: ${compressionMethod}`);
+}
+function findEocd(buffer) {
+    for(let i = buffer.length - 22; i >= Math.max(0, buffer.length - 65557); i--)if (0x06054b50 === buffer.readUInt32LE(i)) return i;
+    return -1;
+}
+export { extractDocxText };
+
+//# sourceMappingURL=docxParser.js.map

package/features/ai/TextExtractor/parsers/docxParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/ai/TextExtractor/parsers/docxParser.js","sources":["../../../../../src/features/ai/TextExtractor/parsers/docxParser.ts"],"sourcesContent":["import { inflateRawSync } from \"node:zlib\";\n\nexport async function extractDocxText(buffer: Buffer): Promise<string> {\n    const xml = extractFileFromZip(buffer, \"word/document.xml\");\n    if (!xml) {\n        throw new Error(\"Invalid DOCX: word/document.xml not found.\");\n    }\n\n    const stylesXml = extractFileFromZip(buffer, \"word/styles.xml\");\n    const styleMap = stylesXml ? buildStyleMap(stylesXml) : new Map<string, string>();\n\n    return convertToMarkdown(xml, styleMap);\n}\n\nfunction buildStyleMap(stylesXml: string): Map<string, string> {\n    const map = new Map<string, string>();\n    const styleRegex = /<w:style\\s[^>]*w:styleId=\"([^\"]*)\"[^>]*>[\\s\\S]*?<\\/w:style>/g;\n    let match: RegExpExecArray | null;\n\n    while ((match = styleRegex.exec(stylesXml)) !== null) {\n        const styleId = match[1];\n        const block = match[0];\n        const nameMatch = block.match(/<w:name\\s+w:val=\"([^\"]*)\"/);\n        if (nameMatch) {\n            map.set(styleId, nameMatch[1]);\n        }\n    }\n\n    return map;\n}\n\nfunction getHeadingLevel(paragraphXml: string, styleMap: Map<string, string>): number {\n    const styleMatch = paragraphXml.match(/<w:pStyle\\s+w:val=\"([^\"]*)\"/);\n    if (!styleMatch) {\n        return 0;\n    }\n\n    const styleId = styleMatch[1];\n\n    const directMatch = styleId.match(/^[Hh]eading(\\d)$/);\n    if (directMatch) {\n        return parseInt(directMatch[1], 10);\n    }\n\n    const styleName = styleMap.get(styleId) ?? \"\";\n    const nameMatch = styleName.match(/^[Hh]eading\\s*(\\d)$/);\n    if (nameMatch) {\n        return parseInt(nameMatch[1], 10);\n    }\n\n    if (/title/i.test(styleName) || /title/i.test(styleId)) {\n        return 1;\n    }\n\n    return 0;\n}\n\nfunction isListItem(paragraphXml: string): boolean {\n    return /<w:numId\\s/.test(paragraphXml);\n}\n\nfunction extractRunMarkdown(runXml: string): string {\n    const textRegex = /<w:t(?:\\s[^>]*)?>([^<]*)<\\/w:t>/g;\n    const texts: string[] = [];\n    let match: RegExpExecArray | null;\n    while ((match = textRegex.exec(runXml)) !== null) {\n        texts.push(match[1]);\n    }\n    if (texts.length === 0) {\n        return \"\";\n    }\n\n    const text = texts.join(\"\");\n    const isBold = /<w:b[\\s/>]/.test(runXml) && !/<w:b\\s+w:val=\"(false|0)\"/.test(runXml);\n    const isItalic = /<w:i[\\s/>]/.test(runXml) && !/<w:i\\s+w:val=\"(false|0)\"/.test(runXml);\n\n    if (isBold && isItalic) {\n        return `***${text}***`;\n    }\n    if (isBold) {\n        return `**${text}**`;\n    }\n    if (isItalic) {\n        return `*${text}*`;\n    }\n    return text;\n}\n\nfunction convertToMarkdown(xml: string, styleMap: Map<string, string>): string {\n    const paragraphs: string[] = [];\n    const paragraphRegex = /<w:p[\\s>][\\s\\S]*?<\\/w:p>/g;\n    let paragraphMatch: RegExpExecArray | null;\n\n    while ((paragraphMatch = paragraphRegex.exec(xml)) !== null) {\n        const paragraphXml = paragraphMatch[0];\n\n        const runRegex = /<w:r[\\s>][\\s\\S]*?<\\/w:r>/g;\n        const runs: string[] = [];\n        let runMatch: RegExpExecArray | null;\n        while ((runMatch = runRegex.exec(paragraphXml)) !== null) {\n            const md = extractRunMarkdown(runMatch[0]);\n            if (md) {\n                runs.push(md);\n            }\n        }\n\n        if (runs.length === 0) {\n            continue;\n        }\n\n        let line = runs.join(\"\");\n        const headingLevel = getHeadingLevel(paragraphXml, styleMap);\n\n        if (headingLevel > 0 && headingLevel <= 6) {\n            line = `${\"#\".repeat(headingLevel)} ${line}`;\n        } else if (isListItem(paragraphXml)) {\n            line = `- ${line}`;\n        }\n\n        paragraphs.push(line);\n    }\n\n    return paragraphs.join(\"\\n\\n\");\n}\n\n// --- ZIP utilities (unchanged) ---\n\nfunction extractFileFromZip(buffer: Buffer, targetPath: string): string | null {\n    const eocdOffset = findEocd(buffer);\n    if (eocdOffset === -1) {\n        throw new Error(\"Invalid ZIP: End of Central Directory not found.\");\n    }\n\n    const cdOffset = buffer.readUInt32LE(eocdOffset + 16);\n    const cdSize = buffer.readUInt32LE(eocdOffset + 12);\n    const cdEnd = cdOffset + cdSize;\n    let offset = cdOffset;\n\n    while (offset < cdEnd) {\n        const sig = buffer.readUInt32LE(offset);\n        if (sig !== 0x02014b50) {\n            break;\n        }\n\n        const compressionMethod = buffer.readUInt16LE(offset + 10);\n        const compressedSize = buffer.readUInt32LE(offset + 20);\n        const fileNameLen = buffer.readUInt16LE(offset + 28);\n        const extraLen = buffer.readUInt16LE(offset + 30);\n        const commentLen = buffer.readUInt16LE(offset + 32);\n        const localHeaderOffset = buffer.readUInt32LE(offset + 42);\n        const fileName = buffer.toString(\"utf-8\", offset + 46, offset + 46 + fileNameLen);\n\n        if (fileName === targetPath) {\n            return readLocalFile(buffer, localHeaderOffset, compressionMethod, compressedSize);\n        }\n\n        offset += 46 + fileNameLen + extraLen + commentLen;\n    }\n\n    return null;\n}\n\nfunction readLocalFile(\n    buffer: Buffer,\n    offset: number,\n    compressionMethod: number,\n    compressedSize: number\n): string {\n    const sig = buffer.readUInt32LE(offset);\n    if (sig !== 0x04034b50) {\n        throw new Error(\"Invalid ZIP: bad local file header.\");\n    }\n\n    const localFileNameLen = buffer.readUInt16LE(offset + 26);\n    const localExtraLen = buffer.readUInt16LE(offset + 28);\n    const dataOffset = offset + 30 + localFileNameLen + localExtraLen;\n\n    const raw = buffer.subarray(dataOffset, dataOffset + compressedSize);\n\n    if (compressionMethod === 0) {\n        return raw.toString(\"utf-8\");\n    }\n\n    if (compressionMethod === 8) {\n        return inflateRawSync(raw).toString(\"utf-8\");\n    }\n\n    throw new Error(`Unsupported ZIP compression method: ${compressionMethod}`);\n}\n\nfunction findEocd(buffer: Buffer): number {\n    for (let i = buffer.length - 22; i >= Math.max(0, buffer.length - 65557); i--) {\n        if (buffer.readUInt32LE(i) === 0x06054b50) {\n            return i;\n        }\n    }\n    return -1;\n}\n"],"names":["extractDocxText","buffer","xml","extractFileFromZip","Error","stylesXml","styleMap","buildStyleMap","Map","convertToMarkdown","map","styleRegex","match","styleId","block","nameMatch","getHeadingLevel","paragraphXml","styleMatch","directMatch","parseInt","styleName","isListItem","extractRunMarkdown","runXml","textRegex","texts","text","isBold","isItalic","paragraphs","paragraphRegex","paragraphMatch","runRegex","runs","runMatch","md","line","headingLevel","targetPath","eocdOffset","findEocd","cdOffset","cdSize","cdEnd","offset","sig","compressionMethod","compressedSize","fileNameLen","extraLen","commentLen","localHeaderOffset","fileName","readLocalFile","localFileNameLen","localExtraLen","dataOffset","raw","inflateRawSync","i","Math"],"mappings":"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"}

package/features/ai/abstractions.d.ts

@@ -70,16 +70,35 @@ export declare namespace Ai {
     type GenerateTextParams = AiGenerateTextParams;
     type StreamTextParams = AiStreamTextParams;
 }
+/**
+ * Behavioural hints about a tool. Purely advisory — they never replace a permission check.
+ * Names mirror the MCP tool annotations so they can be forwarded verbatim to MCP clients,
+ * which use them to decide what to auto-approve and what to confirm with the user.
+ */
+export interface IAiSdkToolAnnotations {
+    /** Tool does not modify state. */
+    readOnlyHint?: boolean;
+    /** Tool may perform destructive updates (only meaningful when not read-only). */
+    destructiveHint?: boolean;
+    /** Repeated calls with the same arguments have no additional effect. */
+    idempotentHint?: boolean;
+    /** Tool interacts with entities outside its own closed world. */
+    openWorldHint?: boolean;
+}
 export interface IAiSdkTool<TInput = any> {
     readonly name: string;
     readonly description: string;
     readonly inputSchema: FlexibleSchema<TInput>;
+    /** Human-friendly display name. Falls back to `name` when omitted. */
+    readonly title?: string;
+    readonly annotations?: IAiSdkToolAnnotations;
     execute(input: TInput): Promise<unknown>;
 }
 /** A single tool that can be provided to AI generateText/streamText calls. */
 export declare const AiSdkTool: import("@webiny/di").Abstraction<IAiSdkTool<any>>;
 export declare namespace AiSdkTool {
     type Interface = IAiSdkTool;
+    type Annotations = IAiSdkToolAnnotations;
 }
 export interface IAiSdkTools {
     getToolSet(): ToolSet;

package/features/ai/abstractions.js.map

@@ -1 +1 @@
-{"version":3,"file":"features/ai/abstractions.js","sources":["../../../src/features/ai/abstractions.ts"],"sourcesContent":["import { createAbstraction } from \"@webiny/feature/api\";\nimport type { generateText } from \"ai\";\nimport type { streamText } from \"ai\";\nimport type { LanguageModel } from \"ai\";\nimport type { FlexibleSchema, ToolSet } from \"ai\";\n\n// AiSdk\n\nexport interface IAiSdkModel {\n    id: string; // raw model id, e.g. \"claude-sonnet-4-5\"\n    name: string; // human-friendly name, e.g. \"Claude Sonnet 4.5\"\n}\n\nexport interface IAiSdk {\n    languageModel(modelId: string): LanguageModel;\n}\n\n/** A single AI SDK instance (e.g. OpenAI, Anthropic) that resolves model instances. */\nexport const AiSdk = createAbstraction<IAiSdk>(\"AiSdk\");\n\nexport namespace AiSdk {\n    export type Interface = IAiSdk;\n}\n\n// AiSdkFactory\n\nexport interface IAiSdkFactory {\n    readonly id: string; // machine id, e.g. \"anthropic\"\n    readonly name: string; // human-friendly name, e.g. \"Anthropic\"\n    readonly models: readonly IAiSdkModel[]; // static model list, no API call needed\n    execute(apiKey?: string): Promise<IAiSdk>;\n}\n\n/** Factory that asynchronously initialises an AI SDK. Register one per provider namespace. */\nexport const AiSdkFactory = createAbstraction<IAiSdkFactory>(\"AiSdkFactory\");\n\nexport namespace AiSdkFactory {\n    export type Interface = IAiSdkFactory;\n}\n\n// AiConnection\n\nexport interface IAiConnectionInline {\n    readonly sdkName: string;\n    readonly apiKey?: string;\n}\n\nexport interface IAiConnection extends IAiConnectionInline {\n    readonly id: string;\n}\n\n// AiConnectionFactory\n\nexport interface IAiConnectionFactory {\n    execute(): Promise<IAiConnection>;\n}\n\n/** Factory that asynchronously produces an AiConnection. */\nexport const AiConnectionFactory = createAbstraction<IAiConnectionFactory>(\"AiConnectionFactory\");\n\nexport namespace AiConnectionFactory {\n    export type Interface = IAiConnectionFactory;\n}\n\n// Ai\n\ntype SDKGenerateTextParams = Parameters<typeof generateText>[0];\ntype SDKStreamTextParams = Parameters<typeof streamText>[0];\n\nexport type AiGenerateTextParams = Omit<SDKGenerateTextParams, \"model\"> & {\n    model: string;\n    connection?: string | IAiConnectionInline;\n};\nexport type AiStreamTextParams = Omit<SDKStreamTextParams, \"model\"> & {\n    model: string;\n    connection?: string | IAiConnectionInline;\n};\n\nexport interface AiModel {\n    providerId: string; // e.g. \"anthropic\"\n    providerName: string; // e.g. \"Anthropic\"\n    modelId: string; // e.g. \"claude-sonnet-4-5\"\n    modelName: string; // e.g. \"Claude Sonnet 4.5\"\n}\n\nexport interface IAi {\n    generateText(params: AiGenerateTextParams): ReturnType<typeof generateText>;\n    streamText(params: AiStreamTextParams): Promise<ReturnType<typeof streamText>>;\n    listModels(): Promise<AiModel[]>;\n    listModelsByConnections(): Promise<AiModel[]>;\n    listModelsByConnection(connection: string | IAiConnectionInline): Promise<AiModel[]>;\n}\n\n/** Interact with AI language models using registered providers. */\nexport const Ai = createAbstraction<IAi>(\"Ai\");\n\nexport namespace Ai {\n    export type Interface = IAi;\n    export type GenerateTextParams = AiGenerateTextParams;\n    export type StreamTextParams = AiStreamTextParams;\n}\n\n// AiSdkTool\n\nexport interface IAiSdkTool<TInput = any> {\n    readonly name: string;\n    readonly description: string;\n    readonly inputSchema: FlexibleSchema<TInput>;\n    execute(input: TInput): Promise<unknown>;\n}\n\n/** A single tool that can be provided to AI generateText/streamText calls. */\nexport const AiSdkTool = createAbstraction<IAiSdkTool>(\"AiSdkTool\");\n\nexport namespace AiSdkTool {\n    export type Interface = IAiSdkTool;\n}\n\n// AiSdkTools\n\nexport interface IAiSdkTools {\n    getToolSet(): ToolSet;\n}\n\n/** Collection of AI SDK tools. Returns a ready-to-use ToolSet for generateText/streamText. */\nexport const AiSdkTools = createAbstraction<IAiSdkTools>(\"AiSdkTools\");\n\nexport namespace AiSdkTools {\n    export type Interface = IAiSdkTools;\n}\n"],"names":["AiSdk","createAbstraction","AiSdkFactory","AiConnectionFactory","Ai","AiSdkTool","AiSdkTools"],"mappings":";AAkBO,MAAMA,QAAQC,kBAA0B;AAgBxC,MAAMC,eAAeD,kBAAiC;AAwBtD,MAAME,sBAAsBF,kBAAwC;AAoCpE,MAAMG,KAAKH,kBAAuB;AAkBlC,MAAMI,YAAYJ,kBAA8B;AAahD,MAAMK,aAAaL,kBAA+B"}
+{"version":3,"file":"features/ai/abstractions.js","sources":["../../../src/features/ai/abstractions.ts"],"sourcesContent":["import { createAbstraction } from \"@webiny/feature/api\";\nimport type { generateText } from \"ai\";\nimport type { streamText } from \"ai\";\nimport type { LanguageModel } from \"ai\";\nimport type { FlexibleSchema, ToolSet } from \"ai\";\n\n// AiSdk\n\nexport interface IAiSdkModel {\n    id: string; // raw model id, e.g. \"claude-sonnet-4-5\"\n    name: string; // human-friendly name, e.g. \"Claude Sonnet 4.5\"\n}\n\nexport interface IAiSdk {\n    languageModel(modelId: string): LanguageModel;\n}\n\n/** A single AI SDK instance (e.g. OpenAI, Anthropic) that resolves model instances. */\nexport const AiSdk = createAbstraction<IAiSdk>(\"AiSdk\");\n\nexport namespace AiSdk {\n    export type Interface = IAiSdk;\n}\n\n// AiSdkFactory\n\nexport interface IAiSdkFactory {\n    readonly id: string; // machine id, e.g. \"anthropic\"\n    readonly name: string; // human-friendly name, e.g. \"Anthropic\"\n    readonly models: readonly IAiSdkModel[]; // static model list, no API call needed\n    execute(apiKey?: string): Promise<IAiSdk>;\n}\n\n/** Factory that asynchronously initialises an AI SDK. Register one per provider namespace. */\nexport const AiSdkFactory = createAbstraction<IAiSdkFactory>(\"AiSdkFactory\");\n\nexport namespace AiSdkFactory {\n    export type Interface = IAiSdkFactory;\n}\n\n// AiConnection\n\nexport interface IAiConnectionInline {\n    readonly sdkName: string;\n    readonly apiKey?: string;\n}\n\nexport interface IAiConnection extends IAiConnectionInline {\n    readonly id: string;\n}\n\n// AiConnectionFactory\n\nexport interface IAiConnectionFactory {\n    execute(): Promise<IAiConnection>;\n}\n\n/** Factory that asynchronously produces an AiConnection. */\nexport const AiConnectionFactory = createAbstraction<IAiConnectionFactory>(\"AiConnectionFactory\");\n\nexport namespace AiConnectionFactory {\n    export type Interface = IAiConnectionFactory;\n}\n\n// Ai\n\ntype SDKGenerateTextParams = Parameters<typeof generateText>[0];\ntype SDKStreamTextParams = Parameters<typeof streamText>[0];\n\nexport type AiGenerateTextParams = Omit<SDKGenerateTextParams, \"model\"> & {\n    model: string;\n    connection?: string | IAiConnectionInline;\n};\nexport type AiStreamTextParams = Omit<SDKStreamTextParams, \"model\"> & {\n    model: string;\n    connection?: string | IAiConnectionInline;\n};\n\nexport interface AiModel {\n    providerId: string; // e.g. \"anthropic\"\n    providerName: string; // e.g. \"Anthropic\"\n    modelId: string; // e.g. \"claude-sonnet-4-5\"\n    modelName: string; // e.g. \"Claude Sonnet 4.5\"\n}\n\nexport interface IAi {\n    generateText(params: AiGenerateTextParams): ReturnType<typeof generateText>;\n    streamText(params: AiStreamTextParams): Promise<ReturnType<typeof streamText>>;\n    listModels(): Promise<AiModel[]>;\n    listModelsByConnections(): Promise<AiModel[]>;\n    listModelsByConnection(connection: string | IAiConnectionInline): Promise<AiModel[]>;\n}\n\n/** Interact with AI language models using registered providers. */\nexport const Ai = createAbstraction<IAi>(\"Ai\");\n\nexport namespace Ai {\n    export type Interface = IAi;\n    export type GenerateTextParams = AiGenerateTextParams;\n    export type StreamTextParams = AiStreamTextParams;\n}\n\n// AiSdkTool\n\n/**\n * Behavioural hints about a tool. Purely advisory — they never replace a permission check.\n * Names mirror the MCP tool annotations so they can be forwarded verbatim to MCP clients,\n * which use them to decide what to auto-approve and what to confirm with the user.\n */\nexport interface IAiSdkToolAnnotations {\n    /** Tool does not modify state. */\n    readOnlyHint?: boolean;\n    /** Tool may perform destructive updates (only meaningful when not read-only). */\n    destructiveHint?: boolean;\n    /** Repeated calls with the same arguments have no additional effect. */\n    idempotentHint?: boolean;\n    /** Tool interacts with entities outside its own closed world. */\n    openWorldHint?: boolean;\n}\n\nexport interface IAiSdkTool<TInput = any> {\n    readonly name: string;\n    readonly description: string;\n    readonly inputSchema: FlexibleSchema<TInput>;\n    /** Human-friendly display name. Falls back to `name` when omitted. */\n    readonly title?: string;\n    readonly annotations?: IAiSdkToolAnnotations;\n    execute(input: TInput): Promise<unknown>;\n}\n\n/** A single tool that can be provided to AI generateText/streamText calls. */\nexport const AiSdkTool = createAbstraction<IAiSdkTool>(\"AiSdkTool\");\n\nexport namespace AiSdkTool {\n    export type Interface = IAiSdkTool;\n    export type Annotations = IAiSdkToolAnnotations;\n}\n\n// AiSdkTools\n\nexport interface IAiSdkTools {\n    getToolSet(): ToolSet;\n}\n\n/** Collection of AI SDK tools. Returns a ready-to-use ToolSet for generateText/streamText. */\nexport const AiSdkTools = createAbstraction<IAiSdkTools>(\"AiSdkTools\");\n\nexport namespace AiSdkTools {\n    export type Interface = IAiSdkTools;\n}\n"],"names":["AiSdk","createAbstraction","AiSdkFactory","AiConnectionFactory","Ai","AiSdkTool","AiSdkTools"],"mappings":";AAkBO,MAAMA,QAAQC,kBAA0B;AAgBxC,MAAMC,eAAeD,kBAAiC;AAwBtD,MAAME,sBAAsBF,kBAAwC;AAoCpE,MAAMG,KAAKH,kBAAuB;AAqClC,MAAMI,YAAYJ,kBAA8B;AAchD,MAAMK,aAAaL,kBAA+B"}