@pushwoosh/rpc-gateway-ai-assistant 0.1.277 → 0.1.278

package/data.js

@@ -2084,6 +2084,18 @@ export const data = {
                 "method": "post",
                 "path": "/api/v1/aigen/extract-style"
             },
+            "ExtractTheme": {
+                "request": "pushwoosh.aigen.v1.AiGenExtractThemeRequest",
+                "response": "pushwoosh.aigen.v1.AiGenExtractThemeResponse",
+                "method": "post",
+                "path": "/api/v1/aigen/extract-theme"
+            },
+            "Translate": {
+                "request": "pushwoosh.aigen.v1.AiGenTranslateRequest",
+                "response": "pushwoosh.aigen.v1.AiGenTranslateResponse",
+                "method": "post",
+                "path": "/api/v1/aigen/translate"
+            },
             "ConvertUnlayer": {
                 "request": "pushwoosh.aigen.v1.AiGenConvertUnlayerRequest",
                 "response": "pushwoosh.aigen.v1.AiGenConvertUnlayerResponse",
@@ -2570,6 +2582,134 @@ export const data = {
             }
         }
     },
+    "pushwoosh.aigen.v1.AiGenSourceFormat": {
+        "type": "E",
+        "values": [
+            "AI_GEN_SOURCE_FORMAT_UNSPECIFIED",
+            "AI_GEN_SOURCE_FORMAT_TEXT",
+            "AI_GEN_SOURCE_FORMAT_MARKDOWN",
+            "AI_GEN_SOURCE_FORMAT_HTML",
+            "AI_GEN_SOURCE_FORMAT_PDF"
+        ]
+    },
+    "pushwoosh.aigen.v1.AiGenSource": {
+        "type": "I",
+        "fields": {
+            "format": {
+                "type": "pushwoosh.aigen.v1.AiGenSourceFormat"
+            },
+            "content": {
+                "type": "string"
+            },
+            "name": {
+                "type": "string"
+            }
+        }
+    },
+    "pushwoosh.aigen.v1.AiGenTheme": {
+        "type": "I",
+        "fields": {
+            "colors": {
+                "type": "string",
+                "mapKeyType": "string"
+            },
+            "fontFamily": {
+                "type": "string"
+            },
+            "headingFontFamily": {
+                "type": "string"
+            }
+        }
+    },
+    "pushwoosh.aigen.v1.AiGenExtractThemeRequest": {
+        "type": "I",
+        "fields": {
+            "image": {
+                "type": "pushwoosh.aigen.v1.AiGenReferenceImage",
+                "optional": true
+            },
+            "application": {
+                "type": "string"
+            },
+            "llmProvider": {
+                "type": "string",
+                "optional": true
+            },
+            "llmModel": {
+                "type": "string",
+                "optional": true
+            },
+            "sources": {
+                "type": "pushwoosh.aigen.v1.AiGenSource",
+                "array": true
+            },
+            "description": {
+                "type": "string"
+            },
+            "siteUrl": {
+                "type": "string"
+            }
+        }
+    },
+    "pushwoosh.aigen.v1.AiGenExtractThemeResponse": {
+        "type": "I",
+        "fields": {
+            "theme": {
+                "type": "pushwoosh.aigen.v1.AiGenTheme"
+            },
+            "logoUrl": {
+                "type": "string"
+            },
+            "brandVoice": {
+                "type": "string"
+            }
+        }
+    },
+    "pushwoosh.aigen.v1.AiGenTranslateRequest": {
+        "type": "I",
+        "fields": {
+            "application": {
+                "type": "string"
+            },
+            "texts": {
+                "type": "string",
+                "array": true
+            },
+            "targetLanguages": {
+                "type": "string",
+                "array": true
+            },
+            "context": {
+                "type": "string"
+            },
+            "llmProvider": {
+                "type": "string",
+                "optional": true
+            },
+            "llmModel": {
+                "type": "string",
+                "optional": true
+            }
+        }
+    },
+    "pushwoosh.aigen.v1.AiGenTranslatedTexts": {
+        "type": "I",
+        "fields": {
+            "texts": {
+                "type": "string",
+                "array": true
+            }
+        }
+    },
+    "pushwoosh.aigen.v1.AiGenTranslateResponse": {
+        "type": "I",
+        "fields": {
+            "translations": {
+                "type": "pushwoosh.aigen.v1.AiGenTranslatedTexts",
+                "mapKeyType": "string"
+            }
+        }
+    },
     "pushwoosh.aigen.v1.AiGenConvertUnlayerRequest": {
         "type": "I",
         "fields": {

package/package.json

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

package/pushwoosh_aigen_v1.d.ts

@@ -6,6 +6,8 @@ import { ColorSchemeItem as pushwoosh_aibuilder_v1_ColorSchemeItem } from './pus
 import { AiBuilderBlock as pushwoosh_aibuilder_v1_AiBuilderBlock } from './pushwoosh_aibuilder_v1';
 import { EdgeInsets as pushwoosh_aibuilder_v1_EdgeInsets } from './pushwoosh_aibuilder_v1';
 export type AiGenService_ExtractStyle = RpcMethod<AiGenExtractStyleRequest, AiGenExtractStyleResponse>;
+export type AiGenService_ExtractTheme = RpcMethod<AiGenExtractThemeRequest, AiGenExtractThemeResponse>;
+export type AiGenService_Translate = RpcMethod<AiGenTranslateRequest, AiGenTranslateResponse>;
 export type AiGenService_ConvertUnlayer = RpcMethod<AiGenConvertUnlayerRequest, AiGenConvertUnlayerResponse>;
 export type AiGenService_DocumentToHtml = RpcMethod<AiGenDocumentToHtmlRequest, AiGenDocumentToHtmlResponse>;
 export type AiGenService_DocumentToPageHtml = RpcMethod<AiGenDocumentToPageHtmlRequest, AiGenDocumentToPageHtmlResponse>;
@@ -69,6 +71,16 @@ export interface AiGenService {
      * design screenshot. Unary; the result is small.
      */
     ExtractStyle: AiGenService_ExtractStyle;
+    /**
+     * ExtractTheme samples a full brand theme (every palette role + both font stacks) and
+     * the brand voice from any mix of materials. See documents/vibeml-architecture.md.
+     */
+    ExtractTheme: AiGenService_ExtractTheme;
+    /**
+     * Translate renders a batch of email texts into the target languages, one call per
+     * language. Markup and dynamic syntax survive verbatim; responses are index-aligned.
+     */
+    Translate: AiGenService_Translate;
     /**
      * ConvertUnlayer deterministically converts an Unlayer email-template
      * design (the `editorConfig` JSON stored in EmailContent.Unlayer) into
@@ -647,6 +659,95 @@ export type AiGenExtractStyleResponse = {
      */
     typographyNotes: string;
 };
+/**
+ * AiGenSourceFormat tags a source's content type; it decides how the server feeds it to
+ * the model. PDF needs a document-capable provider, else FailedPrecondition.
+ */
+export type AiGenSourceFormat = 'AI_GEN_SOURCE_FORMAT_UNSPECIFIED' | 'AI_GEN_SOURCE_FORMAT_TEXT' | 'AI_GEN_SOURCE_FORMAT_MARKDOWN'
+/** Fed as text: the model reads the content, it does not re-emit the markup. */
+ | 'AI_GEN_SOURCE_FORMAT_HTML'
+/** content is base64 PDF bytes (no data: prefix), forwarded as a native document. */
+ | 'AI_GEN_SOURCE_FORMAT_PDF';
+/**
+ * AiGenSource is reference material the model works off instead of inventing from the
+ * prompt. Factual source material, never instructions.
+ */
+export type AiGenSource = {
+    /** Required; UNSPECIFIED is InvalidArgument. */
+    format: AiGenSourceFormat;
+    /** UTF-8 text, or base64 bytes for PDF. Required; capped at 200 KB (PDF ~12 MB base64). */
+    content: string;
+    /** Optional label distinguishing multiple sources ("product brief"). */
+    name: string;
+};
+/**
+ * AiGenTheme is a role-keyed palette plus the two font stacks — the extractor's own
+ * output shape, not a document's color_scheme.
+ */
+export type AiGenTheme = {
+    /**
+     * Keyed by semantic role, values strictly hex. ExtractTheme fills every role:
+     * background, surface, text, heading, text-secondary, accent, text-on-accent, border, link.
+     */
+    colors: Record<string, string>;
+    /** CSS font-family chain for body text, e.g. "Inter, system-ui, sans-serif". */
+    fontFamily: string;
+    /** Headings; may equal font_family. */
+    headingFontFamily: string;
+};
+/** At least one of image / sources / description / site_url is required; any mix is allowed. */
+export type AiGenExtractThemeRequest = {
+    /** Screenshot, logo or moodboard. Optional; needs a vision-capable model. */
+    image?: AiGenReferenceImage;
+    /** Application code, for account/app scoping middleware and logging. */
+    application: string;
+    /** Dev-only LLM override, same semantics as AiGenRequest.llm_provider: empty = the default. */
+    llmProvider?: string;
+    llmModel?: string;
+    /** Brand materials: brand-book PDF, HTML page, markdown or plain text. Optional. */
+    sources: AiGenSource[];
+    /** Written brand description ("dark green, minimalist, premium outdoor brand"). Optional. */
+    description: string;
+    /**
+     * Public site to read the brand off ("acme.com"). The server distils its colours, fonts
+     * and meta into one source and adopts the logo it finds as the image. Optional.
+     */
+    siteUrl: string;
+};
+export type AiGenExtractThemeResponse = {
+    theme: AiGenTheme;
+    /** The logo found on site_url; empty without a site or a find. The client decides. */
+    logoUrl: string;
+    /** How the brand talks, 1-3 sentences, for a copywriter to imitate. Empty without copy. */
+    brandVoice: string;
+};
+export type AiGenTranslateRequest = {
+    /** Application code, for account/app scoping middleware and logging. */
+    application: string;
+    /**
+     * Source texts: plain, inline HTML, merge tags / Liquid / %%macros%% (all kept verbatim).
+     * Capped at 300 texts and 60 000 characters in total.
+     */
+    texts: string[];
+    /**
+     * Language codes as the editor names them ("es", "pt-BR"), without the source language.
+     * Capped at 20.
+     */
+    targetLanguages: string[];
+    /** Optional hint steering tone and terminology (campaign topic, brand voice). */
+    context: string;
+    /** Dev-only LLM override, same semantics as AiGenRequest.llm_provider: empty = the default. */
+    llmProvider?: string;
+    llmModel?: string;
+};
+export type AiGenTranslatedTexts = {
+    /** Index-aligned with AiGenTranslateRequest.texts. */
+    texts: string[];
+};
+export type AiGenTranslateResponse = {
+    /** Exactly the requested languages: all-or-nothing, a failed language fails the call. */
+    translations: Record<string, AiGenTranslatedTexts>;
+};
 export type AiGenConvertUnlayerRequest = {
     /**
      * The Unlayer design JSON (EmailContent.Unlayer.editor_config): the