@webiny/ai-powerups 6.6.0-alpha.4 → 6.6.0-alpha.5

package/api/features/AdminAssistant/events.d.ts

@@ -0,0 +1,54 @@
+import type { ModelMessage } from "ai";
+import type { PendingApproval } from "./approvals.js";
+/**
+ * What the assistant emits while it works.
+ *
+ * Deliberately a small, purpose-built set rather than the AI SDK's UI-message protocol: the client is
+ * a command palette, not a chat framework, and it needs one thing the SDK protocol does not model for
+ * us — the approval pause. Keeping our own events also means the admin bundle carries no AI SDK code.
+ *
+ * Transport-free by design. A transport frames these (as SSE, as newline JSON, as a CLI render); the
+ * feature only says what happened.
+ */
+export type AdminAssistantEvent = 
+/** A fragment of the answer. Concatenate in arrival order. */
+{
+    type: "text";
+    text: string;
+}
+/** A tool started running. Named so the UI can show work in progress, not just a spinner. */
+ | {
+    type: "tool-call";
+    name: string;
+}
+/** A tool finished. Pairs with `tool-call` by name. */
+ | {
+    type: "tool-result";
+    name: string;
+}
+/**
+ * A tool threw. Also pairs with `tool-call` by name, and is NOT terminal: the model reads the
+ * message and usually corrects itself on the next step, which is why tools report failure by
+ * throwing. Without this the call would have no outcome and its chip would spin forever.
+ */
+ | {
+    type: "tool-error";
+    name: string;
+    message: string;
+}
+/** The loop paused: these calls change something and need a human decision. */
+ | {
+    type: "approval";
+    approvals: PendingApproval[];
+}
+/** Terminal success. Carries what the client must replay to resume after an approval. */
+ | {
+    type: "done";
+    messages: ModelMessage[];
+    steps: number;
+}
+/** Terminal failure. The run produced no usable answer. */
+ | {
+    type: "error";
+    message: string;
+};

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

@@ -0,0 +1,12 @@
+/**
+ * The admin assistant: its capability, the use case, and the HTTP route that reaches it.
+ *
+ * Lives in AI Power-Ups rather than in a package of its own because everything it needs is here —
+ * the settings that choose its model, the capability resolver that reads them, and the tools it
+ * calls. As a separate package it could only reach those through an abstraction registered back
+ * from this side, which is an indirection that bought nothing.
+ */
+export declare const AdminAssistantFeature: {
+    name: string;
+    register(container: import("@webiny/di").Container): void;
+};

package/api/features/AdminAssistant/feature.js

@@ -0,0 +1,23 @@
+import { createFeature } from "@webiny/feature/api";
+import { FeatureFlags } from "@webiny/api-core/features/featureFlags/abstractions.js";
+import { AdminAssistantConfig } from "./abstractions.js";
+import { AdminAssistantUseCase } from "./AdminAssistantUseCase.js";
+import { AdminAssistantStreamRouteDefinition } from "./AdminAssistantStreamRoute.js";
+import { AdminAssistantCapability } from "./capability.js";
+const MAX_STEPS = 12;
+const AdminAssistantFeature = createFeature({
+    name: "AiPowerUps/AdminAssistant",
+    register (container) {
+        const enabled = container.resolve(FeatureFlags).get().isEnabled("aiPowerups.adminAssistant");
+        if (!enabled) return;
+        container.register(AdminAssistantCapability);
+        container.registerInstance(AdminAssistantConfig, {
+            maxSteps: MAX_STEPS
+        });
+        container.register(AdminAssistantUseCase);
+        container.register(AdminAssistantStreamRouteDefinition);
+    }
+});
+export { AdminAssistantFeature };
+
+//# sourceMappingURL=feature.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/AdminAssistant/feature.js","sources":["../../../../src/api/features/AdminAssistant/feature.ts"],"sourcesContent":["import { createFeature } from \"@webiny/feature/api\";\nimport { FeatureFlags } from \"@webiny/api-core/features/featureFlags/abstractions.js\";\nimport { AdminAssistantConfig } from \"./abstractions.js\";\nimport { AdminAssistantUseCase } from \"./AdminAssistantUseCase.js\";\nimport { AdminAssistantStreamRouteDefinition } from \"./AdminAssistantStreamRoute.js\";\nimport { AdminAssistantCapability } from \"./capability.js\";\n\n/**\n * How many rounds the agent loop may take before it is cut off.\n *\n * Enough for the deepest expected chain: list models, describe one, query it, answer — plus room for\n * a corrected retry after a rejected filter.\n *\n * Deliberately not configurable. It is a runaway guard, closer to a timeout than a setting, and the\n * number only means something next to the tool chains the assistant actually walks. Exposing it\n * invites a project to raise it to 100 and find out what that costs.\n */\nconst MAX_STEPS = 12;\n\n/**\n * The admin assistant: its capability, the use case, and the HTTP route that reaches it.\n *\n * Lives in AI Power-Ups rather than in a package of its own because everything it needs is here —\n * the settings that choose its model, the capability resolver that reads them, and the tools it\n * calls. As a separate package it could only reach those through an abstraction registered back\n * from this side, which is an indirection that bought nothing.\n */\nexport const AdminAssistantFeature = createFeature({\n    name: \"AiPowerUps/AdminAssistant\",\n    register(container) {\n        // Register-time gate on the effective flags (project config && live WCP license), matching\n        // how every other AI feature gates itself. Nothing is registered when it is off, so an\n        // unlicensed project has no `/stream/ai/admin-assistant` route and no settings row.\n        const enabled = container\n            .resolve(FeatureFlags)\n            .get()\n            .isEnabled(\"aiPowerups.adminAssistant\");\n\n        if (!enabled) {\n            return;\n        }\n\n        container.register(AdminAssistantCapability);\n        container.registerInstance(AdminAssistantConfig, { maxSteps: MAX_STEPS });\n        container.register(AdminAssistantUseCase);\n\n        /*\n         * Only the definition is registered: the router matches on it and builds the handler it\n         * names once a request actually hits the path.\n         */\n        container.register(AdminAssistantStreamRouteDefinition);\n    }\n});\n"],"names":["MAX_STEPS","AdminAssistantFeature","createFeature","container","enabled","FeatureFlags","AdminAssistantCapability","AdminAssistantConfig","AdminAssistantUseCase","AdminAssistantStreamRouteDefinition"],"mappings":";;;;;;AAiBA,MAAMA,YAAY;AAUX,MAAMC,wBAAwBC,cAAc;IAC/C,MAAM;IACN,UAASC,SAAS;QAId,MAAMC,UAAUD,UACX,OAAO,CAACE,cACR,GAAG,GACH,SAAS,CAAC;QAEf,IAAI,CAACD,SACD;QAGJD,UAAU,QAAQ,CAACG;QACnBH,UAAU,gBAAgB,CAACI,sBAAsB;YAAE,UAAUP;QAAU;QACvEG,UAAU,QAAQ,CAACK;QAMnBL,UAAU,QAAQ,CAACM;IACvB;AACJ"}

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

@@ -0,0 +1,5 @@
+export { AdminAssistantUseCase, AdminAssistantConfig } from "./abstractions.js";
+export type { AdminAssistantParams } from "./abstractions.js";
+export type { AdminAssistantEvent } from "./events.js";
+export { AdminAssistantCapability, ADMIN_ASSISTANT_CAPABILITY } from "./capability.js";
+export { AdminAssistantFeature } from "./feature.js";

package/api/features/AdminAssistant/index.js

@@ -0,0 +1,3 @@
+export { AdminAssistantConfig, AdminAssistantUseCase } from "./abstractions.js";
+export { ADMIN_ASSISTANT_CAPABILITY, AdminAssistantCapability } from "./capability.js";
+export { AdminAssistantFeature } from "./feature.js";

package/api/features/AdminAssistant/parseChatBody.d.ts

@@ -0,0 +1,14 @@
+import type { ModelMessage } from "ai";
+import type { ApprovalDecision } from "./approvals.js";
+export interface ParsedChatBody {
+    messages: ModelMessage[];
+    decisions: ApprovalDecision[];
+}
+/**
+ * Accepts either a fresh question or a continuation. A continuation replays `messages` verbatim,
+ * including the assistant message carrying the approval request, because the SDK matches an approval
+ * response to its request by id and that request exists nowhere else. We keep no session.
+ *
+ * Returns null for anything unusable, so the caller decides the status code.
+ */
+export declare const parseChatBody: (body: unknown) => ParsedChatBody | null;

package/api/features/AdminAssistant/parseChatBody.js

@@ -0,0 +1,33 @@
+import { parseDecisions } from "./approvals.js";
+const safeParse = (value)=>{
+    try {
+        return JSON.parse(value);
+    } catch  {
+        return;
+    }
+};
+const parseChatBody = (body)=>{
+    const raw = "string" == typeof body ? safeParse(body) : body;
+    const payload = raw;
+    if (!payload) return null;
+    const decisions = parseDecisions(payload["approvals"]);
+    const prompt = payload["prompt"];
+    if ("string" == typeof prompt && prompt.trim()) return {
+        messages: [
+            {
+                role: "user",
+                content: prompt
+            }
+        ],
+        decisions
+    };
+    const messages = payload["messages"];
+    if (!Array.isArray(messages) || 0 === messages.length) return null;
+    return {
+        messages: messages,
+        decisions
+    };
+};
+export { parseChatBody };
+
+//# sourceMappingURL=parseChatBody.js.map

package/api/features/AdminAssistant/parseChatBody.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/AdminAssistant/parseChatBody.js","sources":["../../../../src/api/features/AdminAssistant/parseChatBody.ts"],"sourcesContent":["import type { ModelMessage } from \"ai\";\nimport { parseDecisions } from \"./approvals.js\";\nimport type { ApprovalDecision } from \"./approvals.js\";\n\nexport interface ParsedChatBody {\n    messages: ModelMessage[];\n    decisions: ApprovalDecision[];\n}\n\nconst safeParse = (value: string): unknown => {\n    try {\n        return JSON.parse(value);\n    } catch {\n        return undefined;\n    }\n};\n\n/**\n * Accepts either a fresh question or a continuation. A continuation replays `messages` verbatim,\n * including the assistant message carrying the approval request, because the SDK matches an approval\n * response to its request by id and that request exists nowhere else. We keep no session.\n *\n * Returns null for anything unusable, so the caller decides the status code.\n */\nexport const parseChatBody = (body: unknown): ParsedChatBody | null => {\n    const raw = typeof body === \"string\" ? safeParse(body) : body;\n    const payload = raw as Record<string, unknown> | undefined;\n\n    if (!payload) {\n        return null;\n    }\n\n    const decisions = parseDecisions(payload[\"approvals\"]);\n    const prompt = payload[\"prompt\"];\n\n    if (typeof prompt === \"string\" && prompt.trim()) {\n        return { messages: [{ role: \"user\", content: prompt }], decisions };\n    }\n\n    const messages = payload[\"messages\"];\n\n    if (!Array.isArray(messages) || messages.length === 0) {\n        return null;\n    }\n\n    return { messages: messages as ModelMessage[], decisions };\n};\n"],"names":["safeParse","value","JSON","parseChatBody","body","raw","payload","decisions","parseDecisions","prompt","messages","Array"],"mappings":";AASA,MAAMA,YAAY,CAACC;IACf,IAAI;QACA,OAAOC,KAAK,KAAK,CAACD;IACtB,EAAE,OAAM;QACJ;IACJ;AACJ;AASO,MAAME,gBAAgB,CAACC;IAC1B,MAAMC,MAAM,AAAgB,YAAhB,OAAOD,OAAoBJ,UAAUI,QAAQA;IACzD,MAAME,UAAUD;IAEhB,IAAI,CAACC,SACD,OAAO;IAGX,MAAMC,YAAYC,eAAeF,OAAO,CAAC,YAAY;IACrD,MAAMG,SAASH,OAAO,CAAC,SAAS;IAEhC,IAAI,AAAkB,YAAlB,OAAOG,UAAuBA,OAAO,IAAI,IACzC,OAAO;QAAE,UAAU;YAAC;gBAAE,MAAM;gBAAQ,SAASA;YAAO;SAAE;QAAEF;IAAU;IAGtE,MAAMG,WAAWJ,OAAO,CAAC,WAAW;IAEpC,IAAI,CAACK,MAAM,OAAO,CAACD,aAAaA,AAAoB,MAApBA,SAAS,MAAM,EAC3C,OAAO;IAGX,OAAO;QAAE,UAAUA;QAA4BH;IAAU;AAC7D"}

package/api/features/AdminAssistant/systemPrompt.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The assistant is deliberately told to DISCOVER rather than guess. Model IDs and field IDs are
+ * project-specific — there is no way to know them from training data — so every concrete answer has to
+ * come from a tool call. Without this instruction models happily invent a plausible `modelId` and then
+ * report the resulting error as if the content did not exist.
+ */
+export declare const SYSTEM_PROMPT = "You are the Webiny admin assistant. You help editors and developers find, understand and change the content in their Webiny project.\n\nYou have tools available. Use them \u2014 never answer a question about this project's content, models, or files from memory or assumption.\n\nHow to work:\n- Content model IDs and field IDs are specific to this project. Always discover them with listContentModels, then describeContentModel, before querying.\n- Build filters with the field IDs describeContentModel returned. Do not guess field names.\n- If a tool returns an error, read it and correct your call. A \"not allowed\" error means the user lacks permission \u2014 say so plainly rather than retrying.\n- If a query returns nothing, say so. Do not present an empty result as if it were data.\n\nChanging things:\n- Tools that change something are not executed until the user approves them. Propose the change by calling the tool; the user sees exactly what you asked for and confirms it.\n- Read first, then propose. Look up the ids you need (teams, folders, entries) rather than guessing them, because the user is approving the arguments you supply.\n- Propose one coherent change at a time. Do not bundle unrelated edits into a single step.\n- If an approval is denied, do not retry the same call. Acknowledge it and stop.\n\nHow to answer:\n- Be brief. These answers appear in a command palette, not a chat window.\n- Lead with the answer. No preamble, no restating the question.\n- When you list entries, give the few fields that matter, not every field you received.\n- State counts precisely (\"3 products are on sale\"), never vaguely.";

package/api/features/AdminAssistant/systemPrompt.js

@@ -0,0 +1,24 @@
+const SYSTEM_PROMPT = `You are the Webiny admin assistant. You help editors and developers find, understand and change the content in their Webiny project.
+
+You have tools available. Use them — never answer a question about this project's content, models, or files from memory or assumption.
+
+How to work:
+- Content model IDs and field IDs are specific to this project. Always discover them with listContentModels, then describeContentModel, before querying.
+- Build filters with the field IDs describeContentModel returned. Do not guess field names.
+- If a tool returns an error, read it and correct your call. A "not allowed" error means the user lacks permission — say so plainly rather than retrying.
+- If a query returns nothing, say so. Do not present an empty result as if it were data.
+
+Changing things:
+- Tools that change something are not executed until the user approves them. Propose the change by calling the tool; the user sees exactly what you asked for and confirms it.
+- Read first, then propose. Look up the ids you need (teams, folders, entries) rather than guessing them, because the user is approving the arguments you supply.
+- Propose one coherent change at a time. Do not bundle unrelated edits into a single step.
+- If an approval is denied, do not retry the same call. Acknowledge it and stop.
+
+How to answer:
+- Be brief. These answers appear in a command palette, not a chat window.
+- Lead with the answer. No preamble, no restating the question.
+- When you list entries, give the few fields that matter, not every field you received.
+- State counts precisely ("3 products are on sale"), never vaguely.`;
+export { SYSTEM_PROMPT };
+
+//# sourceMappingURL=systemPrompt.js.map

package/api/features/AdminAssistant/systemPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/AdminAssistant/systemPrompt.js","sources":["../../../../src/api/features/AdminAssistant/systemPrompt.ts"],"sourcesContent":["/**\n * The assistant is deliberately told to DISCOVER rather than guess. Model IDs and field IDs are\n * project-specific — there is no way to know them from training data — so every concrete answer has to\n * come from a tool call. Without this instruction models happily invent a plausible `modelId` and then\n * report the resulting error as if the content did not exist.\n */\nexport const SYSTEM_PROMPT = `You are the Webiny admin assistant. You help editors and developers find, understand and change the content in their Webiny project.\n\nYou have tools available. Use them — never answer a question about this project's content, models, or files from memory or assumption.\n\nHow to work:\n- Content model IDs and field IDs are specific to this project. Always discover them with listContentModels, then describeContentModel, before querying.\n- Build filters with the field IDs describeContentModel returned. Do not guess field names.\n- If a tool returns an error, read it and correct your call. A \"not allowed\" error means the user lacks permission — say so plainly rather than retrying.\n- If a query returns nothing, say so. Do not present an empty result as if it were data.\n\nChanging things:\n- Tools that change something are not executed until the user approves them. Propose the change by calling the tool; the user sees exactly what you asked for and confirms it.\n- Read first, then propose. Look up the ids you need (teams, folders, entries) rather than guessing them, because the user is approving the arguments you supply.\n- Propose one coherent change at a time. Do not bundle unrelated edits into a single step.\n- If an approval is denied, do not retry the same call. Acknowledge it and stop.\n\nHow to answer:\n- Be brief. These answers appear in a command palette, not a chat window.\n- Lead with the answer. No preamble, no restating the question.\n- When you list entries, give the few fields that matter, not every field you received.\n- State counts precisely (\"3 products are on sale\"), never vaguely.`;\n"],"names":["SYSTEM_PROMPT"],"mappings":"AAMO,MAAMA,gBAAgB,CAAC;;;;;;;;;;;;;;;;;;;;mEAoBqC,CAAC"}

package/api/features/AiImageEnrichment/PrepareImageEnrichmentUseCase.d.ts

@@ -1,16 +1,14 @@
 import { Result } from "@webiny/feature/api";
-import { Encryption } from "@webiny/api-core/features/encryption/index.js";
 import { GetFileUseCase } from "@webiny/api-file-manager/features/file/GetFile/index.js";
 import { GetFileContentsByIdUseCase } from "@webiny/api-file-manager/features/file/GetFileContentsById/abstractions.js";
 import { PrepareImageEnrichmentUseCase as UseCaseAbstraction, type IPreparedImageEnrichment } from "./abstractions.js";
-import { GetSettingsUseCase } from "../../../api/features/GetSettings/index.js";
+import { ResolveAiCapabilityUseCase } from "../../../api/features/Capabilities/index.js";
 import type { ImageEnrichmentError } from "./errors.js";
 declare class PrepareImageEnrichmentUseCaseImpl implements UseCaseAbstraction.Interface {
     private getFile;
     private getFileContents;
-    private getSettings;
-    private encryption;
-    constructor(getFile: GetFileUseCase.Interface, getFileContents: GetFileContentsByIdUseCase.Interface, getSettings: GetSettingsUseCase.Interface, encryption: Encryption.Interface);
+    private resolveCapability;
+    constructor(getFile: GetFileUseCase.Interface, getFileContents: GetFileContentsByIdUseCase.Interface, resolveCapability: ResolveAiCapabilityUseCase.Interface);
     execute(fileId: string): Promise<Result<IPreparedImageEnrichment, ImageEnrichmentError>>;
 }
 export declare const PrepareImageEnrichmentUseCase: typeof PrepareImageEnrichmentUseCaseImpl & {

package/api/features/AiImageEnrichment/PrepareImageEnrichmentUseCase.js

@@ -1,16 +1,15 @@
 import { Result } from "@webiny/feature/api";
-import { Encryption } from "@webiny/api-core/features/encryption/index.js";
 import { GetFileUseCase } from "@webiny/api-file-manager/features/file/GetFile/index.js";
 import { GetFileContentsByIdUseCase } from "@webiny/api-file-manager/features/file/GetFileContentsById/abstractions.js";
 import { PrepareImageEnrichmentUseCase } from "./abstractions.js";
-import { GetSettingsUseCase } from "../GetSettings/index.js";
+import { ResolveAiCapabilityUseCase, withAdditionalInstructions } from "../Capabilities/index.js";
+import { FM_IMAGE_ENRICHMENT_CAPABILITY } from "./capability.js";
 import { EnrichmentFileContentsError, EnrichmentFileNotFoundError, EnrichmentNoProviderError, EnrichmentNotAnImageError } from "./errors.js";
 class PrepareImageEnrichmentUseCaseImpl {
-    constructor(getFile, getFileContents, getSettings, encryption){
+    constructor(getFile, getFileContents, resolveCapability){
         this.getFile = getFile;
         this.getFileContents = getFileContents;
-        this.getSettings = getSettings;
-        this.encryption = encryption;
+        this.resolveCapability = resolveCapability;
     }
     async execute(fileId) {
         const fileResult = await this.getFile.execute(fileId);
@@ -19,19 +18,16 @@ class PrepareImageEnrichmentUseCaseImpl {
         if (!file.type.startsWith("image/")) return Result.fail(new EnrichmentNotAnImageError(file.type));
         const contentsResult = await this.getFileContents.execute(fileId);
         if (contentsResult.isFail()) return Result.fail(new EnrichmentFileContentsError(contentsResult.error.message));
-        const aiSettingsResult = await this.getSettings.execute();
-        if (aiSettingsResult.isFail()) return Result.fail(new EnrichmentNoProviderError());
-        const firstProvider = aiSettingsResult.value.providers.presets[0];
-        if (!firstProvider) return Result.fail(new EnrichmentNoProviderError());
+        const resolved = await this.resolveCapability.execute(FM_IMAGE_ENRICHMENT_CAPABILITY);
+        if (resolved.isFail()) return Result.fail(new EnrichmentNoProviderError(resolved.error.message));
+        const capability = resolved.value;
         return Result.ok({
             fileId: file.id,
             imageBase64: contentsResult.value.buffer.toString("base64"),
             imageMediaType: contentsResult.value.contentType,
-            model: firstProvider.model,
-            connection: {
-                sdkName: firstProvider.model.split("/")[0],
-                apiKey: await this.encryption.decrypt(firstProvider.apiKeyEncrypted)
-            }
+            model: capability.model,
+            prompt: withAdditionalInstructions(capability),
+            connection: capability.connection
         });
     }
 }
@@ -40,8 +36,7 @@ const PrepareImageEnrichmentUseCase_PrepareImageEnrichmentUseCase = PrepareImage
     dependencies: [
         GetFileUseCase,
         GetFileContentsByIdUseCase,
-        GetSettingsUseCase,
-        Encryption
+        ResolveAiCapabilityUseCase
     ]
 });
 export { PrepareImageEnrichmentUseCase_PrepareImageEnrichmentUseCase as PrepareImageEnrichmentUseCase };

package/api/features/AiImageEnrichment/PrepareImageEnrichmentUseCase.js.map

@@ -1 +1 @@
-{"version":3,"file":"api/features/AiImageEnrichment/PrepareImageEnrichmentUseCase.js","sources":["../../../../src/api/features/AiImageEnrichment/PrepareImageEnrichmentUseCase.ts"],"sourcesContent":["import { Result } from \"@webiny/feature/api\";\nimport { Encryption } from \"@webiny/api-core/features/encryption/index.js\";\nimport { GetFileUseCase } from \"@webiny/api-file-manager/features/file/GetFile/index.js\";\nimport { GetFileContentsByIdUseCase } from \"@webiny/api-file-manager/features/file/GetFileContentsById/abstractions.js\";\nimport {\n    PrepareImageEnrichmentUseCase as UseCaseAbstraction,\n    type IPreparedImageEnrichment\n} from \"./abstractions.js\";\nimport { GetSettingsUseCase } from \"~/api/features/GetSettings/index.js\";\nimport {\n    EnrichmentFileContentsError,\n    EnrichmentFileNotFoundError,\n    EnrichmentNoProviderError,\n    EnrichmentNotAnImageError\n} from \"./errors.js\";\nimport type { ImageEnrichmentError } from \"./errors.js\";\n\nclass PrepareImageEnrichmentUseCaseImpl implements UseCaseAbstraction.Interface {\n    constructor(\n        private getFile: GetFileUseCase.Interface,\n        private getFileContents: GetFileContentsByIdUseCase.Interface,\n        private getSettings: GetSettingsUseCase.Interface,\n        private encryption: Encryption.Interface\n    ) {}\n\n    async execute(fileId: string): Promise<Result<IPreparedImageEnrichment, ImageEnrichmentError>> {\n        const fileResult = await this.getFile.execute(fileId);\n        if (fileResult.isFail()) {\n            return Result.fail(new EnrichmentFileNotFoundError(fileId));\n        }\n\n        const file = fileResult.value;\n\n        if (!file.type.startsWith(\"image/\")) {\n            return Result.fail(new EnrichmentNotAnImageError(file.type));\n        }\n\n        // Read the image bytes and send them to the AI as base64, NOT a URL. A URL forces the\n        // provider to fetch the file — which fails for private/access-controlled files, leaks the\n        // domain, and can't reach a non-public origin (e.g. local dev). base64 is a portable standard\n        // that works on every setup. (Also resolves the AI-SDK \"image part\" deprecation.)\n        const contentsResult = await this.getFileContents.execute(fileId);\n        if (contentsResult.isFail()) {\n            return Result.fail(new EnrichmentFileContentsError(contentsResult.error.message));\n        }\n\n        const aiSettingsResult = await this.getSettings.execute();\n        if (aiSettingsResult.isFail()) {\n            return Result.fail(new EnrichmentNoProviderError());\n        }\n\n        const firstProvider = aiSettingsResult.value.providers.presets[0];\n        if (!firstProvider) {\n            return Result.fail(new EnrichmentNoProviderError());\n        }\n\n        return Result.ok({\n            fileId: file.id,\n            imageBase64: contentsResult.value.buffer.toString(\"base64\"),\n            imageMediaType: contentsResult.value.contentType,\n            model: firstProvider.model,\n            connection: {\n                sdkName: firstProvider.model.split(\"/\")[0],\n                apiKey: await this.encryption.decrypt(firstProvider.apiKeyEncrypted)\n            }\n        });\n    }\n}\n\nexport const PrepareImageEnrichmentUseCase = UseCaseAbstraction.createImplementation({\n    implementation: PrepareImageEnrichmentUseCaseImpl,\n    dependencies: [GetFileUseCase, GetFileContentsByIdUseCase, GetSettingsUseCase, Encryption]\n});\n"],"names":["PrepareImageEnrichmentUseCaseImpl","getFile","getFileContents","getSettings","encryption","fileId","fileResult","Result","EnrichmentFileNotFoundError","file","EnrichmentNotAnImageError","contentsResult","EnrichmentFileContentsError","aiSettingsResult","EnrichmentNoProviderError","firstProvider","PrepareImageEnrichmentUseCase","UseCaseAbstraction","GetFileUseCase","GetFileContentsByIdUseCase","GetSettingsUseCase","Encryption"],"mappings":";;;;;;;AAiBA,MAAMA;IACF,YACYC,OAAiC,EACjCC,eAAqD,EACrDC,WAAyC,EACzCC,UAAgC,CAC1C;aAJUH,OAAO,GAAPA;aACAC,eAAe,GAAfA;aACAC,WAAW,GAAXA;aACAC,UAAU,GAAVA;IACT;IAEH,MAAM,QAAQC,MAAc,EAAmE;QAC3F,MAAMC,aAAa,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAACD;QAC9C,IAAIC,WAAW,MAAM,IACjB,OAAOC,OAAO,IAAI,CAAC,IAAIC,4BAA4BH;QAGvD,MAAMI,OAAOH,WAAW,KAAK;QAE7B,IAAI,CAACG,KAAK,IAAI,CAAC,UAAU,CAAC,WACtB,OAAOF,OAAO,IAAI,CAAC,IAAIG,0BAA0BD,KAAK,IAAI;QAO9D,MAAME,iBAAiB,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAACN;QAC1D,IAAIM,eAAe,MAAM,IACrB,OAAOJ,OAAO,IAAI,CAAC,IAAIK,4BAA4BD,eAAe,KAAK,CAAC,OAAO;QAGnF,MAAME,mBAAmB,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO;QACvD,IAAIA,iBAAiB,MAAM,IACvB,OAAON,OAAO,IAAI,CAAC,IAAIO;QAG3B,MAAMC,gBAAgBF,iBAAiB,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE;QACjE,IAAI,CAACE,eACD,OAAOR,OAAO,IAAI,CAAC,IAAIO;QAG3B,OAAOP,OAAO,EAAE,CAAC;YACb,QAAQE,KAAK,EAAE;YACf,aAAaE,eAAe,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;YAClD,gBAAgBA,eAAe,KAAK,CAAC,WAAW;YAChD,OAAOI,cAAc,KAAK;YAC1B,YAAY;gBACR,SAASA,cAAc,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;gBAC1C,QAAQ,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAACA,cAAc,eAAe;YACvE;QACJ;IACJ;AACJ;AAEO,MAAMC,8DAAgCC,8BAAAA,oBAAuC,CAAC;IACjF,gBAAgBjB;IAChB,cAAc;QAACkB;QAAgBC;QAA4BC;QAAoBC;KAAW;AAC9F"}
+{"version":3,"file":"api/features/AiImageEnrichment/PrepareImageEnrichmentUseCase.js","sources":["../../../../src/api/features/AiImageEnrichment/PrepareImageEnrichmentUseCase.ts"],"sourcesContent":["import { Result } from \"@webiny/feature/api\";\nimport { GetFileUseCase } from \"@webiny/api-file-manager/features/file/GetFile/index.js\";\nimport { GetFileContentsByIdUseCase } from \"@webiny/api-file-manager/features/file/GetFileContentsById/abstractions.js\";\nimport {\n    PrepareImageEnrichmentUseCase as UseCaseAbstraction,\n    type IPreparedImageEnrichment\n} from \"./abstractions.js\";\nimport {\n    ResolveAiCapabilityUseCase,\n    withAdditionalInstructions\n} from \"~/api/features/Capabilities/index.js\";\nimport { FM_IMAGE_ENRICHMENT_CAPABILITY } from \"./capability.js\";\nimport {\n    EnrichmentFileContentsError,\n    EnrichmentFileNotFoundError,\n    EnrichmentNoProviderError,\n    EnrichmentNotAnImageError\n} from \"./errors.js\";\nimport type { ImageEnrichmentError } from \"./errors.js\";\n\nclass PrepareImageEnrichmentUseCaseImpl implements UseCaseAbstraction.Interface {\n    constructor(\n        private getFile: GetFileUseCase.Interface,\n        private getFileContents: GetFileContentsByIdUseCase.Interface,\n        private resolveCapability: ResolveAiCapabilityUseCase.Interface\n    ) {}\n\n    async execute(fileId: string): Promise<Result<IPreparedImageEnrichment, ImageEnrichmentError>> {\n        const fileResult = await this.getFile.execute(fileId);\n        if (fileResult.isFail()) {\n            return Result.fail(new EnrichmentFileNotFoundError(fileId));\n        }\n\n        const file = fileResult.value;\n\n        if (!file.type.startsWith(\"image/\")) {\n            return Result.fail(new EnrichmentNotAnImageError(file.type));\n        }\n\n        // Read the image bytes and send them to the AI as base64, NOT a URL. A URL forces the\n        // provider to fetch the file — which fails for private/access-controlled files, leaks the\n        // domain, and can't reach a non-public origin (e.g. local dev). base64 is a portable standard\n        // that works on every setup. (Also resolves the AI-SDK \"image part\" deprecation.)\n        const contentsResult = await this.getFileContents.execute(fileId);\n        if (contentsResult.isFail()) {\n            return Result.fail(new EnrichmentFileContentsError(contentsResult.error.message));\n        }\n\n        const resolved = await this.resolveCapability.execute(FM_IMAGE_ENRICHMENT_CAPABILITY);\n        if (resolved.isFail()) {\n            return Result.fail(new EnrichmentNoProviderError(resolved.error.message));\n        }\n\n        const capability = resolved.value;\n\n        return Result.ok({\n            fileId: file.id,\n            imageBase64: contentsResult.value.buffer.toString(\"base64\"),\n            imageMediaType: contentsResult.value.contentType,\n            model: capability.model,\n            prompt: withAdditionalInstructions(capability),\n            connection: capability.connection\n        });\n    }\n}\n\nexport const PrepareImageEnrichmentUseCase = UseCaseAbstraction.createImplementation({\n    implementation: PrepareImageEnrichmentUseCaseImpl,\n    dependencies: [GetFileUseCase, GetFileContentsByIdUseCase, ResolveAiCapabilityUseCase]\n});\n"],"names":["PrepareImageEnrichmentUseCaseImpl","getFile","getFileContents","resolveCapability","fileId","fileResult","Result","EnrichmentFileNotFoundError","file","EnrichmentNotAnImageError","contentsResult","EnrichmentFileContentsError","resolved","FM_IMAGE_ENRICHMENT_CAPABILITY","EnrichmentNoProviderError","capability","withAdditionalInstructions","PrepareImageEnrichmentUseCase","UseCaseAbstraction","GetFileUseCase","GetFileContentsByIdUseCase","ResolveAiCapabilityUseCase"],"mappings":";;;;;;;AAoBA,MAAMA;IACF,YACYC,OAAiC,EACjCC,eAAqD,EACrDC,iBAAuD,CACjE;aAHUF,OAAO,GAAPA;aACAC,eAAe,GAAfA;aACAC,iBAAiB,GAAjBA;IACT;IAEH,MAAM,QAAQC,MAAc,EAAmE;QAC3F,MAAMC,aAAa,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAACD;QAC9C,IAAIC,WAAW,MAAM,IACjB,OAAOC,OAAO,IAAI,CAAC,IAAIC,4BAA4BH;QAGvD,MAAMI,OAAOH,WAAW,KAAK;QAE7B,IAAI,CAACG,KAAK,IAAI,CAAC,UAAU,CAAC,WACtB,OAAOF,OAAO,IAAI,CAAC,IAAIG,0BAA0BD,KAAK,IAAI;QAO9D,MAAME,iBAAiB,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAACN;QAC1D,IAAIM,eAAe,MAAM,IACrB,OAAOJ,OAAO,IAAI,CAAC,IAAIK,4BAA4BD,eAAe,KAAK,CAAC,OAAO;QAGnF,MAAME,WAAW,MAAM,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAACC;QACtD,IAAID,SAAS,MAAM,IACf,OAAON,OAAO,IAAI,CAAC,IAAIQ,0BAA0BF,SAAS,KAAK,CAAC,OAAO;QAG3E,MAAMG,aAAaH,SAAS,KAAK;QAEjC,OAAON,OAAO,EAAE,CAAC;YACb,QAAQE,KAAK,EAAE;YACf,aAAaE,eAAe,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;YAClD,gBAAgBA,eAAe,KAAK,CAAC,WAAW;YAChD,OAAOK,WAAW,KAAK;YACvB,QAAQC,2BAA2BD;YACnC,YAAYA,WAAW,UAAU;QACrC;IACJ;AACJ;AAEO,MAAME,8DAAgCC,8BAAAA,oBAAuC,CAAC;IACjF,gBAAgBlB;IAChB,cAAc;QAACmB;QAAgBC;QAA4BC;KAA2B;AAC1F"}

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

@@ -29,6 +29,12 @@ export interface IPreparedImageEnrichment {
     imageBase64: string;
     imageMediaType: string;
     model: string;
+    /**
+     * The resolved prompt: this capability's guidance (or the project's replacement for it) with
+     * the project's additional instructions appended. `AI_ENRICHMENT_PROMPT` is the default that
+     * feeds it, not what gets sent.
+     */
+    prompt: string;
     connection: {
         sdkName: string;
         apiKey: string;

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

@@ -1 +1 @@
-{"version":3,"file":"api/features/AiImageEnrichment/abstractions.js","sources":["../../../../src/api/features/AiImageEnrichment/abstractions.ts"],"sourcesContent":["import { createAbstraction, Result } from \"@webiny/feature/api\";\nimport { z } from \"zod\";\nimport type { ImageEnrichmentError } from \"./errors.js\";\n\nexport const AI_ENRICHMENT_PROMPT =\n    \"Analyze this image and return up to 5 lowercase descriptive tags and one short sentence describing the image.\";\n\n/**\n * The shape both entry points ask the model for. Exported as the bare zod schema rather than a\n * ready-made `Output.object(...)`: the AI SDK's `Output` type can't be named in emitted declarations\n * (TS4023), so each call site wraps this locally instead.\n */\nexport const aiEnrichmentSchema = z.object({\n    tags: z.array(z.string()),\n    description: z.string()\n});\n\n/** The enrichment result: what the model produces and what gets persisted. */\nexport interface IEnrichmentOutput {\n    tags: string[];\n    description: string;\n}\n\n/**\n * Everything needed to run the AI call, gathered up front: the image bytes, the resolved provider,\n * and the file's current tags (needed to merge rather than overwrite).\n *\n * Deliberately split from the AI call itself so both entry points share the same preparation and the\n * same failure modes — and so the streaming route can answer with a real HTTP status code for\n * anything knowable before the stream opens, instead of burying it in a 200 response.\n */\nexport interface IPreparedImageEnrichment {\n    fileId: string;\n    imageBase64: string;\n    imageMediaType: string;\n    model: string;\n    connection: {\n        sdkName: string;\n        apiKey: string;\n    };\n}\n\nexport interface IPrepareImageEnrichmentUseCase {\n    execute(fileId: string): Promise<Result<IPreparedImageEnrichment, ImageEnrichmentError>>;\n}\n\nexport const PrepareImageEnrichmentUseCase = createAbstraction<IPrepareImageEnrichmentUseCase>(\n    \"PrepareImageEnrichmentUseCase\"\n);\n\nexport namespace PrepareImageEnrichmentUseCase {\n    export type Interface = IPrepareImageEnrichmentUseCase;\n}\n\nexport interface IApplyImageEnrichmentParams {\n    fileId: string;\n    tags: string[];\n    description: string;\n}\n\nexport interface IAppliedImageEnrichment {\n    fileId: string;\n    tags: string[];\n    description: string;\n}\n\nexport interface IApplyImageEnrichmentUseCase {\n    execute(\n        params: IApplyImageEnrichmentParams\n    ): Promise<Result<IAppliedImageEnrichment, ImageEnrichmentError>>;\n}\n\nexport const ApplyImageEnrichmentUseCase = createAbstraction<IApplyImageEnrichmentUseCase>(\n    \"ApplyImageEnrichmentUseCase\"\n);\n\nexport namespace ApplyImageEnrichmentUseCase {\n    export type Interface = IApplyImageEnrichmentUseCase;\n}\n"],"names":["AI_ENRICHMENT_PROMPT","aiEnrichmentSchema","z","PrepareImageEnrichmentUseCase","createAbstraction","ApplyImageEnrichmentUseCase"],"mappings":";;AAIO,MAAMA,uBACT;AAOG,MAAMC,qBAAqBC,EAAE,MAAM,CAAC;IACvC,MAAMA,EAAE,KAAK,CAACA,EAAE,MAAM;IACtB,aAAaA,EAAE,MAAM;AACzB;AA+BO,MAAMC,gCAAgCC,kBACzC;AAyBG,MAAMC,8BAA8BD,kBACvC"}
+{"version":3,"file":"api/features/AiImageEnrichment/abstractions.js","sources":["../../../../src/api/features/AiImageEnrichment/abstractions.ts"],"sourcesContent":["import { createAbstraction, Result } from \"@webiny/feature/api\";\nimport { z } from \"zod\";\nimport type { ImageEnrichmentError } from \"./errors.js\";\n\nexport const AI_ENRICHMENT_PROMPT =\n    \"Analyze this image and return up to 5 lowercase descriptive tags and one short sentence describing the image.\";\n\n/**\n * The shape both entry points ask the model for. Exported as the bare zod schema rather than a\n * ready-made `Output.object(...)`: the AI SDK's `Output` type can't be named in emitted declarations\n * (TS4023), so each call site wraps this locally instead.\n */\nexport const aiEnrichmentSchema = z.object({\n    tags: z.array(z.string()),\n    description: z.string()\n});\n\n/** The enrichment result: what the model produces and what gets persisted. */\nexport interface IEnrichmentOutput {\n    tags: string[];\n    description: string;\n}\n\n/**\n * Everything needed to run the AI call, gathered up front: the image bytes, the resolved provider,\n * and the file's current tags (needed to merge rather than overwrite).\n *\n * Deliberately split from the AI call itself so both entry points share the same preparation and the\n * same failure modes — and so the streaming route can answer with a real HTTP status code for\n * anything knowable before the stream opens, instead of burying it in a 200 response.\n */\nexport interface IPreparedImageEnrichment {\n    fileId: string;\n    imageBase64: string;\n    imageMediaType: string;\n    model: string;\n    /**\n     * The resolved prompt: this capability's guidance (or the project's replacement for it) with\n     * the project's additional instructions appended. `AI_ENRICHMENT_PROMPT` is the default that\n     * feeds it, not what gets sent.\n     */\n    prompt: string;\n    connection: {\n        sdkName: string;\n        apiKey: string;\n    };\n}\n\nexport interface IPrepareImageEnrichmentUseCase {\n    execute(fileId: string): Promise<Result<IPreparedImageEnrichment, ImageEnrichmentError>>;\n}\n\nexport const PrepareImageEnrichmentUseCase = createAbstraction<IPrepareImageEnrichmentUseCase>(\n    \"PrepareImageEnrichmentUseCase\"\n);\n\nexport namespace PrepareImageEnrichmentUseCase {\n    export type Interface = IPrepareImageEnrichmentUseCase;\n}\n\nexport interface IApplyImageEnrichmentParams {\n    fileId: string;\n    tags: string[];\n    description: string;\n}\n\nexport interface IAppliedImageEnrichment {\n    fileId: string;\n    tags: string[];\n    description: string;\n}\n\nexport interface IApplyImageEnrichmentUseCase {\n    execute(\n        params: IApplyImageEnrichmentParams\n    ): Promise<Result<IAppliedImageEnrichment, ImageEnrichmentError>>;\n}\n\nexport const ApplyImageEnrichmentUseCase = createAbstraction<IApplyImageEnrichmentUseCase>(\n    \"ApplyImageEnrichmentUseCase\"\n);\n\nexport namespace ApplyImageEnrichmentUseCase {\n    export type Interface = IApplyImageEnrichmentUseCase;\n}\n"],"names":["AI_ENRICHMENT_PROMPT","aiEnrichmentSchema","z","PrepareImageEnrichmentUseCase","createAbstraction","ApplyImageEnrichmentUseCase"],"mappings":";;AAIO,MAAMA,uBACT;AAOG,MAAMC,qBAAqBC,EAAE,MAAM,CAAC;IACvC,MAAMA,EAAE,KAAK,CAACA,EAAE,MAAM;IACtB,aAAaA,EAAE,MAAM;AACzB;AAqCO,MAAMC,gCAAgCC,kBACzC;AAyBG,MAAMC,8BAA8BD,kBACvC"}

package/api/features/AiImageEnrichment/buildEnrichmentAiRequest.js

@@ -1,5 +1,5 @@
 import { Output } from "ai";
-import { AI_ENRICHMENT_PROMPT, aiEnrichmentSchema } from "./abstractions.js";
+import { aiEnrichmentSchema } from "./abstractions.js";
 function buildEnrichmentAiRequest(prepared) {
     return {
         model: prepared.model,
@@ -18,7 +18,7 @@ function buildEnrichmentAiRequest(prepared) {
                     },
                     {
                         type: "text",
-                        text: AI_ENRICHMENT_PROMPT
+                        text: prepared.prompt
                     }
                 ]
             }

package/api/features/AiImageEnrichment/buildEnrichmentAiRequest.js.map

@@ -1 +1 @@
-{"version":3,"file":"api/features/AiImageEnrichment/buildEnrichmentAiRequest.js","sources":["../../../../src/api/features/AiImageEnrichment/buildEnrichmentAiRequest.ts"],"sourcesContent":["import { Output } from \"ai\";\nimport type { Ai } from \"@webiny/api-core/features/ai/index.js\";\nimport { AI_ENRICHMENT_PROMPT, aiEnrichmentSchema } from \"./abstractions.js\";\nimport type { IPreparedImageEnrichment } from \"./abstractions.js\";\n\n/**\n * Builds the AI request both enrichment entry points send — the background task via `generateText`\n * and the streaming route via `streamText`. Identical model, structured output, connection, and\n * message payload; only the call differs.\n *\n * This is also where `Output.object(...)` lives rather than on `IPreparedImageEnrichment`: the AI\n * SDK's `Output` type can't be named in emitted declarations (TS4023), so it has to be built inside a\n * function body, not held on an exported interface.\n */\nexport function buildEnrichmentAiRequest(\n    prepared: IPreparedImageEnrichment\n): Ai.GenerateTextParams {\n    return {\n        model: prepared.model,\n        output: Output.object({ schema: aiEnrichmentSchema }),\n        connection: prepared.connection,\n        messages: [\n            {\n                role: \"user\",\n                content: [\n                    {\n                        // Sent as base64, not a URL: a URL forces the provider to fetch the file,\n                        // which fails for private files and can't reach a non-public origin.\n                        type: \"file\",\n                        data: prepared.imageBase64,\n                        mediaType: prepared.imageMediaType\n                    },\n                    {\n                        type: \"text\",\n                        text: AI_ENRICHMENT_PROMPT\n                    }\n                ]\n            }\n        ]\n    };\n}\n"],"names":["buildEnrichmentAiRequest","prepared","Output","aiEnrichmentSchema","AI_ENRICHMENT_PROMPT"],"mappings":";;AAcO,SAASA,yBACZC,QAAkC;IAElC,OAAO;QACH,OAAOA,SAAS,KAAK;QACrB,QAAQC,OAAO,MAAM,CAAC;YAAE,QAAQC;QAAmB;QACnD,YAAYF,SAAS,UAAU;QAC/B,UAAU;YACN;gBACI,MAAM;gBACN,SAAS;oBACL;wBAGI,MAAM;wBACN,MAAMA,SAAS,WAAW;wBAC1B,WAAWA,SAAS,cAAc;oBACtC;oBACA;wBACI,MAAM;wBACN,MAAMG;oBACV;iBACH;YACL;SACH;IACL;AACJ"}
+{"version":3,"file":"api/features/AiImageEnrichment/buildEnrichmentAiRequest.js","sources":["../../../../src/api/features/AiImageEnrichment/buildEnrichmentAiRequest.ts"],"sourcesContent":["import { Output } from \"ai\";\nimport type { Ai } from \"@webiny/api-core/features/ai/index.js\";\nimport { aiEnrichmentSchema } from \"./abstractions.js\";\nimport type { IPreparedImageEnrichment } from \"./abstractions.js\";\n\n/**\n * Builds the AI request both enrichment entry points send — the background task via `generateText`\n * and the streaming route via `streamText`. Identical model, structured output, connection, and\n * message payload; only the call differs.\n *\n * This is also where `Output.object(...)` lives rather than on `IPreparedImageEnrichment`: the AI\n * SDK's `Output` type can't be named in emitted declarations (TS4023), so it has to be built inside a\n * function body, not held on an exported interface.\n */\nexport function buildEnrichmentAiRequest(\n    prepared: IPreparedImageEnrichment\n): Ai.GenerateTextParams {\n    return {\n        model: prepared.model,\n        output: Output.object({ schema: aiEnrichmentSchema }),\n        connection: prepared.connection,\n        messages: [\n            {\n                role: \"user\",\n                content: [\n                    {\n                        // Sent as base64, not a URL: a URL forces the provider to fetch the file,\n                        // which fails for private files and can't reach a non-public origin.\n                        type: \"file\",\n                        data: prepared.imageBase64,\n                        mediaType: prepared.imageMediaType\n                    },\n                    {\n                        type: \"text\",\n                        text: prepared.prompt\n                    }\n                ]\n            }\n        ]\n    };\n}\n"],"names":["buildEnrichmentAiRequest","prepared","Output","aiEnrichmentSchema"],"mappings":";;AAcO,SAASA,yBACZC,QAAkC;IAElC,OAAO;QACH,OAAOA,SAAS,KAAK;QACrB,QAAQC,OAAO,MAAM,CAAC;YAAE,QAAQC;QAAmB;QACnD,YAAYF,SAAS,UAAU;QAC/B,UAAU;YACN;gBACI,MAAM;gBACN,SAAS;oBACL;wBAGI,MAAM;wBACN,MAAMA,SAAS,WAAW;wBAC1B,WAAWA,SAAS,cAAc;oBACtC;oBACA;wBACI,MAAM;wBACN,MAAMA,SAAS,MAAM;oBACzB;iBACH;YACL;SACH;IACL;AACJ"}

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

@@ -0,0 +1,18 @@
+import { AiCapability } from "../../../api/features/Capabilities/index.js";
+export declare const FM_IMAGE_ENRICHMENT_CAPABILITY = "fm.imageEnrichment";
+declare class FmImageEnrichmentCapabilityImpl implements AiCapability.Interface {
+    readonly id = "fm.imageEnrichment";
+    readonly label = "Image enrichment";
+    readonly description = "Reads an uploaded image and writes its alt text, title and tags. Needs a model that accepts image input.";
+    readonly defaultRole: "vision";
+    /**
+     * The one prompt here whose structure does not come from the prose: `Output.object(...)` in
+     * `buildEnrichmentAiRequest` enforces the tags/description shape. Projects still adjust it by
+     * appending, which is where house tag vocabularies go ("use our taxonomy", "British spelling").
+     */
+    readonly guidance = "Analyze this image and return up to 5 lowercase descriptive tags and one short sentence describing the image.";
+}
+export declare const FmImageEnrichmentCapability: typeof FmImageEnrichmentCapabilityImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("~/api/features/Capabilities/index.js").IAiCapability>;
+};
+export {};

package/api/features/AiImageEnrichment/capability.js

@@ -0,0 +1,19 @@
+import { AiCapability } from "../Capabilities/index.js";
+import { AI_ENRICHMENT_PROMPT } from "./abstractions.js";
+const FM_IMAGE_ENRICHMENT_CAPABILITY = "fm.imageEnrichment";
+class FmImageEnrichmentCapabilityImpl {
+    constructor(){
+        this.id = FM_IMAGE_ENRICHMENT_CAPABILITY;
+        this.label = "Image enrichment";
+        this.description = "Reads an uploaded image and writes its alt text, title and tags. Needs a model that accepts image input.";
+        this.defaultRole = "vision";
+        this.guidance = AI_ENRICHMENT_PROMPT;
+    }
+}
+const FmImageEnrichmentCapability = AiCapability.createImplementation({
+    implementation: FmImageEnrichmentCapabilityImpl,
+    dependencies: []
+});
+export { FM_IMAGE_ENRICHMENT_CAPABILITY, FmImageEnrichmentCapability };
+
+//# sourceMappingURL=capability.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/AiImageEnrichment/capability.js","sources":["../../../../src/api/features/AiImageEnrichment/capability.ts"],"sourcesContent":["import { AiCapability } from \"~/api/features/Capabilities/index.js\";\nimport { AI_ENRICHMENT_PROMPT } from \"./abstractions.js\";\n\nexport const FM_IMAGE_ENRICHMENT_CAPABILITY = \"fm.imageEnrichment\";\n\nclass FmImageEnrichmentCapabilityImpl implements AiCapability.Interface {\n    readonly id = FM_IMAGE_ENRICHMENT_CAPABILITY;\n    readonly label = \"Image enrichment\";\n    readonly description =\n        \"Reads an uploaded image and writes its alt text, title and tags. Needs a model that accepts image input.\";\n    readonly defaultRole = \"vision\" as const;\n    /**\n     * The one prompt here whose structure does not come from the prose: `Output.object(...)` in\n     * `buildEnrichmentAiRequest` enforces the tags/description shape. Projects still adjust it by\n     * appending, which is where house tag vocabularies go (\"use our taxonomy\", \"British spelling\").\n     */\n    readonly guidance = AI_ENRICHMENT_PROMPT;\n}\n\nexport const FmImageEnrichmentCapability = AiCapability.createImplementation({\n    implementation: FmImageEnrichmentCapabilityImpl,\n    dependencies: []\n});\n"],"names":["FM_IMAGE_ENRICHMENT_CAPABILITY","FmImageEnrichmentCapabilityImpl","AI_ENRICHMENT_PROMPT","FmImageEnrichmentCapability","AiCapability"],"mappings":";;AAGO,MAAMA,iCAAiC;AAE9C,MAAMC;;aACO,EAAE,GAAGD;aACL,KAAK,GAAG;aACR,WAAW,GAChB;aACK,WAAW,GAAG;QAKtB,KACQ,QAAQ,GAAGE;;AACxB;AAEO,MAAMC,8BAA8BC,aAAa,oBAAoB,CAAC;IACzE,gBAAgBH;IAChB,cAAc,EAAE;AACpB"}

package/api/features/AiImageEnrichment/errors.d.ts

@@ -17,7 +17,12 @@ export declare class EnrichmentFileContentsError extends Error {
 }
 export declare class EnrichmentNoProviderError extends Error {
     readonly code: "ENRICHMENT_NO_AI_PROVIDER";
-    constructor();
+    /**
+     * The reason comes from capability resolution, which knows which of the several ways this can
+     * fail actually happened: no model in the Vision role, a deleted connection, a missing key.
+     * Passing it through beats replacing all of them with one generic sentence.
+     */
+    constructor(reason?: string);
 }
 export declare class EnrichmentPersistError extends Error {
     readonly code: "ENRICHMENT_PERSIST_FAILED";

package/api/features/AiImageEnrichment/errors.js

@@ -14,8 +14,8 @@ class EnrichmentFileContentsError extends Error {
     }
 }
 class EnrichmentNoProviderError extends Error {
-    constructor(){
-        super("No AI provider configured. Add a provider in AI Power Ups settings."), this.code = "ENRICHMENT_NO_AI_PROVIDER";
+    constructor(reason){
+        super(reason ?? "No AI model is configured for image enrichment. Pick one under Settings → AI Power-Ups → Model roles."), this.code = "ENRICHMENT_NO_AI_PROVIDER";
     }
 }
 class EnrichmentPersistError extends Error {

package/api/features/AiImageEnrichment/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"api/features/AiImageEnrichment/errors.js","sources":["../../../../src/api/features/AiImageEnrichment/errors.ts"],"sourcesContent":["/**\n * Errors shared by every image-enrichment entry point (the background task and the streaming HTTP\n * route). Each carries a `code` so callers can map it to their own transport: the task turns them\n * into task results, the route into HTTP status codes.\n */\nexport class EnrichmentFileNotFoundError extends Error {\n    readonly code = \"ENRICHMENT_FILE_NOT_FOUND\" as const;\n\n    constructor(fileId: string) {\n        super(`File not found: ${fileId}`);\n    }\n}\n\nexport class EnrichmentNotAnImageError extends Error {\n    readonly code = \"ENRICHMENT_NOT_AN_IMAGE\" as const;\n\n    constructor(type: string) {\n        super(`File is not an image (received \"${type}\"); skipping AI enrichment.`);\n    }\n}\n\nexport class EnrichmentFileContentsError extends Error {\n    readonly code = \"ENRICHMENT_FILE_CONTENTS_UNREADABLE\" as const;\n\n    constructor(reason: string) {\n        super(`Unable to read file contents: ${reason}`);\n    }\n}\n\nexport class EnrichmentNoProviderError extends Error {\n    readonly code = \"ENRICHMENT_NO_AI_PROVIDER\" as const;\n\n    constructor() {\n        super(\"No AI provider configured. Add a provider in AI Power Ups settings.\");\n    }\n}\n\nexport class EnrichmentPersistError extends Error {\n    readonly code = \"ENRICHMENT_PERSIST_FAILED\" as const;\n\n    constructor(reason: string) {\n        super(`Failed to update file: ${reason}`);\n    }\n}\n\nexport type ImageEnrichmentError =\n    | EnrichmentFileNotFoundError\n    | EnrichmentNotAnImageError\n    | EnrichmentFileContentsError\n    | EnrichmentNoProviderError\n    | EnrichmentPersistError;\n"],"names":["EnrichmentFileNotFoundError","Error","fileId","EnrichmentNotAnImageError","type","EnrichmentFileContentsError","reason","EnrichmentNoProviderError","EnrichmentPersistError"],"mappings":"AAKO,MAAMA,oCAAoCC;IAG7C,YAAYC,MAAc,CAAE;QACxB,KAAK,CAAC,CAAC,gBAAgB,EAAEA,QAAQ,QAH5B,IAAI,GAAG;IAIhB;AACJ;AAEO,MAAMC,kCAAkCF;IAG3C,YAAYG,IAAY,CAAE;QACtB,KAAK,CAAC,CAAC,gCAAgC,EAAEA,KAAK,2BAA2B,CAAC,QAHrE,IAAI,GAAG;IAIhB;AACJ;AAEO,MAAMC,oCAAoCJ;IAG7C,YAAYK,MAAc,CAAE;QACxB,KAAK,CAAC,CAAC,8BAA8B,EAAEA,QAAQ,QAH1C,IAAI,GAAG;IAIhB;AACJ;AAEO,MAAMC,kCAAkCN;IAG3C,aAAc;QACV,KAAK,CAAC,6EAHD,IAAI,GAAG;IAIhB;AACJ;AAEO,MAAMO,+BAA+BP;IAGxC,YAAYK,MAAc,CAAE;QACxB,KAAK,CAAC,CAAC,uBAAuB,EAAEA,QAAQ,QAHnC,IAAI,GAAG;IAIhB;AACJ"}
+{"version":3,"file":"api/features/AiImageEnrichment/errors.js","sources":["../../../../src/api/features/AiImageEnrichment/errors.ts"],"sourcesContent":["/**\n * Errors shared by every image-enrichment entry point (the background task and the streaming HTTP\n * route). Each carries a `code` so callers can map it to their own transport: the task turns them\n * into task results, the route into HTTP status codes.\n */\nexport class EnrichmentFileNotFoundError extends Error {\n    readonly code = \"ENRICHMENT_FILE_NOT_FOUND\" as const;\n\n    constructor(fileId: string) {\n        super(`File not found: ${fileId}`);\n    }\n}\n\nexport class EnrichmentNotAnImageError extends Error {\n    readonly code = \"ENRICHMENT_NOT_AN_IMAGE\" as const;\n\n    constructor(type: string) {\n        super(`File is not an image (received \"${type}\"); skipping AI enrichment.`);\n    }\n}\n\nexport class EnrichmentFileContentsError extends Error {\n    readonly code = \"ENRICHMENT_FILE_CONTENTS_UNREADABLE\" as const;\n\n    constructor(reason: string) {\n        super(`Unable to read file contents: ${reason}`);\n    }\n}\n\nexport class EnrichmentNoProviderError extends Error {\n    readonly code = \"ENRICHMENT_NO_AI_PROVIDER\" as const;\n\n    /**\n     * The reason comes from capability resolution, which knows which of the several ways this can\n     * fail actually happened: no model in the Vision role, a deleted connection, a missing key.\n     * Passing it through beats replacing all of them with one generic sentence.\n     */\n    constructor(reason?: string) {\n        super(\n            reason ??\n                \"No AI model is configured for image enrichment. Pick one under Settings → AI Power-Ups → Model roles.\"\n        );\n    }\n}\n\nexport class EnrichmentPersistError extends Error {\n    readonly code = \"ENRICHMENT_PERSIST_FAILED\" as const;\n\n    constructor(reason: string) {\n        super(`Failed to update file: ${reason}`);\n    }\n}\n\nexport type ImageEnrichmentError =\n    | EnrichmentFileNotFoundError\n    | EnrichmentNotAnImageError\n    | EnrichmentFileContentsError\n    | EnrichmentNoProviderError\n    | EnrichmentPersistError;\n"],"names":["EnrichmentFileNotFoundError","Error","fileId","EnrichmentNotAnImageError","type","EnrichmentFileContentsError","reason","EnrichmentNoProviderError","EnrichmentPersistError"],"mappings":"AAKO,MAAMA,oCAAoCC;IAG7C,YAAYC,MAAc,CAAE;QACxB,KAAK,CAAC,CAAC,gBAAgB,EAAEA,QAAQ,QAH5B,IAAI,GAAG;IAIhB;AACJ;AAEO,MAAMC,kCAAkCF;IAG3C,YAAYG,IAAY,CAAE;QACtB,KAAK,CAAC,CAAC,gCAAgC,EAAEA,KAAK,2BAA2B,CAAC,QAHrE,IAAI,GAAG;IAIhB;AACJ;AAEO,MAAMC,oCAAoCJ;IAG7C,YAAYK,MAAc,CAAE;QACxB,KAAK,CAAC,CAAC,8BAA8B,EAAEA,QAAQ,QAH1C,IAAI,GAAG;IAIhB;AACJ;AAEO,MAAMC,kCAAkCN;IAQ3C,YAAYK,MAAe,CAAE;QACzB,KAAK,CACDA,UACI,+GAVH,IAAI,GAAG;IAYhB;AACJ;AAEO,MAAME,+BAA+BP;IAGxC,YAAYK,MAAc,CAAE;QACxB,KAAK,CAAC,CAAC,uBAAuB,EAAEA,QAAQ,QAHnC,IAAI,GAAG;IAIhB;AACJ"}

package/api/features/AiImageEnrichment/feature.js

@@ -5,11 +5,13 @@ import { AiImageEnrichmentTask } from "./AiImageEnrichmentTask.js";
 import { AiImageEnrichmentStreamRouteDefinition } from "./AiImageEnrichmentStreamRoute.js";
 import { PrepareImageEnrichmentUseCase } from "./PrepareImageEnrichmentUseCase.js";
 import { ApplyImageEnrichmentUseCase } from "./ApplyImageEnrichmentUseCase.js";
+import { FmImageEnrichmentCapability } from "./capability.js";
 const AiImageEnrichmentFeature = createFeature({
     name: "AiPowerUps/AiImageEnrichment",
     register (container) {
         const enabled = container.resolve(FeatureFlags).get().isEnabled("aiPowerups.fileManager.imageEnrichment");
         if (!enabled) return;
+        container.register(FmImageEnrichmentCapability);
         container.register(PrepareImageEnrichmentUseCase);
         container.register(ApplyImageEnrichmentUseCase);
         container.register(AiImageEnrichmentAfterCreateHandler);

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

@@ -1 +1 @@
-{"version":3,"file":"api/features/AiImageEnrichment/feature.js","sources":["../../../../src/api/features/AiImageEnrichment/feature.ts"],"sourcesContent":["import { createFeature } from \"@webiny/feature/api\";\nimport { FeatureFlags } from \"@webiny/api-core/features/featureFlags/abstractions.js\";\nimport { AiImageEnrichmentAfterCreateHandler } from \"./AiImageEnrichmentAfterCreateHandler.js\";\nimport { AiImageEnrichmentTask } from \"./AiImageEnrichmentTask.js\";\nimport { AiImageEnrichmentStreamRouteDefinition } from \"./AiImageEnrichmentStreamRoute.js\";\nimport { PrepareImageEnrichmentUseCase } from \"./PrepareImageEnrichmentUseCase.js\";\nimport { ApplyImageEnrichmentUseCase } from \"./ApplyImageEnrichmentUseCase.js\";\n\nexport const AiImageEnrichmentFeature = createFeature({\n    name: \"AiPowerUps/AiImageEnrichment\",\n    register(container) {\n        // Register-time gate on the effective feature flags (userFlag && live WCP license). Valid at\n        // register() time because the license is refreshed PRE-register (WcpLicenseLoader.load() in\n        // registerApiRequestStack) and FeatureFlags reads that process cache — and it re-evaluates per\n        // request since the child re-registers, so a license change takes effect on the next request.\n        const enabled = container\n            .resolve(FeatureFlags)\n            .get()\n            .isEnabled(\"aiPowerups.fileManager.imageEnrichment\");\n\n        if (!enabled) {\n            return;\n        }\n\n        container.register(PrepareImageEnrichmentUseCase);\n        container.register(ApplyImageEnrichmentUseCase);\n\n        // Automatic enrichment after a file is created.\n        container.register(AiImageEnrichmentAfterCreateHandler);\n        container.register(AiImageEnrichmentTask);\n\n        // On-demand re-enrichment, streamed.\n        container.register(AiImageEnrichmentStreamRouteDefinition);\n    }\n});\n"],"names":["AiImageEnrichmentFeature","createFeature","container","enabled","FeatureFlags","PrepareImageEnrichmentUseCase","ApplyImageEnrichmentUseCase","AiImageEnrichmentAfterCreateHandler","AiImageEnrichmentTask","AiImageEnrichmentStreamRouteDefinition"],"mappings":";;;;;;;AAQO,MAAMA,2BAA2BC,cAAc;IAClD,MAAM;IACN,UAASC,SAAS;QAKd,MAAMC,UAAUD,UACX,OAAO,CAACE,cACR,GAAG,GACH,SAAS,CAAC;QAEf,IAAI,CAACD,SACD;QAGJD,UAAU,QAAQ,CAACG;QACnBH,UAAU,QAAQ,CAACI;QAGnBJ,UAAU,QAAQ,CAACK;QACnBL,UAAU,QAAQ,CAACM;QAGnBN,UAAU,QAAQ,CAACO;IACvB;AACJ"}
+{"version":3,"file":"api/features/AiImageEnrichment/feature.js","sources":["../../../../src/api/features/AiImageEnrichment/feature.ts"],"sourcesContent":["import { createFeature } from \"@webiny/feature/api\";\nimport { FeatureFlags } from \"@webiny/api-core/features/featureFlags/abstractions.js\";\nimport { AiImageEnrichmentAfterCreateHandler } from \"./AiImageEnrichmentAfterCreateHandler.js\";\nimport { AiImageEnrichmentTask } from \"./AiImageEnrichmentTask.js\";\nimport { AiImageEnrichmentStreamRouteDefinition } from \"./AiImageEnrichmentStreamRoute.js\";\nimport { PrepareImageEnrichmentUseCase } from \"./PrepareImageEnrichmentUseCase.js\";\nimport { ApplyImageEnrichmentUseCase } from \"./ApplyImageEnrichmentUseCase.js\";\nimport { FmImageEnrichmentCapability } from \"./capability.js\";\n\nexport const AiImageEnrichmentFeature = createFeature({\n    name: \"AiPowerUps/AiImageEnrichment\",\n    register(container) {\n        // Register-time gate on the effective feature flags (userFlag && live WCP license). Valid at\n        // register() time because the license is refreshed PRE-register (WcpLicenseLoader.load() in\n        // registerApiRequestStack) and FeatureFlags reads that process cache — and it re-evaluates per\n        // request since the child re-registers, so a license change takes effect on the next request.\n        const enabled = container\n            .resolve(FeatureFlags)\n            .get()\n            .isEnabled(\"aiPowerups.fileManager.imageEnrichment\");\n\n        if (!enabled) {\n            return;\n        }\n\n        // Registered inside the gate, so a project without the license does not get a settings\n        // row for a feature it cannot use.\n        container.register(FmImageEnrichmentCapability);\n        container.register(PrepareImageEnrichmentUseCase);\n        container.register(ApplyImageEnrichmentUseCase);\n\n        // Automatic enrichment after a file is created.\n        container.register(AiImageEnrichmentAfterCreateHandler);\n        container.register(AiImageEnrichmentTask);\n\n        // On-demand re-enrichment, streamed.\n        container.register(AiImageEnrichmentStreamRouteDefinition);\n    }\n});\n"],"names":["AiImageEnrichmentFeature","createFeature","container","enabled","FeatureFlags","FmImageEnrichmentCapability","PrepareImageEnrichmentUseCase","ApplyImageEnrichmentUseCase","AiImageEnrichmentAfterCreateHandler","AiImageEnrichmentTask","AiImageEnrichmentStreamRouteDefinition"],"mappings":";;;;;;;;AASO,MAAMA,2BAA2BC,cAAc;IAClD,MAAM;IACN,UAASC,SAAS;QAKd,MAAMC,UAAUD,UACX,OAAO,CAACE,cACR,GAAG,GACH,SAAS,CAAC;QAEf,IAAI,CAACD,SACD;QAKJD,UAAU,QAAQ,CAACG;QACnBH,UAAU,QAAQ,CAACI;QACnBJ,UAAU,QAAQ,CAACK;QAGnBL,UAAU,QAAQ,CAACM;QACnBN,UAAU,QAAQ,CAACO;QAGnBP,UAAU,QAAQ,CAACQ;IACvB;AACJ"}

package/api/features/Capabilities/CapabilitiesHandler.d.ts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import { AiPowerUpsSettingsGroupHandler } from "../../../api/features/shared/index.js";
+import type { CapabilitiesSettings } from "./types.js";
+import type { PersistedCapabilities } from "./types.js";
+declare class CapabilitiesHandlerImpl implements AiPowerUpsSettingsGroupHandler.Interface {
+    readonly name = "capabilities";
+    readonly inputSchema: z.ZodObject<{
+        items: z.ZodRecord<z.ZodString, z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+            overrides: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                roleId: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
+                    fast: "fast";
+                    standard: "standard";
+                    vision: "vision";
+                }>, z.ZodLiteral<"">]>>>;
+                connectionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                additionalInstructions: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    mapFromStorage(persisted: unknown): CapabilitiesSettings;
+    mapToStorage(internal: unknown): Promise<PersistedCapabilities>;
+}
+declare const _default: typeof CapabilitiesHandlerImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("../shared/abstractions.js").IAiPowerUpsSettingsGroupHandler>;
+};
+export default _default;

package/api/features/Capabilities/CapabilitiesHandler.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { AiPowerUpsSettingsGroupHandler } from "../shared/index.js";
+import { AI_MODEL_ROLE_IDS } from "../ModelRoles/index.js";
+const overrideSchema = z.object({
+    roleId: z.union([
+        z["enum"](AI_MODEL_ROLE_IDS),
+        z.literal("")
+    ]).nullish(),
+    connectionId: z.string().nullish(),
+    model: z.string().nullish(),
+    additionalInstructions: z.string().nullish()
+});
+const entrySchema = z.object({
+    enabled: z.boolean().nullish(),
+    overrides: overrideSchema.nullish()
+});
+const inputSchema = z.object({
+    items: z.record(z.string(), entrySchema)
+});
+const dropEmptyValues = (override)=>Object.fromEntries(Object.entries(override).filter(([, value])=>{
+        if (null == value) return false;
+        return "string" == typeof value ? "" !== value.trim() : true;
+    }));
+const normaliseEnabled = (enabled)=>false !== enabled;
+class CapabilitiesHandlerImpl {
+    mapFromStorage(persisted) {
+        const stored = persisted ?? {};
+        return {
+            items: stored.items ?? {}
+        };
+    }
+    async mapToStorage(internal) {
+        const input = internal;
+        const entries = Object.entries(input.items ?? {}).filter((entry)=>Boolean(entry[1])).map(([id, entry])=>[
+                id,
+                {
+                    enabled: normaliseEnabled(entry.enabled),
+                    overrides: dropEmptyValues(entry.overrides ?? {})
+                }
+            ]);
+        return {
+            items: Object.fromEntries(entries)
+        };
+    }
+    constructor(){
+        this.name = "capabilities";
+        this.inputSchema = inputSchema;
+    }
+}
+const CapabilitiesHandler = AiPowerUpsSettingsGroupHandler.createImplementation({
+    implementation: CapabilitiesHandlerImpl,
+    dependencies: []
+});
+export default CapabilitiesHandler;
+
+//# sourceMappingURL=CapabilitiesHandler.js.map