@ykurilov/agent-chat-react 0.73.0 → 0.75.0

package/dist/index.js

@@ -29,7 +29,7 @@ import {
   voiceAnswerIds,
   voiceErrorText,
   withoutResetSteps
-} from "./chunk-WJJY2WLQ.js";
+} from "./chunk-LF723Y52.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-WJJY2WLQ.js";
+} from "./chunk-LF723Y52.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.d.ts

@@ -1,9 +1,10 @@
 import type { ComposerOptions } from "./composer-options.js";
+import type { ReactNode } from "react";
 import type { AgentChatMessage, ChatModelChoice } from "./chat-types.js";
 import type { AgentChatExtensions } from "./agent-chat-extensions.js";
 import type { AnswerEditing } from "./answer-editing/answer-editing.js";
 import type { AttachmentsPlugin } from "./attachments-contract.js";
-import type { ChatSkin } from "./skin-contract.js";
+import type { ChatHeaderView, ChatSkin } from "./skin-contract.js";
 import type { VoiceInput } from "./voice-input.js";
 import type { VoiceDialogEngine } from "./voice-dialog.js";
 import type { AppRefusal } from "./app-refusal.js";
@@ -16,6 +17,10 @@ import type { AppEventHandler } from "./app-events.js";
 import type { TurnFinishedEvent } from "./turn-finished.js";
 import type { ChatStateValues } from "./chat-state/chat-state.js";
 export interface AgentChatProps extends AgentChatExtensions {
+    /** Optional application heading and trailing content, rendered by the selected skin. */
+    header?: ChatHeaderView;
+    /** Application-owned result. Shown after loaded history while idle; never changes server status. Null/false removes it. */
+    completion?: ReactNode;
     composerOptions?: ComposerOptions;
     /** Адрес обработчика чата, например `/api/chat`. */
     api: string;

package/dist/types/index.d.ts

@@ -26,7 +26,7 @@ export type { StepCall, StepPhrase, StepPhrases, StepPhraseText, WorkView } from
 export { guessStepIcon, stepIconOf } from "./work-view/step-icons.js";
 export type { StepIcon } from "./work-view/step-icons.js";
 export type { SpendingInfo, SpendingPeriod, SpendingRefusalReason, SpendingScope, SpendingView, SpendingWindowInfo } from "./spending-status.js";
-export type { AgentNoticeViewKind, AgentNoticeViewProps, AgentVideoView, ChatOriginView, ChatSkin, CustomWidgetProps, DiagramColors, DiagramView, FormFieldView, LiveDemoColors, LiveDemoView, GeneratedImagesView, HelperCallStatus, HelperCallView, HelperStepView, MediaViewerProps, MessageActionView, ModelChoiceView, StaffMessageView, TaskCardView, TaskStatusView, ToolApprovalView, ToolCallState, VoiceInputView, WidgetView, WorkStepsView, } from "./skin-contract.js";
+export type { AgentNoticeViewKind, AgentNoticeViewProps, AgentVideoView, ChatOriginView, ChatSkin, ChatHeaderView, CustomWidgetProps, DiagramColors, DiagramView, FormFieldView, LiveDemoColors, LiveDemoView, GeneratedImagesView, HelperCallStatus, HelperCallView, HelperStepView, MediaViewerProps, MessageActionView, ModelChoiceView, StaffMessageView, TaskCardView, TaskStatusView, ToolApprovalView, ToolCallState, VoiceInputView, WidgetView, WorkStepsView, } from "./skin-contract.js";
 export type { AgentAppBridge, AppDataChange, BrowserCall, BrowserCallResult, ScreenPlace } from "./app-bridge/app-bridge.js";
 export { useAgentChat } from "./use-agent-chat.js";
 export type { AppRefusal, AppRefusalKind } from "./app-refusal.js";

package/dist/types/labels.d.ts

@@ -222,6 +222,11 @@ export interface ComposerSettingsLabels {
     output: string;
 }
 export interface ChatLabels {
+    /** Приветствие пустого чата. Скины без приветствия игнорируют. */
+    welcome?: {
+        title?: string;
+        description?: string;
+    };
     composerSettings?: Partial<ComposerSettingsLabels>;
     /**
      * Язык словаря (BCP 47): `ru` у `russianLabels`, `en` у `englishLabels`. Скин по нему выбирает свои надписи — например,
@@ -450,7 +455,11 @@ export interface ChatLabels {
     workView?: Partial<WorkViewLabels>;
 }
 /** Словарь, в котором есть и необязательные надписи: их подставляет `ChatLabelsProvider`. */
-export type ResolvedChatLabels = Omit<ChatLabels, "widgets" | "diagram" | "demo" | "images" | "videos" | "viewer" | "voice" | "helpers" | "tasks" | "notices" | "messengerStatus" | "workView" | "composerSettings"> & Required<Pick<ChatLabels, "externalImageLink" | "answerCutByLength" | "answerEdited" | "answerUndelivered" | "toolOutputEdited" | "editAnswer" | "steeringPending" | "thinkingPhrases" | "thinkingElapsed" | "spendingMessagesLeft" | "spendingMessagesExhausted" | "editMessageLimit">> & {
+export type ResolvedChatLabels = Omit<ChatLabels, "widgets" | "diagram" | "demo" | "images" | "videos" | "viewer" | "voice" | "helpers" | "tasks" | "notices" | "messengerStatus" | "workView" | "composerSettings" | "welcome"> & Required<Pick<ChatLabels, "externalImageLink" | "answerCutByLength" | "answerEdited" | "answerUndelivered" | "toolOutputEdited" | "editAnswer" | "steeringPending" | "thinkingPhrases" | "thinkingElapsed" | "spendingMessagesLeft" | "spendingMessagesExhausted" | "editMessageLimit">> & {
+    welcome: {
+        title: string;
+        description: string;
+    };
     composerSettings: ComposerSettingsLabels;
     widgets: WidgetLabels;
     diagram: DiagramLabels;

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

@@ -411,7 +411,7 @@ export interface StaffMessageView {
     staffName?: string;
 }
 /**
- * Договор скина, версия 29: необязательные Composer.options, AgentMessage.modelDetails и WorkSteps.live.completed.
+ * Договор скина, версия 31: необязательные Layout.header и Layout.completion. Версия 30: необязательный Layout.empty. Версия 29: необязательные Composer.options, AgentMessage.modelDetails и WorkSteps.live.completed.
  * Скины 28 работают без правок. В версии 28 добавились только необязательные значки шагов и заголовки раздумий:
  * `WorkStepsView.live.icon`, `WorkStepsView.done.items`, `icons`, `moreIcons` и `Reasoning.title`, docs/skin-v28.md;
  * скин версии 27 работает без правок: шаги без значков, раздумья — «Думал N сек».
@@ -465,8 +465,19 @@ export interface StaffMessageView {
  * собирает ленту только из этих
  * компонентов и ничего своего не рисует. Надписи компоненты берут из `useChatLabels()`.
  */
+/** Application-owned chat heading; skins render it in their own visual system. */
+export interface ChatHeaderView {
+    title: string;
+    aside?: ReactNode;
+    headingLevel?: 1 | 2 | 3;
+}
 export interface ChatSkin {
     Layout: ComponentType<{
+        header?: ChatHeaderView;
+        /** Application-owned result, after the feed in the same scroll root. Keep composer mounted but hidden while present. */
+        completion?: ReactNode;
+        /** История успешно загружена, сообщений нет и ход не выполняется. Необязательная подсказка для приветствия. */
+        empty?: boolean;
         feed: ReactNode;
         composer: ReactNode;
         notice?: ReactNode;

package/package.json

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