@pushwoosh/rpc-gateway-ai-assistant 0.1.240 → 0.1.242

package/data.js

@@ -1040,6 +1040,20 @@ export const data = {
             }
         }
     },
+    "pushwoosh.aibuilder.v1.SyncedBlockRef": {
+        "type": "I",
+        "fields": {
+            "templateCode": {
+                "type": "string"
+            },
+            "sourceUpdatedAt": {
+                "type": "string"
+            },
+            "fragmentCode": {
+                "type": "string"
+            }
+        }
+    },
     "pushwoosh.aibuilder.v1.AiBuilderBlock": {
         "type": "I",
         "fields": {
@@ -1068,6 +1082,10 @@ export const data = {
                 "type": "pushwoosh.aibuilder.v1.BlockStyles",
                 "optional": true
             },
+            "syncedRef": {
+                "type": "pushwoosh.aibuilder.v1.SyncedBlockRef",
+                "optional": true
+            },
             "parentId": {
                 "type": "string"
             }
@@ -1414,6 +1432,30 @@ export const data = {
                 "response": "pushwoosh.aigen.v1.AiGenConvertUnlayerResponse",
                 "method": "post",
                 "path": "/api/v1/aigen/convert-unlayer"
+            },
+            "GenerateMediaImage": {
+                "request": "pushwoosh.aigen.v1.AiGenMediaImageRequest",
+                "response": "pushwoosh.aigen.v1.AiGenMediaImageResponse",
+                "method": "post",
+                "path": "/api/v1/aigen/media-image"
+            },
+            "SearchStockPhotos": {
+                "request": "pushwoosh.aigen.v1.AiGenStockSearchRequest",
+                "response": "pushwoosh.aigen.v1.AiGenStockSearchResponse",
+                "method": "post",
+                "path": "/api/v1/aigen/stock-search"
+            },
+            "ImportStockPhoto": {
+                "request": "pushwoosh.aigen.v1.AiGenStockImportRequest",
+                "response": "pushwoosh.aigen.v1.AiGenStockImportResponse",
+                "method": "post",
+                "path": "/api/v1/aigen/stock-import"
+            },
+            "GenerateImageAlt": {
+                "request": "pushwoosh.aigen.v1.AiGenImageAltRequest",
+                "response": "pushwoosh.aigen.v1.AiGenImageAltResponse",
+                "method": "post",
+                "path": "/api/v1/aigen/image-alt"
             }
         }
     },
@@ -1882,6 +1924,172 @@ export const data = {
             }
         }
     },
+    "pushwoosh.aigen.v1.AiGenMediaImageRequest": {
+        "type": "I",
+        "fields": {
+            "application": {
+                "type": "string"
+            },
+            "prompt": {
+                "type": "string"
+            },
+            "aspectRatio": {
+                "type": "string"
+            }
+        }
+    },
+    "pushwoosh.aigen.v1.AiGenMediaImageResponse": {
+        "type": "I",
+        "fields": {
+            "url": {
+                "type": "string"
+            },
+            "mediaUuid": {
+                "type": "string"
+            },
+            "width": {
+                "type": "number"
+            },
+            "height": {
+                "type": "number"
+            }
+        }
+    },
+    "pushwoosh.aigen.v1.StockProvider": {
+        "type": "E",
+        "values": [
+            "STOCK_PROVIDER_UNSPECIFIED",
+            "STOCK_PROVIDER_PEXELS"
+        ]
+    },
+    "pushwoosh.aigen.v1.AiGenStockSearchRequest": {
+        "type": "I",
+        "fields": {
+            "application": {
+                "type": "string"
+            },
+            "query": {
+                "type": "string"
+            },
+            "page": {
+                "type": "number"
+            },
+            "provider": {
+                "type": "pushwoosh.aigen.v1.StockProvider"
+            }
+        }
+    },
+    "pushwoosh.aigen.v1.StockPhoto": {
+        "type": "I",
+        "fields": {
+            "id": {
+                "type": "string"
+            },
+            "thumbUrl": {
+                "type": "string"
+            },
+            "width": {
+                "type": "number"
+            },
+            "height": {
+                "type": "number"
+            },
+            "photographer": {
+                "type": "string"
+            },
+            "photographerUrl": {
+                "type": "string"
+            },
+            "avgColor": {
+                "type": "string"
+            },
+            "alt": {
+                "type": "string"
+            }
+        }
+    },
+    "pushwoosh.aigen.v1.AiGenStockSearchResponse": {
+        "type": "I",
+        "fields": {
+            "photos": {
+                "type": "pushwoosh.aigen.v1.StockPhoto",
+                "array": true
+            },
+            "total": {
+                "type": "number"
+            },
+            "page": {
+                "type": "number"
+            },
+            "provider": {
+                "type": "pushwoosh.aigen.v1.StockProvider"
+            }
+        }
+    },
+    "pushwoosh.aigen.v1.AiGenStockImportRequest": {
+        "type": "I",
+        "fields": {
+            "application": {
+                "type": "string"
+            },
+            "provider": {
+                "type": "pushwoosh.aigen.v1.StockProvider"
+            },
+            "photoId": {
+                "type": "string"
+            }
+        }
+    },
+    "pushwoosh.aigen.v1.AiGenStockImportResponse": {
+        "type": "I",
+        "fields": {
+            "url": {
+                "type": "string"
+            },
+            "mediaUuid": {
+                "type": "string"
+            },
+            "width": {
+                "type": "number"
+            },
+            "height": {
+                "type": "number"
+            },
+            "alt": {
+                "type": "string"
+            }
+        }
+    },
+    "pushwoosh.aigen.v1.AiGenImageAltRequest": {
+        "type": "I",
+        "fields": {
+            "application": {
+                "type": "string"
+            },
+            "imageUrl": {
+                "type": "string"
+            },
+            "llmProvider": {
+                "type": "string",
+                "optional": true
+            },
+            "llmModel": {
+                "type": "string",
+                "optional": true
+            },
+            "language": {
+                "type": "string"
+            }
+        }
+    },
+    "pushwoosh.aigen.v1.AiGenImageAltResponse": {
+        "type": "I",
+        "fields": {
+            "alt": {
+                "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.240",
+    "version": "0.1.242",
     "description": "AI Assistant api gateway HTTP API Types and Data",
     "main": "index.js",
     "module": "index.js",

package/pushwoosh_aibuilder_v1.d.ts

@@ -926,6 +926,28 @@ export type Divider = {
     style: DividerStyle;
     widthPercent: number;
 };
+/**
+ * SyncedBlockRef links a block subtree root back to the saved-block template it was inserted from.
+ * Client-managed end to end: the client refreshes the subtree from the template on load,
+ * pushes edits back via TemplatesService, and re-applies the link after AI edits.
+ */
+export type SyncedBlockRef = {
+    /** TemplatesService code of the source template. */
+    templateCode: string;
+    /**
+     * RFC3339 updated_at of the source template at last sync — the staleness check on load.
+     * A string, not google.protobuf.Timestamp, on purpose: the value is client-opaque and lives in
+     * documents stored as raw JSON (rpc-v2 smartcards content), where a Timestamp's generated
+     * Date type would lie after a plain JSON revival; only the client ever parses it.
+     */
+    sourceUpdatedAt: string;
+    /**
+     * Companion email template holding the block's rendered fragment. The email
+     * emitter writes `{% email_content "<code>" %}` instead of the baked block,
+     * so the sending pipeline inlines the CURRENT fragment at send time.
+     */
+    fragmentCode: string;
+};
 export type AiBuilderBlock_block_card = {
     type: 'card';
     data: AiBuilderCard;
@@ -954,6 +976,8 @@ export type AiBuilderBlock_block = AiBuilderBlock_block_card | AiBuilderBlock_bl
 export type AiBuilderBlock = {
     id: string;
     styles?: BlockStyles;
+    /** Synced-block link; present only on the root of an instance's subtree. */
+    syncedRef?: SyncedBlockRef;
     /**
      * 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

package/pushwoosh_aigen_v1.d.ts

@@ -6,6 +6,10 @@ import { ColorSchemeItem as pushwoosh_aibuilder_v1_ColorSchemeItem } from './pus
 import { AiBuilderBlock as pushwoosh_aibuilder_v1_AiBuilderBlock } from './pushwoosh_aibuilder_v1';
 export type AiGenService_ExtractStyle = RpcMethod<AiGenExtractStyleRequest, AiGenExtractStyleResponse>;
 export type AiGenService_ConvertUnlayer = RpcMethod<AiGenConvertUnlayerRequest, AiGenConvertUnlayerResponse>;
+export type AiGenService_GenerateMediaImage = RpcMethod<AiGenMediaImageRequest, AiGenMediaImageResponse>;
+export type AiGenService_SearchStockPhotos = RpcMethod<AiGenStockSearchRequest, AiGenStockSearchResponse>;
+export type AiGenService_ImportStockPhoto = RpcMethod<AiGenStockImportRequest, AiGenStockImportResponse>;
+export type AiGenService_GenerateImageAlt = RpcMethod<AiGenImageAltRequest, AiGenImageAltResponse>;
 /**
  * AiGenService unifies document create / edit / per-block regeneration and
  * targeted block insertion into a single streaming RPC. Dispatch rules:
@@ -73,6 +77,34 @@ export interface AiGenService {
      * document validation. Unary; the result is document-sized.
      */
     ConvertUnlayer: AiGenService_ConvertUnlayer;
+    /**
+     * GenerateMediaImage generates ONE image from a prompt and stores it in
+     * the application's media library — the media-gallery "Generate" tab.
+     * Same generator the streaming pipeline uses (Gemini image model, cheap
+     * quality tier); the response carries the stored file's URL and uuid,
+     * ready to insert as ContentImage.src / media_uuid.
+     */
+    GenerateMediaImage: AiGenService_GenerateMediaImage;
+    /**
+     * SearchStockPhotos proxies a stock-photo search (Pexels) — the API key
+     * stays server-side and the browser never talks to the provider. Results
+     * are preview-only: thumbnails for the picker plus the attribution the
+     * provider requires. Inserting a photo goes through ImportStockPhoto.
+     */
+    SearchStockPhotos: AiGenService_SearchStockPhotos;
+    /**
+     * ImportStockPhoto copies one stock photo into the application's media
+     * library: the server resolves the photo by id at the provider, downloads
+     * the bytes itself (never a client-supplied URL — SSRF stays impossible)
+     * and uploads them to media storage with a provenance description.
+     */
+    ImportStockPhoto: AiGenService_ImportStockPhoto;
+    /**
+     * GenerateImageAlt writes alt text for an existing image: the server
+     * fetches the image (media-library / stock hosts only), shows it to a
+     * vision-capable model and returns one concise accessibility-grade alt.
+     */
+    GenerateImageAlt: AiGenService_GenerateImageAlt;
 }
 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. */
@@ -621,3 +653,90 @@ export type AiGenConvertUnlayerResponse = {
      */
     warnings: string[];
 };
+export type AiGenMediaImageRequest = {
+    application: string;
+    /** Image generation prompt; required, capped server-side. */
+    prompt: string;
+    /**
+     * Gemini ImageConfig aspect ratio ("1:1", "16:9", "21:9", "3:4", ...).
+     * Empty = the generator default.
+     */
+    aspectRatio: string;
+};
+export type AiGenMediaImageResponse = {
+    /** The stored media file, ready for ContentImage.src / media_uuid. */
+    url: string;
+    mediaUuid: string;
+    width: number;
+    height: number;
+};
+/**
+ * StockProvider names the upstream catalog. Only Pexels for now; the enum
+ * exists so a second provider (Pixabay) is a value, not a schema break.
+ */
+export type StockProvider = 
+/** treated as PEXELS */
+'STOCK_PROVIDER_UNSPECIFIED' | 'STOCK_PROVIDER_PEXELS';
+export type AiGenStockSearchRequest = {
+    application: string;
+    query: string;
+    /** 1-based page, provider-side pagination; 0 = first page. */
+    page: number;
+    provider: StockProvider;
+};
+/**
+ * One search hit: enough for the picker tile + the provider's required
+ * attribution. No full-size URLs — the import round-trips by id.
+ */
+export type StockPhoto = {
+    id: string;
+    /** Preview for the picker grid (provider CDN, display-only). */
+    thumbUrl: string;
+    width: number;
+    height: number;
+    photographer: string;
+    /** Photographer / photo page at the provider — the attribution link. */
+    photographerUrl: string;
+    /** Average color for grid placeholders ("#aabbcc"); may be empty. */
+    avgColor: string;
+    alt: string;
+};
+export type AiGenStockSearchResponse = {
+    photos: StockPhoto[];
+    total: number;
+    page: number;
+    provider: StockProvider;
+};
+export type AiGenStockImportRequest = {
+    application: string;
+    provider: StockProvider;
+    /** Provider photo id from a SearchStockPhotos hit. */
+    photoId: string;
+};
+export type AiGenStockImportResponse = {
+    url: string;
+    mediaUuid: string;
+    width: number;
+    height: number;
+    /** Alt suggested by the provider's metadata; may be empty. */
+    alt: string;
+};
+export type AiGenImageAltRequest = {
+    application: string;
+    /**
+     * Image to describe. Must live on an allowlisted host (the application's
+     * media storage or a stock CDN) — the server refuses to fetch elsewhere.
+     */
+    imageUrl: string;
+    /** Dev-only LLM override, same semantics as AiGenRequest.llm_provider. */
+    llmProvider?: string;
+    llmModel?: string;
+    /**
+     * Optional language for the alt text (ISO code); empty = the image's
+     * dominant/default language, typically English.
+     */
+    language: string;
+};
+export type AiGenImageAltResponse = {
+    alt: string;
+};