@pushwoosh/rpc-gateway-ai-assistant 0.1.454 → 0.1.455

package/data.js

@@ -1809,6 +1809,13 @@ export const data = {
             },
             "url": {
                 "type": "string"
+            },
+            "annotation": {
+                "type": "string"
+            },
+            "annotationTranslations": {
+                "type": "string",
+                "mapKeyType": "string"
             }
         }
     },
@@ -2459,6 +2466,12 @@ export const data = {
                 "response": "pushwoosh.aigen.v1.AiGenImageAltResponse",
                 "method": "post",
                 "path": "/api/v1/aigen/image-alt"
+            },
+            "GenerateArticleAnnotations": {
+                "request": "pushwoosh.aigen.v1.AiGenArticleAnnotationsRequest",
+                "response": "pushwoosh.aigen.v1.AiGenArticleAnnotationsResponse",
+                "method": "post",
+                "path": "/api/v1/aigen/article-annotations"
             }
         }
     },
@@ -3514,6 +3527,81 @@ export const data = {
             }
         }
     },
+    "pushwoosh.aigen.v1.AiGenAnnotationTone": {
+        "type": "E",
+        "values": [
+            "AI_GEN_ANNOTATION_TONE_UNSPECIFIED",
+            "AI_GEN_ANNOTATION_TONE_NEUTRAL",
+            "AI_GEN_ANNOTATION_TONE_EXPLANATORY",
+            "AI_GEN_ANNOTATION_TONE_WITTY"
+        ]
+    },
+    "pushwoosh.aigen.v1.AiGenArticle": {
+        "type": "I",
+        "fields": {
+            "url": {
+                "type": "string"
+            },
+            "title": {
+                "type": "string"
+            },
+            "summary": {
+                "type": "string"
+            }
+        }
+    },
+    "pushwoosh.aigen.v1.AiGenArticleAnnotationsRequest": {
+        "type": "I",
+        "fields": {
+            "application": {
+                "type": "string"
+            },
+            "articles": {
+                "type": "pushwoosh.aigen.v1.AiGenArticle",
+                "array": true
+            },
+            "tone": {
+                "type": "pushwoosh.aigen.v1.AiGenAnnotationTone"
+            },
+            "instruction": {
+                "type": "string"
+            },
+            "language": {
+                "type": "string"
+            },
+            "llmProvider": {
+                "type": "string",
+                "optional": true
+            },
+            "llmModel": {
+                "type": "string",
+                "optional": true
+            }
+        }
+    },
+    "pushwoosh.aigen.v1.AiGenArticleAnnotation": {
+        "type": "I",
+        "fields": {
+            "annotation": {
+                "type": "string"
+            },
+            "error": {
+                "type": "string"
+            },
+            "fromSummary": {
+                "type": "boolean"
+            }
+        }
+    },
+    "pushwoosh.aigen.v1.AiGenArticleAnnotationsResponse": {
+        "type": "I",
+        "fields": {
+            "annotations": {
+                "type": "pushwoosh.aigen.v1.AiGenArticleAnnotation",
+                "array": true
+            }
+        }
+    },
     "pushwoosh.accounts.assistant.v1.Role": {
         "type": "E",
         "values": [

package/package.json

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

package/pushwoosh_aibuilder_v1.d.ts

@@ -1252,6 +1252,9 @@ export type NewsItem = {
     author: string;
     category: string;
     url: string;
+    /** Editorial intro under the title, AI-written in the builder and editable. */
+    annotation: string;
+    annotationTranslations: Record<string, string>;
 };
 export type NewsSource = 
 /** Renders as MANUAL. */

package/pushwoosh_aigen_v1.d.ts

@@ -19,6 +19,7 @@ export type AiGenService_SearchStockPhotos = RpcMethod<AiGenStockSearchRequest,
 export type AiGenService_ImportStockPhoto = RpcMethod<AiGenStockImportRequest, AiGenStockImportResponse>;
 export type AiGenService_ImportImageByUrl = RpcMethod<AiGenImageImportRequest, AiGenImageImportResponse>;
 export type AiGenService_GenerateImageAlt = RpcMethod<AiGenImageAltRequest, AiGenImageAltResponse>;
+export type AiGenService_GenerateArticleAnnotations = RpcMethod<AiGenArticleAnnotationsRequest, AiGenArticleAnnotationsResponse>;
 /**
  * AiGenService unifies document create / edit / per-block regeneration and
  * targeted block insertion into a single streaming RPC. Dispatch rules:
@@ -184,6 +185,11 @@ export interface AiGenService {
      * vision-capable model and returns one concise accessibility-grade alt.
      */
     GenerateImageAlt: AiGenService_GenerateImageAlt;
+    /**
+     * GenerateArticleAnnotations writes a short editorial intro per news article:
+     * the server reads each article page and falls back to the given summary.
+     */
+    GenerateArticleAnnotations: AiGenService_GenerateArticleAnnotations;
 }
 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. */
@@ -1092,3 +1098,44 @@ export type AiGenImageAltRequest = {
 export type AiGenImageAltResponse = {
     alt: string;
 };
+export type AiGenAnnotationTone = 'AI_GEN_ANNOTATION_TONE_UNSPECIFIED'
+/** What happened, plainly. */
+ | 'AI_GEN_ANNOTATION_TONE_NEUTRAL'
+/** Why the story matters to the reader. */
+ | 'AI_GEN_ANNOTATION_TONE_EXPLANATORY'
+/** Light, with a gentle joke; the model falls back to neutral on sensitive topics. */
+ | 'AI_GEN_ANNOTATION_TONE_WITTY';
+export type AiGenArticle = {
+    /** Public article page; its text is what the intro is written from. */
+    url: string;
+    title: string;
+    /** Feed summary, used when the page yields no readable text. */
+    summary: string;
+};
+export type AiGenArticleAnnotationsRequest = {
+    /** Application code, for account/app scoping middleware and logging. */
+    application: string;
+    /** Capped at 12, the news block's card limit. */
+    articles: AiGenArticle[];
+    /** UNSPECIFIED = NEUTRAL. */
+    tone: AiGenAnnotationTone;
+    /** Optional editorial voice guidance, up to 500 characters. */
+    instruction: string;
+    /** ISO code of the output language; empty = the article's own language. */
+    language: string;
+    /** Dev-only LLM override, same semantics as AiGenRequest.llm_provider: empty = the default. */
+    llmProvider?: string;
+    llmModel?: string;
+};
+export type AiGenArticleAnnotation = {
+    /** Empty when error is set. */
+    annotation: string;
+    /** Per-article failure, so one broken page cannot blank the whole block. */
+    error: string;
+    /** True when the article page had no readable text and the feed summary was used. */
+    fromSummary: boolean;
+};
+export type AiGenArticleAnnotationsResponse = {
+    /** Index-aligned with AiGenArticleAnnotationsRequest.articles. */
+    annotations: AiGenArticleAnnotation[];
+};