@pushwoosh/rpc-gateway-ai-assistant 0.1.142 → 0.1.144

package/data.js

@@ -58,6 +58,36 @@ export const data = {
             "CARD_IMAGE_FIT_FILL"
         ]
     },
+    "pushwoosh.aibuilder.v1.CardImageSizeUnit": {
+        "type": "E",
+        "values": [
+            "CARD_IMAGE_SIZE_UNIT_UNSPECIFIED",
+            "CARD_IMAGE_SIZE_UNIT_PX",
+            "CARD_IMAGE_SIZE_UNIT_PERCENT"
+        ]
+    },
+    "pushwoosh.aibuilder.v1.CardImageSize": {
+        "type": "I",
+        "fields": {
+            "value": {
+                "type": "number"
+            },
+            "unit": {
+                "type": "pushwoosh.aibuilder.v1.CardImageSizeUnit"
+            }
+        }
+    },
+    "pushwoosh.aibuilder.v1.CardImagePosition": {
+        "type": "I",
+        "fields": {
+            "x": {
+                "type": "number"
+            },
+            "y": {
+                "type": "number"
+            }
+        }
+    },
     "pushwoosh.aibuilder.v1.TextVariantStyle": {
         "type": "I",
         "fields": {
@@ -145,10 +175,6 @@ export const data = {
     "pushwoosh.aibuilder.v1.CardStyles": {
         "type": "I",
         "fields": {
-            "accentFitPadding": {
-                "type": "pushwoosh.aibuilder.v1.EdgeInsets",
-                "optional": true
-            },
             "contentPadding": {
                 "type": "pushwoosh.aibuilder.v1.EdgeInsets",
                 "optional": true
@@ -406,8 +432,13 @@ export const data = {
             "imageFit": {
                 "type": "pushwoosh.aibuilder.v1.CardImageFit"
             },
-            "accentFit": {
-                "type": "boolean"
+            "imageSize": {
+                "type": "pushwoosh.aibuilder.v1.CardImageSize",
+                "optional": true
+            },
+            "imagePosition": {
+                "type": "pushwoosh.aibuilder.v1.CardImagePosition",
+                "optional": true
             }
         }
     },
@@ -704,24 +735,16 @@ export const data = {
             "generateImages": {
                 "type": "boolean"
             },
-            "settings": {
-                "type": "pushwoosh.aibuilder.v1.DocumentSettings",
-                "optional": true
-            },
-            "textVariants": {
-                "type": "pushwoosh.aibuilder.v1.TextVariantStyle",
-                "mapKeyType": "string"
-            },
-            "colorScheme": {
-                "type": "pushwoosh.aibuilder.v1.ColorSchemeItem",
-                "mapKeyType": "string"
-            },
             "addBlock": {
                 "type": "pushwoosh.aigen.v1.AiGenAddBlock",
                 "optional": true
             },
             "mode": {
                 "type": "pushwoosh.aigen.v1.AiGenMode"
+            },
+            "template": {
+                "type": "pushwoosh.aibuilder.v1.AiBuilderDocument",
+                "optional": true
             }
         }
     },

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@pushwoosh/rpc-gateway-ai-assistant",
-    "version": "0.1.142",
+    "version": "0.1.144",
     "description": "AI Assistant api gateway HTTP API Types and Data",
     "main": "index.js",
     "module": "index.js",

package/pushwoosh_aibuilder_v1.d.ts

@@ -83,8 +83,51 @@ export type CardImageFit = 'CARD_IMAGE_FIT_UNSPECIFIED'
  * and other assets that must not be cropped.
  */
  | 'CARD_IMAGE_FIT_CONTAIN'
-/** Stretch to fit, distorting aspect ratio. Rarely useful. */
+/**
+ * Stretch to fit, distorting aspect ratio. Deprecated — no longer
+ * offered in the editor and dropped from the LLM schema; kept only for
+ * wire compatibility.
+ */
  | 'CARD_IMAGE_FIT_FILL';
+/** Unit for CardImageSize.value. */
+export type CardImageSizeUnit = 
+/** value ignored → client default */
+'CARD_IMAGE_SIZE_UNIT_UNSPECIFIED'
+/** absolute pixels */
+ | 'CARD_IMAGE_SIZE_UNIT_PX'
+/** % of the card content-box width */
+ | 'CARD_IMAGE_SIZE_UNIT_PERCENT';
+/**
+ * CardImageSize sizes the image slot. Which dimension it drives depends on
+ * AiBuilderCard.layout:
+ * LEFT / RIGHT → width of the image column
+ * TOP          → height of the image
+ * BACKGROUND   → height of the card (width is always 100%)
+ * NO           → no image, ignored
+ * PERCENT is always measured against the card content-box WIDTH, so a
+ * percentage height yields a stable aspect ratio regardless of card width.
+ * Client-managed: the LLM never sets this; the backend round-trips it
+ * verbatim. value <= 0 (or unit UNSPECIFIED) is treated as unset → the
+ * client falls back to its default.
+ */
+export type CardImageSize = {
+    value: number;
+    unit: CardImageSizeUnit;
+};
+/**
+ * CardImagePosition is the focus / anchor of the image within its slot
+ * (CSS object-position). One field serves both UI modes:
+ * CONTAIN → "set position" (where the fitted image sits)
+ * COVER   → "focal point"  (which point stays in frame when cropped)
+ * Percentages 0..100; (0,0) = top-left, (50,50) = centre. Client-managed:
+ * the LLM never sets this; the backend round-trips it verbatim.
+ */
+export type CardImagePosition = {
+    /** horizontal, % (left) */
+    x: number;
+    /** vertical,   % (top) */
+    y: number;
+};
 export type TextVariantStyle = {
     fontSize: number;
     fontWeight: number;
@@ -165,11 +208,6 @@ export type ColumnsStyles = {
     padding?: EdgeInsets;
 };
 export type CardStyles = {
-    /**
-     * Padding applied to the image column when accent_fit is enabled on
-     * the card (see AiBuilderCard.accent_fit). Ignored otherwise.
-     */
-    accentFitPadding?: EdgeInsets;
     /**
      * Padding applied to the card's content (text) area on top of any
      * document-level default. Applies to all layouts that have a content
@@ -313,11 +351,17 @@ export type AiBuilderCard = {
      */
     imageFit: CardImageFit;
     /**
-     * Apply only to LEFT / RIGHT layouts: render the image as a side
-     * accent that fits the height of the text column. Ignored for other
-     * layouts.
+     * Size of the image slot (width for LEFT/RIGHT, height for TOP, card
+     * height for BACKGROUND; ignored for NO). Client-managed: the LLM never
+     * sets it, the backend round-trips it. Unset → client default.
+     */
+    imageSize?: CardImageSize;
+    /**
+     * Focus / anchor of the image within its slot (object-position).
+     * Client-managed: the LLM never sets it, the backend round-trips it.
+     * Unset → centre (50/50). Applies to the image layouts only.
      */
-    accentFit: boolean;
+    imagePosition?: CardImagePosition;
 };
 export type AiBuilderColumns = {
     columns: AiBuilderColumn[];

package/pushwoosh_aigen_v1.d.ts

@@ -6,7 +6,7 @@ import { AiBuilderBlock as pushwoosh_aibuilder_v1_AiBuilderBlock } from './pushw
 /**
  * AiGenService unifies document create / edit / per-block regeneration and
  * targeted block insertion into a single streaming RPC. Dispatch rules:
- * - document empty                       → create a new document
+ * - document empty (template required)   → create a new document from the template
  * - document set                         → edit existing document (diff planner)
  * - document set + block_path            → regenerate only that block; planner
  * skipped, structure_diff NOT emitted
@@ -78,7 +78,12 @@ export type AiGenBlockPath = {
 };
 export type AiGenRequest = {
     prompt: string;
-    /** Empty → create a new document. Set → edit. */
+    /**
+     * Edit mode: the existing document to mutate. Empty on create — use
+     * `template` instead. Mutually exclusive with `template`. On edit the
+     * document's styling (settings, text_variants, color_scheme) is read
+     * from here.
+     */
     document?: pushwoosh_aibuilder_v1_AiBuilderDocument;
     /**
      * Bypass mode: path `[page_id, block_id]` of the block to regenerate.
@@ -88,10 +93,6 @@ export type AiGenRequest = {
     blockPath: string[];
     application: string;
     generateImages: boolean;
-    /** Used on create; in edit taken from document. */
-    settings?: pushwoosh_aibuilder_v1_DocumentSettings;
-    textVariants: Record<string, pushwoosh_aibuilder_v1_TextVariantStyle>;
-    colorScheme: Record<string, pushwoosh_aibuilder_v1_ColorSchemeItem>;
     /**
      * Set → add-block mode: insert a single new block into `document` at a
      * client-specified position, skipping the planner. Mutually exclusive
@@ -103,6 +104,16 @@ export type AiGenRequest = {
      * rejects UNSPECIFIED with InvalidArgument.
      */
     mode: AiGenMode;
+    /**
+     * Create mode: the prototype document the new document is generated
+     * from. Required when `document` is empty; mutually exclusive with
+     * `document`. The generator preserves the template's styling (settings,
+     * text_variants, color_scheme are read from here on create) and
+     * imitates the layout / tone of its blocks while writing fresh content
+     * for the user's prompt. A template with no blocks degenerates to a
+     * free create (styling only, no structural reference).
+     */
+    template?: pushwoosh_aibuilder_v1_AiBuilderDocument;
 };
 /**
  * AiGenAddBlock triggers add-block mode on Generate. The server emits a