@pushwoosh/rpc-gateway-ai-assistant 0.1.110 → 0.1.112

package/data.js

@@ -134,8 +134,7 @@ export const data = {
             "model": {
                 "type": "pushwoosh.aibuilder.v1.LLMProvider"
             }
-        },
-        "oneofs": {}
+        }
     },
     "pushwoosh.aibuilder.v1.BuilderGenerateBlockRequest": {
         "type": "I",
@@ -283,7 +282,7 @@ export const data = {
         "type": "I",
         "fields": {
             "layout": {
-                "type": "pushwoosh.aibuilder.v1.DocumentBlockLayout"
+                "type": "pushwoosh.aibuilder.v1.CardLayout"
             },
             "image": {
                 "type": "pushwoosh.aibuilder.v1.Image",
@@ -291,9 +290,14 @@ export const data = {
             },
             "content": {
                 "type": "pushwoosh.aibuilder.v1.Content"
+            },
+            "imageFit": {
+                "type": "pushwoosh.aibuilder.v1.CardImageFit"
+            },
+            "accentFit": {
+                "type": "boolean"
             }
-        },
-        "oneofs": {}
+        }
     },
     "pushwoosh.aibuilder.v1.BuilderCreateColumns": {
         "type": "I",
@@ -304,6 +308,14 @@ export const data = {
             "columns": {
                 "type": "pushwoosh.aibuilder.v1.BuilderCreateColumn",
                 "array": true
+            },
+            "contentBefore": {
+                "type": "pushwoosh.aibuilder.v1.Content",
+                "optional": true
+            },
+            "contentAfter": {
+                "type": "pushwoosh.aibuilder.v1.Content",
+                "optional": true
             }
         }
     },
@@ -316,9 +328,12 @@ export const data = {
             },
             "content": {
                 "type": "pushwoosh.aibuilder.v1.Content"
+            },
+            "width": {
+                "type": "string",
+                "optional": true
             }
-        },
-        "oneofs": {}
+        }
     },
     "pushwoosh.aibuilder.v1.BuilderCreateStreamEvent": {
         "type": "I",
@@ -439,15 +454,33 @@ export const data = {
             "DOCUMENT_BLOCK_TYPE_COLUMNS"
         ]
     },
-    "pushwoosh.aibuilder.v1.DocumentBlockLayout": {
+    "pushwoosh.aibuilder.v1.CardLayout": {
+        "type": "E",
+        "values": [
+            "CARD_LAYOUT_UNSPECIFIED",
+            "CARD_LAYOUT_RIGHT",
+            "CARD_LAYOUT_LEFT",
+            "CARD_LAYOUT_TOP",
+            "CARD_LAYOUT_NO",
+            "CARD_LAYOUT_BACKGROUND"
+        ]
+    },
+    "pushwoosh.aibuilder.v1.ButtonGroupAlign": {
+        "type": "E",
+        "values": [
+            "BUTTON_GROUP_ALIGN_UNSPECIFIED",
+            "BUTTON_GROUP_ALIGN_LEFT",
+            "BUTTON_GROUP_ALIGN_CENTER",
+            "BUTTON_GROUP_ALIGN_RIGHT"
+        ]
+    },
+    "pushwoosh.aibuilder.v1.CardImageFit": {
         "type": "E",
         "values": [
-            "DOCUMENT_BLOCK_LAYOUT_UNSPECIFIED",
-            "DOCUMENT_BLOCK_LAYOUT_RIGHT",
-            "DOCUMENT_BLOCK_LAYOUT_LEFT",
-            "DOCUMENT_BLOCK_LAYOUT_TOP",
-            "DOCUMENT_BLOCK_LAYOUT_NO",
-            "DOCUMENT_BLOCK_LAYOUT_BACKGROUND"
+            "CARD_IMAGE_FIT_UNSPECIFIED",
+            "CARD_IMAGE_FIT_COVER",
+            "CARD_IMAGE_FIT_CONTAIN",
+            "CARD_IMAGE_FIT_FILL"
         ]
     },
     "pushwoosh.aibuilder.v1.TextVariantStyle": {
@@ -495,9 +528,6 @@ export const data = {
     "pushwoosh.aibuilder.v1.BlockStyles": {
         "type": "I",
         "fields": {
-            "padding": {
-                "type": "pushwoosh.aibuilder.v1.EdgeInsets"
-            },
             "backgroundColor": {
                 "type": "string"
             },
@@ -522,19 +552,25 @@ export const data = {
             "gap": {
                 "type": "number",
                 "optional": true
+            },
+            "padding": {
+                "type": "pushwoosh.aibuilder.v1.EdgeInsets",
+                "optional": true
             }
-        },
-        "oneofs": {}
+        }
     },
     "pushwoosh.aibuilder.v1.CardStyles": {
         "type": "I",
         "fields": {
-            "imageGap": {
-                "type": "number",
+            "accentFitPadding": {
+                "type": "pushwoosh.aibuilder.v1.EdgeInsets",
+                "optional": true
+            },
+            "contentPadding": {
+                "type": "pushwoosh.aibuilder.v1.EdgeInsets",
                 "optional": true
             }
-        },
-        "oneofs": {}
+        }
     },
     "pushwoosh.aibuilder.v1.DefaultStyles": {
         "type": "I",
@@ -626,8 +662,7 @@ export const data = {
                 "type": "pushwoosh.aibuilder.v1.ButtonStyles",
                 "optional": true
             }
-        },
-        "oneofs": {}
+        }
     },
     "pushwoosh.aibuilder.v1.ButtonStyles": {
         "type": "I",
@@ -656,8 +691,7 @@ export const data = {
                 "type": "number",
                 "optional": true
             }
-        },
-        "oneofs": {}
+        }
     },
     "pushwoosh.aibuilder.v1.ButtonGroup": {
         "type": "I",
@@ -669,9 +703,11 @@ export const data = {
             "styles": {
                 "type": "pushwoosh.aibuilder.v1.ButtonGroupStyles",
                 "optional": true
+            },
+            "align": {
+                "type": "pushwoosh.aibuilder.v1.ButtonGroupAlign"
             }
-        },
-        "oneofs": {}
+        }
     },
     "pushwoosh.aibuilder.v1.ButtonGroupStyles": {
         "type": "I",
@@ -688,8 +724,7 @@ export const data = {
                 "type": "number",
                 "optional": true
             }
-        },
-        "oneofs": {}
+        }
     },
     "pushwoosh.aibuilder.v1.ContentItem": {
         "type": "I",
@@ -720,9 +755,16 @@ export const data = {
             "textPrompt": {
                 "type": "string",
                 "optional": true
+            },
+            "margin": {
+                "type": "pushwoosh.aibuilder.v1.EdgeInsets",
+                "optional": true
+            },
+            "padding": {
+                "type": "pushwoosh.aibuilder.v1.EdgeInsets",
+                "optional": true
             }
-        },
-        "oneofs": {}
+        }
     },
     "pushwoosh.aibuilder.v1.Image": {
         "type": "I",
@@ -757,7 +799,7 @@ export const data = {
         "type": "I",
         "fields": {
             "layout": {
-                "type": "pushwoosh.aibuilder.v1.DocumentBlockLayout"
+                "type": "pushwoosh.aibuilder.v1.CardLayout"
             },
             "image": {
                 "type": "pushwoosh.aibuilder.v1.Image",
@@ -769,9 +811,14 @@ export const data = {
             "styles": {
                 "type": "pushwoosh.aibuilder.v1.CardStyles",
                 "optional": true
+            },
+            "imageFit": {
+                "type": "pushwoosh.aibuilder.v1.CardImageFit"
+            },
+            "accentFit": {
+                "type": "boolean"
             }
-        },
-        "oneofs": {}
+        }
     },
     "pushwoosh.aibuilder.v1.AiBuilderColumns": {
         "type": "I",
@@ -786,9 +833,16 @@ export const data = {
             },
             "withImages": {
                 "type": "boolean"
+            },
+            "contentBefore": {
+                "type": "pushwoosh.aibuilder.v1.Content",
+                "optional": true
+            },
+            "contentAfter": {
+                "type": "pushwoosh.aibuilder.v1.Content",
+                "optional": true
             }
-        },
-        "oneofs": {}
+        }
     },
     "pushwoosh.aibuilder.v1.AiBuilderColumn": {
         "type": "I",
@@ -799,9 +853,12 @@ export const data = {
             },
             "content": {
                 "type": "pushwoosh.aibuilder.v1.Content"
+            },
+            "width": {
+                "type": "string",
+                "optional": true
             }
-        },
-        "oneofs": {}
+        }
     },
     "pushwoosh.aibuilder.v1.AiBuilderBlock": {
         "type": "I",

package/package.json

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

package/pushwoosh_accounts_assistant_v1.d.ts

@@ -1,5 +1,13 @@
 import { RpcMethod } from './commonTypes';
-export type Role = 'ROLE_UNSPECIFIED' | 'ROLE_USER' | 'ROLE_ASSISTANT' | 'ROLE_TOOL_REQUEST' | 'ROLE_TOOL_USE_RESPONSE' | 'ROLE_CONTEXT_COMPACTIFIED';
+/** Role represents the sender of a message */
+export type Role = 'ROLE_UNSPECIFIED' | 'ROLE_USER' | 'ROLE_ASSISTANT'
+/** Assistant message with tool calls (renamed for DB limit) */
+ | 'ROLE_TOOL_REQUEST'
+/** Function/tool response */
+ | 'ROLE_TOOL_USE_RESPONSE'
+/** Compactified context summary */
+ | 'ROLE_CONTEXT_COMPACTIFIED';
+/** Message represents a single message in a chat */
 export type Message = {
     id: number;
     content: string;
@@ -7,6 +15,7 @@ export type Message = {
     timestamp: Date;
     usage: UsageInfo;
 };
+/** Chat represents a conversation with its metadata and messages */
 export type Chat = {
     id: number;
     title: string;
@@ -14,62 +23,87 @@ export type Chat = {
     createdAt: Date;
     updatedAt: Date;
 };
+/** CreateChatRequest for creating a new chat */
 export type CreateChatRequest = {
     application: string;
     title: string;
 };
+/** CreateChatResponse returns the created chat */
 export type CreateChatResponse = {
     chat: Chat;
 };
+/** GetChatRequest for retrieving a specific chat */
 export type GetChatRequest = {
     application: string;
     chatId: number;
 };
+/** GetChatResponse returns the requested chat */
 export type GetChatResponse = {
     chat: Chat;
 };
+/** GetAllChatsRequest for retrieving all chats */
 export type GetAllChatsRequest = {
     application: string;
 };
+/** GetAllChatsResponse returns all chats sorted by updated_at */
 export type GetAllChatsResponse = {
     chats: Chat[];
 };
+/** UpdateChatTitleRequest for updating a chat's title */
 export type UpdateChatTitleRequest = {
     chatId: number;
     title: string;
 };
+/** UpdateChatTitleResponse confirms the update */
 export type UpdateChatTitleResponse = {};
+/** DeleteChatRequest for deleting a chat */
 export type DeleteChatRequest = {
     application: string;
     id: number;
 };
+/** DeleteChatResponse confirms the deletion */
 export type DeleteChatResponse = {
     success: boolean;
 };
+/** ClearChatRequest for clearing all messages from a chat */
 export type ClearChatRequest = {
     application: string;
     id: number;
 };
+/** ClearChatResponse confirms the clearing */
 export type ClearChatResponse = {
     success: boolean;
 };
+/** FileAttachment represents a file uploaded by the user */
 export type FileAttachment = {
     filename: string;
+    /** MIME type (e.g., "application/pdf") */
     type: string;
+    /** Base64-encoded file content */
     base64: string;
 };
+/** InferenceRequest for streaming AI inference */
 export type InferenceRequest = {
     chatId: number;
+    /** User message content to be added before inference */
     message: string;
+    /** Optional URL for context */
     url: string;
+    /** Optional file attachments */
     attachments: FileAttachment[];
+    /** Optional custom system prompt to add to the inference */
     customSystemPrompt: string;
 };
-export type StreamEventType = 'STREAM_EVENT_UNSPECIFIED' | 'STREAM_EVENT_MESSAGE_START' | 'STREAM_EVENT_CONTENT_BLOCK_START' | 'STREAM_EVENT_TEXT_START' | 'STREAM_EVENT_TEXT_DELTA' | 'STREAM_EVENT_TOOL_USE_START' | 'STREAM_EVENT_CONTENT_BLOCK_STOP' | 'STREAM_EVENT_MESSAGE_DELTA' | 'STREAM_EVENT_MESSAGE_STOP' | 'STREAM_EVENT_ERROR' | 'STREAM_EVENT_TOOL_USE_RESULT' | 'STREAM_EVENT_TOOL_USE_DELTA' | 'STREAM_EVENT_THINKING_DELTA';
+/** StreamingEvent types */
+export type StreamEventType = 'STREAM_EVENT_UNSPECIFIED' | 'STREAM_EVENT_MESSAGE_START' | 'STREAM_EVENT_CONTENT_BLOCK_START' | 'STREAM_EVENT_TEXT_START' | 'STREAM_EVENT_TEXT_DELTA' | 'STREAM_EVENT_TOOL_USE_START' | 'STREAM_EVENT_CONTENT_BLOCK_STOP' | 'STREAM_EVENT_MESSAGE_DELTA' | 'STREAM_EVENT_MESSAGE_STOP' | 'STREAM_EVENT_ERROR' | 'STREAM_EVENT_TOOL_USE_RESULT' | 'STREAM_EVENT_TOOL_USE_DELTA'
+/** Chain of Thoughts thinking content */
+ | 'STREAM_EVENT_THINKING_DELTA';
+/** Tool information for tool use events */
 export type ToolInfo = {
     name: string;
     args: string;
 };
+/** Usage information for token consumption tracking */
 export type UsageInfo = {
     inputTokens: number;
     outputTokens: number;
@@ -78,6 +112,7 @@ export type UsageInfo = {
     totalTokens: number;
     percentage: number;
 };
+/** InferenceResponse for streaming AI responses */
 export type InferenceResponse = {
     type: StreamEventType;
     content: string;
@@ -98,17 +133,22 @@ export type GiveConsentRequest = {
     consentGiven: boolean;
 };
 export type GiveConsentResponse = {};
+/** CompactifyContextRequest for compactifying chat context */
 export type CompactifyContextRequest = {
     application: string;
     chatId: number;
 };
+/** CompactifyContextResponse returns success status */
 export type CompactifyContextResponse = {
     success: boolean;
+    /** The compactified summary */
     compactifiedContent: string;
 };
+/** CheckUsageAllowedRequest for checking if AI usage is allowed */
 export type CheckUsageAllowedRequest = {
     application: string;
 };
+/** CheckUsageAllowedResponse returns whether usage is allowed */
 export type CheckUsageAllowedResponse = {
     allowed: boolean;
     reason: string;
@@ -124,12 +164,19 @@ export type AssistantService_GiveConsent = RpcMethod<GiveConsentRequest, GiveCon
 export type AssistantService_CompactifyContext = RpcMethod<CompactifyContextRequest, CompactifyContextResponse>;
 export type AssistantService_CheckUsageAllowed = RpcMethod<CheckUsageAllowedRequest, CheckUsageAllowedResponse>;
 export interface AssistantService {
+    /** Create a new chat */
     CreateChat: AssistantService_CreateChat;
+    /** Get a specific chat by ID */
     GetChat: AssistantService_GetChat;
+    /** Get all chats sorted by updated_at descending */
     GetAllChats: AssistantService_GetAllChats;
+    /** Update a chat's title */
     UpdateChatTitle: AssistantService_UpdateChatTitle;
+    /** Delete a chat */
     DeleteChat: AssistantService_DeleteChat;
+    /** Clear all messages from a chat */
     ClearChat: AssistantService_ClearChat;
+    /** Stream AI inference responses */
     StreamInference(request: InferenceRequest, options?: {
         signal?: AbortSignal;
     }): Promise<AsyncIterable<InferenceResponse>>;

package/pushwoosh_aibuilder_v1.d.ts

@@ -110,17 +110,26 @@ export type BuilderCreateDocumentBlock = {
     block: BuilderCreateDocumentBlock_block;
 };
 export type BuilderCreateCard = {
-    layout: DocumentBlockLayout;
+    layout: CardLayout;
     image?: Image;
     content: Content;
+    /** Mirrors AiBuilderCard.image_fit for the streamed Create/Update output. */
+    imageFit: CardImageFit;
+    /** Mirrors AiBuilderCard.accent_fit; only meaningful for LEFT / RIGHT layouts. */
+    accentFit: boolean;
 };
 export type BuilderCreateColumns = {
     withImages: boolean;
     columns: BuilderCreateColumn[];
+    /** Content rendered above the columns row. */
+    contentBefore?: Content;
+    /** Content rendered below the columns row. */
+    contentAfter?: Content;
 };
 export type BuilderCreateColumn = {
     image?: Image;
     content: Content;
+    width?: string;
 };
 export type BuilderCreateStreamEvent_event_structure = {
     type: 'structure';
@@ -183,7 +192,26 @@ export type BuilderCreateButtonGroupDelta = {
     buttonGroup: ButtonGroup;
 };
 export type DocumentBlockType = 'DOCUMENT_BLOCK_TYPE_UNSPECIFIED' | 'DOCUMENT_BLOCK_TYPE_CARD' | 'DOCUMENT_BLOCK_TYPE_COLUMNS';
-export type DocumentBlockLayout = 'DOCUMENT_BLOCK_LAYOUT_UNSPECIFIED' | 'DOCUMENT_BLOCK_LAYOUT_RIGHT' | 'DOCUMENT_BLOCK_LAYOUT_LEFT' | 'DOCUMENT_BLOCK_LAYOUT_TOP' | 'DOCUMENT_BLOCK_LAYOUT_NO' | 'DOCUMENT_BLOCK_LAYOUT_BACKGROUND';
+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';
+/**
+ * CardImageFit controls how the card's image fills its image slot.
+ * Why it exists: card slots have fixed proportions while images arrive
+ * with arbitrary aspect ratios. Without this knob the client would have
+ * to pick a single global default and some cards would always look bad.
+ * A product photo is fine with COVER, a company logo must be CONTAIN
+ * or it gets cropped.
+ */
+export type CardImageFit = 'CARD_IMAGE_FIT_UNSPECIFIED'
+/** Fill the slot, cropping overflow. Good default for photos. */
+ | 'CARD_IMAGE_FIT_COVER'
+/**
+ * Fit entirely inside the slot, may leave padding. Required for logos
+ * and other assets that must not be cropped.
+ */
+ | 'CARD_IMAGE_FIT_CONTAIN'
+/** Stretch to fit, distorting aspect ratio. Rarely useful. */
+ | 'CARD_IMAGE_FIT_FILL';
 export type TextVariantStyle = {
     fontSize: number;
     fontWeight: number;
@@ -200,18 +228,30 @@ export type EdgeInsets = {
     left: number;
 };
 export type BlockStyles = {
-    padding: EdgeInsets;
     backgroundColor: string;
     borderColor: string;
     borderWidth: number;
     borderRadius: number;
 };
 export type ColumnsStyles = {
+    /** Padding applied to each column in the columns block. */
     columnPadding?: EdgeInsets;
     gap?: number;
+    /** Padding applied around the columns block (outside the columns row). */
+    padding?: EdgeInsets;
 };
 export type CardStyles = {
-    imageGap?: number;
+    /**
+     * Padding applied to the image column when accent_fit is enabled on
+     * the card (see AiBuilderCard.accent_fit). Ignored otherwise.
+     */
+    accentFitPadding?: EdgeInsets;
+    /**
+     * Padding applied to the card's content (text) area on top of any
+     * document-level default. Applies to all layouts that have a content
+     * area (i.e. every layout, including NO).
+     */
+    contentPadding?: EdgeInsets;
 };
 export type DefaultStyles = {
     common: BlockStyles;
@@ -259,6 +299,11 @@ export type ButtonStyles = {
 export type ButtonGroup = {
     buttons: Button[];
     styles?: ButtonGroupStyles;
+    /**
+     * Horizontal alignment of the buttons within the group container.
+     * UNSPECIFIED = inherit from CSS / client default.
+     */
+    align: ButtonGroupAlign;
 };
 export type ButtonGroupStyles = {
     padding?: EdgeInsets;
@@ -280,6 +325,16 @@ export type ContentItem = {
 export type Content = {
     items: ContentItem[];
     textPrompt?: string;
+    /**
+     * Client-managed margin around the content block. Preserved by the backend
+     * across Update but never exposed to the LLM.
+     */
+    margin?: EdgeInsets;
+    /**
+     * Client-managed padding inside the content block. Preserved by the backend
+     * across Update but never exposed to the LLM.
+     */
+    padding?: EdgeInsets;
 };
 export type Image = {
     prompt: string;
@@ -292,19 +347,36 @@ export type Image = {
     origHeight: number;
 };
 export type AiBuilderCard = {
-    layout: DocumentBlockLayout;
+    layout: CardLayout;
     image?: Image;
     content: Content;
     styles?: CardStyles;
+    /**
+     * How the image fills its slot. Relevant for layouts that have an
+     * image slot: LEFT, RIGHT, TOP, BACKGROUND. Ignored for layout NO.
+     * UNSPECIFIED lets the client fall back to its default fit.
+     */
+    imageFit: CardImageFit;
+    /**
+     * Apply only to LEFT / RIGHT layouts: render the image as a side
+     * accent that fits the height of the text column. Ignored for other
+     * layouts.
+     */
+    accentFit: boolean;
 };
 export type AiBuilderColumns = {
     columns: AiBuilderColumn[];
     styles?: ColumnsStyles;
     withImages: boolean;
+    /** Content rendered above the columns row. */
+    contentBefore?: Content;
+    /** Content rendered below the columns row. */
+    contentAfter?: Content;
 };
 export type AiBuilderColumn = {
     image?: Image;
     content: Content;
+    width?: string;
 };
 export type AiBuilderBlock_block_card = {
     type: 'card';

package/types.d.ts

@@ -7,12 +7,14 @@ export type InterfaceDefinition = {
     oneofs?: {
         [oneofName: string]: OneofGroup;
     };
+    comment?: string;
 };
 export type FieldDefinition = {
     type: string;
     mapKeyType?: string;
     array?: boolean;
     optional?: boolean;
+    comment?: string;
 };
 export type OneofGroup = {
     oneof: string[];
@@ -21,6 +23,8 @@ export type EnumDefinition = {
     type: 'E';
     values: string[];
     valuesArgs?: Record<string, string[]>;
+    comment?: string;
+    valueComments?: Record<string, string>;
 };
 export type ServiceDefinition = {
     type: 'S';
@@ -28,6 +32,7 @@ export type ServiceDefinition = {
     methods: {
         [methodName: string]: ServiceMethod;
     };
+    comment?: string;
 };
 export type ServiceMethod = {
     request: string;
@@ -40,6 +45,7 @@ export type ServiceMethod = {
         failedPreconditions?: string;
         commonFailedPreconditions?: string;
     };
+    comment?: string;
 };
 export type InterfaceDefinitionRaw = InterfaceDefinition & {
     package: string;