@ykurilov/agent-chat-react 0.55.0 → 0.57.0

package/dist/index.js

@@ -26,7 +26,7 @@ import {
   voiceAnswerIds,
   voiceErrorText,
   withoutResetSteps
-} from "./chunk-JZQ7ZOJI.js";
+} from "./chunk-7DVTSVKQ.js";
 
 // src/chat-list/chat-workspace.tsx
 import { useCallback, useEffect, useRef, useState } from "react";

package/dist/panel.js

@@ -6,7 +6,7 @@ import {
   useChatList,
   useChatListView,
   useWorkspaceListSync
-} from "./chunk-JZQ7ZOJI.js";
+} from "./chunk-7DVTSVKQ.js";
 
 // src/agent-panel/agent-panel-provider.tsx
 import { useCallback as useCallback2, useMemo, useRef, useState, useSyncExternalStore as useSyncExternalStore2 } from "react";

package/dist/types/agent-chat-extensions.d.ts

@@ -12,8 +12,9 @@ export interface DiagramsClient {
     }>;
 }
 /**
- * Картинки агента на экране (пакет `@ykurilov/agent-chat-images`, `imagesClient`): сообщает слою поведения имя инструмента
- * и превращает его вызов в вид для скина. Нет `describe`-результата — вызов остаётся обычной строкой инструмента.
+ * Картинки агента на экране (пакет `@ykurilov/agent-chat-images`, `imagesClient`; библиотека картинок
+ * `@ykurilov/agent-chat-image-library`, `imageLibraryClient`): сообщает слою поведения имя инструмента и превращает его
+ * вызов в вид для скина. Нет `describe`-результата — вызов остаётся обычной строкой инструмента.
  */
 export interface ImagesClient {
     /** Имя инструмента, чьи вызовы рисуются как картинки: `generate_images`. */
@@ -56,8 +57,11 @@ export interface AgentChatExtensions {
      * На сервере — `agent.liveDemos: true`.
      */
     liveDemos?: boolean;
-    /** Картинки агента: `imagesClient`. */
-    images?: ImagesClient;
+    /**
+     * Картинки агента: один клиент (`imagesClient`) или несколько списком (`[imagesClient, imageLibraryClient]`) — у каждого
+     * своё имя инструмента. Окно просмотра листает картинки всех клиентов по порядку ленты. Список держите постоянным.
+     */
+    images?: ImagesClient | readonly ImagesClient[];
     /** Видео агента: `videosClient`. */
     videos?: VideosClient;
     /** Вид событий приложения в ответе: тип события → компонент (`{ lesson_passed: LessonPassedBadge }`). */

package/dist/types/media-viewer/generated-images.d.ts

@@ -5,11 +5,13 @@ import type { GeneratedImagesView } from "../skin-contract.js";
 import type { MediaViewerItem } from "./media-viewer-types.js";
 /** Вид картинок агента для части ответа; `undefined` — это не вызов картинок, он остаётся строкой инструмента. */
 export type DescribeGeneratedImages = (part: ToolUIPart | DynamicToolUIPart) => GeneratedImagesView | undefined;
+/** `images` страницы — всегда списком: один клиент или несколько. */
+export declare const imageClientsOf: (images: ImagesClient | readonly ImagesClient[] | undefined) => readonly ImagesClient[];
 /**
- * Картинки агента (`images` страницы): вызов `images.toolName` → вид для скина. Нет `open` (у скина нет окна
- * просмотра) — клик по картинке ничего не делает.
+ * Картинки агента (`images` страницы): вызов инструмента одного из клиентов → вид для скина; клиент выбирается по имени
+ * инструмента. Нет `open` (у скина нет окна просмотра) — клик по картинке ничего не делает.
  */
-export declare function describeGeneratedImages(images: ImagesClient, call: {
+export declare function describeGeneratedImages(images: ImagesClient | readonly ImagesClient[], call: {
     api: string;
     chatId: string;
     open?: ((key: string, trigger: HTMLElement) => void) | undefined;

package/dist/types/skin-contract.d.ts

@@ -281,7 +281,10 @@ export type LiveDemoView =
     source: string;
     reason: "tooLarge" | "unfinished" | "leftPage" | "externalContent";
 };
-/** Картинки агента из вызова `generate_images` (версия 13). */
+/**
+ * Картинки агента из вызова `generate_images` (версия 13) или `show_image` библиотеки картинок (версия 26: `wide` и
+ * `caption`).
+ */
 export interface GeneratedImagesView {
     /** Заказано картинок. */
     ordered: number;
@@ -297,6 +300,8 @@ export interface GeneratedImagesView {
         alt: string;
         width?: number;
         height?: number;
+        /** Версия 26, необязательное: видимая подпись под картинкой (название из библиотеки). */
+        caption?: string;
         onOpen: (trigger: HTMLElement) => void;
     } | {
         state: "failed";
@@ -305,6 +310,11 @@ export interface GeneratedImagesView {
     }>;
     /** Человек нажал «Стоп»: показать `labels.images.stopped`. */
     stopped: boolean;
+    /**
+     * Версия 26, необязательное: картинки во всю ширину ответа, каждая своей пропорции (`width`/`height` элемента), без
+     * обрезки — готовая картинка из библиотеки. Пустой `items` при `wide` — вызов идёт, ничего не рисовать.
+     */
+    wide?: boolean;
 }
 /**
  * Видео агента из вызова `show_video` (версия 14). Плеер грузить только по нажатию на карточку: до него к площадке
@@ -372,7 +382,11 @@ export interface StaffMessageView {
     staffName?: string;
 }
 /**
- * Договор скина, версия 25 (в версии 25 добавилось только необязательное `StaffMessage` — реплика живого сотрудника,
+ * Договор скина, версия 26 (в версии 26 добавились только необязательные `GeneratedImagesView.wide` и `caption` у готовой
+ * картинки — библиотека картинок, docs/image-library.md; скин версии 25 работает без правок: картинка библиотеки
+ * рисуется плиткой сетки ближайшей обычной пропорции (1:1, 3:2, 2:3, 16:9, 9:16) без подписи, подпись остаётся в `alt`;
+ * docs/skin-v26.md).
+ * Версия 25 (в версии 25 добавилось только необязательное `StaffMessage` — реплика живого сотрудника,
  * docs/skin-v25.md; скин версии 24 работает без правок: реплика показывается ответом агента с подписью
  * `labels.notices.staffSaid`).
  * Версия 24 (в версии 24 добавилось только необязательное `AgentMessage.undelivered` — отметка

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ykurilov/agent-chat-react",
-  "version": "0.55.0",
+  "version": "0.57.0",
   "license": "MIT",
   "type": "module",
   "sideEffects": false,