@pushwoosh/rpc-gateway-ai-assistant 0.1.186 → 0.1.188

package/commonTypes.d.ts

@@ -1,12 +1,4 @@
 export type Duration = number;
-/** Arbitrary JSON value (google.protobuf.Value). */
-export type JsonValue = string | number | boolean | null | JsonValue[] | {
-    [key: string]: JsonValue;
-};
-/** Arbitrary JSON object (google.protobuf.Struct). */
-export type JsonObject = {
-    [key: string]: JsonValue;
-};
 export type RpcMethod<Req, Res> = ((request: Req) => Promise<Res>) & {
     safe(request: Req): Promise<[{
         error: unknown;

package/data.js

@@ -390,6 +390,10 @@ export const data = {
             },
             "list": {
                 "type": "pushwoosh.aibuilder.v1.List"
+            },
+            "margin": {
+                "type": "pushwoosh.aibuilder.v1.EdgeInsets",
+                "optional": true
             }
         },
         "oneofs": {
@@ -449,6 +453,10 @@ export const data = {
             },
             "origHeight": {
                 "type": "number"
+            },
+            "margin": {
+                "type": "pushwoosh.aibuilder.v1.EdgeInsets",
+                "optional": true
             }
         }
     },
@@ -867,6 +875,12 @@ export const data = {
                 "response": "pushwoosh.aigen.v1.AiGenExtractStyleResponse",
                 "method": "post",
                 "path": "/api/v1/aigen/extract-style"
+            },
+            "ConvertUnlayer": {
+                "request": "pushwoosh.aigen.v1.AiGenConvertUnlayerRequest",
+                "response": "pushwoosh.aigen.v1.AiGenConvertUnlayerResponse",
+                "method": "post",
+                "path": "/api/v1/aigen/convert-unlayer"
             }
         }
     },
@@ -1293,6 +1307,41 @@ export const data = {
             }
         }
     },
+    "pushwoosh.aigen.v1.AiGenConvertUnlayerRequest": {
+        "type": "I",
+        "fields": {
+            "editorConfig": {
+                "type": "object"
+            },
+            "localizationData": {
+                "type": "object"
+            },
+            "language": {
+                "type": "string"
+            },
+            "application": {
+                "type": "string"
+            },
+            "templateName": {
+                "type": "string"
+            },
+            "subject": {
+                "type": "string"
+            }
+        }
+    },
+    "pushwoosh.aigen.v1.AiGenConvertUnlayerResponse": {
+        "type": "I",
+        "fields": {
+            "document": {
+                "type": "pushwoosh.aibuilder.v1.AiBuilderDocument"
+            },
+            "warnings": {
+                "type": "string",
+                "array": true
+            }
+        }
+    },
     "pushwoosh.accounts.assistant.v1.Role": {
         "type": "E",
         "values": [
@@ -1873,7 +1922,7 @@ export const data = {
                 "optional": true
             },
             "template": {
-                "type": "JsonObject"
+                "type": "object"
             },
             "categories": {
                 "type": "string",
@@ -2008,7 +2057,7 @@ export const data = {
                 "optional": true
             },
             "template": {
-                "type": "JsonObject"
+                "type": "object"
             },
             "categories": {
                 "type": "string",
@@ -2042,7 +2091,7 @@ export const data = {
                 "optional": true
             },
             "template": {
-                "type": "JsonObject"
+                "type": "object"
             },
             "updateCategories": {
                 "type": "boolean"
@@ -2608,7 +2657,8 @@ export const data = {
         "type": "I",
         "fields": {
             "image": {
-                "type": "pushwoosh.vibeml.v1.VibeReferenceImage"
+                "type": "pushwoosh.vibeml.v1.VibeReferenceImage",
+                "optional": true
             },
             "application": {
                 "type": "string"
@@ -2619,6 +2669,13 @@ export const data = {
             "llmModel": {
                 "type": "string",
                 "optional": true
+            },
+            "sources": {
+                "type": "pushwoosh.vibeml.v1.VibeSource",
+                "array": true
+            },
+            "description": {
+                "type": "string"
             }
         }
     },

package/package.json

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

package/pushwoosh_aibuilder_v1.d.ts

@@ -364,6 +364,15 @@ export type ContentItem_item_list = {
 };
 export type ContentItem_item = ContentItem_item_text | ContentItem_item_buttonGroup | ContentItem_item_list;
 export type ContentItem = {
+    /**
+     * Client-managed margin around this single item (outer box of the
+     * element, CSS margin semantics). Unset = the client applies its default
+     * inter-item gap; set (even to zeros) = the client uses exactly this and
+     * skips the default gap. Written by importers (e.g. the Unlayer
+     * converter maps each widget's containerPadding here) and by the editor;
+     * never exposed to the LLM, round-tripped verbatim by the backend.
+     */
+    margin?: EdgeInsets;
     item: ContentItem_item;
 };
 export type Content = {
@@ -389,6 +398,14 @@ export type Image = {
     mediaUuid: string;
     origWidth: number;
     origHeight: number;
+    /**
+     * Client-managed outer margin of the image within its slot (card TOP
+     * image, column image). Same semantics as ContentItem.margin: written by
+     * importers / the editor, never exposed to the LLM, round-tripped
+     * verbatim. Layouts without a discrete image box (BACKGROUND, LEFT/RIGHT
+     * fills) may ignore it.
+     */
+    margin?: EdgeInsets;
 };
 export type AiBuilderCard = {
     layout: CardLayout;

package/pushwoosh_aigen_v1.d.ts

@@ -5,6 +5,7 @@ import { TextVariantStyle as pushwoosh_aibuilder_v1_TextVariantStyle } from './p
 import { ColorSchemeItem as pushwoosh_aibuilder_v1_ColorSchemeItem } from './pushwoosh_aibuilder_v1';
 import { AiBuilderBlock as pushwoosh_aibuilder_v1_AiBuilderBlock } from './pushwoosh_aibuilder_v1';
 export type AiGenService_ExtractStyle = RpcMethod<AiGenExtractStyleRequest, AiGenExtractStyleResponse>;
+export type AiGenService_ConvertUnlayer = RpcMethod<AiGenConvertUnlayerRequest, AiGenConvertUnlayerResponse>;
 /**
  * AiGenService unifies document create / edit / per-block regeneration and
  * targeted block insertion into a single streaming RPC. Dispatch rules:
@@ -58,6 +59,20 @@ export interface AiGenService {
      * design screenshot. Unary; the result is small.
      */
     ExtractStyle: AiGenService_ExtractStyle;
+    /**
+     * ConvertUnlayer deterministically converts an Unlayer email-template
+     * design (the `editorConfig` JSON stored in EmailContent.Unlayer) into
+     * an AiBuilderDocument, so templates built in the Unlayer block editor
+     * can be opened in the AI builder. No LLM involved — the mapping is
+     * pure and repeatable, and the same call can back a bulk migration.
+     *
+     * Unlayer widgets with no AiBuilderDocument equivalent (countdown
+     * timers, custom tools, raw HTML) become Placeholder blocks the AI can
+     * materialise on a follow-up edit; every such lossy step is reported
+     * in `warnings`. The returned document always passes the EMAIL-mode
+     * document validation. Unary; the result is document-sized.
+     */
+    ConvertUnlayer: AiGenService_ConvertUnlayer;
 }
 export type AiGenBlockTypeHint = 'AI_GEN_BLOCK_TYPE_HINT_UNSPECIFIED' | 'AI_GEN_BLOCK_TYPE_HINT_CARD' | 'AI_GEN_BLOCK_TYPE_HINT_COLUMNS'
 /** Top-level free-form Content block. Allowed in WEB_POPUP only. */
@@ -535,3 +550,54 @@ export type AiGenExtractStyleResponse = {
      */
     typographyNotes: string;
 };
+export type AiGenConvertUnlayerRequest = {
+    /**
+     * The Unlayer design JSON (EmailContent.Unlayer.editor_config): the
+     * object carrying body.rows[].columns[].contents[]. Required.
+     */
+    editorConfig: object;
+    /**
+     * Unlayer localization placeholders. Accepts either the per-language
+     * map {"<lang>": {"<path>": "<value>"}} stored alongside the design in
+     * EmailContent.Unlayer.localization_data, or an already-flat
+     * {"<path>": "<value>"} map. Values are substituted into the design's
+     * {{path|type|fallback}} tokens during conversion. Optional — without
+     * it tokens resolve to their inline fallbacks.
+     */
+    localizationData: object;
+    /**
+     * Language key to resolve localized values with when localization_data
+     * is per-language. Empty → "default", falling back to the first
+     * language present.
+     */
+    language: string;
+    /**
+     * Application code. Required by the server's application-scoping
+     * middleware (same as the other AiGen RPCs); the converter itself does
+     * not use it.
+     */
+    application: string;
+    /**
+     * Optional document metadata carried into the result verbatim: the
+     * template name (Meta.template_name) and the email subject
+     * (EmailSettings.subject). Both live outside editor_config on the
+     * stored EmailTemplate, so the caller supplies them.
+     */
+    templateName: string;
+    subject: string;
+};
+export type AiGenConvertUnlayerResponse = {
+    /**
+     * The converted document. Complete and EMAIL-mode valid; block ids are
+     * deterministic ("u<row>-<n>") so repeated conversions of the same
+     * design yield the same document.
+     */
+    document: pushwoosh_aibuilder_v1_AiBuilderDocument;
+    /**
+     * Human-readable notes about content that could not be mapped 1:1 —
+     * unsupported widgets replaced with placeholders, dropped image links,
+     * per-column backgrounds, and similar. Order follows document order.
+     * Empty when the conversion was lossless.
+     */
+    warnings: string[];
+};

package/pushwoosh_templates_v1.d.ts

@@ -1,4 +1,4 @@
-import { RpcMethod, JsonObject } from './commonTypes';
+import { RpcMethod } from './commonTypes';
 export type TemplatesService_List = RpcMethod<ListRequest, ListResponse>;
 export type TemplatesService_Get = RpcMethod<GetRequest, GetResponse>;
 export type TemplatesService_Create = RpcMethod<CreateRequest, CreateResponse>;
@@ -46,7 +46,7 @@ export type Template = {
      * The template document itself: any valid JSON object, opaque to this
      * service.
      */
-    template: JsonObject;
+    template: object;
     /** Category tags attached to this template. Order is not significant. */
     categories: string[];
     /** Creation timestamp. */
@@ -113,7 +113,7 @@ export type CreateRequest = {
     /** Optional free-form description. */
     description?: string;
     /** The template document: any valid JSON object. */
-    template: JsonObject;
+    template: object;
     /** Category tags to attach. May be empty. */
     categories: string[];
 };
@@ -134,7 +134,7 @@ export type UpdateRequest = {
      * New template document (any valid JSON object). Only applied when set
      * (message presence).
      */
-    template: JsonObject;
+    template: object;
     /**
      * Controls how categories is applied (PATCH semantics):
      * - true  → replace categories with the provided list

package/pushwoosh_vibeml_v1.d.ts

@@ -411,20 +411,24 @@ export interface VibeMlService {
      */
     Restyle: VibeMlService_Restyle;
     /**
-     * ExtractTheme samples a brand theme from a single image: the full
-     * role-keyed palette plus body/heading font stacks, returned as a
-     * VibeTheme ready to seed a Generate request. Pure extractor — image
-     * in, theme out, no document.
+     * ExtractTheme samples a brand theme — the full role-keyed palette plus
+     * body/heading font stacks — from any mix of brand materials: an image, a
+     * brand-book PDF, HTML/markdown/text sources, and/or a written brand
+     * description. At least one input (image, source or description) is
+     * required; any combination is allowed — files with a description, files
+     * alone, or a description alone. Returned as a VibeTheme ready to seed a
+     * Generate request. Pure extractor — materials in, theme out, no document.
      *
      * The model MUST return every palette role (background, surface, text,
      * text-secondary, accent, text-on-accent, border, link) and both font
-     * families — even when the image gives no clear typographic signal it
+     * families — even when the materials give no clear typographic signal it
      * picks reasonable stacks rather than leaving them empty.
      *
-     * The chosen model must be vision-capable. Since llm_model is a client
-     * override and capability can't be derived from a model name, there is no
-     * up-front check: a non-vision model fails at the upstream call. Unary;
-     * the result is small.
+     * When an image is attached the chosen model must be vision-capable; a
+     * PDF source requires a document-capable provider (claude/openai/gemini).
+     * Since llm_model is a client override and capability can't be derived
+     * from a model name, there is no up-front vision check: a non-vision
+     * model fails at the upstream call. Unary; the result is small.
      */
     ExtractTheme: VibeMlService_ExtractTheme;
 }
@@ -596,18 +600,31 @@ export type VibeReferenceImage = {
 };
 export type VibeMlExtractThemeRequest = {
     /**
-     * The image to sample the theme from. Required. The selected model must
-     * be vision-capable.
+     * An image to sample the theme from (screenshot, logo, moodboard).
+     * Optional — one of image / sources / description must be present. When
+     * set, the selected model must be vision-capable.
      */
-    image: VibeReferenceImage;
+    image?: VibeReferenceImage;
     /** Application code, for account/app scoping middleware and logging. */
     application: string;
     /**
      * Provider/model, same semantics as on Generate: llm_provider is
-     * REQUIRED, llm_model optional. The chosen model must be vision-capable.
+     * REQUIRED, llm_model optional.
      */
     llmProvider: string;
     llmModel?: string;
+    /**
+     * Brand materials to sample the theme from: a brand-book PDF, an HTML
+     * page, markdown or plain text. Same shape, formats and limits as
+     * Generate's sources (PDF needs a document-capable provider). Optional.
+     */
+    sources: VibeSource[];
+    /**
+     * A written brand description ("dark green, minimalist, premium outdoor
+     * brand") the model derives the palette from. Optional; may accompany or
+     * replace the image/sources.
+     */
+    description: string;
 };
 export type VibeMlExtractThemeResponse = {
     /**