@webskill/chatbot 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,1232 @@
+import { AgentLoopConfig, ApprovalScope, BridgeCapabilities, ExternalSkillProvider, ExternalToolSource, FileSystemProvider, InteractionRequest, InteractionResponse, LlmClient, NetworkPolicy, RenderBlock, RenderResultRequest, RunSnapshot, RunSnapshot as RunSnapshot$1, RuntimePhase, RuntimeRun, ScriptExecutor, TraceEvent, UiBridge, UiSurfaceActionRequest, UiSurfaceActionResponse, UiSurfaceDrafts, UiSurfaceEvent, UiSurfaceSnapshot } from "@webskill/sdk";
+import { SandboxMode } from "@webskill/sdk/browser";
+import { ReactBridgeState, SurfaceRegistry, UiSurfaceActionEvent } from "@webskill/sdk/ui-react";
+import "@webskill/sdk/ui";
+import "react";
+import "react/jsx-runtime";
+//#region ../ui-kit/src/i18n/types.d.ts
+type Locale = 'zh' | 'en';
+/** 单语言词条：key → 文案（支持 {name} 占位插值） */
+type LocaleMessages = Record<string, string>;
+/** 双语字典：zh/en 两个 locale 的键集必须一致（见 assertDictionaryComplete） */
+interface Dictionary {
+  en: LocaleMessages;
+  zh: LocaleMessages;
+}
+type DictionaryKey<D extends Dictionary> = keyof D['en'] & string;
+type InterpolationParams = Record<string, string | number>;
+/** t(key, params?)：查当前 locale 词条并做 {name} 插值 */
+type TranslateFn<D extends Dictionary = Dictionary> = (key: DictionaryKey<D>, params?: InterpolationParams) => string;
+//#endregion
+//#region ../runtime/src/sandbox/bridgeProtocol.d.ts
+/**
+ * 能力模式：true 直通 / false 关闭（TOOL_UNSUPPORTED）/ 'require-approval' 调用前强制授权
+ * （布尔语义与现状完全兼容）
+ */
+type CapabilityMode = boolean | 'require-approval';
+/** 授权粒度：'once-per-run'（默认，run 内同类能力批准一次）/ 'every-call'（每次调用都问） */
+type ApprovalScope$1 = 'once-per-run' | 'every-call';
+//#endregion
+//#region ../runtime/src/sandbox/networkPolicy.d.ts
+/**
+ * 网络策略类型 + 匹配逻辑（单一来源：browser worker 经函数字符串注入、
+ * node worker 直接 import，禁止各自重复实现）。
+ *
+ * 注意：isNetworkAllowed 会被 toString() 内嵌进浏览器 Worker bootstrap，
+ * 函数体必须自包含（不引用模块内其它符号），且不得使用模板字符串/反引号。
+ */
+type NetworkPolicy$1 = 'deny-all' | 'allow-all' | {
+  allow: string[];
+};
+//#endregion
+//#region ../ui-kit/src/runtime-config/types.d.ts
+/**
+ * 运行环境配置模型（P2）：console Configure Tab 编辑、chatbot ChatEngine 装配应用，
+ * 宿主经 RuntimeConfigStore 接线同一存储源（playground localStorage / 集成 OPFS 文件）。
+ * 默认值严格对齐 SDK（AgentLoop/InteractionPolicy/executor 缺省）。
+ */
+interface RuntimeLoopConfig {
+  maxTurns: number;
+  totalTimeoutMs: number;
+  toolTimeoutMs: number;
+  temperature?: number;
+  toolResultMaxBytes: number;
+  maxHistoryMessages: number;
+}
+interface RuntimeInteractionConfig {
+  missingParams: 'user' | 'llm';
+  confirmations: 'required' | 'auto-approve';
+  interactionTimeoutMs: number;
+  approvalScope: ApprovalScope$1;
+}
+type RuntimeRouterStrategy = 'progressive' | 'full-disclosure';
+/** 浏览器宿主执行器档位；Node 宿主的 in-process/worker/process 由宿主侧扩展展示 */
+type RuntimeSandboxExecutor = 'auto' | 'blob-worker' | 'iframe-sandbox';
+interface RuntimeSandboxConfig {
+  executor: RuntimeSandboxExecutor;
+  networkPolicy: NetworkPolicy$1;
+  capabilities: {
+    readReference: CapabilityMode;
+    writeArtifact: CapabilityMode;
+    confirm: CapabilityMode;
+  };
+}
+type RuntimeLlmProvider = 'openai-compatible' | 'anthropic' | 'google';
+interface RuntimeLlmConfig {
+  provider: RuntimeLlmProvider;
+  baseUrl?: string;
+  apiKey?: string;
+  model: string;
+  requestTimeoutMs?: number;
+}
+interface RuntimeConfig {
+  loop: RuntimeLoopConfig;
+  interaction: RuntimeInteractionConfig;
+  router: {
+    strategy: RuntimeRouterStrategy;
+  };
+  streaming: boolean;
+  renderResult: boolean;
+  sandbox: RuntimeSandboxConfig;
+  llm: RuntimeLlmConfig;
+}
+interface RuntimeConfigStore {
+  /**
+   * Loads the runtime configuration. Implementations SHOULD return a complete
+   * RuntimeConfig; consumers wrap stores with `withRuntimeConfigDefaults` so partial
+   * or legacy data is normalized through `mergeRuntimeConfigDefaults` on the read
+   * path. Callers must not apply their own additional fallback merge.
+   */
+  load(): Promise<RuntimeConfig>;
+  save(config: RuntimeConfig): Promise<void>;
+  reset(): Promise<void>;
+}
+//#endregion
+//#region src/core/types.d.ts
+/**
+ * 交互渲染框架档位：native（React InteractionCard）/ a2ui（@a2ui/lit Lit 渲染）/
+ * openui（@openuidev/react-lang Renderer，ui-kit Library）/ vercel（payload 预览档，
+ * 展示 Vercel AI SDK 数据契约 JSON，非完整运行时）
+ */
+type RendererKind = 'native' | 'a2ui' | 'openui' | 'vercel';
+/** OpenAI 兼容端点配置（全部缺省时使用内置演示 LLM） */
+interface LlmConfig {
+  baseUrl?: string;
+  apiKey?: string;
+  model?: string;
+}
+/** assistant 消息所属 run 的一次工具调用（终态：completed/failed） */
+interface ChatToolCall {
+  callId: string;
+  name: string;
+  status: 'completed' | 'failed';
+  /** 参数摘要（JSON 截断 100 字符；trace 重放无 args 时留空，卡片展开详情有则显示） */
+  args?: string;
+  /** 执行耗时（trace completed/failed 回填；live 由 started→终态计时） */
+  durationMs?: number;
+}
+/** 已落盘的待发送附件（composer 附件适配器产出） */
+interface ChatAttachmentInput {
+  id: string;
+  name: string;
+  contentType: string;
+  /** 相对 `attachmentsRoot` 的路径 */
+  path: string;
+  size: number;
+}
+/** 随消息持久化的附件元数据 */
+interface ChatAttachmentMeta extends ChatAttachmentInput {
+  /** 注入模型的内容形态；text 以外的类型当前不接收（runtime 只收纯文本 prompt） */
+  kind: 'text';
+}
+interface ChatMessage {
+  id: string;
+  role: 'user' | 'assistant';
+  text: string;
+  ts: string;
+  /** user 消息携带的附件（旧会话文件无该字段） */
+  attachments?: ChatAttachmentMeta[];
+  /** assistant 消息所属 run */
+  runId?: string;
+  /** 该 run 激活的技能（消息底部 badges） */
+  activeSkillNames?: string[];
+  /** 该 run 的工具调用序列（思维链工具行；按 trace 顺序） */
+  toolCalls?: ChatToolCall[];
+  /**
+   * 该 run 的结果块（bridge.renderResult 的 blocks），随消息持久化。
+   * 当前 run 的块由 ResultBlocksPro 直读 bridge 渲染；历史消息按 blocks 逐条渲染（ResultBlockList）。
+   */
+  blocks?: RenderBlock[];
+  /** The completed generative UI surfaces emitted by this run, retained for history replay. */
+  surfaces?: UiSurfaceSnapshot[];
+}
+interface ChatSessionMeta {
+  id: string;
+  createdAt: string;
+  title?: string;
+  /** 归档会话：列表分区展示，不参与默认选中 */
+  archived?: boolean;
+  /** 用户已手动重命名：后续 send 不再用首条消息覆盖标题 */
+  titleLocked?: boolean;
+}
+type ChatEvent = {
+  type: 'run-started';
+  runId: string;
+} | {
+  type: 'message-delta';
+  runId: string;
+  delta: string;
+} | {
+  type: 'message-complete';
+  message: ChatMessage;
+} | {
+  type: 'skill-activated';
+  runId: string;
+  skills: string[];
+} | {
+  type: 'tool-started';
+  runId: string;
+  callId: string;
+  name: string;
+  args?: string;
+} | {
+  type: 'tool-completed';
+  runId: string;
+  callId: string;
+  name: string;
+  args?: string;
+} | {
+  type: 'tool-failed';
+  runId: string;
+  callId: string;
+  name: string;
+  args?: string;
+} | {
+  type: 'run-completed';
+  runId: string;
+  status: 'completed' | 'failed' | 'cancelled';
+  output: string;
+  activeSkillNames: string[];
+} | {
+  type: 'interaction-requested';
+  id: string;
+  requestType: InteractionRequest['type'];
+} | {
+  type: 'interaction-resolved';
+  id: string;
+  requestType: InteractionRequest['type'];
+  cancelled?: boolean;
+} | {
+  type: 'lifecycle';
+  runId: string;
+  phase: RuntimePhase;
+  at: number;
+  data?: Record<string, unknown>;
+} | {
+  type: 'session-updated';
+  session: ChatSessionMeta;
+} | {
+  type: 'warning';
+  message: string;
+} | {
+  type: 'error';
+  message: string;
+  code?: string;
+};
+interface ChatbotConfig {
+  /** header 标题，默认 'WebSkill Chat' */
+  title?: string;
+  /** 输入框占位文本 */
+  placeholder?: string;
+  /** 会话/trace/artifact 存储根，默认 '/chat' */
+  chatRoot?: string;
+  /** 覆盖 LLM（缺省走 adapter.llmConfig → 内置演示 LLM 的选择链） */
+  llm?: LlmClient;
+  /** AgentLoop 调参（maxTurns、超时等） */
+  loopConfig?: AgentLoopConfig;
+  /**
+   * 运行环境配置存储（P2）：装配时 load() 并应用 loop/interaction/router/streaming/
+   * renderResult/sandbox/llm 映射；与 console Configure Tab 共用同一 store（宿主接线）
+   */
+  runtimeConfig?: RuntimeConfigStore;
+  /** WelcomeScreen 快捷 prompt 覆盖（缺省用内置双语示例） */
+  quickPrompts?: string[];
+  /**
+   * 开启后模型多一个 `render_ui` 工具，可面向 AI Component Catalog 直接生成声明式 UI。
+   * 默认关：工具描述 + 入参 schema 约 14 KB，会计入每一次请求。
+   */
+  generativeUi?: boolean;
+}
+//#endregion
+//#region src/core/hostAdapter.d.ts
+/**
+ * 宿主装配口：chatbot 不感知环境（浏览器/Node），全部能力经此注入。
+ * 页面动态技能来源同时是外部工具来源与外部技能提供者（同一对象两个 port）。
+ */
+interface ChatbotHostAdapter {
+  storage: FileSystemProvider;
+  skillRoots: string[];
+  llmConfig: {
+    load(): Promise<LlmConfig | undefined>;
+    save(config: LlmConfig): Promise<void>;
+    clear(): Promise<void>;
+  };
+  pageSkillSource?: ExternalToolSource & ExternalSkillProvider;
+  navigation: {
+    openConsole(): void;
+    /** 跳 console Traces 面板并定位该 run（v1.1；缺省时消息不渲染 View trace 入口） */
+    openConsoleTrace?(runId: string): void;
+  };
+  /** 缺省 BrowserWorkerScriptExecutor（@webskill/browser）；Node 宿主可注入自己的执行器 */
+  executor?: ScriptExecutor;
+}
+//#endregion
+//#region src/core/interactionBridge.d.ts
+/**
+ * 探测 A2UI Lit 渲染器是否可用（@a2ui/lit 为 optional peer，未安装时 import 失败）。
+ * Appearance/设置区据此对 A2UI 档置灰；仅动态 import，不强依赖。
+ */
+declare function probeA2uiAvailability(): Promise<boolean>;
+/**
+ * 为 A2UI 挂载容器配置 Markdown 渲染（@a2ui/markdown-it，optional peer）：
+ * 经 @lit/context 向 surface 子树注入 renderMarkdown（markdown-it + dompurify），
+ * 消除 "[MarkdownDirective] can't render markdown" 降级。
+ * 未安装时返回 false（宿主可据此保留产品化限制说明）。
+ */
+declare function configureA2uiMarkdown(mount: HTMLElement): Promise<boolean>;
+/**
+ * 探测 OpenUI 渲染器是否可用（@openuidev/react-lang 为 optional peer）。
+ * Appearance/设置区据此对 OpenUI 档置灰；仅动态 import，不强依赖。
+ */
+declare function probeOpenUiAvailability(): Promise<boolean>;
+/** openui 档一次待决交互（lang 文本由 react 层交给 @openuidev/react-lang Renderer 渲染） */
+interface OpenUiSession {
+  request: InteractionRequest;
+  lang: string;
+}
+/**
+ * OpenUI 交互通道（core 层，不 import react）：
+ * - request() 把 InteractionRequest 转成 openui-lang 文本并挂起，react 层
+ *   （OpenUiInteraction）订阅 current 后动态加载 @openuidev/react-lang 渲染；
+ * - 动作事件经 handleAction → fromOpenUiAction（含 authorize Allow/Deny 语义）回传；
+ * - react 层初始化失败调 fail()：挂起请求 reject（桥据此粘性降级 native）并记录原因；
+ * - attach/detach 标记渲染视图是否挂载（未挂载时桥直接降级 native，不悬挂请求）。
+ */
+declare class OpenUiChannel {
+  #private;
+  /** React useSyncExternalStore 兼容订阅 */
+  subscribe: (listener: () => void) => (() => void);
+  get current(): OpenUiSession | undefined;
+  get isAttached(): boolean;
+  /** react 层初始化失败原因（未安装 @openuidev/react-lang 等）；记录后粘性生效 */
+  get failure(): string | undefined;
+  attach(): void;
+  detach(): void;
+  request(input: InteractionRequest): Promise<InteractionResponse>;
+  /** runtime 交互超时/取消：以 cancelled resolve 挂起的 request（防悬挂 + 残留） */
+  cancel(id: string): void;
+  /** react 层 OpenUI 动作回传（fromOpenUiAction：Allow → value:true；Deny/Cancel → cancelled:true） */
+  handleAction(action: unknown): void;
+  /** react 层初始化失败：挂起请求 reject 并记录原因（桥读取后降级 native） */
+  fail(message: string): void;
+}
+interface CompositeUiBridgeDeps {
+  /** native 档交互 + streamingText/renderResult 数据源（始终生效；vercel 预览档也走它） */
+  reactBridge: ReactBridgeState;
+  getRenderer(): RendererKind;
+  /** a2ui 档交互容器（Chatbot ref 回调注入；未挂载时 a2ui 请求降级 native） */
+  getInteractionMount(): HTMLElement | undefined;
+  /** openui 档交互通道（引擎持有；react 层 OpenUiInteraction attach 后生效） */
+  getOpenUiChannel(): OpenUiChannel;
+  emit(event: ChatEvent): void;
+}
+/**
+ * 复合 UiBridge（P2/P3 渲染框架档）：
+ * - streamingText / renderResult 始终委托 ReactBridgeState（结果块数据源不变）；
+ * - 交互 request/cancel 按渲染档分发：native → ReactBridgeState（InteractionCard），
+ *   a2ui → LitRendererBridge（@a2ui/lit，容器由 Chatbot 提供），
+ *   openui → OpenUiChannel（@openuidev/react-lang Renderer 由 react 层装配），
+ *   vercel → ReactBridgeState（payload 预览卡消费 bridge.pending，仅可取消）；
+ * - 每次交互开始/结束发 interaction-requested/resolved 事件（UI 据此显隐 a2ui 容器）；
+ * - a2ui/openui 初始化失败（optional peer 未安装等）降级 native + warning 事件，不阻断 run。
+ */
+declare class CompositeUiBridge implements UiBridge {
+  #private;
+  constructor(deps: CompositeUiBridgeDeps);
+  /** 渲染档热切换：丢弃已建的 a2ui 桥与降级状态（新档立即生效，无需重装配 runtime） */
+  reset(): void;
+  request(input: InteractionRequest): Promise<InteractionResponse>;
+  /** runtime 交互超时/取消：按档委托（a2ui/openui 桥 cancel 会以 cancelled resolve 挂起的 request） */
+  cancel(id: string): void;
+  renderResult(input: RenderResultRequest): Promise<void>;
+  renderSurface(event: UiSurfaceEvent): Promise<void>;
+  requestSurfaceAction(input: UiSurfaceActionRequest): Promise<UiSurfaceActionResponse>;
+  cancelSurfaceAction(nonce: string): void;
+  onTextDelta(runId: string, delta: string): Promise<void>;
+}
+//#endregion
+//#region src/core/chatEngine.d.ts
+/** 默认沙箱执行器的构造参数（adapter.executor 未注入时；executorFactory 替换点可见同一形状） */
+interface SandboxExecutorDeps {
+  fs: FileSystemProvider;
+  sandbox?: SandboxMode;
+  networkPolicy?: NetworkPolicy;
+  capabilities?: BridgeCapabilities;
+  approvalScope?: ApprovalScope;
+  uiBridge?: UiBridge;
+}
+interface ChatEngineOptions {
+  llm?: LlmClient;
+  loopConfig?: AgentLoopConfig;
+  chatRoot?: string;
+  /** 运行环境配置存储（P2）：#ensureReady 装配时 load()（默认值兜底）并按映射应用 */
+  runtimeConfig?: RuntimeConfigStore;
+  /** 初始渲染框架档（默认 'native'；运行中可 setRenderer 热切换） */
+  renderer?: RendererKind;
+  /** 注入 `render_ui` 工具，让模型面向 AI Component Catalog 生成声明式 UI */
+  generativeUi?: boolean;
+  /** 沙箱执行器替换点（测试注入 spy 断言构造参数；缺省 BrowserWorkerScriptExecutor） */
+  executorFactory?: (deps: SandboxExecutorDeps) => ScriptExecutor;
+}
+/**
+ * 对话框引擎：装配 WebSkillRuntime + 会话持久化 + 事件分发。
+ * llmConfig.load() 是异步的，runtime 在首次 send 前懒装配（#ensureReady）。
+ */
+declare class ChatEngine {
+  #private;
+  readonly bridge: ReactBridgeState;
+  constructor(adapter: ChatbotHostAdapter, options?: ChatEngineOptions);
+  /** 当前渲染框架档 */
+  get renderer(): RendererKind;
+  /** 渲染框架热切换：复合桥按档分发，无需重装配 runtime（会话句柄保留） */
+  setRenderer(renderer: RendererKind): void;
+  /** a2ui 档交互容器注入（Chatbot ref 回调；卸载传 null） */
+  setInteractionMount(el: HTMLElement | null): void;
+  /** openui 档交互通道（Chatbot 的 OpenUiInteraction 订阅/attach；core 只产出 lang 文本） */
+  get openUiChannel(): OpenUiChannel;
+  /** 探测 @a2ui/lit 是否安装（Appearance/设置区 A2UI 档置灰判定） */
+  probeA2uiAvailability(): Promise<boolean>;
+  onEvent(listener: (event: ChatEvent) => void): () => void;
+  /**
+   * 配置源变更后调用（LLM 设置 / RuntimeConfigStore 内容变化）：丢弃缓存的
+   * runtime/llm/会话句柄，下次 send 重新装配（RuntimeConfig 重新 load() 应用）
+   */
+  reloadConfig(): void;
+  /** 旧名保留（与 reloadConfig 同语义，向后兼容） */
+  reloadLlm(): void;
+  listSessions(): Promise<ChatSessionMeta[]>;
+  createSession(): Promise<ChatSessionMeta>;
+  selectSession(id: string): Promise<ChatMessage[]>;
+  deleteSession(id: string): Promise<void>;
+  /** 重命名会话：写入 title 并锁定（后续 send 不再用首条消息覆盖） */
+  renameSession(id: string, title: string): Promise<void>;
+  /** 归档会话（仅标记，消息与 trace 不动） */
+  archiveSession(id: string): Promise<void>;
+  /** 取消归档 */
+  unarchiveSession(id: string): Promise<void>;
+  /** 重发语义：取该 user 消息文本重新 send（assistant 应答新起一轮；不重写历史） */
+  retry(messageId: string): Promise<void>;
+  /**
+   * 编辑重发：截断该 user 消息（含自身）之后的持久化历史，再用新文本重跑一轮。
+   * runtime session 句柄自带的对话历史不受影响（与 retry 同口径）。
+   */
+  editAndResend(messageId: string, text: string): Promise<void>;
+  /** 从当前会话消息列表删除指定消息并持久化（消息不存在/无当前会话时静默跳过） */
+  deleteMessage(messageId: string): Promise<void>;
+  /**
+   * 驱动当前 session 的一轮 run。同 session 并发由 runtime session handle 内部
+   * 队列串行化（此处直接 await）；UI 层应在 send 期间禁用输入。
+   * 附件正文按 `attachmentsRoot` 内的路径读回并拼进 prompt（runtime 只收纯文本）。
+   */
+  send(text: string, attachments?: readonly ChatAttachmentInput[]): Promise<void>;
+  /** 附件落盘根目录（composer 附件适配器写入，send 时读回） */
+  get attachmentsRoot(): string;
+  /** 取消进行中的 run（Composer Stop 按钮）；run 未找到/已结束返回 false */
+  cancel(runId: string): boolean;
+  /** 列出可恢复的 interrupted run（InterruptedBanner 数据源） */
+  listInterrupted(): Promise<RunSnapshot$1[]>;
+  /**
+   * 恢复 interrupted run：等待中的交互重新进入 bridge.pending（UI 复用 InteractionForm），
+   * 完成后与 send 同路径（assistant 消息持久化 + run-completed + trace 落盘）。
+   */
+  resume(runId: string): Promise<void>;
+}
+//#endregion
+//#region src/core/traceSink.d.ts
+/**
+ * run trace 落盘格式：与 console 包的共享约定（两包零依赖，console 的
+ * createFsTraceSource(fs, chatRoot) 读同一位置），字段名不得擅自变更。
+ */
+interface RunTraceFile {
+  runId: string;
+  sessionId: string;
+  startedAt: string;
+  endedAt?: string;
+  status: 'completed' | 'failed' | 'cancelled';
+  activeSkills: string[];
+  events: TraceEvent[];
+}
+/** 写 `<chatRoot>/traces/<runId>.json`；写失败降级 console.warn，不阻断对话 */
+declare function writeRunTrace(fs: FileSystemProvider, chatRoot: string, run: RuntimeRun): Promise<void>;
+//#endregion
+//#region src/i18n.d.ts
+/**
+ * chatbot 双语字典：全部 UI 文案的单一来源（英文为主，zh 条目齐全）。
+ * 特性区块（WelcomeScreen / SettingsDrawer 各节 / authorize 说明等）必须含
+ * title + description 双语条目——"会说话的 UI"的文案底座。
+ */
+declare const chatbotDictionary: {
+  en: {
+    'app.title': string;
+    'header.sessions': string;
+    'header.settings': string;
+    'header.console': string;
+    'session.title': string;
+    'session.new': string;
+    'session.searchPlaceholder': string;
+    'session.empty': string;
+    'session.delete': string;
+    'welcome.title': string;
+    'welcome.assistantTitle': string;
+    'welcome.description': string;
+    'welcome.capability.skills.title': string;
+    'welcome.capability.skills.description': string;
+    'welcome.capability.generativeUi.title': string;
+    'welcome.capability.generativeUi.description': string;
+    'welcome.capability.transparency.title': string;
+    'welcome.capability.transparency.description': string;
+    'welcome.quickPrompts': string;
+    'welcome.prompt.1': string;
+    'welcome.prompt.2': string;
+    'welcome.prompt.3': string;
+    'welcome.prompt.4': string;
+    'message.copy': string;
+    'message.copied': string;
+    'message.retry': string;
+    'message.delete': string;
+    'message.viewTrace': string;
+    'message.skillsUsed': string;
+    'tool.summary.one': string;
+    'tool.summary.other': string;
+    'tool.status.running': string;
+    'tool.status.completed': string;
+    'tool.status.failed': string;
+    'tool.duration': string;
+    'tool.args': string;
+    'cot.thinking': string;
+    'cot.thought': string;
+    'cot.summary': string;
+    'cot.reasoning': string;
+    'cot.working': string;
+    'trace.title': string;
+    'trace.skill': string;
+    'trace.phase.route': string;
+    'trace.phase.activate': string;
+    'trace.phase.execute': string;
+    'trace.phase.interact': string;
+    'trace.phase.complete': string;
+    'trace.phase.fail': string;
+    'interaction.ask.title': string;
+    'interaction.confirm.title': string;
+    'interaction.form.title': string;
+    'interaction.select.title': string;
+    'interaction.authorize.title': string;
+    'interaction.authorize.description': string;
+    'interaction.authorize.capability': string;
+    'interaction.authorize.details': string;
+    'interaction.submit': string;
+    'interaction.cancel': string;
+    'interaction.confirm': string;
+    'interaction.allow': string;
+    'interaction.deny': string;
+    'interaction.required': string;
+    'result.artifacts': string;
+    'result.download': string;
+    'result.file': string;
+    'status.aria': string;
+    'status.route': string;
+    'status.activate': string;
+    'status.execute': string;
+    'status.interact': string;
+    'status.complete': string;
+    'status.failed': string;
+    'status.cancelled': string;
+    'banner.interrupted': string;
+    'banner.description': string;
+    'banner.resume': string;
+    'composer.placeholder': string;
+    'composer.inputLabel': string;
+    'composer.send': string;
+    'composer.stop': string;
+    'composer.attachments': string;
+    'composer.addAttachment': string;
+    'composer.removeAttachment': string;
+    'settings.title': string;
+    'settings.model.title': string;
+    'settings.model.description': string;
+    'settings.provider': string;
+    'settings.providerNote': string;
+    'settings.provider.openai-compatible': string;
+    'settings.provider.anthropic': string;
+    'settings.provider.google': string;
+    'settings.provider.anthropic.note': string;
+    'settings.provider.google.note': string;
+    'settings.endpoint': string;
+    'settings.apiKey': string;
+    'settings.modelName': string;
+    'settings.streaming': string;
+    'settings.streamingNote': string;
+    'settings.temperature': string;
+    'settings.temperatureNote': string;
+    'settings.test': string;
+    'settings.testing': string;
+    'settings.available': string;
+    'settings.unavailable': string;
+    'settings.streamingSupported': string;
+    'settings.nonStreamingFallback': string;
+    'settings.demoBadge': string;
+    'settings.demoNote': string;
+    'settings.save': string;
+    'settings.clear': string;
+    'settings.appearance.title': string;
+    'settings.appearance.description': string;
+    'settings.theme': string;
+    'settings.theme.light': string;
+    'settings.theme.dark': string;
+    'settings.language': string;
+    'settings.language.en': string;
+    'settings.language.zh': string;
+    'settings.renderer': string;
+    'settings.renderer.description': string;
+    'settings.renderer.native': string;
+    'settings.renderer.a2ui': string;
+    'settings.renderer.openui': string;
+    'settings.renderer.vercel': string;
+    'vercel.preview.title': string;
+    'vercel.preview.badge': string;
+    'vercel.preview.description': string;
+    'error.title': string;
+    'error.suggestion': string;
+    'error.dismiss': string;
+  };
+  zh: {
+    'app.title': string;
+    'header.sessions': string;
+    'header.settings': string;
+    'header.console': string;
+    'session.title': string;
+    'session.new': string;
+    'session.searchPlaceholder': string;
+    'session.empty': string;
+    'session.delete': string;
+    'welcome.title': string;
+    'welcome.assistantTitle': string;
+    'welcome.description': string;
+    'welcome.capability.skills.title': string;
+    'welcome.capability.skills.description': string;
+    'welcome.capability.generativeUi.title': string;
+    'welcome.capability.generativeUi.description': string;
+    'welcome.capability.transparency.title': string;
+    'welcome.capability.transparency.description': string;
+    'welcome.quickPrompts': string;
+    'welcome.prompt.1': string;
+    'welcome.prompt.2': string;
+    'welcome.prompt.3': string;
+    'welcome.prompt.4': string;
+    'message.copy': string;
+    'message.copied': string;
+    'message.retry': string;
+    'message.delete': string;
+    'message.viewTrace': string;
+    'message.skillsUsed': string;
+    'tool.summary.one': string;
+    'tool.summary.other': string;
+    'tool.status.running': string;
+    'tool.status.completed': string;
+    'tool.status.failed': string;
+    'tool.duration': string;
+    'tool.args': string;
+    'cot.thinking': string;
+    'cot.thought': string;
+    'cot.summary': string;
+    'cot.reasoning': string;
+    'cot.working': string;
+    'trace.title': string;
+    'trace.skill': string;
+    'trace.phase.route': string;
+    'trace.phase.activate': string;
+    'trace.phase.execute': string;
+    'trace.phase.interact': string;
+    'trace.phase.complete': string;
+    'trace.phase.fail': string;
+    'interaction.ask.title': string;
+    'interaction.confirm.title': string;
+    'interaction.form.title': string;
+    'interaction.select.title': string;
+    'interaction.authorize.title': string;
+    'interaction.authorize.description': string;
+    'interaction.authorize.capability': string;
+    'interaction.authorize.details': string;
+    'interaction.submit': string;
+    'interaction.cancel': string;
+    'interaction.confirm': string;
+    'interaction.allow': string;
+    'interaction.deny': string;
+    'interaction.required': string;
+    'result.artifacts': string;
+    'result.download': string;
+    'result.file': string;
+    'status.aria': string;
+    'status.route': string;
+    'status.activate': string;
+    'status.execute': string;
+    'status.interact': string;
+    'status.complete': string;
+    'status.failed': string;
+    'status.cancelled': string;
+    'banner.interrupted': string;
+    'banner.description': string;
+    'banner.resume': string;
+    'composer.placeholder': string;
+    'composer.inputLabel': string;
+    'composer.send': string;
+    'composer.stop': string;
+    'composer.attachments': string;
+    'composer.addAttachment': string;
+    'composer.removeAttachment': string;
+    'settings.title': string;
+    'settings.model.title': string;
+    'settings.model.description': string;
+    'settings.provider': string;
+    'settings.providerNote': string;
+    'settings.provider.openai-compatible': string;
+    'settings.provider.anthropic': string;
+    'settings.provider.google': string;
+    'settings.provider.anthropic.note': string;
+    'settings.provider.google.note': string;
+    'settings.endpoint': string;
+    'settings.apiKey': string;
+    'settings.modelName': string;
+    'settings.streaming': string;
+    'settings.streamingNote': string;
+    'settings.temperature': string;
+    'settings.temperatureNote': string;
+    'settings.test': string;
+    'settings.testing': string;
+    'settings.available': string;
+    'settings.unavailable': string;
+    'settings.streamingSupported': string;
+    'settings.nonStreamingFallback': string;
+    'settings.demoBadge': string;
+    'settings.demoNote': string;
+    'settings.save': string;
+    'settings.clear': string;
+    'settings.appearance.title': string;
+    'settings.appearance.description': string;
+    'settings.theme': string;
+    'settings.theme.light': string;
+    'settings.theme.dark': string;
+    'settings.language': string;
+    'settings.language.en': string;
+    'settings.language.zh': string;
+    'settings.renderer': string;
+    'settings.renderer.description': string;
+    'settings.renderer.native': string;
+    'settings.renderer.a2ui': string;
+    'settings.renderer.openui': string;
+    'settings.renderer.vercel': string;
+    'vercel.preview.title': string;
+    'vercel.preview.badge': string;
+    'vercel.preview.description': string;
+    'error.title': string;
+    'error.suggestion': string;
+    'error.dismiss': string;
+  };
+};
+/** chatbot 组件取文案：t('welcome.title') / t('tool.summary.other', { count: 3 }) */
+declare const useT: () => TranslateFn<{
+  en: {
+    'app.title': string;
+    'header.sessions': string;
+    'header.settings': string;
+    'header.console': string;
+    'session.title': string;
+    'session.new': string;
+    'session.searchPlaceholder': string;
+    'session.empty': string;
+    'session.delete': string;
+    'welcome.title': string;
+    'welcome.assistantTitle': string;
+    'welcome.description': string;
+    'welcome.capability.skills.title': string;
+    'welcome.capability.skills.description': string;
+    'welcome.capability.generativeUi.title': string;
+    'welcome.capability.generativeUi.description': string;
+    'welcome.capability.transparency.title': string;
+    'welcome.capability.transparency.description': string;
+    'welcome.quickPrompts': string;
+    'welcome.prompt.1': string;
+    'welcome.prompt.2': string;
+    'welcome.prompt.3': string;
+    'welcome.prompt.4': string;
+    'message.copy': string;
+    'message.copied': string;
+    'message.retry': string;
+    'message.delete': string;
+    'message.viewTrace': string;
+    'message.skillsUsed': string;
+    'tool.summary.one': string;
+    'tool.summary.other': string;
+    'tool.status.running': string;
+    'tool.status.completed': string;
+    'tool.status.failed': string;
+    'tool.duration': string;
+    'tool.args': string;
+    'cot.thinking': string;
+    'cot.thought': string;
+    'cot.summary': string;
+    'cot.reasoning': string;
+    'cot.working': string;
+    'trace.title': string;
+    'trace.skill': string;
+    'trace.phase.route': string;
+    'trace.phase.activate': string;
+    'trace.phase.execute': string;
+    'trace.phase.interact': string;
+    'trace.phase.complete': string;
+    'trace.phase.fail': string;
+    'interaction.ask.title': string;
+    'interaction.confirm.title': string;
+    'interaction.form.title': string;
+    'interaction.select.title': string;
+    'interaction.authorize.title': string;
+    'interaction.authorize.description': string;
+    'interaction.authorize.capability': string;
+    'interaction.authorize.details': string;
+    'interaction.submit': string;
+    'interaction.cancel': string;
+    'interaction.confirm': string;
+    'interaction.allow': string;
+    'interaction.deny': string;
+    'interaction.required': string;
+    'result.artifacts': string;
+    'result.download': string;
+    'result.file': string;
+    'status.aria': string;
+    'status.route': string;
+    'status.activate': string;
+    'status.execute': string;
+    'status.interact': string;
+    'status.complete': string;
+    'status.failed': string;
+    'status.cancelled': string;
+    'banner.interrupted': string;
+    'banner.description': string;
+    'banner.resume': string;
+    'composer.placeholder': string;
+    'composer.inputLabel': string;
+    'composer.send': string;
+    'composer.stop': string;
+    'composer.attachments': string;
+    'composer.addAttachment': string;
+    'composer.removeAttachment': string;
+    'settings.title': string;
+    'settings.model.title': string;
+    'settings.model.description': string;
+    'settings.provider': string;
+    'settings.providerNote': string;
+    'settings.provider.openai-compatible': string;
+    'settings.provider.anthropic': string;
+    'settings.provider.google': string;
+    'settings.provider.anthropic.note': string;
+    'settings.provider.google.note': string;
+    'settings.endpoint': string;
+    'settings.apiKey': string;
+    'settings.modelName': string;
+    'settings.streaming': string;
+    'settings.streamingNote': string;
+    'settings.temperature': string;
+    'settings.temperatureNote': string;
+    'settings.test': string;
+    'settings.testing': string;
+    'settings.available': string;
+    'settings.unavailable': string;
+    'settings.streamingSupported': string;
+    'settings.nonStreamingFallback': string;
+    'settings.demoBadge': string;
+    'settings.demoNote': string;
+    'settings.save': string;
+    'settings.clear': string;
+    'settings.appearance.title': string;
+    'settings.appearance.description': string;
+    'settings.theme': string;
+    'settings.theme.light': string;
+    'settings.theme.dark': string;
+    'settings.language': string;
+    'settings.language.en': string;
+    'settings.language.zh': string;
+    'settings.renderer': string;
+    'settings.renderer.description': string;
+    'settings.renderer.native': string;
+    'settings.renderer.a2ui': string;
+    'settings.renderer.openui': string;
+    'settings.renderer.vercel': string;
+    'vercel.preview.title': string;
+    'vercel.preview.badge': string;
+    'vercel.preview.description': string;
+    'error.title': string;
+    'error.suggestion': string;
+    'error.dismiss': string;
+  };
+  zh: {
+    'app.title': string;
+    'header.sessions': string;
+    'header.settings': string;
+    'header.console': string;
+    'session.title': string;
+    'session.new': string;
+    'session.searchPlaceholder': string;
+    'session.empty': string;
+    'session.delete': string;
+    'welcome.title': string;
+    'welcome.assistantTitle': string;
+    'welcome.description': string;
+    'welcome.capability.skills.title': string;
+    'welcome.capability.skills.description': string;
+    'welcome.capability.generativeUi.title': string;
+    'welcome.capability.generativeUi.description': string;
+    'welcome.capability.transparency.title': string;
+    'welcome.capability.transparency.description': string;
+    'welcome.quickPrompts': string;
+    'welcome.prompt.1': string;
+    'welcome.prompt.2': string;
+    'welcome.prompt.3': string;
+    'welcome.prompt.4': string;
+    'message.copy': string;
+    'message.copied': string;
+    'message.retry': string;
+    'message.delete': string;
+    'message.viewTrace': string;
+    'message.skillsUsed': string;
+    'tool.summary.one': string;
+    'tool.summary.other': string;
+    'tool.status.running': string;
+    'tool.status.completed': string;
+    'tool.status.failed': string;
+    'tool.duration': string;
+    'tool.args': string;
+    'cot.thinking': string;
+    'cot.thought': string;
+    'cot.summary': string;
+    'cot.reasoning': string;
+    'cot.working': string;
+    'trace.title': string;
+    'trace.skill': string;
+    'trace.phase.route': string;
+    'trace.phase.activate': string;
+    'trace.phase.execute': string;
+    'trace.phase.interact': string;
+    'trace.phase.complete': string;
+    'trace.phase.fail': string;
+    'interaction.ask.title': string;
+    'interaction.confirm.title': string;
+    'interaction.form.title': string;
+    'interaction.select.title': string;
+    'interaction.authorize.title': string;
+    'interaction.authorize.description': string;
+    'interaction.authorize.capability': string;
+    'interaction.authorize.details': string;
+    'interaction.submit': string;
+    'interaction.cancel': string;
+    'interaction.confirm': string;
+    'interaction.allow': string;
+    'interaction.deny': string;
+    'interaction.required': string;
+    'result.artifacts': string;
+    'result.download': string;
+    'result.file': string;
+    'status.aria': string;
+    'status.route': string;
+    'status.activate': string;
+    'status.execute': string;
+    'status.interact': string;
+    'status.complete': string;
+    'status.failed': string;
+    'status.cancelled': string;
+    'banner.interrupted': string;
+    'banner.description': string;
+    'banner.resume': string;
+    'composer.placeholder': string;
+    'composer.inputLabel': string;
+    'composer.send': string;
+    'composer.stop': string;
+    'composer.attachments': string;
+    'composer.addAttachment': string;
+    'composer.removeAttachment': string;
+    'settings.title': string;
+    'settings.model.title': string;
+    'settings.model.description': string;
+    'settings.provider': string;
+    'settings.providerNote': string;
+    'settings.provider.openai-compatible': string;
+    'settings.provider.anthropic': string;
+    'settings.provider.google': string;
+    'settings.provider.anthropic.note': string;
+    'settings.provider.google.note': string;
+    'settings.endpoint': string;
+    'settings.apiKey': string;
+    'settings.modelName': string;
+    'settings.streaming': string;
+    'settings.streamingNote': string;
+    'settings.temperature': string;
+    'settings.temperatureNote': string;
+    'settings.test': string;
+    'settings.testing': string;
+    'settings.available': string;
+    'settings.unavailable': string;
+    'settings.streamingSupported': string;
+    'settings.nonStreamingFallback': string;
+    'settings.demoBadge': string;
+    'settings.demoNote': string;
+    'settings.save': string;
+    'settings.clear': string;
+    'settings.appearance.title': string;
+    'settings.appearance.description': string;
+    'settings.theme': string;
+    'settings.theme.light': string;
+    'settings.theme.dark': string;
+    'settings.language': string;
+    'settings.language.en': string;
+    'settings.language.zh': string;
+    'settings.renderer': string;
+    'settings.renderer.description': string;
+    'settings.renderer.native': string;
+    'settings.renderer.a2ui': string;
+    'settings.renderer.openui': string;
+    'settings.renderer.vercel': string;
+    'vercel.preview.title': string;
+    'vercel.preview.badge': string;
+    'vercel.preview.description': string;
+    'error.title': string;
+    'error.suggestion': string;
+    'error.dismiss': string;
+  };
+}>;
+//#endregion
+//#region src/react/appearance.d.ts
+/** chatbot 主题（根 div 挂 .dark 类生效） */
+type ChatTheme = 'light' | 'dark';
+/** SettingsDrawer 内切换外观时回调宿主持久化 */
+interface AppearanceChange {
+  theme?: ChatTheme;
+  locale?: Locale;
+  /** 渲染框架档（native/a2ui）；宿主持久化后经 Chatbot renderer prop 回注 */
+  renderer?: RendererKind;
+}
+//#endregion
+//#region src/react/useChatLayout.d.ts
+/** 宿主可指定的布局档；auto 按容器尺寸判定 */
+type ChatLayout = 'auto' | 'fullscreen' | 'embedded';
+type ResolvedChatLayout = 'fullscreen' | 'embedded' | 'mobile';
+//#endregion
+//#region src/react/Chatbot.d.ts
+interface ChatbotProps {
+  adapter: ChatbotHostAdapter;
+  config?: ChatbotConfig;
+  /** 界面语言（默认 'en'；SettingsDrawer 内切换后经 onAppearanceChange 通知宿主） */
+  locale?: Locale;
+  /** 主题（默认 'light'；'dark' 时根 div 挂 .dark 类） */
+  theme?: ChatTheme;
+  /** 交互渲染框架档（默认 'native'；'a2ui' 需宿主安装 optional peer @a2ui/lit） */
+  renderer?: RendererKind;
+  /** Native custom surface 的显式 renderer/schema allowlist。 */
+  surfaceRegistry?: SurfaceRegistry;
+  /** 布局档（默认 'auto'：按容器尺寸在 fullscreen / embedded / mobile 之间判定） */
+  layout?: ChatLayout;
+  onAppearanceChange?(next: AppearanceChange): void;
+}
+/**
+ * ChatEngine owns message/session/runtime state while assistant-ui Base owns the
+ * presentation shell and accessible thread primitives.
+ */
+declare function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, renderer: rendererProp, surfaceRegistry, layout, onAppearanceChange }: ChatbotProps): import("react").JSX.Element;
+//#endregion
+//#region src/react/A2uiSurfaceHost.d.ts
+interface A2uiSurfaceHostProps {
+  bridge: ReactBridgeState;
+  runId?: string;
+  registry?: SurfaceRegistry;
+}
+interface A2uiSurfaceSnapshotHostProps {
+  snapshots: readonly UiSurfaceSnapshot[];
+  registry?: SurfaceRegistry;
+  onAction?(event: UiSurfaceActionEvent): void;
+  drafts?: UiSurfaceDrafts;
+  onDraftChange?(event: {
+    runId: string;
+    surfaceId: string;
+    value: Record<string, unknown>;
+  }): void;
+}
+/** Renders persisted A2UI Basic Catalog surfaces and controlled WebSkill extensions without a live bridge. @experimental */
+declare function A2uiSurfaceSnapshotHost({ snapshots, registry, onAction, drafts, onDraftChange }: A2uiSurfaceSnapshotHostProps): import("react").JSX.Element | null;
+/** Renders A2UI Basic Catalog surfaces and controlled WebSkill extensions from live bridge snapshots. @experimental */
+declare function A2uiSurfaceHost({ bridge, runId, registry }: A2uiSurfaceHostProps): import("react").JSX.Element;
+//#endregion
+//#region src/react/SkillBadges.d.ts
+/** 消息底部展示该 run 激活的技能名徽章（无技能不渲染） */
+declare function SkillBadges({ skills }: {
+  skills: string[];
+}): import("react").JSX.Element | null;
+//#endregion
+//#region src/react/InteractionCard.d.ts
+interface InteractionCardProps {
+  bridge: ReactBridgeState;
+}
+/** 订阅 bridge.pending 渲染五类交互卡（ask/confirm/form/select/authorize，native） */
+declare function InteractionCard({ bridge }: InteractionCardProps): import("react").JSX.Element | null;
+//#endregion
+//#region src/react/OpenUiInteraction.d.ts
+interface OpenUiInteractionProps {
+  channel: OpenUiChannel;
+}
+/**
+ * openui 档交互视图：订阅 OpenUiChannel（core 产出 openui-lang 文本），动态加载
+ * optional peer @openuidev/react-lang 的 Renderer 渲染；动作事件回传 channel.handleAction。
+ * 模块加载失败 → channel.fail（桥粘性降级 native，InteractionCard 接管）。
+ */
+declare function OpenUiInteraction({ channel }: OpenUiInteractionProps): import("react").JSX.Element | null;
+//#endregion
+//#region src/react/OpenUiSurfaceHost.d.ts
+interface OpenUiSurfaceHostProps {
+  bridge: ReactBridgeState;
+  runId?: string;
+  registry?: SurfaceRegistry;
+}
+interface OpenUiSurfaceSnapshotHostProps {
+  snapshots: readonly UiSurfaceSnapshot[];
+  registry?: SurfaceRegistry;
+  onAction?(event: UiSurfaceActionEvent): void;
+  drafts?: UiSurfaceDrafts;
+  onDraftChange?(event: {
+    runId: string;
+    surfaceId: string;
+    value: Record<string, unknown>;
+  }): void;
+}
+/** Renders persisted UiSurface snapshots through the OpenUI extension without a live bridge. @experimental */
+declare function OpenUiSurfaceSnapshotHost({ snapshots, registry, onAction, drafts, onDraftChange }: OpenUiSurfaceSnapshotHostProps): import("react").JSX.Element | null;
+/** Renders serializable UiSurface descriptors through an OpenUI library extension. @experimental */
+declare function OpenUiSurfaceHost({ bridge, runId, registry }: OpenUiSurfaceHostProps): import("react").JSX.Element;
+//#endregion
+//#region src/react/VercelPayloadPreview.d.ts
+interface VercelPayloadPreviewProps {
+  bridge: ReactBridgeState;
+}
+/**
+ * vercel 档（payload 预览）：不渲染表单，展示 InteractionRequest 经 toVercelToolInvocation
+ * 转换后的 Vercel AI SDK 数据契约 JSON 卡。仅提供 Cancel 结束交互（非完整运行时）。
+ */
+declare function VercelPayloadPreview({ bridge }: VercelPayloadPreviewProps): import("react").JSX.Element | null;
+//#endregion
+//#region src/react/VercelSurfaceHost.d.ts
+interface VercelSurfaceHostProps {
+  bridge: ReactBridgeState;
+  runId?: string;
+  registry?: SurfaceRegistry;
+}
+interface VercelSurfaceSnapshotHostProps {
+  snapshots: readonly UiSurfaceSnapshot[];
+  registry?: SurfaceRegistry;
+  onAction?(event: UiSurfaceActionEvent): void;
+  drafts?: UiSurfaceDrafts;
+  onDraftChange?(event: {
+    runId: string;
+    surfaceId: string;
+    value: Record<string, unknown>;
+  }): void;
+}
+/** Renders persisted Vercel-compatible data parts without subscribing to a live bridge. @experimental */
+declare function VercelSurfaceSnapshotHost({ snapshots, registry, onAction, drafts, onDraftChange }: VercelSurfaceSnapshotHostProps): import("react").JSX.Element | null;
+/** Consumes Vercel-compatible surface data parts with a controlled React surface renderer. @experimental */
+declare function VercelSurfaceHost({ bridge, runId, registry }: VercelSurfaceHostProps): import("react").JSX.Element | null;
+//#endregion
+//#region src/react/ResultBlocksPro.d.ts
+/** 可下载文件描述（file 块与 artifact 统一成该形状） */
+interface DownloadableFile {
+  path: string;
+  /** 所属 run（artifact 存储路径 <chatRoot>/artifacts/<runId>/<path> 解析用） */
+  runId?: string;
+  mimeType?: string;
+  size?: number;
+}
+interface ResultBlocksProProps {
+  bridge: ReactBridgeState;
+  /** 只在所属 run 仍活动时展示；完成结果块由 ChatMessage 历史承接。 */
+  activeRunId?: string;
+  /** 注入后 file 块 / artifact 渲染下载按钮（宿主负责读存储并触发浏览器下载） */
+  onDownload?(file: DownloadableFile): void;
+}
+/** 按 blocks 直接渲染的形态（历史消息结果块；当前 run 走 ResultBlocksPro 的 bridge 路径） */
+interface ResultBlockListProps {
+  blocks: RenderBlock[];
+  /** 所属 run（file 块下载路径解析用） */
+  runId: string;
+  onDownload?(file: DownloadableFile): void;
+}
+/**
+ * 结果块列表（AnimatePresence 逐块入场）：markdown / json / table / chart / image / file。
+ * 历史消息（ChatMessage.blocks）与当前 run（ResultBlocksPro）共用的渲染形态。
+ */
+declare function ResultBlockList({ blocks, runId, onDownload }: ResultBlockListProps): import("react").JSX.Element;
+/**
+ * run 完成结果块渐进挂载（AnimatePresence 逐块入场）：
+ * markdown / json / table / chart / image / file + artifact 下载卡。
+ */
+declare function ResultBlocksPro({ bridge, activeRunId, onDownload }: ResultBlocksProProps): import("react").JSX.Element | null;
+//#endregion
+//#region src/react/InterruptedBanner.d.ts
+interface InterruptedBannerProps {
+  engine: ChatEngine;
+  /** 会话切换时重新检查（值变化即触发重新 listInterrupted） */
+  sessionId?: string;
+}
+/**
+ * 未完成对话提示条：挂载/会话切换时检查 interrupted 快照，非空则顶部 banner
+ * + Resume（engine.resume 后等待中的表单重新进入 bridge.pending）。
+ */
+declare function InterruptedBanner({ engine, sessionId }: InterruptedBannerProps): import("react").JSX.Element | null;
+//#endregion
+//#region src/react/SettingsDrawer.d.ts
+interface SettingsDrawerProps {
+  open: boolean;
+  llmConfig: ChatbotHostAdapter['llmConfig'];
+  /**
+   * 运行环境配置存储（P4-A）：注入后表单读写 store 的 llm 段 + streaming + loop.temperature，
+   * 保存后引擎 reloadConfig 装配生效；缺省回退 adapter.llmConfig 旧路径（仅 OpenAI 兼容）
+   */
+  runtimeConfig?: RuntimeConfigStore;
+  theme: ChatTheme;
+  locale: Locale;
+  /** 当前渲染框架档（Appearance 区 Badge 展示；切换由宿主外观配置源完成） */
+  renderer?: RendererKind;
+  /** 主题/语言切换时回调（宿主借此持久化；内部 state 由 Chatbot 跟随） */
+  onAppearanceChange?(next: AppearanceChange): void;
+  /** 保存/清除成功后回调（Chatbot 借此触发 engine.reloadConfig） */
+  onSaved(): void;
+  onClose(): void;
+}
+/** 设置抽屉：LLM 配置（三协议供应商 / 能力探测 / Demo model 标识 / 流式与 temperature）+ 外观（主题/语言） */
+declare function SettingsDrawer({ open, llmConfig, runtimeConfig, theme, locale, renderer, onAppearanceChange, onSaved, onClose }: SettingsDrawerProps): import("react").JSX.Element;
+//#endregion
+//#region src/react/ErrorCard.d.ts
+interface ErrorCardProps {
+  /** 稳定错误码（WebSkillError.code / RUN_FAILED；缺省不渲染徽章） */
+  code?: string;
+  message: string;
+  onDismiss?(): void;
+}
+/** 结构化错误卡：错误码徽章 + 描述 + 建议（engine error 事件 / 失败 run） */
+declare function ErrorCard({ code, message, onDismiss }: ErrorCardProps): import("react").JSX.Element;
+//#endregion
+export { A2uiSurfaceHost, type A2uiSurfaceHostProps, A2uiSurfaceSnapshotHost, type A2uiSurfaceSnapshotHostProps, type AppearanceChange, type ChatAttachmentInput, type ChatAttachmentMeta, ChatEngine, type ChatEngineOptions, type ChatEvent, type ChatLayout, type ChatMessage, type ChatSessionMeta, type ChatTheme, type ChatToolCall, Chatbot, type ChatbotConfig, type ChatbotHostAdapter, type ChatbotProps, CompositeUiBridge, type CompositeUiBridgeDeps, type DownloadableFile, ErrorCard, type ErrorCardProps, InteractionCard, type InteractionCardProps, InterruptedBanner, type InterruptedBannerProps, type LlmConfig, type Locale, OpenUiChannel, OpenUiInteraction, type OpenUiInteractionProps, type OpenUiSession, OpenUiSurfaceHost, type OpenUiSurfaceHostProps, OpenUiSurfaceSnapshotHost, type OpenUiSurfaceSnapshotHostProps, type RendererKind, type ResolvedChatLayout, ResultBlockList, type ResultBlockListProps, ResultBlocksPro, type ResultBlocksProProps, type RunSnapshot, type RunTraceFile, type SandboxExecutorDeps, SettingsDrawer, type SettingsDrawerProps, SkillBadges, VercelPayloadPreview, type VercelPayloadPreviewProps, VercelSurfaceHost, type VercelSurfaceHostProps, VercelSurfaceSnapshotHost, type VercelSurfaceSnapshotHostProps, chatbotDictionary, configureA2uiMarkdown, probeA2uiAvailability, probeOpenUiAvailability, useT, writeRunTrace };