@webskill/chatbot 0.2.0 → 0.3.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, ScriptExecutor, SessionStore, SkillCatalogEntry, SkillIntegrityGuard, SkillOutcomeReporter, SkillStateGuard, UiBridge, UiSpecDrafts, UiSpecEvent, UiSpecSnapshot, UiSurfaceActionRequest, UiSurfaceActionResponse } from "@webskill/sdk";
+import { AgentLoopConfig, ApprovalScope, BridgeCapabilities, ExternalSkillProvider, ExternalToolSource, FileSystemProvider, HookRunner, InteractionRequest, InteractionResponse, LifecycleEventInit, LlmClient, NetworkPolicy, Page, PageQuery, RenderBlock, RenderResultRequest, RunSnapshot, RunSnapshotListEntry, RuntimePhase, ScriptExecutor, SessionStore, SkillCatalogEntry, SkillIntegrityGuard, SkillOutcomeReporter, SkillStateGuard, UiBridge, UiSpecDrafts, UiSpecEvent, UiSpecSnapshot, UiSurfaceActionRequest, UiSurfaceActionResponse, UserProfile, UserProfileEntry, 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 { PagePerceptionPolicy, PerceptionRecord, SkillCandidateSink, TodoItem } from "@webskill/sdk/agent";
@@ -103,6 +103,18 @@ interface RuntimeRemoteUrlConfig {
 }
 /** `chrome-builtin` 走浏览器 Prompt API，无端点与密钥；其余三档是云端 HTTP 协议 */
 type RuntimeLlmProvider = 'openai-compatible' | 'anthropic' | 'google' | 'chrome-builtin';
+/**
+ * 单个模型的能力声明（FR-11.4 / FR-14.2）。`image` 缺省视为 `false`：
+ * 猜测支持会把图片发给纯文本模型，拿到的是 provider 的不可读报错。
+ * `tools` 反过来，缺省视为 `true`：云端模型几乎都支持，默认关会把存量配置里
+ * 没标能力的条目全部降级成纯对话。
+ * @experimental
+ */
+interface RuntimeLlmCapabilities {
+  image: boolean;
+  /** 是否支持原生工具调用；false 时 Agent 走纯对话路径 */
+  tools: boolean;
+}
 /**
  * 单个模型条目。`id` 稳定，会话记录与消息归属存的是它，用户改名不影响历史；
  * `label` 只用于展示——同一个 `model` 可能配了两个不同的 `baseUrl`（公司代理与直连），
@@ -116,6 +128,7 @@ interface RuntimeLlmEntry {
   apiKey?: string;
   model: string;
   requestTimeoutMs?: number;
+  capabilities?: RuntimeLlmCapabilities;
 }
 /** 模型列表 + 默认项。`defaultId` 由 `mergeRuntimeConfigDefaults` 归一到真实存在的条目 */
 interface RuntimeLlmSelection {
@@ -129,8 +142,6 @@ interface RuntimeLlmSelection {
  * `skillGeneration`：技能自动生成，默认**关闭**——会把对话内容写进持久化的候选，
  * 属于新增攻击面（AC-G7 判据一）。
  * `generativeUi`：生成式 UI，默认**关闭**——catalog 描述约 14 KB 计入每次请求。
- * `formAutofill`：跨会话表单自动填充，默认**关闭**（FR-5.10）——会把用户亲手填的内容
- * （可能是手机号、地址）跨会话持久化，属新增攻击面。
  * `uiPresets`：开放给模型的场景预设，默认全开——预设本体按需加载，
  * 只有名字与一行摘要计入请求；置空列表等于完全关闭预设。
  */
@@ -138,7 +149,6 @@ interface RuntimeAgentCapabilitiesConfig {
   todo: boolean;
   skillGeneration: boolean;
   generativeUi: boolean;
-  formAutofill: boolean;
   /** 串行委派（FR-11.8）：默认关。一句话可能展开成多个子 run，调用量对用户不可预期 */
   delegation: boolean;
   uiPresets: string[];
@@ -152,6 +162,51 @@ type UnsignedSkillPolicy = 'allow' | 'warn' | 'deny';
 interface RuntimeSecurityConfig {
   unsignedSkills: UnsignedSkillPolicy;
 }
+/** 生成式 UI 的渲染器档位。ui-kit 不依赖 `@webskill/ui`，因此这里写字面量联合 @experimental */
+type RuntimeRendererId = 'native' | 'a2ui' | 'openui' | 'vercel';
+/**
+ * 外观配置（0.6.0 FR-20.1）。0.5.x 之前外观由宿主自持并单独存一份，
+ * 导致 chatbot 与 console 各看各的；纳入 `RuntimeConfig` 后两端共用同一份。
+ * `dictationLang` 只对 chatbot 有意义（console 无语音输入），但同属外观段。
+ * @experimental
+ */
+interface RuntimeAppearanceConfig {
+  theme: 'light' | 'dark';
+  locale: Locale;
+  renderer: RuntimeRendererId;
+  dictationLang: string;
+}
+/**
+ * 多模态输入配置（0.6.0 FR-11.3 / FR-11.6 / FR-12.3）。
+ * `imageAttachments` 与 `pageImageCapture` 默认都关（AC-G5）：
+ * 两者都会把图像随请求外发给模型提供方，属新增攻击面。
+ * @experimental
+ */
+interface RuntimeMultimodalConfig {
+  imageAttachments: boolean;
+  /** 页面图像抓取总开关（FR-12.3）；关时感知只走纯文本路径 */
+  pageImageCapture: boolean;
+  /** 附件与取像共用 */
+  maxImageBytes: number;
+  /** 附件与取像共用 */
+  maxImagesPerMessage: number;
+}
+/**
+ * 用户画像配置（0.6.0 FR-19.6）。`enabled` 默认**关**（AC-G5）：
+ * 开启后会把用户的提问与填写持久化到本地，属新增攻击面；
+ * `encrypted` 默认**开**——它不新增采集，只决定已采集的数据怎么落盘，默认明文无正当理由。
+ * chatbot 与 console 共用这一份。
+ * @experimental
+ */
+interface RuntimeUserProfileConfig {
+  enabled: boolean;
+  /** 画像注入系统提示的字节上限（FR-19.4） */
+  injectMaxBytes: number;
+  /** 行为记录容量上限，超出淘汰最旧（FR-19.2） */
+  recordLimit: number;
+  /** 本地存储加密（FR-19.5） */
+  encrypted: boolean;
+}
 /** @experimental */
 interface RuntimeConfig {
   loop: RuntimeLoopConfig;
@@ -166,6 +221,11 @@ interface RuntimeConfig {
   llm: RuntimeLlmSelection;
   agentCapabilities: RuntimeAgentCapabilitiesConfig;
   security: RuntimeSecurityConfig;
+  appearance: RuntimeAppearanceConfig;
+  multimodal: RuntimeMultimodalConfig;
+  userProfile: RuntimeUserProfileConfig;
+  /** 被用户删掉的自动模型条目 id（FR-14.3）：删一次就不该再自己长回来 */
+  dismissedAutoEntries: readonly string[];
 }
 /** @experimental */
 interface RuntimeConfigStore {
@@ -178,44 +238,41 @@ interface RuntimeConfigStore {
   load(): Promise<RuntimeConfig>;
   save(config: RuntimeConfig): Promise<void>;
   reset(): Promise<void>;
+  /**
+   * Subscribes to configuration changes; returns an unsubscribe function.
+   * Optional: stores without it degrade to the previous behaviour where hosts
+   * remount consumers after a save.
+   */
+  subscribe?(listener: () => void): () => void;
 }
 //#endregion
-//#region ../ui-kit/src/runtime-config/preferences.d.ts
-/** 导出结构的版本；导入时逐字校验，不做向前兼容猜测 */
-declare const PREFERENCE_EXPORT_VERSION = 1;
+//#region ../ui-kit/src/runtime-config/stores.d.ts
 /**
- * 模型条目的可导出形态。`Omit<RuntimeLlmEntry, 'apiKey'>` 让**编译期**就放不进密钥——
- * 靠「序列化时记得删」依赖开发者不忘记，靠类型则依赖编译器（FR-5.2）。
- * @experimental
+ * `RuntimeConfigStore` 的两个实现（0.6.0 FR-20.1）。0.5.x 之前 SDK 只有接口没有实现，
+ * 每个宿主自己写一份 localStorage 读写，「chatbot 与 console 读同一份配置」靠宿主恰好传了
+ * 同一个对象，不是 SDK 保证。
  */
-type PreferenceLlmEntry = Omit<RuntimeLlmEntry, 'apiKey'>;
-/** 宿主自己持有的外观状态（不在 `RuntimeConfig` 里，由调用方传入） @experimental */
-interface PreferenceAppearance {
-  theme?: string;
-  locale?: string;
-  renderer?: string;
-}
+/** 默认存储键；外观也在这份配置里，宿主不应再开第二个键存主题 @experimental */
+declare const DEFAULT_RUNTIME_CONFIG_STORAGE_KEY = "webskill.runtime-config";
 /** @experimental */
-interface PreferenceExport {
-  version: typeof PREFERENCE_EXPORT_VERSION;
-  exportedAt: string;
-  preferences: {
-    appearance?: PreferenceAppearance;
-    interaction?: {
-      missingParams?: string;
-      confirmations?: string;
-    };
-    models?: readonly PreferenceLlmEntry[];
-    agentCapabilities?: {
-      todo?: boolean;
-      skillGeneration?: boolean;
-      generativeUi?: boolean;
-      formAutofill?: boolean;
-      delegation?: boolean;
-      uiPresets?: string[];
-    };
-  };
+interface LocalStorageRuntimeConfigStoreOptions {
+  key?: string;
+  /** 注入存储实现，便于测试与非 window 环境；缺省取 `globalThis.localStorage` */
+  storage?: Storage;
 }
+/**
+ * localStorage 实现。跨标签页同步经 `storage` 事件——该事件只在**其他**标签页写入时触发，
+ * 因此本标签页 `save()` 后需要自行通知订阅者。
+ * 存储不可用（SSR、隐私模式、配额满）时退化为内存，不抛错：配置读写失败不该让宿主白屏。
+ * @experimental
+ */
+declare function createLocalStorageRuntimeConfigStore(options?: LocalStorageRuntimeConfigStoreOptions): RuntimeConfigStore;
+/** 内存实现：测试、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';
 //#endregion
 //#region src/core/types.d.ts
 /**
@@ -277,11 +334,32 @@ interface ChatAttachmentInput {
   /** 相对 `attachmentsRoot` 的路径 */
   path: string;
   size: number;
+  /** 注入模型的内容形态；决定 send 时读文本还是读二进制 */
+  kind: ChatAttachmentKind;
+  /** 图片经压缩时的原始字节数，供 UI 显示「3.2 MB → 1.8 MB」（FR-11.3） */
+  originalSize?: number;
 }
 /** 随消息持久化的附件元数据 @experimental */
-interface ChatAttachmentMeta extends ChatAttachmentInput {
-  /** 注入模型的内容形态；text 以外的类型当前不接收（runtime 只收纯文本 prompt） */
-  kind: 'text';
+type ChatAttachmentMeta = ChatAttachmentInput;
+/**
+ * 归并后的显示相位。进行中通道与历史通道共用这一个结构：
+ * 各存一份正是「运行细节首轮后消失」的根因（需求 17 条目 10-6）。
+ * @experimental
+ */
+interface ChatRunPhase {
+  phase: RuntimePhase;
+  at: number;
+  /** 下一个步进到达时回填 */
+  endedAt?: number;
+  /** 由结构化 `LifecycleEvent.data` 派生的一句摘要 */
+  note?: string;
+}
+/** 本轮发生的一次已提交交互（FR-17.8：提交后表单保留所填值） @experimental */
+interface ChatInteractionRecord {
+  id: string;
+  request: InteractionRequest;
+  /** 提交时的表单值；文件类字段已在引擎侧脱敏 */
+  submittedValues?: unknown;
 }
 /** @stable */
 interface ChatMessage {
@@ -291,6 +369,12 @@ interface ChatMessage {
   ts: string;
   /** user 消息携带的附件（旧会话文件无该字段） */
   attachments?: ChatAttachmentMeta[];
+  /**
+   * 随消息持久化的系统提示（例如「图片超出数量上限，未发送 X」，FR-11.3）。
+   * 放在消息里而不是 toast：toast 会消失，用户回头就查不到这次到底发了什么。
+   * @experimental
+   */
+  notice?: string;
   /** assistant 消息所属 run */
   runId?: string;
   /** 该 run 激活的技能（消息底部 badges） */
@@ -317,6 +401,18 @@ interface ChatMessage {
    * 写在消息上而不是会话上：切换模型只对后续消息生效，已有消息的归属不能被改写。
    */
   model?: string;
+  /**
+   * 该轮的生命周期相位快照（FR-17.7）。不持久化它，live 状态一丢「运行细节」入口就消失，
+   * 表现为容器高度先减后增。
+   * @experimental
+   */
+  phases?: ChatRunPhase[];
+  /**
+   * 该轮发生的交互及其终态（FR-17.8）。交互卡归属发起它的那条消息，
+   * 后续结果另开新消息，而不是就地改写原表单。
+   * @experimental
+   */
+  interactions?: ChatInteractionRecord[];
 }
 /** @stable */
 interface ChatSessionMeta {
@@ -328,6 +424,17 @@ interface ChatSessionMeta {
   /** 用户已手动重命名：后续 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';
@@ -368,6 +475,8 @@ type ChatEvent = {
   status: 'completed' | 'failed' | 'cancelled';
   output: string;
   activeSkillNames: string[];
+  /** 终止原因对应的稳定错误码（仅非正常结束时）：UI 据此分类提示，不再压平为 RUN_FAILED */
+  code?: WebSkillErrorCode;
 } | {
   type: 'todo-changed';
   runId: string;
@@ -380,6 +489,8 @@ type ChatEvent = {
   type: 'interaction-requested';
   id: string;
   requestType: InteractionRequest['type'];
+  /** 等待对象的可读名称（表单标题 / 问题正文）：等待指示器要说清在等什么（FR-21.3） */
+  label?: string;
 } | {
   type: 'interaction-resolved';
   id: string;
@@ -388,6 +499,21 @@ type ChatEvent = {
 } | LifecycleChatEvent | {
   type: 'session-updated';
   session: ChatSessionMeta;
+} |
+/**
+ * 会话结束（需求 19 FR-19.3）：切换、删除、归档、引擎释放各算一次。
+ * 用户画像的自动提炼挂在这个事件上——没有它就只能靠定时器猜「聊完了没」。
+ * @experimental
+ */
+{
+  type: 'session-ended';
+  sessionId: string;
+  reason: 'switched' | 'deleted' | 'archived' | 'closed';
+} |
+/** 画像提炼完成（需求 19 FR-19.3）：设置面板据此刷新列表 @experimental */
+{
+  type: 'user-profile-updated';
+  profile: UserProfile;
 } | {
   type: 'warning';
   message: string;
@@ -544,6 +670,8 @@ declare class ChatEngine {
    * 重装配 runtime 以换掉客户端；已落盘的消息不受影响。
    */
   setModel(entryId: string | undefined): void;
+  /** 会话文件所在目录：「存储未初始化」提示要把路径写给用户看 @experimental */
+  get sessionsRoot(): string;
   /** 渲染框架热切换：复合桥按档分发，无需重装配 runtime（会话句柄保留） */
   setRenderer(renderer: RendererKind): void;
   /** 非 native 三档共用的交互通道（Chatbot 的 SpecInteraction 订阅/attach；core 只产出 catalog 节点树） */
@@ -560,8 +688,11 @@ declare class ChatEngine {
    * 会话列表页。归档会话也返回：UI 自己分区展示。
    * `limit` 不给默认值——缺省属于 `SessionStore` 实现，在这里兜底就等于只下推了一半。
    */
-  listSessions(options?: PageQuery): Promise<Page<ChatSessionMeta>>;
-  createSession(): Promise<ChatSessionMeta>;
+  listSessions(options?: PageQuery): Promise<ChatSessionListResult>;
+  /** `title` 缺省时会话先无标题，首条消息发出时再按内容补（FR-21.8） */
+  createSession(options?: {
+    title?: string;
+  }): Promise<ChatSessionMeta>;
   /**
    * 选中会话并取**最新**一页历史（页内时间升序）。
    * 返回全量 `ChatMessage[]` 的旧签名已移除：长会话下它强迫每个调用方拿全量。
@@ -590,13 +721,18 @@ declare class ChatEngine {
   /**
    * 驱动当前 session 的一轮 run。同 session 并发由 runtime session handle 内部
    * 队列串行化（此处直接 await）；UI 层应在 send 期间禁用输入。
-   * 附件正文按 `attachmentsRoot` 内的路径读回并拼进 prompt（runtime 只收纯文本）。
+   * 附件按 `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[]>;
   /**
@@ -604,12 +740,36 @@ declare class ChatEngine {
    * 完成后与 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-5.11）。不传 `fieldKey` 即整体清空。
-   * 与开关分开：关掉开关只是停止召回，用户往往还想把已存的内容删干净。
+   * 一并清除记录与画像，并销毁加密密钥（FR-19.8：关闭总开关时的「一并清除」）。
+   * 密钥留着就等于给残留密文留了一把能解开的钥匙。
    * @experimental
    */
-  clearFormAutofill(fieldKey?: string): Promise<void>;
+  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>;
 }
 //#endregion
 //#region src/core/interactionBridge.d.ts
@@ -658,6 +818,12 @@ interface CompositeUiBridgeDeps {
   getInteractionChannel(): SpecInteractionChannel;
   /** 渲染档能力表（省略用 DEFAULT_RENDERER_CAPABILITIES） */
   capabilities?: Readonly<Record<RendererKind, RendererCapability>>;
+  /**
+   * 交互结束（含取消）后的回调，带完整请求与应答。
+   * `interaction-resolved` 事件不带值，而切分消息需要把用户填的内容留在表单上（FR-17.8）。
+   * @experimental
+   */
+  onResolved?(request: InteractionRequest, response: InteractionResponse): void;
   emit(event: ChatEvent): void;
 }
 /**
@@ -698,11 +864,23 @@ declare const chatbotDictionary: {
     'header.sessions': string;
     'header.settings': string;
     'header.console': string;
+    'header.theme.light': string;
+    'header.theme.dark': string;
     'session.title': string;
     'session.new': string;
     'session.searchPlaceholder': string;
     'session.empty': string;
+    'session.missingRoot': string;
+    'session.skipped': string;
     'session.delete': string;
+    'session.actions': string;
+    'session.menu.rename': string;
+    'session.menu.archive': string;
+    'session.menu.unarchive': string;
+    'session.menu.delete': string;
+    'session.delete.confirmTitle': string;
+    'session.delete.confirmDescription': string;
+    'common.cancel': string;
     'session.rename': string;
     'session.renameInput': string;
     'session.archive': string;
@@ -741,6 +919,8 @@ declare const chatbotDictionary: {
     'tool.args': string;
     'tool.denied.reason': string;
     'tool.failed.reason': string;
+    'tool.notFound.reason': string;
+    'tool.exhausted.reason': string;
     'cot.thinking': string;
     'cot.thought': string;
     'cot.summary': string;
@@ -750,6 +930,9 @@ declare const chatbotDictionary: {
     'trace.skill': string;
     'perception.reading': string;
     'perception.excluded': string;
+    'perception.images': string;
+    'perception.imagesOmitted': string;
+    'perception.imageFailures': string;
     'trace.phase.route': string;
     'trace.phase.activate': string;
     'trace.phase.execute': string;
@@ -767,16 +950,25 @@ declare const chatbotDictionary: {
     'interaction.form.title': string;
     'interaction.select.title': string;
     'interaction.authorize.title': string;
+    'interaction.filePick.title': string;
+    'interaction.filePick.choose': string;
+    'interaction.filePick.decline': string;
+    'interaction.filePick.selected': string;
     'interaction.authorize.description': string;
     'interaction.authorize.capability': string;
     'interaction.authorize.details': string;
     'interaction.origin': string;
+    'interaction.submitted': string;
     'interaction.submit': string;
     'interaction.cancel': string;
     'interaction.confirm': string;
     'interaction.allow': string;
     'interaction.deny': string;
     'interaction.required': string;
+    'interaction.wait': string;
+    'interaction.wait.inPanel': string;
+    'interaction.wait.fallback': string;
+    'interaction.wait.locate': string;
     'result.artifacts': string;
     'result.download': string;
     'result.file': string;
@@ -798,14 +990,38 @@ declare const chatbotDictionary: {
     'composer.attachments': string;
     'composer.addAttachment': string;
     'composer.removeAttachment': string;
+    'composer.attachment.kind.text': string;
+    'composer.attachment.kind.image': string;
+    'composer.attachment.kind.file': string;
+    'composer.attachment.compressed': string;
     'composer.model': string;
     'composer.model.demo': string;
+    'composer.plainChatOnly': string;
+    'composer.menu': string;
+    'composer.pageCapture': string;
+    'composer.pageCapture.disabled.setting': string;
+    'composer.pageCapture.disabled.model': string;
+    'composer.addAttachment.imagesOff': string;
+    'composer.addAttachment.modelNoImages': string;
     'composer.dictate': string;
     'composer.dictate.stop': string;
     'composer.dictate.recording': string;
     'composer.dictate.api-missing': string;
     'composer.dictate.insecure-context': string;
     'settings.title': string;
+    'settings.group.general': string;
+    'settings.group.models': string;
+    'settings.group.agent': string;
+    'settings.group.multimodal': string;
+    'settings.group.privacy': string;
+    'settings.general.title': string;
+    'settings.general.description': string;
+    'settings.privacy.title': string;
+    'settings.privacy.description': string;
+    'settings.model.actions': string;
+    'settings.model.removeConfirmTitle': string;
+    'settings.model.removeConfirmDescription': string;
+    'settings.model.isDefault': string;
     'settings.model.title': string;
     'settings.model.description': string;
     'settings.model.empty': string;
@@ -858,40 +1074,62 @@ declare const chatbotDictionary: {
     'settings.agent.skillGenerationNote': string;
     'settings.agent.delegation': string;
     'settings.agent.delegationNote': string;
-    'settings.agent.formAutofill': string;
-    'settings.agent.formAutofillNote': string;
-    'settings.agent.formAutofillClear': string;
-    'settings.agent.formAutofillCleared': string;
-    'settings.preferences.title': string;
-    'settings.preferences.description': string;
-    'settings.preferences.export': string;
-    'settings.preferences.import': string;
-    'settings.preferences.exported': string;
-    'settings.preferences.imported': string;
+    'settings.privacy.enabled': string;
+    'settings.privacy.enabledRisk': string;
+    'settings.privacy.encrypted': string;
+    'settings.privacy.encryptedNote': string;
+    'settings.privacy.injectMaxBytes': string;
+    'settings.privacy.injectMaxBytesNote': string;
+    'settings.privacy.recordLimit': string;
+    'settings.privacy.recordLimitNote': string;
+    'settings.privacy.disableClearPrompt': string;
+    'settings.privacy.disableClearConfirm': string;
+    'settings.privacy.disableClearKeep': string;
+    'settings.privacy.profileTitle': string;
+    'settings.privacy.profileNote': string;
+    'settings.privacy.profileEmpty': string;
+    'settings.privacy.profileDelete': string;
+    'settings.privacy.refine': string;
+    'settings.privacy.export': string;
+    'settings.privacy.import': string;
+    'settings.privacy.clearRecords': string;
+    'settings.privacy.clearProfile': string;
+    'settings.privacy.clearConfirm': string;
+    'settings.privacy.exportReview': string;
+    'settings.privacy.exportConfirm': string;
+    'settings.privacy.importDiff': string;
+    'settings.model.image': string;
+    'settings.model.imageNote': string;
+    'settings.model.tools': string;
+    'settings.model.toolsNote': string;
+    'settings.model.builtinFixed': string;
+    'settings.capability.plainChat': string;
+    'settings.multimodal.title': string;
+    'settings.multimodal.description': string;
+    'settings.multimodal.imageAttachments': string;
+    'settings.multimodal.imageAttachmentsRisk': string;
+    'settings.multimodal.pageImageCapture': string;
+    'settings.multimodal.pageImageCaptureRisk': string;
+    'settings.multimodal.maxImages': string;
+    'settings.multimodal.maxImagesNote': string;
+    'settings.multimodal.maxImageBytes': string;
+    'settings.multimodal.maxImageBytesNote': string;
     'settings.voice.title': string;
     'settings.voice.description': string;
     'settings.voice.lang': string;
     'settings.voice.langFollow': 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;
     'surface.legacy.placeholder': string;
     'error.title': string;
     'error.suggestion': string;
+    'error.suggestion.LLM_UNAVAILABLE': string;
+    'error.suggestion.LLM_REQUEST_FAILED': string;
+    'error.suggestion.RUN_TIMEOUT': string;
+    'error.suggestion.RUN_INTERACTION_TIMEOUT': string;
+    'error.suggestion.RUN_MAX_TURNS_EXCEEDED': string;
+    'error.suggestion.TOOL_RESOLUTION_EXHAUSTED': string;
     'error.dismiss': string;
   };
   zh: {
@@ -899,11 +1137,23 @@ declare const chatbotDictionary: {
     'header.sessions': string;
     'header.settings': string;
     'header.console': string;
+    'header.theme.light': string;
+    'header.theme.dark': string;
     'session.title': string;
     'session.new': string;
     'session.searchPlaceholder': string;
     'session.empty': string;
+    'session.missingRoot': string;
+    'session.skipped': string;
     'session.delete': string;
+    'session.actions': string;
+    'session.menu.rename': string;
+    'session.menu.archive': string;
+    'session.menu.unarchive': string;
+    'session.menu.delete': string;
+    'session.delete.confirmTitle': string;
+    'session.delete.confirmDescription': string;
+    'common.cancel': string;
     'session.rename': string;
     'session.renameInput': string;
     'session.archive': string;
@@ -942,6 +1192,8 @@ declare const chatbotDictionary: {
     'tool.args': string;
     'tool.denied.reason': string;
     'tool.failed.reason': string;
+    'tool.notFound.reason': string;
+    'tool.exhausted.reason': string;
     'cot.thinking': string;
     'cot.thought': string;
     'cot.summary': string;
@@ -951,6 +1203,9 @@ declare const chatbotDictionary: {
     'trace.skill': string;
     'perception.reading': string;
     'perception.excluded': string;
+    'perception.images': string;
+    'perception.imagesOmitted': string;
+    'perception.imageFailures': string;
     'trace.phase.route': string;
     'trace.phase.activate': string;
     'trace.phase.execute': string;
@@ -968,16 +1223,25 @@ declare const chatbotDictionary: {
     'interaction.form.title': string;
     'interaction.select.title': string;
     'interaction.authorize.title': string;
+    'interaction.filePick.title': string;
+    'interaction.filePick.choose': string;
+    'interaction.filePick.decline': string;
+    'interaction.filePick.selected': string;
     'interaction.authorize.description': string;
     'interaction.authorize.capability': string;
     'interaction.authorize.details': string;
     'interaction.origin': string;
+    'interaction.submitted': string;
     'interaction.submit': string;
     'interaction.cancel': string;
     'interaction.confirm': string;
     'interaction.allow': string;
     'interaction.deny': string;
     'interaction.required': string;
+    'interaction.wait': string;
+    'interaction.wait.inPanel': string;
+    'interaction.wait.fallback': string;
+    'interaction.wait.locate': string;
     'result.artifacts': string;
     'result.download': string;
     'result.file': string;
@@ -999,14 +1263,38 @@ declare const chatbotDictionary: {
     'composer.attachments': string;
     'composer.addAttachment': string;
     'composer.removeAttachment': string;
+    'composer.attachment.kind.text': string;
+    'composer.attachment.kind.image': string;
+    'composer.attachment.kind.file': string;
+    'composer.attachment.compressed': string;
     'composer.model': string;
     'composer.model.demo': string;
+    'composer.plainChatOnly': string;
+    'composer.menu': string;
+    'composer.pageCapture': string;
+    'composer.pageCapture.disabled.setting': string;
+    'composer.pageCapture.disabled.model': string;
+    'composer.addAttachment.imagesOff': string;
+    'composer.addAttachment.modelNoImages': string;
     'composer.dictate': string;
     'composer.dictate.stop': string;
     'composer.dictate.recording': string;
     'composer.dictate.api-missing': string;
     'composer.dictate.insecure-context': string;
     'settings.title': string;
+    'settings.group.general': string;
+    'settings.group.models': string;
+    'settings.group.agent': string;
+    'settings.group.multimodal': string;
+    'settings.group.privacy': string;
+    'settings.general.title': string;
+    'settings.general.description': string;
+    'settings.privacy.title': string;
+    'settings.privacy.description': string;
+    'settings.model.actions': string;
+    'settings.model.removeConfirmTitle': string;
+    'settings.model.removeConfirmDescription': string;
+    'settings.model.isDefault': string;
     'settings.model.title': string;
     'settings.model.description': string;
     'settings.model.empty': string;
@@ -1059,40 +1347,62 @@ declare const chatbotDictionary: {
     'settings.agent.skillGenerationNote': string;
     'settings.agent.delegation': string;
     'settings.agent.delegationNote': string;
-    'settings.agent.formAutofill': string;
-    'settings.agent.formAutofillNote': string;
-    'settings.agent.formAutofillClear': string;
-    'settings.agent.formAutofillCleared': string;
-    'settings.preferences.title': string;
-    'settings.preferences.description': string;
-    'settings.preferences.export': string;
-    'settings.preferences.import': string;
-    'settings.preferences.exported': string;
-    'settings.preferences.imported': string;
+    'settings.privacy.enabled': string;
+    'settings.privacy.enabledRisk': string;
+    'settings.privacy.encrypted': string;
+    'settings.privacy.encryptedNote': string;
+    'settings.privacy.injectMaxBytes': string;
+    'settings.privacy.injectMaxBytesNote': string;
+    'settings.privacy.recordLimit': string;
+    'settings.privacy.recordLimitNote': string;
+    'settings.privacy.disableClearPrompt': string;
+    'settings.privacy.disableClearConfirm': string;
+    'settings.privacy.disableClearKeep': string;
+    'settings.privacy.profileTitle': string;
+    'settings.privacy.profileNote': string;
+    'settings.privacy.profileEmpty': string;
+    'settings.privacy.profileDelete': string;
+    'settings.privacy.refine': string;
+    'settings.privacy.export': string;
+    'settings.privacy.import': string;
+    'settings.privacy.clearRecords': string;
+    'settings.privacy.clearProfile': string;
+    'settings.privacy.clearConfirm': string;
+    'settings.privacy.exportReview': string;
+    'settings.privacy.exportConfirm': string;
+    'settings.privacy.importDiff': string;
+    'settings.model.image': string;
+    'settings.model.imageNote': string;
+    'settings.model.tools': string;
+    'settings.model.toolsNote': string;
+    'settings.model.builtinFixed': string;
+    'settings.capability.plainChat': string;
+    'settings.multimodal.title': string;
+    'settings.multimodal.description': string;
+    'settings.multimodal.imageAttachments': string;
+    'settings.multimodal.imageAttachmentsRisk': string;
+    'settings.multimodal.pageImageCapture': string;
+    'settings.multimodal.pageImageCaptureRisk': string;
+    'settings.multimodal.maxImages': string;
+    'settings.multimodal.maxImagesNote': string;
+    'settings.multimodal.maxImageBytes': string;
+    'settings.multimodal.maxImageBytesNote': string;
     'settings.voice.title': string;
     'settings.voice.description': string;
     'settings.voice.lang': string;
     'settings.voice.langFollow': 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;
     'surface.legacy.placeholder': string;
     'error.title': string;
     'error.suggestion': string;
+    'error.suggestion.LLM_UNAVAILABLE': string;
+    'error.suggestion.LLM_REQUEST_FAILED': string;
+    'error.suggestion.RUN_TIMEOUT': string;
+    'error.suggestion.RUN_INTERACTION_TIMEOUT': string;
+    'error.suggestion.RUN_MAX_TURNS_EXCEEDED': string;
+    'error.suggestion.TOOL_RESOLUTION_EXHAUSTED': string;
     'error.dismiss': string;
   };
 };
@@ -1103,11 +1413,23 @@ declare const useT: () => TranslateFn<{
     'header.sessions': string;
     'header.settings': string;
     'header.console': string;
+    'header.theme.light': string;
+    'header.theme.dark': string;
     'session.title': string;
     'session.new': string;
     'session.searchPlaceholder': string;
     'session.empty': string;
+    'session.missingRoot': string;
+    'session.skipped': string;
     'session.delete': string;
+    'session.actions': string;
+    'session.menu.rename': string;
+    'session.menu.archive': string;
+    'session.menu.unarchive': string;
+    'session.menu.delete': string;
+    'session.delete.confirmTitle': string;
+    'session.delete.confirmDescription': string;
+    'common.cancel': string;
     'session.rename': string;
     'session.renameInput': string;
     'session.archive': string;
@@ -1146,6 +1468,8 @@ declare const useT: () => TranslateFn<{
     'tool.args': string;
     'tool.denied.reason': string;
     'tool.failed.reason': string;
+    'tool.notFound.reason': string;
+    'tool.exhausted.reason': string;
     'cot.thinking': string;
     'cot.thought': string;
     'cot.summary': string;
@@ -1155,6 +1479,9 @@ declare const useT: () => TranslateFn<{
     'trace.skill': string;
     'perception.reading': string;
     'perception.excluded': string;
+    'perception.images': string;
+    'perception.imagesOmitted': string;
+    'perception.imageFailures': string;
     'trace.phase.route': string;
     'trace.phase.activate': string;
     'trace.phase.execute': string;
@@ -1172,16 +1499,25 @@ declare const useT: () => TranslateFn<{
     'interaction.form.title': string;
     'interaction.select.title': string;
     'interaction.authorize.title': string;
+    'interaction.filePick.title': string;
+    'interaction.filePick.choose': string;
+    'interaction.filePick.decline': string;
+    'interaction.filePick.selected': string;
     'interaction.authorize.description': string;
     'interaction.authorize.capability': string;
     'interaction.authorize.details': string;
     'interaction.origin': string;
+    'interaction.submitted': string;
     'interaction.submit': string;
     'interaction.cancel': string;
     'interaction.confirm': string;
     'interaction.allow': string;
     'interaction.deny': string;
     'interaction.required': string;
+    'interaction.wait': string;
+    'interaction.wait.inPanel': string;
+    'interaction.wait.fallback': string;
+    'interaction.wait.locate': string;
     'result.artifacts': string;
     'result.download': string;
     'result.file': string;
@@ -1203,14 +1539,38 @@ declare const useT: () => TranslateFn<{
     'composer.attachments': string;
     'composer.addAttachment': string;
     'composer.removeAttachment': string;
+    'composer.attachment.kind.text': string;
+    'composer.attachment.kind.image': string;
+    'composer.attachment.kind.file': string;
+    'composer.attachment.compressed': string;
     'composer.model': string;
     'composer.model.demo': string;
+    'composer.plainChatOnly': string;
+    'composer.menu': string;
+    'composer.pageCapture': string;
+    'composer.pageCapture.disabled.setting': string;
+    'composer.pageCapture.disabled.model': string;
+    'composer.addAttachment.imagesOff': string;
+    'composer.addAttachment.modelNoImages': string;
     'composer.dictate': string;
     'composer.dictate.stop': string;
     'composer.dictate.recording': string;
     'composer.dictate.api-missing': string;
     'composer.dictate.insecure-context': string;
     'settings.title': string;
+    'settings.group.general': string;
+    'settings.group.models': string;
+    'settings.group.agent': string;
+    'settings.group.multimodal': string;
+    'settings.group.privacy': string;
+    'settings.general.title': string;
+    'settings.general.description': string;
+    'settings.privacy.title': string;
+    'settings.privacy.description': string;
+    'settings.model.actions': string;
+    'settings.model.removeConfirmTitle': string;
+    'settings.model.removeConfirmDescription': string;
+    'settings.model.isDefault': string;
     'settings.model.title': string;
     'settings.model.description': string;
     'settings.model.empty': string;
@@ -1263,40 +1623,62 @@ declare const useT: () => TranslateFn<{
     'settings.agent.skillGenerationNote': string;
     'settings.agent.delegation': string;
     'settings.agent.delegationNote': string;
-    'settings.agent.formAutofill': string;
-    'settings.agent.formAutofillNote': string;
-    'settings.agent.formAutofillClear': string;
-    'settings.agent.formAutofillCleared': string;
-    'settings.preferences.title': string;
-    'settings.preferences.description': string;
-    'settings.preferences.export': string;
-    'settings.preferences.import': string;
-    'settings.preferences.exported': string;
-    'settings.preferences.imported': string;
+    'settings.privacy.enabled': string;
+    'settings.privacy.enabledRisk': string;
+    'settings.privacy.encrypted': string;
+    'settings.privacy.encryptedNote': string;
+    'settings.privacy.injectMaxBytes': string;
+    'settings.privacy.injectMaxBytesNote': string;
+    'settings.privacy.recordLimit': string;
+    'settings.privacy.recordLimitNote': string;
+    'settings.privacy.disableClearPrompt': string;
+    'settings.privacy.disableClearConfirm': string;
+    'settings.privacy.disableClearKeep': string;
+    'settings.privacy.profileTitle': string;
+    'settings.privacy.profileNote': string;
+    'settings.privacy.profileEmpty': string;
+    'settings.privacy.profileDelete': string;
+    'settings.privacy.refine': string;
+    'settings.privacy.export': string;
+    'settings.privacy.import': string;
+    'settings.privacy.clearRecords': string;
+    'settings.privacy.clearProfile': string;
+    'settings.privacy.clearConfirm': string;
+    'settings.privacy.exportReview': string;
+    'settings.privacy.exportConfirm': string;
+    'settings.privacy.importDiff': string;
+    'settings.model.image': string;
+    'settings.model.imageNote': string;
+    'settings.model.tools': string;
+    'settings.model.toolsNote': string;
+    'settings.model.builtinFixed': string;
+    'settings.capability.plainChat': string;
+    'settings.multimodal.title': string;
+    'settings.multimodal.description': string;
+    'settings.multimodal.imageAttachments': string;
+    'settings.multimodal.imageAttachmentsRisk': string;
+    'settings.multimodal.pageImageCapture': string;
+    'settings.multimodal.pageImageCaptureRisk': string;
+    'settings.multimodal.maxImages': string;
+    'settings.multimodal.maxImagesNote': string;
+    'settings.multimodal.maxImageBytes': string;
+    'settings.multimodal.maxImageBytesNote': string;
     'settings.voice.title': string;
     'settings.voice.description': string;
     'settings.voice.lang': string;
     'settings.voice.langFollow': 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;
     'surface.legacy.placeholder': string;
     'error.title': string;
     'error.suggestion': string;
+    'error.suggestion.LLM_UNAVAILABLE': string;
+    'error.suggestion.LLM_REQUEST_FAILED': string;
+    'error.suggestion.RUN_TIMEOUT': string;
+    'error.suggestion.RUN_INTERACTION_TIMEOUT': string;
+    'error.suggestion.RUN_MAX_TURNS_EXCEEDED': string;
+    'error.suggestion.TOOL_RESOLUTION_EXHAUSTED': string;
     'error.dismiss': string;
   };
   zh: {
@@ -1304,11 +1686,23 @@ declare const useT: () => TranslateFn<{
     'header.sessions': string;
     'header.settings': string;
     'header.console': string;
+    'header.theme.light': string;
+    'header.theme.dark': string;
     'session.title': string;
     'session.new': string;
     'session.searchPlaceholder': string;
     'session.empty': string;
+    'session.missingRoot': string;
+    'session.skipped': string;
     'session.delete': string;
+    'session.actions': string;
+    'session.menu.rename': string;
+    'session.menu.archive': string;
+    'session.menu.unarchive': string;
+    'session.menu.delete': string;
+    'session.delete.confirmTitle': string;
+    'session.delete.confirmDescription': string;
+    'common.cancel': string;
     'session.rename': string;
     'session.renameInput': string;
     'session.archive': string;
@@ -1347,6 +1741,8 @@ declare const useT: () => TranslateFn<{
     'tool.args': string;
     'tool.denied.reason': string;
     'tool.failed.reason': string;
+    'tool.notFound.reason': string;
+    'tool.exhausted.reason': string;
     'cot.thinking': string;
     'cot.thought': string;
     'cot.summary': string;
@@ -1356,6 +1752,9 @@ declare const useT: () => TranslateFn<{
     'trace.skill': string;
     'perception.reading': string;
     'perception.excluded': string;
+    'perception.images': string;
+    'perception.imagesOmitted': string;
+    'perception.imageFailures': string;
     'trace.phase.route': string;
     'trace.phase.activate': string;
     'trace.phase.execute': string;
@@ -1373,16 +1772,25 @@ declare const useT: () => TranslateFn<{
     'interaction.form.title': string;
     'interaction.select.title': string;
     'interaction.authorize.title': string;
+    'interaction.filePick.title': string;
+    'interaction.filePick.choose': string;
+    'interaction.filePick.decline': string;
+    'interaction.filePick.selected': string;
     'interaction.authorize.description': string;
     'interaction.authorize.capability': string;
     'interaction.authorize.details': string;
     'interaction.origin': string;
+    'interaction.submitted': string;
     'interaction.submit': string;
     'interaction.cancel': string;
     'interaction.confirm': string;
     'interaction.allow': string;
     'interaction.deny': string;
     'interaction.required': string;
+    'interaction.wait': string;
+    'interaction.wait.inPanel': string;
+    'interaction.wait.fallback': string;
+    'interaction.wait.locate': string;
     'result.artifacts': string;
     'result.download': string;
     'result.file': string;
@@ -1404,14 +1812,38 @@ declare const useT: () => TranslateFn<{
     'composer.attachments': string;
     'composer.addAttachment': string;
     'composer.removeAttachment': string;
+    'composer.attachment.kind.text': string;
+    'composer.attachment.kind.image': string;
+    'composer.attachment.kind.file': string;
+    'composer.attachment.compressed': string;
     'composer.model': string;
     'composer.model.demo': string;
+    'composer.plainChatOnly': string;
+    'composer.menu': string;
+    'composer.pageCapture': string;
+    'composer.pageCapture.disabled.setting': string;
+    'composer.pageCapture.disabled.model': string;
+    'composer.addAttachment.imagesOff': string;
+    'composer.addAttachment.modelNoImages': string;
     'composer.dictate': string;
     'composer.dictate.stop': string;
     'composer.dictate.recording': string;
     'composer.dictate.api-missing': string;
     'composer.dictate.insecure-context': string;
     'settings.title': string;
+    'settings.group.general': string;
+    'settings.group.models': string;
+    'settings.group.agent': string;
+    'settings.group.multimodal': string;
+    'settings.group.privacy': string;
+    'settings.general.title': string;
+    'settings.general.description': string;
+    'settings.privacy.title': string;
+    'settings.privacy.description': string;
+    'settings.model.actions': string;
+    'settings.model.removeConfirmTitle': string;
+    'settings.model.removeConfirmDescription': string;
+    'settings.model.isDefault': string;
     'settings.model.title': string;
     'settings.model.description': string;
     'settings.model.empty': string;
@@ -1464,40 +1896,62 @@ declare const useT: () => TranslateFn<{
     'settings.agent.skillGenerationNote': string;
     'settings.agent.delegation': string;
     'settings.agent.delegationNote': string;
-    'settings.agent.formAutofill': string;
-    'settings.agent.formAutofillNote': string;
-    'settings.agent.formAutofillClear': string;
-    'settings.agent.formAutofillCleared': string;
-    'settings.preferences.title': string;
-    'settings.preferences.description': string;
-    'settings.preferences.export': string;
-    'settings.preferences.import': string;
-    'settings.preferences.exported': string;
-    'settings.preferences.imported': string;
+    'settings.privacy.enabled': string;
+    'settings.privacy.enabledRisk': string;
+    'settings.privacy.encrypted': string;
+    'settings.privacy.encryptedNote': string;
+    'settings.privacy.injectMaxBytes': string;
+    'settings.privacy.injectMaxBytesNote': string;
+    'settings.privacy.recordLimit': string;
+    'settings.privacy.recordLimitNote': string;
+    'settings.privacy.disableClearPrompt': string;
+    'settings.privacy.disableClearConfirm': string;
+    'settings.privacy.disableClearKeep': string;
+    'settings.privacy.profileTitle': string;
+    'settings.privacy.profileNote': string;
+    'settings.privacy.profileEmpty': string;
+    'settings.privacy.profileDelete': string;
+    'settings.privacy.refine': string;
+    'settings.privacy.export': string;
+    'settings.privacy.import': string;
+    'settings.privacy.clearRecords': string;
+    'settings.privacy.clearProfile': string;
+    'settings.privacy.clearConfirm': string;
+    'settings.privacy.exportReview': string;
+    'settings.privacy.exportConfirm': string;
+    'settings.privacy.importDiff': string;
+    'settings.model.image': string;
+    'settings.model.imageNote': string;
+    'settings.model.tools': string;
+    'settings.model.toolsNote': string;
+    'settings.model.builtinFixed': string;
+    'settings.capability.plainChat': string;
+    'settings.multimodal.title': string;
+    'settings.multimodal.description': string;
+    'settings.multimodal.imageAttachments': string;
+    'settings.multimodal.imageAttachmentsRisk': string;
+    'settings.multimodal.pageImageCapture': string;
+    'settings.multimodal.pageImageCaptureRisk': string;
+    'settings.multimodal.maxImages': string;
+    'settings.multimodal.maxImagesNote': string;
+    'settings.multimodal.maxImageBytes': string;
+    'settings.multimodal.maxImageBytesNote': string;
     'settings.voice.title': string;
     'settings.voice.description': string;
     'settings.voice.lang': string;
     'settings.voice.langFollow': 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;
     'surface.legacy.placeholder': string;
     'error.title': string;
     'error.suggestion': string;
+    'error.suggestion.LLM_UNAVAILABLE': string;
+    'error.suggestion.LLM_REQUEST_FAILED': string;
+    'error.suggestion.RUN_TIMEOUT': string;
+    'error.suggestion.RUN_INTERACTION_TIMEOUT': string;
+    'error.suggestion.RUN_MAX_TURNS_EXCEEDED': string;
+    'error.suggestion.TOOL_RESOLUTION_EXHAUSTED': string;
     'error.dismiss': string;
   };
 }>;
@@ -1529,9 +1983,12 @@ type ResolvedChatLayout = 'fullscreen' | 'embedded' | 'mobile';
 interface ChatbotProps {
   adapter: ChatbotHostAdapter;
   config?: ChatbotConfig;
-  /** 界面语言（默认 'en'；SettingsDrawer 内切换后经 onAppearanceChange 通知宿主） */
+  /**
+   * 界面语言（默认 'en'）。**传了 `config.runtimeConfig` 时本属性被忽略**：
+   * 0.6.0 起外观配置的唯一真值源是配置存储（FR-20.1）。
+   */
   locale?: Locale;
-  /** 主题（默认 'light'；'dark' 时根 div 挂 .dark 类） */
+  /** 主题（默认 'light'）。同上：有配置源时被忽略 */
   theme?: ChatTheme;
   /** 交互渲染框架档（默认 'native'；'a2ui' 需宿主安装 optional peer @a2ui/lit） */
   renderer?: RendererKind;
@@ -1716,34 +2173,50 @@ interface SettingsDrawerProps {
    * 缺省时模型区只读展示（宿主没接配置源，谈不上持久化）。
    */
   runtimeConfig?: RuntimeConfigStore;
-  theme: ChatTheme;
-  locale: Locale;
-  /** 当前渲染框架档（Appearance 区可切换；缺 optional peer 的档位置灰） */
-  renderer?: RendererKind;
   /**
    * 语音识别语言（BCP-47）；空串即跟随界面语言（FR-7.7）。
    * @experimental
    */
   dictationLang?: string;
-  /** 主题/语言切换时回调（宿主借此持久化；内部 state 由 Chatbot 跟随） */
+  /** 语音语言切换时回调（写回同一份外观配置） */
   onAppearanceChange?(next: AppearanceChange): void;
-  /** 保存/清除成功后回调（Chatbot 借此触发 engine.reloadConfig） */
-  onSaved(): void;
   /**
-   * 清除跨会话表单填写历史（FR-5.11）。不注入即不渲染按钮（R11）。
+   * 当前选中的模型条目 id（FR-14.4）：它不支持工具时，Agent 能力开关置灰。
    * @experimental
    */
-  onClearFormAutofill?(): Promise<void>;
+  selectedModelId?: string;
+  /** 保存/清除成功后回调（Chatbot 借此触发 engine.reloadConfig） */
+  onSaved(): void;
   /**
-   * 导出偏好时回调（FR-5.1）：不注入时默认触发浏览器下载；
-   * 宿主要改成写入自己的存储（或复制到剪贴板）时接本回调。
+   * 用户画像的读写入口（需求 19）。不注入即整段画像 UI 不渲染（R11）——
+   * 没有数据源时展示一个空列表比不展示更容易让人以为「记录丢了」。
    * @experimental
    */
-  onExportPreferences?(data: PreferenceExport): void;
+  userProfileApi?: UserProfileApi;
   onClose(): void;
 }
-/** 设置抽屉：模型列表（增删改 / 设默认 / 逐条探测）+ 流式与 temperature + Agent 能力 + 外观 @stable */
-declare function SettingsDrawer({ open, runtimeConfig, theme, locale, renderer, dictationLang, onAppearanceChange, onSaved, onClearFormAutofill, onExportPreferences, onClose }: SettingsDrawerProps): import("react").JSX.Element;
+/** 设置面板对画像数据的最小依赖面；实现由 Chatbot 用 ChatEngine 装配 @experimental */
+interface UserProfileApi {
+  read(): Promise<UserProfile>;
+  refine(): Promise<UserProfile>;
+  deleteEntry(id: string): Promise<UserProfile>;
+  clearRecords(): Promise<void>;
+  clearProfile(): Promise<void>;
+  /** 记录与画像一并清除（关闭总开关时的追问） */
+  clearAll(): Promise<void>;
+  /** `excludeIds` 来自导出前的逐条审阅 */
+  export(excludeIds: readonly string[]): Promise<UserProfileExport>;
+  diffImport(incoming: UserProfileExport): Promise<UserProfileImportDiff>;
+  applyImport(incoming: UserProfileExport): Promise<UserProfile>;
+}
+/** @experimental */
+interface UserProfileImportDiff {
+  added: readonly UserProfileEntry[];
+  updated: readonly UserProfileEntry[];
+  origin: string;
+}
+/** 设置抽屉：模型列表（增删改 / 设默认 / 逐条探测）+ 流式与 temperature + Agent 能力 + 语音语言 @stable */
+declare function SettingsDrawer({ open, runtimeConfig, dictationLang, selectedModelId, onAppearanceChange, onSaved, userProfileApi: profileApi, onClose }: SettingsDrawerProps): import("react").JSX.Element;
 //#endregion
 //#region src/react/ErrorCard.d.ts
 /** @stable */
@@ -1756,4 +2229,4 @@ interface ErrorCardProps {
 /** 结构化错误卡：错误码徽章 + 描述 + 建议（engine error 事件 / 失败 run） @stable */
 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 ChatbotGovernancePorts, type ChatbotHostAdapter, type ChatbotProps, CompositeUiBridge, type CompositeUiBridgeDeps, DEFAULT_RENDERER_CAPABILITIES, 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 SandboxExecutorDeps, SettingsDrawer, type SettingsDrawerProps, SkillBadges, SpecInteraction, type SpecInteractionProps, VercelPayloadPreview, type VercelPayloadPreviewProps, VercelSurfaceHost, type VercelSurfaceHostProps, VercelSurfaceSnapshotHost, type VercelSurfaceSnapshotHostProps, chatbotDictionary, configureA2uiMarkdown, probeA2uiAvailability, probeOpenUiAvailability, useT };
+export { A2uiSurfaceHost, type A2uiSurfaceHostProps, A2uiSurfaceSnapshotHost, type A2uiSurfaceSnapshotHostProps, type AppearanceChange, 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, SettingsDrawer, type SettingsDrawerProps, SkillBadges, SpecInteraction, type SpecInteractionProps, type UserProfileApi, type UserProfileImportDiff, VercelPayloadPreview, type VercelPayloadPreviewProps, VercelSurfaceHost, type VercelSurfaceHostProps, VercelSurfaceSnapshotHost, type VercelSurfaceSnapshotHostProps, chatbotDictionary, configureA2uiMarkdown, createLocalStorageRuntimeConfigStore, createMemoryRuntimeConfigStore, probeA2uiAvailability, probeOpenUiAvailability, useT };