@pactor-app/chat 1.18.0 → 1.18.1

package/README.md

@@ -73,7 +73,7 @@ driver.complete();
 - **`<ChatView store transport? onSend? safeRegistry? capabilities? permission? confirm? conversationId? user? params? greeting? subtitle? suggestions?>`**：消息列表 + Composer。发送时 `onSend` 回调先行，注入 `transport` 时同时驱动一轮 turn。空会话渲染 `<EmptyState>`：问候语（`--pactor-chat-font-display` 衬线展示字体）+ 副标题 + `suggestions` 起始建议（字符串或 `{ label, prompt? }`，点击即发送，空数组不渲染建议区）。Composer 扩展 props（`attachments` / `onAttachmentsChange` / `onAttachFiles` / `onAttachmentClick` / `toolbarStart` / `toolbarEnd` / `onMentionTrigger` / `onPlusMenu`）原样透传给内建 Composer，语义见下方 `<Composer>`。
 - **`<MessageBubble>` / `<PartRenderer>`**：按 role 区分气泡；parts 按类型渲染（text / markdown / dsl / error 附重试入口 / status / artifact 产出物卡片——整卡可点击：着色图标盒 + 标题 + 元信息行「尺寸 · 类型」+ 右上箭头，图标经 `resolveArtifactIcon` 按扩展名优先、kind 兜底解析并带 tone 着色档位，与面板下拉 / 目录树一致；卡片即 `ChatArtifactCard` 内部组件，DSL 片段与 fallback 共用，包入口导出可直接复用；同一消息内连续 artifact part 归并为卡片组，多于 4 个收起为前 4 张 + 「展开 / 收起」与「查看所有产物（n) ›」（打开面板定位产物目录视图，回调 `onOpenArtifactList`））；thinking 折叠卡与 tool-call / tool-result 配对轨迹移交 `<ActivityTrace>`；assistant 终态消息底部展示时间戳（当天 HH:mm、非当天带日期，`formatMessageTime`；流式中与无 createdAt 的历史消息不展示，user / system 不展示）。
 - **`<ActivityTrace>`**：流式状态头（动画图标 + 呼吸文案 + 秒级计时，结束定格）+ 配对工具轨迹条目（单行：名称 + 参数摘要 + 状态图标，展开显示参数与结果/错误）+ thinking 折叠卡（与工具列表为独立块）；状态头统一折叠/展开全部内容——流式展开 → 答案阶段自动折叠（单向闩锁：折叠一次后 mode 回跳不重新自动展开，防闪烁）→ 用户 pin 后不再自动变更（按消息记忆）。
-- **`<ArtifactPanel artifact? artifacts? inspector? artifactViewers? onClose? onSelectArtifact?>`**：产出物预览面板——标题栏（可选目录列表钮 + 标题 + kind 角标 + 下载钮 + 关闭钮）+ 内容区。内建渲染 markdown / code / text / dsl（Safe Registry 活预览）+ 图片类文件（png / jpg / svg / webp 等，经 `fileType` 或 title 扩展名识别，svg 支持原始标记）；`artifactViewers` 按键（扩展名 / kind）对特定格式自定义预览，优先内建；多产物时 header 文件名处为切换下拉，左端目录钮展示产物目录列表（目录视图下返回钮隐藏、标题显示"产物目录"）；下载钮把当前产物存为本地文件（dsl 存 JSON，图片 URL fetch 失败降级新标签）；桌面固定宽右栏（默认宽 = `--pactor-chat-content-width`，宽度夹取 `--pactor-chat-inspector-min-width` 480px ~ host 宽 2/3），背景 `--pactor-chat-inspector-bg` 略深于聊天区，窄屏覆盖抽屉。
+- **`<ArtifactPanel artifact? artifacts? inspector? artifactViewers? onClose? onSelectArtifact?>`**：产出物预览面板——标题栏（可选目录列表钮 + 标题 + kind 角标 + 下载钮 + 关闭钮）+ 内容区。内建渲染 markdown / code / text / dsl（Safe Registry 活预览）+ 图片类文件（png / jpg / svg / webp 等，经 `fileType` 或 title 扩展名识别，svg 支持原始标记）；`artifactViewers` 按键（扩展名 / kind）对特定格式自定义预览，优先内建；多产物时 header 文件名处为切换下拉，左端目录钮展示产物目录列表（目录视图下返回钮隐藏、标题显示"产物目录"）；下载钮把当前产物存为本地文件（dsl 存 JSON，图片 URL fetch 失败降级新标签）；桌面固定宽右栏（默认宽 = `--pactor-chat-content-width`，宽度夹取 `--pactor-chat-inspector-min-width` 480px ~ min(`--pactor-chat-inspector-max-width` 600px, host 宽 2/3)），背景 `--pactor-chat-inspector-bg` 略深于聊天区，窄屏覆盖抽屉。
 - **`ArtifactStore` / `collectArtifacts` / `mergeArtifacts`**（零 React）：产出物列表容器——`open` 按 id upsert 并激活、`list()`（引用稳定）/ `activate(id)` / `update(patch)`（补丁激活项）/ `close()`（只关面板，列表保留）/ `subscribe`；`collectArtifacts(messages)` 从消息流归集 ready 产出物（tabs / 目录列表默认数据源），`mergeArtifacts(stream, opened)` 合并归集与打开记录（store 补丁版本优先）。
 - **`downloadArtifact` / `resolveArtifactFilename` / `buildArtifactBlob`**（产物下载）：文件名按 title（无扩展名补 fileType / kind 缺省）；文本类存 UTF-8 Blob，dsl 存格式化 JSON，svg 原始标记存 image/svg+xml，图片 http(s) URL fetch 取回（失败降级新标签打开）。
 - **`<MessageActions>`**：消息操作条（hover 显现），数据驱动渲染——`actions` 缺省为 `['copy', 'regenerate', 'retry', 'edit']`：复制（`collectMessageText` 汇总文本写入剪贴板）、末条 completed assistant 重新生成、user 消息气泡内联编辑重发（确认 → 截断 + 重跑，取消不改 store）、error 消息重试。传入数组时严格按数组渲染（数组即真相），内建动作可按字段覆盖 label / icon / roles / visibleWhen，自定义动作经 `callService(service, { actionId, message })` 派发；图标名走 `MESSAGE_ACTION_ICONS` 白名单（未知名渲染占位图标）。详见下文「消息操作条：messageActions」。
@@ -136,7 +136,7 @@ body:
 ```
 
 - **菜单**：`menu: ChatMenuItem[]`（`key / label / icon? / badge? / disabled? / group?`）驱动内建侧栏；`icon` 为字符串名，映射内置 lucide 子集（plus / chat / history / settings / star / search / user / folder），未知名渲染占位圆点不抛错；`group` 渲染分组标题行；`activeMenuKey` 为受控 prop，典型用法是 `${state.x}` 绑定 + `events.onMenuSelect` 调 `setState` 闭环；disabled 项不触发 `onMenuSelect`。
-- **Header 三层**：`title` 标量 → `headerExtra?: DslNode | ReactNode`（标题右侧槽）→ `header?: DslNode | ReactNode`（整体替换内建 header）；`showHeader: false` 关闭。header 收进产物面板 host 的 `__main` 左列（header + 对话区纵向堆叠）：面板打开时与对话区同宽、不覆盖面板上方（面板独占右列全高），面板关闭时随 `__main` 通栏；均不随对话列限宽。DslNode 槽仅在页面运行时（DslRenderer）上下文内经 `useRenderer().renderChildren` 渲染；纯 React 场景传 ReactNode，误传 DslNode 时告警并跳过（不抛错）。
+- **Header 三层**：`title` 标量 → `headerExtra?: DslNode | ReactNode`（标题右侧槽）→ `header?: DslNode | ReactNode`（整体替换内建 header）；`showHeader: false` 关闭。header 收进产物面板 host 的 `__main` 左列（header + 对话区纵向堆叠）：面板打开时随 `__main` 通栏（左贴宿主边缘、右贴面板分隔线）、不覆盖面板上方（面板独占右列全高），面板关闭时同样通栏；均不随对话列限宽。DslNode 槽仅在页面运行时（DslRenderer）上下文内经 `useRenderer().renderChildren` 渲染；纯 React 场景传 ReactNode，误传 DslNode 时告警并跳过（不抛错）。
 - **侧栏槽**：`sidebar?: DslNode | ReactNode` 提供时整体替代内建菜单侧栏（仍以 AppShell 承载）。
 - **产出物面板**：`artifact` / `panelOpen` 受控 props（典型 `${state.x}` 绑定），事件 `onArtifact`（part 就绪）/ `onOpenArtifact`（卡片打开）/ `onOpenArtifactList`（卡片区"查看所有产物"，典型接法 `setState panelOpen=true`，面板自动定位产物目录视图）/ `onPanelClose` / `onSelectArtifact`（下拉 / 目录列表切换，典型接法 `setState artifact=${event.artifact}`）；多产物清单由组合层自动从消息流归集，无需 DSL 接线；自定义预览经 `ChatServicesProvider` 注入 `artifactViewers`（函数不进 DSL）。详见上文 `<ArtifactPanel>` 与 `examples/chat/src/chat.page.yaml`。
 - **React 直连**：`<ChatServicesProvider>` + `<Chat>` 同样可直接作为 React 组件使用（events 即普通函数 props：`onSend?(text)` / `onMenuSelect?(key, item)`）。`createChatWorkspace` 工厂保留为兼容路径，内部已改为 provider + 同一组合逻辑（`ChatComposition`），行为不变。

package/dist/index.cjs

@@ -2015,7 +2015,7 @@ function ArtifactPanel({
     const onMove = (moveEvent) => {
       const hostRect = panel.parentElement?.getBoundingClientRect();
       const hostWidth = hostRect !== void 0 && hostRect.width > 0 ? hostRect.width : window.innerWidth;
-      const maxWidth = hostWidth * 2 / 3;
+      const maxWidth = Math.min(600, hostWidth * 2 / 3);
       const next = startWidth + (startX - moveEvent.clientX);
       setWidth(Math.round(Math.min(Math.max(next, 480), maxWidth)));
     };
@@ -2098,7 +2098,7 @@ function ArtifactPanel({
 }
 
 // src/view/ChatView.tsx
-var import_components11 = require("@pactor-app/ui/components");
+var import_components12 = require("@pactor-app/ui/components");
 var import_core4 = require("@pactor-app/core");
 var import_react17 = require("react");
 
@@ -3109,6 +3109,7 @@ function EmptyState({
 
 // src/view/MessageBubble.tsx
 var import_react16 = require("react");
+var import_components11 = require("@pactor-app/ui/components");
 
 // src/view/ActivityTrace.tsx
 var import_components9 = require("@pactor-app/ui/components");
@@ -3645,8 +3646,26 @@ function MessageEditForm({
     ] })
   ] });
 }
+function isAgentIconUrl(icon) {
+  return /^(https?:|data:|\/)/.test(icon);
+}
+function AgentHeader({ agent }) {
+  return /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("div", { className: "pactor-chat-message__agent", children: [
+    agent.icon !== void 0 && (isAgentIconUrl(agent.icon) ? /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(
+      "img",
+      {
+        className: "pactor-chat-message__agent-icon",
+        src: agent.icon,
+        alt: "",
+        "aria-hidden": true
+      }
+    ) : /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("span", { className: "pactor-chat-message__agent-icon", "aria-hidden": true, children: /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(import_components11.Icon, { name: agent.icon }) })),
+    /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("span", { className: "pactor-chat-message__agent-name", children: agent.name })
+  ] });
+}
 function MessageBubble({
   message,
+  agent,
   runtime,
   scope,
   showRegenerate = false,
@@ -3673,6 +3692,7 @@ function MessageBubble({
     (part) => part.type === "thinking" || part.type === "tool-call" || part.type === "tool-result"
   ));
   const showTime = message.role === "assistant" && !live && message.createdAt !== void 0;
+  const agentIdentity = message.role === "assistant" ? message.agent ?? agent : void 0;
   return /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)(
     "div",
     {
@@ -3691,6 +3711,7 @@ function MessageBubble({
             onCancel: () => setEditing(false)
           }
         ) : /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("div", { className: "pactor-chat-message__body", children: [
+          agentIdentity && /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(AgentHeader, { agent: agentIdentity }),
           showTrace && /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(ActivityTrace, { message }),
           message.parts.length === 0 && message.status === "pending" && message.role !== "assistant" ? /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("span", { className: "pactor-chat-message__pending", children: "\u2026" }) : groupArtifactParts(message.parts).map(
             (segment, index) => Array.isArray(segment) ? /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(
@@ -3770,6 +3791,7 @@ function lastContentLength(messages) {
 function ChatView({
   store,
   transport,
+  agent,
   onSend,
   safeRegistry,
   capabilities,
@@ -3977,6 +3999,7 @@ function ChatView({
             MessageBubble,
             {
               message,
+              agent,
               runtime,
               scope,
               showRegenerate: message.id === regenerableMessageId,
@@ -3996,7 +4019,7 @@ function ChatView({
               className: "pactor-chat-scroll-bottom",
               onClick: scrollToBottom,
               children: [
-                /* @__PURE__ */ (0, import_jsx_runtime16.jsx)(import_components11.Icon, { name: "arrow-down", size: 13 }),
+                /* @__PURE__ */ (0, import_jsx_runtime16.jsx)(import_components12.Icon, { name: "arrow-down", size: 13 }),
                 "\u56DE\u5230\u5E95\u90E8"
               ]
             }
@@ -4009,7 +4032,7 @@ function ChatView({
 }
 
 // src/view/WorkspaceHeader.tsx
-var import_components12 = require("@pactor-app/ui/components");
+var import_components13 = require("@pactor-app/ui/components");
 var import_react18 = require("react");
 
 // src/export-markdown.ts
@@ -4170,7 +4193,7 @@ function WorkspaceHeader({
         title: "\u5BFC\u51FA Markdown",
         "aria-label": "\u5BFC\u51FA Markdown",
         onClick: handleExport,
-        children: /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(import_components12.Icon, { name: "download", size: 15 })
+        children: /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(import_components13.Icon, { name: "download", size: 15 })
       },
       "export"
     ),
@@ -4182,7 +4205,7 @@ function WorkspaceHeader({
         title: theme === "dark" ? "\u5207\u6362\u4E3A\u6D45\u8272" : "\u5207\u6362\u4E3A\u6DF1\u8272",
         "aria-label": "\u5207\u6362\u660E\u6697\u4E3B\u9898",
         onClick: handleTheme,
-        children: theme === "dark" ? /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(import_components12.Icon, { name: "sun", size: 15 }) : /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(import_components12.Icon, { name: "moon", size: 15 })
+        children: theme === "dark" ? /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(import_components13.Icon, { name: "sun", size: 15 }) : /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(import_components13.Icon, { name: "moon", size: 15 })
       },
       "theme"
     ),
@@ -4194,7 +4217,7 @@ function WorkspaceHeader({
         title: "\u6E05\u7A7A\u4F1A\u8BDD",
         "aria-label": "\u6E05\u7A7A\u4F1A\u8BDD",
         onClick: handleClear,
-        children: /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(import_components12.Icon, { name: "trash", size: 15 })
+        children: /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(import_components13.Icon, { name: "trash", size: 15 })
       },
       "clear"
     )
@@ -4295,6 +4318,7 @@ function ChatComposition({
   services,
   title,
   greeting,
+  agent,
   subtitle,
   suggestions,
   conversationId,
@@ -4464,6 +4488,7 @@ function ChatComposition({
         {
           store,
           transport: services.transport,
+          agent,
           onSend: handleSend,
           safeRegistry: services.safeRegistry,
           capabilities: services.capabilities,
@@ -4645,7 +4670,7 @@ function createChatWorkspace(services) {
 }
 
 // src/view/Chat.tsx
-var import_components13 = require("@pactor-app/ui/components");
+var import_components14 = require("@pactor-app/ui/components");
 var import_react21 = require("react");
 
 // src/view/chrome/menu.tsx
@@ -4774,7 +4799,7 @@ function ChatSidebarMenu({
             drawer?.close();
           },
           children: [
-            item.icon !== void 0 ? /* @__PURE__ */ (0, import_jsx_runtime22.jsx)("span", { className: "pactor-chat-menu__icon", children: /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(import_components13.Icon, { name: item.icon, size: 15, strokeWidth: 1.7 }) }) : null,
+            item.icon !== void 0 ? /* @__PURE__ */ (0, import_jsx_runtime22.jsx)("span", { className: "pactor-chat-menu__icon", children: /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(import_components14.Icon, { name: item.icon, size: 15, strokeWidth: 1.7 }) }) : null,
             /* @__PURE__ */ (0, import_jsx_runtime22.jsx)("span", { className: "pactor-chat-menu__label", children: item.label }),
             item.dot === true ? /* @__PURE__ */ (0, import_jsx_runtime22.jsx)("span", { className: "pactor-chat-menu__dot", "aria-hidden": true }) : null,
             item.badge !== void 0 ? /* @__PURE__ */ (0, import_jsx_runtime22.jsx)("span", { className: "pactor-chat-menu__badge", children: item.badge }) : null
@@ -4783,7 +4808,7 @@ function ChatSidebarMenu({
       );
       return /* @__PURE__ */ (0, import_jsx_runtime22.jsxs)(import_react21.Fragment, { children: [
         groupLabel !== void 0 ? /* @__PURE__ */ (0, import_jsx_runtime22.jsx)("div", { className: "pactor-chat-menu__group", children: groupLabel }) : null,
-        collapsed ? /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(import_components13.RailTooltip, { label: item.label, children: button }) : button
+        collapsed ? /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(import_components14.RailTooltip, { label: item.label, children: button }) : button
       ] }, item.key);
     }) });
   })();
@@ -4798,6 +4823,7 @@ function ChatSidebarMenu({
 function Chat({
   title,
   greeting,
+  agent,
   subtitle,
   suggestions,
   conversationId,
@@ -4865,6 +4891,7 @@ function Chat({
       services,
       title,
       greeting,
+      agent,
       subtitle,
       suggestions,
       conversationId,
@@ -4951,7 +4978,7 @@ function registerChatComponent(registry) {
   registerChatShellComponent(registry);
 }
 function createChatComponentRegistry() {
-  const registry = (0, import_components13.createComponentRegistry)();
+  const registry = (0, import_components14.createComponentRegistry)();
   registerChatComponent(registry);
   return registry;
 }

package/dist/index.d.cts

@@ -251,6 +251,19 @@ interface ChatMessageAction {
     /** 自定义动作的派发服务名（经注入的 callService 解析） */
     service?: string;
 }
+/**
+ * 消息归属 Agent 身份：assistant 消息顶部以「图标 + 加粗名称」展示
+ * 返回该消息的 Agent。DSL 可表达的纯数据对象。
+ */
+interface ChatAgentIdentity {
+    /** Agent 展示名（加粗渲染） */
+    name: string;
+    /**
+     * 图标：@pactor-app/ui Icon 白名单名（未知名渲染占位图标），
+     * 或图片 URL（http(s): / data: / 绝对路径开头按 <img> 渲染）
+     */
+    icon?: string;
+}
 /** Chat 消息 */
 interface ChatMessage {
     id: string;
@@ -259,6 +272,8 @@ interface ChatMessage {
     parts: ChatPart[];
     createdAt?: number;
     attachments?: ChatAttachment[];
+    /** 返回该消息的 Agent 身份（assistant 消息顶部展示） */
+    agent?: ChatAgentIdentity;
 }
 /** updatePart 的定位参数：数组下标或 part id */
 type PartRef = number | string;
@@ -1053,6 +1068,12 @@ interface ChatProps {
     title?: string;
     /** 空会话问候语 */
     greeting?: string;
+    /**
+     * 会话级 Agent 身份（DSL 可表达对象）：assistant 消息顶部以
+     * 「图标 + 加粗名称」展示返回消息的 Agent；消息自带
+     * message.agent 时以消息为准；未配置不渲染身份行
+     */
+    agent?: ChatAgentIdentity;
     /** 空会话副标题 */
     subtitle?: string;
     /** 空会话起始建议；空数组 / 未传时不渲染建议区 */
@@ -1176,7 +1197,7 @@ declare function ChatSidebarMenu({ menu, activeMenuKey, onMenuSelect, }: {
  * 「未配置聊天服务」提示并 console.warn，不抛错。组合逻辑与
  * createChatWorkspace 共用内部 ChatComposition（决策 D5）。
  */
-declare function Chat({ title, greeting, subtitle, suggestions, conversationId, params, showHeader, menu, activeMenuKey, sidebar, toolbarStart, toolbarEnd, composerFooter, composerBottom, hideToolbar, headerExtra, header, headerActions, editableTitle, onExport, onThemeChange, onClear, onTitleChange, models, model, onModelChange, modelPlacement, contexts, onContextsChange, messageActions, onMessageAction, artifact, panelOpen, onPanelClose, inspector, onArtifact, onOpenArtifact, onOpenArtifactList, onSelectArtifact, className, onSend, onMenuSelect, }: ChatProps): ReactNode;
+declare function Chat({ title, greeting, agent, subtitle, suggestions, conversationId, params, showHeader, menu, activeMenuKey, sidebar, toolbarStart, toolbarEnd, composerFooter, composerBottom, hideToolbar, headerExtra, header, headerActions, editableTitle, onExport, onThemeChange, onClear, onTitleChange, models, model, onModelChange, modelPlacement, contexts, onContextsChange, messageActions, onMessageAction, artifact, panelOpen, onPanelClose, inspector, onArtifact, onOpenArtifact, onOpenArtifactList, onSelectArtifact, className, onSend, onMenuSelect, }: ChatProps): ReactNode;
 /** Chat 的 DSL 组件类型名 */
 declare const CHAT_COMPONENT_TYPE = "Chat";
 /**
@@ -1421,6 +1442,11 @@ interface ChatViewProps extends Pick<ComposerProps, 'attachments' | 'onAttachmen
     store: ConversationStore;
     /** 注入后发送即驱动 turn；缺省时仅触发 onSend */
     transport?: ChatTransport;
+    /**
+     * 会话级 Agent 身份（assistant 消息顶部「图标 + 加粗名称」展示的兜底，
+     * 消息自带 message.agent 时以消息为准）；未配置不渲染身份行
+     */
+    agent?: ChatAgentIdentity;
     onSend?: (text: string) => void;
     /** Safe Registry（createSafeRegistry 包装后的白名单注册表） */
     safeRegistry?: Registry<unknown>;
@@ -1489,7 +1515,7 @@ interface ChatViewProps extends Pick<ComposerProps, 'attachments' | 'onAttachmen
     composerBottom?: ReactNode;
     className?: string;
 }
-declare function ChatView({ store, transport, onSend, safeRegistry, capabilities, permission, confirm, conversationId, user, params, greeting, subtitle, suggestions, className, onArtifact, onOpenArtifact, onOpenArtifactList, attachments, onAttachmentsChange, onAttachFiles, onAttachmentClick, toolbarStart, toolbarEnd, composerFooter, hideToolbar, onMentionTrigger, onPlusMenu, models, model, onModelChange, modelPlacement, contexts, onContextsChange, callService, messageActions, onMessageAction, composerBottom, }: ChatViewProps): react.JSX.Element;
+declare function ChatView({ store, transport, agent, onSend, safeRegistry, capabilities, permission, confirm, conversationId, user, params, greeting, subtitle, suggestions, className, onArtifact, onOpenArtifact, onOpenArtifactList, attachments, onAttachmentsChange, onAttachFiles, onAttachmentClick, toolbarStart, toolbarEnd, composerFooter, hideToolbar, onMentionTrigger, onPlusMenu, models, model, onModelChange, modelPlacement, contexts, onContextsChange, callService, messageActions, onMessageAction, composerBottom, }: ChatViewProps): react.JSX.Element;
 
 /**
  * ActivityTrace（spec: chat-activity-trace，设计决策 D1/D4）：
@@ -1524,6 +1550,11 @@ declare function ActivityTrace({ message }: ActivityTraceProps): react.JSX.Eleme
  */
 interface MessageBubbleProps {
     message: ChatMessage;
+    /**
+     * 会话级 Agent 身份兜底：assistant 消息未自带 message.agent 时
+     * 以其在消息顶部展示「图标 + 加粗名称」（单 Agent 会话的便捷配置）
+     */
+    agent?: ChatAgentIdentity;
     /** 透传给 dsl part 的渲染运行时与作用域 */
     runtime?: ChatRuntime;
     scope?: Omit<ChatScope, 'message'>;
@@ -1555,7 +1586,7 @@ interface MessageBubbleProps {
  * 当天 HH:mm；非当天 M月d日 HH:mm
  */
 declare function formatMessageTime(ts: number, now?: number): string;
-declare function MessageBubble({ message, runtime, scope, showRegenerate, onRegenerate, onRetry, onEditResend, messageActions, callService, onMessageAction, }: MessageBubbleProps): react.JSX.Element;
+declare function MessageBubble({ message, agent, runtime, scope, showRegenerate, onRegenerate, onRetry, onEditResend, messageActions, callService, onMessageAction, }: MessageBubbleProps): react.JSX.Element;
 
 /**
  * MessageActions（spec: chat-message-actions / 消息操作条）：
@@ -1655,4 +1686,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 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, 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 };

package/dist/index.d.ts

@@ -251,6 +251,19 @@ interface ChatMessageAction {
     /** 自定义动作的派发服务名（经注入的 callService 解析） */
     service?: string;
 }
+/**
+ * 消息归属 Agent 身份：assistant 消息顶部以「图标 + 加粗名称」展示
+ * 返回该消息的 Agent。DSL 可表达的纯数据对象。
+ */
+interface ChatAgentIdentity {
+    /** Agent 展示名（加粗渲染） */
+    name: string;
+    /**
+     * 图标：@pactor-app/ui Icon 白名单名（未知名渲染占位图标），
+     * 或图片 URL（http(s): / data: / 绝对路径开头按 <img> 渲染）
+     */
+    icon?: string;
+}
 /** Chat 消息 */
 interface ChatMessage {
     id: string;
@@ -259,6 +272,8 @@ interface ChatMessage {
     parts: ChatPart[];
     createdAt?: number;
     attachments?: ChatAttachment[];
+    /** 返回该消息的 Agent 身份（assistant 消息顶部展示） */
+    agent?: ChatAgentIdentity;
 }
 /** updatePart 的定位参数：数组下标或 part id */
 type PartRef = number | string;
@@ -1053,6 +1068,12 @@ interface ChatProps {
     title?: string;
     /** 空会话问候语 */
     greeting?: string;
+    /**
+     * 会话级 Agent 身份（DSL 可表达对象）：assistant 消息顶部以
+     * 「图标 + 加粗名称」展示返回消息的 Agent；消息自带
+     * message.agent 时以消息为准；未配置不渲染身份行
+     */
+    agent?: ChatAgentIdentity;
     /** 空会话副标题 */
     subtitle?: string;
     /** 空会话起始建议；空数组 / 未传时不渲染建议区 */
@@ -1176,7 +1197,7 @@ declare function ChatSidebarMenu({ menu, activeMenuKey, onMenuSelect, }: {
  * 「未配置聊天服务」提示并 console.warn，不抛错。组合逻辑与
  * createChatWorkspace 共用内部 ChatComposition（决策 D5）。
  */
-declare function Chat({ title, greeting, subtitle, suggestions, conversationId, params, showHeader, menu, activeMenuKey, sidebar, toolbarStart, toolbarEnd, composerFooter, composerBottom, hideToolbar, headerExtra, header, headerActions, editableTitle, onExport, onThemeChange, onClear, onTitleChange, models, model, onModelChange, modelPlacement, contexts, onContextsChange, messageActions, onMessageAction, artifact, panelOpen, onPanelClose, inspector, onArtifact, onOpenArtifact, onOpenArtifactList, onSelectArtifact, className, onSend, onMenuSelect, }: ChatProps): ReactNode;
+declare function Chat({ title, greeting, agent, subtitle, suggestions, conversationId, params, showHeader, menu, activeMenuKey, sidebar, toolbarStart, toolbarEnd, composerFooter, composerBottom, hideToolbar, headerExtra, header, headerActions, editableTitle, onExport, onThemeChange, onClear, onTitleChange, models, model, onModelChange, modelPlacement, contexts, onContextsChange, messageActions, onMessageAction, artifact, panelOpen, onPanelClose, inspector, onArtifact, onOpenArtifact, onOpenArtifactList, onSelectArtifact, className, onSend, onMenuSelect, }: ChatProps): ReactNode;
 /** Chat 的 DSL 组件类型名 */
 declare const CHAT_COMPONENT_TYPE = "Chat";
 /**
@@ -1421,6 +1442,11 @@ interface ChatViewProps extends Pick<ComposerProps, 'attachments' | 'onAttachmen
     store: ConversationStore;
     /** 注入后发送即驱动 turn；缺省时仅触发 onSend */
     transport?: ChatTransport;
+    /**
+     * 会话级 Agent 身份（assistant 消息顶部「图标 + 加粗名称」展示的兜底，
+     * 消息自带 message.agent 时以消息为准）；未配置不渲染身份行
+     */
+    agent?: ChatAgentIdentity;
     onSend?: (text: string) => void;
     /** Safe Registry（createSafeRegistry 包装后的白名单注册表） */
     safeRegistry?: Registry<unknown>;
@@ -1489,7 +1515,7 @@ interface ChatViewProps extends Pick<ComposerProps, 'attachments' | 'onAttachmen
     composerBottom?: ReactNode;
     className?: string;
 }
-declare function ChatView({ store, transport, onSend, safeRegistry, capabilities, permission, confirm, conversationId, user, params, greeting, subtitle, suggestions, className, onArtifact, onOpenArtifact, onOpenArtifactList, attachments, onAttachmentsChange, onAttachFiles, onAttachmentClick, toolbarStart, toolbarEnd, composerFooter, hideToolbar, onMentionTrigger, onPlusMenu, models, model, onModelChange, modelPlacement, contexts, onContextsChange, callService, messageActions, onMessageAction, composerBottom, }: ChatViewProps): react.JSX.Element;
+declare function ChatView({ store, transport, agent, onSend, safeRegistry, capabilities, permission, confirm, conversationId, user, params, greeting, subtitle, suggestions, className, onArtifact, onOpenArtifact, onOpenArtifactList, attachments, onAttachmentsChange, onAttachFiles, onAttachmentClick, toolbarStart, toolbarEnd, composerFooter, hideToolbar, onMentionTrigger, onPlusMenu, models, model, onModelChange, modelPlacement, contexts, onContextsChange, callService, messageActions, onMessageAction, composerBottom, }: ChatViewProps): react.JSX.Element;
 
 /**
  * ActivityTrace（spec: chat-activity-trace，设计决策 D1/D4）：
@@ -1524,6 +1550,11 @@ declare function ActivityTrace({ message }: ActivityTraceProps): react.JSX.Eleme
  */
 interface MessageBubbleProps {
     message: ChatMessage;
+    /**
+     * 会话级 Agent 身份兜底：assistant 消息未自带 message.agent 时
+     * 以其在消息顶部展示「图标 + 加粗名称」（单 Agent 会话的便捷配置）
+     */
+    agent?: ChatAgentIdentity;
     /** 透传给 dsl part 的渲染运行时与作用域 */
     runtime?: ChatRuntime;
     scope?: Omit<ChatScope, 'message'>;
@@ -1555,7 +1586,7 @@ interface MessageBubbleProps {
  * 当天 HH:mm；非当天 M月d日 HH:mm
  */
 declare function formatMessageTime(ts: number, now?: number): string;
-declare function MessageBubble({ message, runtime, scope, showRegenerate, onRegenerate, onRetry, onEditResend, messageActions, callService, onMessageAction, }: MessageBubbleProps): react.JSX.Element;
+declare function MessageBubble({ message, agent, runtime, scope, showRegenerate, onRegenerate, onRetry, onEditResend, messageActions, callService, onMessageAction, }: MessageBubbleProps): react.JSX.Element;
 
 /**
  * MessageActions（spec: chat-message-actions / 消息操作条）：
@@ -1655,4 +1686,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 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, 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 };

package/dist/index.js

@@ -1950,7 +1950,7 @@ function ArtifactPanel({
     const onMove = (moveEvent) => {
       const hostRect = panel.parentElement?.getBoundingClientRect();
       const hostWidth = hostRect !== void 0 && hostRect.width > 0 ? hostRect.width : window.innerWidth;
-      const maxWidth = hostWidth * 2 / 3;
+      const maxWidth = Math.min(600, hostWidth * 2 / 3);
       const next = startWidth + (startX - moveEvent.clientX);
       setWidth(Math.round(Math.min(Math.max(next, 480), maxWidth)));
     };
@@ -2033,7 +2033,7 @@ function ArtifactPanel({
 }
 
 // src/view/ChatView.tsx
-import { Icon as Icon10 } from "@pactor-app/ui/components";
+import { Icon as Icon11 } from "@pactor-app/ui/components";
 import { Registry as Registry3 } from "@pactor-app/core";
 import { useEffect as useEffect9, useMemo as useMemo3, useRef as useRef11, useState as useState14, useSyncExternalStore } from "react";
 
@@ -3049,6 +3049,7 @@ function EmptyState({
 
 // src/view/MessageBubble.tsx
 import { useRef as useRef10, useState as useState13 } from "react";
+import { Icon as Icon10 } from "@pactor-app/ui/components";
 
 // src/view/ActivityTrace.tsx
 import { Icon as Icon8 } from "@pactor-app/ui/components";
@@ -3585,8 +3586,26 @@ function MessageEditForm({
     ] })
   ] });
 }
+function isAgentIconUrl(icon) {
+  return /^(https?:|data:|\/)/.test(icon);
+}
+function AgentHeader({ agent }) {
+  return /* @__PURE__ */ jsxs11("div", { className: "pactor-chat-message__agent", children: [
+    agent.icon !== void 0 && (isAgentIconUrl(agent.icon) ? /* @__PURE__ */ jsx15(
+      "img",
+      {
+        className: "pactor-chat-message__agent-icon",
+        src: agent.icon,
+        alt: "",
+        "aria-hidden": true
+      }
+    ) : /* @__PURE__ */ jsx15("span", { className: "pactor-chat-message__agent-icon", "aria-hidden": true, children: /* @__PURE__ */ jsx15(Icon10, { name: agent.icon }) })),
+    /* @__PURE__ */ jsx15("span", { className: "pactor-chat-message__agent-name", children: agent.name })
+  ] });
+}
 function MessageBubble({
   message,
+  agent,
   runtime,
   scope,
   showRegenerate = false,
@@ -3613,6 +3632,7 @@ function MessageBubble({
     (part) => part.type === "thinking" || part.type === "tool-call" || part.type === "tool-result"
   ));
   const showTime = message.role === "assistant" && !live && message.createdAt !== void 0;
+  const agentIdentity = message.role === "assistant" ? message.agent ?? agent : void 0;
   return /* @__PURE__ */ jsxs11(
     "div",
     {
@@ -3631,6 +3651,7 @@ function MessageBubble({
             onCancel: () => setEditing(false)
           }
         ) : /* @__PURE__ */ jsxs11("div", { className: "pactor-chat-message__body", children: [
+          agentIdentity && /* @__PURE__ */ jsx15(AgentHeader, { agent: agentIdentity }),
           showTrace && /* @__PURE__ */ jsx15(ActivityTrace, { message }),
           message.parts.length === 0 && message.status === "pending" && message.role !== "assistant" ? /* @__PURE__ */ jsx15("span", { className: "pactor-chat-message__pending", children: "\u2026" }) : groupArtifactParts(message.parts).map(
             (segment, index) => Array.isArray(segment) ? /* @__PURE__ */ jsx15(
@@ -3710,6 +3731,7 @@ function lastContentLength(messages) {
 function ChatView({
   store,
   transport,
+  agent,
   onSend,
   safeRegistry,
   capabilities,
@@ -3917,6 +3939,7 @@ function ChatView({
             MessageBubble,
             {
               message,
+              agent,
               runtime,
               scope,
               showRegenerate: message.id === regenerableMessageId,
@@ -3936,7 +3959,7 @@ function ChatView({
               className: "pactor-chat-scroll-bottom",
               onClick: scrollToBottom,
               children: [
-                /* @__PURE__ */ jsx16(Icon10, { name: "arrow-down", size: 13 }),
+                /* @__PURE__ */ jsx16(Icon11, { name: "arrow-down", size: 13 }),
                 "\u56DE\u5230\u5E95\u90E8"
               ]
             }
@@ -3949,7 +3972,7 @@ function ChatView({
 }
 
 // src/view/WorkspaceHeader.tsx
-import { Icon as Icon11 } from "@pactor-app/ui/components";
+import { Icon as Icon12 } from "@pactor-app/ui/components";
 import { useEffect as useEffect10, useRef as useRef12, useState as useState15 } from "react";
 
 // src/export-markdown.ts
@@ -4110,7 +4133,7 @@ function WorkspaceHeader({
         title: "\u5BFC\u51FA Markdown",
         "aria-label": "\u5BFC\u51FA Markdown",
         onClick: handleExport,
-        children: /* @__PURE__ */ jsx17(Icon11, { name: "download", size: 15 })
+        children: /* @__PURE__ */ jsx17(Icon12, { name: "download", size: 15 })
       },
       "export"
     ),
@@ -4122,7 +4145,7 @@ function WorkspaceHeader({
         title: theme === "dark" ? "\u5207\u6362\u4E3A\u6D45\u8272" : "\u5207\u6362\u4E3A\u6DF1\u8272",
         "aria-label": "\u5207\u6362\u660E\u6697\u4E3B\u9898",
         onClick: handleTheme,
-        children: theme === "dark" ? /* @__PURE__ */ jsx17(Icon11, { name: "sun", size: 15 }) : /* @__PURE__ */ jsx17(Icon11, { name: "moon", size: 15 })
+        children: theme === "dark" ? /* @__PURE__ */ jsx17(Icon12, { name: "sun", size: 15 }) : /* @__PURE__ */ jsx17(Icon12, { name: "moon", size: 15 })
       },
       "theme"
     ),
@@ -4134,7 +4157,7 @@ function WorkspaceHeader({
         title: "\u6E05\u7A7A\u4F1A\u8BDD",
         "aria-label": "\u6E05\u7A7A\u4F1A\u8BDD",
         onClick: handleClear,
-        children: /* @__PURE__ */ jsx17(Icon11, { name: "trash", size: 15 })
+        children: /* @__PURE__ */ jsx17(Icon12, { name: "trash", size: 15 })
       },
       "clear"
     )
@@ -4235,6 +4258,7 @@ function ChatComposition({
   services,
   title,
   greeting,
+  agent,
   subtitle,
   suggestions,
   conversationId,
@@ -4404,6 +4428,7 @@ function ChatComposition({
         {
           store,
           transport: services.transport,
+          agent,
           onSend: handleSend,
           safeRegistry: services.safeRegistry,
           capabilities: services.capabilities,
@@ -4585,7 +4610,7 @@ function createChatWorkspace(services) {
 }
 
 // src/view/Chat.tsx
-import { createComponentRegistry, Icon as Icon12, RailTooltip } from "@pactor-app/ui/components";
+import { createComponentRegistry, Icon as Icon13, RailTooltip } from "@pactor-app/ui/components";
 import { Fragment as Fragment10, useEffect as useEffect11, useRef as useRef14 } from "react";
 
 // src/view/chrome/menu.tsx
@@ -4714,7 +4739,7 @@ function ChatSidebarMenu({
             drawer?.close();
           },
           children: [
-            item.icon !== void 0 ? /* @__PURE__ */ jsx22("span", { className: "pactor-chat-menu__icon", children: /* @__PURE__ */ jsx22(Icon12, { name: item.icon, size: 15, strokeWidth: 1.7 }) }) : null,
+            item.icon !== void 0 ? /* @__PURE__ */ jsx22("span", { className: "pactor-chat-menu__icon", children: /* @__PURE__ */ jsx22(Icon13, { name: item.icon, size: 15, strokeWidth: 1.7 }) }) : null,
             /* @__PURE__ */ jsx22("span", { className: "pactor-chat-menu__label", children: item.label }),
             item.dot === true ? /* @__PURE__ */ jsx22("span", { className: "pactor-chat-menu__dot", "aria-hidden": true }) : null,
             item.badge !== void 0 ? /* @__PURE__ */ jsx22("span", { className: "pactor-chat-menu__badge", children: item.badge }) : null
@@ -4738,6 +4763,7 @@ function ChatSidebarMenu({
 function Chat({
   title,
   greeting,
+  agent,
   subtitle,
   suggestions,
   conversationId,
@@ -4805,6 +4831,7 @@ function Chat({
       services,
       title,
       greeting,
+      agent,
       subtitle,
       suggestions,
       conversationId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pactor-app/chat",
-  "version": "1.18.0",
+  "version": "1.18.1",
   "description": "Pactor chat: AI message rendering protocol (message model, streaming reducer, safe registry, capability action) and chat runtime view (ChatView / MessageBubble / PartRenderer / Composer / chat layout)",
   "keywords": [
     "pactor",
@@ -49,11 +49,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@pactor-app/core": "1.18.0",
-    "@pactor-app/permission": "1.18.0",
-    "@pactor-app/markdown": "1.18.0",
-    "@pactor-app/runtime": "1.18.0",
-    "@pactor-app/ui": "1.18.0"
+    "@pactor-app/core": "1.18.1",
+    "@pactor-app/markdown": "1.18.1",
+    "@pactor-app/ui": "1.18.1",
+    "@pactor-app/runtime": "1.18.1",
+    "@pactor-app/permission": "1.18.1"
   },
   "peerDependencies": {
     "react": ">=18"

package/styles.css

@@ -88,10 +88,12 @@
   --pactor-chat-shell-scrim: rgb(0 0 0 / 40%);
   /* 产出物面板（spec: chat-artifact-panel）：桌面固定宽右栏。
      默认宽与对话列一致（--pactor-chat-content-width），
-     宽度夹取 [--pactor-chat-inspector-min-width, host 宽 2/3]；
+     宽度夹取 [--pactor-chat-inspector-min-width,
+              min(--pactor-chat-inspector-max-width, host 宽 2/3)]；
      背景略深于聊天区底色，视觉上与消息流区分 */
   --pactor-chat-inspector-width: var(--pactor-chat-content-width);
   --pactor-chat-inspector-min-width: 480px;
+  --pactor-chat-inspector-max-width: 600px;
   --pactor-chat-inspector-bg: color-mix(
     in srgb,
     var(--pactor-chat-bg) 96%,
@@ -102,6 +104,10 @@
   /* 对话列左右最小内间距（spec: chat-artifact-panel / 拖拽调宽）：
      面板调宽挤压剩余空间时，对话列左右始终保留该间距 */
   --pactor-chat-content-gutter: 16px;
+  /* 聊天区 header 与产物面板 header 的公共高度（min-height，border-box）：
+     两边内容自然高度不同（面板侧 menu-trigger 更高），经统一 min-height
+     对齐，面板打开时两条分隔线同高；内容更高时自然撑开 */
+  --pactor-chat-header-height: 48px;
 }
 
 .pactor-chat-view {
@@ -221,8 +227,8 @@
 /* ------------------------------------------------------------
  * ChatWorkspace（spec: chat-dsl-page）：createChatWorkspace 工厂
  * 返回组件的外层容器 = 对话列（ChatView）；工作区头部（header）
- * 收进面板 host 的 __main 左列——面板打开时与对话区同宽（不覆盖
- * 面板上方），面板关闭时随 __main 通栏；不随对话列限宽。
+ * 收进面板 host 的 __main 左列——面板打开时随 __main 通栏（左贴
+ * 宿主边缘、右贴面板分隔线，不覆盖面板上方），不随对话列限宽。
  * ------------------------------------------------------------ */
 
 .pactor-chat-workspace {
@@ -232,8 +238,9 @@
   min-height: 0;
   /* 对话列缺省限宽居中（spec: chat-app-shell 嵌入契约）：
    * shell content / 面板 host / 独立块级容器三场景统一生效。
-   * width 用 calc 预留 gutter——产物栏调宽挤压时，max-width 限宽
-   * 失效（剩余空间不足）后左右仍恒保留 --pactor-chat-content-gutter
+   * width 用 calc 预留 gutter——对话列包含块是 __main 左列（面板
+   * 宽度不计入 100% 基准），产物栏调宽挤压、max-width 限宽失效
+   * （剩余空间不足）后左右仍恒保留 --pactor-chat-content-gutter
    * 内间距，不会贴到容器边缘或面板分隔线 */
   width: calc(100% - 2 * var(--pactor-chat-content-gutter));
   max-width: var(--pactor-chat-content-width);
@@ -265,6 +272,9 @@
   padding: 10px 16px;
   border-bottom: 1px solid var(--pactor-chat-border);
   flex-shrink: 0;
+  /* 与产物面板 header 等高（--pactor-chat-header-height） */
+  box-sizing: border-box;
+  min-height: var(--pactor-chat-header-height);
 }
 
 .pactor-chat-workspace__title {
@@ -359,8 +369,8 @@
  * ------------------------------------------------------------ */
 
 /* 面板打开时的容器：行内容器 __row 承载左右两列——__main 左列
- * （header + 对话区，同宽；header 不覆盖面板上方）与面板右列
- * （独占全高）；host 在 shell content 内撑满剩余高度与宽度 */
+ * （header + 对话区纵向堆叠；header 通栏、不覆盖面板上方）与面板
+ * 右列（独占全高）；host 在 shell content 内撑满剩余高度与宽度 */
 .pactor-chat-inspector-host {
   display: flex;
   flex-direction: column;
@@ -371,8 +381,10 @@
   background: var(--pactor-chat-bg);
 }
 
-/* host 行内容器：__main 左列与面板的 flex 行（gutter 契约挂在行上——
- * __main 内的 header / 对话列共享行 padding 的左 gutter） */
+/* host 行内容器：__main 左列与面板的 flex 行。对话列 gutter 契约
+ * 由对话列自身 calc 宽度保证（见 .pactor-chat-workspace）——容器侧
+ * 不加 padding/margin，否则 __main 内的 header 会被内缩，两端无法
+ * 贴到宿主边缘与面板分隔线 */
 .pactor-chat-inspector-host__row {
   display: flex;
   flex: 1;
@@ -381,7 +393,7 @@
 }
 
 /* __main 左列：header + 主区（AppShell / workspace）纵向堆叠，
- * 宽度 = 行宽减去面板宽（面板打开时 header 与对话区同宽） */
+ * 宽度 = 行宽减去面板宽（header 通栏：左贴宿主边缘、右贴面板分隔线） */
 .pactor-chat-inspector-host__main {
   display: flex;
   flex-direction: column;
@@ -397,28 +409,20 @@
   min-width: 0;
 }
 
-/* 对话列左右最小内间距（gutter 契约，spec: chat-artifact-panel / 拖拽调宽）：
- * 对话列自身的 calc 宽度在 flex 行内会把面板宽度一并计入 100% 基准，
- * shrink 后 margin auto 塌到 0；因此面板打开时的 gutter 由容器侧保证——
- * 左：row padding-left；右：面板 margin-left（对话列与分隔线的间距）。
- * 面板关闭（:has 不命中）时不加 row padding，避免与对话列 calc 重复计算 */
-.pactor-chat-inspector-host__row:has(> .pactor-chat-inspector) {
-  padding-left: var(--pactor-chat-content-gutter);
-}
-
-.pactor-chat-inspector-host__row > .pactor-chat-inspector {
-  margin-left: var(--pactor-chat-content-gutter);
-}
-
 .pactor-chat-inspector {
   position: relative;
   display: flex;
   flex-direction: column;
-  /* 默认宽对齐对话列；上限 host 宽 2/3（与拖拽夹取一致），下限 min-width 令牌。
+  /* 默认宽对齐对话列；上限 min(max-width 令牌 600px, host 宽 2/3)（与拖拽夹取一致），
+   * 下限 min-width 令牌。
    * max-width 是拖拽 inline 宽度的硬兜底：inline width 不能覆盖 max-width，
-   * 拖拽夹取偏差 / 拖拽后窗口尺寸变化时面板也不会突破 2/3 上限 */
-  width: min(var(--pactor-chat-inspector-width), calc(100% * 2 / 3));
-  max-width: calc(100% * 2 / 3);
+   * 拖拽夹取偏差 / 拖拽后窗口尺寸变化时面板也不会突破上限 */
+  width: min(
+    var(--pactor-chat-inspector-width),
+    var(--pactor-chat-inspector-max-width),
+    calc(100% * 2 / 3)
+  );
+  max-width: min(var(--pactor-chat-inspector-max-width), calc(100% * 2 / 3));
   min-width: var(--pactor-chat-inspector-min-width);
   flex-shrink: 0;
   border-left: 1px solid var(--pactor-chat-border);
@@ -449,6 +453,9 @@
   padding: 10px 12px;
   border-bottom: 1px solid var(--pactor-chat-border);
   flex-shrink: 0;
+  /* 与聊天区 header 等高（--pactor-chat-header-height） */
+  box-sizing: border-box;
+  min-height: var(--pactor-chat-header-height);
 }
 
 .pactor-chat-inspector__title {
@@ -495,7 +502,9 @@
   gap: 6px;
   min-width: 0;
   max-width: 100%;
-  padding: 3px 6px;
+  /* 纵向 padding 2px：自身 26.4px + header padding 20px + border 1px
+   * ≤ --pactor-chat-header-height（48px），不撑破两侧 header 等高 */
+  padding: 2px 6px;
   border-radius: var(--pactor-chat-radius-sm);
   cursor: pointer;
   color: var(--pactor-chat-fg);
@@ -1060,6 +1069,40 @@
   align-items: stretch;
 }
 
+/* assistant 消息顶部 Agent 身份行：图标 + 加粗名称 */
+.pactor-chat-message__agent {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  min-width: 0;
+  font-size: 13px;
+  line-height: 18px;
+  color: var(--pactor-chat-fg);
+}
+
+.pactor-chat-message__agent-icon {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  flex-shrink: 0;
+  width: 1.1em;
+  height: 1.1em;
+  color: var(--pactor-chat-muted-fg);
+}
+
+img.pactor-chat-message__agent-icon {
+  border-radius: var(--pactor-chat-radius-sm, 4px);
+  object-fit: cover;
+}
+
+.pactor-chat-message__agent-name {
+  font-size: 1.1em;
+  font-weight: 600;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
 /* system：居中弱提示 */
 .pactor-chat-message--system {
   align-items: center;