orbcafe-ui 1.1.2 → 1.1.3

package/README.md

@@ -6,7 +6,7 @@
 
 - 组件可直接通过 NPM 安装并使用。
 - 组件 API 稳定、类型完整、目录结构一致。
-- 组件内部逻辑可复用（通过 Hooks），文档可追踪（README 规范化）。
+- 组件公共 API、类型契约与回调契约稳定，文档与 examples 可追踪。
 
 ---
 
@@ -24,12 +24,13 @@
 | `CustomizeAgent` | AI 参数与 Prompt 模板设置弹窗 | `src/components/CustomizeAgent` | `src/components/CustomizeAgent/README.md` |
 | `DetailInfo` | 标准详情页容器（信息块 + Tabs + 底部表格 + AI/搜索） | `src/components/DetailInfo` | `src/components/DetailInfo/README.md` |
 | `PageLayout` | 页面壳层（Header + Navigation + Content） | `src/components/PageLayout` | `src/components/PageLayout/README.md` |
+| `AgentUI` | 聊天 UI 与 Copilot UI（StdChat / CopilotChat / AgentPanel） | `src/components/AgentUI` | `src/components/AgentUI/README.md` |
 
 ### 文档查阅顺序（推荐）
 
 1. 先看模块根 README：了解能力边界、最小接入示例。  
-2. 再看模块 `Hooks/README.md`：确认状态管理、参数、返回值与联动方式。  
-3. 最后看模块详细设计文档（如 `graphreport.md`）：理解内部结构与扩展点。  
+2. 如果该模块公开导出 hooks，再看模块 `Hooks/README.md`：确认状态管理、参数、返回值与联动方式。  
+3. 最后看模块详细设计文档或 AI 契约索引：理解内部结构、标准案例与扩展点。  
 
 ### 常用文档索引
 
@@ -38,6 +39,76 @@
 - `StdReport Hooks`：`src/components/StdReport/Hooks/README.md`
 - `PageLayout Hooks`：`src/components/PageLayout/Hooks/README.md`
 - `DetailInfo` 模块文档：`src/components/DetailInfo/README.md`
+- `AgentUI` 模块文档：`src/components/AgentUI/README.md`
+- `AI 模块契约索引`：`skills/orbcafe-ui-component-usage/references/module-contracts.md`
+
+---
+
+## AgentUI（聊天与 Copilot）
+
+`AgentUI` 是库里负责聊天类交互的标准模块，当前建议直接使用以下公共 API：
+
+- `AgentPanel`: 带头部的标准聊天容器。
+- `StdChat`: 适合整页、弹窗、工作台内嵌聊天。
+- `CopilotChat`: 适合右下角 Copilot 浮窗内容层。
+- `AgentUICardHooks` / `AgentUICardHookEvent`: 卡片交互事件回调类型。
+
+### Import
+
+```tsx
+import {
+  AgentPanel,
+  StdChat,
+  CopilotChat,
+  type ChatMessage,
+  type AgentUICardHooks
+} from 'orbcafe-ui'
+```
+
+### 使用约定
+
+- `AgentUI` 当前没有独立导出的自定义 hooks，对外稳定接口是组件 props 和回调契约。
+- 标准消息状态以 `messages + isResponding` 为主。
+- 卡片交互统一通过 `cardHooks.onCardEvent` 承接。
+- `StdChat` 负责标准聊天布局，`CopilotChat` 只负责 Copilot 面板内容层，不负责浮窗壳、拖拽和缩放。
+
+详细接入方式、example 拆解和封装边界说明见 `src/components/AgentUI/README.md`。
+
+---
+
+## AI-First Integration
+
+如果目标是让 AI 在 vibe coding 场景里稳定使用 ORBCAFE UI，推荐遵循这条顺序：
+
+1. 先用 `skills/orbcafe-ui-component-usage` 判定目标模块。
+2. 再看 `skills/orbcafe-ui-component-usage/references/module-contracts.md`，确认：
+   - 公共导出入口
+   - 推荐标准组件
+   - 是否公开 hooks
+   - 最小状态结构
+   - 标准 example
+   - 验证与排障清单
+3. 最后才看具体模块 README 和官方 examples。
+
+### 当前标准化原则
+
+- 只使用 `src/index.ts` 可达的公共导出。
+- 优先走 canonical example，不从内部组件自由拼装。
+- 每个模块都要回答 5 个问题：
+  - 用哪个公共入口组件或 hook
+  - 最小状态是什么
+  - 必须回调有哪些
+  - 标准 example 是哪个
+  - 怎么验证“真的生效了”
+
+### 关于 Hooks
+
+不是所有模块都以 hooks 为主入口。
+
+- `StdReport`、`DetailInfo`、`PivotTable`、`AINav`、`PageLayout` 明确公开了 hooks。
+- `AgentUI` 当前不公开自定义 hook，稳定入口是组件 props 和回调契约。
+
+这条规则对 AI 很重要，因为它决定了应该生成“hook 驱动代码”还是“组件 + callbacks 驱动代码”。
 
 ---
 
@@ -186,15 +257,24 @@ Hydration mismatch 常见来源：
 提交前建议至少执行：
 
 ```bash
-# 1) 构建组件库
+# 1) 校验 AI 契约与公开导出一致
+npm run check:ai-contracts
+
+# 2) 构建组件库
 npm run build
 
-# 2) 校验 examples
+# 3) 校验 examples
 cd examples
 npm run lint
 npx tsc --noEmit
 ```
 
+如果要做一轮更完整的发布前检查：
+
+```bash
+npm run release:check
+```
+
 如果只想快速看运行效果：
 
 ```bash
@@ -202,6 +282,16 @@ cd examples
 npm run dev
 ```
 
+### 发布前 AI 契约清单
+
+每次发布前至少确认：
+
+1. `src/index.ts` 的公共导出与 skill 文档一致。
+2. `skills/orbcafe-ui-component-usage/references/module-contracts.md` 和 `.json` 已同步更新。
+3. 新模块已声明 `Hook-first` / `Component-first`。
+4. 每个模块至少有一个 canonical example。
+5. router skill 已能把新模块正确分流。
+
 ---
 
 ## Internationalization (i18n)

package/dist/index.d.mts

@@ -772,8 +772,12 @@ interface UseStandardReportOptions {
     fetchData?: (params: any) => Promise<any>;
     initialRowsPerPage?: number;
     rowsPerPageOptions?: number[];
+    tableKey?: string;
+    mode?: CStandardPageProps['mode'];
+    serviceUrl?: string;
+    variantService?: IVariantService;
 }
-declare const useStandardReport: ({ metadata, fetchData, initialRowsPerPage, rowsPerPageOptions, }: UseStandardReportOptions) => {
+declare const useStandardReport: ({ metadata, fetchData, initialRowsPerPage, rowsPerPageOptions, tableKey, mode, serviceUrl, variantService, }: UseStandardReportOptions) => {
     pageProps: CStandardPageProps;
     filters: Record<string, any>;
     rows: any[];
@@ -1533,6 +1537,105 @@ interface COrbCanvasProps {
 }
 declare function COrbCanvas({ hue, hoverIntensity, rotateOnHover, forceHoverState, backgroundColor }: COrbCanvasProps): react_jsx_runtime.JSX.Element;
 
+interface TableTypeContent {
+    type: 'table';
+    data: any;
+}
+interface ChartCardTypeContent {
+    type: 'bar-chart-card' | 'line-chart-card' | 'pie-chart-card' | 'combo-chart-card' | 'heatmap-chart-card' | 'fishbone-chart-card' | 'waterfall-chart-card' | 'google-map-card' | 'amap-card';
+    title: string;
+    subtitle?: string;
+    data: any[];
+    config?: any;
+}
+interface SAPCardTypeContent {
+    type: 'sap-analytical-card' | 'sap-list-card' | 'sap-object-card' | 'sap-component-card';
+    manifest: any;
+}
+interface AgentUICardTypeContent {
+    type: 'error-card' | 'warning-card' | 'suggestions-card' | 'tool-result-card';
+    [key: string]: any;
+}
+type ParsedCardData = TableTypeContent | ChartCardTypeContent | SAPCardTypeContent | AgentUICardTypeContent;
+type AgentUICardType = ParsedCardData['type'];
+type AgentUICardAction = 'render' | 'close' | 'retry' | 'confirm' | 'action' | 'suggestion-click';
+interface AgentUICardHookEvent {
+    messageId?: string;
+    cardType: AgentUICardType;
+    action: AgentUICardAction;
+    title?: string;
+    payload?: unknown;
+    rawData?: unknown;
+}
+interface AgentUICardHooks {
+    onCardEvent?: (event: AgentUICardHookEvent) => void;
+}
+
+interface AssistantActionContext {
+    isLatestAssistant: boolean;
+    onRegenerate?: () => Promise<void>;
+}
+interface ChatMessageProps {
+    message: ChatMessage;
+    onStreamingComplete?: () => void;
+    assistantActions?: AssistantActionContext;
+    streamIntervalMs?: number;
+    streamChunkSize?: number;
+    cardHooks?: AgentUICardHooks;
+}
+interface ChatMessage {
+    id: string;
+    type: 'user' | 'assistant';
+    content: string;
+    timestamp: Date;
+    isStreaming?: boolean;
+}
+declare const ChatMessage: React__default.FC<ChatMessageProps>;
+
+interface StdChatProps {
+    messages: ChatMessage[];
+    onSend: (content: string, files?: File[]) => Promise<void>;
+    onStop?: () => void;
+    onRegenerate?: (messageId: string) => Promise<void>;
+    isResponding?: boolean;
+    className?: string;
+    placeholder?: string;
+    streamIntervalMs?: number;
+    streamChunkSize?: number;
+    onMessageStreamingComplete?: (messageId: string) => void;
+    cardHooks?: AgentUICardHooks;
+}
+declare const StdChat: React__default.FC<StdChatProps>;
+
+interface AgentPanelProps extends StdChatProps {
+    title?: string;
+    description?: string;
+    headerActions?: React__default.ReactNode;
+}
+declare const AgentPanel: React__default.FC<AgentPanelProps>;
+
+type CopilotCorner = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+interface CopilotChatProps {
+    messages: ChatMessage[];
+    onSend: (content: string, files?: File[]) => Promise<void>;
+    onStop?: () => void;
+    onRegenerate?: (messageId: string) => Promise<void>;
+    isResponding?: boolean;
+    className?: string;
+    placeholder?: string;
+    title?: string;
+    corner?: CopilotCorner;
+    onCollapse?: () => void;
+    onHeaderPointerDown?: (e: React__default.PointerEvent<HTMLDivElement>) => void;
+    onPlusClick?: () => void;
+    onMicClick?: () => void;
+    streamIntervalMs?: number;
+    streamChunkSize?: number;
+    onMessageStreamingComplete?: (messageId: string) => void;
+    cardHooks?: AgentUICardHooks;
+}
+declare const CopilotChat: React__default.FC<CopilotChatProps>;
+
 interface MarkdownRendererProps {
     markdown?: string;
     content?: string;
@@ -1627,4 +1730,4 @@ declare const PAGE_TRANSITION_PRESETS: {
     };
 };
 
-export { type AINavContextValue, type AmapEmbedOptions, Button, type ButtonProps, CAINavProvider, type CAINavProviderProps, CAmapChart, type CAmapChartProps, CAppHeader, type CAppHeaderProps, type CAppHeaderUser, type CAppHeaderUserMenuItem, CAppPageLayout, type CAppPageLayoutProps, CBarChart, type CBarChartProps, CChartCard, type CChartCardProps, CComboChart, type CComboChartProps, CCustomizeAgent, type CCustomizeAgentProps, CDetailInfoPage, type CDetailInfoPageProps, CDetailSearchAiBar, type CDetailSearchAiBarProps, CDetailSectionCard, type CDetailSectionCardProps, CFishboneChart, type CFishboneChartProps, CGoogleMapChart, type CGoogleMapChartProps, CGraphCharts, CGraphKpiCards, CGraphReport, type CGraphReportProps, CHeatmapChart, type CHeatmapChartProps, CLayoutManagement, type CLayoutManagementProps, CLayoutManager, type CLayoutManagerProps, CLineChart, type CLineChartProps, CMessageBox, type CMessageBoxProps, type CMessageBoxType, COrbCanvas, type COrbCanvasProps, CPageLayout, type CPageLayoutProps, CPageTransition, type CPageTransitionProps, CPieChart, type CPieChartProps, CPivotTable, type CPivotTableProps, CSmartFilter, type CSmartFilterProps, CSmartTable, CStandardPage, type CStandardPageProps, CTable, CTableBody, type CTableBodyProps, CTableCell, type CTableCellProps, CTableContainer, type CTableContainerProps, CTableHead, type CTableHeadProps, type CTableProps, type CTableQuickCreateConfig, type CTableQuickDeleteConfig, type CTableQuickEditConfig, CTableRow, type CTableRowProps, CVariantManagement, type CVariantManagementProps, CVariantManager, CVoiceWaveOverlay, type CVoiceWaveOverlayProps, CWaterfallChart, type CWaterfallChartProps, CodeBlock, type CodeBlockProps, type CustomizeAgentSavePayload, type CustomizeAgentSettings, type CustomizeAgentTemplateOption, type DateOperator, type DetailInfoAiConfig, type DetailInfoField, type DetailInfoSearchHit, type DetailInfoSearchMode, type DetailInfoSection, type DetailInfoTab, type DetailInfoTableConfig, type FilterField, type FilterOperator, type FilterType, type FilterValue, GlobalMessage, type GoogleMapEmbedOptions, type GraphBarDatum, type GraphComboDatum, type GraphFishboneBranch, type GraphHeatmapDatum, type GraphLineDatum, type GraphMapLocation, type GraphPieDatum, type GraphReportConfig, type GraphReportFieldMapping, type GraphReportInteractionState, type GraphReportKpis, type GraphReportModel, type GraphRow, type GraphTableColumn, type GraphWaterfallDatum, type IVariantService, type LayoutMetadata, MarkdownRenderer, type MarkdownRendererProps, MathBlock, type MathBlockProps, MermaidBlock, type MermaidBlockProps, type MessageContent, type MessageEvent, type MessageOptions, NavigationIsland, type NavigationIslandProps, type NumberOperator, ORBCAFE_I18N_MESSAGES, type OrbcafeI18nContextValue, OrbcafeI18nProvider, type OrbcafeI18nProviderProps, type OrbcafeLocale, type OrbcafeLocaleMessages, type OrbcafeMessageKey, type OrbcafeMessageParams, PAGE_TRANSITION_PRESETS, type PageTransitionVariant, type ParsedMarkdownTable, type PivotAggregation, type PivotFieldDefinition, type PivotFieldType, type PivotFilterSelections, type PivotLayoutConfig, type PivotTableModel, type PivotTablePreset, type PivotValueFieldConfig, type PivotValueFieldState, type ReportColumn, type ReportFilter, type ReportMetadata, type SelectOperator, type TableAlign, TableBlock, type TableBlockProps, type TextOperator, ThinkBlock, type ThinkBlockProps, TreeMenu, type TreeMenuItem, type UseAmapEmbedUrlOptions, type UseDetailInfoOptions, type UseDetailInfoResult, type UseGoogleMapEmbedUrlOptions, type UseGraphChartDataOptions, type UseGraphChartDataResult, type UseGraphInteractionResult, type UseGraphReportOptions, type UseGraphReportResult, type UseNavigationIslandOptions, type UseNavigationIslandResult, type UsePageLayoutOptions, type UsePivotTableOptions, type UsePivotTableResult, type UseStandardReportOptions, type UseVoiceInputOptions, type UseVoiceInputResult, type VariantMetadata, type VoiceNavigatorContextValue, VoiceNavigatorProvider, type VoiceNavigatorProviderProps, VoiceWaveOverlay, type VoiceWaveOverlayProps, buildAmapEmbedUrl, buildGoogleMapEmbedUrl, buildGoogleMapIframe, buttonVariants, message, messageManager, parseMarkdownTable, renderMarkdown, resolveVariantFilters, resolveVariantLayout, useAINav, useAmapEmbedUrl, useDetailInfo, useGoogleMapEmbedUrl, useGraphChartData, useGraphInteraction, useGraphReport, useNavigationIsland, useOrbcafeI18n, usePageLayout, usePivotTable, useStandardReport, useVoiceInput, useVoiceNavigator };
+export { type AINavContextValue, AgentPanel, type AgentPanelProps, type AgentUICardAction, type AgentUICardHookEvent, type AgentUICardHooks, type AgentUICardType, type AmapEmbedOptions, Button, type ButtonProps, CAINavProvider, type CAINavProviderProps, CAmapChart, type CAmapChartProps, CAppHeader, type CAppHeaderProps, type CAppHeaderUser, type CAppHeaderUserMenuItem, CAppPageLayout, type CAppPageLayoutProps, CBarChart, type CBarChartProps, CChartCard, type CChartCardProps, CComboChart, type CComboChartProps, CCustomizeAgent, type CCustomizeAgentProps, CDetailInfoPage, type CDetailInfoPageProps, CDetailSearchAiBar, type CDetailSearchAiBarProps, CDetailSectionCard, type CDetailSectionCardProps, CFishboneChart, type CFishboneChartProps, CGoogleMapChart, type CGoogleMapChartProps, CGraphCharts, CGraphKpiCards, CGraphReport, type CGraphReportProps, CHeatmapChart, type CHeatmapChartProps, CLayoutManagement, type CLayoutManagementProps, CLayoutManager, type CLayoutManagerProps, CLineChart, type CLineChartProps, CMessageBox, type CMessageBoxProps, type CMessageBoxType, COrbCanvas, type COrbCanvasProps, CPageLayout, type CPageLayoutProps, CPageTransition, type CPageTransitionProps, CPieChart, type CPieChartProps, CPivotTable, type CPivotTableProps, CSmartFilter, type CSmartFilterProps, CSmartTable, CStandardPage, type CStandardPageProps, CTable, CTableBody, type CTableBodyProps, CTableCell, type CTableCellProps, CTableContainer, type CTableContainerProps, CTableHead, type CTableHeadProps, type CTableProps, type CTableQuickCreateConfig, type CTableQuickDeleteConfig, type CTableQuickEditConfig, CTableRow, type CTableRowProps, CVariantManagement, type CVariantManagementProps, CVariantManager, CVoiceWaveOverlay, type CVoiceWaveOverlayProps, CWaterfallChart, type CWaterfallChartProps, ChatMessage, CodeBlock, type CodeBlockProps, CopilotChat, type CopilotChatProps, type CustomizeAgentSavePayload, type CustomizeAgentSettings, type CustomizeAgentTemplateOption, type DateOperator, type DetailInfoAiConfig, type DetailInfoField, type DetailInfoSearchHit, type DetailInfoSearchMode, type DetailInfoSection, type DetailInfoTab, type DetailInfoTableConfig, type FilterField, type FilterOperator, type FilterType, type FilterValue, GlobalMessage, type GoogleMapEmbedOptions, type GraphBarDatum, type GraphComboDatum, type GraphFishboneBranch, type GraphHeatmapDatum, type GraphLineDatum, type GraphMapLocation, type GraphPieDatum, type GraphReportConfig, type GraphReportFieldMapping, type GraphReportInteractionState, type GraphReportKpis, type GraphReportModel, type GraphRow, type GraphTableColumn, type GraphWaterfallDatum, type IVariantService, type LayoutMetadata, MarkdownRenderer, type MarkdownRendererProps, MathBlock, type MathBlockProps, MermaidBlock, type MermaidBlockProps, type MessageContent, type MessageEvent, type MessageOptions, NavigationIsland, type NavigationIslandProps, type NumberOperator, ORBCAFE_I18N_MESSAGES, type OrbcafeI18nContextValue, OrbcafeI18nProvider, type OrbcafeI18nProviderProps, type OrbcafeLocale, type OrbcafeLocaleMessages, type OrbcafeMessageKey, type OrbcafeMessageParams, PAGE_TRANSITION_PRESETS, type PageTransitionVariant, type ParsedMarkdownTable, type PivotAggregation, type PivotFieldDefinition, type PivotFieldType, type PivotFilterSelections, type PivotLayoutConfig, type PivotTableModel, type PivotTablePreset, type PivotValueFieldConfig, type PivotValueFieldState, type ReportColumn, type ReportFilter, type ReportMetadata, type SelectOperator, StdChat, type StdChatProps, type TableAlign, TableBlock, type TableBlockProps, type TextOperator, ThinkBlock, type ThinkBlockProps, TreeMenu, type TreeMenuItem, type UseAmapEmbedUrlOptions, type UseDetailInfoOptions, type UseDetailInfoResult, type UseGoogleMapEmbedUrlOptions, type UseGraphChartDataOptions, type UseGraphChartDataResult, type UseGraphInteractionResult, type UseGraphReportOptions, type UseGraphReportResult, type UseNavigationIslandOptions, type UseNavigationIslandResult, type UsePageLayoutOptions, type UsePivotTableOptions, type UsePivotTableResult, type UseStandardReportOptions, type UseVoiceInputOptions, type UseVoiceInputResult, type VariantMetadata, type VoiceNavigatorContextValue, VoiceNavigatorProvider, type VoiceNavigatorProviderProps, VoiceWaveOverlay, type VoiceWaveOverlayProps, buildAmapEmbedUrl, buildGoogleMapEmbedUrl, buildGoogleMapIframe, buttonVariants, message, messageManager, parseMarkdownTable, renderMarkdown, resolveVariantFilters, resolveVariantLayout, useAINav, useAmapEmbedUrl, useDetailInfo, useGoogleMapEmbedUrl, useGraphChartData, useGraphInteraction, useGraphReport, useNavigationIsland, useOrbcafeI18n, usePageLayout, usePivotTable, useStandardReport, useVoiceInput, useVoiceNavigator };

package/dist/index.d.ts

@@ -772,8 +772,12 @@ interface UseStandardReportOptions {
     fetchData?: (params: any) => Promise<any>;
     initialRowsPerPage?: number;
     rowsPerPageOptions?: number[];
+    tableKey?: string;
+    mode?: CStandardPageProps['mode'];
+    serviceUrl?: string;
+    variantService?: IVariantService;
 }
-declare const useStandardReport: ({ metadata, fetchData, initialRowsPerPage, rowsPerPageOptions, }: UseStandardReportOptions) => {
+declare const useStandardReport: ({ metadata, fetchData, initialRowsPerPage, rowsPerPageOptions, tableKey, mode, serviceUrl, variantService, }: UseStandardReportOptions) => {
     pageProps: CStandardPageProps;
     filters: Record<string, any>;
     rows: any[];
@@ -1533,6 +1537,105 @@ interface COrbCanvasProps {
 }
 declare function COrbCanvas({ hue, hoverIntensity, rotateOnHover, forceHoverState, backgroundColor }: COrbCanvasProps): react_jsx_runtime.JSX.Element;
 
+interface TableTypeContent {
+    type: 'table';
+    data: any;
+}
+interface ChartCardTypeContent {
+    type: 'bar-chart-card' | 'line-chart-card' | 'pie-chart-card' | 'combo-chart-card' | 'heatmap-chart-card' | 'fishbone-chart-card' | 'waterfall-chart-card' | 'google-map-card' | 'amap-card';
+    title: string;
+    subtitle?: string;
+    data: any[];
+    config?: any;
+}
+interface SAPCardTypeContent {
+    type: 'sap-analytical-card' | 'sap-list-card' | 'sap-object-card' | 'sap-component-card';
+    manifest: any;
+}
+interface AgentUICardTypeContent {
+    type: 'error-card' | 'warning-card' | 'suggestions-card' | 'tool-result-card';
+    [key: string]: any;
+}
+type ParsedCardData = TableTypeContent | ChartCardTypeContent | SAPCardTypeContent | AgentUICardTypeContent;
+type AgentUICardType = ParsedCardData['type'];
+type AgentUICardAction = 'render' | 'close' | 'retry' | 'confirm' | 'action' | 'suggestion-click';
+interface AgentUICardHookEvent {
+    messageId?: string;
+    cardType: AgentUICardType;
+    action: AgentUICardAction;
+    title?: string;
+    payload?: unknown;
+    rawData?: unknown;
+}
+interface AgentUICardHooks {
+    onCardEvent?: (event: AgentUICardHookEvent) => void;
+}
+
+interface AssistantActionContext {
+    isLatestAssistant: boolean;
+    onRegenerate?: () => Promise<void>;
+}
+interface ChatMessageProps {
+    message: ChatMessage;
+    onStreamingComplete?: () => void;
+    assistantActions?: AssistantActionContext;
+    streamIntervalMs?: number;
+    streamChunkSize?: number;
+    cardHooks?: AgentUICardHooks;
+}
+interface ChatMessage {
+    id: string;
+    type: 'user' | 'assistant';
+    content: string;
+    timestamp: Date;
+    isStreaming?: boolean;
+}
+declare const ChatMessage: React__default.FC<ChatMessageProps>;
+
+interface StdChatProps {
+    messages: ChatMessage[];
+    onSend: (content: string, files?: File[]) => Promise<void>;
+    onStop?: () => void;
+    onRegenerate?: (messageId: string) => Promise<void>;
+    isResponding?: boolean;
+    className?: string;
+    placeholder?: string;
+    streamIntervalMs?: number;
+    streamChunkSize?: number;
+    onMessageStreamingComplete?: (messageId: string) => void;
+    cardHooks?: AgentUICardHooks;
+}
+declare const StdChat: React__default.FC<StdChatProps>;
+
+interface AgentPanelProps extends StdChatProps {
+    title?: string;
+    description?: string;
+    headerActions?: React__default.ReactNode;
+}
+declare const AgentPanel: React__default.FC<AgentPanelProps>;
+
+type CopilotCorner = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+interface CopilotChatProps {
+    messages: ChatMessage[];
+    onSend: (content: string, files?: File[]) => Promise<void>;
+    onStop?: () => void;
+    onRegenerate?: (messageId: string) => Promise<void>;
+    isResponding?: boolean;
+    className?: string;
+    placeholder?: string;
+    title?: string;
+    corner?: CopilotCorner;
+    onCollapse?: () => void;
+    onHeaderPointerDown?: (e: React__default.PointerEvent<HTMLDivElement>) => void;
+    onPlusClick?: () => void;
+    onMicClick?: () => void;
+    streamIntervalMs?: number;
+    streamChunkSize?: number;
+    onMessageStreamingComplete?: (messageId: string) => void;
+    cardHooks?: AgentUICardHooks;
+}
+declare const CopilotChat: React__default.FC<CopilotChatProps>;
+
 interface MarkdownRendererProps {
     markdown?: string;
     content?: string;
@@ -1627,4 +1730,4 @@ declare const PAGE_TRANSITION_PRESETS: {
     };
 };
 
-export { type AINavContextValue, type AmapEmbedOptions, Button, type ButtonProps, CAINavProvider, type CAINavProviderProps, CAmapChart, type CAmapChartProps, CAppHeader, type CAppHeaderProps, type CAppHeaderUser, type CAppHeaderUserMenuItem, CAppPageLayout, type CAppPageLayoutProps, CBarChart, type CBarChartProps, CChartCard, type CChartCardProps, CComboChart, type CComboChartProps, CCustomizeAgent, type CCustomizeAgentProps, CDetailInfoPage, type CDetailInfoPageProps, CDetailSearchAiBar, type CDetailSearchAiBarProps, CDetailSectionCard, type CDetailSectionCardProps, CFishboneChart, type CFishboneChartProps, CGoogleMapChart, type CGoogleMapChartProps, CGraphCharts, CGraphKpiCards, CGraphReport, type CGraphReportProps, CHeatmapChart, type CHeatmapChartProps, CLayoutManagement, type CLayoutManagementProps, CLayoutManager, type CLayoutManagerProps, CLineChart, type CLineChartProps, CMessageBox, type CMessageBoxProps, type CMessageBoxType, COrbCanvas, type COrbCanvasProps, CPageLayout, type CPageLayoutProps, CPageTransition, type CPageTransitionProps, CPieChart, type CPieChartProps, CPivotTable, type CPivotTableProps, CSmartFilter, type CSmartFilterProps, CSmartTable, CStandardPage, type CStandardPageProps, CTable, CTableBody, type CTableBodyProps, CTableCell, type CTableCellProps, CTableContainer, type CTableContainerProps, CTableHead, type CTableHeadProps, type CTableProps, type CTableQuickCreateConfig, type CTableQuickDeleteConfig, type CTableQuickEditConfig, CTableRow, type CTableRowProps, CVariantManagement, type CVariantManagementProps, CVariantManager, CVoiceWaveOverlay, type CVoiceWaveOverlayProps, CWaterfallChart, type CWaterfallChartProps, CodeBlock, type CodeBlockProps, type CustomizeAgentSavePayload, type CustomizeAgentSettings, type CustomizeAgentTemplateOption, type DateOperator, type DetailInfoAiConfig, type DetailInfoField, type DetailInfoSearchHit, type DetailInfoSearchMode, type DetailInfoSection, type DetailInfoTab, type DetailInfoTableConfig, type FilterField, type FilterOperator, type FilterType, type FilterValue, GlobalMessage, type GoogleMapEmbedOptions, type GraphBarDatum, type GraphComboDatum, type GraphFishboneBranch, type GraphHeatmapDatum, type GraphLineDatum, type GraphMapLocation, type GraphPieDatum, type GraphReportConfig, type GraphReportFieldMapping, type GraphReportInteractionState, type GraphReportKpis, type GraphReportModel, type GraphRow, type GraphTableColumn, type GraphWaterfallDatum, type IVariantService, type LayoutMetadata, MarkdownRenderer, type MarkdownRendererProps, MathBlock, type MathBlockProps, MermaidBlock, type MermaidBlockProps, type MessageContent, type MessageEvent, type MessageOptions, NavigationIsland, type NavigationIslandProps, type NumberOperator, ORBCAFE_I18N_MESSAGES, type OrbcafeI18nContextValue, OrbcafeI18nProvider, type OrbcafeI18nProviderProps, type OrbcafeLocale, type OrbcafeLocaleMessages, type OrbcafeMessageKey, type OrbcafeMessageParams, PAGE_TRANSITION_PRESETS, type PageTransitionVariant, type ParsedMarkdownTable, type PivotAggregation, type PivotFieldDefinition, type PivotFieldType, type PivotFilterSelections, type PivotLayoutConfig, type PivotTableModel, type PivotTablePreset, type PivotValueFieldConfig, type PivotValueFieldState, type ReportColumn, type ReportFilter, type ReportMetadata, type SelectOperator, type TableAlign, TableBlock, type TableBlockProps, type TextOperator, ThinkBlock, type ThinkBlockProps, TreeMenu, type TreeMenuItem, type UseAmapEmbedUrlOptions, type UseDetailInfoOptions, type UseDetailInfoResult, type UseGoogleMapEmbedUrlOptions, type UseGraphChartDataOptions, type UseGraphChartDataResult, type UseGraphInteractionResult, type UseGraphReportOptions, type UseGraphReportResult, type UseNavigationIslandOptions, type UseNavigationIslandResult, type UsePageLayoutOptions, type UsePivotTableOptions, type UsePivotTableResult, type UseStandardReportOptions, type UseVoiceInputOptions, type UseVoiceInputResult, type VariantMetadata, type VoiceNavigatorContextValue, VoiceNavigatorProvider, type VoiceNavigatorProviderProps, VoiceWaveOverlay, type VoiceWaveOverlayProps, buildAmapEmbedUrl, buildGoogleMapEmbedUrl, buildGoogleMapIframe, buttonVariants, message, messageManager, parseMarkdownTable, renderMarkdown, resolveVariantFilters, resolveVariantLayout, useAINav, useAmapEmbedUrl, useDetailInfo, useGoogleMapEmbedUrl, useGraphChartData, useGraphInteraction, useGraphReport, useNavigationIsland, useOrbcafeI18n, usePageLayout, usePivotTable, useStandardReport, useVoiceInput, useVoiceNavigator };
+export { type AINavContextValue, AgentPanel, type AgentPanelProps, type AgentUICardAction, type AgentUICardHookEvent, type AgentUICardHooks, type AgentUICardType, type AmapEmbedOptions, Button, type ButtonProps, CAINavProvider, type CAINavProviderProps, CAmapChart, type CAmapChartProps, CAppHeader, type CAppHeaderProps, type CAppHeaderUser, type CAppHeaderUserMenuItem, CAppPageLayout, type CAppPageLayoutProps, CBarChart, type CBarChartProps, CChartCard, type CChartCardProps, CComboChart, type CComboChartProps, CCustomizeAgent, type CCustomizeAgentProps, CDetailInfoPage, type CDetailInfoPageProps, CDetailSearchAiBar, type CDetailSearchAiBarProps, CDetailSectionCard, type CDetailSectionCardProps, CFishboneChart, type CFishboneChartProps, CGoogleMapChart, type CGoogleMapChartProps, CGraphCharts, CGraphKpiCards, CGraphReport, type CGraphReportProps, CHeatmapChart, type CHeatmapChartProps, CLayoutManagement, type CLayoutManagementProps, CLayoutManager, type CLayoutManagerProps, CLineChart, type CLineChartProps, CMessageBox, type CMessageBoxProps, type CMessageBoxType, COrbCanvas, type COrbCanvasProps, CPageLayout, type CPageLayoutProps, CPageTransition, type CPageTransitionProps, CPieChart, type CPieChartProps, CPivotTable, type CPivotTableProps, CSmartFilter, type CSmartFilterProps, CSmartTable, CStandardPage, type CStandardPageProps, CTable, CTableBody, type CTableBodyProps, CTableCell, type CTableCellProps, CTableContainer, type CTableContainerProps, CTableHead, type CTableHeadProps, type CTableProps, type CTableQuickCreateConfig, type CTableQuickDeleteConfig, type CTableQuickEditConfig, CTableRow, type CTableRowProps, CVariantManagement, type CVariantManagementProps, CVariantManager, CVoiceWaveOverlay, type CVoiceWaveOverlayProps, CWaterfallChart, type CWaterfallChartProps, ChatMessage, CodeBlock, type CodeBlockProps, CopilotChat, type CopilotChatProps, type CustomizeAgentSavePayload, type CustomizeAgentSettings, type CustomizeAgentTemplateOption, type DateOperator, type DetailInfoAiConfig, type DetailInfoField, type DetailInfoSearchHit, type DetailInfoSearchMode, type DetailInfoSection, type DetailInfoTab, type DetailInfoTableConfig, type FilterField, type FilterOperator, type FilterType, type FilterValue, GlobalMessage, type GoogleMapEmbedOptions, type GraphBarDatum, type GraphComboDatum, type GraphFishboneBranch, type GraphHeatmapDatum, type GraphLineDatum, type GraphMapLocation, type GraphPieDatum, type GraphReportConfig, type GraphReportFieldMapping, type GraphReportInteractionState, type GraphReportKpis, type GraphReportModel, type GraphRow, type GraphTableColumn, type GraphWaterfallDatum, type IVariantService, type LayoutMetadata, MarkdownRenderer, type MarkdownRendererProps, MathBlock, type MathBlockProps, MermaidBlock, type MermaidBlockProps, type MessageContent, type MessageEvent, type MessageOptions, NavigationIsland, type NavigationIslandProps, type NumberOperator, ORBCAFE_I18N_MESSAGES, type OrbcafeI18nContextValue, OrbcafeI18nProvider, type OrbcafeI18nProviderProps, type OrbcafeLocale, type OrbcafeLocaleMessages, type OrbcafeMessageKey, type OrbcafeMessageParams, PAGE_TRANSITION_PRESETS, type PageTransitionVariant, type ParsedMarkdownTable, type PivotAggregation, type PivotFieldDefinition, type PivotFieldType, type PivotFilterSelections, type PivotLayoutConfig, type PivotTableModel, type PivotTablePreset, type PivotValueFieldConfig, type PivotValueFieldState, type ReportColumn, type ReportFilter, type ReportMetadata, type SelectOperator, StdChat, type StdChatProps, type TableAlign, TableBlock, type TableBlockProps, type TextOperator, ThinkBlock, type ThinkBlockProps, TreeMenu, type TreeMenuItem, type UseAmapEmbedUrlOptions, type UseDetailInfoOptions, type UseDetailInfoResult, type UseGoogleMapEmbedUrlOptions, type UseGraphChartDataOptions, type UseGraphChartDataResult, type UseGraphInteractionResult, type UseGraphReportOptions, type UseGraphReportResult, type UseNavigationIslandOptions, type UseNavigationIslandResult, type UsePageLayoutOptions, type UsePivotTableOptions, type UsePivotTableResult, type UseStandardReportOptions, type UseVoiceInputOptions, type UseVoiceInputResult, type VariantMetadata, type VoiceNavigatorContextValue, VoiceNavigatorProvider, type VoiceNavigatorProviderProps, VoiceWaveOverlay, type VoiceWaveOverlayProps, buildAmapEmbedUrl, buildGoogleMapEmbedUrl, buildGoogleMapIframe, buttonVariants, message, messageManager, parseMarkdownTable, renderMarkdown, resolveVariantFilters, resolveVariantLayout, useAINav, useAmapEmbedUrl, useDetailInfo, useGoogleMapEmbedUrl, useGraphChartData, useGraphInteraction, useGraphReport, useNavigationIsland, useOrbcafeI18n, usePageLayout, usePivotTable, useStandardReport, useVoiceInput, useVoiceNavigator };