@pushwoosh/rpc-gateway-ai-assistant 0.1.143 → 0.1.145

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
             }
         }
     },
@@ -714,6 +745,29 @@ export const data = {
             "template": {
                 "type": "pushwoosh.aibuilder.v1.AiBuilderDocument",
                 "optional": true
+            },
+            "llmProvider": {
+                "type": "string",
+                "optional": true
+            },
+            "llmModel": {
+                "type": "string",
+                "optional": true
+            },
+            "referenceImages": {
+                "type": "pushwoosh.aigen.v1.AiGenReferenceImage",
+                "array": true
+            }
+        }
+    },
+    "pushwoosh.aigen.v1.AiGenReferenceImage": {
+        "type": "I",
+        "fields": {
+            "mediaType": {
+                "type": "string"
+            },
+            "data": {
+                "type": "string"
             }
         }
     },

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@pushwoosh/rpc-gateway-ai-assistant",
-    "version": "0.1.143",
+    "version": "0.1.145",
     "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

@@ -114,6 +114,39 @@ export type AiGenRequest = {
      * free create (styling only, no structural reference).
      */
     template?: pushwoosh_aibuilder_v1_AiBuilderDocument;
+    /**
+     * Dev-only override of the LLM backing block/structure generation.
+     * Empty = the server default (self-hosted Qwen/vLLM). "claude" routes
+     * generation through Anthropic. Gated client-side behind a hidden dev
+     * flag; the server simply honours whatever it receives.
+     */
+    llmProvider?: string;
+    /**
+     * Dev-only override of the concrete model name for the chosen provider.
+     * Empty = the provider's configured default (e.g. anthropic.model from
+     * config). Ignored when it doesn't apply to the provider.
+     */
+    llmModel?: string;
+    /**
+     * Reference images ("make it like this design") fed into the generation
+     * LLM's context — both the structure planner and the per-block content
+     * generator see them. Requires a vision-capable provider (Claude, or our
+     * multimodal Qwen/vLLM). Empty = text-only generation as before. Sent
+     * inline as base64; one image is the common case but the field is
+     * repeated for future multi-reference prompts.
+     */
+    referenceImages: AiGenReferenceImage[];
+};
+/**
+ * AiGenReferenceImage is an inline, base64-encoded image attached to a
+ * generation request as visual context. Not persisted as document content —
+ * it only conditions the LLM for this one run.
+ */
+export type AiGenReferenceImage = {
+    /** MIME type: "image/jpeg" | "image/png" | "image/gif" | "image/webp". */
+    mediaType: string;
+    /** Base64-encoded image bytes (no data: URI prefix). */
+    data: string;
 };
 /**
  * AiGenAddBlock triggers add-block mode on Generate. The server emits a