@pushwoosh/rpc-gateway-ai-assistant 0.1.157 → 0.1.158

package/data.js

@@ -1103,6 +1103,19 @@ export const data = {
                 "method": "post",
                 "path": "/api/v1/aigen/generate",
                 "serverStreaming": true
+            },
+            "RenderHtml": {
+                "request": "pushwoosh.aigen.v1.AiGenHtmlRequest",
+                "response": "pushwoosh.aigen.v1.AiGenHtmlEvent",
+                "method": "post",
+                "path": "/api/v1/aigen/html",
+                "serverStreaming": true
+            },
+            "ExtractStyle": {
+                "request": "pushwoosh.aigen.v1.AiGenExtractStyleRequest",
+                "response": "pushwoosh.aigen.v1.AiGenExtractStyleResponse",
+                "method": "post",
+                "path": "/api/v1/aigen/extract-style"
             }
         }
     },
@@ -1436,6 +1449,99 @@ export const data = {
             }
         }
     },
+    "pushwoosh.aigen.v1.AiGenHtmlRequest": {
+        "type": "I",
+        "fields": {
+            "document": {
+                "type": "pushwoosh.aibuilder.v1.AiBuilderDocument"
+            },
+            "mode": {
+                "type": "pushwoosh.aigen.v1.AiGenMode"
+            },
+            "application": {
+                "type": "string"
+            },
+            "referenceImages": {
+                "type": "pushwoosh.aigen.v1.AiGenReferenceImage",
+                "array": true
+            },
+            "llmProvider": {
+                "type": "string",
+                "optional": true
+            },
+            "llmModel": {
+                "type": "string",
+                "optional": true
+            },
+            "instructions": {
+                "type": "string"
+            }
+        }
+    },
+    "pushwoosh.aigen.v1.AiGenHtmlEvent": {
+        "type": "I",
+        "fields": {
+            "progress": {
+                "type": "string"
+            },
+            "htmlDelta": {
+                "type": "string"
+            },
+            "done": {
+                "type": "pushwoosh.aigen.v1.AiGenDoneEvent"
+            },
+            "fatal": {
+                "type": "string"
+            }
+        },
+        "oneofs": {
+            "event": {
+                "oneof": [
+                    "progress",
+                    "htmlDelta",
+                    "done",
+                    "fatal"
+                ]
+            }
+        }
+    },
+    "pushwoosh.aigen.v1.AiGenExtractStyleRequest": {
+        "type": "I",
+        "fields": {
+            "image": {
+                "type": "pushwoosh.aigen.v1.AiGenReferenceImage"
+            },
+            "llmProvider": {
+                "type": "string",
+                "optional": true
+            },
+            "llmModel": {
+                "type": "string",
+                "optional": true
+            },
+            "application": {
+                "type": "string"
+            }
+        }
+    },
+    "pushwoosh.aigen.v1.AiGenExtractStyleResponse": {
+        "type": "I",
+        "fields": {
+            "colorScheme": {
+                "type": "pushwoosh.aibuilder.v1.ColorSchemeItem",
+                "mapKeyType": "string"
+            },
+            "fontFamily": {
+                "type": "string"
+            },
+            "headingFontFamily": {
+                "type": "string"
+            },
+            "typographyNotes": {
+                "type": "string"
+            }
+        }
+    },
     "pushwoosh.accounts.assistant.v1.Role": {
         "type": "E",
         "values": [

package/package.json

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

package/pushwoosh_aigen_v1.d.ts

@@ -1,8 +1,10 @@
+import { RpcMethod } from './commonTypes';
 import { AiBuilderDocument as pushwoosh_aibuilder_v1_AiBuilderDocument } from './pushwoosh_aibuilder_v1';
 import { DocumentSettings as pushwoosh_aibuilder_v1_DocumentSettings } from './pushwoosh_aibuilder_v1';
 import { TextVariantStyle as pushwoosh_aibuilder_v1_TextVariantStyle } from './pushwoosh_aibuilder_v1';
 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>;
 /**
  * AiGenService unifies document create / edit / per-block regeneration and
  * targeted block insertion into a single streaming RPC. Dispatch rules:
@@ -27,6 +29,35 @@ export interface AiGenService {
     Generate(request: AiGenRequest, options?: {
         signal?: AbortSignal;
     }): Promise<AsyncIterable<AiGenEvent>>;
+    /**
+     * RenderHtml renders an existing AiBuilderDocument into a finished,
+     * self-contained HTML document. The model writes the whole HTML — a
+     * full <!DOCTYPE html> page with embedded/inline CSS — from the
+     * document's content and styling, streamed back as ordered html_delta
+     * chunks the client concatenates.
+     *
+     * mode picks the flavour: EMAIL → email-safe markup (table-based
+     * layout, inline CSS, max client compatibility); WEB_POPUP → a modern
+     * responsive page (CSS in <head>, fl/grid). UNSPECIFIED and FULL are
+     * rejected like on Generate.
+     *
+     * An optional reference image conditions the visual style ("make it
+     * look like this design") — its palette, typography, spacing, and
+     * corner treatment are sampled by a vision-capable provider.
+     * llm_provider / llm_model are the same dev-only overrides as Generate.
+     */
+    RenderHtml(request: AiGenHtmlRequest, options?: {
+        signal?: AbortSignal;
+    }): Promise<AsyncIterable<AiGenHtmlEvent>>;
+    /**
+     * ExtractStyle samples a visual style from a single image: a colour
+     * palette (keyed by semantic role) plus typography hints (body /
+     * heading font-family stacks and a free-text character note). It is a
+     * pure extractor — no document in, no document out — meant to seed a
+     * fresh AiBuilderDocument's color_scheme / fonts from a brand asset or
+     * design screenshot. Unary; the result is small.
+     */
+    ExtractStyle: AiGenService_ExtractStyle;
 }
 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. */
@@ -387,3 +418,119 @@ export type AiGenEvent_event = AiGenEvent_event_progress | AiGenEvent_event_stru
 export type AiGenEvent = {
     event: AiGenEvent_event;
 };
+export type AiGenHtmlRequest = {
+    /**
+     * The document to render to HTML. Required; must carry at least one
+     * page. All of its content and styling (blocks, text, buttons, image
+     * src/alt, color_scheme, settings) is fed to the model verbatim — the
+     * model only formats it, it does not rewrite the copy.
+     */
+    document: pushwoosh_aibuilder_v1_AiBuilderDocument;
+    /**
+     * Document-domain profile for the output flavour. Required — the
+     * server rejects UNSPECIFIED and FULL like on Generate. EMAIL produces
+     * email-safe markup (table layout, inline CSS); WEB_POPUP produces a
+     * modern responsive page.
+     */
+    mode: AiGenMode;
+    /**
+     * Application id, used for media-context / logging parity with
+     * Generate. Optional for rendering.
+     */
+    application: string;
+    /**
+     * Optional reference images: "style it like this design". Fed to a
+     * vision-capable provider (Claude, or our multimodal Qwen/vLLM) as
+     * visual context for palette / typography / spacing. Empty = the
+     * style is derived from the document and instructions only. Sent
+     * inline as base64; reuses the same shape as Generate.
+     */
+    referenceImages: AiGenReferenceImage[];
+    /**
+     * Dev-only override of the LLM. Empty = the server default
+     * (self-hosted Qwen/vLLM); "claude" routes through Anthropic. Same
+     * semantics and gating as AiGenRequest.llm_provider.
+     */
+    llmProvider?: string;
+    /**
+     * Dev-only override of the concrete model name for the chosen
+     * provider. Empty = the provider's configured default.
+     */
+    llmModel?: string;
+    /**
+     * Optional free-form extra guidance from the user layered on top of
+     * the document content ("dark theme", "more whitespace", "single
+     * column"). Empty = render faithfully with sensible defaults.
+     */
+    instructions: string;
+};
+export type AiGenHtmlEvent_event_progress = {
+    type: 'progress';
+    data: string;
+};
+export type AiGenHtmlEvent_event_htmlDelta = {
+    type: 'htmlDelta';
+    data: string;
+};
+export type AiGenHtmlEvent_event_done = {
+    type: 'done';
+    data: AiGenDoneEvent;
+};
+export type AiGenHtmlEvent_event_fatal = {
+    type: 'fatal';
+    data: string;
+};
+export type AiGenHtmlEvent_event = AiGenHtmlEvent_event_progress | AiGenHtmlEvent_event_htmlDelta | AiGenHtmlEvent_event_done | AiGenHtmlEvent_event_fatal;
+/** AiGenHtmlEvent is one frame of the RenderHtml stream. */
+export type AiGenHtmlEvent = {
+    event: AiGenHtmlEvent_event;
+};
+export type AiGenExtractStyleRequest = {
+    /**
+     * The image to sample the style from. Required. Sent inline as base64,
+     * same shape as RenderHtml's reference images. Needs a vision-capable
+     * provider (Claude, or our multimodal Qwen/vLLM).
+     */
+    image: AiGenReferenceImage;
+    /** Dev-only LLM override, same semantics as AiGenRequest.llm_provider. */
+    llmProvider?: string;
+    llmModel?: string;
+    /**
+     * Application code. Required by the server's application-scoping
+     * middleware (same as the other AiGen RPCs); the extractor itself does
+     * not use it yet — it samples style from the image alone — so today it
+     * only satisfies app/account scoping. Kept here so the wire contract is
+     * consistent and a future media-aware extension has it ready.
+     */
+    application: string;
+};
+export type AiGenExtractStyleResponse = {
+    /**
+     * Palette sampled from the image, keyed by semantic role. The model
+     * returns ONLY the roles it can confidently derive — absent roles are
+     * the client's to fill from its own defaults. Preferred role keys
+     * (the model may add others when clearly present in the image):
+     * background, surface, border, text, text-secondary, text-disabled,
+     * text-on-accent, accent, accent-hover, link, success, warning, error.
+     * Values are the proto ColorSchemeItem (hex + human-readable label).
+     */
+    colorScheme: Record<string, pushwoosh_aibuilder_v1_ColorSchemeItem>;
+    /**
+     * CSS font-family chain for body text inferred from the image's
+     * typographic feel (e.g. "Inter, system-ui, sans-serif"). Empty when
+     * the image gives no clear signal. The exact face can't be identified
+     * from an image — this is a best-effort closest stack.
+     */
+    fontFamily: string;
+    /**
+     * CSS font-family chain for headings. Empty when no clear signal or
+     * when it matches font_family.
+     */
+    headingFontFamily: string;
+    /**
+     * Short free-text description of the typographic character (e.g.
+     * "geometric sans, heavy display headings, generous tracking") for
+     * downstream use such as RenderHtml. Empty when not determinable.
+     */
+    typographyNotes: string;
+};