@pushwoosh/rpc-gateway-ai-assistant 0.1.185 → 0.1.187

package/data.js

@@ -2608,7 +2608,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 +2620,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.185",
+    "version": "0.1.187",
     "description": "AI Assistant api gateway HTTP API Types and Data",
     "main": "index.js",
     "module": "index.js",

package/pushwoosh_vibeml_v1.d.ts

@@ -61,8 +61,9 @@ export type VibeDocumentSettings = {
     contentWidth: string;
     /**
      * Email canvas / body background color — the MJML mj-body background
-     * analog: the area behind the content column. Hex ("#f4f4f4") or
-     * "transparent". Empty = the renderer's default.
+     * analog: the area behind the content column. Hex ("#f4f4f4"),
+     * "transparent", or a theme color token ("$background"). Empty = the
+     * renderer's default.
      */
     background: string;
 };
@@ -164,12 +165,15 @@ export type VibeMeta = {
  */
 export type VibeTheme = {
     /**
-     * Reference palette keyed by semantic role (background, surface, text,
+     * Design-token palette keyed by semantic role (background, surface, text,
      * text-secondary, accent, text-on-accent, border, link). Free-form
-     * string keys — no key is guaranteed present — so this is a set of brand
-     * colors blocks/attributes can reference. Values are hex colors
-     * ("#155F50"). The canvas background is NOT here — it is a guaranteed
-     * field on VibeDocumentSettings.
+     * string keys — no key is guaranteed present. Any color-typed prop value
+     * (block props, attributes, block_variants, settings.background) may
+     * reference an entry by token: "$accent" means colors["accent"], resolved
+     * by the renderer at render time — so re-theming a document is just
+     * swapping this palette. Values here are strictly hex colors ("#155F50");
+     * a token cannot reference another token. The canvas background is NOT
+     * here — it is a guaranteed field on VibeDocumentSettings.
      */
     colors: Record<string, string>;
     /** CSS font-family chain for body text. */
@@ -407,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;
 }
@@ -592,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 = {
     /**