@pushwoosh/rpc-gateway-ai-assistant 0.1.124 → 0.1.126

package/data.js

@@ -6,7 +6,17 @@ export const data = {
         "values": [
             "DOCUMENT_BLOCK_TYPE_UNSPECIFIED",
             "DOCUMENT_BLOCK_TYPE_CARD",
-            "DOCUMENT_BLOCK_TYPE_COLUMNS"
+            "DOCUMENT_BLOCK_TYPE_COLUMNS",
+            "DOCUMENT_BLOCK_TYPE_CONTENT",
+            "DOCUMENT_BLOCK_TYPE_GROUP"
+        ]
+    },
+    "pushwoosh.aibuilder.v1.GroupDirection": {
+        "type": "E",
+        "values": [
+            "GROUP_DIRECTION_UNSPECIFIED",
+            "GROUP_DIRECTION_VERTICAL",
+            "GROUP_DIRECTION_HORIZONTAL"
         ]
     },
     "pushwoosh.aibuilder.v1.CardLayout": {
@@ -29,6 +39,15 @@ export const data = {
             "BUTTON_GROUP_ALIGN_RIGHT"
         ]
     },
+    "pushwoosh.aibuilder.v1.GroupAlign": {
+        "type": "E",
+        "values": [
+            "GROUP_ALIGN_UNSPECIFIED",
+            "GROUP_ALIGN_START",
+            "GROUP_ALIGN_CENTER",
+            "GROUP_ALIGN_END"
+        ]
+    },
     "pushwoosh.aibuilder.v1.CardImageFit": {
         "type": "E",
         "values": [
@@ -84,16 +103,20 @@ export const data = {
         "type": "I",
         "fields": {
             "backgroundColor": {
-                "type": "string"
+                "type": "string",
+                "optional": true
             },
             "borderColor": {
-                "type": "string"
+                "type": "string",
+                "optional": true
             },
             "borderWidth": {
-                "type": "number"
+                "type": "number",
+                "optional": true
             },
             "borderRadius": {
-                "type": "number"
+                "type": "number",
+                "optional": true
             }
         }
     },
@@ -415,6 +438,29 @@ export const data = {
             }
         }
     },
+    "pushwoosh.aibuilder.v1.AiBuilderGroup": {
+        "type": "I",
+        "fields": {
+            "direction": {
+                "type": "pushwoosh.aibuilder.v1.GroupDirection"
+            },
+            "margin": {
+                "type": "pushwoosh.aibuilder.v1.EdgeInsets",
+                "optional": true
+            },
+            "padding": {
+                "type": "pushwoosh.aibuilder.v1.EdgeInsets",
+                "optional": true
+            },
+            "gap": {
+                "type": "number",
+                "optional": true
+            },
+            "align": {
+                "type": "pushwoosh.aibuilder.v1.GroupAlign"
+            }
+        }
+    },
     "pushwoosh.aibuilder.v1.AiBuilderBlock": {
         "type": "I",
         "fields": {
@@ -427,16 +473,27 @@ export const data = {
             "columns": {
                 "type": "pushwoosh.aibuilder.v1.AiBuilderColumns"
             },
+            "content": {
+                "type": "pushwoosh.aibuilder.v1.Content"
+            },
+            "group": {
+                "type": "pushwoosh.aibuilder.v1.AiBuilderGroup"
+            },
             "styles": {
                 "type": "pushwoosh.aibuilder.v1.BlockStyles",
                 "optional": true
+            },
+            "parentId": {
+                "type": "string"
             }
         },
         "oneofs": {
             "block": {
                 "oneof": [
                     "card",
-                    "columns"
+                    "columns",
+                    "content",
+                    "group"
                 ]
             }
         }
@@ -444,16 +501,75 @@ export const data = {
     "pushwoosh.aibuilder.v1.Meta": {
         "type": "I",
         "fields": {
-            "emailSubject": {
+            "templateName": {
+                "type": "string"
+            }
+        }
+    },
+    "pushwoosh.aibuilder.v1.EmailSettings": {
+        "type": "I",
+        "fields": {
+            "subject": {
                 "type": "string",
                 "optional": true
             },
-            "emailPreheader": {
+            "preheader": {
                 "type": "string",
                 "optional": true
+            }
+        }
+    },
+    "pushwoosh.aibuilder.v1.PopupAnimation": {
+        "type": "E",
+        "values": [
+            "POPUP_ANIMATION_UNSPECIFIED",
+            "POPUP_ANIMATION_NONE",
+            "POPUP_ANIMATION_FADE",
+            "POPUP_ANIMATION_SLIDE"
+        ]
+    },
+    "pushwoosh.aibuilder.v1.PopupOverlay": {
+        "type": "I",
+        "fields": {
+            "color": {
+                "type": "string"
             },
-            "templateName": {
+            "opacity": {
+                "type": "number"
+            }
+        }
+    },
+    "pushwoosh.aibuilder.v1.PopupSettings": {
+        "type": "I",
+        "fields": {
+            "borderRadius": {
+                "type": "number"
+            },
+            "boxShadow": {
                 "type": "string"
+            },
+            "overlay": {
+                "type": "pushwoosh.aibuilder.v1.PopupOverlay",
+                "optional": true
+            },
+            "animation": {
+                "type": "pushwoosh.aibuilder.v1.PopupAnimation"
+            },
+            "top": {
+                "type": "number",
+                "optional": true
+            },
+            "bottom": {
+                "type": "number",
+                "optional": true
+            },
+            "left": {
+                "type": "number",
+                "optional": true
+            },
+            "right": {
+                "type": "number",
+                "optional": true
             }
         }
     },
@@ -489,6 +605,14 @@ export const data = {
             },
             "meta": {
                 "type": "pushwoosh.aibuilder.v1.Meta"
+            },
+            "emailSettings": {
+                "type": "pushwoosh.aibuilder.v1.EmailSettings",
+                "optional": true
+            },
+            "popupSettings": {
+                "type": "pushwoosh.aibuilder.v1.PopupSettings",
+                "optional": true
             }
         }
     },
@@ -510,7 +634,18 @@ export const data = {
         "values": [
             "AI_GEN_BLOCK_TYPE_HINT_UNSPECIFIED",
             "AI_GEN_BLOCK_TYPE_HINT_CARD",
-            "AI_GEN_BLOCK_TYPE_HINT_COLUMNS"
+            "AI_GEN_BLOCK_TYPE_HINT_COLUMNS",
+            "AI_GEN_BLOCK_TYPE_HINT_CONTENT",
+            "AI_GEN_BLOCK_TYPE_HINT_GROUP"
+        ]
+    },
+    "pushwoosh.aigen.v1.AiGenMode": {
+        "type": "E",
+        "values": [
+            "AI_GEN_MODE_UNSPECIFIED",
+            "AI_GEN_MODE_EMAIL",
+            "AI_GEN_MODE_FULL",
+            "AI_GEN_MODE_WEB_POPUP"
         ]
     },
     "pushwoosh.aigen.v1.AiGenBlockPath": {
@@ -557,6 +692,9 @@ export const data = {
             "addBlock": {
                 "type": "pushwoosh.aigen.v1.AiGenAddBlock",
                 "optional": true
+            },
+            "mode": {
+                "type": "pushwoosh.aigen.v1.AiGenMode"
             }
         }
     },
@@ -573,6 +711,9 @@ export const data = {
             },
             "typeHint": {
                 "type": "pushwoosh.aigen.v1.AiGenBlockTypeHint"
+            },
+            "parentId": {
+                "type": "string"
             }
         }
     },
@@ -588,6 +729,9 @@ export const data = {
             },
             "prompt": {
                 "type": "string"
+            },
+            "parentId": {
+                "type": "string"
             }
         }
     },
@@ -616,6 +760,9 @@ export const data = {
             "afterPath": {
                 "type": "string",
                 "array": true
+            },
+            "parentId": {
+                "type": "string"
             }
         }
     },
@@ -631,6 +778,9 @@ export const data = {
             },
             "prompt": {
                 "type": "string"
+            },
+            "parentId": {
+                "type": "string"
             }
         }
     },
@@ -663,14 +813,20 @@ export const data = {
             }
         }
     },
-    "pushwoosh.aigen.v1.AiGenBlockColors": {
+    "pushwoosh.aigen.v1.AiGenBlockStyles": {
         "type": "I",
         "fields": {
             "backgroundColor": {
-                "type": "string"
+                "type": "string",
+                "optional": true
             },
             "borderColor": {
-                "type": "string"
+                "type": "string",
+                "optional": true
+            },
+            "borderRadius": {
+                "type": "number",
+                "optional": true
             }
         }
     },
@@ -731,6 +887,14 @@ export const data = {
             }
         }
     },
+    "pushwoosh.aigen.v1.AiGenGroup": {
+        "type": "I",
+        "fields": {
+            "direction": {
+                "type": "pushwoosh.aibuilder.v1.GroupDirection"
+            }
+        }
+    },
     "pushwoosh.aigen.v1.AiGenBlock": {
         "type": "I",
         "fields": {
@@ -740,8 +904,14 @@ export const data = {
             "columns": {
                 "type": "pushwoosh.aigen.v1.AiGenColumns"
             },
+            "content": {
+                "type": "pushwoosh.aibuilder.v1.Content"
+            },
+            "group": {
+                "type": "pushwoosh.aigen.v1.AiGenGroup"
+            },
             "styles": {
-                "type": "pushwoosh.aigen.v1.AiGenBlockColors",
+                "type": "pushwoosh.aigen.v1.AiGenBlockStyles",
                 "optional": true
             }
         },
@@ -749,7 +919,9 @@ export const data = {
             "block": {
                 "oneof": [
                     "card",
-                    "columns"
+                    "columns",
+                    "content",
+                    "group"
                 ]
             }
         }
@@ -950,6 +1122,12 @@ export const data = {
             },
             "isOnboarding": {
                 "type": "boolean"
+            },
+            "onboardingCompletedAt": {
+                "type": "Date"
+            },
+            "handoffChildChatId": {
+                "type": "number"
             }
         }
     },
@@ -1262,6 +1440,22 @@ export const data = {
             }
         }
     },
+    "pushwoosh.accounts.assistant.v1.CompleteOnboardingHandoffRequest": {
+        "type": "I",
+        "fields": {
+            "chatId": {
+                "type": "number"
+            }
+        }
+    },
+    "pushwoosh.accounts.assistant.v1.CompleteOnboardingHandoffResponse": {
+        "type": "I",
+        "fields": {
+            "chat": {
+                "type": "pushwoosh.accounts.assistant.v1.Chat"
+            }
+        }
+    },
     "pushwoosh.accounts.assistant.v1.AssistantService": {
         "type": "S",
         "key": "assistant",
@@ -1360,6 +1554,12 @@ export const data = {
                 "method": "post",
                 "path": "/api/v1/chats/{chat_id}/onboarding/intro",
                 "serverStreaming": true
+            },
+            "CompleteOnboardingHandoff": {
+                "request": "pushwoosh.accounts.assistant.v1.CompleteOnboardingHandoffRequest",
+                "response": "pushwoosh.accounts.assistant.v1.CompleteOnboardingHandoffResponse",
+                "method": "post",
+                "path": "/api/v1/chats/{chat_id}/onboarding/handoff"
             }
         }
     }

package/package.json

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

package/pushwoosh_accounts_assistant_v1.d.ts

@@ -41,9 +41,26 @@ export type Chat = {
     /**
      * is_onboarding flags this chat as the account's onboarding chat.
      * Frontend uses it to decide whether to call StreamOnboardingIntro on the
-     * first turn and may render the chat with onboarding-specific UI.
+     * first turn and may render the chat with onboarding-specific UI. Inference
+     * for onboarding chats is routed exclusively to StreamInferenceLLM — other
+     * StreamInference* endpoints are not used while is_onboarding=true.
      */
     isOnboarding: boolean;
+    /**
+     * onboarding_completed_at is set on the onboarding chat the moment the
+     * agent invokes the complete_onboarding tool. Frontend polls this field
+     * after each StreamInferenceLLM turn (and on chat reload) to detect that
+     * the agent has signalled completion and the handoff to a regular chat
+     * should be triggered via CompleteOnboardingHandoff.
+     */
+    onboardingCompletedAt: Date;
+    /**
+     * handoff_child_chat_id, on the onboarding chat, stores the id of the
+     * regular chat created by CompleteOnboardingHandoff. Non-zero means
+     * the handoff has already been performed — repeated calls are idempotent
+     * and return that chat. Zero means no handoff yet.
+     */
+    handoffChildChatId: number;
 };
 /** CreateChatRequest for creating a new chat */
 export type CreateChatRequest = {
@@ -195,6 +212,24 @@ export type CheckUsageAllowedResponse = {
 export type OnboardingIntroRequest = {
     chatId: number;
 };
+/**
+ * CompleteOnboardingHandoffRequest performs the transition from a completed
+ * onboarding chat to a fresh regular chat. The referenced chat must be the
+ * account's onboarding chat with onboarding_completed_at already set by the
+ * agent's complete_onboarding tool call. Idempotent: subsequent calls return
+ * the same regular chat that the first call created.
+ */
+export type CompleteOnboardingHandoffRequest = {
+    chatId: number;
+};
+/**
+ * CompleteOnboardingHandoffResponse returns the regular chat that should
+ * host the rest of the conversation. The chat carries the handoff summary
+ * in its system context — frontend can navigate to it directly.
+ */
+export type CompleteOnboardingHandoffResponse = {
+    chat: Chat;
+};
 export type AssistantService_CreateChat = RpcMethod<CreateChatRequest, CreateChatResponse>;
 export type AssistantService_GetChat = RpcMethod<GetChatRequest, GetChatResponse>;
 export type AssistantService_GetAllChats = RpcMethod<GetAllChatsRequest, GetAllChatsResponse>;
@@ -205,6 +240,7 @@ export type AssistantService_GetConsent = RpcMethod<GetConsentRequest, GetConsen
 export type AssistantService_GiveConsent = RpcMethod<GiveConsentRequest, GiveConsentResponse>;
 export type AssistantService_CompactifyContext = RpcMethod<CompactifyContextRequest, CompactifyContextResponse>;
 export type AssistantService_CheckUsageAllowed = RpcMethod<CheckUsageAllowedRequest, CheckUsageAllowedResponse>;
+export type AssistantService_CompleteOnboardingHandoff = RpcMethod<CompleteOnboardingHandoffRequest, CompleteOnboardingHandoffResponse>;
 export interface AssistantService {
     /** Create a new chat */
     CreateChat: AssistantService_CreateChat;
@@ -228,6 +264,11 @@ export interface AssistantService {
     StreamInferenceChatGPT(request: InferenceRequest, options?: {
         signal?: AbortSignal;
     }): Promise<AsyncIterable<InferenceResponse>>;
+    /**
+     * StreamInferenceLLM is the self-hosted LLM (Qwen) inference endpoint.
+     * Frontend routes onboarding chats (is_onboarding=true) here exclusively;
+     * other StreamInference* endpoints are reserved for regular chats.
+     */
     StreamInferenceLLM(request: InferenceRequest, options?: {
         signal?: AbortSignal;
     }): Promise<AsyncIterable<InferenceResponse>>;
@@ -245,4 +286,13 @@ export interface AssistantService {
     StreamOnboardingIntro(request: OnboardingIntroRequest, options?: {
         signal?: AbortSignal;
     }): Promise<AsyncIterable<InferenceResponse>>;
+    /**
+     * CompleteOnboardingHandoff atomically creates the regular chat that
+     * succeeds a completed onboarding chat and copies the agent's handoff
+     * summary into it. Idempotent: a second call returns the same regular
+     * chat. Frontend calls this after detecting onboarding_completed_at on
+     * the onboarding chat (either right after a StreamInferenceLLM turn or
+     * on chat reload).
+     */
+    CompleteOnboardingHandoff: AssistantService_CompleteOnboardingHandoff;
 }

package/pushwoosh_aibuilder_v1.d.ts

@@ -1,6 +1,37 @@
-export type DocumentBlockType = 'DOCUMENT_BLOCK_TYPE_UNSPECIFIED' | 'DOCUMENT_BLOCK_TYPE_CARD' | 'DOCUMENT_BLOCK_TYPE_COLUMNS';
+export type DocumentBlockType = 'DOCUMENT_BLOCK_TYPE_UNSPECIFIED' | 'DOCUMENT_BLOCK_TYPE_CARD' | 'DOCUMENT_BLOCK_TYPE_COLUMNS'
+/**
+ * Top-level free-form Content block (text + buttons), no card
+ * framing or image slot. Allowed in WEB_POPUP only.
+ */
+ | 'DOCUMENT_BLOCK_TYPE_CONTENT'
+/**
+ * Structural stack container — a "group" block in the kind registry.
+ * Wire-shape is AiBuilderBlock.group. Allowed in EMAIL and WEB_POPUP.
+ */
+ | 'DOCUMENT_BLOCK_TYPE_GROUP';
+/**
+ * GroupDirection picks which axis an AiBuilderGroup lays its children
+ * along. The planner emits UNSPECIFIED (proto zero) on freshly
+ * generated groups — clients should treat UNSPECIFIED and VERTICAL
+ * identically as a vertical stack. HORIZONTAL is only ever set by the
+ * client (post-generation) when it wants a side-by-side layout; the
+ * backend preserves the client's choice across edits. The enum lives
+ * at file scope so the same shape is shared between the document
+ * model and the AiGen wire types.
+ */
+export type GroupDirection = 'GROUP_DIRECTION_UNSPECIFIED' | 'GROUP_DIRECTION_VERTICAL' | 'GROUP_DIRECTION_HORIZONTAL';
 export type CardLayout = 'CARD_LAYOUT_UNSPECIFIED' | 'CARD_LAYOUT_RIGHT' | 'CARD_LAYOUT_LEFT' | 'CARD_LAYOUT_TOP' | 'CARD_LAYOUT_NO' | 'CARD_LAYOUT_BACKGROUND';
 export type ButtonGroupAlign = 'BUTTON_GROUP_ALIGN_UNSPECIFIED' | 'BUTTON_GROUP_ALIGN_LEFT' | 'BUTTON_GROUP_ALIGN_CENTER' | 'BUTTON_GROUP_ALIGN_RIGHT';
+/**
+ * GroupAlign controls alignment of an AiBuilderGroup's children along
+ * the perpendicular axis (for direction=VERTICAL → horizontal
+ * alignment of children; for direction=HORIZONTAL → vertical
+ * alignment). UNSPECIFIED is the proto zero value and clients should
+ * render it as START — same client-managed pattern as GroupDirection.
+ * Named in start/center/end terms (not left/right) because the
+ * concrete axis depends on direction.
+ */
+export type GroupAlign = 'GROUP_ALIGN_UNSPECIFIED' | 'GROUP_ALIGN_START' | 'GROUP_ALIGN_CENTER' | 'GROUP_ALIGN_END';
 /**
  * CardImageFit controls how the card's image fills its image slot.
  * Why it exists: card slots have fixed proportions while images arrive
@@ -34,11 +65,50 @@ export type EdgeInsets = {
     bottom: number;
     left: number;
 };
+/**
+ * BlockStyles is the universal per-block visual override applied at
+ * the AiBuilderBlock level — independent of the concrete block kind.
+ * Every block kind (card, columns, group, and any future kind we add)
+ * carries it through AiBuilderBlock.styles; the client renders the
+ * frame, the LLM emits the colour overrides, and the user adjusts the
+ * rest in the editor. Per-kind layout knobs (CardStyles padding,
+ * ColumnsStyles gap, …) live on their own messages and stay
+ * independent of this one.
+ *
+ * All fields are optional. An unset field means "inherit / no
+ * override" — the client falls back to DocumentSettings.default_styles
+ * and then to its renderer default.
+ *
+ * Tri-state semantics differ between string and numeric fields:
+ * - String fields (background_color, border_color): empty string ""
+ * is equivalent to unset — clients collapse both to "inherit".
+ * Backend should emit unset rather than ""; do not rely on "" as
+ * an "explicit reset" state for colours.
+ * - Numeric fields (border_width, border_radius): explicit 0 is
+ * distinct from unset (means "no border" / "sharp corners") and
+ * is preserved across edits.
+ *
+ * LLM-managed: background_color, border_color, border_radius — the
+ * block generator may emit these via AiGenBlockStyles and the
+ * pipeline lifts them into BlockStyles.
+ * Client-managed: border_width — the LLM never sees it, the backend
+ * preserves it verbatim across edits.
+ */
 export type BlockStyles = {
-    backgroundColor: string;
-    borderColor: string;
-    borderWidth: number;
-    borderRadius: number;
+    /**
+     * Empty string "" is treated as unset by clients. Prefer emitting
+     * unset.
+     */
+    backgroundColor?: string;
+    /**
+     * Empty string "" is treated as unset by clients. Prefer emitting
+     * unset.
+     */
+    borderColor?: string;
+    /** Explicit 0 is distinct from unset and preserved. */
+    borderWidth?: number;
+    /** Explicit 0 is distinct from unset and preserved. */
+    borderRadius?: number;
 };
 export type ColumnsStyles = {
     /** Padding applied to each column in the columns block. */
@@ -185,6 +255,37 @@ export type AiBuilderColumn = {
     content: Content;
     width?: string;
 };
+/**
+ * AiBuilderGroup is a structural stack container. Children live as
+ * siblings in the same AiBuilderPage with their parent_id pointing at
+ * this block's id; the group itself has no copy and no image slot.
+ * Allowed in EMAIL and WEB_POPUP.
+ *
+ * direction / align / margin / padding / gap are client-managed: the
+ * LLM never sees them, the backend preserves them across edits. On
+ * freshly generated groups the backend emits proto-zero values
+ * (direction = UNSPECIFIED, align = UNSPECIFIED, optional fields
+ * unset); clients are expected to render UNSPECIFIED direction as a
+ * vertical stack, UNSPECIFIED align as START, and set non-default
+ * values themselves when needed.
+ */
+export type AiBuilderGroup = {
+    direction: GroupDirection;
+    /** Outer spacing around the group block. */
+    margin?: EdgeInsets;
+    /** Inner spacing between the group's frame and its children. */
+    padding?: EdgeInsets;
+    /**
+     * Spacing between adjacent children. UNSPECIFIED (0) lets the
+     * client fall back to its default. Use a non-zero value to override.
+     */
+    gap?: number;
+    /**
+     * Alignment of children along the axis perpendicular to direction.
+     * UNSPECIFIED → render as START.
+     */
+    align: GroupAlign;
+};
 export type AiBuilderBlock_block_card = {
     type: 'card';
     data: AiBuilderCard;
@@ -193,17 +294,106 @@ export type AiBuilderBlock_block_columns = {
     type: 'columns';
     data: AiBuilderColumns;
 };
-export type AiBuilderBlock_block = AiBuilderBlock_block_card | AiBuilderBlock_block_columns;
+export type AiBuilderBlock_block_content = {
+    type: 'content';
+    data: Content;
+};
+export type AiBuilderBlock_block_group = {
+    type: 'group';
+    data: AiBuilderGroup;
+};
+export type AiBuilderBlock_block = AiBuilderBlock_block_card | AiBuilderBlock_block_columns | AiBuilderBlock_block_content | AiBuilderBlock_block_group;
 export type AiBuilderBlock = {
     id: string;
     styles?: BlockStyles;
+    /**
+     * Id of the block-of-this-page that contains this one. Empty string
+     * marks a top-level block. The parent (if set) must be a container
+     * kind in the same AiBuilderPage. Containers may nest to arbitrary
+     * depth; the server rejects trees deeper than 16 levels with
+     * InvalidArgument (a sanity cap, not a product limit). Per-mode
+     * soft hints in the planner prompt steer the model toward shallower
+     * structures appropriate for each channel.
+     */
+    parentId: string;
     block: AiBuilderBlock_block;
 };
+/**
+ * Meta carries channel-agnostic document-level metadata generated by
+ * the meta generator. Channel-specific fields (email subject /
+ * preheader, future popup-only / inapp-only fields) live in their own
+ * optional sub-messages on AiBuilderDocument (EmailSettings,
+ * PopupSettings, ...) so this message stays small and uniform across
+ * all modes.
+ */
 export type Meta = {
-    emailSubject?: string;
-    emailPreheader?: string;
     templateName: string;
 };
+/**
+ * EmailSettings holds the email-only document-level fields produced by
+ * the meta generator under mode=EMAIL. Populated only when the
+ * document was generated for the email channel; absent otherwise.
+ */
+export type EmailSettings = {
+    subject?: string;
+    preheader?: string;
+};
+/**
+ * PopupAnimation chooses how a web-popup enters / exits the
+ * viewport. UNSPECIFIED leaves the choice to the client default
+ * (typically NONE or FADE). Client-managed: the LLM never selects an
+ * animation.
+ */
+export type PopupAnimation = 'POPUP_ANIMATION_UNSPECIFIED' | 'POPUP_ANIMATION_NONE' | 'POPUP_ANIMATION_FADE' | 'POPUP_ANIMATION_SLIDE';
+/**
+ * PopupOverlay describes the backdrop drawn behind the popup. Both
+ * fields are client-managed; the LLM does not see them.
+ */
+export type PopupOverlay = {
+    /** Hex color, e.g. "#000000". Empty string = no overlay. */
+    color: string;
+    /** 0.0 (fully transparent) to 1.0 (opaque). */
+    opacity: number;
+};
+/**
+ * PopupSettings holds the web-popup channel's client-managed UI
+ * configuration on AiBuilderDocument. Populated by the client (the
+ * editor) and preserved across edits by the server through the same
+ * flow as AiBuilderGroup's client-managed fields: the LLM never sees
+ * these values, server-side conversion never writes to them, the
+ * client owns them end-to-end.
+ */
+export type PopupSettings = {
+    /** Corner radius of the popup container, in px. 0 = sharp corners. */
+    borderRadius: number;
+    /**
+     * CSS box-shadow string, e.g. "0 4px 24px rgba(0,0,0,0.2)". Empty
+     * string = no shadow.
+     */
+    boxShadow: string;
+    /** Backdrop overlay. Absent = no overlay. */
+    overlay?: PopupOverlay;
+    /** Enter / exit animation. UNSPECIFIED = client default. */
+    animation: PopupAnimation;
+    /**
+     * Edge offsets in px (CSS-style positioning). Any subset of
+     * top / bottom / left / right may be set. When none are set the
+     * popup is centered in the viewport. Typical combinations:
+     * - centered:     leave all unset
+     * - bottom-left:  set bottom + left (with the desired gutter)
+     * - top-right:    set top + right
+     * - full-bleed
+     * overlay band: set both top + bottom (and/or left + right);
+     * the client decides how to fill the gap.
+     * Conflicting pairs (top + bottom, left + right) are permitted on
+     * the wire — the client decides whether to stretch the popup
+     * between the two edges or to honour one of them.
+     */
+    top?: number;
+    bottom?: number;
+    left?: number;
+    right?: number;
+};
 /**
  * AiBuilderPage groups a list of blocks under a single logical page. For
  * now every document has exactly one page; the structure is in place so
@@ -221,4 +411,14 @@ export type AiBuilderDocument = {
     textVariants: Record<string, TextVariantStyle>;
     colorScheme: Record<string, ColorSchemeItem>;
     meta: Meta;
+    /**
+     * Email channel-specific fields. Populated only when the document
+     * was generated for mode=EMAIL.
+     */
+    emailSettings?: EmailSettings;
+    /**
+     * Web popup channel-specific fields. Populated only when the
+     * document was generated for mode=WEB_POPUP.
+     */
+    popupSettings?: PopupSettings;
 };

package/pushwoosh_aigen_v1.d.ts

@@ -6,6 +6,7 @@ import { CardLayout as pushwoosh_aibuilder_v1_CardLayout } from './pushwoosh_aib
 import { Image as pushwoosh_aibuilder_v1_Image } from './pushwoosh_aibuilder_v1';
 import { Content as pushwoosh_aibuilder_v1_Content } from './pushwoosh_aibuilder_v1';
 import { CardImageFit as pushwoosh_aibuilder_v1_CardImageFit } from './pushwoosh_aibuilder_v1';
+import { GroupDirection as pushwoosh_aibuilder_v1_GroupDirection } from './pushwoosh_aibuilder_v1';
 /**
  * AiGenService unifies document create / edit / per-block regeneration and
  * targeted block insertion into a single streaming RPC. Dispatch rules:
@@ -31,7 +32,37 @@ export interface AiGenService {
         signal?: AbortSignal;
     }): Promise<AsyncIterable<AiGenEvent>>;
 }
-export type AiGenBlockTypeHint = 'AI_GEN_BLOCK_TYPE_HINT_UNSPECIFIED' | 'AI_GEN_BLOCK_TYPE_HINT_CARD' | 'AI_GEN_BLOCK_TYPE_HINT_COLUMNS';
+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. */
+ | 'AI_GEN_BLOCK_TYPE_HINT_CONTENT'
+/**
+ * Structural stack container ("group"). The block generator is
+ * skipped — groups carry no copy, just children referenced via
+ * parent_id. Allowed in EMAIL and WEB_POPUP.
+ */
+ | 'AI_GEN_BLOCK_TYPE_HINT_GROUP';
+/**
+ * AiGenMode selects the document-domain profile the generation pipeline
+ * runs under: which block kinds are allowed, which Meta fields are
+ * produced, how the system prompts phrase the document type.
+ *
+ * Clients must send a concrete mode on every AiGenRequest. EMAIL is
+ * the email-builder behaviour with a restricted block set and the
+ * email-only meta fields. WEB_POPUP targets web overlay popups: full
+ * block toolkit, popup-tuned prompts, popup-aware image generation.
+ * FULL was a transitional placeholder; it is now deprecated — the
+ * server rejects requests with mode=FULL and clients must move to
+ * WEB_POPUP (or a future concrete channel like INAPP_MOBILE).
+ * UNSPECIFIED is the proto3 zero value and is rejected by the server
+ * with InvalidArgument.
+ */
+export type AiGenMode = 'AI_GEN_MODE_UNSPECIFIED' | 'AI_GEN_MODE_EMAIL'
+/**
+ * Deprecated: kept for wire-compat. The server rejects requests
+ * with this mode (InvalidArgument). Use AI_GEN_MODE_WEB_POPUP for
+ * popups or a future concrete channel for other surfaces.
+ */
+ | 'AI_GEN_MODE_FULL' | 'AI_GEN_MODE_WEB_POPUP';
 /**
  * AiGenBlockPath wraps a block-addressing path so it can appear inside
  * repeated fields — proto3 disallows `repeated repeated`. Path is
@@ -63,6 +94,11 @@ export type AiGenRequest = {
      * with `block_path`. Requires `document`.
      */
     addBlock?: AiGenAddBlock;
+    /**
+     * Document-domain profile for this generation. Required — the server
+     * rejects UNSPECIFIED with InvalidArgument.
+     */
+    mode: AiGenMode;
 };
 /**
  * AiGenAddBlock triggers add-block mode on Generate. The server emits a
@@ -89,6 +125,13 @@ export type AiGenAddBlock = {
      * based on the prompt and surrounding blocks.
      */
     typeHint: AiGenBlockTypeHint;
+    /**
+     * Id of the parent container block in the same page. Empty string =
+     * top-level. The new block becomes a child of that container. The
+     * server rejects parent_id that does not resolve to an existing
+     * container block in `document`.
+     */
+    parentId: string;
 };
 export type AiGenStructureBlock = {
     /** [page_id, block_id] */
@@ -96,6 +139,12 @@ export type AiGenStructureBlock = {
     typeHint: AiGenBlockTypeHint;
     /** per-block prompt for the block generator */
     prompt: string;
+    /**
+     * Id of the parent container block (within the same page). Empty
+     * string marks a top-level block. Set on container kinds' children
+     * so the client can rebuild the tree from the stream.
+     */
+    parentId: string;
 };
 /** Emitted once for create, before any block_delta. */
 export type AiGenStructure = {
@@ -113,12 +162,25 @@ export type AiGenStructureAdd = {
      * same diff (must share `page_id`).
      */
     afterPath: string[];
+    /**
+     * Id of the parent container block. Empty string = top-level. May
+     * reference an existing container or another add from the same diff.
+     * The new block becomes a child of that container (still a sibling in
+     * page.blocks; the tree is rebuilt by group-by-parent on the client).
+     */
+    parentId: string;
 };
 export type AiGenStructureReplace = {
     /** existing block path, preserved */
     blockPath: string[];
     typeHint: AiGenBlockTypeHint;
     prompt: string;
+    /**
+     * Existing parent_id of the replaced block, echoed for completeness
+     * so the client doesn't need a side-table lookup. Replace never moves
+     * a block across containers — for that, the planner emits remove+add.
+     */
+    parentId: string;
 };
 /**
  * Emitted once for edit (when the planner ran), before any block_delta.
@@ -132,9 +194,39 @@ export type AiGenStructureDiff = {
     updateTextVariants: Record<string, pushwoosh_aibuilder_v1_TextVariantStyle>;
     updateColorScheme: Record<string, pushwoosh_aibuilder_v1_ColorSchemeItem>;
 };
-export type AiGenBlockColors = {
-    backgroundColor: string;
-    borderColor: string;
+/**
+ * AiGenBlockStyles is the wire-format subset of BlockStyles the block
+ * generator can emit. Mirrors the LLM-managed fields of BlockStyles
+ * (background_color, border_color, border_radius). Client-managed
+ * fields like border_width are intentionally absent — they belong to
+ * the editor, not the model, and travel with the document, not with
+ * the AiGen stream.
+ *
+ * All fields are optional and follow BlockStyles presence semantics:
+ * - String fields (background_color, border_color): "" ≡ unset
+ * (inherit). The pipeline already normalises empty LLM output to
+ * unset; this documents that clients also collapse the two states.
+ * - Numeric fields (border_radius): explicit 0 is distinct from
+ * unset and preserved.
+ */
+export type AiGenBlockStyles = {
+    /**
+     * Empty string "" is treated as unset by clients. The pipeline
+     * emits unset for empty LLM output.
+     */
+    backgroundColor?: string;
+    /**
+     * Empty string "" is treated as unset by clients. The pipeline
+     * emits unset for empty LLM output.
+     */
+    borderColor?: string;
+    /**
+     * Corner radius in px. Explicit 0 means "sharp corners" and is
+     * distinct from unset (which means "inherit"). Carried through the
+     * stream so the client picks up rounded-corner styling — common
+     * on web popups — without waiting for the next document fetch.
+     */
+    borderRadius?: number;
 };
 export type AiGenCard = {
     layout: pushwoosh_aibuilder_v1_CardLayout;
@@ -154,6 +246,17 @@ export type AiGenColumns = {
     contentBefore?: pushwoosh_aibuilder_v1_Content;
     contentAfter?: pushwoosh_aibuilder_v1_Content;
 };
+/**
+ * AiGenGroup is the wire payload for a "group" container block. The
+ * block generator is skipped for groups; the planner emits the
+ * container's structure and the children come as separate block_delta
+ * events. The direction field on the underlying AiBuilderGroup is
+ * client-managed and not emitted by the planner — AiGenGroup carries
+ * it for symmetry with the document model only.
+ */
+export type AiGenGroup = {
+    direction: pushwoosh_aibuilder_v1_GroupDirection;
+};
 export type AiGenBlock_block_card = {
     type: 'card';
     data: AiGenCard;
@@ -162,13 +265,21 @@ export type AiGenBlock_block_columns = {
     type: 'columns';
     data: AiGenColumns;
 };
-export type AiGenBlock_block = AiGenBlock_block_card | AiGenBlock_block_columns;
+export type AiGenBlock_block_content = {
+    type: 'content';
+    data: pushwoosh_aibuilder_v1_Content;
+};
+export type AiGenBlock_block_group = {
+    type: 'group';
+    data: AiGenGroup;
+};
+export type AiGenBlock_block = AiGenBlock_block_card | AiGenBlock_block_columns | AiGenBlock_block_content | AiGenBlock_block_group;
 /**
  * AiGenBlock is the payload carried by block_delta. The block's own id
  * lives in the enclosing event's `block_path`; the payload is id-less.
  */
 export type AiGenBlock = {
-    styles?: AiGenBlockColors;
+    styles?: AiGenBlockStyles;
     block: AiGenBlock_block;
 };
 /**