@pactor-app/chat 1.44.0 → 1.46.0

package/dist/index.d.cts

@@ -1,4 +1,6 @@
 import { DslNode, Registry, PermissionConfig } from '@pactor-app/core';
+import { A as ArtifactViewers } from './download-DnP2uArc.cjs';
+export { c as ArtifactTreeNode, d as ArtifactViewer, e as buildArtifactBlob, f as buildArtifactTree, g as downloadArtifact, r as resolveArtifactFilename, s as saveBlob } from './download-DnP2uArc.cjs';
 import { ActionContext, ActionRegistry, RuntimeContext, ActionEngine } from '@pactor-app/runtime';
 import { PermissionStore } from '@pactor-app/permission';
 import * as react from 'react';
@@ -338,21 +340,6 @@ declare class ConversationStore {
     private commit;
 }
 
-/** 下载文件名：title 已带扩展名原样使用；否则补 fileType / kind 缺省扩展名 */
-declare function resolveArtifactFilename(artifact: ChatArtifact): string;
-/**
- * 构建下载 Blob；图片内容为 http(s) URL 时返回 null（由 downloadArtifact
- * 走 fetch 取回，失败降级新标签打开）
- */
-declare function buildArtifactBlob(artifact: ChatArtifact): Blob | null;
-/** 触发浏览器下载（Object URL + 临时锚点） */
-declare function saveBlob(blob: Blob, filename: string): void;
-/**
- * 下载产物：文本类 / dsl JSON / 图片 data URL 与 svg 标记直接存 Blob；
- * 图片 http(s) URL fetch 取回（跨域失败降级新标签打开）
- */
-declare function downloadArtifact(artifact: ChatArtifact): Promise<void>;
-
 /**
  * Streaming 事件模型与 reducer（设计决策 D2，设计文档第 69 节）。
  *
@@ -746,16 +733,17 @@ interface UseChatAutoScrollResult {
 declare function useChatAutoScroll({ messageCount, lastContentLength, isStreaming, }: UseChatAutoScrollOptions): UseChatAutoScrollResult;
 
 /**
- * ArtifactPanel（spec: chat-artifact-panel，设计决策 D2/D3）：
- * 产出物预览面板 = 标题栏（标题 + kind 角标 + 关闭按钮）+ 内容区。
- *
- * 内容按 artifact.kind 分发内建渲染器：markdown 经 @pactor-app/markdown
- * 安全渲染；code 只读代码块（language 仅作角标，不引高亮依赖）；
- * text 预格式文本；dsl 经 guardChatDsl 白名单守卫 + renderChildren
- * 活预览（与消息流 dsl part 同安全级），被拦截 / 渲染失败一律降级为
- * 受控占位块（ChatDenied 同款），MUST NOT 抛错。
+ * ArtifactPanel（spec: chat-artifact-panel）：chat 组合层——展示由包内
+ * 展示组件（src/components/ArtifactPanel，单一实现，自 @pactor-app/ui
+ * 迁入）承载，本层保留 chat 运行时
+ * 接线：整对象 onSelectArtifact（ui 为 id 形式，经 artifacts 回查）、
+ * 面板皮肤类（pactor-chat-inspector）、拖拽调宽（resizable 常开）与
+ * chrome DSL 标题栏（ChatPanel* 内部组件 + chat.panelClose /
+ * panelToggleList / panelDownload 包级动作桥接，无 renderer 或类型
+ * 缺失时回退同一组内部组件的手写组合）。
  *
- * 纯展示组件：关闭只触发 onClose，不单方面修改外部状态。
+ * 目录列表视图状态由本层受控持有（ui view / onViewChange），chrome
+ * 标题栏的目录钮 / 切换下拉经 ChatPanelContext 共享同一状态。
  */
 interface ArtifactPanelProps {
     /** 当前产出物；null 时内容区为空态（inspector 槽场景常见） */
@@ -781,6 +769,8 @@ interface ArtifactPanelProps {
     inspector?: ReactNode;
     /** 关闭按钮 / 遮罩点击回调 */
     onClose?: () => void;
+    /** 下载回调；缺省内部走浏览器下载（downloadArtifact） */
+    onDownload?: (artifact: ChatArtifact) => void;
     /** dsl 产出物活预览的 Safe Registry；缺省时 dsl 内容渲染降级块 */
     safeRegistry?: Registry<unknown>;
     /** 注入 dsl 预览作用域 user */
@@ -792,29 +782,7 @@ interface ArtifactPanelProps {
     artifactViewers?: ArtifactViewers;
     className?: string;
 }
-/**
- * 产物目录树（纯函数）：按 id 的 '/' 分段建目录层级——
- * id 形如 `reports/q3/月报` 时产出 reports → q3 两级目录；
- * 无 '/' 分段的产物平铺在根层。目录先于文件、各自按名称排序。
- */
-interface ArtifactTreeNode {
-    /** 段名（目录名或产物标题） */
-    name: string;
-    /** 完整路径（目录为 id 前缀，文件为产物 id） */
-    path: string;
-    artifact?: ChatArtifact;
-    children: ArtifactTreeNode[];
-}
-declare function buildArtifactTree(artifacts: ChatArtifact[]): ArtifactTreeNode[];
-/**
- * 自定义产物查看器（spec: chat-artifact-panel / 自定义预览）：
- * 键为扩展名（小写不带点，如 'png' / 'md'）或 kind
- * （'markdown' / 'code' / 'text' / 'dsl'）；扩展名键优先于 kind 键，
- * 均优先于内建渲染器。查看器抛错不经守卫——宿主代码自负。
- */
-type ArtifactViewer = (artifact: ChatArtifact) => ReactNode;
-type ArtifactViewers = Record<string, ArtifactViewer>;
-declare function ArtifactPanel({ artifact, artifacts, activeArtifactId, onSelectArtifact, viewRequest, onViewRequestConsumed, inspector, onClose, safeRegistry, user, artifactViewers, className, }: ArtifactPanelProps): ReactNode;
+declare function ArtifactPanel({ artifact, artifacts, activeArtifactId, onSelectArtifact, viewRequest, onViewRequestConsumed, inspector, onClose, onDownload, safeRegistry, user, artifactViewers, className, }: ArtifactPanelProps): ReactNode;
 
 /**
  * EmptyState（spec: chat-empty-state，设计决策 D0/D1）：空会话欢迎页。
@@ -823,10 +791,12 @@ declare function ArtifactPanel({ artifact, artifacts, activeArtifactId, onSelect
  * 点击建议经 `onSuggestionClick` 回调交还调用方（ChatView 接入时
  * 复用 Composer 的同一条发送路径）。
  *
+ * 展示由 @pactor-app/ui 的 Welcome + Suggestion 组合承载（回退路径；
+ * greeting 经 titleClassName 复用 chat 皮肤的 display 衬线字体栈）。
  * chrome DSL 渲染层（spec: chat-chrome-dsl）：元素层在页面运行时内
- * 优先经 ChromeSlot 以宿主组件（Typography / Text / Button）DSL 组合
- * 渲染，建议点击经 chat.sendSuggestion 内建动作接回同一发送路径；
- * 无 renderer 环境或类型缺失时回退下方手写实现（EmptyStateFallback）。
+ * 优先经 ChromeSlot 以宿主组件（Typography / Text / Suggestion）DSL
+ * 组合渲染，建议点击经 chat.sendSuggestion 内建动作接回同一发送路径；
+ * 无 renderer 环境或类型缺失时回退 ui 组合实现（EmptyStateFallback）。
  */
 type ChatSuggestion = string | {
     label: string;
@@ -1208,7 +1178,8 @@ declare const CHAT_COMPONENT_TYPE = "Chat";
  */
 declare function registerChatComponent(registry: Registry<unknown>): void;
 /**
- * 便捷工厂：创建含全部内置组件 + Chat / ChatShell 的组件注册表，
+ * 便捷工厂：创建含全部内置组件（ui 内置 + chat 展示组件）+
+ * Chat / ChatShell 的组件注册表，
  * 直接作为 createPactorApplication 的 componentRegistry 选项：
  *
  * ```ts
@@ -1344,25 +1315,26 @@ type CallChatService = (name: string, params?: Record<string, unknown>) => Promi
 
 /**
  * Composer（spec: chat-view / Composer + chat-composer-extensions）：
- * 自适应高度 textarea + 状态机发送按钮（disabled / ready / streaming
- * 停止，同一按钮元素切换，streaming 态带纯 CSS 光环）。
+ * chat 组合层——展示由包内展示组件（src/components/Composer，自
+ * @pactor-app/ui 迁入）承载（fallback 路径），本层只保留运行时接线：
+ * 发送状态机回调映射、附件模型适配、词边界 '@'
+ * 提及检测（内建弹层 / 调用方回调）、'+' 入口与 chrome DSL 桥接。
  *
- * - IME 守卫（D6）：compositionstart/end + keydown.isComposing 兜底，
- *   合成中 Enter 不发送
- * - 附件（D3）：受控 `attachments` + `onAttachmentsChange`；拖拽悬停态、
- *   粘贴与文件选择产出 `File[]` 经 `onAttachFiles` 交给调用方（包内
- *   不上传）；卡片点击经 `onAttachmentClick` 通知
+ * - IME 守卫由 ui ChatInput 承担（合成中 Enter 不发送），本层不再实现
+ * - 附件（D3）：受控 `attachments` + `onAttachmentsChange`；粘贴 / 拖拽 /
+ *   文件选择产出 `File[]` 经 `onAttachFiles` 交给调用方（包内不上传）；
+ *   卡片点击经 `onAttachmentClick` 通知
  * - 扩展槽：`toolbarStart` / `toolbarEnd` 渲染槽；词边界 `@` 触发
  *   `onMentionTrigger(query, anchorRect)`；"+" 按钮触发
  *   `onPlusMenu(anchorRect)`（无回调不渲染入口）
  * - 内建特性（chat-builtin-features）：models 非空时工具栏右端渲染
- *   模型 chip（AnchoredPopover 列表，toolbarEnd 之前）；contexts 配置
- *   且未注入调用方回调时启用内建 @ 提及 / + 菜单弹层，选中项追加为
- *   输入区上方的上下文 chips（受控：contextChips + onContextChipsChange）
+ *   模型 chip（toolbarEnd 之前）；contexts 配置且未注入调用方回调时
+ *   启用内建 @ 提及 / + 菜单弹层，选中项追加为输入区上方的上下文
+ *   chips（受控：contextChips + onContextChipsChange）
  * - chrome DSL 渲染层（spec: chat-composer-on-chatinput）：呈现层在
  *   DSL 环境经宿主 ChatInput 组合渲染（非受控 + chat.composerSubmit
- *   桥接 + 冒泡同步 / 附件承接），无 renderer 或类型缺失时回退手写
- *   呈现（ComposerFallback），两条路径交互语义一致
+ *   桥接 + 冒泡同步 / 附件承接），无 renderer 或类型缺失时回退
+ *   ui Composer 组合路径，两条路径交互语义一致
  */
 interface ComposerProps {
     /** 发送回调；输入框在回调后清空 */
@@ -1542,11 +1514,11 @@ declare function ActivityTrace({ message }: ActivityTraceProps): react.JSX.Eleme
 
 /**
  * MessageBubble：按 role 区分呈现（参考 DeepTutor web 消息区设计）——
- * user 右侧圆角气泡；assistant 左侧通栏排版：顶部活动轨迹区
- * （ActivityTrace：状态头 + thinking + 配对工具轨迹），正文 parts 按序
- * 渲染；hover 操作条（MessageActions：复制 / 重新生成 / 编辑 / 重试）；
- * system 居中弱提示。
- * 颜色经 `--pactor-chat-*` 变量表达。
+ * user 右侧气泡（ui Bubble，tinted 变体）；assistant 左侧通栏排版：
+ * 顶部 Agent 身份行（ui Sender）+ 活动轨迹区（ActivityTrace：状态头 +
+ * thinking + 配对工具轨迹），正文 parts 按序渲染；hover 操作条
+ * （MessageActions：复制 / 重新生成 / 编辑 / 重试）；system 居中弱提示。
+ * 颜色经 `--pactor-chat-*` 变量与 ui 语义令牌表达。
  */
 interface MessageBubbleProps {
     message: ChatMessage;
@@ -1686,4 +1658,4 @@ interface ChatLayoutRegistry {
 /** 注册 chat 布局（已注册时不覆盖，与 createLayoutRegistry 约定一致） */
 declare function registerChatLayout(layoutRegistry: ChatLayoutRegistry): void;
 
-export { ARTIFACT_IMAGE_EXTENSIONS, ActivityTrace, type ActivityTraceProps, AppShell, type AppShellProps, type ArtifactIconSpec, type ArtifactIconTone, ArtifactPanel, type ArtifactPanelProps, type ArtifactPatch, ArtifactStore, type ArtifactTreeNode, type ArtifactViewer, type ArtifactViewers, type BuiltinMessageAction, CHAT_COMPONENT_TYPE, CHAT_DENIED_TYPE, CHAT_LAYOUT_TYPE, CHAT_SHELL_COMPONENT_TYPE, type CapabilityActionDeps, type CapabilityHandler, Chat, type ChatAgentIdentity, type ChatArtifact, ChatArtifactCard, type ChatAttachment, type ChatCapabilityRegistry, type ChatConfirm, type ChatConfirmRequest, type ChatContextItem, type ChatContextSource, ChatDenied, type ChatEvent, type ChatHeaderAction, type ChatInput, ChatLayout, type ChatLayoutProps, type ChatLayoutRegistry, type ChatMenuItem, type ChatMessage, type ChatMessageAction, type ChatModelOption, type ChatPart, type ChatPermissionChecker, type ChatProps, type ChatRole, type ChatRuntime, type ChatScope, type ChatServices, ChatServicesProvider, ChatShell, type ChatShellProps, ChatSidebarMenu, type ChatSuggestion, type ChatTransport, type ChatTurnResult, ChatView, type ChatViewProps, type ChatWorkspaceProps, type ChatWorkspaceServices, Composer, type ComposerProps, ConversationStore, type CreateChatRuntimeOptions, DEFAULT_CHAT_GREETING, EmptyState, type EmptyStateProps, type ManualChatDriver, MessageActions, type MessageActionsProps, MessageBubble, type MessageBubbleProps, type MessagePatch, type MessageStatus, type PartPatch, type PartRef, PartRenderer, type PartRendererProps, type PartStatus, type RunChatTurnOptions, type StreamingMode, type ToolCallStatus, type ToolTraceEntry, type UseChatAutoScrollOptions, type UseChatAutoScrollResult, type UseSmoothStreamTextOptions, applyChatEvent, artifactCardMeta, buildArtifactBlob, buildArtifactTree, buildChatScope, collectArtifacts, collectMessageText, createChatComponentRegistry, createChatId, createChatRuntime, createChatWorkspace, createManualDriver, createSafeRegistry, detectStreamingMode, downloadArtifact, formatArtifactSize, formatMessageTime, guardChatDsl, isImageArtifact, mergeArtifacts, pairToolTraces, registerCapabilityAction, registerChatComponent, registerChatLayout, registerChatShellComponent, resolveArtifactFileType, resolveArtifactFilename, resolveArtifactIcon, resolveArtifactIconName, runChatTurn, runRegenerateTurn, saveBlob, useChatAutoScroll, useChatServices, useSidebarDrawer, useSmoothStreamText };
+export { ARTIFACT_IMAGE_EXTENSIONS, ActivityTrace, type ActivityTraceProps, AppShell, type AppShellProps, type ArtifactIconSpec, type ArtifactIconTone, ArtifactPanel, type ArtifactPanelProps, type ArtifactPatch, ArtifactStore, ArtifactViewers, type BuiltinMessageAction, CHAT_COMPONENT_TYPE, CHAT_DENIED_TYPE, CHAT_LAYOUT_TYPE, CHAT_SHELL_COMPONENT_TYPE, type CapabilityActionDeps, type CapabilityHandler, Chat, type ChatAgentIdentity, type ChatArtifact, ChatArtifactCard, type ChatAttachment, type ChatCapabilityRegistry, type ChatConfirm, type ChatConfirmRequest, type ChatContextItem, type ChatContextSource, ChatDenied, type ChatEvent, type ChatHeaderAction, type ChatInput, ChatLayout, type ChatLayoutProps, type ChatLayoutRegistry, type ChatMenuItem, type ChatMessage, type ChatMessageAction, type ChatModelOption, type ChatPart, type ChatPermissionChecker, type ChatProps, type ChatRole, type ChatRuntime, type ChatScope, type ChatServices, ChatServicesProvider, ChatShell, type ChatShellProps, ChatSidebarMenu, type ChatSuggestion, type ChatTransport, type ChatTurnResult, ChatView, type ChatViewProps, type ChatWorkspaceProps, type ChatWorkspaceServices, Composer, type ComposerProps, ConversationStore, type CreateChatRuntimeOptions, DEFAULT_CHAT_GREETING, EmptyState, type EmptyStateProps, type ManualChatDriver, MessageActions, type MessageActionsProps, MessageBubble, type MessageBubbleProps, type MessagePatch, type MessageStatus, type PartPatch, type PartRef, PartRenderer, type PartRendererProps, type PartStatus, type RunChatTurnOptions, type StreamingMode, type ToolCallStatus, type ToolTraceEntry, type UseChatAutoScrollOptions, type UseChatAutoScrollResult, type UseSmoothStreamTextOptions, applyChatEvent, artifactCardMeta, buildChatScope, collectArtifacts, collectMessageText, createChatComponentRegistry, createChatId, createChatRuntime, createChatWorkspace, createManualDriver, createSafeRegistry, detectStreamingMode, formatArtifactSize, formatMessageTime, guardChatDsl, isImageArtifact, mergeArtifacts, pairToolTraces, registerCapabilityAction, registerChatComponent, registerChatLayout, registerChatShellComponent, resolveArtifactFileType, resolveArtifactIcon, resolveArtifactIconName, runChatTurn, runRegenerateTurn, useChatAutoScroll, useChatServices, useSidebarDrawer, useSmoothStreamText };

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 import { DslNode, Registry, PermissionConfig } from '@pactor-app/core';
+import { A as ArtifactViewers } from './download-DnP2uArc.js';
+export { c as ArtifactTreeNode, d as ArtifactViewer, e as buildArtifactBlob, f as buildArtifactTree, g as downloadArtifact, r as resolveArtifactFilename, s as saveBlob } from './download-DnP2uArc.js';
 import { ActionContext, ActionRegistry, RuntimeContext, ActionEngine } from '@pactor-app/runtime';
 import { PermissionStore } from '@pactor-app/permission';
 import * as react from 'react';
@@ -338,21 +340,6 @@ declare class ConversationStore {
     private commit;
 }
 
-/** 下载文件名：title 已带扩展名原样使用；否则补 fileType / kind 缺省扩展名 */
-declare function resolveArtifactFilename(artifact: ChatArtifact): string;
-/**
- * 构建下载 Blob；图片内容为 http(s) URL 时返回 null（由 downloadArtifact
- * 走 fetch 取回，失败降级新标签打开）
- */
-declare function buildArtifactBlob(artifact: ChatArtifact): Blob | null;
-/** 触发浏览器下载（Object URL + 临时锚点） */
-declare function saveBlob(blob: Blob, filename: string): void;
-/**
- * 下载产物：文本类 / dsl JSON / 图片 data URL 与 svg 标记直接存 Blob；
- * 图片 http(s) URL fetch 取回（跨域失败降级新标签打开）
- */
-declare function downloadArtifact(artifact: ChatArtifact): Promise<void>;
-
 /**
  * Streaming 事件模型与 reducer（设计决策 D2，设计文档第 69 节）。
  *
@@ -746,16 +733,17 @@ interface UseChatAutoScrollResult {
 declare function useChatAutoScroll({ messageCount, lastContentLength, isStreaming, }: UseChatAutoScrollOptions): UseChatAutoScrollResult;
 
 /**
- * ArtifactPanel（spec: chat-artifact-panel，设计决策 D2/D3）：
- * 产出物预览面板 = 标题栏（标题 + kind 角标 + 关闭按钮）+ 内容区。
- *
- * 内容按 artifact.kind 分发内建渲染器：markdown 经 @pactor-app/markdown
- * 安全渲染；code 只读代码块（language 仅作角标，不引高亮依赖）；
- * text 预格式文本；dsl 经 guardChatDsl 白名单守卫 + renderChildren
- * 活预览（与消息流 dsl part 同安全级），被拦截 / 渲染失败一律降级为
- * 受控占位块（ChatDenied 同款），MUST NOT 抛错。
+ * ArtifactPanel（spec: chat-artifact-panel）：chat 组合层——展示由包内
+ * 展示组件（src/components/ArtifactPanel，单一实现，自 @pactor-app/ui
+ * 迁入）承载，本层保留 chat 运行时
+ * 接线：整对象 onSelectArtifact（ui 为 id 形式，经 artifacts 回查）、
+ * 面板皮肤类（pactor-chat-inspector）、拖拽调宽（resizable 常开）与
+ * chrome DSL 标题栏（ChatPanel* 内部组件 + chat.panelClose /
+ * panelToggleList / panelDownload 包级动作桥接，无 renderer 或类型
+ * 缺失时回退同一组内部组件的手写组合）。
  *
- * 纯展示组件：关闭只触发 onClose，不单方面修改外部状态。
+ * 目录列表视图状态由本层受控持有（ui view / onViewChange），chrome
+ * 标题栏的目录钮 / 切换下拉经 ChatPanelContext 共享同一状态。
  */
 interface ArtifactPanelProps {
     /** 当前产出物；null 时内容区为空态（inspector 槽场景常见） */
@@ -781,6 +769,8 @@ interface ArtifactPanelProps {
     inspector?: ReactNode;
     /** 关闭按钮 / 遮罩点击回调 */
     onClose?: () => void;
+    /** 下载回调；缺省内部走浏览器下载（downloadArtifact） */
+    onDownload?: (artifact: ChatArtifact) => void;
     /** dsl 产出物活预览的 Safe Registry；缺省时 dsl 内容渲染降级块 */
     safeRegistry?: Registry<unknown>;
     /** 注入 dsl 预览作用域 user */
@@ -792,29 +782,7 @@ interface ArtifactPanelProps {
     artifactViewers?: ArtifactViewers;
     className?: string;
 }
-/**
- * 产物目录树（纯函数）：按 id 的 '/' 分段建目录层级——
- * id 形如 `reports/q3/月报` 时产出 reports → q3 两级目录；
- * 无 '/' 分段的产物平铺在根层。目录先于文件、各自按名称排序。
- */
-interface ArtifactTreeNode {
-    /** 段名（目录名或产物标题） */
-    name: string;
-    /** 完整路径（目录为 id 前缀，文件为产物 id） */
-    path: string;
-    artifact?: ChatArtifact;
-    children: ArtifactTreeNode[];
-}
-declare function buildArtifactTree(artifacts: ChatArtifact[]): ArtifactTreeNode[];
-/**
- * 自定义产物查看器（spec: chat-artifact-panel / 自定义预览）：
- * 键为扩展名（小写不带点，如 'png' / 'md'）或 kind
- * （'markdown' / 'code' / 'text' / 'dsl'）；扩展名键优先于 kind 键，
- * 均优先于内建渲染器。查看器抛错不经守卫——宿主代码自负。
- */
-type ArtifactViewer = (artifact: ChatArtifact) => ReactNode;
-type ArtifactViewers = Record<string, ArtifactViewer>;
-declare function ArtifactPanel({ artifact, artifacts, activeArtifactId, onSelectArtifact, viewRequest, onViewRequestConsumed, inspector, onClose, safeRegistry, user, artifactViewers, className, }: ArtifactPanelProps): ReactNode;
+declare function ArtifactPanel({ artifact, artifacts, activeArtifactId, onSelectArtifact, viewRequest, onViewRequestConsumed, inspector, onClose, onDownload, safeRegistry, user, artifactViewers, className, }: ArtifactPanelProps): ReactNode;
 
 /**
  * EmptyState（spec: chat-empty-state，设计决策 D0/D1）：空会话欢迎页。
@@ -823,10 +791,12 @@ declare function ArtifactPanel({ artifact, artifacts, activeArtifactId, onSelect
  * 点击建议经 `onSuggestionClick` 回调交还调用方（ChatView 接入时
  * 复用 Composer 的同一条发送路径）。
  *
+ * 展示由 @pactor-app/ui 的 Welcome + Suggestion 组合承载（回退路径；
+ * greeting 经 titleClassName 复用 chat 皮肤的 display 衬线字体栈）。
  * chrome DSL 渲染层（spec: chat-chrome-dsl）：元素层在页面运行时内
- * 优先经 ChromeSlot 以宿主组件（Typography / Text / Button）DSL 组合
- * 渲染，建议点击经 chat.sendSuggestion 内建动作接回同一发送路径；
- * 无 renderer 环境或类型缺失时回退下方手写实现（EmptyStateFallback）。
+ * 优先经 ChromeSlot 以宿主组件（Typography / Text / Suggestion）DSL
+ * 组合渲染，建议点击经 chat.sendSuggestion 内建动作接回同一发送路径；
+ * 无 renderer 环境或类型缺失时回退 ui 组合实现（EmptyStateFallback）。
  */
 type ChatSuggestion = string | {
     label: string;
@@ -1208,7 +1178,8 @@ declare const CHAT_COMPONENT_TYPE = "Chat";
  */
 declare function registerChatComponent(registry: Registry<unknown>): void;
 /**
- * 便捷工厂：创建含全部内置组件 + Chat / ChatShell 的组件注册表，
+ * 便捷工厂：创建含全部内置组件（ui 内置 + chat 展示组件）+
+ * Chat / ChatShell 的组件注册表，
  * 直接作为 createPactorApplication 的 componentRegistry 选项：
  *
  * ```ts
@@ -1344,25 +1315,26 @@ type CallChatService = (name: string, params?: Record<string, unknown>) => Promi
 
 /**
  * Composer（spec: chat-view / Composer + chat-composer-extensions）：
- * 自适应高度 textarea + 状态机发送按钮（disabled / ready / streaming
- * 停止，同一按钮元素切换，streaming 态带纯 CSS 光环）。
+ * chat 组合层——展示由包内展示组件（src/components/Composer，自
+ * @pactor-app/ui 迁入）承载（fallback 路径），本层只保留运行时接线：
+ * 发送状态机回调映射、附件模型适配、词边界 '@'
+ * 提及检测（内建弹层 / 调用方回调）、'+' 入口与 chrome DSL 桥接。
  *
- * - IME 守卫（D6）：compositionstart/end + keydown.isComposing 兜底，
- *   合成中 Enter 不发送
- * - 附件（D3）：受控 `attachments` + `onAttachmentsChange`；拖拽悬停态、
- *   粘贴与文件选择产出 `File[]` 经 `onAttachFiles` 交给调用方（包内
- *   不上传）；卡片点击经 `onAttachmentClick` 通知
+ * - IME 守卫由 ui ChatInput 承担（合成中 Enter 不发送），本层不再实现
+ * - 附件（D3）：受控 `attachments` + `onAttachmentsChange`；粘贴 / 拖拽 /
+ *   文件选择产出 `File[]` 经 `onAttachFiles` 交给调用方（包内不上传）；
+ *   卡片点击经 `onAttachmentClick` 通知
  * - 扩展槽：`toolbarStart` / `toolbarEnd` 渲染槽；词边界 `@` 触发
  *   `onMentionTrigger(query, anchorRect)`；"+" 按钮触发
  *   `onPlusMenu(anchorRect)`（无回调不渲染入口）
  * - 内建特性（chat-builtin-features）：models 非空时工具栏右端渲染
- *   模型 chip（AnchoredPopover 列表，toolbarEnd 之前）；contexts 配置
- *   且未注入调用方回调时启用内建 @ 提及 / + 菜单弹层，选中项追加为
- *   输入区上方的上下文 chips（受控：contextChips + onContextChipsChange）
+ *   模型 chip（toolbarEnd 之前）；contexts 配置且未注入调用方回调时
+ *   启用内建 @ 提及 / + 菜单弹层，选中项追加为输入区上方的上下文
+ *   chips（受控：contextChips + onContextChipsChange）
  * - chrome DSL 渲染层（spec: chat-composer-on-chatinput）：呈现层在
  *   DSL 环境经宿主 ChatInput 组合渲染（非受控 + chat.composerSubmit
- *   桥接 + 冒泡同步 / 附件承接），无 renderer 或类型缺失时回退手写
- *   呈现（ComposerFallback），两条路径交互语义一致
+ *   桥接 + 冒泡同步 / 附件承接），无 renderer 或类型缺失时回退
+ *   ui Composer 组合路径，两条路径交互语义一致
  */
 interface ComposerProps {
     /** 发送回调；输入框在回调后清空 */
@@ -1542,11 +1514,11 @@ declare function ActivityTrace({ message }: ActivityTraceProps): react.JSX.Eleme
 
 /**
  * MessageBubble：按 role 区分呈现（参考 DeepTutor web 消息区设计）——
- * user 右侧圆角气泡；assistant 左侧通栏排版：顶部活动轨迹区
- * （ActivityTrace：状态头 + thinking + 配对工具轨迹），正文 parts 按序
- * 渲染；hover 操作条（MessageActions：复制 / 重新生成 / 编辑 / 重试）；
- * system 居中弱提示。
- * 颜色经 `--pactor-chat-*` 变量表达。
+ * user 右侧气泡（ui Bubble，tinted 变体）；assistant 左侧通栏排版：
+ * 顶部 Agent 身份行（ui Sender）+ 活动轨迹区（ActivityTrace：状态头 +
+ * thinking + 配对工具轨迹），正文 parts 按序渲染；hover 操作条
+ * （MessageActions：复制 / 重新生成 / 编辑 / 重试）；system 居中弱提示。
+ * 颜色经 `--pactor-chat-*` 变量与 ui 语义令牌表达。
  */
 interface MessageBubbleProps {
     message: ChatMessage;
@@ -1686,4 +1658,4 @@ interface ChatLayoutRegistry {
 /** 注册 chat 布局（已注册时不覆盖，与 createLayoutRegistry 约定一致） */
 declare function registerChatLayout(layoutRegistry: ChatLayoutRegistry): void;
 
-export { ARTIFACT_IMAGE_EXTENSIONS, ActivityTrace, type ActivityTraceProps, AppShell, type AppShellProps, type ArtifactIconSpec, type ArtifactIconTone, ArtifactPanel, type ArtifactPanelProps, type ArtifactPatch, ArtifactStore, type ArtifactTreeNode, type ArtifactViewer, type ArtifactViewers, type BuiltinMessageAction, CHAT_COMPONENT_TYPE, CHAT_DENIED_TYPE, CHAT_LAYOUT_TYPE, CHAT_SHELL_COMPONENT_TYPE, type CapabilityActionDeps, type CapabilityHandler, Chat, type ChatAgentIdentity, type ChatArtifact, ChatArtifactCard, type ChatAttachment, type ChatCapabilityRegistry, type ChatConfirm, type ChatConfirmRequest, type ChatContextItem, type ChatContextSource, ChatDenied, type ChatEvent, type ChatHeaderAction, type ChatInput, ChatLayout, type ChatLayoutProps, type ChatLayoutRegistry, type ChatMenuItem, type ChatMessage, type ChatMessageAction, type ChatModelOption, type ChatPart, type ChatPermissionChecker, type ChatProps, type ChatRole, type ChatRuntime, type ChatScope, type ChatServices, ChatServicesProvider, ChatShell, type ChatShellProps, ChatSidebarMenu, type ChatSuggestion, type ChatTransport, type ChatTurnResult, ChatView, type ChatViewProps, type ChatWorkspaceProps, type ChatWorkspaceServices, Composer, type ComposerProps, ConversationStore, type CreateChatRuntimeOptions, DEFAULT_CHAT_GREETING, EmptyState, type EmptyStateProps, type ManualChatDriver, MessageActions, type MessageActionsProps, MessageBubble, type MessageBubbleProps, type MessagePatch, type MessageStatus, type PartPatch, type PartRef, PartRenderer, type PartRendererProps, type PartStatus, type RunChatTurnOptions, type StreamingMode, type ToolCallStatus, type ToolTraceEntry, type UseChatAutoScrollOptions, type UseChatAutoScrollResult, type UseSmoothStreamTextOptions, applyChatEvent, artifactCardMeta, buildArtifactBlob, buildArtifactTree, buildChatScope, collectArtifacts, collectMessageText, createChatComponentRegistry, createChatId, createChatRuntime, createChatWorkspace, createManualDriver, createSafeRegistry, detectStreamingMode, downloadArtifact, formatArtifactSize, formatMessageTime, guardChatDsl, isImageArtifact, mergeArtifacts, pairToolTraces, registerCapabilityAction, registerChatComponent, registerChatLayout, registerChatShellComponent, resolveArtifactFileType, resolveArtifactFilename, resolveArtifactIcon, resolveArtifactIconName, runChatTurn, runRegenerateTurn, saveBlob, useChatAutoScroll, useChatServices, useSidebarDrawer, useSmoothStreamText };
+export { ARTIFACT_IMAGE_EXTENSIONS, ActivityTrace, type ActivityTraceProps, AppShell, type AppShellProps, type ArtifactIconSpec, type ArtifactIconTone, ArtifactPanel, type ArtifactPanelProps, type ArtifactPatch, ArtifactStore, ArtifactViewers, type BuiltinMessageAction, CHAT_COMPONENT_TYPE, CHAT_DENIED_TYPE, CHAT_LAYOUT_TYPE, CHAT_SHELL_COMPONENT_TYPE, type CapabilityActionDeps, type CapabilityHandler, Chat, type ChatAgentIdentity, type ChatArtifact, ChatArtifactCard, type ChatAttachment, type ChatCapabilityRegistry, type ChatConfirm, type ChatConfirmRequest, type ChatContextItem, type ChatContextSource, ChatDenied, type ChatEvent, type ChatHeaderAction, type ChatInput, ChatLayout, type ChatLayoutProps, type ChatLayoutRegistry, type ChatMenuItem, type ChatMessage, type ChatMessageAction, type ChatModelOption, type ChatPart, type ChatPermissionChecker, type ChatProps, type ChatRole, type ChatRuntime, type ChatScope, type ChatServices, ChatServicesProvider, ChatShell, type ChatShellProps, ChatSidebarMenu, type ChatSuggestion, type ChatTransport, type ChatTurnResult, ChatView, type ChatViewProps, type ChatWorkspaceProps, type ChatWorkspaceServices, Composer, type ComposerProps, ConversationStore, type CreateChatRuntimeOptions, DEFAULT_CHAT_GREETING, EmptyState, type EmptyStateProps, type ManualChatDriver, MessageActions, type MessageActionsProps, MessageBubble, type MessageBubbleProps, type MessagePatch, type MessageStatus, type PartPatch, type PartRef, PartRenderer, type PartRendererProps, type PartStatus, type RunChatTurnOptions, type StreamingMode, type ToolCallStatus, type ToolTraceEntry, type UseChatAutoScrollOptions, type UseChatAutoScrollResult, type UseSmoothStreamTextOptions, applyChatEvent, artifactCardMeta, buildChatScope, collectArtifacts, collectMessageText, createChatComponentRegistry, createChatId, createChatRuntime, createChatWorkspace, createManualDriver, createSafeRegistry, detectStreamingMode, formatArtifactSize, formatMessageTime, guardChatDsl, isImageArtifact, mergeArtifacts, pairToolTraces, registerCapabilityAction, registerChatComponent, registerChatLayout, registerChatShellComponent, resolveArtifactFileType, resolveArtifactIcon, resolveArtifactIconName, runChatTurn, runRegenerateTurn, useChatAutoScroll, useChatServices, useSidebarDrawer, useSmoothStreamText };