@pactor-app/chat 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,1401 @@
+import { DslNode, Registry, PermissionConfig } from '@pactor-app/core';
+import { ActionContext, ActionRegistry, RuntimeContext, ActionEngine } from '@pactor-app/runtime';
+import { PermissionStore } from '@pactor-app/permission';
+import * as react from 'react';
+import { RefObject, ReactNode, ComponentType } from 'react';
+
+/**
+ * 产出物模型与 ArtifactStore（spec: chat-artifact-panel，设计决策 D1）。
+ *
+ * 零 React，可纯 Node 测试；状态语义与 ConversationStore 同模式
+ * （不可变更新 + subscribe 通知，兼容 useSyncExternalStore）。
+ * store 只持当前一个产出物：多产出物 / 历史由业务层自行管理后注入。
+ */
+/** 产出物：dsl kind 的 content 为 DslNode 普通对象，其余 kind 为字符串 */
+interface ChatArtifact {
+    id: string;
+    kind: 'markdown' | 'code' | 'text' | 'dsl';
+    title: string;
+    content: string | DslNode;
+    /** code kind 的语言标记（仅作角标展示） */
+    language?: string;
+    meta?: Record<string, unknown>;
+}
+/** update 的补丁：id 不可改 */
+type ArtifactPatch = Partial<Omit<ChatArtifact, 'id'>>;
+/**
+ * ArtifactStore（设计决策 D1）：当前产出物的可变容器。
+ * 可注入（services.artifactStore）或由组合层自持（ref 保持）。
+ * 对未 open 状态下的 update 宽容：console.warn 并忽略，不抛错。
+ */
+declare class ArtifactStore {
+    private artifact;
+    private readonly listeners;
+    /** 当前产出物（未打开时为 null；引用在不变时保持稳定） */
+    get(): ChatArtifact | null;
+    /** 打开（或替换）当前产出物 */
+    open(artifact: ChatArtifact): void;
+    /** 部分更新当前产出物（id 不可改）；未 open 时告警并忽略 */
+    update(patch: ArtifactPatch): void;
+    /** 关闭面板（未打开时幂等，不重复通知） */
+    close(): void;
+    /** 订阅变更；返回退订函数 */
+    subscribe(listener: () => void): () => void;
+    private notify;
+}
+
+/**
+ * 消息模型（设计决策 D1，设计文档第 58/59/70 节）：
+ * AI Message Rendering Protocol 的数据层——消息 + Part 联合类型 +
+ * 状态机。零 React，可纯 Node 测试。
+ */
+/** 消息角色 */
+type ChatRole = 'user' | 'assistant' | 'system';
+/** 消息状态机 */
+type MessageStatus = 'pending' | 'streaming' | 'completed' | 'error' | 'cancelled';
+/** Part 状态机（tool-call / tool-result / error / status 使用各自的状态字段） */
+type PartStatus = 'pending' | 'streaming' | 'ready' | 'error';
+/** tool-call part 的执行状态 */
+type ToolCallStatus = 'waiting' | 'running' | 'success' | 'failed';
+/**
+ * Part 联合类型：一条消息由有序 Part 数组组成，
+ * thinking 与正文分离（设计文档第 72 节）。
+ *
+ * 各 variant 的 `id` 可选：streaming 事件携带 partId 时按 id 定位，
+ * 缺省时 reducer 按"最后一个同类 part"定位。
+ */
+type ChatPart = {
+    id?: string;
+    type: 'text';
+    content: string;
+    status?: PartStatus;
+} | {
+    id?: string;
+    type: 'markdown';
+    content: string;
+    status?: PartStatus;
+} | {
+    id?: string;
+    type: 'dsl';
+    /** dsl.complete 事件写入；dsl.start 占位阶段缺省（渲染为占位） */
+    schema?: DslNode;
+    status?: PartStatus;
+} | {
+    id?: string;
+    type: 'thinking';
+    content: string;
+    status?: PartStatus;
+} | {
+    id?: string;
+    type: 'tool-call';
+    name: string;
+    title?: string;
+    /** 调用参数（tool.start 事件携带；供活动轨迹参数摘要 / 详情渲染） */
+    args?: unknown;
+    status: ToolCallStatus;
+} | {
+    id?: string;
+    type: 'tool-result';
+    name: string;
+    status: 'success' | 'failed';
+    result?: unknown;
+    error?: string;
+} | {
+    id?: string;
+    type: 'error';
+    message: string;
+} | {
+    id?: string;
+    type: 'status';
+    text: string;
+} | {
+    id?: string;
+    /** 产出物 part（spec: chat-artifact-panel，设计决策 D4）：内联渲染为产出物卡片 */
+    type: 'artifact';
+    artifact: ChatArtifact;
+    status?: PartStatus;
+};
+/** 消息附件引用（上传与存储由调用方负责，包内只持有引用） */
+interface ChatAttachment {
+    id: string;
+    name: string;
+    mimeType: string;
+    size?: number;
+    url?: string;
+}
+/**
+ * 上下文项（spec: chat-context-sources，设计决策 D6）：
+ * 选中候选追加为 Composer 上方 chips；`label` 用于 chip 展示，
+ * `trigger` 标记来源入口（'@' 提及 / '+' 菜单），`data` 为 source 项
+ * 原始数据（如 agentId），transport 可结构化消费。
+ */
+interface ChatContextItem {
+    id: string;
+    label: string;
+    trigger?: '@' | '+';
+    data?: unknown;
+}
+/**
+ * 上下文数据源（spec: chat-context-sources，设计决策 D1）：
+ * `trigger` 标记入口（'@' 提及弹层 / '+' 菜单）；`items` 为静态候选
+ * 数组；`service` + `params` 为声明式服务引用，经注入的
+ * `ChatServices.callService(name, params)` 解析为 `ChatContextItem[]`
+ * （结果按 source 键会话级缓存）。全部为 DSL 可表达数据。
+ */
+interface ChatContextSource {
+    trigger: '@' | '+';
+    /** 来源名（弹层分组展示 / 错误提示用） */
+    label: string;
+    /** 静态候选数组；与 service 二选一 */
+    items?: ChatContextItem[];
+    /** 声明式服务引用（经 callService 解析） */
+    service?: string;
+    /** service 调用参数 */
+    params?: Record<string, unknown>;
+}
+/** 模型选项（spec: chat-model-selector）：value 进 ChatInput.model，label 用于 chip 展示 */
+interface ChatModelOption {
+    value: string;
+    label: string;
+}
+/**
+ * 内建消息动作名（spec: chat-message-actions，设计决策 D1）：
+ * 数组项为字符串时等价于 `{ id: <name>, builtin: <name> }`
+ */
+type BuiltinMessageAction = 'copy' | 'regenerate' | 'retry' | 'edit';
+/**
+ * 消息操作条动作描述（spec: chat-message-actions，设计决策 D1）：
+ * 全部为 DSL 可表达数据——`builtin` 指定时复用内建行为（label / icon /
+ * roles / visibleWhen 按字段覆盖内建默认描述）；无 `builtin` 为自定义
+ * 动作，点击经 `ChatServices.callService(service, { actionId, message })`
+ * 派发并并行触发 `onMessageAction` 通知。
+ */
+interface ChatMessageAction {
+    /** 动作标识（服务派发 actionId 与事件 event.action 用） */
+    id: string;
+    /** 指定则复用内建行为与默认描述（可逐字段覆盖） */
+    builtin?: BuiltinMessageAction;
+    /** tooltip 文案；缺省用内建默认（自定义动作缺省回退为 id） */
+    label?: string;
+    /** 图标名（MESSAGE_ACTION_ICONS 白名单）；未知名渲染占位图标 */
+    icon?: string;
+    /** 可见角色；自定义动作缺省 ['assistant'] */
+    roles?: Array<'user' | 'assistant'>;
+    /**
+     * 可见状态：'completed' 匹配非流式非错误终态（含 cancelled），
+     * 'error' 匹配 error，'always' 含 streaming；自定义动作缺省 'completed'
+     */
+    visibleWhen?: 'completed' | 'error' | 'always';
+    /** 自定义动作的派发服务名（经注入的 callService 解析） */
+    service?: string;
+}
+/** Chat 消息 */
+interface ChatMessage {
+    id: string;
+    role: ChatRole;
+    status: MessageStatus;
+    parts: ChatPart[];
+    createdAt?: number;
+    attachments?: ChatAttachment[];
+}
+/** updatePart 的定位参数：数组下标或 part id */
+type PartRef = number | string;
+/** updateMessage 的补丁：id 不可改 */
+type MessagePatch = Partial<Omit<ChatMessage, 'id'>>;
+/** updatePart 的补丁（宽类型：按目标 part variant 取子集） */
+type PartPatch = Partial<{
+    content: string;
+    schema: DslNode;
+    status: string;
+    name: string;
+    title: string;
+    args: unknown;
+    result: unknown;
+    error: string;
+    message: string;
+    text: string;
+    artifact: ChatArtifact;
+}>;
+/** 生成 Chat 侧消息 / part id（单调后缀保证同毫秒唯一） */
+declare function createChatId(prefix?: string): string;
+
+/**
+ * ConversationStore（设计决策 D1）：消息列表的可变容器，零 React。
+ *
+ * 全部更新不可变：每次变更产生新的 messages 数组引用（被修改的
+ * 消息 / part 同样为新对象），`getMessages()` 引用仅在变化时改变，
+ * 兼容 React `useSyncExternalStore` 的 snapshot 语义。
+ *
+ * 对未知 messageId 的更新宽容：console.warn 并忽略，不抛错。
+ */
+declare class ConversationStore {
+    private messages;
+    private readonly listeners;
+    /** 当前消息数组（只读快照；引用在不变时保持稳定） */
+    getMessages(): ChatMessage[];
+    getMessage(id: string): ChatMessage | undefined;
+    /** 追加消息（id 重复时告警并忽略） */
+    appendMessage(message: ChatMessage): void;
+    /** 更新消息级字段（status / role / parts 等，id 不可改） */
+    updateMessage(id: string, patch: MessagePatch): void;
+    /** 追加 part 到目标消息 */
+    appendPart(messageId: string, part: ChatPart): void;
+    /**
+     * 更新目标 part：partRef 为数组下标或 part id。
+     * 未命中时告警并忽略（宽容约定同 updateMessage）。
+     */
+    updatePart(messageId: string, partRef: PartRef, patch: PartPatch): void;
+    /** 设置消息状态 */
+    setStatus(id: string, status: MessageStatus): void;
+    /**
+     * 不可变地移除目标消息及其后全部消息（编辑重发 / 重新生成的截断基础）。
+     * 未知 id 时告警并忽略。
+     */
+    removeMessagesFrom(messageId: string): void;
+    /** 清空会话 */
+    clear(): void;
+    /** 订阅变更；返回退订函数 */
+    subscribe(listener: () => void): () => void;
+    /** 以 mutator 更新单条消息（找不到时告警并忽略） */
+    private mutateMessage;
+    private commit;
+}
+
+/**
+ * Streaming 事件模型与 reducer（设计决策 D2，设计文档第 69 节）。
+ *
+ * 事件对齐 SSE 协议：`message.start` / `text.delta` / `thinking.delta`
+ * / `tool.start` / `tool.result` / `dsl.start` / `dsl.complete`
+ * / `artifact`（产出物，spec: chat-artifact-panel）/ `message.end`
+ * / `message.error`（`dsl.patch` V1 不实现）。
+ */
+type ChatEvent = {
+    type: 'message.start';
+    messageId: string;
+    role?: ChatMessage['role'];
+} | {
+    type: 'text.delta';
+    messageId: string;
+    delta: string;
+    partId?: string;
+    /** 目标 part 类型（缺省 text；新建 part 时生效） */
+    format?: 'text' | 'markdown';
+} | {
+    type: 'thinking.delta';
+    messageId: string;
+    delta: string;
+    partId?: string;
+} | {
+    type: 'tool.start';
+    messageId: string;
+    name: string;
+    title?: string;
+    /** 调用参数（可选；reducer 存入 tool-call part 的 args） */
+    args?: unknown;
+    partId?: string;
+} | {
+    type: 'tool.result';
+    messageId: string;
+    name: string;
+    status: 'success' | 'failed';
+    result?: unknown;
+    error?: string;
+    partId?: string;
+} | {
+    type: 'dsl.start';
+    messageId: string;
+    partId?: string;
+} | {
+    type: 'dsl.complete';
+    messageId: string;
+    schema: DslNode;
+    partId?: string;
+} | {
+    /** 产出物到达（spec: chat-artifact-panel）：一次性写入 ready 的 artifact part */
+    type: 'artifact';
+    messageId: string;
+    artifact: ChatArtifact;
+    partId?: string;
+} | {
+    type: 'message.end';
+    messageId: string;
+} | {
+    type: 'message.error';
+    messageId: string;
+    error: string;
+};
+/**
+ * applyChatEvent（设计决策 D2）：纯函数 reducer，把单个流式事件
+ * 落到 ConversationStore。不抛错：
+ *
+ * - 乱序 / 缺失宽容：delta 先于 message.start 时自动建立 assistant
+ *   占位消息；目标 part 不存在时自动创建。
+ * - 未知事件：忽略并 console.warn。
+ */
+declare function applyChatEvent(store: ConversationStore, event: ChatEvent): void;
+
+/**
+ * 活动轨迹纯函数（设计决策 D1，spec: chat-activity-trace）。
+ *
+ * 零 React、Node 可测：流式状态头的模式推导与 tool-call / tool-result
+ * 的配对轨迹。视图层（ActivityTrace）只负责渲染这些函数的输出。
+ */
+/** 流式状态头的模式 */
+type StreamingMode = 'reasoning' | 'tool' | 'responding';
+/**
+ * 由消息 parts 推导当前流式模式：
+ *
+ * - 存在 waiting / running 的 tool-call → `tool`（未完结的工具调用
+ *   总是优先，即使更晚有正文 streaming）；
+ * - 否则取最靠后的活动（streaming）part：thinking → `reasoning`，
+ *   text / markdown / dsl → `responding`（更晚的活动 part 优先）；
+ * - 消息不在 streaming / pending，或无活动 part → `null`。
+ */
+declare function detectStreamingMode(message: ChatMessage): StreamingMode | null;
+/**
+ * 配对后的工具轨迹条目：单行可展开渲染所需的数据。
+ *
+ * 事件模型无 callId（设计决策 D1 的取舍），保留原始 part 下标
+ * （`callIndex` / `resultIndex`）便于将来升级 callId 配对。
+ */
+interface ToolTraceEntry {
+    /** 工具名（tool-call / tool-result 的 name） */
+    name: string;
+    /** 人类可读标题（来自 tool-call part） */
+    title?: string;
+    /** 调用参数（来自配对 tool-call part 的 args；供参数摘要 / 详情渲染） */
+    args?: unknown;
+    /**
+     * 派生状态：已配对 result 时取 result 的 success / failed，
+     * 否则保留 call 自身的 waiting / running。
+     */
+    status: ToolCallStatus;
+    /** result 载荷（success 时） */
+    result?: unknown;
+    /** 错误信息（failed 时） */
+    error?: string;
+    /** tool-call part 在消息 parts 中的下标 */
+    callIndex: number;
+    /** 配对的 tool-result part 下标；未配对时缺省 */
+    resultIndex?: number;
+}
+/**
+ * 将 tool-call 与 tool-result 按 name + 出现顺序配对：
+ * 每个 result 落到同名最早未配对的 call（顺序事件流下等价于
+ * "最早未完结的同名 call"）。孤儿 result（无同名 call）忽略。
+ * 返回条目按 call 出现顺序排列。
+ */
+declare function pairToolTraces(parts: ChatPart[]): ToolTraceEntry[];
+
+/**
+ * ChatTransport 与 turn 驱动（设计决策 D2）。
+ *
+ * 真实 SSE / WebSocket 客户端不在 V1 范围：业务按服务端协议自行实现
+ * `ChatTransport`（或后续补 `createSseTransport`）；测试与手动驱动
+ * 场景使用 `createManualDriver()`。
+ */
+/** 一轮对话的输入 */
+interface ChatInput {
+    text: string;
+    conversationId?: string;
+    /**
+     * 当前选中模型 value（spec: chat-streaming，设计决策 D2）：
+     * 由视图层在发送时注入；可选字段，既有 transport 实现无需修改
+     */
+    model?: string;
+    /**
+     * 当前生效的上下文 chips（spec: chat-streaming，设计决策 D2/D6）：
+     * 由视图层在发送时注入；MUST NOT 拼接进 `text` 字段（不污染用户
+     * 原文），transport 自行结构化消费；可选字段，既有实现无需修改
+     */
+    contexts?: ChatContextItem[];
+}
+/** Chat 传输层：发送输入，返回流式事件 */
+interface ChatTransport {
+    send(input: ChatInput): AsyncIterable<ChatEvent>;
+}
+/** runChatTurn 的可选定制（id 生成等，测试可注入确定性 id） */
+interface RunChatTurnOptions {
+    userMessageId?: string;
+    assistantMessageId?: string;
+    /** 取消信号：abort 时停止消费事件流，assistant 消息以 cancelled 收尾 */
+    signal?: AbortSignal;
+    /**
+     * 跳过 user 消息追加（重新生成复用已有 user 消息时使用）：
+     * 仍追加 assistant 占位并 reduce 事件流。
+     */
+    skipUserMessage?: boolean;
+}
+/** runChatTurn 结果：本 turn 建立的两条消息 id */
+interface ChatTurnResult {
+    userMessageId: string;
+    assistantMessageId: string;
+}
+/**
+ * 执行一轮对话：先 append user 消息（completed）与 assistant 占位
+ * （pending），再 for-await transport 事件流逐事件 reduce。
+ *
+ * transport 流中的事件统一归一到 assistant 占位消息（一个 turn 的
+ * 事件流即该回复的事件流）；transport 抛错时收敛为 message.error，
+ * 不向上抛出。
+ */
+declare function runChatTurn(store: ConversationStore, transport: ChatTransport, input: ChatInput, options?: RunChatTurnOptions): Promise<ChatTurnResult>;
+/**
+ * 重新生成末轮（设计决策 D2，spec: chat-streaming / 重新生成轮次）：
+ * 定位 store 中最后一条 user 消息，移除其后全部消息（保留该 user
+ * 消息本身），再以其文本驱动一轮新 turn（skipUserMessage，不产生
+ * 新的 user 消息）。
+ *
+ * store 中无 user 消息时告警并正常返回（不抛错、不改 store）。
+ * `options.signal` 语义同 runChatTurn：abort 时新 assistant 消息以
+ * cancelled 收尾并正常返回。
+ */
+declare function runRegenerateTurn(store: ConversationStore, transport: ChatTransport, options?: RunChatTurnOptions): Promise<ChatTurnResult | undefined>;
+/** 手动 driver：代码控制推送事件的 ChatTransport 实现 */
+interface ManualChatDriver {
+    transport: ChatTransport;
+    /** 推送一个事件（在 send 之前推送的事件会排队，send 后依次产出） */
+    push(event: ChatEvent): void;
+    /** 结束事件流（send 的 for-await 正常退出） */
+    complete(): void;
+    /** 以错误终止事件流（runChatTurn 收敛为 message.error） */
+    fail(cause: unknown): void;
+}
+/**
+ * 创建手动 driver（测试与业务手动驱动共用）：
+ * `push` / `complete` / `fail` 控制事件流，`transport.send` 产出。
+ * 一个 driver 对应一次 send；send 之后不可复用。
+ */
+declare function createManualDriver(): ManualChatDriver;
+
+/**
+ * 创建 Safe Registry：`allowed` ∩ `source` 之外的类型对渲染层不可见
+ * （get 返回 undefined，Renderer 走受控占位）。
+ */
+declare function createSafeRegistry(source: Registry<unknown>, allowed: string[]): Registry<unknown>;
+
+/**
+ * capability 动作（设计决策 D4，设计文档第 64、81.5 节）：
+ * AI DSL 触发业务能力的唯一通道，执行链为
+ * CapabilityRegistry → Permission → Confirmation → Execute。
+ */
+/** 业务能力 handler */
+interface CapabilityHandler {
+    /** 声明权限：执行前经 PermissionAdapter 检查 */
+    permission?: PermissionConfig;
+    /** 风险等级；'high' 需经 confirm 确认（注入时） */
+    risk?: 'low' | 'high';
+    /** 以求值后的 params 执行，返回值作为动作 data */
+    execute(params: Record<string, unknown>, ctx: ActionContext): unknown | Promise<unknown>;
+}
+/** Capability Registry：能力名 → handler */
+type ChatCapabilityRegistry = Registry<CapabilityHandler>;
+/** 结构化权限检查器（兼容 @pactor-app/runtime PermissionAdapter 与 @pactor-app/permission createPermissionAdapter 的返回） */
+interface ChatPermissionChecker {
+    check(permission: PermissionConfig): boolean;
+}
+/** 高风险确认请求 */
+interface ChatConfirmRequest {
+    name: string;
+    params: Record<string, unknown>;
+}
+/** 高风险确认回调：返回 true 继续执行，false 取消（skipped 语义） */
+type ChatConfirm = (request: ChatConfirmRequest) => Promise<boolean>;
+interface CapabilityActionDeps {
+    capabilities: ChatCapabilityRegistry;
+    /** 缺省时视为全部放行 */
+    permission?: ChatPermissionChecker;
+    /** 缺省时高风险 capability 受控拒绝（design Risks 约定） */
+    confirm?: ChatConfirm;
+}
+/**
+ * 注册 `capability` 动作（已注册的同名动作不会被覆盖）。
+ *
+ * DSL 侧：`{ action: 'capability', params: { name: '<能力名>', params: {...} } }`。
+ *
+ * 执行链（每步失败均为受控返回，不抛出）：
+ * 1. `params.name` 查 CapabilityRegistry，未注册 → `{ ok: false }`
+ * 2. capability 声明 `permission` 且检查拒绝 → `{ ok: false }`
+ * 3. capability 声明 `risk: 'high'`：注入 confirm 时先确认，
+ *    取消 → `{ ok: true, skipped: true }`；未注入 confirm → `{ ok: false }`
+ * 4. `capability.execute(params.params, ctx)`，返回值作为动作 data
+ */
+declare function registerCapabilityAction(actions: ActionRegistry, deps: CapabilityActionDeps): void;
+
+/**
+ * Chat 作用域与 RuntimeContext 组装（设计决策 D5，设计文档第 73 节）。
+ *
+ * DSL part 经 runtime Renderer 渲染：ComponentRegistry 用 Safe Registry，
+ * 作用域在 runtime 全局作用域之上注入 `conversation` / `message` /
+ * `params`（`user` 经 RuntimeContext 注入）——沿用表达式引擎约束，
+ * 不暴露浏览器全局对象。
+ */
+/** DSL part 渲染的 chat 局部作用域 */
+interface ChatScope {
+    conversation: {
+        id?: string;
+    };
+    message: {
+        id: string;
+    };
+    params?: Record<string, unknown>;
+}
+/** 组装 chat 局部作用域（作为 renderChildren 的 extraScope 传入） */
+declare function buildChatScope(scope: ChatScope): Record<string, unknown>;
+interface CreateChatRuntimeOptions {
+    /** Safe Registry；缺省时使用空注册表（dsl part 全部渲染受控占位） */
+    safeRegistry?: Registry<unknown>;
+    /** capability 白名单；缺省时不注册 capability 动作 */
+    capabilities?: ChatCapabilityRegistry;
+    /** 权限检查器（与 permissionStore 二选一，permission 优先） */
+    permission?: ChatPermissionChecker;
+    /** @pactor-app/permission 的 PermissionStore，用于构造权限检查器 */
+    permissionStore?: PermissionStore;
+    /** 高风险 capability 确认回调 */
+    confirm?: ChatConfirm;
+    /** 注入作用域 `user` */
+    user?: Record<string, unknown>;
+}
+interface ChatRuntime {
+    context: RuntimeContext;
+    engine: ActionEngine;
+}
+/**
+ * 创建 Chat DSL 渲染运行时：
+ *
+ * - ComponentRegistry 为 Safe Registry（白名单之外的组件不可见）
+ * - 注册 runtime 内置动作（setState 等）；注入 capabilities 时注册
+ *   `capability` 动作（Safe Registry 只挡组件，动作侧由 capability
+ *   白名单兜底——AI DSL 建议只配置 capability 动作）
+ * - permissionStore 经 @pactor-app/permission 构造 PermissionAdapter，
+ *   供 Renderer 的 `permission` 字段与 capability 链共用
+ */
+declare function createChatRuntime(options?: CreateChatRuntimeOptions): ChatRuntime;
+
+/**
+ * DSL part 的白名单守卫（设计决策 D3/D5）：渲染前把白名单之外的
+ * 节点替换为受控"不允许"占位节点（`ChatDenied`），占位组件由
+ * PartRenderer 注册进 Safe Registry。
+ *
+ * 纯函数、零 React，可纯 Node 测试。
+ *
+ * 注意：只处理 DSL 树的 type / children 主干；props 内嵌的 DSL 子树
+ * （Table columns[].cell 等）由 runtime Renderer 的 UnsupportedComponent
+ * 兜底（Safe Registry get 未命中即受控占位，不会渲染真实组件）。
+ */
+/** 受控占位节点的 DSL 类型名（占用不可能与业务组件冲突的名称） */
+declare const CHAT_DENIED_TYPE = "ChatDenied";
+/**
+ * 递归守卫 DSL 树：白名单内的节点原样保留（children 递归处理）；
+ * 白名单外的节点替换为 `{ type: 'ChatDenied', props: { deniedType } }`，
+ * 其 children 一并丢弃（不渲染其中任何内容）。
+ */
+declare function guardChatDsl(node: DslNode, registry: Registry<unknown>): DslNode;
+
+/**
+ * useSmoothStreamText（技术选型参考 DeepTutor web 同名 hook，独立实现）：
+ * 把"可见文本"的增长速率与流式 delta 的到达节奏解耦——上游 chunk 再
+ * 突发，用户看到的都是平滑的打字机揭示。
+ *
+ * 机制：
+ * - isStreaming 且 content 长于已揭示部分时，以 requestAnimationFrame
+ *   循环推进游标；每帧揭示 max(minCharsPerFrame, backlog / catchUpDivisor)，
+ *   封顶 maxCharsPerFrame（长时间积压的大 chunk 不会龟速打字半分钟）；
+ * - isStreaming 翻 false 时立即对齐全文（短消息不留残尾）；
+ * - content 回缩（重新生成 / 分支切换）时立即回退游标，不显示幽灵尾巴；
+ * - enabled: false 时直通原文（调用方可对 streaming / 非 streaming 走同一
+ *   渲染路径）。
+ */
+interface UseSmoothStreamTextOptions {
+    /** 每帧揭示上限（字符），默认 120 */
+    maxCharsPerFrame?: number;
+    /** 每帧揭示下限（字符），默认 2 */
+    minCharsPerFrame?: number;
+    /** 积压除数：越大揭示越慢，约 5 比较自然，默认 5 */
+    catchUpDivisor?: number;
+    /** false 时直通原文，默认 true */
+    enabled?: boolean;
+}
+declare function useSmoothStreamText(content: string, isStreaming: boolean, options?: UseSmoothStreamTextOptions): string;
+
+/**
+ * useChatAutoScroll（技术选型参考 DeepTutor web 同名 hook，独立实现）：
+ * "钉在底部"的流式自动滚动。
+ *
+ * 机制：
+ * - 跟随时，唯一写者在 useLayoutEffect 里执行
+ *   `scrollTop = scrollHeight`（避免多路写 scrollTop 造成的抖动）；
+ * - 用户上翻超过 RELEASE_THRESHOLD（80px）释放跟随，可安静翻历史；
+ *   回到距底 REENGAGE_THRESHOLD（40px）内自动恢复跟随；
+ * - 释放跟随期间由调用方展示"回到底部"入口（isFollowing=false），
+ *   点击 scrollToBottom 恢复；
+ * - 滚动容器需配合 `overflow-anchor: none`（styles.css 已内置），
+ *   防止浏览器滚动锚定与跟随互相拉扯。
+ */
+interface UseChatAutoScrollOptions {
+    /** 消息总数（变化触发一次跟随判定） */
+    messageCount: number;
+    /** 最后一条消息的文本总长度（流式增长触发跟随） */
+    lastContentLength: number;
+    /** 是否处于流式中（仅流式中才需要高频跟随） */
+    isStreaming: boolean;
+}
+interface UseChatAutoScrollResult {
+    containerRef: RefObject<HTMLDivElement | null>;
+    /** 是否处于跟随状态（false 时调用方应显示"回到底部"入口） */
+    isFollowing: boolean;
+    /** 恢复跟随并立即滚到底部 */
+    scrollToBottom: () => void;
+}
+declare function useChatAutoScroll({ messageCount, lastContentLength, isStreaming, }: UseChatAutoScrollOptions): UseChatAutoScrollResult;
+
+/**
+ * EmptyState（spec: chat-empty-state，设计决策 D0/D1）：空会话欢迎页。
+ *
+ * 数据以接口注入：greeting / subtitle / suggestions 均为受控 props；
+ * 点击建议经 `onSuggestionClick` 回调交还调用方（ChatView 接入时
+ * 复用 Composer 的同一条发送路径）。
+ */
+type ChatSuggestion = string | {
+    label: string;
+    prompt?: string;
+};
+interface EmptyStateProps {
+    /** 问候语（display 衬线字体栈渲染）；缺省用默认文案 */
+    greeting?: string;
+    /** 可选副标题 */
+    subtitle?: string;
+    /** 起始建议；空数组 / 未传时不渲染建议区 */
+    suggestions?: ChatSuggestion[];
+    /** 点击建议回调，入参为该建议的 `prompt ?? label` */
+    onSuggestionClick?: (text: string) => void;
+}
+/** 默认问候语（可被 greeting prop 覆盖） */
+declare const DEFAULT_CHAT_GREETING = "\u4F60\u597D\uFF0C\u6709\u4EC0\u4E48\u53EF\u4EE5\u5E2E\u4F60\uFF1F";
+declare function EmptyState({ greeting, subtitle, suggestions, onSuggestionClick, }: EmptyStateProps): react.JSX.Element;
+
+/**
+ * 内建工作区 header（spec: chat-dsl-component / Header 配置，设计决策 D4）：
+ * 标题（editableTitle 时点击进入编辑，Enter / blur 提交）+ 右侧操作组
+ * （按 headerActions 数组顺序渲染，位于 headerExtra 槽之前）。
+ *
+ * 默认行为总在包内执行，事件为并行通知（与 onSend 同款语义）：
+ * - export：store.getMessages() 序列化 Markdown 并触发下载
+ * - theme：读 document.documentElement 当前 data-pactor-theme 并切换
+ *   （'dark' ↔ 移除），事件带新 theme
+ * - clear：store.clear()
+ *
+ * 零渲染承诺：headerActions 缺省 / 空数组且未开 editableTitle 时，
+ * 渲染 DOM 与既有内建 header 逐字节一致。
+ */
+/** 内建 header 操作项（按数组顺序渲染） */
+type ChatHeaderAction = 'export' | 'theme' | 'clear';
+
+/**
+ * ChatWorkspace 宿主服务（spec: chat-dsl-page，设计决策 D1）：
+ * 全部运行时依赖与交互回调由宿主注入——表达式作用域只承载
+ * 可序列化数据，函数 / 实例不进 DSL props。
+ * （chat-dsl-component 起同型复用为 ChatServices，经 ChatServicesProvider
+ * 注入；本工厂保留为 React 直连路径。）
+ */
+interface ChatWorkspaceServices {
+    /** 传输层（必填）：发送即经 runChatTurn 驱动一轮对话 */
+    transport: ChatTransport;
+    /** 外部自持 store；与 storeFactory 二选一，缺省包内默认构造 */
+    store?: ConversationStore;
+    /** 缺省 store 的创建工厂（仅首渲染调用一次） */
+    storeFactory?: () => ConversationStore;
+    /** 产出物面板 store（spec: chat-artifact-panel）；缺省包内默认构造 */
+    artifactStore?: ArtifactStore;
+    /** Safe Registry（createSafeRegistry 包装后的白名单注册表） */
+    safeRegistry?: Registry<unknown>;
+    /** capability 白名单与确认链 */
+    capabilities?: ChatCapabilityRegistry;
+    permission?: ChatPermissionChecker;
+    confirm?: ChatConfirm;
+    /** 注入 dsl part 作用域 user */
+    user?: Record<string, unknown>;
+    /**
+     * 附件伪上传 / 上传：粘贴、拖拽、文件选择产出的 File[] 交给宿主处理，
+     * 回传的 ChatAttachment[] 追加进受控附件区（支持异步）；发送后清空
+     */
+    onAttachFiles?: (files: File[]) => ChatAttachment[] | Promise<ChatAttachment[]>;
+    /** 附件卡片点击通知（预览等由宿主实现） */
+    onAttachmentClick?: (attachment: ChatAttachment) => void;
+    /** 发送回调（在 transport 驱动 turn 之前触发） */
+    onSend?: (text: string) => void;
+    /**
+     * 声明式数据源解析出口（spec: chat-context-sources，设计决策 D1）：
+     * contexts 的 service 引用（`{ service, params? }`）经此调用解析为
+     * 候选数据；宿主桥到 ServiceRegistry 或自有实现。函数不进 DSL
+     * props，统一经 ChatServices 注入。
+     */
+    callService?: (name: string, params?: Record<string, unknown>) => Promise<unknown>;
+    /** 词边界 `@` 输入触发：query 为 `@` 后文本，anchorRect 为弹层锚点 */
+    onMentionTrigger?: (query: string, anchorRect: DOMRect) => void;
+    /** "+" 按钮触发弹层入口 */
+    onPlusMenu?: (anchorRect: DOMRect) => void;
+    /** Composer 工具栏左 / 右槽（ReactNode 闭包槽，纯 React 与 DSL 场景均可用） */
+    toolbarStart?: ReactNode;
+    toolbarEnd?: ReactNode;
+    /** 工作区头部右侧扩展区（提供 title 或 headerExtra 时渲染头部） */
+    headerExtra?: ReactNode;
+}
+/**
+ * ChatWorkspace 的 DSL 安全 props（spec: chat-dsl-page / DSL 安全 props）：
+ * 全部为 DSL 可表达的标量 / 数组 / 普通对象；函数与类实例一律不出现。
+ */
+interface ChatWorkspaceProps {
+    /** 工作区头部标题（提供 title 或服务注入 headerExtra 时渲染头部） */
+    title?: string;
+    /** 空会话问候语 */
+    greeting?: string;
+    /** 空会话副标题 */
+    subtitle?: string;
+    /** 空会话起始建议；空数组 / 未传时不渲染建议区 */
+    suggestions?: ChatSuggestion[];
+    /** 会话 id（注入 dsl part 作用域 conversation.id） */
+    conversationId?: string;
+    /** 注入 dsl part 作用域 params */
+    params?: Record<string, unknown>;
+    /**
+     * 侧栏 DslNode 槽（任务 1.1 结论：renderer 对内嵌 DslNode prop 跳过提前
+     * 求值，组件经 useRenderer().renderChildren 渲染）。提供时以 AppShell
+     * 包裹工作区（侧栏 + 移动端抽屉）。仅页面运行时上下文内有效。
+     */
+    sidebar?: DslNode;
+    /** Composer 工具栏右端 DslNode 槽（与服务注入的 toolbarEnd 先后渲染） */
+    toolbarEnd?: DslNode;
+    /**
+     * 产出物面板受控 props（spec: chat-artifact-panel，决策 D2）：
+     * 任一提供即全受控；都未提供时由内部 / 注入的 ArtifactStore 驱动
+     */
+    artifact?: ChatArtifact | null;
+    panelOpen?: boolean;
+    /** 面板关闭回调（runtime 绑定 events.onPanelClose 时以函数形态传入） */
+    onPanelClose?: () => void;
+    /** 面板内容 DslNode 槽：提供时整体替代内建渲染器 */
+    inspector?: DslNode;
+    /** artifact part 就绪回调（runtime 绑定 events.onArtifact 时传入） */
+    onArtifact?: (artifact: ChatArtifact) => void;
+    /** 产出物卡片"在面板中打开"回调（runtime 绑定 events.onOpenArtifact 时传入） */
+    onOpenArtifact?: (artifact: ChatArtifact) => void;
+    /**
+     * 内建 header 操作组（spec: chat-dsl-component / Header 配置，决策 D4）：
+     * 按数组顺序渲染（headerExtra 槽之前）；缺省不渲染
+     */
+    headerActions?: ChatHeaderAction[];
+    /** 标题可编辑（点击进入编辑，Enter / blur 提交）；缺省 false */
+    editableTitle?: boolean;
+    onExport?: () => void;
+    onThemeChange?: (theme: 'light' | 'dark') => void;
+    onClear?: () => void;
+    onTitleChange?: (title: string) => void;
+    /** 内建模型选择（spec: chat-model-selector，决策 D5 受控规则） */
+    models?: ChatModelOption[];
+    model?: string;
+    onModelChange?: (value: string) => void;
+    /**
+     * 模型 chip 渲染位置（spec: chat-model-selector / 模型选择位置配置，
+     * 决策 D2；DSL 可序列化标量，缺省 'composer'）。'header' 时头部渲染
+     * 条件扩展：仅配置 models（无 title / headerExtra）也渲染极简头部
+     */
+    modelPlacement?: 'composer' | 'header';
+    /** 内建上下文数据源（spec: chat-context-sources） */
+    contexts?: ChatContextSource[];
+    onContextsChange?: (chips: ChatContextItem[]) => void;
+    /** 消息操作条声明式配置（spec: chat-message-actions；DSL 可序列化数据） */
+    messageActions?: Array<BuiltinMessageAction | ChatMessageAction>;
+    /** 消息动作点击通知（runtime 绑定 events.onMessageAction 时以函数形态传入） */
+    onMessageAction?: (actionId: string, message: ChatMessage) => void;
+    className?: string;
+}
+/**
+ * createChatWorkspace（spec: chat-dsl-page / chat-dsl-component，决策 D5）：
+ * 宿主闭包注入全部运行时服务，返回可注册进 DSL 组件注册表
+ * （options.components）的 ChatWorkspace 组件。
+ *
+ * 实现为 ChatServicesProvider + ChatComposition 的薄封装（与 Chat 组件
+ * 共用同一组合，逻辑单一来源）；行为与 DSL props 契约保持不变。
+ */
+declare function createChatWorkspace(services: ChatWorkspaceServices): (props: ChatWorkspaceProps) => ReactNode;
+
+/**
+ * Chat 的运行时服务（spec: chat-dsl-component，设计决策 D1）：
+ * 与 ChatWorkspaceServices 同型——transport 必填，其余可选。
+ * 表达式作用域只承载可序列化数据，函数 / 实例不进 DSL props，
+ * 故服务经 React Context 注入一次，`Chat` 组件就近读取。
+ */
+type ChatServices = ChatWorkspaceServices;
+/**
+ * 宿主在应用根部注入一次聊天服务；其下所有 `Chat` 组件（含 DSL 页面
+ * 渲染的实例）经 context 消费。多层嵌套时就近原则生效。
+ */
+declare function ChatServicesProvider({ value, children, }: {
+    value: ChatServices;
+    children?: ReactNode;
+}): ReactNode;
+/** 读取最近的 ChatServicesProvider；无 provider 返回 null（不抛错） */
+declare function useChatServices(): ChatServices | null;
+
+/**
+ * 菜单项（spec: chat-dsl-component，设计决策 D2）：纯数据驱动——
+ * DSL 可表达的标量字段，图标为字符串名（白名单映射内置 lucide 子集，
+ * 避免 DSL 携带组件）。`group` 为分组标题：与上一项 group 不同时
+ * 在该项之前渲染分组行。
+ */
+interface ChatMenuItem {
+    key: string;
+    label: string;
+    /** 字符串图标名（plus / chat / history / settings / star / search / user / folder）；未知名渲染占位圆点 */
+    icon?: string;
+    badge?: string | number;
+    /** 状态圆点（spec: chat-dsl-component / 菜单项状态点，决策 D4）：label 右侧渲染 danger 系小圆点；与 badge 可共存 */
+    dot?: boolean;
+    disabled?: boolean;
+    /** 分组标题（相邻同组只渲染一次） */
+    group?: string;
+}
+/**
+ * Chat 组件 props（spec: chat-dsl-component）：标量 / 数组 / 普通对象为
+ * DSL 可表达配置；sidebar / headerExtra / header 槽同时接受 DslNode
+ * （页面运行时内经 renderChildren 渲染）与 ReactNode（纯 React 直连）。
+ */
+interface ChatProps {
+    /** 内建 header 标题 */
+    title?: string;
+    /** 空会话问候语 */
+    greeting?: string;
+    /** 空会话副标题 */
+    subtitle?: string;
+    /** 空会话起始建议；空数组 / 未传时不渲染建议区 */
+    suggestions?: ChatSuggestion[];
+    /** 会话 id（注入 dsl part 作用域 conversation.id） */
+    conversationId?: string;
+    /** 注入 dsl part 作用域 params */
+    params?: Record<string, unknown>;
+    /** 传 false 关闭 header；缺省渲染（header 槽整体替换 > title + headerExtra 内建 header） */
+    showHeader?: boolean;
+    /** 左侧菜单数据；提供时以 AppShell 承载内建侧栏 */
+    menu?: ChatMenuItem[];
+    /** 受控高亮项 key（DSL 侧可绑 ${state.x}，经 onMenuSelect + setState 闭环） */
+    activeMenuKey?: string;
+    /** 侧栏槽：提供时替代内建菜单侧栏 */
+    sidebar?: DslNode | ReactNode;
+    /** 内建 header 标题右侧槽 */
+    headerExtra?: DslNode | ReactNode;
+    /** header 槽：整体替换内建 header */
+    header?: DslNode | ReactNode;
+    /**
+     * 内建 header 操作组（spec: chat-dsl-component / Header 配置，决策 D4）：
+     * 按数组顺序渲染 export / theme / clear 图标按钮（headerExtra 槽之前）；
+     * 缺省不渲染。默认行为总在包内执行，事件为并行通知
+     */
+    headerActions?: ChatHeaderAction[];
+    /** 标题可编辑（点击进入编辑，Enter / blur 提交）；缺省 false */
+    editableTitle?: boolean;
+    onExport?: () => void;
+    onThemeChange?: (theme: 'light' | 'dark') => void;
+    onClear?: () => void;
+    onTitleChange?: (title: string) => void;
+    /**
+     * 内建模型选择（spec: chat-model-selector）：DSL 可表达数据；
+     * model + onModelChange 构成受控闭环（典型接法：
+     * model: ${state.model} + events.onModelChange → setState）
+     */
+    models?: ChatModelOption[];
+    model?: string;
+    onModelChange?: (value: string) => void;
+    /** 模型 chip 渲染位置（spec: chat-model-selector / 模型选择位置配置，决策 D2；DSL 可序列化标量，缺省 'composer'） */
+    modelPlacement?: 'composer' | 'header';
+    /** 内建上下文数据源（spec: chat-context-sources）；service 引用经 ChatServices.callService 解析 */
+    contexts?: ChatContextSource[];
+    onContextsChange?: (chips: ChatContextItem[]) => void;
+    /**
+     * 消息操作条声明式配置（spec: chat-message-actions，决策 D1）：
+     * DSL 可序列化数据；缺省渲染内建 copy / regenerate / retry / edit；
+     * 传入数组时严格按数组渲染（数组即真相），自定义动作 service 引用经
+     * ChatServices.callService 派发
+     */
+    messageActions?: Array<BuiltinMessageAction | ChatMessageAction>;
+    /** 消息动作点击通知（event 作用域含 action 与 message；内建动作亦通知） */
+    onMessageAction?: (actionId: string, message: ChatMessage) => void;
+    /**
+     * 产出物面板（spec: chat-artifact-panel / chat-dsl-component，决策 D2）：
+     * `artifact` / `panelOpen` 可绑 DSL state；任一提供即全受控，
+     * 都未提供时由内部 / 注入的 ArtifactStore 驱动
+     */
+    artifact?: ChatArtifact | null;
+    panelOpen?: boolean;
+    /** 面板关闭按钮 / 窄屏遮罩点击回调（典型接法：setState panelOpen=false） */
+    onPanelClose?: () => void;
+    /** 面板内容槽：提供时整体替代面板内建渲染器 */
+    inspector?: DslNode | ReactNode;
+    /** artifact part 就绪时触发（event 作用域含 artifact；框架不擅自开面板） */
+    onArtifact?: (artifact: ChatArtifact) => void;
+    /** 产出物卡片"在面板中打开"按钮点击回调（event 作用域含 artifact；受控场景的开面板入口） */
+    onOpenArtifact?: (artifact: ChatArtifact) => void;
+    className?: string;
+    /** 发送回调：与 transport 驱动 turn 并行（同 ChatView onSend 语义） */
+    onSend?: (text: string) => void;
+    /** 菜单项点击回调（disabled 项不触发） */
+    onMenuSelect?: (key: string, item: ChatMenuItem) => void;
+}
+/** 菜单图标名 → lucide 子集（白名单式，未知名渲染占位圆点，不抛错） */
+declare const MENU_ICONS: Record<string, ComponentType<{
+    size?: number;
+    strokeWidth?: number;
+}>>;
+/** 内建侧栏：menu 数据驱动的菜单（分组标题 + 图标 + badge + disabled）；ChatShell 同款复用 */
+declare function ChatSidebarMenu({ menu, activeMenuKey, onMenuSelect, }: {
+    menu: ChatMenuItem[];
+    activeMenuKey?: string;
+    onMenuSelect?: (key: string, item: ChatMenuItem) => void;
+}): ReactNode;
+/**
+ * Chat（spec: chat-dsl-component）：一等 DSL 聊天工作区组件——
+ * 与 Button / Input 同级，注册后 `{ type: 'Chat', props, events }` 即可声明。
+ *
+ * 服务经最近的 ChatServicesProvider 读取（决策 D1）；缺失时渲染受控
+ * 「未配置聊天服务」提示并 console.warn，不抛错。组合逻辑与
+ * createChatWorkspace 共用内部 ChatComposition（决策 D5）。
+ */
+declare function Chat({ title, greeting, subtitle, suggestions, conversationId, params, showHeader, menu, activeMenuKey, sidebar, headerExtra, header, headerActions, editableTitle, onExport, onThemeChange, onClear, onTitleChange, models, model, onModelChange, modelPlacement, contexts, onContextsChange, messageActions, onMessageAction, artifact, panelOpen, onPanelClose, inspector, onArtifact, onOpenArtifact, className, onSend, onMenuSelect, }: ChatProps): ReactNode;
+/** Chat 的 DSL 组件类型名 */
+declare const CHAT_COMPONENT_TYPE = "Chat";
+/**
+ * 注册 Chat DSL 组件（spec: chat-dsl-component / Chat 组件注册）：
+ * 已存在同名类型时不覆盖（沿用 registerChatLayout 的语义）。
+ * ChatShell（spec: chat-dsl-component / ChatShell 外壳组件，决策 D6）
+ * 一并注册，同样不覆盖已有同名类型。
+ */
+declare function registerChatComponent(registry: Registry<unknown>): void;
+
+/**
+ * ChatShell（spec: chat-dsl-component / ChatShell 外壳组件，设计决策 D6）：
+ * 菜单外壳 = AppShell + 内建菜单侧栏（复用 Chat 的 ChatMenuItem 数据 /
+ * 图标白名单 / activeMenuKey 高亮 / onMenuSelect 事件）+ 主区内容槽。
+ *
+ * 纯展示外壳：MUST NOT 含聊天逻辑与路由逻辑——菜单点击只发事件，
+ * 导航还是状态切换由宿主 / DSL 决定。典型用法：DSL 场景 content 槽内
+ * 放若干带 when 条件的子树（onMenuSelect → setState 闭环）；应用场景
+ * content 传路由出口（onMenuSelect → bridge.push，刷新由路由还原）。
+ */
+interface ChatShellProps {
+    /** 左侧菜单数据；提供时以 AppShell 承载内建菜单侧栏 */
+    menu?: ChatMenuItem[];
+    /** 受控高亮项 key（DSL 侧可绑 ${state.x}，经 onMenuSelect + setState 闭环） */
+    activeMenuKey?: string;
+    /** 品牌区（透传 AppShell）：移动端顶栏 + 桌面侧栏顶部品牌行（决策 D3） */
+    brand?: ReactNode;
+    /** 桌面端可折叠为 icon rail（透传 AppShell；DSL 可序列化布尔，缺省 false） */
+    collapsible?: boolean;
+    /** 侧栏槽：提供时替代内建菜单侧栏 */
+    sidebar?: DslNode | ReactNode;
+    /** 侧栏底部固定槽（spec: chat-app-shell / 侧栏底部槽）：DslNode 经 renderChildren 渲染，ReactNode 原样渲染 */
+    sidebarFooter?: DslNode | ReactNode;
+    /** 主区内容槽：DslNode 经 renderChildren 渲染；ReactNode 原样渲染（路由出口等） */
+    content?: DslNode | ReactNode;
+    className?: string;
+    /** 菜单项点击回调（disabled 项不触发；DSL 侧 event 含 key 与 item） */
+    onMenuSelect?: (key: string, item: ChatMenuItem) => void;
+}
+declare function ChatShell({ menu, activeMenuKey, brand, collapsible, sidebar, sidebarFooter, content, className, onMenuSelect, }: ChatShellProps): ReactNode;
+/** ChatShell 的 DSL 组件类型名 */
+declare const CHAT_SHELL_COMPONENT_TYPE = "ChatShell";
+/**
+ * 注册 ChatShell DSL 组件：已存在同名类型时 MUST NOT 覆盖。
+ * 一般由 registerChatComponent 一并调用（Chat 与 ChatShell 同源注册）。
+ */
+declare function registerChatShellComponent(registry: Registry<unknown>): void;
+
+/**
+ * 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 抛错。
+ *
+ * 纯展示组件：关闭只触发 onClose，不单方面修改外部状态。
+ */
+interface ArtifactPanelProps {
+    /** 当前产出物；null 时内容区为空态（inspector 槽场景常见） */
+    artifact?: ChatArtifact | null;
+    /** 面板内容槽：提供时整体替代内建渲染器（标题栏保留） */
+    inspector?: ReactNode;
+    /** 关闭按钮 / 遮罩点击回调 */
+    onClose?: () => void;
+    /** dsl 产出物活预览的 Safe Registry；缺省时 dsl 内容渲染降级块 */
+    safeRegistry?: Registry<unknown>;
+    /** 注入 dsl 预览作用域 user */
+    user?: Record<string, unknown>;
+    className?: string;
+}
+declare function ArtifactPanel({ artifact, inspector, onClose, safeRegistry, user, className, }: ArtifactPanelProps): ReactNode;
+
+declare function useSidebarDrawer(): {
+    close: () => void;
+    collapsed: boolean;
+} | null;
+interface AppShellProps {
+    /** 侧栏内容（会话列表等），完全由调用方注入 */
+    sidebar: ReactNode;
+    /** 品牌区内容（logo / 名称）：移动端渲染在顶栏；桌面端渲染在侧栏顶部品牌行（决策 D3） */
+    brand?: ReactNode;
+    /**
+     * 路由 / 会话切换标识：值变化时抽屉在渲染期关闭
+     * （compare-during-render，框架无关，替代路由 hook 耦合）
+     */
+    locationKey?: string;
+    /**
+     * 侧栏底部固定区（spec: chat-app-shell / 侧栏底部槽）：渲染在侧栏
+     * 滚动区之后（不随菜单滚动）；未提供时不渲染容器（零渲染承诺）
+     */
+    sidebarFooter?: ReactNode;
+    /**
+     * 桌面端可折叠（spec: chat-app-shell / 桌面侧栏头部与折叠，决策 D3）：
+     * 为 true 时品牌行右端渲染折叠按钮，点击切换内部非受控 collapsed
+     * 状态——折叠后桌面侧栏收窄为 icon rail；移动端不渲染折叠按钮、
+     * 抽屉语义不受影响。缺省 false
+     */
+    collapsible?: boolean;
+    children: ReactNode;
+    className?: string;
+}
+/**
+ * AppShell（spec: chat-app-shell）：聊天工作区应用外壳 = 侧栏插槽 + 主区。
+ *
+ * 桌面（≥768px）：侧栏与主区在 flex 行内同级排列；
+ * 移动端（<768px）：侧栏退出文档流变为左侧覆盖抽屉（遮罩 + 顶栏菜单按钮）。
+ * 布局切换全部在 styles.css 媒体查询（`.pactor-chat-shell*`）中表达，
+ * JS 只拥有抽屉开合状态 `drawerOpen`。
+ */
+declare function AppShell({ sidebar, brand, locationKey, sidebarFooter, collapsible, children, className }: AppShellProps): react.JSX.Element;
+
+/**
+ * 上下文数据源解析与候选列表（spec: chat-context-sources，设计决策 D1/D5）：
+ * 内部组件（不从 index.ts 导出），内建 @ 提及弹层与 + 菜单共用。
+ *
+ * - 静态 `items` 直用；`service` 引用经注入的 `callService(name, params)`
+ *   异步解析，结果按 source 键（service 名 + params JSON）做会话级缓存
+ *   （Map 存 promise，同一弹层会话不重复请求）
+ * - `callService` 未注入而 source 引用 service 时渲染内联错误提示，
+ *   不抛错、不击穿组件树（与 Safe Registry 的受控降级同款取向）
+ */
+/** callService 服务桥签名（与 ChatServices.callService 同型） */
+type CallChatService = (name: string, params?: Record<string, unknown>) => Promise<unknown>;
+
+/**
+ * Composer（spec: chat-view / Composer + chat-composer-extensions）：
+ * 自适应高度 textarea + 状态机发送按钮（disabled / ready / streaming
+ * 停止，同一按钮元素切换，streaming 态带纯 CSS 光环）。
+ *
+ * - IME 守卫（D6）：compositionstart/end + keydown.isComposing 兜底，
+ *   合成中 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）
+ */
+interface ComposerProps {
+    /** 发送回调；输入框在回调后清空 */
+    onSend?: (text: string) => void;
+    /** 流式中为 true：按钮变为停止，点击触发 onStop */
+    streaming?: boolean;
+    /** 停止当前 turn */
+    onStop?: () => void;
+    placeholder?: string;
+    disabled?: boolean;
+    /** 受控附件列表（提供即渲染附件区；上传与存储由调用方负责） */
+    attachments?: ChatAttachment[];
+    /** 附件列表变更（卡片移除后回调新数组） */
+    onAttachmentsChange?: (attachments: ChatAttachment[]) => void;
+    /** 粘贴 / 拖拽 / 文件选择产出的原始文件，交给调用方处理 */
+    onAttachFiles?: (files: File[]) => void;
+    /** 附件卡片点击通知（预览等由调用方实现） */
+    onAttachmentClick?: (attachment: ChatAttachment) => void;
+    /** 工具栏左 / 右渲染槽 */
+    toolbarStart?: ReactNode;
+    toolbarEnd?: ReactNode;
+    /** 词边界 `@` 输入触发：query 为 `@` 后文本，anchorRect 为弹层锚点 */
+    onMentionTrigger?: (query: string, anchorRect: DOMRect) => void;
+    /** "+" 按钮触发弹层入口 */
+    onPlusMenu?: (anchorRect: DOMRect) => void;
+    /**
+     * 内建模型选择（spec: chat-model-selector）：非空时工具栏右端渲染
+     * 内建模型 chip（位于 toolbarEnd 槽内容之前）；缺省 / 空数组不渲染
+     */
+    models?: ChatModelOption[];
+    /** 当前选中模型 value（由 ChatView 经受控规则 D5 解析后传入） */
+    model?: string;
+    /** 弹层中选中模型时触发 */
+    onModelChange?: (value: string) => void;
+    /**
+     * 内建上下文数据源（spec: chat-context-sources）：存在 `trigger: '@'`
+     * 的 source 且未注入 onMentionTrigger 时启用内建提及弹层；存在
+     * `trigger: '+'` 的 source 且未注入 onPlusMenu 时渲染内建 "+" 入口
+     */
+    contextSources?: ChatContextSource[];
+    /** 上下文 chips（受控：由 ChatView 持有，渲染在输入区上方） */
+    contextChips?: ChatContextItem[];
+    /** chips 变更回调（选中追加 / 单独移除） */
+    onContextChipsChange?: (chips: ChatContextItem[]) => void;
+    /** service 引用解析出口（ChatServices.callService 透传） */
+    callService?: CallChatService;
+}
+declare function Composer({ onSend, streaming, onStop, placeholder, disabled, attachments, onAttachmentsChange, onAttachFiles, onAttachmentClick, toolbarStart, toolbarEnd, onMentionTrigger, onPlusMenu, models, model, onModelChange, contextSources, contextChips, onContextChipsChange, callService, }: ComposerProps): react.JSX.Element;
+
+/**
+ * ChatView（设计决策 D6）：消息列表（useSyncExternalStore 订阅
+ * ConversationStore）+ Composer。
+ *
+ * 发送语义：`onSend` 回调先行（业务可完全自管）；注入 `transport`
+ * 时同时经 `runChatTurn` 驱动一轮对话（user 消息 + assistant 占位 +
+ * 流式 reduce）。通常二选一。
+ *
+ * 流式交互（技术选型参考 DeepTutor web）：
+ * - 流式中 Composer 发送按钮变为停止按钮，点击 abort 当前 turn
+ *   （assistant 消息以 cancelled 收尾）；
+ * - 消息区贴底自动跟随，用户上翻释放、回底恢复，释放期间显示
+ *   "回到底部"浮动按钮。
+ *
+ * Composer 扩展 props（attachments / onAttachFiles / toolbar 槽 /
+ * 提及与 "+" 触发等，见 ComposerProps）原样透传给内建 Composer。
+ */
+interface ChatViewProps extends Pick<ComposerProps, 'attachments' | 'onAttachmentsChange' | 'onAttachFiles' | 'onAttachmentClick' | 'toolbarStart' | 'toolbarEnd' | 'onMentionTrigger' | 'onPlusMenu'> {
+    store: ConversationStore;
+    /** 注入后发送即驱动 turn；缺省时仅触发 onSend */
+    transport?: ChatTransport;
+    onSend?: (text: string) => void;
+    /** Safe Registry（createSafeRegistry 包装后的白名单注册表） */
+    safeRegistry?: Registry<unknown>;
+    /** capability 白名单与确认链（注入 capabilities 时注册 capability 动作） */
+    capabilities?: ChatCapabilityRegistry;
+    permission?: ChatPermissionChecker;
+    confirm?: ChatConfirm;
+    /** 会话 id（注入 dsl part 作用域 conversation.id） */
+    conversationId?: string;
+    /** 注入 dsl part 作用域 user / params */
+    user?: Record<string, unknown>;
+    params?: Record<string, unknown>;
+    /** 空会话问候语（缺省用内置默认文案） */
+    greeting?: string;
+    /** 空会话副标题 */
+    subtitle?: string;
+    /** 空会话起始建议；空数组 / 未传时不渲染建议区 */
+    suggestions?: ChatSuggestion[];
+    /**
+     * artifact part 就绪（status ready）时触发（spec: chat-dsl-component /
+     * 产出物事件）；同一 part 只触发一次，框架不擅自打开面板
+     */
+    onArtifact?: (artifact: ChatArtifact) => void;
+    /** artifact 卡片"在面板中打开"回调（透传 PartRenderer） */
+    onOpenArtifact?: (artifact: ChatArtifact) => void;
+    /**
+     * 内建模型选择（spec: chat-model-selector，决策 D5）：
+     * `model` + `onModelChange` 同时提供即受控（以 props 为准）；
+     * 仅提供 `models` 时组件自持选中态（缺省 models[0]）；
+     * 未配置 models 时不渲染 chip 且 ChatInput.model 为 undefined
+     */
+    models?: ChatModelOption[];
+    model?: string;
+    onModelChange?: (value: string) => void;
+    /**
+     * 模型 chip 渲染位置（spec: chat-model-selector / 模型选择位置配置，
+     * 决策 D2）：缺省 'composer'（Composer 工具栏右端）；'header' 时
+     * Composer 不再渲染 chip（chip 由 ChatComposition 渲染到工作区头部
+     * 左端——ChatView 单独使用时 'header' 等效于不渲染 chip）
+     */
+    modelPlacement?: 'composer' | 'header';
+    /**
+     * 内建上下文数据源（spec: chat-context-sources）：chips 状态由
+     * ChatView 自持（选中追加 / 单独移除 / 发送后清空），
+     * `onContextsChange` 并行通知；未配置时不启用内建弹层与 "+" 入口
+     */
+    contexts?: ChatContextSource[];
+    onContextsChange?: (chips: ChatContextItem[]) => void;
+    /** service 引用解析出口（ChatServices.callService 透传 Composer 与消息动作条） */
+    callService?: CallChatService;
+    /**
+     * 消息操作条声明式配置（spec: chat-message-actions，决策 D1）：
+     * 缺省等价于 `['copy', 'regenerate', 'retry', 'edit']`（与历史行为一致）；
+     * 传入数组时严格按数组顺序与内容渲染，未列出的内建动作不出现
+     */
+    messageActions?: Array<BuiltinMessageAction | ChatMessageAction>;
+    /** 全部消息动作（含内建）点击的并行通知（event 语义，不影响内建默认行为） */
+    onMessageAction?: (actionId: string, message: ChatMessage) => void;
+    className?: string;
+}
+declare function ChatView({ store, transport, onSend, safeRegistry, capabilities, permission, confirm, conversationId, user, params, greeting, subtitle, suggestions, className, onArtifact, onOpenArtifact, attachments, onAttachmentsChange, onAttachFiles, onAttachmentClick, toolbarStart, toolbarEnd, onMentionTrigger, onPlusMenu, models, model, onModelChange, modelPlacement, contexts, onContextsChange, callService, messageActions, onMessageAction, }: ChatViewProps): react.JSX.Element;
+
+/**
+ * ActivityTrace（spec: chat-activity-trace，设计决策 D1/D4）：
+ * assistant 消息顶部的活动轨迹区。
+ *
+ * - 流式状态头（StreamingStatus）：动画图标 + 呼吸状态文案 + 秒级计时，
+ *   模式由纯函数 detectStreamingMode 推导；消息结束后定格为完成态；
+ * - 配对工具轨迹（TraceRow）：pairToolTraces 输出的单行可展开条目；
+ * - thinking 折叠卡（ThinkingCard）：markdown 正文，流式展开 + 进行中指示，
+ *   答案阶段自动折叠，用户操作后 pin。
+ *
+ * 折叠状态机（每条消息独立，随组件实例记忆）：`auto | pinned-open |
+ * pinned-closed`——auto 跟随流式阶段；用户点击后 pin，不再自动变更。
+ */
+interface ActivityTraceProps {
+    message: ChatMessage;
+}
+declare function ActivityTrace({ message }: ActivityTraceProps): react.JSX.Element;
+
+/**
+ * MessageBubble：按 role 区分呈现（参考 DeepTutor web 消息区设计）——
+ * user 右侧圆角气泡；assistant 左侧通栏排版：顶部活动轨迹区
+ * （ActivityTrace：状态头 + thinking + 配对工具轨迹），正文 parts 按序
+ * 渲染；hover 操作条（MessageActions：复制 / 重新生成 / 编辑 / 重试）；
+ * system 居中弱提示。
+ * 颜色经 `--pactor-chat-*` 变量表达。
+ */
+interface MessageBubbleProps {
+    message: ChatMessage;
+    /** 透传给 dsl part 的渲染运行时与作用域 */
+    runtime?: ChatRuntime;
+    scope?: Omit<ChatScope, 'message'>;
+    params?: Record<string, unknown>;
+    /** 末条已完成 assistant 消息：提供 onRegenerate 时出示重新生成入口 */
+    showRegenerate?: boolean;
+    /** 重新生成回调（spec: chat-message-actions / 重新生成） */
+    onRegenerate?: () => void;
+    /** error 消息重试回调（spec: chat-message-actions / 错误重试） */
+    onRetry?: () => void;
+    /**
+     * user 消息编辑重发回调（spec: chat-message-actions / 用户消息编辑重发）：
+     * 提供时出示编辑入口；确认后以新文本回调（调用方负责截断 store 并重跑
+     * turn）；取消编辑不触任何回调。
+     */
+    onEditResend?: (text: string) => void;
+    /**
+     * 消息操作条声明式配置（spec: chat-message-actions，透传 MessageActions）：
+     * 缺省渲染内建 copy / regenerate / retry / edit（与历史行为一致）
+     */
+    messageActions?: Array<BuiltinMessageAction | ChatMessageAction>;
+    /** 自定义动作服务派发出口（ChatServices.callService 透传） */
+    callService?: CallChatService;
+    /** 全部动作（含内建）点击的并行通知 */
+    onMessageAction?: (actionId: string, message: ChatMessage) => void;
+    /** artifact 卡片"在面板中打开"回调（透传 PartRenderer） */
+    onOpenArtifact?: (artifact: ChatArtifact) => void;
+}
+declare function MessageBubble({ message, runtime, scope, showRegenerate, onRegenerate, onRetry, onEditResend, messageActions, callService, onMessageAction, onOpenArtifact, }: MessageBubbleProps): react.JSX.Element;
+
+/**
+ * MessageActions（spec: chat-message-actions / 消息操作条）：
+ * 消息 hover 显现的操作条，数据驱动渲染——`actions` 缺省为
+ * `['copy', 'regenerate', 'retry', 'edit']`（与历史硬编码渲染一致）；
+ * 传入数组时严格按数组顺序与内容渲染（数组即真相，未列出的内建动作
+ * 不出现）。内建动作保留包内默认行为（复制写剪贴板 / 重新生成 / 重试 /
+ * 编辑进内联编辑框），配置的 label / icon / roles / visibleWhen 按字段
+ * 覆盖内建默认描述；「regenerate 仅末条 assistant」与 transport 依赖为
+ * 不可覆盖的附加约束。自定义动作（无 builtin）点击经 callService 派发
+ * （未注入时 console.warn 跳过，不抛错）；全部动作点击并行触发
+ * onMessageAction 通知。
+ *
+ * 接口边界（D0）：组件只做展示与回调触发，turn 驱动由调用方
+ * （ChatView）注入；无回调时对应内建入口不渲染。
+ */
+interface MessageActionsProps {
+    message: ChatMessage;
+    /**
+     * 操作条声明式配置（spec: chat-message-actions，决策 D1）：
+     * 缺省等价于 `['copy', 'regenerate', 'retry', 'edit']`；
+     * 字符串项等价于 `{ id: <name>, builtin: <name> }`
+     */
+    actions?: Array<BuiltinMessageAction | ChatMessageAction>;
+    /** 末条已完成 assistant：regenerate 附加约束（不可被配置覆盖） */
+    showRegenerate?: boolean;
+    /** 重新生成回调（未提供时 regenerate 不渲染） */
+    onRegenerate?: () => void;
+    /** user 消息编辑入口回调（未提供时 edit 不渲染） */
+    onEdit?: () => void;
+    /** error 消息重试回调（未提供时 retry 不渲染） */
+    onRetry?: () => void;
+    /** error 消息：重试入口常显（不依赖 hover） */
+    forceVisible?: boolean;
+    /** 自定义动作服务派发出口（ChatServices.callService 透传） */
+    callService?: CallChatService;
+    /** 全部动作（含内建）点击的并行通知 */
+    onMessageAction?: (actionId: string, message: ChatMessage) => void;
+}
+/** 动作图标名 → lucide 子集（白名单式，同菜单 MENU_ICONS 口径；未知名渲染占位图标，不抛错） */
+declare const MESSAGE_ACTION_ICONS: Record<string, ComponentType<{
+    size?: number;
+}>>;
+/** 收集消息的可复制文本（text / markdown part 按序拼接） */
+declare function collectMessageText(message: ChatMessage): string;
+declare function MessageActions({ message, actions, showRegenerate, onRegenerate, onEdit, onRetry, forceVisible, callService, onMessageAction, }: MessageActionsProps): react.JSX.Element | null;
+
+/**
+ * PartRenderer：按 part 类型渲染。
+ *
+ * - text → 文本段落；markdown → @pactor-app/markdown 安全渲染器
+ *   （streaming 期间经 useSmoothStreamText 打字机揭示）
+ * - dsl → runtime DslRenderer（Safe Registry + chat 作用域），
+ *   白名单外节点经 guardChatDsl 替换为受控"不允许"占位
+ * - tool-call / tool-result / thinking → 不在此渲染（由 assistant 消息
+ *   顶部的 ActivityTrace 配对 / 折叠呈现，见 chat-activity-trace）
+ * - error → 自绘警示条；status → 弱提示文本
+ * - artifact → 产出物卡片（标题 + kind 角标 + "在面板中打开"按钮，
+ *   spec: chat-artifact-panel）
+ *
+ * 视图零 antd 依赖，颜色经 `@pactor-app/chat/styles.css` 的
+ * `--pactor-chat-*` 变量表达。
+ */
+interface PartRendererProps {
+    part: ChatPart;
+    /** dsl part 渲染运行时（缺省时 dsl part 渲染受控占位） */
+    runtime?: ChatRuntime;
+    /** dsl part 的 chat 作用域 */
+    scope?: ChatScope;
+    /** 所属消息是否流式中（text/markdown 启用平滑揭示） */
+    streaming?: boolean;
+    /** artifact 卡片"在面板中打开"回调（spec: chat-artifact-panel） */
+    onOpenArtifact?: (artifact: ChatArtifact) => void;
+}
+/** 白名单外组件的受控占位（注册名 ChatDenied，见 dsl-guard） */
+declare function ChatDenied({ deniedType }: {
+    deniedType?: string;
+}): react.JSX.Element;
+declare function PartRenderer({ part, runtime, scope, streaming, onOpenArtifact }: PartRendererProps): react.JSX.Element | null;
+
+/**
+ * ChatLayout（设计决策 D6）：chat 布局 = header（title）+ ChatView 区。
+ * V1 无会话历史侧栏。颜色经 `--pactor-chat-*` 变量表达
+ * （`@pactor-app/chat/styles.css`），布局结构类样式同文件。
+ */
+interface ChatLayoutProps {
+    title?: ReactNode;
+    children?: ReactNode;
+}
+declare function ChatLayout({ title, children }: ChatLayoutProps): react.JSX.Element;
+/** 布局类型名（resolveLayout(registry, 'chat') 命中） */
+declare const CHAT_LAYOUT_TYPE = "chat";
+/**
+ * 结构化 LayoutRegistry（兼容 @pactor-app/ui layout 层的 LayoutRegistry =
+ * Registry<LayoutComponent>）：以结构化类型声明，避免对
+ * @pactor-app/ui 产生运行时依赖。
+ */
+interface ChatLayoutRegistry {
+    has(name: string): boolean;
+    register(name: string, component: ComponentType<any>): void;
+}
+/** 注册 chat 布局（已注册时不覆盖，与 createLayoutRegistry 约定一致） */
+declare function registerChatLayout(layoutRegistry: ChatLayoutRegistry): void;
+
+export { ActivityTrace, type ActivityTraceProps, AppShell, type AppShellProps, ArtifactPanel, type ArtifactPanelProps, type ArtifactPatch, ArtifactStore, type BuiltinMessageAction, CHAT_COMPONENT_TYPE, CHAT_DENIED_TYPE, CHAT_LAYOUT_TYPE, CHAT_SHELL_COMPONENT_TYPE, type CapabilityActionDeps, type CapabilityHandler, Chat, type ChatArtifact, 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, MENU_ICONS, MESSAGE_ACTION_ICONS, 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, buildChatScope, collectMessageText, createChatId, createChatRuntime, createChatWorkspace, createManualDriver, createSafeRegistry, detectStreamingMode, guardChatDsl, pairToolTraces, registerCapabilityAction, registerChatComponent, registerChatLayout, registerChatShellComponent, runChatTurn, runRegenerateTurn, useChatAutoScroll, useChatServices, useSidebarDrawer, useSmoothStreamText };