@umbraco-ai/core 1.9.0 → 1.10.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umbraco-ai/core",
-  "version": "1.9.0",
+  "version": "1.10.1",
   "type": "module",
   "types": "./types/umbraco-ai-public-types.d.ts",
   "files": [
@@ -8,8 +8,8 @@
     "README.md"
   ],
   "peerDependencies": {
+    "@umbraco-cms/backoffice": "^17.3.0",
     "chart.js": "^4.5.1",
-    "diff": "^8.0.3",
-    "@umbraco-cms/backoffice": "^17.1.0"
+    "diff": "^8.0.3"
   }
 }

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

@@ -14,6 +14,7 @@ import { UmbContextToken } from '@umbraco-cms/backoffice/context-api';
 import { UmbControllerBase } from '@umbraco-cms/backoffice/class-api';
 import type { UmbControllerHost } from '@umbraco-cms/backoffice/controller-api';
 import type { UmbDetailRepository } from '@umbraco-cms/backoffice/repository';
+import type { UmbElement } from '@umbraco-cms/backoffice/element-api';
 import { UmbEntityActionBase } from '@umbraco-cms/backoffice/entity-action';
 import { UmbEntityActionEvent } from '@umbraco-cms/backoffice/entity-action';
 import { UmbEntityBulkActionBase } from '@umbraco-cms/backoffice/entity-bulk-action';
@@ -23,6 +24,33 @@ import { UmbModalBaseElement } from '@umbraco-cms/backoffice/modal';
 import { UmbModalToken } from '@umbraco-cms/backoffice/modal';
 import { UUIFormControlMixinElement } from '@umbraco-ui/uui-base';
 
+declare interface AiHttpClient {
+    setConfig: (config: any) => unknown;
+    interceptors: {
+        response: {
+            use: (fn: (response: Response, request: Request, opts?: unknown) => Response | Promise<Response>) => unknown;
+        };
+    };
+}
+
+/**
+ * Configures a generated hey-api client with the backoffice auth callback
+ * and attaches a silent 401 recovery interceptor.
+ *
+ * The interceptor calls `authContext.makeRefreshTokenRequest()` on a 401
+ * and retries the request once. This is a workaround for CMS issue
+ * https://github.com/umbraco/Umbraco-CMS/issues/22647 — the default
+ * `UmbApiInterceptorController.bindDefaultInterceptors` is unusable from
+ * third-party entry-point hosts because its `UmbAuthSignalerContext`
+ * ends up scoped below `umb-app` and emissions never reach `UmbAuthContext`.
+ *
+ * @param host The entry point's `host` parameter (`UmbElement`).
+ * @param client The generated hey-api client to configure.
+ * @returns A Promise that resolves once auth is configured on the client.
+ * @public
+ */
+export declare function configureAiClient(host: UmbElement, client: AiHttpClient): Promise<void>;
+
 export declare const coreClientReady: Promise<void>;
 
 /**
@@ -529,7 +557,10 @@ export declare class UaiDocumentAdapter implements UaiEntityAdapterApi {
     getName(workspaceContext: unknown): string;
     /**
      * Get an observable for the document name for reactive updates.
-     * Uses the variants observable which properly tracks name changes.
+     * Uses the variants observable which properly tracks name changes, and
+     * picks the variant whose culture matches what the editor currently has
+     * focused so the AI context selector shows the right name on multi-
+     * variant documents.
      */
     getNameObservable(workspaceContext: unknown): Observable<string | undefined> | undefined;
     /**
@@ -545,7 +576,12 @@ export declare class UaiDocumentAdapter implements UaiEntityAdapterApi {
     /**
      * Serialize document for LLM context.
      * Uses structure to get all properties, then merges with values.
-     * Only includes TextBox and TextArea properties for now.
+     *
+     * Multi-variant content: `getValues()` returns one entry per
+     * (alias, culture, segment). We pick the entry that matches the variant
+     * the editor currently has focused, falling back to the invariant entry
+     * for properties that don't vary, so prompt template variables like
+     * `{{header}}` resolve to the active culture's value.
      */
     serializeForLlm(workspaceContext: unknown): Promise<UaiSerializedEntity>;
     /**
@@ -1138,6 +1174,14 @@ export declare interface UaiSerializedEntity {
     name: string;
     /** Parent unique when creating a new entity. Undefined for existing entities. */
     parentUnique?: string | null;
+    /**
+     * Active culture the editor was on when the entity was serialized.
+     * Null/undefined for invariant entities. Used by the server to pick the
+     * matching property entry from `data.properties` on multi-variant content.
+     */
+    culture?: string | null;
+    /** Active segment when the entity was serialized. */
+    segment?: string | null;
     /**
      * Free-form entity data as JSON object.
      * Adapters decide the structure based on entity type.
@@ -1147,7 +1191,7 @@ export declare interface UaiSerializedEntity {
      * {
      *   contentType: "blogPost",
      *   properties: [
-     *     { alias: "title", label: "Title", editorAlias: "Umbraco.TextBox", value: "Hello" }
+     *     { alias: "title", label: "Title", editorAlias: "Umbraco.TextBox", value: "Hello", culture: "en-US", segment: null }
      *   ]
      * }
      * ```
@@ -1166,15 +1210,18 @@ export declare interface UaiSerializedEntity {
 
 /**
  * Serialized property for LLM context.
- * @deprecated Entity data is now stored in UaiSerializedEntity.data as free-form JSON.
- * For CMS entities, properties are nested inside the data field.
- * This interface is kept for reference only.
+ * Used as the element type of `UaiSerializedEntity.data.properties` for CMS entities.
+ *
+ * `culture` and `segment` describe which variant this property value belongs to:
+ * `null` means invariant (no culture/segment dimension on the property).
  */
 export declare interface UaiSerializedProperty {
     alias: string;
     label: string;
     editorAlias: string;
     value: unknown;
+    culture: string | null;
+    segment: string | null;
 }
 
 /**