@webskill/chatbot 0.10.0 → 0.11.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { AgentLoopConfig, ApprovalScope, BridgeCapabilities, DocxTextExtractor, ExternalSkillProvider, ExternalToolSource, FileSystemProvider, HookRunner, InteractionRequest, InteractionResponse, LifecycleEventInit, LinkedDocumentReader, LlmClient, NetworkPolicy, Page, PageQuery, PdfTextExtractor, RenderBlock, RenderResultRequest, RunSnapshot, RunSnapshotListEntry, RuntimePhase, RuntimeRun, ScriptExecutor, SessionStore, SkillCandidateMarker, SkillCatalogEntry, SkillIntegrityGuard, SkillOutcomeReporter, SkillStateGuard, UiBridge, UiSpecDrafts, UiSpecEvent, UiSpecSnapshot, UiSurfaceActionRequest, UiSurfaceActionResponse, UserProfile, UserProfileExport, WebSkillErrorCode, XlsxTextExtractor, diffUserProfile } from "@webskill/sdk";
+import { AgentLoopConfig, ApprovalScope, BridgeCapabilities, DataSourceInfo, DocxTextExtractor, ExternalSkillProvider, ExternalToolSource, FileSystemProvider, HookRunner, InteractionRequest, InteractionResponse, LifecycleEventInit, LinkedDocumentReader, LlmClient, NetworkPolicy, Page, PageQuery, PdfTextExtractor, RenderBlock, RenderResultRequest, RunSnapshot, RunSnapshotListEntry, RuntimePhase, RuntimeRun, ScriptExecutor, SessionStore, SkillCandidateMarker, SkillCatalogEntry, SkillIntegrityGuard, SkillOutcomeReporter, SkillStateGuard, UiBridge, UiSpecDrafts, UiSpecEvent, UiSpecSnapshot, UiSurfaceActionRequest, UiSurfaceActionResponse, UserProfile, UserProfileExport, WebSkillErrorCode, XlsxTextExtractor, diffUserProfile } from "@webskill/sdk";
 import { SandboxMode, TypeScriptSupportOptions } from "@webskill/sdk/browser";
 import { CustomSurfaceActionEvent, ReactBridgeState, SpecInteractionChannel, SurfaceRegistry, UiSurfaceActionEvent } from "@webskill/sdk/ui-react";
-import { PageActionPolicy, PagePerceptionPolicy, PerceptionRecord, SkillCandidateSink, TodoItem } from "@webskill/sdk/agent";
+import { DownloadedFileConsent, DownloadedFileReader, PageActionPolicy, PagePerceptionPolicy, PerceptionPagingBudget, PerceptionRecord, SkillCandidateSink, TodoItem } from "@webskill/sdk/agent";
 import "react";
 import "react/jsx-runtime";
 //#region ../ui-kit/src/i18n/types.d.ts
@@ -26,6 +26,37 @@ 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 ../core/src/attachment/kind.d.ts
+/**
+ * 附件类型判据与文本形态。0.14.0 分册 20 从 `@webskill/chatbot` 迁入：
+ * 「用户上传」与「读取下载目录」两条入口必须给出同一结论（AC-20.17）、
+ * 产出同一份文本（AC-20.6），而后者住在 `@webskill/agent`，chatbot 依赖 agent，
+ * 判据只能落在两者共同的下游。纯字符串运算，无环境依赖。
+ */
+/** 附件在模型侧的内容形态（0.6.0 FR-11.2） @experimental */
+type ChatAttachmentKind = 'text' | 'image' | 'file' | 'document-text';
+//#endregion
+//#region ../runtime/src/tools/types.d.ts
+/**
+ * 宿主声明的一个数据源的**可公开部分**（0.14.0 分册 19）。
+ *
+ * `target` 不在这里，且不得被加进来：这条通路的终点是模型上下文，
+ * 而「地址不由脚本提供」正是 0.11.0 分册 16 §2.2 授权面的全部依据。
+ * @experimental
+ */
+interface DataSourceInfo$1 {
+  id: string;
+  description: string;
+  /**
+   * 非宿主声明时的出处（0.14.0 分册 21）。缺省即宿主声明，不带标注。
+   *
+   * 有值意味着 `description` **来自页面**，模型看到的清单里必须随之出现「可能不准确」的标注，
+   * 否则一段由站点控制的文本会以宿主口吻进上下文。
+   * @experimental
+   */
+  provenance?: 'page-declared' | 'tool-projection';
+}
+//#endregion
 //#region ../runtime/src/sandbox/bridgeProtocol.d.ts
 /**
  * 能力模式：true 直通 / false 关闭（TOOL_UNSUPPORTED）/ 'require-approval' 调用前强制授权
@@ -117,6 +148,19 @@ interface RuntimeHooksConfig {
 }
 /** 浏览器宿主执行器档位；Node 宿主的 in-process/worker/process 由宿主侧扩展展示 */
 type RuntimeSandboxExecutor = 'auto' | 'blob-worker' | 'iframe-sandbox';
+/**
+ * 用户自己声明的取数源（0.14.0 分册 19）。
+ *
+ * 存在的理由：从别的宿主导出的技能会声明本宿主没有的源 id，没有这一段就永远跑不起来。
+ * 它不放宽任何闸门——`url` 照过 `sandbox.remoteUrl` 判定，取数照受 `capabilities.fetchData` 管，
+ * 变的只是「谁来写这个地址」：宿主开发者，还是宿主的使用者。
+ */
+interface RuntimeDataSourceEntry {
+  id: string;
+  /** 绝对 http(s) 地址 */
+  url: string;
+  description: string;
+}
 interface RuntimeSandboxConfig {
   executor: RuntimeSandboxExecutor;
   networkPolicy: NetworkPolicy$1;
@@ -138,6 +182,11 @@ interface RuntimeSandboxConfig {
    * 所以不受 `toolResultMaxBytes` 约束。
    */
   maxDataSourceBytes: number;
+  /**
+   * 用户声明的取数源（0.14.0 分册 19）；缺省空数组 = 只有宿主代码写死的那些。
+   * 与宿主源撞 id 时宿主的那条胜出——否则用户配置就能改写宿主的授权面。
+   */
+  dataSources: RuntimeDataSourceEntry[];
   /**
    * 出站 URL 准入策略（`RemoteUrlPolicy` 的可配置部分）：技能安装、MCP 端点连接
    * 这类由宿主发起的取数都按它判定。两项都默认关，即 https-only 且拒绝内网/环回。
@@ -145,6 +194,13 @@ interface RuntimeSandboxConfig {
   remoteUrl: RuntimeRemoteUrlConfig;
   /** 浏览器沙箱的 TypeScript 支持；关闭时 `.ts` 脚本按 `TOOL_UNSUPPORTED` 拒绝 */
   typescript: RuntimeTypeScriptConfig;
+  /**
+   * 读取用户下载的文件（0.14.0 分册 20）。缺省 `false`。
+   *
+   * **不放进 `capabilities`**：那张表的语义是三态 `CapabilityMode`（关 / 需批准 / 开），
+   * 而本能力的「需批准」是恒定的，放进去会凭空多出一个「开且不批准」的非法组合。
+   */
+  downloadedFiles: boolean;
 }
 /**
  * 只做类型擦除，不做类型检查。`esbuildUrl` 为绝对 http(s) 地址时按 `remoteUrl` 判定；
@@ -378,269 +434,582 @@ declare function createLocalStorageRuntimeConfigStore(options?: LocalStorageRunt
 /** 内存实现：测试、SSR、以及宿主明确不想持久化时使用。 @experimental */
 declare function createMemoryRuntimeConfigStore(initial?: Partial<RuntimeConfig>): RuntimeConfigStore;
 //#endregion
-//#region src/core/attachmentKind.d.ts
-/** 附件在模型侧的内容形态（0.6.0 FR-11.2） @experimental */
-type ChatAttachmentKind = 'text' | 'image' | 'file' | 'document-text';
-//#endregion
-//#region src/core/types.d.ts
+//#region src/core/hostAdapter.d.ts
 /**
- * 治理 port 集合（F1）：宿主把 `SkillStatePolicy` 的适配器交给 chatbot，
- * 由它接到内部装配的 `WebSkillRuntime` 上。字段名与 `WebSkillRuntimeDeps` 逐个对齐，
- * 不做重命名：中间多一层映射只会让宿主多记一套名字。
- * @experimental
+ * 宿主装配口：chatbot 不感知环境（浏览器/Node），全部能力经此注入。
+ * 页面动态技能来源同时是外部工具来源与外部技能提供者（同一对象两个 port）。
+ * LLM 配置不在这里——它统一由 `RuntimeConfigStore` 承载（0.5.0 起）。
+ * @stable
  */
-interface ChatbotGovernancePorts {
-  /** `SkillStatePolicy.toSkillStateGuard()`：read/activate/execute 三入口拦截 */
-  skillStateGuard?: SkillStateGuard;
-  /** `SkillStatePolicy.toSkillIntegrityGuard(verify)`：激活期验签，失败即隔离 */
-  skillIntegrityGuard?: SkillIntegrityGuard;
-  /** `SkillStatePolicy.toSkillOutcomeReporter()`：执行失败计数，达阈值即隔离 */
-  skillOutcomeReporter?: SkillOutcomeReporter;
-  /** `SkillStatePolicy.catalogFilter()`：非 active 技能不进路由候选集 */
-  catalogFilter?: (entries: SkillCatalogEntry[]) => SkillCatalogEntry[] | Promise<SkillCatalogEntry[]>;
+interface ChatbotHostAdapter {
+  storage: FileSystemProvider;
+  skillRoots: string[];
+  pageSkillSource?: ExternalToolSource & ExternalSkillProvider;
+  navigation: {
+    openConsole(): void;
+    /** 跳 console Traces 面板并定位该 run（v1.1；缺省时消息不渲染 View trace 入口） */
+    openConsoleTrace?(runId: string): void;
+    /** 打开治理面的审批队列并定位该候选（FR-24.2）；宿主未接治理面时不提供，入口随之不渲染 */
+    openConsoleCandidate?(candidateId: string): void;
+  };
+  /** 缺省 BrowserWorkerScriptExecutor（@webskill/browser）；Node 宿主可注入自己的执行器 */
+  executor?: ScriptExecutor;
   /**
-   * run 未激活任何技能时的钩子（如 `createMissHook`）。
+   * 页面只读感知策略（需求 10）。**只能在这里注入**：启用与否是宿主侧配置，
+   * 设置抽屉里没有也不会有开关（FR-10.1）——风险由部署方承担，
+   * 不应交给终端用户随手勾选。
+   * @experimental
+   */
+  pagePerception?: PagePerceptionPolicy;
+  /**
+   * 感知结果的分段预算（0.14.0 分册 22 FR-22.4 / FR-22.8）。
    *
-   * 开关存在 `GovernanceFacade.missHook`（属 console），chatbot 读不到也不该依赖它；
-   * 所以读开关是**宿主**的责任。宿主应传一个**每次触发时才读开关**的闭包，
-   * 而不是装配时把布尔值算好——`#assemble()` 不是每次 run 都跑，
-   * 算好了会导致「开着启动 → 中途关闭」不生效（AC-17.11）。
+   * 与 `pagePerception` 同一条装配规矩：只能在这里给，设置抽屉里没有开关。
+   * **不给即不分段，但地板照样生效**——不开启不等于允许引擎盲切，
+   * 超预算时仍然是「读到预算为止 + 一条原位说明」，只是没有续读的入口。
+   * @experimental
    */
-  onSkillMiss?: (input: {
-    prompt: string;
-    run: RuntimeRun;
-  }) => Promise<void>;
-}
-/** 分配式交叉：直接写 `信封 & LifecycleEventInit` 会把联合压成一个对象，`phase` 的判别性就没了 */
-type WithChatMeta<T> = T extends unknown ? {
-  type: 'lifecycle';
-  runId: string;
-  at: number;
-} & T : never;
-/**
- * 生命周期步进事件：`data` 随 `phase` 判别，与 runtime 的 `LifecycleEvent` 同一套契约。
- * 旧的 `Record<string, unknown>` 等于没有契约：消费方只能硬编码键名。
- */
-type LifecycleChatEvent = WithChatMeta<LifecycleEventInit>;
-/**
- * 交互渲染框架档位：native（React InteractionCard）/ a2ui（@a2ui/lit Lit 渲染）/
- * openui（@openuidev/react-lang Renderer，ui-kit Library）/ vercel（@json-render/react
- * Registry 渲染 catalog 声明树）
- * @experimental
- */
-type RendererKind = 'native' | 'a2ui' | 'openui' | 'vercel';
-/** assistant 消息所属 run 的一次工具调用（终态：completed/failed） @stable */
-interface ChatToolCall {
-  callId: string;
-  name: string;
-  status: 'completed' | 'failed';
-  /** 参数摘要（JSON 截断 100 字符；trace 重放无 args 时留空，卡片展开详情有则显示） */
-  args?: string;
-  /** 执行耗时（trace completed/failed 回填；live 由 started→终态计时） */
-  durationMs?: number;
+  pagePerceptionPaging?: PerceptionPagingBudget;
   /**
-   * 开始时刻（epoch ms，0.10.0 UI-UX5 #32）。与思考段按时间穿插需要共同时钟；
-   * 旧会话消息没有该字段时工具卡片保持原有相对顺序。
+   * 页面操作能力（需求 23）。**不注入即完全关闭**，与 `pagePerception` 分开：
+   * 可读不等于可操作。同样只能在这里注入——给终端用户一个「打开代操作」的开关
+   * 等于把安全边界交给最不了解它的人。
+   * @experimental
    */
-  at?: number;
+  pageActions?: PageActionPolicy;
   /**
-   * failed 时的结构化错误码（如 `TOOL_NOT_ALLOWED`）。
-   * 「被策略拒绝」与「执行失败」在 UI 上是两回事，靠错误码区分而不是解析文案。
+   * 读页面链接指向的文档（分册 22）。实现住在 `@webskill/browser`，
+   * 而 chatbot 不依赖它 —— 与 `pagePerception` 同一条装配规矩：宿主注入。
+   * 不注入即 `read_linked_document` 不注册。
    */
-  errorCode?: string;
-  /** failed 时的错误说明（拒绝时即「被哪条策略拒绝」） */
-  errorMessage?: string;
-}
-/** 已落盘的待发送附件（composer 附件适配器产出） @experimental */
-interface ChatAttachmentInput {
-  id: string;
-  name: string;
-  contentType: string;
-  /** 相对 `attachmentsRoot` 的路径 */
-  path: string;
-  size: number;
-  /** 注入模型的内容形态；决定 send 时读文本还是读二进制 */
-  kind: ChatAttachmentKind;
-  /** 图片经压缩时的原始字节数，供 UI 显示「3.2 MB → 1.8 MB」（FR-11.3） */
-  originalSize?: number;
+  linkedDocuments?: LinkedDocumentReader;
+  /** docx → 文本（`extractDocxText`）；不注入即 Word 文档明确报「本环境不支持」 */
+  docxExtractor?: DocxTextExtractor;
+  /** xlsx → 文本（`extractXlsxText`）；不注入即 Excel 工作簿明确报「本环境不支持」 */
+  xlsxExtractor?: XlsxTextExtractor;
+  /**
+   * PDF → 文本；**只用于直传被端点拒后的回退**（0.13.0 FR-22.1）。
+   * PDF 仍然默认直传，能读的端点拿到的还是原件；不注入即没有回退能力。
+   */
+  pdfExtractor?: PdfTextExtractor;
+  /** 文档读取留痕出口（FR-22.6） */
+  documentAudit?: {
+    append(event: {
+      type: string;
+      target: string;
+      data?: Record<string, unknown>;
+    }): Promise<unknown>;
+  };
+  /**
+   * 读用户本机下载的文件（0.14.0 分册 20）。**不注入即两个工具都不注册**，
+   * 与 `sandbox.downloadedFiles` 开关是「与」的关系：宿主没接通路，用户开了也没用。
+   *
+   * 只收端口，不收策略：授权卡出口、能力开关、模型读图能力、docx/xlsx 抽取器
+   * 全在引擎这一侧，宿主自己拼一个策略必然要重复这四项判断。
+   * @experimental
+   */
+  downloads?: {
+    reader: DownloadedFileReader;
+    /** 「不再询问」的记忆端口；不注入即每次都问 */
+    consent?: DownloadedFileConsent;
+  };
 }
-/** 随消息持久化的附件元数据 @experimental */
-type ChatAttachmentMeta = ChatAttachmentInput;
+//#endregion
+//#region src/core/chatEngine.d.ts
 /**
- * 归并后的显示相位。进行中通道与历史通道共用这一个结构：
- * 各存一份正是「运行细节首轮后消失」的根因（需求 17 条目 10-6）。
+ * 条目能否真的发请求：云端要有端点或密钥，浏览器内置两者都不需要。
+ *
+ * 导出给 UI：选择器不用同一份判据的话，用户能选中一个空配置条目，
+ * 而引擎静默回退到另一条——界面说在用 A、实际跑的是 B（UI-UX8 D1）。
  * @experimental
  */
-interface ChatRunPhase {
-  phase: RuntimePhase;
-  at: number;
-  /** 下一个步进到达时回填 */
-  endedAt?: number;
-  /** 由结构化 `LifecycleEvent.data` 派生的一句摘要 */
-  note?: string;
-  /** fail 相位的具体说明：`reason` 只有七种取值，说不出「哪个上限、哪个模型」 */
-  detail?: string;
-}
-/** 本轮发生的一次已提交交互（FR-17.8：提交后表单保留所填值） @experimental */
-interface ChatInteractionRecord {
-  id: string;
-  request: InteractionRequest;
-  /** 提交时的表单值；文件类字段已在引擎侧脱敏 */
-  submittedValues?: unknown;
-}
+declare const isLlmEntryUsable: (entry: RuntimeLlmEntry) => boolean;
 /**
- * 该 run 内模型产出的一段思考正文（0.10.0 UI-UX5 #32）。
- * 每次模型调用的思考算一段；随消息持久化，重开会话仍能看到。
- * 模型不支持思考输出时整个数组缺省——不产空壳卡片。
+ * 选中条目 → 默认条目 → 首条；命中不可用条目时**回退到下一个可用条目**
+ * （0.10.0 复核：选中项失效时宁可静默换用可用模型，也不能把 UI 锁死成
+ * 「未配置」死胡同——引擎与 UI 共用同一判据，两边必须同进退）。
+ * 全部不可用才 undefined（引擎走内置演示）。
+ *
+ * 导出给 UI 复用同一判据：composer 的「未配置模型」引导判定必须与引擎的
+ * 实际挑选结果一致，否则会出现「UI 说有模型、引擎却走演示档」的错位（0.10.0 UI-UX5 #49-1）。
  * @experimental
  */
-interface ChatThinking {
-  text: string;
-  /** 首个思考增量到达时刻（epoch ms；与工具卡片按时间穿插的排序依据） */
-  at: number;
+declare function pickUsableLlmEntry(entries: readonly RuntimeLlmEntry[], defaultId: string | undefined, selectedId: string | undefined): RuntimeLlmEntry | undefined;
+/** 默认沙箱执行器的构造参数（adapter.executor 未注入时；executorFactory 替换点可见同一形状） @stable */
+interface SandboxExecutorDeps {
+  fs: FileSystemProvider;
+  sandbox?: SandboxMode;
+  networkPolicy?: NetworkPolicy;
+  capabilities?: BridgeCapabilities;
+  approvalScope?: ApprovalScope;
+  uiBridge?: UiBridge;
+  /** 缺省时 `.ts` 脚本按 `TOOL_UNSUPPORTED` 拒绝 */
+  typescript?: TypeScriptSupportOptions;
 }
 /**
- * 该 run 的大模型用量（0.10.0 UI-UX5 #47）：随消息持久化，重开会话仍可见。
- * 上游不回报 token 用量时整个字段缺省——不显示假数据。
- * @experimental
+ * 装配时（而非执行时）把 `sandbox.typescript` 转成执行器参数，让配置错误早暴露。
+ * 只对绝对 URL 走 `RemoteUrlPolicy`：同源相对路径与打包器 specifier 不是出站请求。
  */
-interface ChatTokenUsage {
-  inputTokens: number;
-  outputTokens: number;
-  /** 本 run 向大模型发送请求的次数（模型调用轮数） */
-  llmCalls: number;
-}
 /**
- * 助手消息的有序内容段（分册 17 FR-17.1）：文字与 surface / 结果块按生成顺序排列。
- * 冗余记账——删掉本字段消息内容不缺失，只退化成「正文在上、扩展在下」（FR-17.11）。
+ * 由 `RuntimeConfig` 装出沙箱执行器依赖。
+ *
+ * 主链路与**评估链路**共用这一处（T-17-H）：此前评估侧只传 `fs`，
+ * 于是评估里跑的技能不受沙箱、网络策略、能力与授权范围约束——
+ * 那比「.ts 跑不了」严重得多（设计 17 §1.1a）。
+ *
  * @experimental
  */
-type ChatContentPart = {
-  type: 'text';
-  text: string;
-  at: number;
-} | {
-  type: 'surface';
-  surfaceId: string;
-  at: number;
-} | {
-  type: 'blocks';
-  at: number;
-};
+declare function sandboxExecutorDeps(fs: FileSystemProvider, rc?: RuntimeConfig, uiBridge?: SandboxExecutorDeps['uiBridge']): SandboxExecutorDeps;
 /** @stable */
-interface ChatMessage {
-  id: string;
-  role: 'user' | 'assistant';
+interface ChatEngineOptions {
+  llm?: LlmClient;
+  loopConfig?: AgentLoopConfig;
+  chatRoot?: string;
+  /** 运行环境配置存储（P2）：#ensureReady 装配时 load()（默认值兜底）并按映射应用 */
+  runtimeConfig?: RuntimeConfigStore;
+  /** 初始渲染框架档（默认 'native'；运行中可 setRenderer 热切换） */
+  renderer?: RendererKind;
   /**
-   * 消息正文。本 run 一个字也没产出时（例如模型开口前就被中止）**缺省**，
-   * 与「产出了空串」区分开——写空串会渲染出一个空白气泡（FR-20.4）。
+   * 注入 `render_ui` 工具，让模型面向 AI Component Catalog 生成声明式 UI。
+   *
+   * 注入了 `runtimeConfig` 时**以 `RuntimeConfig.agentCapabilities.generativeUi` 为准**，
+   * 本字段只在未接配置存储的宿主上生效（否则设置面板里的开关点了不算数）。
    */
-  text?: string;
-  ts: string;
-  /** user 消息携带的附件（旧会话文件无该字段） */
-  attachments?: ChatAttachmentMeta[];
+  generativeUi?: boolean;
+  /** 沙箱执行器替换点（测试注入 spy 断言构造参数；缺省 BrowserWorkerScriptExecutor） */
+  executorFactory?: (deps: SandboxExecutorDeps) => ScriptExecutor;
   /**
-   * 随消息持久化的系统提示（例如「图片超出数量上限，未发送 X」，FR-11.3）。
-   * 放在消息里而不是 toast：toast 会消失，用户回头就查不到这次到底发了什么。
-   * @experimental
+   * 宿主声明的数据源取数入口（分册 16）。不注入即脚本上下文没有 `fetchData` 这个键。
+   *
+   * 装配点必须在宿主：策略本体 `DataSourcePolicy` 住在 `@webskill/agent`，
+   * 而数据源的目标地址是宿主自己的业务知识，chatbot 无从代为声明。
+   * 能力开关 `sandbox.capabilities.fetchData` 缺省关，注入了也还要宿主在配置里打开。
    */
-  notice?: string;
-  /** assistant 消息所属 run */
-  runId?: string;
-  /** 该 run 激活的技能（消息底部 badges） */
-  activeSkillNames?: string[];
-  /** 该 run 的工具调用序列（思维链工具行；按 trace 顺序） */
-  toolCalls?: ChatToolCall[];
+  fetchData?: (sourceId: string, params?: Record<string, unknown>) => Promise<unknown>;
   /**
-   * 该 run 的思考段序列（0.10.0 UI-UX5 #32）：渲染时与 `toolCalls` 按 `at` 归并，
-   * 多张思考卡片按时间穿插在工具卡片之间。
-   * @experimental
+   * 宿主声明的数据源清单（0.14.0 分册 19），取自 `DataSourcePolicy.publicSources`。
+   * 技能声明了本宿主没有的源时，引擎在激活回执里说明缺什么；不注入即不说。
    */
-  thinkings?: ChatThinking[];
+  dataSources?: readonly DataSourceInfo$1[] | (() => readonly DataSourceInfo$1[]);
   /**
-   * 该 run 的结果块（bridge.renderResult 的 blocks），随消息持久化。
-   * 当前 run 的块由 ResultBlocksPro 直读 bridge 渲染；历史消息按 blocks 逐条渲染（ResultBlockList）。
+   * 会话落盘替换点（缺省 `FsSessionStore`，落在 `<chatRoot>/sessions`）。
+   * 宕主换自己的实现（如 IndexedDB）与测试统计端口读写量都走这里。
    */
-  blocks?: RenderBlock[];
-  /** The completed generative UI surfaces emitted by this run, retained for history replay. */
-  surfaces?: UiSpecSnapshot[];
-  /** 该 run 的待办清单终态（历史消息重放；未产生清单时缺省） */
-  todos?: TodoItem[];
+  sessionStore?: SessionStore<ChatMessage>;
   /**
-   * 该 run 内发生的页面只读感知（需求 10 FR-10.5）。
-   * 随消息持久化而不只在运行中闪现——事后仍能查到「那一次它读了哪些区域」。
-   * @experimental
+   * 宿主已注册好钩子的执行器；装配时把 `RuntimeConfig.hooks` 应用到它再交给 runtime。
+   * 不注入即不挂钩子（与 0.0.2 行为一致）。
    */
-  perceptions?: PerceptionRecord[];
+  hooks?: HookRunner;
   /**
-   * 该 run 的大模型用量（0.10.0 UI-UX5 #47）：消息操作区图标右侧显示
-   * 输入输出合计 tokens（千分位）。上游不回报用量时缺省，不显示假数据。
-   * @experimental
+   * 治理 port 注入（F1）：把 `SkillStatePolicy` 的三个适配器接到本引擎装配的 runtime 上。
+   *
+   * 不注入即完全关闭，行为与 0.0.2 一致。装配点必须在宿主：chatbot 不能依赖
+   * `@webskill/governance`（它是可选治理层，且要求宿主提供治理根与审计存储）。
+   *
+   * 三个一起给才形成闭环——只给 `skillOutcomeReporter` 会把技能标成 `quarantined`
+   * 却仍旧照常路由和执行，降级形同虚设。
    */
-  usage?: ChatTokenUsage;
+  governance?: ChatbotGovernancePorts;
   /**
-   * 发出本轮请求的模型条目 id（`RuntimeConfig.llm.entries[].id`）。
-   * 写在消息上而不是会话上：切换模型只对后续消息生效，已有消息的归属不能被改写。
+   * 技能自动生成的候选收货端（需求 12 号）。与 `governance` 同理，装配点在宿主：
+   * `@webskill/governance` 的 `createCandidateSink()` 是现成实现。
+   *
+   * 开关另在 `RuntimeConfig.agentCapabilities.skillGeneration`（默认关）；
+   * 开关开但未注入本端口时，工具会把 `SKILL_GENERATION_DISABLED` 回给模型。
    */
-  model?: string;
+  skillCandidates?: SkillCandidateSink;
+}
+/**
+ * 对话框引擎：装配 WebSkillRuntime + 会话持久化 + 事件分发。
+ * RuntimeConfig 的 load() 是异步的，runtime 在首次 send 前懒装配（#ensureReady）。
+ * @stable
+ */
+declare class ChatEngine {
+  #private;
+  readonly bridge: ReactBridgeState;
+  constructor(adapter: ChatbotHostAdapter, options?: ChatEngineOptions);
+  /** 当前待办清单快照（宿主可直读；实时更新订阅 `todo-changed` 事件） */
+  get todos(): readonly TodoItem[];
+  /** 当前渲染框架档 */
+  get renderer(): RendererKind;
+  /** 当前会话选中的模型条目 id；未显式切换过时为 undefined（走 `RuntimeConfig.llm.defaultId`） */
+  get modelId(): string | undefined;
   /**
-   * 该轮的生命周期相位快照（FR-17.7）。不持久化它，live 状态一丢「运行细节」入口就消失，
-   * 表现为容器高度先减后增。
-   * @experimental
+   * 切换本会话后续消息使用的模型条目（需求 4）。传 `undefined` 回到配置里的默认项。
+   * 重装配 runtime 以换掉客户端；已落盘的消息不受影响。
    */
-  phases?: ChatRunPhase[];
+  setModel(entryId: string | undefined): void;
+  /** 会话文件所在目录：「存储未初始化」提示要把路径写给用户看 @experimental */
+  get sessionsRoot(): string;
+  /** 渲染框架热切换：复合桥按档分发，无需重装配 runtime（会话句柄保留） */
+  setRenderer(renderer: RendererKind): void;
+  /** 非 native 三档共用的交互通道（Chatbot 的 SpecInteraction 订阅/attach；core 只产出 catalog 节点树） */
+  get interactionChannel(): SpecInteractionChannel;
+  /** 探测 @a2ui/lit 是否安装（Appearance/设置区 A2UI 档置灰判定） */
+  probeA2uiAvailability(): Promise<boolean>;
+  onEvent(listener: (event: ChatEvent) => void): () => void;
   /**
-   * 该轮发生的交互及其终态（FR-17.8）。交互卡归属发起它的那条消息，
-   * 后续结果另开新消息，而不是就地改写原表单。
+   * 配置源变更后调用（LLM 设置 / RuntimeConfigStore 内容变化）：丢弃缓存的
+   * runtime/llm/会话句柄，下次 send 重新装配（RuntimeConfig 重新 load() 应用）
+   */
+  reloadConfig(): void;
+  /**
+   * 技能仓变更后调用（安装/卸载/发布）：作废 runtime 缓存的技能目录，下次 send 重新扫描。
+   *
+   * 比 `reloadConfig()` 轻，因为它不清 `#handles`——那会连带丢掉每个会话的模型上下文。
+   * 装技能的界面与对话不在同一个页面时（如扩展的 options 页 vs side panel），
+   * 宿主必须自己把变更通知过来，否则新技能要等页面重载才出现在 catalog 里。
    * @experimental
    */
-  interactions?: ChatInteractionRecord[];
+  invalidateSkills(): void;
   /**
-   * 该轮提交的技能候选（FR-24.1）。数据来自 `$skillCandidate` 载荷，
-   * 不从模型复述的自然语言里解析。
+   * 会话列表页。归档会话也返回：UI 自己分区展示。
+   * `limit` 不给默认值——缺省属于 `SessionStore` 实现，在这里兜底就等于只下推了一半。
+   */
+  listSessions(options?: PageQuery): Promise<ChatSessionListResult>;
+  /** `title` 缺省时会话先无标题，首条消息发出时再按内容补（FR-21.8） */
+  createSession(options?: {
+    title?: string;
+  }): Promise<ChatSessionMeta>;
+  /**
+   * 选中会话并取**最新**一页历史（页内时间升序）。
+   * 返回全量 `ChatMessage[]` 的旧签名已移除：长会话下它强迫每个调用方拿全量。
+   */
+  selectSession(id: string, options?: PageQuery): Promise<Page<ChatMessage>>;
+  /** 向历史方向再取一页；`cursor` 只能来自上一页的 `nextCursor` */
+  loadMoreMessages(cursor: string, options?: {
+    limit?: number;
+  }): Promise<Page<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` 内的路径读回并构造 `LlmContentPart[]`（FR-11.2）。
+   */
+  send(text: string, attachments?: readonly ChatAttachmentInput[]): Promise<void>;
+  /** 附件落盘根目录（composer 附件适配器写入，send 时读回） */
+  get attachmentsRoot(): string;
+  /** 取消进行中的 run（Composer Stop 按钮）；run 未找到/已结束返回 false */
+  cancel(runId: string): boolean;
+  /**
+   * 释放引擎：取消进行中的 run、退订全部事件、丢弃装配缓存。
+   * 宿主重挂组件时用它收尾；只是换配置的话用 `reloadConfig()`，不要 dispose。
+   */
+  dispose(): Promise<void>;
+  /** 列出 interrupted run（InterruptedBanner 数据源）；版本不受支持的项带 unsupported 标记 */
+  listInterrupted(): Promise<RunSnapshotListEntry[]>;
+  /**
+   * 恢复 interrupted run：等待中的交互重新进入 bridge.pending（UI 复用 InteractionForm），
+   * 完成后与 send 同路径（assistant 消息持久化 + run-completed + trace 落盘）。
+   */
+  resume(runId: string): Promise<void>;
+  /** 读取当前画像（FR-19.3：可见） @experimental */
+  readUserProfile(): Promise<UserProfile>;
+  /** 已记录的行为条数；设置面板用它告诉用户「清除」会删掉什么 @experimental */
+  countBehaviorRecords(): Promise<number>;
+  /** 删除单条画像结论（FR-19.3：可编辑可删除） @experimental */
+  deleteUserProfileEntry(id: string): Promise<UserProfile>;
+  /** 清除全部行为记录（FR-19.8）。与清除画像是两个独立操作 @experimental */
+  clearBehaviorRecords(): Promise<void>;
+  /** 清除提炼出的画像（FR-19.8） @experimental */
+  clearUserProfile(): Promise<void>;
+  /**
+   * 一并清除记录与画像，并销毁加密密钥（FR-19.8：关闭总开关时的「一并清除」）。
+   * 密钥留着就等于给残留密文留了一把能解开的钥匙。
    * @experimental
    */
-  candidates?: SkillCandidateMarker[];
+  clearUserProfileData(): Promise<void>;
   /**
-   * 文字与 surface / blocks 的生成顺序（分册 17）。缺省时按 0.11.0 的两段式渲染。
+   * 手动提炼（FR-19.3）。与会话结束后的自动提炼同一条路径，
+   * 区别只在于这里的失败会抛给调用方——用户点了按钮就该看到结果。
    * @experimental
    */
-  contentParts?: ChatContentPart[];
-}
-/** @stable */
-interface ChatSessionMeta {
-  id: string;
-  createdAt: string;
-  title?: string;
-  /** 归档会话：列表分区展示，不参与默认选中 */
-  archived?: boolean;
-  /** 用户已手动重命名：后续 send 不再用首条消息覆盖标题 */
-  titleLocked?: boolean;
+  refineUserProfile(): Promise<UserProfile>;
+  /** 导出画像（FR-19.7）。`excludeIds` 来自导出前的审阅界面 @experimental */
+  exportUserProfile(excludeIds?: readonly string[]): Promise<UserProfileExport>;
+  /** 导入前的差异（FR-19.7）：由 UI 展示并确认后才调用 `applyUserProfileImport` @experimental */
+  diffUserProfileImport(incoming: UserProfileExport): Promise<ReturnType<typeof diffUserProfile> & {
+    origin: string;
+  }>;
+  /** 确认后落库（FR-19.7） @experimental */
+  applyUserProfileImport(incoming: UserProfileExport): Promise<UserProfile>;
 }
+//#endregion
+//#region src/core/types.d.ts
 /**
- * 会话列表页：除了数据，还得告诉 UI「为什么是空的」（FR-21.4 / FR-21.11）。 @experimental
+ * 治理 port 集合（F1）：宿主把 `SkillStatePolicy` 的适配器交给 chatbot，
+ * 由它接到内部装配的 `WebSkillRuntime` 上。字段名与 `WebSkillRuntimeDeps` 逐个对齐，
+ * 不做重命名：中间多一层映射只会让宿主多记一套名字。
+ * @experimental
  */
-interface ChatSessionListResult {
-  items: ChatSessionMeta[];
-  nextCursor?: string;
-  /** `'ok'` = 正常列举；`'missing-root'` = 会话目录不存在（多半是 chatRoot 配错） */
-  source: 'ok' | 'missing-root';
-  /** 读不动而被跳过的会话文件名 */
-  skipped: readonly string[];
+interface ChatbotGovernancePorts {
+  /** `SkillStatePolicy.toSkillStateGuard()`：read/activate/execute 三入口拦截 */
+  skillStateGuard?: SkillStateGuard;
+  /** `SkillStatePolicy.toSkillIntegrityGuard(verify)`：激活期验签，失败即隔离 */
+  skillIntegrityGuard?: SkillIntegrityGuard;
+  /** `SkillStatePolicy.toSkillOutcomeReporter()`：执行失败计数，达阈值即隔离 */
+  skillOutcomeReporter?: SkillOutcomeReporter;
+  /** `SkillStatePolicy.catalogFilter()`：非 active 技能不进路由候选集 */
+  catalogFilter?: (entries: SkillCatalogEntry[]) => SkillCatalogEntry[] | Promise<SkillCatalogEntry[]>;
+  /**
+   * run 未激活任何技能时的钩子（如 `createMissHook`）。
+   *
+   * 开关存在 `GovernanceFacade.missHook`（属 console），chatbot 读不到也不该依赖它；
+   * 所以读开关是**宿主**的责任。宿主应传一个**每次触发时才读开关**的闭包，
+   * 而不是装配时把布尔值算好——`#assemble()` 不是每次 run 都跑，
+   * 算好了会导致「开着启动 → 中途关闭」不生效（AC-17.11）。
+   */
+  onSkillMiss?: (input: {
+    prompt: string;
+    run: RuntimeRun;
+  }) => Promise<void>;
 }
-/** @stable */
-type ChatEvent = {
-  type: 'run-started';
-  runId: string;
-} | {
-  type: 'message-delta';
+/** 分配式交叉：直接写 `信封 & LifecycleEventInit` 会把联合压成一个对象，`phase` 的判别性就没了 */
+type WithChatMeta<T> = T extends unknown ? {
+  type: 'lifecycle';
   runId: string;
-  delta: string;
-} |
+  at: number;
+} & T : never;
 /**
- * 思考增量（0.10.0 UI-UX5 #32）：runtime 的 thinking-delta 原样转发。
- * 模型不产出思考时一个事件也没有；UI 据事件有无决定渲不渲染思考卡片。
- */
+ * 生命周期步进事件：`data` 随 `phase` 判别，与 runtime 的 `LifecycleEvent` 同一套契约。
+ * 旧的 `Record<string, unknown>` 等于没有契约：消费方只能硬编码键名。
+ */
+type LifecycleChatEvent = WithChatMeta<LifecycleEventInit>;
+/**
+ * 交互渲染框架档位：native（React InteractionCard）/ a2ui（@a2ui/lit Lit 渲染）/
+ * openui（@openuidev/react-lang Renderer，ui-kit Library）/ vercel（@json-render/react
+ * Registry 渲染 catalog 声明树）
+ * @experimental
+ */
+type RendererKind = 'native' | 'a2ui' | 'openui' | 'vercel';
+/** assistant 消息所属 run 的一次工具调用（终态：completed/failed） @stable */
+interface ChatToolCall {
+  callId: string;
+  name: string;
+  status: 'completed' | 'failed';
+  /** 参数摘要（JSON 截断 100 字符；trace 重放无 args 时留空，卡片展开详情有则显示） */
+  args?: string;
+  /** 执行耗时（trace completed/failed 回填；live 由 started→终态计时） */
+  durationMs?: number;
+  /**
+   * 开始时刻（epoch ms，0.10.0 UI-UX5 #32）。与思考段按时间穿插需要共同时钟；
+   * 旧会话消息没有该字段时工具卡片保持原有相对顺序。
+   */
+  at?: number;
+  /**
+   * failed 时的结构化错误码（如 `TOOL_NOT_ALLOWED`）。
+   * 「被策略拒绝」与「执行失败」在 UI 上是两回事，靠错误码区分而不是解析文案。
+   */
+  errorCode?: string;
+  /** failed 时的错误说明（拒绝时即「被哪条策略拒绝」） */
+  errorMessage?: string;
+}
+/** 已落盘的待发送附件（composer 附件适配器产出） @experimental */
+interface ChatAttachmentInput {
+  id: string;
+  name: string;
+  contentType: string;
+  /** 相对 `attachmentsRoot` 的路径 */
+  path: string;
+  size: number;
+  /** 注入模型的内容形态；决定 send 时读文本还是读二进制 */
+  kind: ChatAttachmentKind;
+  /** 图片经压缩时的原始字节数，供 UI 显示「3.2 MB → 1.8 MB」（FR-11.3） */
+  originalSize?: number;
+}
+/** 随消息持久化的附件元数据 @experimental */
+type ChatAttachmentMeta = ChatAttachmentInput;
+/**
+ * 归并后的显示相位。进行中通道与历史通道共用这一个结构：
+ * 各存一份正是「运行细节首轮后消失」的根因（需求 17 条目 10-6）。
+ * @experimental
+ */
+interface ChatRunPhase {
+  phase: RuntimePhase;
+  at: number;
+  /** 下一个步进到达时回填 */
+  endedAt?: number;
+  /** 由结构化 `LifecycleEvent.data` 派生的一句摘要 */
+  note?: string;
+  /** fail 相位的具体说明：`reason` 只有七种取值，说不出「哪个上限、哪个模型」 */
+  detail?: string;
+}
+/** 本轮发生的一次已提交交互（FR-17.8：提交后表单保留所填值） @experimental */
+interface ChatInteractionRecord {
+  id: string;
+  request: InteractionRequest;
+  /** 提交时的表单值；文件类字段已在引擎侧脱敏 */
+  submittedValues?: unknown;
+}
+/**
+ * 该 run 内模型产出的一段思考正文（0.10.0 UI-UX5 #32）。
+ * 每次模型调用的思考算一段；随消息持久化，重开会话仍能看到。
+ * 模型不支持思考输出时整个数组缺省——不产空壳卡片。
+ * @experimental
+ */
+interface ChatThinking {
+  text: string;
+  /** 首个思考增量到达时刻（epoch ms；与工具卡片按时间穿插的排序依据） */
+  at: number;
+}
+/**
+ * 该 run 的大模型用量（0.10.0 UI-UX5 #47）：随消息持久化，重开会话仍可见。
+ * 上游不回报 token 用量时整个字段缺省——不显示假数据。
+ * @experimental
+ */
+interface ChatTokenUsage {
+  inputTokens: number;
+  outputTokens: number;
+  /** 本 run 向大模型发送请求的次数（模型调用轮数） */
+  llmCalls: number;
+}
+/**
+ * 助手消息的有序内容段（分册 17 FR-17.1）：文字与 surface / 结果块按生成顺序排列。
+ * 冗余记账——删掉本字段消息内容不缺失，只退化成「正文在上、扩展在下」（FR-17.11）。
+ * @experimental
+ */
+type ChatContentPart = {
+  type: 'text';
+  text: string;
+  at: number;
+} | {
+  type: 'surface';
+  surfaceId: string;
+  at: number;
+} | {
+  type: 'blocks';
+  at: number;
+};
+/** @stable */
+interface ChatMessage {
+  id: string;
+  role: 'user' | 'assistant';
+  /**
+   * 消息正文。本 run 一个字也没产出时（例如模型开口前就被中止）**缺省**，
+   * 与「产出了空串」区分开——写空串会渲染出一个空白气泡（FR-20.4）。
+   */
+  text?: string;
+  ts: string;
+  /** user 消息携带的附件（旧会话文件无该字段） */
+  attachments?: ChatAttachmentMeta[];
+  /**
+   * 随消息持久化的系统提示（例如「图片超出数量上限，未发送 X」，FR-11.3）。
+   * 放在消息里而不是 toast：toast 会消失，用户回头就查不到这次到底发了什么。
+   * @experimental
+   */
+  notice?: string;
+  /** assistant 消息所属 run */
+  runId?: string;
+  /** 该 run 激活的技能（消息底部 badges） */
+  activeSkillNames?: string[];
+  /** 该 run 的工具调用序列（思维链工具行；按 trace 顺序） */
+  toolCalls?: ChatToolCall[];
+  /**
+   * 该 run 的思考段序列（0.10.0 UI-UX5 #32）：渲染时与 `toolCalls` 按 `at` 归并，
+   * 多张思考卡片按时间穿插在工具卡片之间。
+   * @experimental
+   */
+  thinkings?: ChatThinking[];
+  /**
+   * 该 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?: UiSpecSnapshot[];
+  /** 该 run 的待办清单终态（历史消息重放；未产生清单时缺省） */
+  todos?: TodoItem[];
+  /**
+   * 该 run 内发生的页面只读感知（需求 10 FR-10.5）。
+   * 随消息持久化而不只在运行中闪现——事后仍能查到「那一次它读了哪些区域」。
+   * @experimental
+   */
+  perceptions?: PerceptionRecord[];
+  /**
+   * 该 run 的大模型用量（0.10.0 UI-UX5 #47）：消息操作区图标右侧显示
+   * 输入输出合计 tokens（千分位）。上游不回报用量时缺省，不显示假数据。
+   * @experimental
+   */
+  usage?: ChatTokenUsage;
+  /**
+   * 发出本轮请求的模型条目 id（`RuntimeConfig.llm.entries[].id`）。
+   * 写在消息上而不是会话上：切换模型只对后续消息生效，已有消息的归属不能被改写。
+   */
+  model?: string;
+  /**
+   * 该轮的生命周期相位快照（FR-17.7）。不持久化它，live 状态一丢「运行细节」入口就消失，
+   * 表现为容器高度先减后增。
+   * @experimental
+   */
+  phases?: ChatRunPhase[];
+  /**
+   * 该轮发生的交互及其终态（FR-17.8）。交互卡归属发起它的那条消息，
+   * 后续结果另开新消息，而不是就地改写原表单。
+   * @experimental
+   */
+  interactions?: ChatInteractionRecord[];
+  /**
+   * 该轮提交的技能候选（FR-24.1）。数据来自 `$skillCandidate` 载荷，
+   * 不从模型复述的自然语言里解析。
+   * @experimental
+   */
+  candidates?: SkillCandidateMarker[];
+  /**
+   * 文字与 surface / blocks 的生成顺序（分册 17）。缺省时按 0.11.0 的两段式渲染。
+   * @experimental
+   */
+  contentParts?: ChatContentPart[];
+}
+/** @stable */
+interface ChatSessionMeta {
+  id: string;
+  createdAt: string;
+  title?: string;
+  /** 归档会话：列表分区展示，不参与默认选中 */
+  archived?: boolean;
+  /** 用户已手动重命名：后续 send 不再用首条消息覆盖标题 */
+  titleLocked?: boolean;
+}
+/**
+ * 会话列表页：除了数据，还得告诉 UI「为什么是空的」（FR-21.4 / FR-21.11）。 @experimental
+ */
+interface ChatSessionListResult {
+  items: ChatSessionMeta[];
+  nextCursor?: string;
+  /** `'ok'` = 正常列举；`'missing-root'` = 会话目录不存在（多半是 chatRoot 配错） */
+  source: 'ok' | 'missing-root';
+  /** 读不动而被跳过的会话文件名 */
+  skipped: readonly string[];
+}
+/** @stable */
+type ChatEvent = {
+  type: 'run-started';
+  runId: string;
+} | {
+  type: 'message-delta';
+  runId: string;
+  delta: string;
+} |
+/**
+ * 思考增量（0.10.0 UI-UX5 #32）：runtime 的 thinking-delta 原样转发。
+ * 模型不产出思考时一个事件也没有；UI 据事件有无决定渲不渲染思考卡片。
+ */
 {
   type: 'thinking-delta';
   runId: string;
@@ -803,287 +1172,27 @@ interface ChatbotConfig {
    * 依赖表，每次渲染新建一个箭头函数会把整个引擎重建掉。
    */
   fetchData?: (sourceId: string, params?: Record<string, unknown>) => Promise<unknown>;
-}
-//#endregion
-//#region src/core/hostAdapter.d.ts
-/**
- * 宿主装配口：chatbot 不感知环境（浏览器/Node），全部能力经此注入。
- * 页面动态技能来源同时是外部工具来源与外部技能提供者（同一对象两个 port）。
- * LLM 配置不在这里——它统一由 `RuntimeConfigStore` 承载（0.5.0 起）。
- * @stable
- */
-interface ChatbotHostAdapter {
-  storage: FileSystemProvider;
-  skillRoots: string[];
-  pageSkillSource?: ExternalToolSource & ExternalSkillProvider;
-  navigation: {
-    openConsole(): void;
-    /** 跳 console Traces 面板并定位该 run（v1.1；缺省时消息不渲染 View trace 入口） */
-    openConsoleTrace?(runId: string): void;
-    /** 打开治理面的审批队列并定位该候选（FR-24.2）；宿主未接治理面时不提供，入口随之不渲染 */
-    openConsoleCandidate?(candidateId: string): void;
-  };
-  /** 缺省 BrowserWorkerScriptExecutor（@webskill/browser）；Node 宿主可注入自己的执行器 */
-  executor?: ScriptExecutor;
   /**
-   * 页面只读感知策略（需求 10）。**只能在这里注入**：启用与否是宿主侧配置，
-   * 设置抽屉里没有也不会有开关（FR-10.1）——风险由部署方承担，
-   * 不应交给终端用户随手勾选。
-   * @experimental
-   */
-  pagePerception?: PagePerceptionPolicy;
-  /**
-   * 页面操作能力（需求 23）。**不注入即完全关闭**，与 `pagePerception` 分开：
-   * 可读不等于可操作。同样只能在这里注入——给终端用户一个「打开代操作」的开关
-   * 等于把安全边界交给最不了解它的人。
-   * @experimental
-   */
-  pageActions?: PageActionPolicy;
-  /**
-   * 读页面链接指向的文档（分册 22）。实现住在 `@webskill/browser`，
-   * 而 chatbot 不依赖它 —— 与 `pagePerception` 同一条装配规矩：宿主注入。
-   * 不注入即 `read_linked_document` 不注册。
-   */
-  linkedDocuments?: LinkedDocumentReader;
-  /** docx → 文本（`extractDocxText`）；不注入即 Word 文档明确报「本环境不支持」 */
-  docxExtractor?: DocxTextExtractor;
-  /** xlsx → 文本（`extractXlsxText`）；不注入即 Excel 工作簿明确报「本环境不支持」 */
-  xlsxExtractor?: XlsxTextExtractor;
-  /**
-   * PDF → 文本；**只用于直传被端点拒后的回退**（0.13.0 FR-22.1）。
-   * PDF 仍然默认直传，能读的端点拿到的还是原件；不注入即没有回退能力。
-   */
-  pdfExtractor?: PdfTextExtractor;
-  /** 文档读取留痕出口（FR-22.6） */
-  documentAudit?: {
-    append(event: {
-      type: string;
-      target: string;
-      data?: Record<string, unknown>;
-    }): Promise<unknown>;
-  };
-}
-//#endregion
-//#region src/core/chatEngine.d.ts
-/**
- * 条目能否真的发请求：云端要有端点或密钥，浏览器内置两者都不需要。
- *
- * 导出给 UI：选择器不用同一份判据的话，用户能选中一个空配置条目，
- * 而引擎静默回退到另一条——界面说在用 A、实际跑的是 B（UI-UX8 D1）。
- * @experimental
- */
-declare const isLlmEntryUsable: (entry: RuntimeLlmEntry) => boolean;
-/**
- * 选中条目 → 默认条目 → 首条；命中不可用条目时**回退到下一个可用条目**
- * （0.10.0 复核：选中项失效时宁可静默换用可用模型，也不能把 UI 锁死成
- * 「未配置」死胡同——引擎与 UI 共用同一判据，两边必须同进退）。
- * 全部不可用才 undefined（引擎走内置演示）。
- *
- * 导出给 UI 复用同一判据：composer 的「未配置模型」引导判定必须与引擎的
- * 实际挑选结果一致，否则会出现「UI 说有模型、引擎却走演示档」的错位（0.10.0 UI-UX5 #49-1）。
- * @experimental
- */
-declare function pickUsableLlmEntry(entries: readonly RuntimeLlmEntry[], defaultId: string | undefined, selectedId: string | undefined): RuntimeLlmEntry | undefined;
-/** 默认沙箱执行器的构造参数（adapter.executor 未注入时；executorFactory 替换点可见同一形状） @stable */
-interface SandboxExecutorDeps {
-  fs: FileSystemProvider;
-  sandbox?: SandboxMode;
-  networkPolicy?: NetworkPolicy;
-  capabilities?: BridgeCapabilities;
-  approvalScope?: ApprovalScope;
-  uiBridge?: UiBridge;
-  /** 缺省时 `.ts` 脚本按 `TOOL_UNSUPPORTED` 拒绝 */
-  typescript?: TypeScriptSupportOptions;
-}
-/**
- * 装配时（而非执行时）把 `sandbox.typescript` 转成执行器参数，让配置错误早暴露。
- * 只对绝对 URL 走 `RemoteUrlPolicy`：同源相对路径与打包器 specifier 不是出站请求。
- */
-/**
- * 由 `RuntimeConfig` 装出沙箱执行器依赖。
- *
- * 主链路与**评估链路**共用这一处（T-17-H）：此前评估侧只传 `fs`，
- * 于是评估里跑的技能不受沙箱、网络策略、能力与授权范围约束——
- * 那比「.ts 跑不了」严重得多（设计 17 §1.1a）。
- *
- * @experimental
- */
-declare function sandboxExecutorDeps(fs: FileSystemProvider, rc?: RuntimeConfig, uiBridge?: SandboxExecutorDeps['uiBridge']): SandboxExecutorDeps;
-/** @stable */
-interface ChatEngineOptions {
-  llm?: LlmClient;
-  loopConfig?: AgentLoopConfig;
-  chatRoot?: string;
-  /** 运行环境配置存储（P2）：#ensureReady 装配时 load()（默认值兜底）并按映射应用 */
-  runtimeConfig?: RuntimeConfigStore;
-  /** 初始渲染框架档（默认 'native'；运行中可 setRenderer 热切换） */
-  renderer?: RendererKind;
-  /**
-   * 注入 `render_ui` 工具，让模型面向 AI Component Catalog 生成声明式 UI。
-   *
-   * 注入了 `runtimeConfig` 时**以 `RuntimeConfig.agentCapabilities.generativeUi` 为准**，
-   * 本字段只在未接配置存储的宿主上生效（否则设置面板里的开关点了不算数）。
-   */
-  generativeUi?: boolean;
-  /** 沙箱执行器替换点（测试注入 spy 断言构造参数；缺省 BrowserWorkerScriptExecutor） */
-  executorFactory?: (deps: SandboxExecutorDeps) => ScriptExecutor;
-  /**
-   * 宿主声明的数据源取数入口（分册 16）。不注入即脚本上下文没有 `fetchData` 这个键。
+   * 宿主声明的数据源清单（0.14.0 分册 19）：透传给 `ChatEngineOptions.dataSources`。
+   * 用 `DataSourcePolicy.publicSources` 取，不要改传 `sources`——后者带 `target`，
+   * 结构子类型让这个赋值的类型检查能过，接口地址就静默进了模型上下文。
    *
-   * 装配点必须在宿主：策略本体 `DataSourcePolicy` 住在 `@webskill/agent`，
-   * 而数据源的目标地址是宿主自己的业务知识，chatbot 无从代为声明。
-   * 能力开关 `sandbox.capabilities.fetchData` 缺省关，注入了也还要宿主在配置里打开。
-   */
-  fetchData?: (sourceId: string, params?: Record<string, unknown>) => Promise<unknown>;
-  /**
-   * 会话落盘替换点（缺省 `FsSessionStore`，落在 `<chatRoot>/sessions`）。
-   * 宕主换自己的实现（如 IndexedDB）与测试统计端口读写量都走这里。
+   * **必须是稳定引用**（模块级或 `useMemo`）：同 `fetchData`，它进 `ChatEngine` 的依赖表。
+   * 源清单随用户配置变动的宿主传函数形式，引擎在每次激活时求值，改配置无须重建引擎。
    */
-  sessionStore?: SessionStore<ChatMessage>;
+  dataSources?: readonly DataSourceInfo[] | (() => readonly DataSourceInfo[]);
   /**
-   * 宿主已注册好钩子的执行器；装配时把 `RuntimeConfig.hooks` 应用到它再交给 runtime。
-   * 不注入即不挂钩子（与 0.0.2 行为一致）。
-   */
-  hooks?: HookRunner;
-  /**
-   * 治理 port 注入（F1）：把 `SkillStatePolicy` 的三个适配器接到本引擎装配的 runtime 上。
-   *
-   * 不注入即完全关闭，行为与 0.0.2 一致。装配点必须在宿主：chatbot 不能依赖
-   * `@webskill/governance`（它是可选治理层，且要求宿主提供治理根与审计存储）。
+   * 沙箱执行器替换点（分册 12）：透传给 `ChatEngineOptions.executorFactory`。
    *
-   * 三个一起给才形成闭环——只给 `skillOutcomeReporter` 会把技能标成 `quarantined`
-   * 却仍旧照常路由和执行，降级形同虚设。
-   */
-  governance?: ChatbotGovernancePorts;
-  /**
-   * 技能自动生成的候选收货端（需求 12 号）。与 `governance` 同理，装配点在宿主：
-   * `@webskill/governance` 的 `createCandidateSink()` 是现成实现。
+   * 需要自定义执行器的宿主**必须走这里，而不是 `ChatbotHostAdapter.executor`**：
+   * 后者是一个构造期就定死的实例，装配时会整个跳过 `RuntimeConfig.sandbox` 映射，
+   * 于是设置面板里的能力开关、网络策略、TypeScript 与授权范围全部点了不算数。
+   * 本替换点拿到的 `deps` 已由引擎按当前配置算好，宿主只需覆盖自己要换的那几项。
    *
-   * 开关另在 `RuntimeConfig.agentCapabilities.skillGeneration`（默认关）；
-   * 开关开但未注入本端口时，工具会把 `SKILL_GENERATION_DISABLED` 回给模型。
-   */
-  skillCandidates?: SkillCandidateSink;
-}
-/**
- * 对话框引擎：装配 WebSkillRuntime + 会话持久化 + 事件分发。
- * RuntimeConfig 的 load() 是异步的，runtime 在首次 send 前懒装配（#ensureReady）。
- * @stable
- */
-declare class ChatEngine {
-  #private;
-  readonly bridge: ReactBridgeState;
-  constructor(adapter: ChatbotHostAdapter, options?: ChatEngineOptions);
-  /** 当前待办清单快照（宿主可直读；实时更新订阅 `todo-changed` 事件） */
-  get todos(): readonly TodoItem[];
-  /** 当前渲染框架档 */
-  get renderer(): RendererKind;
-  /** 当前会话选中的模型条目 id；未显式切换过时为 undefined（走 `RuntimeConfig.llm.defaultId`） */
-  get modelId(): string | undefined;
-  /**
-   * 切换本会话后续消息使用的模型条目（需求 4）。传 `undefined` 回到配置里的默认项。
-   * 重装配 runtime 以换掉客户端；已落盘的消息不受影响。
-   */
-  setModel(entryId: string | undefined): void;
-  /** 会话文件所在目录：「存储未初始化」提示要把路径写给用户看 @experimental */
-  get sessionsRoot(): string;
-  /** 渲染框架热切换：复合桥按档分发，无需重装配 runtime（会话句柄保留） */
-  setRenderer(renderer: RendererKind): void;
-  /** 非 native 三档共用的交互通道（Chatbot 的 SpecInteraction 订阅/attach；core 只产出 catalog 节点树） */
-  get interactionChannel(): SpecInteractionChannel;
-  /** 探测 @a2ui/lit 是否安装（Appearance/设置区 A2UI 档置灰判定） */
-  probeA2uiAvailability(): Promise<boolean>;
-  onEvent(listener: (event: ChatEvent) => void): () => void;
-  /**
-   * 配置源变更后调用（LLM 设置 / RuntimeConfigStore 内容变化）：丢弃缓存的
-   * runtime/llm/会话句柄，下次 send 重新装配（RuntimeConfig 重新 load() 应用）
-   */
-  reloadConfig(): void;
-  /**
-   * 会话列表页。归档会话也返回：UI 自己分区展示。
-   * `limit` 不给默认值——缺省属于 `SessionStore` 实现，在这里兜底就等于只下推了一半。
-   */
-  listSessions(options?: PageQuery): Promise<ChatSessionListResult>;
-  /** `title` 缺省时会话先无标题，首条消息发出时再按内容补（FR-21.8） */
-  createSession(options?: {
-    title?: string;
-  }): Promise<ChatSessionMeta>;
-  /**
-   * 选中会话并取**最新**一页历史（页内时间升序）。
-   * 返回全量 `ChatMessage[]` 的旧签名已移除：长会话下它强迫每个调用方拿全量。
-   */
-  selectSession(id: string, options?: PageQuery): Promise<Page<ChatMessage>>;
-  /** 向历史方向再取一页；`cursor` 只能来自上一页的 `nextCursor` */
-  loadMoreMessages(cursor: string, options?: {
-    limit?: number;
-  }): Promise<Page<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` 内的路径读回并构造 `LlmContentPart[]`（FR-11.2）。
-   */
-  send(text: string, attachments?: readonly ChatAttachmentInput[]): Promise<void>;
-  /** 附件落盘根目录（composer 附件适配器写入，send 时读回） */
-  get attachmentsRoot(): string;
-  /** 取消进行中的 run（Composer Stop 按钮）；run 未找到/已结束返回 false */
-  cancel(runId: string): boolean;
-  /**
-   * 释放引擎：取消进行中的 run、退订全部事件、丢弃装配缓存。
-   * 宿主重挂组件时用它收尾；只是换配置的话用 `reloadConfig()`，不要 dispose。
-   */
-  dispose(): Promise<void>;
-  /** 列出 interrupted run（InterruptedBanner 数据源）；版本不受支持的项带 unsupported 标记 */
-  listInterrupted(): Promise<RunSnapshotListEntry[]>;
-  /**
-   * 恢复 interrupted run：等待中的交互重新进入 bridge.pending（UI 复用 InteractionForm），
-   * 完成后与 send 同路径（assistant 消息持久化 + run-completed + trace 落盘）。
-   */
-  resume(runId: string): Promise<void>;
-  /** 读取当前画像（FR-19.3：可见） @experimental */
-  readUserProfile(): Promise<UserProfile>;
-  /** 已记录的行为条数；设置面板用它告诉用户「清除」会删掉什么 @experimental */
-  countBehaviorRecords(): Promise<number>;
-  /** 删除单条画像结论（FR-19.3：可编辑可删除） @experimental */
-  deleteUserProfileEntry(id: string): Promise<UserProfile>;
-  /** 清除全部行为记录（FR-19.8）。与清除画像是两个独立操作 @experimental */
-  clearBehaviorRecords(): Promise<void>;
-  /** 清除提炼出的画像（FR-19.8） @experimental */
-  clearUserProfile(): Promise<void>;
-  /**
-   * 一并清除记录与画像，并销毁加密密钥（FR-19.8：关闭总开关时的「一并清除」）。
-   * 密钥留着就等于给残留密文留了一把能解开的钥匙。
+   * **必须是稳定引用**（模块级或 `useMemo`）：同 `fetchData`，它进 `ChatEngine` 的依赖表。
    * @experimental
    */
-  clearUserProfileData(): Promise<void>;
-  /**
-   * 手动提炼（FR-19.3）。与会话结束后的自动提炼同一条路径，
-   * 区别只在于这里的失败会抛给调用方——用户点了按钮就该看到结果。
-   * @experimental
-   */
-  refineUserProfile(): Promise<UserProfile>;
-  /** 导出画像（FR-19.7）。`excludeIds` 来自导出前的审阅界面 @experimental */
-  exportUserProfile(excludeIds?: readonly string[]): Promise<UserProfileExport>;
-  /** 导入前的差异（FR-19.7）：由 UI 展示并确认后才调用 `applyUserProfileImport` @experimental */
-  diffUserProfileImport(incoming: UserProfileExport): Promise<ReturnType<typeof diffUserProfile> & {
-    origin: string;
-  }>;
-  /** 确认后落库（FR-19.7） @experimental */
-  applyUserProfileImport(incoming: UserProfileExport): Promise<UserProfile>;
+  executorFactory?: (deps: SandboxExecutorDeps) => ScriptExecutor;
 }
 //#endregion
 //#region src/core/interactionBridge.d.ts
@@ -1238,7 +1347,6 @@ declare const chatbotDictionary: {
     'welcome.capability.transparency.title': string;
     'welcome.capability.transparency.description': string;
     'welcome.quickPrompts': string;
-    'welcome.dynamicPrompts': string;
     'message.copy': string;
     'message.copied': string;
     'message.retry': string;
@@ -1324,11 +1432,20 @@ declare const chatbotDictionary: {
     'interaction.pageAction.click': string;
     'interaction.pageAction.fill': string;
     'interaction.pageAction.submit': string;
+    'interaction.pageAction.select': string;
+    'interaction.pageAction.set': string;
+    'interaction.pageAction.attach': string;
     'interaction.pageAction.role.click': string;
     'interaction.pageAction.role.fill': string;
     'interaction.pageAction.role.submit': string;
+    'interaction.pageAction.role.select': string;
+    'interaction.pageAction.role.set': string;
+    'interaction.pageAction.role.attach': string;
+    'interaction.pageAction.remember': string;
     'interaction.pageAction.frame': string;
     'interaction.pageAction.elevated': string;
+    'interaction.downloadedFile.file': string;
+    'interaction.downloadedFile.remember': string;
     'interaction.traceEvidence.title': string;
     'interaction.traceEvidence.columnDraft': string;
     'interaction.traceEvidence.columnTrace': string;
@@ -1591,7 +1708,6 @@ declare const chatbotDictionary: {
     'welcome.capability.transparency.title': string;
     'welcome.capability.transparency.description': string;
     'welcome.quickPrompts': string;
-    'welcome.dynamicPrompts': string;
     'message.copy': string;
     'message.copied': string;
     'message.edit': string;
@@ -1677,11 +1793,20 @@ declare const chatbotDictionary: {
     'interaction.pageAction.click': string;
     'interaction.pageAction.fill': string;
     'interaction.pageAction.submit': string;
+    'interaction.pageAction.select': string;
+    'interaction.pageAction.set': string;
+    'interaction.pageAction.attach': string;
     'interaction.pageAction.role.click': string;
     'interaction.pageAction.role.fill': string;
     'interaction.pageAction.role.submit': string;
+    'interaction.pageAction.role.select': string;
+    'interaction.pageAction.role.set': string;
+    'interaction.pageAction.role.attach': string;
+    'interaction.pageAction.remember': string;
     'interaction.pageAction.frame': string;
     'interaction.pageAction.elevated': string;
+    'interaction.downloadedFile.file': string;
+    'interaction.downloadedFile.remember': string;
     'interaction.traceEvidence.title': string;
     'interaction.traceEvidence.columnDraft': string;
     'interaction.traceEvidence.columnTrace': string;
@@ -1947,7 +2072,6 @@ declare const useT: () => TranslateFn<{
     'welcome.capability.transparency.title': string;
     'welcome.capability.transparency.description': string;
     'welcome.quickPrompts': string;
-    'welcome.dynamicPrompts': string;
     'message.copy': string;
     'message.copied': string;
     'message.retry': string;
@@ -2033,11 +2157,20 @@ declare const useT: () => TranslateFn<{
     'interaction.pageAction.click': string;
     'interaction.pageAction.fill': string;
     'interaction.pageAction.submit': string;
+    'interaction.pageAction.select': string;
+    'interaction.pageAction.set': string;
+    'interaction.pageAction.attach': string;
     'interaction.pageAction.role.click': string;
     'interaction.pageAction.role.fill': string;
     'interaction.pageAction.role.submit': string;
+    'interaction.pageAction.role.select': string;
+    'interaction.pageAction.role.set': string;
+    'interaction.pageAction.role.attach': string;
+    'interaction.pageAction.remember': string;
     'interaction.pageAction.frame': string;
     'interaction.pageAction.elevated': string;
+    'interaction.downloadedFile.file': string;
+    'interaction.downloadedFile.remember': string;
     'interaction.traceEvidence.title': string;
     'interaction.traceEvidence.columnDraft': string;
     'interaction.traceEvidence.columnTrace': string;
@@ -2300,7 +2433,6 @@ declare const useT: () => TranslateFn<{
     'welcome.capability.transparency.title': string;
     'welcome.capability.transparency.description': string;
     'welcome.quickPrompts': string;
-    'welcome.dynamicPrompts': string;
     'message.copy': string;
     'message.copied': string;
     'message.edit': string;
@@ -2386,11 +2518,20 @@ declare const useT: () => TranslateFn<{
     'interaction.pageAction.click': string;
     'interaction.pageAction.fill': string;
     'interaction.pageAction.submit': string;
+    'interaction.pageAction.select': string;
+    'interaction.pageAction.set': string;
+    'interaction.pageAction.attach': string;
     'interaction.pageAction.role.click': string;
     'interaction.pageAction.role.fill': string;
     'interaction.pageAction.role.submit': string;
+    'interaction.pageAction.role.select': string;
+    'interaction.pageAction.role.set': string;
+    'interaction.pageAction.role.attach': string;
+    'interaction.pageAction.remember': string;
     'interaction.pageAction.frame': string;
     'interaction.pageAction.elevated': string;
+    'interaction.downloadedFile.file': string;
+    'interaction.downloadedFile.remember': string;
     'interaction.traceEvidence.title': string;
     'interaction.traceEvidence.columnDraft': string;
     'interaction.traceEvidence.columnTrace': string;
@@ -2878,6 +3019,6 @@ declare function ErrorCard({ code, message, loopLimits, onOpenSettings, onDismis
  * Version of the published `@webskill/chatbot` package, injected at build time.
  * @stable
  */
-declare const CHATBOT_VERSION = "0.10.0";
+declare const CHATBOT_VERSION = "0.11.0";
 //#endregion
 export { A2uiSurfaceHost, type A2uiSurfaceHostProps, A2uiSurfaceSnapshotHost, type A2uiSurfaceSnapshotHostProps, type AppearanceChange, CHATBOT_VERSION, type ChatAttachmentInput, type ChatAttachmentMeta, type ChatContentPart, ChatEngine, type ChatEngineOptions, type ChatEvent, type ChatInteractionRecord, type ChatLayout, type ChatMessage, type ChatRunPhase, type ChatSessionListResult, type ChatSessionMeta, type ChatTheme, type ChatThinking, type ChatTokenUsage, type ChatToolCall, Chatbot, type ChatbotConfig, type ChatbotGovernancePorts, type ChatbotHostAdapter, type ChatbotProps, CompositeUiBridge, type CompositeUiBridgeDeps, DEFAULT_RENDERER_CAPABILITIES, DEFAULT_RUNTIME_CONFIG_STORAGE_KEY, type DownloadableFile, ErrorCard, type ErrorCardProps, InteractionCard, type InteractionCardProps, InterruptedBanner, type InterruptedBannerProps, type Locale, type LocalizedText, OpenUiSurfaceHost, type OpenUiSurfaceHostProps, OpenUiSurfaceSnapshotHost, type OpenUiSurfaceSnapshotHostProps, type QuickPrompt, type QuickPromptIconName, type RendererCapability, type RendererKind, type ResolvedChatLayout, ResultBlockList, type ResultBlockListProps, ResultBlocksPro, type ResultBlocksProProps, type RunSnapshot, type RuntimeAppearanceConfig, type RuntimeConfig, type RuntimeConfigStore, type RuntimeQuickPrompt, type RuntimeRendererId, type SandboxExecutorDeps, type SettingsSectionId, SkillBadges, SpecInteraction, type SpecInteractionProps, VercelPayloadPreview, type VercelPayloadPreviewProps, VercelSurfaceHost, type VercelSurfaceHostProps, VercelSurfaceSnapshotHost, type VercelSurfaceSnapshotHostProps, chatbotDictionary, configureA2uiMarkdown, createLocalStorageRuntimeConfigStore, createMemoryRuntimeConfigStore, isLlmEntryUsable, pickUsableLlmEntry, probeA2uiAvailability, probeOpenUiAvailability, sandboxExecutorDeps, useT };