@umbraco-ai/core 1.10.0 → 1.10.1

package/package.json

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

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

@@ -557,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;
     /**
@@ -573,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>;
     /**
@@ -1166,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.
@@ -1175,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 }
      *   ]
      * }
      * ```
@@ -1194,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;
 }
 
 /**