@webiny/ai-powerups 0.0.0-unstable.0156a4c312

package/api/features/CmsGenerateEntryContent/CmsGenerateEntryContentUseCase.js

@@ -0,0 +1,133 @@
+import { stepCountIs } from "ai";
+import { Result } from "@webiny/feature/api";
+import { Ai, AiSdkTools, AiToolPipelineRunner } from "@webiny/api-core/features/ai/index.js";
+import { ListTagsUseCase } from "@webiny/api-file-manager/features/file/ListTags/index.js";
+import { GetModelUseCase } from "@webiny/api-headless-cms/features/contentModel/GetModel/index.js";
+import { ModelToAstConverter } from "@webiny/api-headless-cms/features/contentModel/ModelToAstConverter/index.js";
+import { CmsModelToJsonSchemaConverter } from "@webiny/api-headless-cms/utils/contentModelToJsonSchema/index.js";
+import { ResolveAiCapabilityUseCase, withAdditionalInstructions } from "../Capabilities/index.js";
+import { CMS_GENERATE_ENTRY_CAPABILITY } from "./capability.js";
+import { AiPromptContextBuilder, formatAdditionalFilesContext } from "../AiPromptContext/index.js";
+import { createReadProjectFileTool } from "../AiPromptContext/ReadProjectFileTool.js";
+import { CmsGenerateEntryContentUseCase } from "./abstractions.js";
+import { buildEntryPrompt } from "./buildPrompt.js";
+import { LlmJsonResponse } from "../../../domain/LlmJsonResponse.js";
+import { injectDynamicZoneTypenames } from "./injectDynamicZoneTypenames.js";
+class CmsGenerateEntryContentUseCaseImpl {
+    constructor(promptContextBuilder, resolveCapability, ai, aiSdkTools, listTags, getModel, modelToAst, toolPipelineRunner){
+        this.promptContextBuilder = promptContextBuilder;
+        this.resolveCapability = resolveCapability;
+        this.ai = ai;
+        this.aiSdkTools = aiSdkTools;
+        this.listTags = listTags;
+        this.getModel = getModel;
+        this.modelToAst = modelToAst;
+        this.toolPipelineRunner = toolPipelineRunner;
+    }
+    async execute(params) {
+        const resolved = await this.resolveCapability.execute(CMS_GENERATE_ENTRY_CAPABILITY);
+        if (resolved.isFail()) return Result.fail(resolved.error);
+        const capability = resolved.value;
+        const modelResult = await this.getModel.execute(params.modelId);
+        if (modelResult.isFail()) return Result.fail(new Error(`Content model "${params.modelId}" not found.`));
+        const model = modelResult.value;
+        const modelAst = this.modelToAst.toAst(model);
+        const jsonSchemaConverter = new CmsModelToJsonSchemaConverter();
+        const entrySchema = jsonSchemaConverter.convert(modelAst, {
+            name: model.name,
+            description: model.description
+        });
+        const sdkTools = this.aiSdkTools.getToolSet();
+        const context = await this.promptContextBuilder.execute({
+            projectId: params.projectId,
+            readerPersonaId: params.readerPersonaId,
+            writerPersonaId: params.writerPersonaId,
+            excludedFileIds: params.excludedFileIds,
+            additionalFileIds: params.additionalFileIds
+        });
+        if (context.allProjectFiles.length > 0) {
+            const projectFileTool = createReadProjectFileTool(context.allProjectFiles, context.excludedFileIds);
+            Object.assign(sdkTools, projectFileTool);
+        }
+        const tagsResult = await this.listTags.execute({
+            where: {
+                type_startsWith: "image/"
+            },
+            limit: 100
+        });
+        const imageTags = tagsResult.isOk() ? tagsResult.value.map((t)=>t.tag) : [];
+        const systemText = withAdditionalInstructions(capability, buildEntryPrompt(model.name, entrySchema, imageTags) + context.toString());
+        const system = {
+            role: "system",
+            content: systemText,
+            providerOptions: {
+                anthropic: {
+                    cacheControl: {
+                        type: "ephemeral"
+                    }
+                }
+            }
+        };
+        try {
+            const aiResult = await this.ai.generateText({
+                model: capability.model,
+                connection: capability.connection,
+                system,
+                toolChoice: "auto",
+                prompt: params.prompt + formatAdditionalFilesContext(context.additionalFiles),
+                ...Object.keys(sdkTools).length > 0 ? {
+                    tools: sdkTools,
+                    stopWhen: stepCountIs(20)
+                } : {}
+            });
+            const text = aiResult.text || (aiResult.steps.filter((step)=>step.text.length > 0).pop()?.text ?? "");
+            const entry = LlmJsonResponse.fromRawText(text).toArray().pop();
+            let resolved;
+            if (entry) {
+                resolved = await this.toolPipelineRunner.resolve(entry);
+                await injectDynamicZoneTypenames(resolved, modelAst, model.singularApiName);
+            }
+            const filesRead = new Set();
+            let toolCallsMade = 0;
+            for (const step of aiResult.steps)for (const call of step.toolCalls){
+                toolCallsMade++;
+                if ("read_project_file" === call.toolName) {
+                    const input = call.input;
+                    if (input.fileId) filesRead.add(input.fileId);
+                }
+            }
+            const telemetry = {
+                filesRead: [
+                    ...filesRead
+                ],
+                cacheHit: context.cacheHit,
+                toolCallsMade,
+                totalSteps: aiResult.steps.length,
+                toolsAvailable: Object.keys(sdkTools),
+                imageTagsInPrompt: imageTags
+            };
+            return Result.ok({
+                values: resolved ?? {},
+                telemetry
+            });
+        } catch (error) {
+            return Result.fail(new Error(`AI generation failed: ${error instanceof Error ? error.message : String(error)}`));
+        }
+    }
+}
+const CmsGenerateEntryContentUseCaseImplementation = CmsGenerateEntryContentUseCase.createImplementation({
+    implementation: CmsGenerateEntryContentUseCaseImpl,
+    dependencies: [
+        AiPromptContextBuilder,
+        ResolveAiCapabilityUseCase,
+        Ai,
+        AiSdkTools,
+        ListTagsUseCase,
+        GetModelUseCase,
+        ModelToAstConverter,
+        AiToolPipelineRunner
+    ]
+});
+export { CmsGenerateEntryContentUseCaseImplementation };
+
+//# sourceMappingURL=CmsGenerateEntryContentUseCase.js.map

package/api/features/CmsGenerateEntryContent/CmsGenerateEntryContentUseCase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/CmsGenerateEntryContent/CmsGenerateEntryContentUseCase.js","sources":["../../../../src/api/features/CmsGenerateEntryContent/CmsGenerateEntryContentUseCase.ts"],"sourcesContent":["import { stepCountIs } from \"ai\";\nimport { Result } from \"@webiny/feature/api\";\nimport { Ai } from \"@webiny/api-core/features/ai/index.js\";\nimport { AiSdkTools } from \"@webiny/api-core/features/ai/index.js\";\nimport { AiToolPipelineRunner } from \"@webiny/api-core/features/ai/index.js\";\nimport { ListTagsUseCase } from \"@webiny/api-file-manager/features/file/ListTags/index.js\";\nimport { GetModelUseCase } from \"@webiny/api-headless-cms/features/contentModel/GetModel/index.js\";\nimport { ModelToAstConverter } from \"@webiny/api-headless-cms/features/contentModel/ModelToAstConverter/index.js\";\nimport { CmsModelToJsonSchemaConverter } from \"@webiny/api-headless-cms/utils/contentModelToJsonSchema/index.js\";\nimport {\n    ResolveAiCapabilityUseCase,\n    withAdditionalInstructions\n} from \"~/api/features/Capabilities/index.js\";\nimport { CMS_GENERATE_ENTRY_CAPABILITY } from \"./capability.js\";\nimport {\n    AiPromptContextBuilder,\n    formatAdditionalFilesContext\n} from \"~/api/features/AiPromptContext/index.js\";\nimport { createReadProjectFileTool } from \"~/api/features/AiPromptContext/ReadProjectFileTool.js\";\nimport { CmsGenerateEntryContentUseCase } from \"./abstractions.js\";\nimport type {\n    CmsGenerateEntryContentParams,\n    GenerateEntryContentResult,\n    GenerateEntryContentTelemetry\n} from \"./abstractions.js\";\nimport { buildEntryPrompt } from \"./buildPrompt.js\";\nimport { LlmJsonResponse } from \"~/domain/LlmJsonResponse.js\";\nimport { injectDynamicZoneTypenames } from \"./injectDynamicZoneTypenames.js\";\n\nclass CmsGenerateEntryContentUseCaseImpl implements CmsGenerateEntryContentUseCase.Interface {\n    constructor(\n        private promptContextBuilder: AiPromptContextBuilder.Interface,\n        private resolveCapability: ResolveAiCapabilityUseCase.Interface,\n        private ai: Ai.Interface,\n        private aiSdkTools: AiSdkTools.Interface,\n        private listTags: ListTagsUseCase.Interface,\n        private getModel: GetModelUseCase.Interface,\n        private modelToAst: ModelToAstConverter.Interface,\n        private toolPipelineRunner: AiToolPipelineRunner.Interface\n    ) {}\n\n    async execute<TValues = Record<string, any>>(\n        params: CmsGenerateEntryContentParams\n    ): Promise<Result<GenerateEntryContentResult<TValues>, Error>> {\n        const resolved = await this.resolveCapability.execute(CMS_GENERATE_ENTRY_CAPABILITY);\n        if (resolved.isFail()) {\n            return Result.fail(resolved.error);\n        }\n\n        const capability = resolved.value;\n\n        const modelResult = await this.getModel.execute(params.modelId);\n        if (modelResult.isFail()) {\n            return Result.fail(new Error(`Content model \"${params.modelId}\" not found.`));\n        }\n\n        const model = modelResult.value;\n        const modelAst = this.modelToAst.toAst(model);\n        const jsonSchemaConverter = new CmsModelToJsonSchemaConverter();\n        const entrySchema = jsonSchemaConverter.convert(modelAst, {\n            name: model.name,\n            description: model.description\n        });\n\n        const sdkTools = this.aiSdkTools.getToolSet();\n\n        const context = await this.promptContextBuilder.execute({\n            projectId: params.projectId,\n            readerPersonaId: params.readerPersonaId,\n            writerPersonaId: params.writerPersonaId,\n            excludedFileIds: params.excludedFileIds,\n            additionalFileIds: params.additionalFileIds\n        });\n\n        if (context.allProjectFiles.length > 0) {\n            const projectFileTool = createReadProjectFileTool(\n                context.allProjectFiles,\n                context.excludedFileIds\n            );\n            Object.assign(sdkTools, projectFileTool);\n        }\n\n        const tagsResult = await this.listTags.execute({\n            where: { type_startsWith: \"image/\" },\n            limit: 100\n        });\n        const imageTags = tagsResult.isOk() ? tagsResult.value.map(t => t.tag) : [];\n\n        const systemText = withAdditionalInstructions(\n            capability,\n            buildEntryPrompt(model.name, entrySchema, imageTags) + context.toString()\n        );\n\n        const system = {\n            role: \"system\" as const,\n            content: systemText,\n            providerOptions: {\n                anthropic: {\n                    cacheControl: { type: \"ephemeral\" }\n                }\n            }\n        };\n\n        try {\n            const aiResult = await this.ai.generateText({\n                model: capability.model,\n                connection: capability.connection,\n                system,\n                toolChoice: \"auto\",\n                prompt: params.prompt + formatAdditionalFilesContext(context.additionalFiles),\n                ...(Object.keys(sdkTools).length > 0\n                    ? { tools: sdkTools, stopWhen: stepCountIs(20) }\n                    : {})\n            });\n\n            const text =\n                aiResult.text ||\n                (aiResult.steps.filter(step => step.text.length > 0).pop()?.text ?? \"\");\n\n            const entry = LlmJsonResponse.fromRawText(text).toArray().pop();\n\n            let resolved: Record<string, any> | undefined;\n\n            if (entry) {\n                resolved = (await this.toolPipelineRunner.resolve(entry)) as Record<string, any>;\n                await injectDynamicZoneTypenames(resolved, modelAst, model.singularApiName);\n            }\n\n            const filesRead = new Set<string>();\n            let toolCallsMade = 0;\n            for (const step of aiResult.steps) {\n                for (const call of step.toolCalls) {\n                    toolCallsMade++;\n                    if (call.toolName === \"read_project_file\") {\n                        const input = call.input as { fileId?: string };\n                        if (input.fileId) {\n                            filesRead.add(input.fileId);\n                        }\n                    }\n                }\n            }\n\n            const telemetry: GenerateEntryContentTelemetry = {\n                filesRead: [...filesRead],\n                cacheHit: context.cacheHit,\n                toolCallsMade,\n                totalSteps: aiResult.steps.length,\n                toolsAvailable: Object.keys(sdkTools),\n                imageTagsInPrompt: imageTags\n            };\n\n            // Boundary cast: the AI output is dynamic JSON, so this is the one honest point\n            // where we hand the resolved values to the caller's chosen `TValues` shape.\n            return Result.ok({ values: (resolved ?? {}) as TValues, telemetry });\n        } catch (error) {\n            return Result.fail(\n                new Error(\n                    `AI generation failed: ${error instanceof Error ? error.message : String(error)}`\n                )\n            );\n        }\n    }\n}\n\nexport const CmsGenerateEntryContentUseCaseImplementation =\n    CmsGenerateEntryContentUseCase.createImplementation({\n        implementation: CmsGenerateEntryContentUseCaseImpl,\n        dependencies: [\n            AiPromptContextBuilder,\n            ResolveAiCapabilityUseCase,\n            Ai,\n            AiSdkTools,\n            ListTagsUseCase,\n            GetModelUseCase,\n            ModelToAstConverter,\n            AiToolPipelineRunner\n        ]\n    });\n"],"names":["CmsGenerateEntryContentUseCaseImpl","promptContextBuilder","resolveCapability","ai","aiSdkTools","listTags","getModel","modelToAst","toolPipelineRunner","params","resolved","CMS_GENERATE_ENTRY_CAPABILITY","Result","capability","modelResult","Error","model","modelAst","jsonSchemaConverter","CmsModelToJsonSchemaConverter","entrySchema","sdkTools","context","projectFileTool","createReadProjectFileTool","Object","tagsResult","imageTags","t","systemText","withAdditionalInstructions","buildEntryPrompt","system","aiResult","formatAdditionalFilesContext","stepCountIs","text","step","entry","LlmJsonResponse","injectDynamicZoneTypenames","filesRead","Set","toolCallsMade","call","input","telemetry","error","String","CmsGenerateEntryContentUseCaseImplementation","CmsGenerateEntryContentUseCase","AiPromptContextBuilder","ResolveAiCapabilityUseCase","Ai","AiSdkTools","ListTagsUseCase","GetModelUseCase","ModelToAstConverter","AiToolPipelineRunner"],"mappings":"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"}

package/api/features/CmsGenerateEntryContent/abstractions.d.ts

@@ -0,0 +1,36 @@
+import { Result } from "@webiny/feature/api";
+export interface CmsGenerateEntryContentParams {
+    prompt: string;
+    modelId: string;
+    projectId?: string | null;
+    excludedFileIds?: string[] | null;
+    readerPersonaId?: string | null;
+    writerPersonaId?: string | null;
+    additionalFileIds?: string[] | null;
+}
+export interface GenerateEntryContentTelemetry {
+    filesRead: string[];
+    cacheHit: boolean;
+    toolCallsMade: number;
+    totalSteps: number;
+    toolsAvailable: string[];
+    imageTagsInPrompt: string[];
+}
+export interface GenerateEntryContentResult<TValues = Record<string, any>> {
+    /**
+     * The generated entry values, keyed by fieldId. Callers that consume the result
+     * directly (e.g. a bulk action) can read fields straight off this object; transport
+     * edges (the background task / websocket stream) serialize it themselves. Pass a type
+     * argument to `execute` to shape this (e.g. `execute<{ aiSummary?: string }>`).
+     */
+    values: TValues;
+    telemetry: GenerateEntryContentTelemetry;
+}
+export interface ICmsGenerateEntryContentUseCase {
+    execute<TValues = Record<string, any>>(params: CmsGenerateEntryContentParams): Promise<Result<GenerateEntryContentResult<TValues>, Error>>;
+}
+export declare const CmsGenerateEntryContentUseCase: import("@webiny/di").Abstraction<ICmsGenerateEntryContentUseCase>;
+export declare namespace CmsGenerateEntryContentUseCase {
+    type Interface = ICmsGenerateEntryContentUseCase;
+    type Params = CmsGenerateEntryContentParams;
+}

package/api/features/CmsGenerateEntryContent/abstractions.js

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

package/api/features/CmsGenerateEntryContent/abstractions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/CmsGenerateEntryContent/abstractions.js","sources":["../../../../src/api/features/CmsGenerateEntryContent/abstractions.ts"],"sourcesContent":["import { createAbstraction, Result } from \"@webiny/feature/api\";\n\nexport interface CmsGenerateEntryContentParams {\n    prompt: string;\n    modelId: string;\n    projectId?: string | null;\n    excludedFileIds?: string[] | null;\n    readerPersonaId?: string | null;\n    writerPersonaId?: string | null;\n    additionalFileIds?: string[] | null;\n}\n\nexport interface GenerateEntryContentTelemetry {\n    filesRead: string[];\n    cacheHit: boolean;\n    toolCallsMade: number;\n    totalSteps: number;\n    toolsAvailable: string[];\n    imageTagsInPrompt: string[];\n}\n\nexport interface GenerateEntryContentResult<TValues = Record<string, any>> {\n    /**\n     * The generated entry values, keyed by fieldId. Callers that consume the result\n     * directly (e.g. a bulk action) can read fields straight off this object; transport\n     * edges (the background task / websocket stream) serialize it themselves. Pass a type\n     * argument to `execute` to shape this (e.g. `execute<{ aiSummary?: string }>`).\n     */\n    values: TValues;\n    telemetry: GenerateEntryContentTelemetry;\n}\n\nexport interface ICmsGenerateEntryContentUseCase {\n    execute<TValues = Record<string, any>>(\n        params: CmsGenerateEntryContentParams\n    ): Promise<Result<GenerateEntryContentResult<TValues>, Error>>;\n}\n\nexport const CmsGenerateEntryContentUseCase = createAbstraction<ICmsGenerateEntryContentUseCase>(\n    \"AiPowerUpsCmsGenerateEntryContentUseCase\"\n);\n\nexport namespace CmsGenerateEntryContentUseCase {\n    export type Interface = ICmsGenerateEntryContentUseCase;\n    export type Params = CmsGenerateEntryContentParams;\n}\n"],"names":["CmsGenerateEntryContentUseCase","createAbstraction"],"mappings":";AAsCO,MAAMA,iCAAiCC,kBAC1C"}

package/api/features/CmsGenerateEntryContent/buildPrompt.d.ts

@@ -0,0 +1,2 @@
+import type { JsonSchema } from "@webiny/api-headless-cms/utils/contentModelToJsonSchema/types.js";
+export declare function buildEntryPrompt(modelName: string, entrySchema: JsonSchema, availableImageTags: string[]): string;

package/api/features/CmsGenerateEntryContent/buildPrompt.js

@@ -0,0 +1,61 @@
+function buildEntryPrompt(modelName, entrySchema, availableImageTags) {
+    const tagListing = availableImageTags.length > 0 ? availableImageTags.map((t)=>`\`${t}\``).join(", ") : "(no image tags available in the File Manager — image fields should be left empty or omitted)";
+    return `You are a CMS content entry generator. Given a user prompt, generate structured content for a "${modelName}" entry using the JSON Schema below.
+
+### Rich Text Content
+
+For rich text fields, wrap the value in a tool envelope:
+\`\`\`json
+{ "tool": "textToLexical", "params": { "text": "<html content>" } }
+\`\`\`
+
+Write the content as semantic HTML: use <h1>-<h6>, <p>, <strong>, <em>, <ul>, <ol>, <li>, <a>, <blockquote>.
+A single rich text field CAN contain an entire article with all headings, paragraphs, lists, and blockquotes.
+
+### Image Selection
+
+You MUST call the \`listImagesByTag\` tool BEFORE using any image ID.
+Do NOT invent image IDs. Any ID not returned by \`listImagesByTag\` will fail to resolve.
+
+The File Manager currently has images tagged with: ${tagListing}.
+
+When a field needs an image:
+1. Pick the tag from the list above that best matches the content topic.
+2. Call \`listImagesByTag\` with that tag.
+3. If results are non-empty, wrap the image reference in a tool envelope:
+   \`{ "tool": "cmsResolveImage", "params": { "id": "<image_id_from_search>" } }\`
+4. If results are empty, try one more tag. If still nothing, leave the field empty.
+
+### File Fields
+
+For file/image fields, always use the \`cmsResolveImage\` tool envelope with an ID obtained from \`listImagesByTag\`:
+\`{ "tool": "cmsResolveImage", "params": { "id": "<file_id>" } }\`
+
+### Reference Fields
+
+Reference fields expect \`{ "entryId": "<id>", "modelId": "<model>" }\`. If you don't have real entry IDs, leave reference fields empty or use placeholder values.
+
+### SEO & Content Best Practices
+
+- Use exactly ONE <h1> per rich text field as the main title.
+- Use <h2> for sections, <h3> for subsections. Never skip heading levels.
+- Keep paragraphs short — 2 to 4 sentences.
+- Lead with the most important information first.
+- Incorporate topic keywords naturally without stuffing.
+
+### Entry Schema
+
+The entry must conform to this JSON Schema:
+
+\`\`\`json
+${JSON.stringify(entrySchema, null, 2)}
+\`\`\`
+
+You MUST generate the full entry content as JSON after using any tools.
+Tool calls are for gathering information — your final response must always be the complete entry JSON object.
+
+IMPORTANT: You MUST return a parsable JSON object conforming to the schema above. No extra text outside the JSON.`;
+}
+export { buildEntryPrompt };
+
+//# sourceMappingURL=buildPrompt.js.map

package/api/features/CmsGenerateEntryContent/buildPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/CmsGenerateEntryContent/buildPrompt.js","sources":["../../../../src/api/features/CmsGenerateEntryContent/buildPrompt.ts"],"sourcesContent":["import type { JsonSchema } from \"@webiny/api-headless-cms/utils/contentModelToJsonSchema/types.js\";\n\nexport function buildEntryPrompt(\n    modelName: string,\n    entrySchema: JsonSchema,\n    availableImageTags: string[]\n): string {\n    const tagListing =\n        availableImageTags.length > 0\n            ? availableImageTags.map(t => `\\`${t}\\``).join(\", \")\n            : \"(no image tags available in the File Manager — image fields should be left empty or omitted)\";\n\n    return `You are a CMS content entry generator. Given a user prompt, generate structured content for a \"${modelName}\" entry using the JSON Schema below.\n\n### Rich Text Content\n\nFor rich text fields, wrap the value in a tool envelope:\n\\`\\`\\`json\n{ \"tool\": \"textToLexical\", \"params\": { \"text\": \"<html content>\" } }\n\\`\\`\\`\n\nWrite the content as semantic HTML: use <h1>-<h6>, <p>, <strong>, <em>, <ul>, <ol>, <li>, <a>, <blockquote>.\nA single rich text field CAN contain an entire article with all headings, paragraphs, lists, and blockquotes.\n\n### Image Selection\n\nYou MUST call the \\`listImagesByTag\\` tool BEFORE using any image ID.\nDo NOT invent image IDs. Any ID not returned by \\`listImagesByTag\\` will fail to resolve.\n\nThe File Manager currently has images tagged with: ${tagListing}.\n\nWhen a field needs an image:\n1. Pick the tag from the list above that best matches the content topic.\n2. Call \\`listImagesByTag\\` with that tag.\n3. If results are non-empty, wrap the image reference in a tool envelope:\n   \\`{ \"tool\": \"cmsResolveImage\", \"params\": { \"id\": \"<image_id_from_search>\" } }\\`\n4. If results are empty, try one more tag. If still nothing, leave the field empty.\n\n### File Fields\n\nFor file/image fields, always use the \\`cmsResolveImage\\` tool envelope with an ID obtained from \\`listImagesByTag\\`:\n\\`{ \"tool\": \"cmsResolveImage\", \"params\": { \"id\": \"<file_id>\" } }\\`\n\n### Reference Fields\n\nReference fields expect \\`{ \"entryId\": \"<id>\", \"modelId\": \"<model>\" }\\`. If you don't have real entry IDs, leave reference fields empty or use placeholder values.\n\n### SEO & Content Best Practices\n\n- Use exactly ONE <h1> per rich text field as the main title.\n- Use <h2> for sections, <h3> for subsections. Never skip heading levels.\n- Keep paragraphs short — 2 to 4 sentences.\n- Lead with the most important information first.\n- Incorporate topic keywords naturally without stuffing.\n\n### Entry Schema\n\nThe entry must conform to this JSON Schema:\n\n\\`\\`\\`json\n${JSON.stringify(entrySchema, null, 2)}\n\\`\\`\\`\n\nYou MUST generate the full entry content as JSON after using any tools.\nTool calls are for gathering information — your final response must always be the complete entry JSON object.\n\nIMPORTANT: You MUST return a parsable JSON object conforming to the schema above. No extra text outside the JSON.`;\n}\n"],"names":["buildEntryPrompt","modelName","entrySchema","availableImageTags","tagListing","t","JSON"],"mappings":"AAEO,SAASA,iBACZC,SAAiB,EACjBC,WAAuB,EACvBC,kBAA4B;IAE5B,MAAMC,aACFD,mBAAmB,MAAM,GAAG,IACtBA,mBAAmB,GAAG,CAACE,CAAAA,IAAK,CAAC,EAAE,EAAEA,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,QAC7C;IAEV,OAAO,CAAC,+FAA+F,EAAEJ,UAAU;;;;;;;;;;;;;;;;;mDAiBpE,EAAEG,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BhE,EAAEE,KAAK,SAAS,CAACJ,aAAa,MAAM,GAAG;;;;;;iHAM0E,CAAC;AAClH"}

package/api/features/CmsGenerateEntryContent/capability.d.ts

@@ -0,0 +1,17 @@
+import { AiCapability } from "../../../api/features/Capabilities/index.js";
+export declare const CMS_GENERATE_ENTRY_CAPABILITY = "cmsGenerateEntry";
+/**
+ * No `guidance`: this prompt is rebuilt on every request from the content model's JSON Schema and
+ * the File Manager's current image tags, so there is no fixed block a project could replace without
+ * dropping the schema the output has to conform to. Additional instructions still apply.
+ */
+declare class CmsGenerateEntryCapabilityImpl implements AiCapability.Interface {
+    readonly id = "cmsGenerateEntry";
+    readonly label = "CMS entry generation";
+    readonly description = "Writes a content entry from a prompt, following the content model's schema and picking images from the File Manager.";
+    readonly defaultRole: "standard";
+}
+export declare const CmsGenerateEntryCapability: typeof CmsGenerateEntryCapabilityImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("~/api/features/Capabilities/index.js").IAiCapability>;
+};
+export {};

package/api/features/CmsGenerateEntryContent/capability.js

@@ -0,0 +1,17 @@
+import { AiCapability } from "../Capabilities/index.js";
+const CMS_GENERATE_ENTRY_CAPABILITY = "cmsGenerateEntry";
+class CmsGenerateEntryCapabilityImpl {
+    constructor(){
+        this.id = CMS_GENERATE_ENTRY_CAPABILITY;
+        this.label = "CMS entry generation";
+        this.description = "Writes a content entry from a prompt, following the content model's schema and picking images from the File Manager.";
+        this.defaultRole = "standard";
+    }
+}
+const CmsGenerateEntryCapability = AiCapability.createImplementation({
+    implementation: CmsGenerateEntryCapabilityImpl,
+    dependencies: []
+});
+export { CMS_GENERATE_ENTRY_CAPABILITY, CmsGenerateEntryCapability };
+
+//# sourceMappingURL=capability.js.map

package/api/features/CmsGenerateEntryContent/capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/CmsGenerateEntryContent/capability.js","sources":["../../../../src/api/features/CmsGenerateEntryContent/capability.ts"],"sourcesContent":["import { AiCapability } from \"~/api/features/Capabilities/index.js\";\n\nexport const CMS_GENERATE_ENTRY_CAPABILITY = \"cmsGenerateEntry\";\n\n/**\n * No `guidance`: this prompt is rebuilt on every request from the content model's JSON Schema and\n * the File Manager's current image tags, so there is no fixed block a project could replace without\n * dropping the schema the output has to conform to. Additional instructions still apply.\n */\nclass CmsGenerateEntryCapabilityImpl implements AiCapability.Interface {\n    readonly id = CMS_GENERATE_ENTRY_CAPABILITY;\n    readonly label = \"CMS entry generation\";\n    readonly description =\n        \"Writes a content entry from a prompt, following the content model's schema and picking images from the File Manager.\";\n    readonly defaultRole = \"standard\" as const;\n}\n\nexport const CmsGenerateEntryCapability = AiCapability.createImplementation({\n    implementation: CmsGenerateEntryCapabilityImpl,\n    dependencies: []\n});\n"],"names":["CMS_GENERATE_ENTRY_CAPABILITY","CmsGenerateEntryCapabilityImpl","CmsGenerateEntryCapability","AiCapability"],"mappings":";AAEO,MAAMA,gCAAgC;AAO7C,MAAMC;;aACO,EAAE,GAAGD;aACL,KAAK,GAAG;aACR,WAAW,GAChB;aACK,WAAW,GAAG;;AAC3B;AAEO,MAAME,6BAA6BC,aAAa,oBAAoB,CAAC;IACxE,gBAAgBF;IAChB,cAAc,EAAE;AACpB"}

package/api/features/CmsGenerateEntryContent/feature.d.ts

@@ -0,0 +1,4 @@
+export declare const CmsGenerateEntryContentFeature: {
+    name: string;
+    register(container: import("@webiny/di").Container): void;
+};

package/api/features/CmsGenerateEntryContent/feature.js

@@ -0,0 +1,15 @@
+import { createFeature } from "@webiny/feature/api";
+import { CmsGenerateEntryContentUseCaseImplementation } from "./CmsGenerateEntryContentUseCase.js";
+import { CmsGenerateEntryContentTask } from "./CmsGenerateEntryContentTask.js";
+import { CmsGenerateEntryCapability } from "./capability.js";
+const CmsGenerateEntryContentFeature = createFeature({
+    name: "AiPowerUps/CmsGenerateEntryContent",
+    register (container) {
+        container.register(CmsGenerateEntryCapability);
+        container.register(CmsGenerateEntryContentUseCaseImplementation);
+        container.register(CmsGenerateEntryContentTask);
+    }
+});
+export { CmsGenerateEntryContentFeature };
+
+//# sourceMappingURL=feature.js.map

package/api/features/CmsGenerateEntryContent/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/CmsGenerateEntryContent/feature.js","sources":["../../../../src/api/features/CmsGenerateEntryContent/feature.ts"],"sourcesContent":["import { createFeature } from \"@webiny/feature/api\";\nimport { CmsGenerateEntryContentUseCaseImplementation } from \"./CmsGenerateEntryContentUseCase.js\";\nimport { CmsGenerateEntryContentTask } from \"./CmsGenerateEntryContentTask.js\";\nimport { CmsGenerateEntryCapability } from \"./capability.js\";\n\nexport const CmsGenerateEntryContentFeature = createFeature({\n    name: \"AiPowerUps/CmsGenerateEntryContent\",\n    register(container) {\n        container.register(CmsGenerateEntryCapability);\n        container.register(CmsGenerateEntryContentUseCaseImplementation);\n        container.register(CmsGenerateEntryContentTask);\n    }\n});\n"],"names":["CmsGenerateEntryContentFeature","createFeature","container","CmsGenerateEntryCapability","CmsGenerateEntryContentUseCaseImplementation","CmsGenerateEntryContentTask"],"mappings":";;;;AAKO,MAAMA,iCAAiCC,cAAc;IACxD,MAAM;IACN,UAASC,SAAS;QACdA,UAAU,QAAQ,CAACC;QACnBD,UAAU,QAAQ,CAACE;QACnBF,UAAU,QAAQ,CAACG;IACvB;AACJ"}

package/api/features/CmsGenerateEntryContent/index.d.ts

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

package/api/features/CmsGenerateEntryContent/index.js

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

package/api/features/CmsGenerateEntryContent/injectDynamicZoneTypenames.d.ts

@@ -0,0 +1,2 @@
+import type { CmsModelAst } from "@webiny/api-headless-cms/types";
+export declare function injectDynamicZoneTypenames(values: Record<string, any>, modelAst: CmsModelAst, singularApiName: string): Promise<void>;

package/api/features/CmsGenerateEntryContent/injectDynamicZoneTypenames.js

@@ -0,0 +1,30 @@
+import { ContentEntryTraverser } from "@webiny/api-headless-cms/features/contentEntry/ContentEntryTraverser/ContentEntryTraverser.js";
+import { createTypeName } from "@webiny/api-headless-cms/utils/createTypeName.js";
+async function injectDynamicZoneTypenames(values, modelAst, singularApiName) {
+    const traverser = new ContentEntryTraverser(modelAst);
+    const graphQLTypeMap = new Map();
+    graphQLTypeMap.set("", singularApiName);
+    await traverser.traverse(values, async ({ field, value, path })=>{
+        if ("dynamicZone" !== field.type || null == value) return;
+        const pathParts = path.split(".");
+        const parentPrefix = pathParts.slice(0, -1).join(".");
+        const enclosingType = graphQLTypeMap.get(parentPrefix) || singularApiName;
+        const typeName = `${enclosingType}_${createTypeName(field.fieldId)}`;
+        const templates = field.settings?.templates || [];
+        const items = field.list && Array.isArray(value) ? value : [
+            value
+        ];
+        for(let i = 0; i < items.length; i++){
+            const item = items[i];
+            if (!item || !item._templateId) continue;
+            const template = templates.find((t)=>t.id === item._templateId);
+            if (!template) continue;
+            item.__typename = `${typeName}_${template.gqlTypeName}`;
+            const itemPath = field.list ? `${path}.${i}` : path;
+            graphQLTypeMap.set(itemPath, item.__typename);
+        }
+    });
+}
+export { injectDynamicZoneTypenames };
+
+//# sourceMappingURL=injectDynamicZoneTypenames.js.map

package/api/features/CmsGenerateEntryContent/injectDynamicZoneTypenames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/CmsGenerateEntryContent/injectDynamicZoneTypenames.js","sources":["../../../../src/api/features/CmsGenerateEntryContent/injectDynamicZoneTypenames.ts"],"sourcesContent":["import type { CmsModelAst } from \"@webiny/api-headless-cms/types\";\nimport { ContentEntryTraverser } from \"@webiny/api-headless-cms/features/contentEntry/ContentEntryTraverser/ContentEntryTraverser.js\";\nimport { createTypeName } from \"@webiny/api-headless-cms/utils/createTypeName.js\";\n\ninterface DynamicZoneTemplate {\n    id: string;\n    gqlTypeName: string;\n}\n\nexport async function injectDynamicZoneTypenames(\n    values: Record<string, any>,\n    modelAst: CmsModelAst,\n    singularApiName: string\n): Promise<void> {\n    const traverser = new ContentEntryTraverser(modelAst);\n\n    const graphQLTypeMap = new Map<string, string>();\n    graphQLTypeMap.set(\"\", singularApiName);\n\n    await traverser.traverse(values, async ({ field, value, path }) => {\n        if (field.type !== \"dynamicZone\" || value == null) {\n            return;\n        }\n\n        const pathParts = path.split(\".\");\n        const parentPrefix = pathParts.slice(0, -1).join(\".\");\n        const enclosingType = graphQLTypeMap.get(parentPrefix) || singularApiName;\n        const typeName = `${enclosingType}_${createTypeName(field.fieldId)}`;\n\n        const templates: DynamicZoneTemplate[] = field.settings?.templates || [];\n        const items: Record<string, any>[] = field.list && Array.isArray(value) ? value : [value];\n\n        for (let i = 0; i < items.length; i++) {\n            const item = items[i];\n            if (!item || !item._templateId) {\n                continue;\n            }\n\n            const template = templates.find(t => t.id === item._templateId);\n            if (!template) {\n                continue;\n            }\n\n            item.__typename = `${typeName}_${template.gqlTypeName}`;\n\n            const itemPath = field.list ? `${path}.${i}` : path;\n            graphQLTypeMap.set(itemPath, item.__typename);\n        }\n    });\n}\n"],"names":["injectDynamicZoneTypenames","values","modelAst","singularApiName","traverser","ContentEntryTraverser","graphQLTypeMap","Map","field","value","path","pathParts","parentPrefix","enclosingType","typeName","createTypeName","templates","items","Array","i","item","template","t","itemPath"],"mappings":";;AASO,eAAeA,2BAClBC,MAA2B,EAC3BC,QAAqB,EACrBC,eAAuB;IAEvB,MAAMC,YAAY,IAAIC,sBAAsBH;IAE5C,MAAMI,iBAAiB,IAAIC;IAC3BD,eAAe,GAAG,CAAC,IAAIH;IAEvB,MAAMC,UAAU,QAAQ,CAACH,QAAQ,OAAO,EAAEO,KAAK,EAAEC,KAAK,EAAEC,IAAI,EAAE;QAC1D,IAAIF,AAAe,kBAAfA,MAAM,IAAI,IAAsBC,AAAS,QAATA,OAChC;QAGJ,MAAME,YAAYD,KAAK,KAAK,CAAC;QAC7B,MAAME,eAAeD,UAAU,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;QACjD,MAAME,gBAAgBP,eAAe,GAAG,CAACM,iBAAiBT;QAC1D,MAAMW,WAAW,GAAGD,cAAc,CAAC,EAAEE,eAAeP,MAAM,OAAO,GAAG;QAEpE,MAAMQ,YAAmCR,MAAM,QAAQ,EAAE,aAAa,EAAE;QACxE,MAAMS,QAA+BT,MAAM,IAAI,IAAIU,MAAM,OAAO,CAACT,SAASA,QAAQ;YAACA;SAAM;QAEzF,IAAK,IAAIU,IAAI,GAAGA,IAAIF,MAAM,MAAM,EAAEE,IAAK;YACnC,MAAMC,OAAOH,KAAK,CAACE,EAAE;YACrB,IAAI,CAACC,QAAQ,CAACA,KAAK,WAAW,EAC1B;YAGJ,MAAMC,WAAWL,UAAU,IAAI,CAACM,CAAAA,IAAKA,EAAE,EAAE,KAAKF,KAAK,WAAW;YAC9D,IAAI,CAACC,UACD;YAGJD,KAAK,UAAU,GAAG,GAAGN,SAAS,CAAC,EAAEO,SAAS,WAAW,EAAE;YAEvD,MAAME,WAAWf,MAAM,IAAI,GAAG,GAAGE,KAAK,CAAC,EAAES,GAAG,GAAGT;YAC/CJ,eAAe,GAAG,CAACiB,UAAUH,KAAK,UAAU;QAChD;IACJ;AACJ"}

package/api/features/CmsResolveImageTool/CmsResolveImageTool.d.ts

@@ -0,0 +1,14 @@
+import { AiOutputTool } from "@webiny/api-core/features/ai/index.js";
+import { GetFileUseCase } from "@webiny/api-file-manager/features/file/GetFile/index.js";
+import { FileUrlGenerator } from "@webiny/api-file-manager/features/file/FileUrlGenerator/index.js";
+declare class CmsResolveImageToolImpl implements AiOutputTool.Interface {
+    private getFile;
+    private urlGenerator;
+    readonly name = "cmsResolveImage";
+    constructor(getFile: GetFileUseCase.Interface, urlGenerator: FileUrlGenerator.Interface);
+    execute(params: Record<string, unknown>): Promise<unknown>;
+}
+export declare const CmsResolveImageTool: typeof CmsResolveImageToolImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("@webiny/api-core/features/ai/toolPipeline").IAiOutputTool>;
+};
+export {};

package/api/features/CmsResolveImageTool/CmsResolveImageTool.js

@@ -0,0 +1,27 @@
+import { AiOutputTool } from "@webiny/api-core/features/ai/index.js";
+import { GetFileUseCase } from "@webiny/api-file-manager/features/file/GetFile/index.js";
+import { FileUrlGenerator } from "@webiny/api-file-manager/features/file/FileUrlGenerator/index.js";
+class CmsResolveImageToolImpl {
+    constructor(getFile, urlGenerator){
+        this.getFile = getFile;
+        this.urlGenerator = urlGenerator;
+        this.name = "cmsResolveImage";
+    }
+    async execute(params) {
+        const id = params.id;
+        if ("string" != typeof id || !id) return null;
+        const result = await this.getFile.execute(id);
+        if (result.isFail()) return null;
+        return await this.urlGenerator.generateUrl(result.value);
+    }
+}
+const CmsResolveImageTool = AiOutputTool.createImplementation({
+    implementation: CmsResolveImageToolImpl,
+    dependencies: [
+        GetFileUseCase,
+        FileUrlGenerator
+    ]
+});
+export { CmsResolveImageTool };
+
+//# sourceMappingURL=CmsResolveImageTool.js.map

package/api/features/CmsResolveImageTool/CmsResolveImageTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/CmsResolveImageTool/CmsResolveImageTool.js","sources":["../../../../src/api/features/CmsResolveImageTool/CmsResolveImageTool.ts"],"sourcesContent":["import { AiOutputTool } from \"@webiny/api-core/features/ai/index.js\";\nimport { GetFileUseCase } from \"@webiny/api-file-manager/features/file/GetFile/index.js\";\nimport { FileUrlGenerator } from \"@webiny/api-file-manager/features/file/FileUrlGenerator/index.js\";\n\nclass CmsResolveImageToolImpl implements AiOutputTool.Interface {\n    readonly name = \"cmsResolveImage\";\n\n    constructor(\n        private getFile: GetFileUseCase.Interface,\n        private urlGenerator: FileUrlGenerator.Interface\n    ) {}\n\n    async execute(params: Record<string, unknown>): Promise<unknown> {\n        const id = params.id;\n        if (typeof id !== \"string\" || !id) {\n            return null;\n        }\n\n        const result = await this.getFile.execute(id);\n        if (result.isFail()) {\n            return null;\n        }\n\n        return await this.urlGenerator.generateUrl(result.value);\n    }\n}\n\nexport const CmsResolveImageTool = AiOutputTool.createImplementation({\n    implementation: CmsResolveImageToolImpl,\n    dependencies: [GetFileUseCase, FileUrlGenerator]\n});\n"],"names":["CmsResolveImageToolImpl","getFile","urlGenerator","params","id","result","CmsResolveImageTool","AiOutputTool","GetFileUseCase","FileUrlGenerator"],"mappings":";;;AAIA,MAAMA;IAGF,YACYC,OAAiC,EACjCC,YAAwC,CAClD;aAFUD,OAAO,GAAPA;aACAC,YAAY,GAAZA;aAJH,IAAI,GAAG;IAKb;IAEH,MAAM,QAAQC,MAA+B,EAAoB;QAC7D,MAAMC,KAAKD,OAAO,EAAE;QACpB,IAAI,AAAc,YAAd,OAAOC,MAAmB,CAACA,IAC3B,OAAO;QAGX,MAAMC,SAAS,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAACD;QAC1C,IAAIC,OAAO,MAAM,IACb,OAAO;QAGX,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,WAAW,CAACA,OAAO,KAAK;IAC3D;AACJ;AAEO,MAAMC,sBAAsBC,aAAa,oBAAoB,CAAC;IACjE,gBAAgBP;IAChB,cAAc;QAACQ;QAAgBC;KAAiB;AACpD"}

package/api/features/CmsResolveImageTool/feature.d.ts

@@ -0,0 +1,4 @@
+export declare const CmsResolveImageToolFeature: {
+    name: string;
+    register(container: import("@webiny/di").Container): void;
+};

package/api/features/CmsResolveImageTool/feature.js

@@ -0,0 +1,11 @@
+import { createFeature } from "@webiny/feature/api";
+import { CmsResolveImageTool } from "./CmsResolveImageTool.js";
+const CmsResolveImageToolFeature = createFeature({
+    name: "AiPowerUps/CmsResolveImageTool",
+    register (container) {
+        container.register(CmsResolveImageTool);
+    }
+});
+export { CmsResolveImageToolFeature };
+
+//# sourceMappingURL=feature.js.map

package/api/features/CmsResolveImageTool/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/CmsResolveImageTool/feature.js","sources":["../../../../src/api/features/CmsResolveImageTool/feature.ts"],"sourcesContent":["import { createFeature } from \"@webiny/feature/api\";\nimport { CmsResolveImageTool } from \"./CmsResolveImageTool.js\";\n\nexport const CmsResolveImageToolFeature = createFeature({\n    name: \"AiPowerUps/CmsResolveImageTool\",\n    register(container) {\n        container.register(CmsResolveImageTool);\n    }\n});\n"],"names":["CmsResolveImageToolFeature","createFeature","container","CmsResolveImageTool"],"mappings":";;AAGO,MAAMA,6BAA6BC,cAAc;IACpD,MAAM;IACN,UAASC,SAAS;QACdA,UAAU,QAAQ,CAACC;IACvB;AACJ"}

package/api/features/ConfiguredAiModels/ConfiguredAiModelsService.d.ts

@@ -0,0 +1,18 @@
+import { Result } from "@webiny/feature/api";
+import { Ai } from "@webiny/api-core/features/ai/index.js";
+import { Logger } from "@webiny/api-core/features/logger/index.js";
+import { GetSettingsUseCase } from "../../../api/features/GetSettings/index.js";
+import type { AiConnectionPreset } from "../../../api/features/Connections/index.js";
+import { ConfiguredAiModelsService as Abstraction } from "./abstractions.js";
+declare class ConfiguredAiModelsServiceImpl implements Abstraction.Interface {
+    private ai;
+    private getSettings;
+    private logger;
+    constructor(ai: Ai.Interface, getSettings: GetSettingsUseCase.Interface, logger: Logger.Interface);
+    list(): Promise<Result<Abstraction.Model[], Error>>;
+    findConnection(model: string): Promise<Result<AiConnectionPreset | null, Error>>;
+}
+export declare const ConfiguredAiModelsService: typeof ConfiguredAiModelsServiceImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("./abstractions.js").IConfiguredAiModelsService>;
+};
+export {};

package/api/features/ConfiguredAiModels/ConfiguredAiModelsService.js

@@ -0,0 +1,92 @@
+import { Result } from "@webiny/feature/api";
+import { Ai } from "@webiny/api-core/features/ai/index.js";
+import { Logger } from "@webiny/api-core/features/logger/index.js";
+import { GetSettingsUseCase } from "../GetSettings/index.js";
+import { sdkNameFromModel } from "../shared/modelId.js";
+import { ConfiguredAiModelsService } from "./abstractions.js";
+class ConfiguredAiModelsServiceImpl {
+    constructor(ai, getSettings, logger){
+        this.ai = ai;
+        this.getSettings = getSettings;
+        this.logger = logger;
+    }
+    async list() {
+        let settings;
+        try {
+            const settingsResult = await this.getSettings.execute();
+            if (settingsResult.isFail()) {
+                this.logger.error({
+                    error: settingsResult.error
+                }, "Could not read the AI Power-Ups settings to list the configured models.");
+                return Result.fail(new Error("Failed to load AI Power-Ups settings."));
+            }
+            settings = settingsResult.value;
+        } catch (error) {
+            this.logger.error({
+                error
+            }, "Could not read the AI Power-Ups settings to list the configured models.");
+            return Result.fail(new Error("Failed to load AI Power-Ups settings."));
+        }
+        let models;
+        try {
+            models = await this.ai.listModels();
+        } catch (error) {
+            this.logger.error({
+                error
+            }, "Could not list the AI provider models.");
+            return Result.fail(new Error("Failed to list the configured AI models."));
+        }
+        const presets = settings.connections?.presets ?? [];
+        const providerIds = new Set(presets.filter((preset)=>preset.apiKeyEncrypted).map((preset)=>preset.sdkName));
+        const configured = new Map();
+        for (const model of models){
+            if (!providerIds.has(model.providerId)) continue;
+            const id = `${model.providerId}/${model.modelId}`;
+            if (!configured.has(id)) configured.set(id, {
+                id,
+                name: model.modelName,
+                providerId: model.providerId,
+                providerName: model.providerName
+            });
+        }
+        return Result.ok([
+            ...configured.values()
+        ]);
+    }
+    async findConnection(model) {
+        const separator = model.indexOf("/");
+        const idSegments = model.slice(separator + 1).split("/");
+        if (separator < 1 || idSegments.some((segment)=>"" === segment)) return Result.ok(null);
+        let settings;
+        try {
+            const settingsResult = await this.getSettings.execute();
+            if (settingsResult.isFail()) {
+                this.logger.error({
+                    error: settingsResult.error
+                }, "Could not read the AI Power-Ups settings to find a model connection.");
+                return Result.fail(new Error("Failed to load AI Power-Ups settings."));
+            }
+            settings = settingsResult.value;
+        } catch (error) {
+            this.logger.error({
+                error
+            }, "Could not read the AI Power-Ups settings to find a model connection.");
+            return Result.fail(new Error("Failed to load AI Power-Ups settings."));
+        }
+        const sdkName = sdkNameFromModel(model);
+        const presets = settings.connections?.presets ?? [];
+        const connection = presets.find((preset)=>preset.sdkName === sdkName && Boolean(preset.apiKeyEncrypted));
+        return Result.ok(connection ?? null);
+    }
+}
+const ConfiguredAiModelsService_ConfiguredAiModelsService = ConfiguredAiModelsService.createImplementation({
+    implementation: ConfiguredAiModelsServiceImpl,
+    dependencies: [
+        Ai,
+        GetSettingsUseCase,
+        Logger
+    ]
+});
+export { ConfiguredAiModelsService_ConfiguredAiModelsService as ConfiguredAiModelsService };
+
+//# sourceMappingURL=ConfiguredAiModelsService.js.map

package/api/features/ConfiguredAiModels/ConfiguredAiModelsService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/ConfiguredAiModels/ConfiguredAiModelsService.js","sources":["../../../../src/api/features/ConfiguredAiModels/ConfiguredAiModelsService.ts"],"sourcesContent":["import { Result } from \"@webiny/feature/api\";\nimport { Ai } from \"@webiny/api-core/features/ai/index.js\";\nimport type { AiModel } from \"@webiny/api-core/features/ai/index.js\";\nimport { Logger } from \"@webiny/api-core/features/logger/index.js\";\nimport { GetSettingsUseCase } from \"~/api/features/GetSettings/index.js\";\nimport { sdkNameFromModel } from \"~/api/features/shared/modelId.js\";\nimport type { AiConnectionPreset } from \"~/api/features/Connections/index.js\";\nimport type { IAiPowerUpsSettings } from \"~/api/types.js\";\nimport { ConfiguredAiModelsService as Abstraction } from \"./abstractions.js\";\n\nclass ConfiguredAiModelsServiceImpl implements Abstraction.Interface {\n    public constructor(\n        private ai: Ai.Interface,\n        private getSettings: GetSettingsUseCase.Interface,\n        private logger: Logger.Interface\n    ) {}\n\n    public async list(): Promise<Result<Abstraction.Model[], Error>> {\n        // Failures are logged here, once, with the raw error; the callers show their own fixed\n        // text and do not log again. The returned Error carries a fixed message only.\n        let settings: IAiPowerUpsSettings;\n        try {\n            const settingsResult = await this.getSettings.execute();\n            if (settingsResult.isFail()) {\n                this.logger.error(\n                    { error: settingsResult.error },\n                    \"Could not read the AI Power-Ups settings to list the configured models.\"\n                );\n                return Result.fail(new Error(\"Failed to load AI Power-Ups settings.\"));\n            }\n            settings = settingsResult.value;\n        } catch (error) {\n            this.logger.error(\n                { error },\n                \"Could not read the AI Power-Ups settings to list the configured models.\"\n            );\n            return Result.fail(new Error(\"Failed to load AI Power-Ups settings.\"));\n        }\n\n        let models: AiModel[];\n        try {\n            models = await this.ai.listModels();\n        } catch (error) {\n            this.logger.error({ error }, \"Could not list the AI provider models.\");\n            return Result.fail(new Error(\"Failed to list the configured AI models.\"));\n        }\n\n        const presets = settings.connections?.presets ?? [];\n        const providerIds = new Set(\n            presets.filter(preset => preset.apiKeyEncrypted).map(preset => preset.sdkName)\n        );\n\n        const configured = new Map<string, Abstraction.Model>();\n        for (const model of models) {\n            if (!providerIds.has(model.providerId)) {\n                continue;\n            }\n            const id = `${model.providerId}/${model.modelId}`;\n            if (configured.has(id)) {\n                continue;\n            }\n            configured.set(id, {\n                id,\n                name: model.modelName,\n                providerId: model.providerId,\n                providerName: model.providerName\n            });\n        }\n        return Result.ok([...configured.values()]);\n    }\n\n    public async findConnection(model: string): Promise<Result<AiConnectionPreset | null, Error>> {\n        // `<provider>/<id>`: a non-empty provider before the first \"/\" and a non-empty id after it.\n        // The id may contain further \"/\" (a gateway model), but no empty segment (\"a//\", \"a/b/\").\n        const separator = model.indexOf(\"/\");\n        const idSegments = model.slice(separator + 1).split(\"/\");\n        if (separator < 1 || idSegments.some(segment => segment === \"\")) {\n            return Result.ok(null);\n        }\n\n        let settings: IAiPowerUpsSettings;\n        try {\n            const settingsResult = await this.getSettings.execute();\n            if (settingsResult.isFail()) {\n                this.logger.error(\n                    { error: settingsResult.error },\n                    \"Could not read the AI Power-Ups settings to find a model connection.\"\n                );\n                return Result.fail(new Error(\"Failed to load AI Power-Ups settings.\"));\n            }\n            settings = settingsResult.value;\n        } catch (error) {\n            this.logger.error(\n                { error },\n                \"Could not read the AI Power-Ups settings to find a model connection.\"\n            );\n            return Result.fail(new Error(\"Failed to load AI Power-Ups settings.\"));\n        }\n\n        const sdkName = sdkNameFromModel(model);\n        const presets = settings.connections?.presets ?? [];\n        const connection = presets.find(preset => {\n            return preset.sdkName === sdkName && Boolean(preset.apiKeyEncrypted);\n        });\n        return Result.ok(connection ?? null);\n    }\n}\n\nexport const ConfiguredAiModelsService = Abstraction.createImplementation({\n    implementation: ConfiguredAiModelsServiceImpl,\n    dependencies: [Ai, GetSettingsUseCase, Logger]\n});\n"],"names":["ConfiguredAiModelsServiceImpl","ai","getSettings","logger","settings","settingsResult","Result","Error","error","models","presets","providerIds","Set","preset","configured","Map","model","id","separator","idSegments","segment","sdkName","sdkNameFromModel","connection","Boolean","ConfiguredAiModelsService","Abstraction","Ai","GetSettingsUseCase","Logger"],"mappings":"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"}