@umbraco-ai/core 17.0.0 → 17.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umbraco-ai/core",
-  "version": "17.0.0",
+  "version": "17.1.0",
   "type": "module",
   "types": "./types/umbraco-ai-public-types.d.ts",
   "files": [

package/types/umbraco-ai-public-types.d.ts

@@ -483,7 +483,6 @@ export declare type PropertyValueOperationRequestModel = {
     operation: AiPropertyOperationModel;
     args?: JsonNode | null;
     rootValue?: JsonNode | null;
-    rootEditorSchemaAlias: string;
     documentMetadata: AiDocumentMetadataModel;
 };
 
@@ -492,7 +491,6 @@ export declare type PropertyValueOperationRequestModelWritable = {
     operation: AiPropertyOperationModel;
     args?: JsonNodeWritable | null;
     rootValue?: JsonNodeWritable | null;
-    rootEditorSchemaAlias: string;
     documentMetadata: AiDocumentMetadataModelWritable;
 };
 
@@ -571,7 +569,6 @@ declare type ResInterceptor<Res, Req, Options> = (response: Res, request: Req, o
 export declare function resolveAndPrepareValue(value: unknown, editorAlias: string | undefined, currentValue: unknown): Promise<unknown>;
 
 declare interface ResolvedRequestOptions<TResponseStyle extends ResponseStyle = 'fields', ThrowOnError extends boolean = boolean, Url extends string = string> extends RequestOptions<unknown, TResponseStyle, ThrowOnError, Url> {
-    headers: Headers;
     serializedBody?: string;
 }
 
@@ -1392,6 +1389,85 @@ export declare interface UaiFrontendToolRepositoryApi extends UmbApi {
     getTools(): Promise<UaiFrontendToolData[]>;
 }
 
+/**
+ * A single generated image, returned as base64 data and/or a URL.
+ * @public
+ */
+export declare interface UaiGeneratedImage {
+    /** Base64-encoded image data, when the provider returned inline data. */
+    data?: string;
+    /** Image URL, when the provider returned a hosted/URI image. */
+    url?: string;
+    /** Media type of the image (e.g. "image/png"). */
+    mediaType?: string;
+}
+
+/**
+ * Public API for generating images from a text prompt.
+ *
+ * Image generation is experimental and only available when the
+ * `Umbraco:AI:Experimental:ImageGeneration` feature flag is enabled server-side;
+ * otherwise the server returns 404.
+ * @public
+ */
+export declare class UaiImageGenerationController extends UmbControllerBase {
+    #private;
+    constructor(host: UmbControllerHost);
+    /**
+     * Generates one or more images from a text prompt.
+     * @param prompt - The text prompt describing the desired image(s).
+     * @param options - Optional configuration (profile ID/alias, count, size, original images, abort signal).
+     * @returns The generation result or error.
+     */
+    generate(prompt: string, options?: UaiImageGenerationOptions): Promise<{
+        data?: UaiImageGenerationResult;
+        error?: unknown;
+    }>;
+}
+
+/**
+ * Options for image generation (public API).
+ * @public
+ */
+export declare interface UaiImageGenerationOptions {
+    /** Profile ID (GUID) or alias. If omitted, uses the default image-generation profile. */
+    profileIdOrAlias?: string;
+    /** Number of images to generate. */
+    count?: number;
+    /** Image size as "{width}x{height}" (e.g. "1024x1024"). */
+    size?: string;
+    /** Response format: "url", "data", or "hosted". */
+    responseFormat?: string;
+    /** Original images to edit (maskless edit). */
+    originalImages?: UaiImageInput[];
+    /** AbortSignal for cancellation. */
+    signal?: AbortSignal;
+}
+
+/* Excluded from this release type: UaiImageGenerationRequest */
+
+/**
+ * Result of an image-generation request.
+ * @public
+ */
+export declare interface UaiImageGenerationResult {
+    images: UaiGeneratedImage[];
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+        totalTokens?: number;
+    };
+}
+
+/**
+ * A base64-encoded input image for maskless editing.
+ * @public
+ */
+export declare interface UaiImageInput {
+    data: string;
+    mediaType: string;
+}
+
 /**
  * A card with background/border chrome wrapping a labeled field.
  */