@ykurilov/agent-chat-react 0.55.0 → 0.56.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @ykurilov/agent-chat-react
 
+## 0.56.0
+
+### Minor Changes
+
+- 1eadba9: Библиотека готовых картинок: новый пакет `@ykurilov/agent-chat-image-library` с инструментами `find_images` и
+  `show_image` поверх каталога приложения. Картинка показывается по ширине ответа с подписью, по нажатию — окно просмотра.
+  
+  - `images` у `AgentChat`, `ChatWorkspace`, `AgentPanel` принимает и список клиентов: `images={[imagesClient, imageLibraryClient]}`.
+    Одиночный клиент работает как раньше.
+  - Договор скина версии 26: у `GeneratedImages` необязательные `wide` и `caption`. Тандем их рисует. Скин версии 25
+    работает без правок: картинка будет плиткой ближайшей обычной пропорции (1:1, 3:2, 2:3, 16:9, 9:16) без подписи.
+  
+  Подробно и как подключить — `docs/image-library.md`.
+  
+  Отказ `show_image`, `show_video` и недоступный каталог в `find_images`, `find_videos` теперь ошибка инструмента (`ImageLibraryError`, `VideoLibraryError` с полем `kind`).
+  В ленте строка «ошибка» вместо зелёной галочки, модель получает тот же текст. Код, который читал `{ отказ }` из
+  результата `show_video` или `find_videos`, должен смотреть на `state: "output-error"` у части сообщения.
+
 ## 0.55.0
 
 ### Minor Changes

package/README.md

@@ -35,6 +35,10 @@ import { AgentChat, ChatLabelsProvider, russianLabels } from "@ykurilov/agent-ch
   (`text`, `staffName`) — не пузырём человека. Договор скина версии 25; скин версии 24 работает без правок: реплика
   показывается ответом агента с подписью `labels.notices.staffSaid` («Сотрудник Ольга») —
   [docs/skin-v25.md](https://github.com/ykurilov/agent-chat-sdk/blob/main/docs/skin-v25.md).
+- Картинка библиотеки (`show_image`, пакет `@ykurilov/agent-chat-image-library`) приходит в `GeneratedImages` с
+  необязательными `wide` (по ширине ответа со своей пропорцией) и `caption` (подпись под картинкой). Договор скина
+  версии 26; скин версии 25 работает без правок: плитка ближайшей обычной пропорции без подписи —
+  [docs/skin-v26.md](https://github.com/ykurilov/agent-chat-sdk/blob/main/docs/skin-v26.md).
 - `ChatWorkspace` — список чатов и открытый чат вместе: создать, переименовать, удалить (нужен `chatList: true` на сервере). Хук — `useChatList`. Скину дополнительно нужны `ChatWorkspace` и `ChatList` (`ChatListSkin`, договор версии 7).
 - `AgentMemory` — экран долгой памяти агента: записи по разделам, добавить, изменить, удалить, «Стереть всю память» (нужна опция `memory` на сервере, пакет `@ykurilov/agent-chat-memory`). `api` — `createMemoryApi({ api: "/api/chat" })`, создавать один раз; `skin` — `MemorySkin` (`tandemMemorySkin`). Хук — `useMemoryNotes`. Без памяти на сервере экран пишет, что память не включена. Договор скина версии 11 — отдельный `MemorySkin`, `ChatSkin` не менялся ([contracts/memory.md](../../specs/017-long-term-memory/contracts/memory.md)).
 - Панель агента: вход `@ykurilov/agent-chat-react/panel`; основной вход его не подтягивает. `AgentPanelProvider` ставится в корневой макет выше страниц (`api`, `userKey`, `browserTools`, `mode` — `overlay` или `push`, `width`, `onDataChanged`, `fetch` — свой `fetch` только для списка чатов), `AgentPanel` рисует кнопку, рамку и чат через скин. Хуки: `useAgentPanel` (`open`, `openChat`, `openNewChat({ draft })`, `pageInset` — отступ страницы в режиме `push`, на экране ≤ 640 px он 0, `busy`), `useAgentPlace({ description, data? })` (где человек; модель видит только описание, `data` — только инструменты), `useAgentDataChanges(tag, handler)` (страница узнаёт, что инструмент изменил данные). Браузерные инструменты — функции в `browserTools` с теми же именами, что описания на сервере (`BrowserToolImplementations`); нет функции — модель получает «Инструмент недоступен на этой странице» (надпись `agentPanelToolUnavailable`). Подробно — [docs/getting-started.md](../../docs/getting-started.md#панель-агента-в-приложении-по-желанию). Общие части: `AgentAppBridge` (связь чата с приложением; `appBridge` в `AgentChat`, `useAgentChat`, `ChatWorkspace`), `initialDraft` (текст в поле ввода при открытии чата), `rememberKey` в `useChatList` (свой ключ запомненного чата). Договор скина версии 12 — отдельный `AgentPanelSkin` (`AgentPanelLauncher`, `AgentPanel`), надписи `agentPanel…` в словаре; `ChatSkin`, `ChatListSkin` и `MemorySkin` не менялись ([contracts/skin.md](../../specs/021-agent-panel/contracts/skin.md)).

package/dist/{chunk-JZQ7ZOJI.js → chunk-7DVTSVKQ.js}

@@ -4682,9 +4682,11 @@ function describeWithViewer(describe, open) {
 // src/media-viewer/generated-images.ts
 import { getToolName as getToolName2, isToolUIPart } from "ai";
 var noOpen2 = () => void 0;
+var imageClientsOf = (images) => images === void 0 ? [] : Array.isArray(images) ? images : [images];
 function describeGeneratedImages(images, call) {
   const openImage = call.open ?? noOpen2;
-  return (part) => getToolName2(part) === images.toolName ? images.describe({ part, api: call.api, chatId: call.chatId, openImage }) : void 0;
+  const byTool = new Map(imageClientsOf(images).map((client) => [client.toolName, client]));
+  return (part) => byTool.get(getToolName2(part))?.describe({ part, api: call.api, chatId: call.chatId, openImage });
 }
 function generatedViewerItems(describe) {
   return (message) => {
@@ -5740,18 +5742,19 @@ function AgentChatBody({ api, chatId, skin, liveness, voice, voiceDialog, attach
   const dialog = useVoiceDialog({ engine: voiceDialog, chatId, chat, ...videos && { videos } });
   const attachments = attachmentsPlugin?.useController({ api, chatId, modelSeesImages: chatModelSeesImages });
   const describeFiles = attachments?.describe;
+  const imageClients = useSameList(imageClientsOf(images));
   const extensions = useMemo15(
     () => ({
       ...widgets && { widgets },
       ...diagrams && { diagrams },
       ...liveDemos && { liveDemos },
-      ...images && { images },
+      ...imageClients.length > 0 && { images: imageClients },
       ...videos && { videos },
       ...appEvents && { appEvents },
       ...workView && { workView },
       ...stepPhrases && { stepPhrases }
     }),
-    [widgets, diagrams, liveDemos, images, videos, appEvents, workView, stepPhrases]
+    [widgets, diagrams, liveDemos, imageClients, videos, appEvents, workView, stepPhrases]
   );
   const scrollRef = useRef16(null);
   const feedRef = useRef16(null);
@@ -5821,7 +5824,7 @@ function AgentChatBody({ api, chatId, skin, liveness, voice, voiceDialog, attach
   const [editingAnswerId, setEditingAnswerId] = useState17(null);
   const saving = useRef16(false);
   const [feedView, setFeedView] = useState17({ epoch: 0 });
-  const imagesShown = images && skin.GeneratedImages ? images : void 0;
+  const imagesShown = imageClients.length > 0 && skin.GeneratedImages ? imageClients : void 0;
   const viewerImages = useMemo15(() => imagesShown && generatedViewerItems(describeGeneratedImages(imagesShown, { api, chatId })), [imagesShown, api, chatId]);
   const getViewerItems = useCallback16(
     () => collectViewerItems({ messages: chat.messages, describeAttachments: describeFiles, extraItems: viewerImages }),
@@ -6558,6 +6561,11 @@ function approvalProps(part, controls) {
   if (part.state === "output-denied" || approval.approved === false) return { approval: { state: "denied" } };
   return { approval: { state: approval.reason === ALWAYS_IN_CHAT ? "always" : "allowed" } };
 }
+function useSameList(list) {
+  const kept = useRef16(list);
+  if (kept.current.length !== list.length || kept.current.some((item, index) => item !== list[index])) kept.current = list;
+  return kept.current;
+}
 
 // src/chat-list/use-chat-list.ts
 import { useCallback as useCallback17, useEffect as useEffect15, useRef as useRef17, useState as useState18 } from "react";
@@ -6956,4 +6964,4 @@ export {
   activeChatTitle,
   useWorkspaceListSync
 };
-//# sourceMappingURL=chunk-JZQ7ZOJI.js.map
+//# sourceMappingURL=chunk-7DVTSVKQ.js.map