@oscloudlab/vgen-agent-assistant 0.0.20 → 0.0.22

package/dist/types/src/components/LeftChatPanel/index.d.ts

@@ -0,0 +1,4 @@
+import { LeftChatPanelProps } from '../VgenAgent/type';
+
+declare const LeftChatPanel: React.FC<LeftChatPanelProps>;
+export default LeftChatPanel;

package/dist/types/src/components/VgenAgent/type.d.ts

@@ -25,6 +25,8 @@ export interface VgenAgentProps {
      * - inline：左侧固定面板，参与宿主布局流、在宿主布局左侧占据固定宽度的一列并与卡片同高（内容区相应缩窄）
      */
     dockLayout?: 'float' | 'inline';
+    /** dock 形态切换回调（由 AI 学伴内右上角切换按钮触发，宿主据此更新 dockLayout） */
+    onDockLayoutChange?: (layout: 'float' | 'inline') => void;
     /** inline 固定面板展开态列宽（number 时按 px），缺省 320 */
     dockPanelWidth?: number | string;
     /** 外部 ref 转调（setQuotedText/sendMsg）的默认目标形态，弹窗保持旧行为不受影响 */
@@ -32,6 +34,9 @@ export interface VgenAgentProps {
     /** diffViewer 组件透传注入：结果卡差异区渲染（未注入时隐藏差异区）；
      *  资源编辑差异锚点（rel_resource_edit）以 modal 形态调用，opts 携带确认/取消回调 */
     customDiffViewer?: (payload: DiffCardPayload, opts?: CustomDiffViewerOpts) => ReactNode;
+    /** dock 无引用态快捷 chips 自定义注入（boarding 宿主自定意图提示词）；
+     *  不传回落 dockVM.GENERAL_CHIPS 默认组；QuickChip.icon 可选，缺省渲染默认消息图标 */
+    generalChips?: QuickChip[];
     /** dock 快捷 chips（send 模式）点击回调，未提供时默认按 label 直接发送 */
     onDockQuickAction?: (label: string) => void;
     /** dock 意图 CTA 点击回调（未提供时 dock 不渲染 CTA 按钮） */
@@ -299,7 +304,8 @@ export interface CustomDiffViewerOpts {
 }
 /** dock 快捷 chip */
 export interface QuickChip {
-    icon: ComponentType<{
+    /** 缺省可不传，渲染处回落默认消息图标 */
+    icon?: ComponentType<{
         className?: string;
     }>;
     label: string;
@@ -340,6 +346,8 @@ export interface DockMessage {
 export interface BottomChatDockProps {
     /** 卡片状态 → 收起态把手提示词（dockHint 三态文案），缺省 'fresh' */
     state?: 'fresh' | 'adjusted' | 'expanded';
+    /** 形态切换回调（面板/浮窗内 Segmented 触发，参数为目标形态，VgenAgent 直绑 onDockLayoutChange） */
+    onSwitchLayout?: (layout: 'float' | 'inline') => void;
     /**
      * dock 消息列表（MessageProps[] 头插序，宿主用 toDockChatMessages 从 controller.messages
      * 纯过滤派生）；渲染与主聊天统一，全部由 MessageContent 组件承载
@@ -373,6 +381,12 @@ export interface BottomChatDockProps {
     /** diffViewer 组件透传注入（结果卡差异区渲染，未注入时结果卡隐藏差异区）；
      *  资源编辑差异锚点以 modal 形态调用，opts 含确认/取消变更回调 */
     customDiffViewer?: (payload: DiffCardPayload, opts?: CustomDiffViewerOpts) => ReactNode;
+    /** 无引用态快捷 chips 自定义注入（VgenAgent 从 props.generalChips 透传），不传回落 dockVM.GENERAL_CHIPS */
+    generalChips?: QuickChip[];
+    /** 头部「开启新对话」按钮回调（VgenAgent 透传 controller.addNewSession），不传不渲染该按钮 */
+    onNewSession?: () => void;
+    /** 头部「会话历史」Popover 内容（VgenAgent 透传 historyListRender 视图），不传不渲染该按钮 */
+    historyPanel?: ReactNode;
 }
 /**
  * 左侧固定形态面板（追加形态，不影响 BottomChatDock 浮窗）：
@@ -381,7 +395,7 @@ export interface BottomChatDockProps {
  * 在宿主布局左侧占据固定宽度的一列并与卡片同高
  * （宿主提供挂载槽位，见 KnowledgeCard bottomDockLayout='inline' 布局）
  */
-export interface BottomChatPanelProps extends BottomChatDockProps {
+export interface LeftChatPanelProps extends BottomChatDockProps {
     /** 展开态面板初始列宽兼拖拽下限（number 按 px 处理），缺省 320；resizable=true 时展开态可拖拽在
      *  [width, 50vw] 区间内自由拉伸；收起态固定为左侧窄竖条，仍在布局内占位 */
     width?: number | string;

package/dist/types/src/index.d.ts

@@ -1,11 +1,11 @@
 import { default as VgenAgent } from './components/VgenAgent';
 import { default as BottomChatDock } from './components/BottomChatDock';
-import { default as BottomChatPanel } from './components/BottomChatPanel';
+import { default as LeftChatPanel } from './components/LeftChatPanel';
 import { useVgenChat } from './hooks/useVgenChat';
 import { COOKIE_AVATAR, detectIntent, GENERAL_CHIPS, INTENT_REPLY, QUOTE_CHIPS, dockHint } from './components/BottomChatDock/dockVM';
 
 export default VgenAgent;
-export { BottomChatDock, BottomChatPanel, useVgenChat, COOKIE_AVATAR, detectIntent, GENERAL_CHIPS, INTENT_REPLY, QUOTE_CHIPS, dockHint, };
+export { BottomChatDock, LeftChatPanel, LeftChatPanel as BottomChatPanel, useVgenChat, COOKIE_AVATAR, detectIntent, GENERAL_CHIPS, INTENT_REPLY, QUOTE_CHIPS, dockHint, };
 export { msgType, agentScene } from './components/VgenAgent/type';
-export type { VgenAgentProps, VgenAgentRefProps, viewModeType, videoInfoProps, knowledgeInfoProps, courseInfoProps, MessageProps, resourceType, recommendVideosProps, chatMsgResProps, saveMsgProps, sessionProps, AdjustmentKind, DiffCardPayload, QuickChip, DockResultData, DockMessage, BottomChatDockProps, BottomChatPanelProps, } from './components/VgenAgent/type';
+export type { VgenAgentProps, VgenAgentRefProps, viewModeType, videoInfoProps, knowledgeInfoProps, courseInfoProps, MessageProps, resourceType, recommendVideosProps, chatMsgResProps, saveMsgProps, sessionProps, AdjustmentKind, DiffCardPayload, QuickChip, DockResultData, DockMessage, BottomChatDockProps, LeftChatPanelProps, LeftChatPanelProps as BottomChatPanelProps, } from './components/VgenAgent/type';
 export type { VgenChatController, UseVgenChatProps } from './hooks/useVgenChat';