@webskill/chatbot 0.6.0 → 0.8.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { AgentLoopConfig, ApprovalScope, BridgeCapabilities, ExternalSkillProvider, ExternalToolSource, FileSystemProvider, HookRunner, InteractionRequest, InteractionResponse, LifecycleEventInit, LlmClient, NetworkPolicy, Page, PageQuery, RenderBlock, RenderResultRequest, RunSnapshot, RunSnapshotListEntry, RuntimePhase, RuntimeRun, ScriptExecutor, SessionStore, SkillCandidateMarker, SkillCatalogEntry, SkillIntegrityGuard, SkillOutcomeReporter, SkillStateGuard, UiBridge, UiSpecDrafts, UiSpecEvent, UiSpecSnapshot, UiSurfaceActionRequest, UiSurfaceActionResponse, UserProfile, UserProfileExport, WebSkillErrorCode, diffUserProfile } from "@webskill/sdk";
+import { AgentLoopConfig, ApprovalScope, BridgeCapabilities, DocxTextExtractor, ExternalSkillProvider, ExternalToolSource, FileSystemProvider, HookRunner, InteractionRequest, InteractionResponse, LifecycleEventInit, LinkedDocumentReader, LlmClient, NetworkPolicy, Page, PageQuery, RenderBlock, RenderResultRequest, RunSnapshot, RunSnapshotListEntry, RuntimePhase, RuntimeRun, ScriptExecutor, SessionStore, SkillCandidateMarker, SkillCatalogEntry, SkillIntegrityGuard, SkillOutcomeReporter, SkillStateGuard, UiBridge, UiSpecDrafts, UiSpecEvent, UiSpecSnapshot, UiSurfaceActionRequest, UiSurfaceActionResponse, UserProfile, UserProfileExport, WebSkillErrorCode, 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";
@@ -53,6 +53,10 @@ interface RuntimeLoopConfig {
   temperature?: number;
   toolResultMaxBytes: number;
   maxHistoryMessages: number;
+  /** `file` 分片的 base64 上限；超出即拒绝并说明，不截断（FR-23.4） */
+  maxDocumentBytes: number;
+  /** `document-text` 分片的字节上限；同样拒绝而不截断（FR-23.4） */
+  maxDocumentTextBytes: number;
 }
 interface RuntimeInteractionConfig {
   missingParams: 'user' | 'llm';
@@ -74,9 +78,22 @@ interface RuntimeSandboxConfig {
   networkPolicy: NetworkPolicy$1;
   capabilities: {
     readReference: CapabilityMode;
+    /** 同时管 readAsset 与 readAssetBinary */
+    readAsset: CapabilityMode;
     writeArtifact: CapabilityMode;
     confirm: CapabilityMode;
+    /**
+     * 脚本按宿主声明的数据源取数（分册 16）。
+     * 与 `readAsset` **相反**，缺省 `false`：它会出网，缺省开等于每个技能默认拿到出站能力。
+     */
+    fetchData: CapabilityMode;
   };
+  /**
+   * 单次取数结果的字节上限（分册 16）。超出即拒绝，**不截断**
+   * ——截断后的 JSON 解不出来，比拒绝更糟。结果回到脚本，不进模型上下文，
+   * 所以不受 `toolResultMaxBytes` 约束。
+   */
+  maxDataSourceBytes: number;
   /**
    * 出站 URL 准入策略（`RemoteUrlPolicy` 的可配置部分）：技能安装、MCP 端点连接
    * 这类由宿主发起的取数都按它判定。两项都默认关，即 https-only 且拒绝内网/环回。
@@ -129,6 +146,13 @@ interface RuntimeLlmEntry {
   model: string;
   requestTimeoutMs?: number;
   capabilities?: RuntimeLlmCapabilities;
+  /**
+   * Anthropic extended thinking 预算（0.10.0 遗留项 #1）：仅 anthropic 条目有意义；
+   * 设置面是开关，开启写入 `DEFAULT_THINKING_BUDGET_TOKENS`。
+   * 0.10.0 #40.4：缺省（undefined）视为**开启**（按默认预算），显式关闭存 0。
+   * @experimental
+   */
+  thinkingBudgetTokens?: number;
 }
 /** 模型列表 + 默认项。`defaultId` 由 `mergeRuntimeConfigDefaults` 归一到真实存在的条目 */
 interface RuntimeLlmSelection {
@@ -182,6 +206,17 @@ interface RuntimeAppearanceConfig {
  * 两者都会把图像随请求外发给模型提供方，属新增攻击面。
  * @experimental
  */
+/**
+ * 文档投放面（0.11.0 分册 18）。
+ *
+ * **只有一个闸门字段**。CSP 白名单不在这里：它由 viewer 路由的**响应头**
+ * 下发（FR-18.3 第 1 条），是宿主部署时调 `viewerCspHeader` 的入参；
+ * 浏览器侧的运行时配置改不动已经发出去的响应头，携在这里只会是个不生效的假开关。
+ */
+interface RuntimeDocumentSurfaceConfig {
+  /** 关着即没有这个投放面；开启还要求宿主额外提供一条 viewer 路由 */
+  enabled: boolean;
+}
 interface RuntimeMultimodalConfig {
   imageAttachments: boolean;
   /** 页面图像抓取总开关（FR-12.3）；关时感知只走纯文本路径 */
@@ -208,6 +243,15 @@ interface RuntimeUserProfileConfig {
   encrypted: boolean;
 }
 /** @experimental */
+interface RuntimeSkillStateConfig {
+  /**
+   * 技能连续失败自动隔离阈值（0.10.0 UI-UX5 #48-12；#49-2 起默认 5），
+   * 与 governance `SkillStatePolicy` 的缺省对齐。读点在 console 的
+   * GovernanceFacade 装配处（`failureThreshold`），守卫本身不读配置。
+   */
+  quarantineThreshold: number;
+}
+/** @experimental */
 interface RuntimeConfig {
   loop: RuntimeLoopConfig;
   interaction: RuntimeInteractionConfig;
@@ -223,7 +267,9 @@ interface RuntimeConfig {
   security: RuntimeSecurityConfig;
   appearance: RuntimeAppearanceConfig;
   multimodal: RuntimeMultimodalConfig;
+  documentSurface: RuntimeDocumentSurfaceConfig;
   userProfile: RuntimeUserProfileConfig;
+  skillState: RuntimeSkillStateConfig;
   /** 被用户删掉的自动模型条目 id（FR-14.3）：删一次就不该再自己长回来 */
   dismissedAutoEntries: readonly string[];
 }
@@ -272,7 +318,7 @@ declare function createMemoryRuntimeConfigStore(initial?: Partial<RuntimeConfig>
 //#endregion
 //#region src/core/attachmentKind.d.ts
 /** 附件在模型侧的内容形态（0.6.0 FR-11.2） @experimental */
-type ChatAttachmentKind = 'text' | 'image' | 'file';
+type ChatAttachmentKind = 'text' | 'image' | 'file' | 'document-text';
 //#endregion
 //#region src/core/types.d.ts
 /**
@@ -330,6 +376,11 @@ interface ChatToolCall {
   args?: string;
   /** 执行耗时（trace completed/failed 回填；live 由 started→终态计时） */
   durationMs?: number;
+  /**
+   * 开始时刻（epoch ms，0.10.0 UI-UX5 #32）。与思考段按时间穿插需要共同时钟；
+   * 旧会话消息没有该字段时工具卡片保持原有相对顺序。
+   */
+  at?: number;
   /**
    * failed 时的结构化错误码（如 `TOOL_NOT_ALLOWED`）。
    * 「被策略拒绝」与「执行失败」在 UI 上是两回事，靠错误码区分而不是解析文案。
@@ -365,6 +416,8 @@ interface ChatRunPhase {
   endedAt?: number;
   /** 由结构化 `LifecycleEvent.data` 派生的一句摘要 */
   note?: string;
+  /** fail 相位的具体说明：`reason` 只有七种取值，说不出「哪个上限、哪个模型」 */
+  detail?: string;
 }
 /** 本轮发生的一次已提交交互（FR-17.8：提交后表单保留所填值） @experimental */
 interface ChatInteractionRecord {
@@ -373,6 +426,28 @@ interface ChatInteractionRecord {
   /** 提交时的表单值；文件类字段已在引擎侧脱敏 */
   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;
+}
 /** @stable */
 interface ChatMessage {
   id: string;
@@ -397,6 +472,12 @@ interface ChatMessage {
   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）。
@@ -412,6 +493,12 @@ interface ChatMessage {
    * @experimental
    */
   perceptions?: PerceptionRecord[];
+  /**
+   * 该 run 的大模型用量（0.10.0 UI-UX5 #47）：消息操作区图标右侧显示
+   * 输入输出合计 tokens（千分位）。上游不回报用量时缺省，不显示假数据。
+   * @experimental
+   */
+  usage?: ChatTokenUsage;
   /**
    * 发出本轮请求的模型条目 id（`RuntimeConfig.llm.entries[].id`）。
    * 写在消息上而不是会话上：切换模型只对后续消息生效，已有消息的归属不能被改写。
@@ -465,6 +552,15 @@ type ChatEvent = {
   type: 'message-delta';
   runId: string;
   delta: string;
+} |
+/**
+ * 思考增量（0.10.0 UI-UX5 #32）：runtime 的 thinking-delta 原样转发。
+ * 模型不产出思考时一个事件也没有；UI 据事件有无决定渲不渲染思考卡片。
+ */
+{
+  type: 'thinking-delta';
+  runId: string;
+  delta: string;
 } | {
   type: 'message-complete';
   message: ChatMessage;
@@ -565,7 +661,8 @@ interface ChatbotConfig {
   quickPrompts?: string[];
   /**
    * 开启后模型多一个 `render_ui` 工具，可面向 AI Component Catalog 直接生成声明式 UI。
-   * 默认关：工具描述 + 入参 schema 约 14 KB，会计入每一次请求。
+   * 默认关：工具描述 + 入参 schema 约 34 KB，会计入每一次请求。
+   * 数字的单一来源是 `@webskill/ui` 的 `catalog/budget.ts`（实测终态 12 744 + 21 470）。
    *
    * 接了 `runtimeConfig` 时以 `RuntimeConfig.agentCapabilities.generativeUi` 为准
    * （设置抽屉里的开关就是它），本字段只在未接配置存储的宿主上生效。
@@ -584,6 +681,14 @@ interface ChatbotConfig {
    * `SKILL_GENERATION_DISABLED`，不弹确认框、不产生候选。
    */
   skillCandidates?: SkillCandidateSink;
+  /**
+   * 宿主声明的数据源取数入口（分册 16）：透传给 `ChatEngineOptions.fetchData`。
+   * 不注入即脚本上下文没有 `fetchData` 这个键。
+   *
+   * **必须是稳定引用**（模块级或 `useMemo`）：它进 `ChatEngine` 的 `useMemo`
+   * 依赖表，每次渲染新建一个箭头函数会把整个引擎重建掉。
+   */
+  fetchData?: (sourceId: string, params?: Record<string, unknown>) => Promise<unknown>;
 }
 //#endregion
 //#region src/core/hostAdapter.d.ts
@@ -620,9 +725,44 @@ interface ChatbotHostAdapter {
    * @experimental
    */
   pageActions?: PageActionPolicy;
+  /**
+   * 读页面链接指向的文档（分册 22）。实现住在 `@webskill/browser`，
+   * 而 chatbot 不依赖它 —— 与 `pagePerception` 同一条装配规矩：宿主注入。
+   * 不注入即 `read_linked_document` 不注册。
+   */
+  linkedDocuments?: LinkedDocumentReader;
+  /** docx → 文本（`extractDocxText`）；不注入即 Word 文档明确报「本环境不支持」 */
+  docxExtractor?: DocxTextExtractor;
+  /** 文档读取留痕出口（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;
@@ -666,6 +806,14 @@ interface ChatEngineOptions {
   generativeUi?: boolean;
   /** 沙箱执行器替换点（测试注入 spy 断言构造参数；缺省 BrowserWorkerScriptExecutor） */
   executorFactory?: (deps: SandboxExecutorDeps) => ScriptExecutor;
+  /**
+   * 宿主声明的数据源取数入口（分册 16）。不注入即脚本上下文没有 `fetchData` 这个键。
+   *
+   * 装配点必须在宿主：策略本体 `DataSourcePolicy` 住在 `@webskill/agent`，
+   * 而数据源的目标地址是宿主自己的业务知识，chatbot 无从代为声明。
+   * 能力开关 `sandbox.capabilities.fetchData` 缺省关，注入了也还要宿主在配置里打开。
+   */
+  fetchData?: (sourceId: string, params?: Record<string, unknown>) => Promise<unknown>;
   /**
    * 会话落盘替换点（缺省 `FsSessionStore`，落在 `<chatRoot>/sessions`）。
    * 宕主换自己的实现（如 IndexedDB）与测试统计端口读写量都走这里。
@@ -918,6 +1066,7 @@ declare const chatbotDictionary: {
     'header.console': string;
     'header.theme.light': string;
     'header.theme.dark': string;
+    'header.language': string;
     'session.title': string;
     'session.new': string;
     'session.searchPlaceholder': string;
@@ -934,6 +1083,11 @@ declare const chatbotDictionary: {
     'session.delete.confirmTitle': string;
     'session.delete.confirmDescription': string;
     'common.cancel': string;
+    'toast.saved': string;
+    'toast.applied': string;
+    'toast.couldNotSave': string;
+    'toast.undo': string;
+    'toast.dismiss': string;
     'session.rename': string;
     'session.renameInput': string;
     'session.archive': string;
@@ -963,7 +1117,9 @@ declare const chatbotDictionary: {
     'message.deleted.title': string;
     'message.deleted.description': string;
     'message.viewTrace': string;
+    'message.tokens': string;
     'message.skillsUsed': string;
+    'message.skill': string;
     'message.edit': string;
     'message.editSend': string;
     'message.editCancel': string;
@@ -986,9 +1142,10 @@ declare const chatbotDictionary: {
     'cot.thinking': string;
     'cot.thought': string;
     'cot.summary': string;
-    'cot.reasoning': string;
     'cot.working': string;
+    'thinking.title': string;
     'trace.title': string;
+    'trace.flow': string;
     'trace.runId': string;
     'trace.runId.copy': string;
     'trace.runId.copied': string;
@@ -1034,6 +1191,7 @@ declare const chatbotDictionary: {
     'interaction.authorize.description': string;
     'interaction.authorize.capability': string;
     'interaction.authorize.details': string;
+    'skillGeneration.confirm': string;
     'interaction.pageAction.click': string;
     'interaction.pageAction.fill': string;
     'interaction.pageAction.submit': string;
@@ -1052,6 +1210,8 @@ declare const chatbotDictionary: {
     'surface.removeItem': string;
     'surface.arrayFirstItemOnly': string;
     'surface.readOnlySnapshot': string;
+    'surface.suggested': string;
+    'surface.useSuggestion': string;
     'interaction.wait': string;
     'interaction.wait.inPanel': string;
     'interaction.wait.fallback': string;
@@ -1081,15 +1241,21 @@ declare const chatbotDictionary: {
     'composer.attachment.kind.text': string;
     'composer.attachment.kind.image': string;
     'composer.attachment.kind.file': string;
+    'composer.attachment.kind.document-text': string;
     'composer.attachment.compressed': string;
     'composer.model': string;
+    'composer.model.unconfigured': string;
     'composer.model.demo': string;
+    'composer.noModel.title': string;
+    'composer.noModel.description': string;
+    'composer.noModel.configure': string;
     'capability.group': string;
     'composer.pageCapture': string;
     'composer.pageCapture.disabled.setting': string;
     'composer.pageCapture.disabled.model': string;
     'composer.addAttachment.imagesOff': string;
     'composer.addAttachment.modelNoImages': string;
+    'attachment.imagesDropped': string;
     'composer.dictate': string;
     'composer.dictate.stop': string;
     'composer.dictate.recording': string;
@@ -1239,6 +1405,7 @@ declare const chatbotDictionary: {
     'header.console': string;
     'header.theme.light': string;
     'header.theme.dark': string;
+    'header.language': string;
     'session.title': string;
     'session.new': string;
     'session.searchPlaceholder': string;
@@ -1255,6 +1422,11 @@ declare const chatbotDictionary: {
     'session.delete.confirmTitle': string;
     'session.delete.confirmDescription': string;
     'common.cancel': string;
+    'toast.saved': string;
+    'toast.applied': string;
+    'toast.couldNotSave': string;
+    'toast.undo': string;
+    'toast.dismiss': string;
     'session.rename': string;
     'session.renameInput': string;
     'session.archive': string;
@@ -1287,7 +1459,9 @@ declare const chatbotDictionary: {
     'message.deleted.title': string;
     'message.deleted.description': string;
     'message.viewTrace': string;
+    'message.tokens': string;
     'message.skillsUsed': string;
+    'message.skill': string;
     'capability.tools.on': string;
     'capability.tools.off': string;
     'capability.images.on': string;
@@ -1307,9 +1481,10 @@ declare const chatbotDictionary: {
     'cot.thinking': string;
     'cot.thought': string;
     'cot.summary': string;
-    'cot.reasoning': string;
     'cot.working': string;
+    'thinking.title': string;
     'trace.title': string;
+    'trace.flow': string;
     'trace.runId': string;
     'trace.runId.copy': string;
     'trace.runId.copied': string;
@@ -1355,6 +1530,7 @@ declare const chatbotDictionary: {
     'interaction.authorize.description': string;
     'interaction.authorize.capability': string;
     'interaction.authorize.details': string;
+    'skillGeneration.confirm': string;
     'interaction.pageAction.click': string;
     'interaction.pageAction.fill': string;
     'interaction.pageAction.submit': string;
@@ -1373,6 +1549,8 @@ declare const chatbotDictionary: {
     'surface.removeItem': string;
     'surface.arrayFirstItemOnly': string;
     'surface.readOnlySnapshot': string;
+    'surface.suggested': string;
+    'surface.useSuggestion': string;
     'interaction.wait': string;
     'interaction.wait.inPanel': string;
     'interaction.wait.fallback': string;
@@ -1402,15 +1580,21 @@ declare const chatbotDictionary: {
     'composer.attachment.kind.text': string;
     'composer.attachment.kind.image': string;
     'composer.attachment.kind.file': string;
+    'composer.attachment.kind.document-text': string;
     'composer.attachment.compressed': string;
     'composer.model': string;
+    'composer.model.unconfigured': string;
     'composer.model.demo': string;
+    'composer.noModel.title': string;
+    'composer.noModel.description': string;
+    'composer.noModel.configure': string;
     'capability.group': string;
     'composer.pageCapture': string;
     'composer.pageCapture.disabled.setting': string;
     'composer.pageCapture.disabled.model': string;
     'composer.addAttachment.imagesOff': string;
     'composer.addAttachment.modelNoImages': string;
+    'attachment.imagesDropped': string;
     'composer.dictate': string;
     'composer.dictate.stop': string;
     'composer.dictate.recording': string;
@@ -1563,6 +1747,7 @@ declare const useT: () => TranslateFn<{
     'header.console': string;
     'header.theme.light': string;
     'header.theme.dark': string;
+    'header.language': string;
     'session.title': string;
     'session.new': string;
     'session.searchPlaceholder': string;
@@ -1579,6 +1764,11 @@ declare const useT: () => TranslateFn<{
     'session.delete.confirmTitle': string;
     'session.delete.confirmDescription': string;
     'common.cancel': string;
+    'toast.saved': string;
+    'toast.applied': string;
+    'toast.couldNotSave': string;
+    'toast.undo': string;
+    'toast.dismiss': string;
     'session.rename': string;
     'session.renameInput': string;
     'session.archive': string;
@@ -1608,7 +1798,9 @@ declare const useT: () => TranslateFn<{
     'message.deleted.title': string;
     'message.deleted.description': string;
     'message.viewTrace': string;
+    'message.tokens': string;
     'message.skillsUsed': string;
+    'message.skill': string;
     'message.edit': string;
     'message.editSend': string;
     'message.editCancel': string;
@@ -1631,9 +1823,10 @@ declare const useT: () => TranslateFn<{
     'cot.thinking': string;
     'cot.thought': string;
     'cot.summary': string;
-    'cot.reasoning': string;
     'cot.working': string;
+    'thinking.title': string;
     'trace.title': string;
+    'trace.flow': string;
     'trace.runId': string;
     'trace.runId.copy': string;
     'trace.runId.copied': string;
@@ -1679,6 +1872,7 @@ declare const useT: () => TranslateFn<{
     'interaction.authorize.description': string;
     'interaction.authorize.capability': string;
     'interaction.authorize.details': string;
+    'skillGeneration.confirm': string;
     'interaction.pageAction.click': string;
     'interaction.pageAction.fill': string;
     'interaction.pageAction.submit': string;
@@ -1697,6 +1891,8 @@ declare const useT: () => TranslateFn<{
     'surface.removeItem': string;
     'surface.arrayFirstItemOnly': string;
     'surface.readOnlySnapshot': string;
+    'surface.suggested': string;
+    'surface.useSuggestion': string;
     'interaction.wait': string;
     'interaction.wait.inPanel': string;
     'interaction.wait.fallback': string;
@@ -1726,15 +1922,21 @@ declare const useT: () => TranslateFn<{
     'composer.attachment.kind.text': string;
     'composer.attachment.kind.image': string;
     'composer.attachment.kind.file': string;
+    'composer.attachment.kind.document-text': string;
     'composer.attachment.compressed': string;
     'composer.model': string;
+    'composer.model.unconfigured': string;
     'composer.model.demo': string;
+    'composer.noModel.title': string;
+    'composer.noModel.description': string;
+    'composer.noModel.configure': string;
     'capability.group': string;
     'composer.pageCapture': string;
     'composer.pageCapture.disabled.setting': string;
     'composer.pageCapture.disabled.model': string;
     'composer.addAttachment.imagesOff': string;
     'composer.addAttachment.modelNoImages': string;
+    'attachment.imagesDropped': string;
     'composer.dictate': string;
     'composer.dictate.stop': string;
     'composer.dictate.recording': string;
@@ -1884,6 +2086,7 @@ declare const useT: () => TranslateFn<{
     'header.console': string;
     'header.theme.light': string;
     'header.theme.dark': string;
+    'header.language': string;
     'session.title': string;
     'session.new': string;
     'session.searchPlaceholder': string;
@@ -1900,6 +2103,11 @@ declare const useT: () => TranslateFn<{
     'session.delete.confirmTitle': string;
     'session.delete.confirmDescription': string;
     'common.cancel': string;
+    'toast.saved': string;
+    'toast.applied': string;
+    'toast.couldNotSave': string;
+    'toast.undo': string;
+    'toast.dismiss': string;
     'session.rename': string;
     'session.renameInput': string;
     'session.archive': string;
@@ -1932,7 +2140,9 @@ declare const useT: () => TranslateFn<{
     'message.deleted.title': string;
     'message.deleted.description': string;
     'message.viewTrace': string;
+    'message.tokens': string;
     'message.skillsUsed': string;
+    'message.skill': string;
     'capability.tools.on': string;
     'capability.tools.off': string;
     'capability.images.on': string;
@@ -1952,9 +2162,10 @@ declare const useT: () => TranslateFn<{
     'cot.thinking': string;
     'cot.thought': string;
     'cot.summary': string;
-    'cot.reasoning': string;
     'cot.working': string;
+    'thinking.title': string;
     'trace.title': string;
+    'trace.flow': string;
     'trace.runId': string;
     'trace.runId.copy': string;
     'trace.runId.copied': string;
@@ -2000,6 +2211,7 @@ declare const useT: () => TranslateFn<{
     'interaction.authorize.description': string;
     'interaction.authorize.capability': string;
     'interaction.authorize.details': string;
+    'skillGeneration.confirm': string;
     'interaction.pageAction.click': string;
     'interaction.pageAction.fill': string;
     'interaction.pageAction.submit': string;
@@ -2018,6 +2230,8 @@ declare const useT: () => TranslateFn<{
     'surface.removeItem': string;
     'surface.arrayFirstItemOnly': string;
     'surface.readOnlySnapshot': string;
+    'surface.suggested': string;
+    'surface.useSuggestion': string;
     'interaction.wait': string;
     'interaction.wait.inPanel': string;
     'interaction.wait.fallback': string;
@@ -2047,15 +2261,21 @@ declare const useT: () => TranslateFn<{
     'composer.attachment.kind.text': string;
     'composer.attachment.kind.image': string;
     'composer.attachment.kind.file': string;
+    'composer.attachment.kind.document-text': string;
     'composer.attachment.compressed': string;
     'composer.model': string;
+    'composer.model.unconfigured': string;
     'composer.model.demo': string;
+    'composer.noModel.title': string;
+    'composer.noModel.description': string;
+    'composer.noModel.configure': string;
     'capability.group': string;
     'composer.pageCapture': string;
     'composer.pageCapture.disabled.setting': string;
     'composer.pageCapture.disabled.model': string;
     'composer.addAttachment.imagesOff': string;
     'composer.addAttachment.modelNoImages': string;
+    'attachment.imagesDropped': string;
     'composer.dictate': string;
     'composer.dictate.stop': string;
     'composer.dictate.recording': string;
@@ -2228,7 +2448,7 @@ interface AppearanceChange {
  * 不在其中（AC-20.7 按「无未覆盖的配置类 leaf」执行，见偏差 D-15）。
  * @experimental
  */
-type SettingsSectionId = 'settings.runtime' | 'settings.sandbox' | 'settings.genui' | 'settings.trust' | 'settings.privacy' | 'settings.appearance' | 'connections.models' | 'connections.page' | 'connections.mcp';
+type SettingsSectionId = 'settings.runtime' | 'settings.sandbox' | 'settings.genui' | 'settings.trust' | 'settings.privacy' | 'settings.appearance' | 'connections.models' | 'connections.webmcp' | 'connections.page' | 'connections.mcp';
 //#endregion
 //#region src/react/useChatLayout.d.ts
 /** 宿主可指定的布局档；auto 按容器尺寸判定 @stable */
@@ -2242,11 +2462,12 @@ interface ChatbotProps {
   adapter: ChatbotHostAdapter;
   config?: ChatbotConfig;
   /**
-   * 界面语言（默认 'en'）。**传了 `config.runtimeConfig` 时本属性被忽略**：
+   * 界面语言（默认 'zh'，0.10.0 UI-UX5 #1：SDK 缺省中文）。
+   * **传了 `config.runtimeConfig` 时本属性被忽略**：
    * 0.6.0 起外观配置的唯一真值源是配置存储（FR-20.1）。
    */
   locale?: Locale;
-  /** 主题（默认 'light'）。同上：有配置源时被忽略 */
+  /** 主题（默认 'dark'，0.10.0 UI-UX5 #1：SDK 缺省深色）。同上：有配置源时被忽略 */
   theme?: ChatTheme;
   /** 交互渲染框架档（默认 'native'；'a2ui' 需宿主安装 optional peer @a2ui/lit） */
   renderer?: RendererKind;
@@ -2256,7 +2477,6 @@ interface ChatbotProps {
   surfaceRegistry?: SurfaceRegistry;
   /** 布局档（默认 'auto'：按容器尺寸在 fullscreen / embedded / mobile 之间判定） */
   layout?: ChatLayout;
-  onAppearanceChange?(next: AppearanceChange): void;
   /**
    * 打开配置面（FR-20.4）。配置面本身已迁到 console，chatbot 只负责发出这个请求；
    * 宿主不接就不渲染任何「打开设置」出口——给一个点了没反应的按钮更糟。
@@ -2274,7 +2494,7 @@ interface ChatbotProps {
  * presentation shell and accessible thread primitives.
  * @stable
  */
-declare function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, renderer: rendererProp, dictationLang: dictationLangProp, surfaceRegistry, layout, onAppearanceChange, onOpenSettings, onEngineReady }: ChatbotProps): import("react").JSX.Element;
+declare function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, renderer: rendererProp, dictationLang: dictationLangProp, surfaceRegistry, layout, onOpenSettings, onEngineReady }: ChatbotProps): import("react").JSX.Element;
 //#endregion
 //#region src/react/A2uiSurfaceHost.d.ts
 /** @experimental */
@@ -2458,6 +2678,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.6.0";
+declare const CHATBOT_VERSION = "0.8.0";
 //#endregion
-export { A2uiSurfaceHost, type A2uiSurfaceHostProps, A2uiSurfaceSnapshotHost, type A2uiSurfaceSnapshotHostProps, type AppearanceChange, CHATBOT_VERSION, type ChatAttachmentInput, type ChatAttachmentMeta, ChatEngine, type ChatEngineOptions, type ChatEvent, type ChatInteractionRecord, type ChatLayout, type ChatMessage, type ChatRunPhase, type ChatSessionListResult, type ChatSessionMeta, type ChatTheme, 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, OpenUiSurfaceHost, type OpenUiSurfaceHostProps, OpenUiSurfaceSnapshotHost, type OpenUiSurfaceSnapshotHostProps, type RendererCapability, type RendererKind, type ResolvedChatLayout, ResultBlockList, type ResultBlockListProps, ResultBlocksPro, type ResultBlocksProProps, type RunSnapshot, type RuntimeAppearanceConfig, type RuntimeConfig, type RuntimeConfigStore, type RuntimeRendererId, type SandboxExecutorDeps, type SettingsSectionId, SkillBadges, SpecInteraction, type SpecInteractionProps, VercelPayloadPreview, type VercelPayloadPreviewProps, VercelSurfaceHost, type VercelSurfaceHostProps, VercelSurfaceSnapshotHost, type VercelSurfaceSnapshotHostProps, chatbotDictionary, configureA2uiMarkdown, createLocalStorageRuntimeConfigStore, createMemoryRuntimeConfigStore, probeA2uiAvailability, probeOpenUiAvailability, sandboxExecutorDeps, useT };
+export { A2uiSurfaceHost, type A2uiSurfaceHostProps, A2uiSurfaceSnapshotHost, type A2uiSurfaceSnapshotHostProps, type AppearanceChange, CHATBOT_VERSION, type ChatAttachmentInput, type ChatAttachmentMeta, 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, OpenUiSurfaceHost, type OpenUiSurfaceHostProps, OpenUiSurfaceSnapshotHost, type OpenUiSurfaceSnapshotHostProps, type RendererCapability, type RendererKind, type ResolvedChatLayout, ResultBlockList, type ResultBlockListProps, ResultBlocksPro, type ResultBlocksProProps, type RunSnapshot, type RuntimeAppearanceConfig, type RuntimeConfig, type RuntimeConfigStore, 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 };