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

package/api/features/WbGeneratePageContent/ComponentFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/WbGeneratePageContent/ComponentFilter.js","sources":["../../../../src/api/features/WbGeneratePageContent/ComponentFilter.ts"],"sourcesContent":["/**\n * Validates LLM-generated page content against the component catalog.\n * Recursively walks the element tree (including nested CreateElement actions\n * inside slot inputs) and removes any element whose component name is not\n * in the catalog. Tool envelopes are left untouched.\n */\nexport class ComponentFilter {\n    private readonly validNames: Set<string>;\n\n    constructor(components: Array<{ name: string }>) {\n        this.validNames = new Set(components.map(c => c.name));\n    }\n\n    filter(elements: unknown[]): unknown[] {\n        return elements\n            .filter(el => this.isValid(el))\n            .map(el => this.processInputs(el as Record<string, unknown>));\n    }\n\n    private isValid(el: unknown): boolean {\n        if (!el || typeof el !== \"object\") {\n            return true;\n        }\n\n        const obj = el as Record<string, unknown>;\n\n        if (\"component\" in obj && typeof obj.component === \"string\") {\n            return this.validNames.has(obj.component);\n        }\n\n        if (obj.action === \"CreateElement\" && obj.params && typeof obj.params === \"object\") {\n            const params = obj.params as Record<string, unknown>;\n            if (\"component\" in params && typeof params.component === \"string\") {\n                return this.validNames.has(params.component);\n            }\n        }\n\n        return true;\n    }\n\n    private processInputs(el: Record<string, unknown>): Record<string, unknown> {\n        const inputs = this.getInputs(el);\n        if (!inputs) {\n            return el;\n        }\n\n        const cleaned: Record<string, unknown> = {};\n        for (const [key, value] of Object.entries(inputs)) {\n            cleaned[key] = this.processValue(value);\n        }\n\n        return this.setInputs(el, cleaned);\n    }\n\n    private getInputs(el: Record<string, unknown>): Record<string, unknown> | null {\n        if (\"inputs\" in el && el.inputs && typeof el.inputs === \"object\") {\n            return el.inputs as Record<string, unknown>;\n        }\n\n        if (\n            el.action === \"CreateElement\" &&\n            el.params &&\n            typeof el.params === \"object\" &&\n            \"inputs\" in (el.params as Record<string, unknown>)\n        ) {\n            const params = el.params as Record<string, unknown>;\n            return params.inputs as Record<string, unknown>;\n        }\n\n        return null;\n    }\n\n    private setInputs(\n        el: Record<string, unknown>,\n        inputs: Record<string, unknown>\n    ): Record<string, unknown> {\n        if (\"inputs\" in el) {\n            return { ...el, inputs };\n        }\n\n        if (el.action === \"CreateElement\" && el.params && typeof el.params === \"object\") {\n            return { ...el, params: { ...el.params, inputs } };\n        }\n\n        return el;\n    }\n\n    private processValue(value: unknown): unknown {\n        if (Array.isArray(value)) {\n            return value.filter(item => this.isValid(item)).map(item => this.processValue(item));\n        }\n\n        if (!value || typeof value !== \"object\") {\n            return value;\n        }\n\n        const obj = value as Record<string, unknown>;\n\n        if (\"tool\" in obj) {\n            return value;\n        }\n\n        if (obj.action === \"CreateElement\") {\n            if (!this.isValid(obj)) {\n                return null;\n            }\n            return this.processInputs(obj);\n        }\n\n        if (\"component\" in obj && \"inputs\" in obj) {\n            return this.processInputs(obj);\n        }\n\n        const result: Record<string, unknown> = {};\n        let changed = false;\n        for (const [k, v] of Object.entries(obj)) {\n            const processed = this.processValue(v);\n            result[k] = processed;\n            if (processed !== v) {\n                changed = true;\n            }\n        }\n        return changed ? result : value;\n    }\n}\n"],"names":["ComponentFilter","components","Set","c","elements","el","obj","params","inputs","cleaned","key","value","Object","Array","item","result","changed","k","v","processed"],"mappings":"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"}

package/api/features/WbGeneratePageContent/WbGeneratePageContentTask.d.ts

@@ -0,0 +1,39 @@
+import { TaskDefinition, TaskHandler } from "@webiny/api-core/features/task/TaskDefinition/index.js";
+import { WebsocketsSendToIdentityUseCase } from "@webiny/api-websockets/features/SendToIdentity/abstractions.js";
+import { WbGeneratePageContentUseCase } from "../../../api/features/WbGeneratePageContent/index.js";
+import { IdentityContext } from "@webiny/api-core/exports/api/security.js";
+export declare const WB_GENERATE_PAGE_CONTENT_TASK_ID = "aiPowerUpsGeneratePageContent";
+export interface IWbGeneratePageContentTaskInput {
+    prompt: string;
+    components: unknown;
+    tools: unknown;
+    projectId?: string | null;
+    excludedFileIds?: string[] | null;
+    readerPersonaId?: string | null;
+    writerPersonaId?: string | null;
+    additionalFileIds?: string[] | null;
+}
+declare class WbGeneratePageContentTaskHandlerImpl implements TaskHandler.Interface<IWbGeneratePageContentTaskInput> {
+    private identityContext;
+    private generatePageContent;
+    private sendToIdentity;
+    constructor(identityContext: IdentityContext.Interface, generatePageContent: WbGeneratePageContentUseCase.Interface, sendToIdentity: WebsocketsSendToIdentityUseCase.Interface);
+    run({ input, controller }: TaskHandler.RunParams<IWbGeneratePageContentTaskInput>): Promise<TaskDefinition.Result<IWbGeneratePageContentTaskInput>>;
+    private sendContentToUser;
+    private sendErrorToUser;
+}
+declare class WbGeneratePageContentTaskImpl implements TaskDefinition.Interface {
+    id: string;
+    title: string;
+    description: string;
+    maxIterations: number;
+    isPrivate: boolean;
+    databaseLogs: boolean;
+    handler: typeof WbGeneratePageContentTaskHandlerImpl & {
+        __abstraction: import("@webiny/di").Abstraction<import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskHandler<import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskInput, import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskOutput>>;
+    };
+}
+export declare const WbGeneratePageContentTask: typeof WbGeneratePageContentTaskImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskDefinition<import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskInput, import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskOutput>>;
+};
+export {};

package/api/features/WbGeneratePageContent/WbGeneratePageContentTask.js

@@ -0,0 +1,94 @@
+import { TaskDefinition, TaskHandler } from "@webiny/api-core/features/task/TaskDefinition/index.js";
+import { WebsocketsSendToIdentityUseCase } from "@webiny/api-websockets/features/SendToIdentity/abstractions.js";
+import { compress } from "@webiny/utils/features/compression/legacy/gzip.js";
+import { WbGeneratePageContentUseCase } from "./index.js";
+import { IdentityContext } from "@webiny/api-core/exports/api/security.js";
+const WB_GENERATE_PAGE_CONTENT_TASK_ID = "aiPowerUpsGeneratePageContent";
+class WbGeneratePageContentTaskHandlerImpl {
+    constructor(identityContext, generatePageContent, sendToIdentity){
+        this.identityContext = identityContext;
+        this.generatePageContent = generatePageContent;
+        this.sendToIdentity = sendToIdentity;
+    }
+    async run({ input, controller }) {
+        if (controller.runtime.isAborted()) return controller.response.aborted();
+        const identity = this.identityContext.getIdentity();
+        let result;
+        try {
+            result = await this.generatePageContent.execute({
+                prompt: input.prompt,
+                components: input.components,
+                tools: input.tools,
+                projectId: input.projectId,
+                excludedFileIds: input.excludedFileIds,
+                readerPersonaId: input.readerPersonaId,
+                writerPersonaId: input.writerPersonaId,
+                additionalFileIds: input.additionalFileIds
+            });
+        } catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            await this.sendErrorToUser(identity.id, message);
+            return controller.response.error({
+                message
+            });
+        }
+        if (result.isFail()) {
+            await this.sendErrorToUser(identity.id, result.error.message);
+            return controller.response.error({
+                message: result.error.message
+            });
+        }
+        const compressed = await compress(result.value.output);
+        const payload = compressed.toString("base64");
+        await this.sendContentToUser(identity.id, payload, result.value.telemetry);
+        return controller.response.done("Page content generated successfully.");
+    }
+    async sendContentToUser(identityId, payload, telemetry) {
+        await this.sendToIdentity.execute({
+            id: identityId
+        }, {
+            action: "aiPowerUps.generatePageContent.content",
+            data: {
+                compression: "gzip",
+                value: payload,
+                telemetry
+            }
+        });
+    }
+    async sendErrorToUser(identityId, message) {
+        await this.sendToIdentity.execute({
+            id: identityId
+        }, {
+            action: "aiPowerUps.generatePageContent.error",
+            data: {
+                message
+            }
+        });
+    }
+}
+const WbGeneratePageContentTaskHandler = TaskHandler.createImplementation({
+    implementation: WbGeneratePageContentTaskHandlerImpl,
+    dependencies: [
+        IdentityContext,
+        WbGeneratePageContentUseCase,
+        WebsocketsSendToIdentityUseCase
+    ]
+});
+class WbGeneratePageContentTaskImpl {
+    constructor(){
+        this.id = WB_GENERATE_PAGE_CONTENT_TASK_ID;
+        this.title = "AI Power-Ups - Generate Page Content";
+        this.description = "Generates page content using AI based on a user prompt.";
+        this.maxIterations = 1;
+        this.isPrivate = true;
+        this.databaseLogs = false;
+        this.handler = WbGeneratePageContentTaskHandler;
+    }
+}
+const WbGeneratePageContentTask = TaskDefinition.createImplementation({
+    implementation: WbGeneratePageContentTaskImpl,
+    dependencies: []
+});
+export { WB_GENERATE_PAGE_CONTENT_TASK_ID, WbGeneratePageContentTask };
+
+//# sourceMappingURL=WbGeneratePageContentTask.js.map

package/api/features/WbGeneratePageContent/WbGeneratePageContentTask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/WbGeneratePageContent/WbGeneratePageContentTask.js","sources":["../../../../src/api/features/WbGeneratePageContent/WbGeneratePageContentTask.ts"],"sourcesContent":["import {\n    TaskDefinition,\n    TaskHandler\n} from \"@webiny/api-core/features/task/TaskDefinition/index.js\";\nimport { WebsocketsSendToIdentityUseCase } from \"@webiny/api-websockets/features/SendToIdentity/abstractions.js\";\nimport { compress } from \"@webiny/utils/features/compression/legacy/gzip.js\";\nimport { WbGeneratePageContentUseCase } from \"~/api/features/WbGeneratePageContent/index.js\";\nimport type { GenerationTelemetry } from \"~/api/features/WbGeneratePageContent/abstractions.js\";\nimport { IdentityContext } from \"@webiny/api-core/exports/api/security.js\";\n\nexport const WB_GENERATE_PAGE_CONTENT_TASK_ID = \"aiPowerUpsGeneratePageContent\";\n\nexport interface IWbGeneratePageContentTaskInput {\n    prompt: string;\n    components: unknown;\n    tools: unknown;\n    projectId?: string | null;\n    excludedFileIds?: string[] | null;\n    readerPersonaId?: string | null;\n    writerPersonaId?: string | null;\n    additionalFileIds?: string[] | null;\n}\n\nclass WbGeneratePageContentTaskHandlerImpl implements TaskHandler.Interface<IWbGeneratePageContentTaskInput> {\n    constructor(\n        private identityContext: IdentityContext.Interface,\n        private generatePageContent: WbGeneratePageContentUseCase.Interface,\n        private sendToIdentity: WebsocketsSendToIdentityUseCase.Interface\n    ) {}\n\n    async run({\n        input,\n        controller\n    }: TaskHandler.RunParams<IWbGeneratePageContentTaskInput>): Promise<\n        TaskDefinition.Result<IWbGeneratePageContentTaskInput>\n    > {\n        if (controller.runtime.isAborted()) {\n            return controller.response.aborted();\n        }\n\n        const identity = this.identityContext.getIdentity();\n\n        let result;\n        try {\n            result = await this.generatePageContent.execute({\n                prompt: input.prompt,\n                components: input.components,\n                tools: input.tools,\n                projectId: input.projectId,\n                excludedFileIds: input.excludedFileIds,\n                readerPersonaId: input.readerPersonaId,\n                writerPersonaId: input.writerPersonaId,\n                additionalFileIds: input.additionalFileIds\n            });\n        } catch (err) {\n            const message = err instanceof Error ? err.message : String(err);\n            await this.sendErrorToUser(identity.id, message);\n            return controller.response.error({ message });\n        }\n\n        if (result.isFail()) {\n            await this.sendErrorToUser(identity.id, result.error.message);\n\n            return controller.response.error({\n                message: result.error.message\n            });\n        }\n\n        const compressed = await compress(result.value.output);\n        const payload = compressed.toString(\"base64\");\n\n        await this.sendContentToUser(identity.id, payload, result.value.telemetry);\n\n        return controller.response.done(\"Page content generated successfully.\");\n    }\n\n    private async sendContentToUser(\n        identityId: string,\n        payload: string,\n        telemetry: GenerationTelemetry\n    ) {\n        await this.sendToIdentity.execute(\n            { id: identityId },\n            {\n                action: \"aiPowerUps.generatePageContent.content\",\n                data: {\n                    compression: \"gzip\",\n                    value: payload,\n                    telemetry\n                }\n            }\n        );\n    }\n\n    private async sendErrorToUser(identityId: string, message: string) {\n        await this.sendToIdentity.execute(\n            { id: identityId },\n            {\n                action: \"aiPowerUps.generatePageContent.error\",\n                data: {\n                    message\n                }\n            }\n        );\n    }\n}\n\nconst WbGeneratePageContentTaskHandler = TaskHandler.createImplementation({\n    implementation: WbGeneratePageContentTaskHandlerImpl,\n    dependencies: [IdentityContext, WbGeneratePageContentUseCase, WebsocketsSendToIdentityUseCase]\n});\n\nclass WbGeneratePageContentTaskImpl implements TaskDefinition.Interface {\n    id = WB_GENERATE_PAGE_CONTENT_TASK_ID;\n    title = \"AI Power-Ups - Generate Page Content\";\n    description = \"Generates page content using AI based on a user prompt.\";\n    maxIterations = 1;\n    isPrivate = true;\n    databaseLogs = false;\n\n    handler = WbGeneratePageContentTaskHandler;\n}\n\nexport const WbGeneratePageContentTask = TaskDefinition.createImplementation({\n    implementation: WbGeneratePageContentTaskImpl,\n    dependencies: []\n});\n"],"names":["WB_GENERATE_PAGE_CONTENT_TASK_ID","WbGeneratePageContentTaskHandlerImpl","identityContext","generatePageContent","sendToIdentity","input","controller","identity","result","err","message","Error","String","compressed","compress","payload","identityId","telemetry","WbGeneratePageContentTaskHandler","TaskHandler","IdentityContext","WbGeneratePageContentUseCase","WebsocketsSendToIdentityUseCase","WbGeneratePageContentTaskImpl","WbGeneratePageContentTask","TaskDefinition"],"mappings":";;;;;AAUO,MAAMA,mCAAmC;AAahD,MAAMC;IACF,YACYC,eAA0C,EAC1CC,mBAA2D,EAC3DC,cAAyD,CACnE;aAHUF,eAAe,GAAfA;aACAC,mBAAmB,GAAnBA;aACAC,cAAc,GAAdA;IACT;IAEH,MAAM,IAAI,EACNC,KAAK,EACLC,UAAU,EAC2C,EAEvD;QACE,IAAIA,WAAW,OAAO,CAAC,SAAS,IAC5B,OAAOA,WAAW,QAAQ,CAAC,OAAO;QAGtC,MAAMC,WAAW,IAAI,CAAC,eAAe,CAAC,WAAW;QAEjD,IAAIC;QACJ,IAAI;YACAA,SAAS,MAAM,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC;gBAC5C,QAAQH,MAAM,MAAM;gBACpB,YAAYA,MAAM,UAAU;gBAC5B,OAAOA,MAAM,KAAK;gBAClB,WAAWA,MAAM,SAAS;gBAC1B,iBAAiBA,MAAM,eAAe;gBACtC,iBAAiBA,MAAM,eAAe;gBACtC,iBAAiBA,MAAM,eAAe;gBACtC,mBAAmBA,MAAM,iBAAiB;YAC9C;QACJ,EAAE,OAAOI,KAAK;YACV,MAAMC,UAAUD,eAAeE,QAAQF,IAAI,OAAO,GAAGG,OAAOH;YAC5D,MAAM,IAAI,CAAC,eAAe,CAACF,SAAS,EAAE,EAAEG;YACxC,OAAOJ,WAAW,QAAQ,CAAC,KAAK,CAAC;gBAAEI;YAAQ;QAC/C;QAEA,IAAIF,OAAO,MAAM,IAAI;YACjB,MAAM,IAAI,CAAC,eAAe,CAACD,SAAS,EAAE,EAAEC,OAAO,KAAK,CAAC,OAAO;YAE5D,OAAOF,WAAW,QAAQ,CAAC,KAAK,CAAC;gBAC7B,SAASE,OAAO,KAAK,CAAC,OAAO;YACjC;QACJ;QAEA,MAAMK,aAAa,MAAMC,SAASN,OAAO,KAAK,CAAC,MAAM;QACrD,MAAMO,UAAUF,WAAW,QAAQ,CAAC;QAEpC,MAAM,IAAI,CAAC,iBAAiB,CAACN,SAAS,EAAE,EAAEQ,SAASP,OAAO,KAAK,CAAC,SAAS;QAEzE,OAAOF,WAAW,QAAQ,CAAC,IAAI,CAAC;IACpC;IAEA,MAAc,kBACVU,UAAkB,EAClBD,OAAe,EACfE,SAA8B,EAChC;QACE,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAC7B;YAAE,IAAID;QAAW,GACjB;YACI,QAAQ;YACR,MAAM;gBACF,aAAa;gBACb,OAAOD;gBACPE;YACJ;QACJ;IAER;IAEA,MAAc,gBAAgBD,UAAkB,EAAEN,OAAe,EAAE;QAC/D,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAC7B;YAAE,IAAIM;QAAW,GACjB;YACI,QAAQ;YACR,MAAM;gBACFN;YACJ;QACJ;IAER;AACJ;AAEA,MAAMQ,mCAAmCC,YAAY,oBAAoB,CAAC;IACtE,gBAAgBlB;IAChB,cAAc;QAACmB;QAAiBC;QAA8BC;KAAgC;AAClG;AAEA,MAAMC;;aACF,EAAE,GAAGvB;aACL,KAAK,GAAG;aACR,WAAW,GAAG;aACd,aAAa,GAAG;aAChB,SAAS,GAAG;aACZ,YAAY,GAAG;aAEf,OAAO,GAAGkB;;AACd;AAEO,MAAMM,4BAA4BC,eAAe,oBAAoB,CAAC;IACzE,gBAAgBF;IAChB,cAAc,EAAE;AACpB"}

package/api/features/WbGeneratePageContent/WbGeneratePageContentUseCase.d.ts

@@ -0,0 +1,21 @@
+import { Result } from "@webiny/feature/api";
+import { Ai } from "@webiny/api-core/features/ai/index.js";
+import { AiSdkTools } from "@webiny/api-core/features/ai/index.js";
+import { ListTagsUseCase } from "@webiny/api-file-manager/features/file/ListTags/index.js";
+import { ResolveAiCapabilityUseCase } from "../../../api/features/Capabilities/index.js";
+import { AiPromptContextBuilder } from "../../../api/features/AiPromptContext/index.js";
+import { WbGeneratePageContentUseCase } from "./abstractions.js";
+import type { WbGeneratePageContentParams, GeneratePageContentResult } from "./abstractions.js";
+declare class WbGeneratePageContentUseCaseImpl implements WbGeneratePageContentUseCase.Interface {
+    private promptContextBuilder;
+    private resolveCapability;
+    private ai;
+    private aiSdkTools;
+    private listTags;
+    constructor(promptContextBuilder: AiPromptContextBuilder.Interface, resolveCapability: ResolveAiCapabilityUseCase.Interface, ai: Ai.Interface, aiSdkTools: AiSdkTools.Interface, listTags: ListTagsUseCase.Interface);
+    execute(params: WbGeneratePageContentParams): Promise<Result<GeneratePageContentResult, Error>>;
+}
+export declare const WbGeneratePageContentUseCaseImplementation: typeof WbGeneratePageContentUseCaseImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("./abstractions.js").IWbGeneratePageContentUseCase>;
+};
+export {};

package/api/features/WbGeneratePageContent/WbGeneratePageContentUseCase.js

@@ -0,0 +1,113 @@
+import { stepCountIs } from "ai";
+import { Result } from "@webiny/feature/api";
+import { Ai, AiSdkTools } from "@webiny/api-core/features/ai/index.js";
+import { ListTagsUseCase } from "@webiny/api-file-manager/features/file/ListTags/index.js";
+import { ResolveAiCapabilityUseCase, withAdditionalInstructions } from "../Capabilities/index.js";
+import { WB_GENERATE_PAGE_CAPABILITY } from "./capability.js";
+import { AiPromptContextBuilder, formatAdditionalFilesContext } from "../AiPromptContext/index.js";
+import { createReadProjectFileTool } from "../AiPromptContext/ReadProjectFileTool.js";
+import { WbGeneratePageContentUseCase } from "./abstractions.js";
+import { buildDomainPrompt } from "./buildPrompt.js";
+import { LlmJsonResponse } from "../../../domain/LlmJsonResponse.js";
+import { ComponentFilter } from "./ComponentFilter.js";
+class WbGeneratePageContentUseCaseImpl {
+    constructor(promptContextBuilder, resolveCapability, ai, aiSdkTools, listTags){
+        this.promptContextBuilder = promptContextBuilder;
+        this.resolveCapability = resolveCapability;
+        this.ai = ai;
+        this.aiSdkTools = aiSdkTools;
+        this.listTags = listTags;
+    }
+    async execute(params) {
+        const resolved = await this.resolveCapability.execute(WB_GENERATE_PAGE_CAPABILITY);
+        if (resolved.isFail()) return Result.fail(resolved.error);
+        const capability = resolved.value;
+        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 components = params.components;
+        const systemText = withAdditionalInstructions(capability, buildDomainPrompt(components, params.tools, 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 elements = LlmJsonResponse.fromRawText(text).toArray();
+            const componentFilter = new ComponentFilter(components);
+            const output = JSON.stringify(componentFilter.filter(elements));
+            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({
+                output,
+                telemetry
+            });
+        } catch (error) {
+            return Result.fail(new Error(`AI generation failed: ${error instanceof Error ? error.message : String(error)}`));
+        }
+    }
+}
+const WbGeneratePageContentUseCaseImplementation = WbGeneratePageContentUseCase.createImplementation({
+    implementation: WbGeneratePageContentUseCaseImpl,
+    dependencies: [
+        AiPromptContextBuilder,
+        ResolveAiCapabilityUseCase,
+        Ai,
+        AiSdkTools,
+        ListTagsUseCase
+    ]
+});
+export { WbGeneratePageContentUseCaseImplementation };
+
+//# sourceMappingURL=WbGeneratePageContentUseCase.js.map

package/api/features/WbGeneratePageContent/WbGeneratePageContentUseCase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/WbGeneratePageContent/WbGeneratePageContentUseCase.js","sources":["../../../../src/api/features/WbGeneratePageContent/WbGeneratePageContentUseCase.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 { ListTagsUseCase } from \"@webiny/api-file-manager/features/file/ListTags/index.js\";\nimport {\n    ResolveAiCapabilityUseCase,\n    withAdditionalInstructions\n} from \"~/api/features/Capabilities/index.js\";\nimport { WB_GENERATE_PAGE_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 { WbGeneratePageContentUseCase } from \"./abstractions.js\";\nimport type {\n    WbGeneratePageContentParams,\n    GeneratePageContentResult,\n    GenerationTelemetry\n} from \"./abstractions.js\";\nimport { buildDomainPrompt } from \"./buildPrompt.js\";\nimport { LlmJsonResponse } from \"~/domain/LlmJsonResponse.js\";\nimport { ComponentFilter } from \"./ComponentFilter.js\";\n\nclass WbGeneratePageContentUseCaseImpl implements WbGeneratePageContentUseCase.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    ) {}\n\n    async execute(\n        params: WbGeneratePageContentParams\n    ): Promise<Result<GeneratePageContentResult, Error>> {\n        const resolved = await this.resolveCapability.execute(WB_GENERATE_PAGE_CAPABILITY);\n        if (resolved.isFail()) {\n            return Result.fail(resolved.error);\n        }\n\n        const capability = resolved.value;\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        // Fetch image tags so the prompt can enumerate what's queryable; without\n        // this the model invents tag/IDs instead of calling listImagesByTag.\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 components = params.components as Array<{ name: string }>;\n        const systemText = withAdditionalInstructions(\n            capability,\n            buildDomainPrompt(components, params.tools, 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 elements = LlmJsonResponse.fromRawText(text).toArray();\n            const componentFilter = new ComponentFilter(components);\n            const output = JSON.stringify(componentFilter.filter(elements));\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: GenerationTelemetry = {\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            return Result.ok({ output, 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 WbGeneratePageContentUseCaseImplementation =\n    WbGeneratePageContentUseCase.createImplementation({\n        implementation: WbGeneratePageContentUseCaseImpl,\n        dependencies: [\n            AiPromptContextBuilder,\n            ResolveAiCapabilityUseCase,\n            Ai,\n            AiSdkTools,\n            ListTagsUseCase\n        ]\n    });\n"],"names":["WbGeneratePageContentUseCaseImpl","promptContextBuilder","resolveCapability","ai","aiSdkTools","listTags","params","resolved","WB_GENERATE_PAGE_CAPABILITY","Result","capability","sdkTools","context","projectFileTool","createReadProjectFileTool","Object","tagsResult","imageTags","t","components","systemText","withAdditionalInstructions","buildDomainPrompt","system","aiResult","formatAdditionalFilesContext","stepCountIs","text","step","elements","LlmJsonResponse","componentFilter","ComponentFilter","output","JSON","filesRead","Set","toolCallsMade","call","input","telemetry","error","Error","String","WbGeneratePageContentUseCaseImplementation","WbGeneratePageContentUseCase","AiPromptContextBuilder","ResolveAiCapabilityUseCase","Ai","AiSdkTools","ListTagsUseCase"],"mappings":"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"}

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

@@ -0,0 +1,31 @@
+import { Result } from "@webiny/feature/api";
+export interface WbGeneratePageContentParams {
+    prompt: string;
+    components: unknown;
+    tools: unknown;
+    projectId?: string | null;
+    excludedFileIds?: string[] | null;
+    readerPersonaId?: string | null;
+    writerPersonaId?: string | null;
+    additionalFileIds?: string[] | null;
+}
+export interface GenerationTelemetry {
+    filesRead: string[];
+    cacheHit: boolean;
+    toolCallsMade: number;
+    totalSteps: number;
+    toolsAvailable: string[];
+    imageTagsInPrompt: string[];
+}
+export interface GeneratePageContentResult {
+    output: string;
+    telemetry: GenerationTelemetry;
+}
+export interface IWbGeneratePageContentUseCase {
+    execute(params: WbGeneratePageContentParams): Promise<Result<GeneratePageContentResult, Error>>;
+}
+export declare const WbGeneratePageContentUseCase: import("@webiny/di").Abstraction<IWbGeneratePageContentUseCase>;
+export declare namespace WbGeneratePageContentUseCase {
+    type Interface = IWbGeneratePageContentUseCase;
+    type Params = WbGeneratePageContentParams;
+}

package/api/features/WbGeneratePageContent/abstractions.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/WbGeneratePageContent/abstractions.js","sources":["../../../../src/api/features/WbGeneratePageContent/abstractions.ts"],"sourcesContent":["import { createAbstraction, Result } from \"@webiny/feature/api\";\n\nexport interface WbGeneratePageContentParams {\n    prompt: string;\n    components: unknown;\n    tools: unknown;\n    projectId?: string | null;\n    excludedFileIds?: string[] | null;\n    readerPersonaId?: string | null;\n    writerPersonaId?: string | null;\n    additionalFileIds?: string[] | null;\n}\n\nexport interface GenerationTelemetry {\n    filesRead: string[];\n    cacheHit: boolean;\n    toolCallsMade: number;\n    totalSteps: number;\n    toolsAvailable: string[];\n    imageTagsInPrompt: string[];\n}\n\nexport interface GeneratePageContentResult {\n    output: string;\n    telemetry: GenerationTelemetry;\n}\n\nexport interface IWbGeneratePageContentUseCase {\n    execute(params: WbGeneratePageContentParams): Promise<Result<GeneratePageContentResult, Error>>;\n}\n\nexport const WbGeneratePageContentUseCase = createAbstraction<IWbGeneratePageContentUseCase>(\n    \"AiPowerUpsWbGeneratePageContentUseCase\"\n);\n\nexport namespace WbGeneratePageContentUseCase {\n    export type Interface = IWbGeneratePageContentUseCase;\n    export type Params = WbGeneratePageContentParams;\n}\n"],"names":["WbGeneratePageContentUseCase","createAbstraction"],"mappings":";AA+BO,MAAMA,+BAA+BC,kBACxC"}

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

@@ -0,0 +1,3 @@
+export declare function buildDomainPrompt(components: Array<{
+    name: string;
+}>, tools: unknown, availableImageTags: string[]): string;

package/api/features/WbGeneratePageContent/buildPrompt.js

@@ -0,0 +1,158 @@
+function buildDomainPrompt(components, tools, availableImageTags) {
+    const componentNames = components.map((c)=>`"${c.name}"`).join(" | ");
+    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 page content generator. Given a user prompt, generate structured page content using the provided component catalog and available tools.
+
+###
+
+### Rich Text Content
+
+A single Webiny/Lexical element CAN contain an entire article, blog post, or content section,
+with all headings, paragraphs, lists, and blockquotes in a single HTML string.
+
+Create separate Webiny/Lexical elements when it needs to be mixed with other content elements.
+Example: RichText - Banner - RichText - Image - Banner - RichText
+
+### Image Selection
+
+You MUST call the \`listImagesByTag\` tool BEFORE emitting any \`resolveImage\` envelope.
+Do NOT invent image IDs. Any ID that was not returned by \`listImagesByTag\` will fail to resolve and the image field will end up empty in the editor.
+
+The File Manager currently has images tagged with: ${tagListing}.
+
+When a component needs an image:
+1. Pick the tag from the list above that best matches the page topic. Only use tags that appear in the list — never invent new tags.
+2. Call \`listImagesByTag\` with that tag.
+3. If the results are non-empty, choose the most appropriate image and reference it using:
+   { "tool": "resolveImage", "params": { "id": "<image_id_from_search>" } }
+4. If the results are empty, try one more tag from the list. If still nothing, leave the image field empty (do NOT invent an ID).
+
+You MUST generate the full page content as JSON after using any tools.
+Tool calls are for gathering information — your final response must
+always be the complete page JSON array.
+
+### SEO & Content Structure Best Practices
+
+When generating page content, follow these SEO guidelines:
+
+Heading hierarchy:
+- Use exactly ONE <h1> per page, as the main title/headline.
+- Use <h2> for major sections, <h3> for subsections. Never skip levels (e.g., no <h3> directly after <h1>).
+- Headings should be descriptive and include relevant keywords naturally — avoid generic headings like "Introduction" or "Section 1".
+
+Paragraphs and readability:
+- Keep paragraphs short — 2 to 4 sentences each.
+- Use <strong> and <em> to emphasize key terms and phrases that a reader scanning the page should notice.
+- Use bullet lists (<ul>) or numbered lists (<ol>) to break down complex information.
+- Write in an active voice. Be direct and concise.
+
+Content structure:
+- Lead with the most important information first (inverted pyramid).
+- Include a compelling opening paragraph immediately after the <h1> that summarizes the page's value proposition.
+- Use transition sentences between sections to maintain reading flow.
+- End with a clear call-to-action or summary.
+
+Keyword usage:
+- Incorporate the main topic keywords naturally in the <h1>, at least one <h2>, the opening paragraph, and throughout the body.
+- Avoid keyword stuffing — content must read naturally to a human.
+- Use semantic variations and related terms rather than repeating the exact same phrase.
+
+Links:
+- Where appropriate, use descriptive anchor text for links (not "click here" or "read more").
+
+### Component Catalog
+
+\`\`\`json
+${JSON.stringify(components, null, 2)}
+\`\`\`
+
+Grid layout options: \`12\`, \`6-6\`, \`4-4-4\`, \`8-4\`, \`4-8\`, \`3-3-3-3\`
+
+### Available Tools
+
+For input fields that require post-processing, wrap the value in a tool envelope: \`{ "tool": "<toolName>", "params": { ... } }\`.
+
+Plain values (text, number, boolean, select) should be set directly without an envelope.
+
+\`\`\`json
+${JSON.stringify(tools, null, 2)}
+\`\`\`
+
+### Page Schema
+
+\`\`\`typescript
+type ComponentName = ${componentNames};
+
+type ElementSchema = {
+  component: ComponentName;
+  inputs: Record<string, unknown>;
+};
+
+type CreateElementAction = {
+  action: "CreateElement";
+  params: ElementSchema;
+};
+
+type PageSchema = {
+  page: ElementSchema[];
+};
+\`\`\`
+
+For slot inputs, use \`{ "action": "CreateElement", "params": { "component": "...", "inputs": { ... } } }\`. For root items inside the "page" array, use \`ElementSchema\` shape.
+Note: \`CreateElement\` uses "action" — it is a structural instruction for the page builder, not a tool invocation.
+
+### Grid Structure Example
+
+When using Webiny/Grid, each column entry must use a CreateElement action
+to create a Webiny/GridColumn, and the GridColumn's children contain the
+actual content elements:
+
+\`\`\`json
+{
+  "component": "Webiny/Grid",
+  "inputs": {
+    "gridLayout": "6-6",
+    "columns": [
+      {
+        "children": {
+          "action": "CreateElement",
+          "params": {
+            "component": "Webiny/GridColumn",
+            "inputs": {
+              "children": [
+                {
+                  "action": "CreateElement",
+                  "params": {
+                    "component": "Webiny/Lexical",
+                    "inputs": {
+                      "content": {
+                        "tool": "textToLexical",
+                        "params": { "text": "..." }
+                      }
+                    }
+                  }
+                }
+              ]
+            }
+          }
+        }
+      }
+    ]
+  }
+}
+\`\`\`
+
+Key rules:
+- "columns" is an array, not an object with numeric keys
+- Each column has a "children" property containing a single CreateElement
+  for Webiny/GridColumn
+- Webiny/GridColumn's "children" is an array of CreateElement actions for
+  the actual content
+
+IMPORTANT: Only use components listed in the Component Catalog above. Do NOT invent component names. Any element with an unrecognized component name will be silently removed from the output.
+
+You MUST return a parsable JSON object with a "page" key containing the array of elements. No extra text outside the JSON.`;
+}
+export { buildDomainPrompt };
+
+//# sourceMappingURL=buildPrompt.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/WbGeneratePageContent/buildPrompt.js","sources":["../../../../src/api/features/WbGeneratePageContent/buildPrompt.ts"],"sourcesContent":["export function buildDomainPrompt(\n    components: Array<{ name: string }>,\n    tools: unknown,\n    availableImageTags: string[]\n): string {\n    const componentNames = components.map(c => `\"${c.name}\"`).join(\" | \");\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    return `You are a page content generator. Given a user prompt, generate structured page content using the provided component catalog and available tools.\n\n###\n\n### Rich Text Content\n\nA single Webiny/Lexical element CAN contain an entire article, blog post, or content section,\nwith all headings, paragraphs, lists, and blockquotes in a single HTML string.\n\nCreate separate Webiny/Lexical elements when it needs to be mixed with other content elements.\nExample: RichText - Banner - RichText - Image - Banner - RichText\n\n### Image Selection\n\nYou MUST call the \\`listImagesByTag\\` tool BEFORE emitting any \\`resolveImage\\` envelope.\nDo NOT invent image IDs. Any ID that was not returned by \\`listImagesByTag\\` will fail to resolve and the image field will end up empty in the editor.\n\nThe File Manager currently has images tagged with: ${tagListing}.\n\nWhen a component needs an image:\n1. Pick the tag from the list above that best matches the page topic. Only use tags that appear in the list — never invent new tags.\n2. Call \\`listImagesByTag\\` with that tag.\n3. If the results are non-empty, choose the most appropriate image and reference it using:\n   { \"tool\": \"resolveImage\", \"params\": { \"id\": \"<image_id_from_search>\" } }\n4. If the results are empty, try one more tag from the list. If still nothing, leave the image field empty (do NOT invent an ID).\n\nYou MUST generate the full page content as JSON after using any tools.\nTool calls are for gathering information — your final response must\nalways be the complete page JSON array.\n\n### SEO & Content Structure Best Practices\n\nWhen generating page content, follow these SEO guidelines:\n\nHeading hierarchy:\n- Use exactly ONE <h1> per page, as the main title/headline.\n- Use <h2> for major sections, <h3> for subsections. Never skip levels (e.g., no <h3> directly after <h1>).\n- Headings should be descriptive and include relevant keywords naturally — avoid generic headings like \"Introduction\" or \"Section 1\".\n\nParagraphs and readability:\n- Keep paragraphs short — 2 to 4 sentences each.\n- Use <strong> and <em> to emphasize key terms and phrases that a reader scanning the page should notice.\n- Use bullet lists (<ul>) or numbered lists (<ol>) to break down complex information.\n- Write in an active voice. Be direct and concise.\n\nContent structure:\n- Lead with the most important information first (inverted pyramid).\n- Include a compelling opening paragraph immediately after the <h1> that summarizes the page's value proposition.\n- Use transition sentences between sections to maintain reading flow.\n- End with a clear call-to-action or summary.\n\nKeyword usage:\n- Incorporate the main topic keywords naturally in the <h1>, at least one <h2>, the opening paragraph, and throughout the body.\n- Avoid keyword stuffing — content must read naturally to a human.\n- Use semantic variations and related terms rather than repeating the exact same phrase.\n\nLinks:\n- Where appropriate, use descriptive anchor text for links (not \"click here\" or \"read more\").\n\n### Component Catalog\n\n\\`\\`\\`json\n${JSON.stringify(components, null, 2)}\n\\`\\`\\`\n\nGrid layout options: \\`12\\`, \\`6-6\\`, \\`4-4-4\\`, \\`8-4\\`, \\`4-8\\`, \\`3-3-3-3\\`\n\n### Available Tools\n\nFor input fields that require post-processing, wrap the value in a tool envelope: \\`{ \"tool\": \"<toolName>\", \"params\": { ... } }\\`.\n\nPlain values (text, number, boolean, select) should be set directly without an envelope.\n\n\\`\\`\\`json\n${JSON.stringify(tools, null, 2)}\n\\`\\`\\`\n\n### Page Schema\n\n\\`\\`\\`typescript\ntype ComponentName = ${componentNames};\n\ntype ElementSchema = {\n  component: ComponentName;\n  inputs: Record<string, unknown>;\n};\n\ntype CreateElementAction = {\n  action: \"CreateElement\";\n  params: ElementSchema;\n};\n\ntype PageSchema = {\n  page: ElementSchema[];\n};\n\\`\\`\\`\n\nFor slot inputs, use \\`{ \"action\": \"CreateElement\", \"params\": { \"component\": \"...\", \"inputs\": { ... } } }\\`. For root items inside the \"page\" array, use \\`ElementSchema\\` shape.\nNote: \\`CreateElement\\` uses \"action\" — it is a structural instruction for the page builder, not a tool invocation.\n\n### Grid Structure Example\n\nWhen using Webiny/Grid, each column entry must use a CreateElement action\nto create a Webiny/GridColumn, and the GridColumn's children contain the\nactual content elements:\n\n\\`\\`\\`json\n{\n  \"component\": \"Webiny/Grid\",\n  \"inputs\": {\n    \"gridLayout\": \"6-6\",\n    \"columns\": [\n      {\n        \"children\": {\n          \"action\": \"CreateElement\",\n          \"params\": {\n            \"component\": \"Webiny/GridColumn\",\n            \"inputs\": {\n              \"children\": [\n                {\n                  \"action\": \"CreateElement\",\n                  \"params\": {\n                    \"component\": \"Webiny/Lexical\",\n                    \"inputs\": {\n                      \"content\": {\n                        \"tool\": \"textToLexical\",\n                        \"params\": { \"text\": \"...\" }\n                      }\n                    }\n                  }\n                }\n              ]\n            }\n          }\n        }\n      }\n    ]\n  }\n}\n\\`\\`\\`\n\nKey rules:\n- \"columns\" is an array, not an object with numeric keys\n- Each column has a \"children\" property containing a single CreateElement\n  for Webiny/GridColumn\n- Webiny/GridColumn's \"children\" is an array of CreateElement actions for\n  the actual content\n\nIMPORTANT: Only use components listed in the Component Catalog above. Do NOT invent component names. Any element with an unrecognized component name will be silently removed from the output.\n\nYou MUST return a parsable JSON object with a \"page\" key containing the array of elements. No extra text outside the JSON.`;\n}\n"],"names":["buildDomainPrompt","components","tools","availableImageTags","componentNames","c","tagListing","t","JSON"],"mappings":"AAAO,SAASA,kBACZC,UAAmC,EACnCC,KAAc,EACdC,kBAA4B;IAE5B,MAAMC,iBAAiBH,WAAW,GAAG,CAACI,CAAAA,IAAK,CAAC,CAAC,EAAEA,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;IAC/D,MAAMC,aACFH,mBAAmB,MAAM,GAAG,IACtBA,mBAAmB,GAAG,CAACI,CAAAA,IAAK,CAAC,EAAE,EAAEA,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,QAC7C;IACV,OAAO,CAAC;;;;;;;;;;;;;;;;;mDAiBuC,EAAED,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6ChE,EAAEE,KAAK,SAAS,CAACP,YAAY,MAAM,GAAG;;;;;;;;;;;;AAYtC,EAAEO,KAAK,SAAS,CAACN,OAAO,MAAM,GAAG;;;;;;qBAMZ,EAAEE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0HAsEoF,CAAC;AAC3H"}

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

@@ -0,0 +1,16 @@
+import { AiCapability } from "../../../api/features/Capabilities/index.js";
+export declare const WB_GENERATE_PAGE_CAPABILITY = "wbGeneratePage";
+/**
+ * No `guidance`, for the same reason as CMS entry generation: the prompt carries the component
+ * catalog and the tool definitions, both computed per request.
+ */
+declare class WbGeneratePageCapabilityImpl implements AiCapability.Interface {
+    readonly id = "wbGeneratePage";
+    readonly label = "Page generation";
+    readonly description = "Writes page content from a prompt using the Website Builder components available in the project.";
+    readonly defaultRole: "standard";
+}
+export declare const WbGeneratePageCapability: typeof WbGeneratePageCapabilityImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("~/api/features/Capabilities/index.js").IAiCapability>;
+};
+export {};

package/api/features/WbGeneratePageContent/capability.js

@@ -0,0 +1,17 @@
+import { AiCapability } from "../Capabilities/index.js";
+const WB_GENERATE_PAGE_CAPABILITY = "wbGeneratePage";
+class WbGeneratePageCapabilityImpl {
+    constructor(){
+        this.id = WB_GENERATE_PAGE_CAPABILITY;
+        this.label = "Page generation";
+        this.description = "Writes page content from a prompt using the Website Builder components available in the project.";
+        this.defaultRole = "standard";
+    }
+}
+const WbGeneratePageCapability = AiCapability.createImplementation({
+    implementation: WbGeneratePageCapabilityImpl,
+    dependencies: []
+});
+export { WB_GENERATE_PAGE_CAPABILITY, WbGeneratePageCapability };
+
+//# sourceMappingURL=capability.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/WbGeneratePageContent/capability.js","sources":["../../../../src/api/features/WbGeneratePageContent/capability.ts"],"sourcesContent":["import { AiCapability } from \"~/api/features/Capabilities/index.js\";\n\nexport const WB_GENERATE_PAGE_CAPABILITY = \"wbGeneratePage\";\n\n/**\n * No `guidance`, for the same reason as CMS entry generation: the prompt carries the component\n * catalog and the tool definitions, both computed per request.\n */\nclass WbGeneratePageCapabilityImpl implements AiCapability.Interface {\n    readonly id = WB_GENERATE_PAGE_CAPABILITY;\n    readonly label = \"Page generation\";\n    readonly description =\n        \"Writes page content from a prompt using the Website Builder components available in the project.\";\n    readonly defaultRole = \"standard\" as const;\n}\n\nexport const WbGeneratePageCapability = AiCapability.createImplementation({\n    implementation: WbGeneratePageCapabilityImpl,\n    dependencies: []\n});\n"],"names":["WB_GENERATE_PAGE_CAPABILITY","WbGeneratePageCapabilityImpl","WbGeneratePageCapability","AiCapability"],"mappings":";AAEO,MAAMA,8BAA8B;AAM3C,MAAMC;;aACO,EAAE,GAAGD;aACL,KAAK,GAAG;aACR,WAAW,GAChB;aACK,WAAW,GAAG;;AAC3B;AAEO,MAAME,2BAA2BC,aAAa,oBAAoB,CAAC;IACtE,gBAAgBF;IAChB,cAAc,EAAE;AACpB"}

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

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

package/api/features/WbGeneratePageContent/feature.js

@@ -0,0 +1,15 @@
+import { createFeature } from "@webiny/feature/api";
+import { WbGeneratePageContentUseCaseImplementation } from "./WbGeneratePageContentUseCase.js";
+import { WbGeneratePageContentTask } from "./WbGeneratePageContentTask.js";
+import { WbGeneratePageCapability } from "./capability.js";
+const WbGeneratePageContentFeature = createFeature({
+    name: "AiPowerUps/WbGeneratePageContent",
+    register (container) {
+        container.register(WbGeneratePageCapability);
+        container.register(WbGeneratePageContentUseCaseImplementation);
+        container.register(WbGeneratePageContentTask);
+    }
+});
+export { WbGeneratePageContentFeature };
+
+//# sourceMappingURL=feature.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/WbGeneratePageContent/feature.js","sources":["../../../../src/api/features/WbGeneratePageContent/feature.ts"],"sourcesContent":["import { createFeature } from \"@webiny/feature/api\";\nimport { WbGeneratePageContentUseCaseImplementation } from \"./WbGeneratePageContentUseCase.js\";\nimport { WbGeneratePageContentTask } from \"./WbGeneratePageContentTask.js\";\nimport { WbGeneratePageCapability } from \"./capability.js\";\n\nexport const WbGeneratePageContentFeature = createFeature({\n    name: \"AiPowerUps/WbGeneratePageContent\",\n    register(container) {\n        container.register(WbGeneratePageCapability);\n        container.register(WbGeneratePageContentUseCaseImplementation);\n        container.register(WbGeneratePageContentTask);\n    }\n});\n"],"names":["WbGeneratePageContentFeature","createFeature","container","WbGeneratePageCapability","WbGeneratePageContentUseCaseImplementation","WbGeneratePageContentTask"],"mappings":";;;;AAKO,MAAMA,+BAA+BC,cAAc;IACtD,MAAM;IACN,UAASC,SAAS;QACdA,UAAU,QAAQ,CAACC;QACnBD,UAAU,QAAQ,CAACE;QACnBF,UAAU,QAAQ,CAACG;IACvB;AACJ"}

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

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

package/api/features/WbGeneratePageContent/index.js

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