@webskill/chatbot 0.0.2 → 0.2.0

package/dist/index.d.ts

@@ -1,10 +1,11 @@
-import { AgentLoopConfig, ApprovalScope, BridgeCapabilities, ExternalSkillProvider, ExternalToolSource, FileSystemProvider, InteractionRequest, InteractionResponse, LlmClient, NetworkPolicy, RenderBlock, RenderResultRequest, RunSnapshot, RunSnapshot as RunSnapshot$1, RuntimePhase, ScriptExecutor, UiBridge, UiSurfaceActionRequest, UiSurfaceActionResponse, UiSurfaceDrafts, UiSurfaceEvent, UiSurfaceSnapshot } from "@webskill/sdk";
-import { SandboxMode } from "@webskill/sdk/browser";
-import { ReactBridgeState, SurfaceRegistry, UiSurfaceActionEvent } from "@webskill/sdk/ui-react";
-import "@webskill/sdk/ui";
+import { 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 { 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";
 import "react";
 import "react/jsx-runtime";
 //#region ../ui-kit/src/i18n/types.d.ts
+/** @stable */
 type Locale = 'zh' | 'en';
 /** 单语言词条：key → 文案（支持 {name} 占位插值） */
 type LocaleMessages = Record<string, string>;
@@ -60,6 +61,12 @@ interface RuntimeInteractionConfig {
   approvalScope: ApprovalScope$1;
 }
 type RuntimeRouterStrategy = 'progressive' | 'full-disclosure';
+/** 生命周期钩子执行策略（`HookRunnerOptions` 的可配置部分） */
+interface RuntimeHooksConfig {
+  timeoutMs: number;
+  /** true 时钩子异常终止 run；缺省隔离为 warning */
+  failOnHookError: boolean;
+}
 /** 浏览器宿主执行器档位；Node 宿主的 in-process/worker/process 由宿主侧扩展展示 */
 type RuntimeSandboxExecutor = 'auto' | 'blob-worker' | 'iframe-sandbox';
 interface RuntimeSandboxConfig {
@@ -70,26 +77,97 @@ interface RuntimeSandboxConfig {
     writeArtifact: CapabilityMode;
     confirm: CapabilityMode;
   };
+  /**
+   * 出站 URL 准入策略（`RemoteUrlPolicy` 的可配置部分）：技能安装、MCP 端点连接
+   * 这类由宿主发起的取数都按它判定。两项都默认关，即 https-only 且拒绝内网/环回。
+   */
+  remoteUrl: RuntimeRemoteUrlConfig;
+  /** 浏览器沙箱的 TypeScript 支持；关闭时 `.ts` 脚本按 `TOOL_UNSUPPORTED` 拒绝 */
+  typescript: RuntimeTypeScriptConfig;
+}
+/**
+ * 只做类型擦除，不做类型检查。`esbuildUrl` 为绝对 http(s) 地址时按 `remoteUrl` 判定；
+ * 同源相对路径与打包器 specifier 不属于出站请求，不参与判定。
+ */
+interface RuntimeTypeScriptConfig {
+  enabled: boolean;
+  /** esbuild-wasm 的 JS 入口地址；enabled 时必填 */
+  esbuildUrl?: string;
+  /** esbuild.wasm 二进制地址；缺省由 esbuild 自行推导 */
+  wasmUrl?: string;
+}
+/** 与 `@webskill/core` 的 `RemoteUrlPolicy` 同形，但两个字段都是必填（配置需要确定值） */
+interface RuntimeRemoteUrlConfig {
+  allowHttp: boolean;
+  allowPrivateHosts: boolean;
 }
-type RuntimeLlmProvider = 'openai-compatible' | 'anthropic' | 'google';
-interface RuntimeLlmConfig {
+/** `chrome-builtin` 走浏览器 Prompt API，无端点与密钥；其余三档是云端 HTTP 协议 */
+type RuntimeLlmProvider = 'openai-compatible' | 'anthropic' | 'google' | 'chrome-builtin';
+/**
+ * 单个模型条目。`id` 稳定，会话记录与消息归属存的是它，用户改名不影响历史；
+ * `label` 只用于展示——同一个 `model` 可能配了两个不同的 `baseUrl`（公司代理与直连），
+ * 光看 `model` 区分不出来。
+ */
+interface RuntimeLlmEntry {
+  id: string;
+  label: string;
   provider: RuntimeLlmProvider;
   baseUrl?: string;
   apiKey?: string;
   model: string;
   requestTimeoutMs?: number;
 }
+/** 模型列表 + 默认项。`defaultId` 由 `mergeRuntimeConfigDefaults` 归一到真实存在的条目 */
+interface RuntimeLlmSelection {
+  entries: readonly RuntimeLlmEntry[];
+  defaultId?: string;
+}
+/**
+ * Agent 能力开关（0.5.0）。默认值逐项经需求评审确定，不适用「新能力一律默认关」的通则。
+ * `todo`：待办清单，默认**开启**——不引入新攻击面、提示词体积远小于生成式 UI catalog，
+ * 且关闭时多步任务体验明显更差。
+ * `skillGeneration`：技能自动生成，默认**关闭**——会把对话内容写进持久化的候选，
+ * 属于新增攻击面（AC-G7 判据一）。
+ * `generativeUi`：生成式 UI，默认**关闭**——catalog 描述约 14 KB 计入每次请求。
+ * `formAutofill`：跨会话表单自动填充，默认**关闭**（FR-5.10）——会把用户亲手填的内容
+ * （可能是手机号、地址）跨会话持久化，属新增攻击面。
+ * `uiPresets`：开放给模型的场景预设，默认全开——预设本体按需加载，
+ * 只有名字与一行摘要计入请求；置空列表等于完全关闭预设。
+ */
+interface RuntimeAgentCapabilitiesConfig {
+  todo: boolean;
+  skillGeneration: boolean;
+  generativeUi: boolean;
+  formAutofill: boolean;
+  /** 串行委派（FR-11.8）：默认关。一句话可能展开成多个子 run，调用量对用户不可预期 */
+  delegation: boolean;
+  uiPresets: string[];
+}
+/**
+ * 未签名技能的处置策略（与 core 的 `UnsignedPolicy` 同形，配置层独立命名）。
+ * 默认 `'warn'` 由需求评审定下（FR-1.2）：`deny` 会让现存未签名技能立即不可用，
+ * 且默认信任库为空时接受集为空；`allow` 等于策略不存在。
+ */
+type UnsignedSkillPolicy = 'allow' | 'warn' | 'deny';
+interface RuntimeSecurityConfig {
+  unsignedSkills: UnsignedSkillPolicy;
+}
+/** @experimental */
 interface RuntimeConfig {
   loop: RuntimeLoopConfig;
   interaction: RuntimeInteractionConfig;
   router: {
     strategy: RuntimeRouterStrategy;
   };
+  hooks: RuntimeHooksConfig;
   streaming: boolean;
   renderResult: boolean;
   sandbox: RuntimeSandboxConfig;
-  llm: RuntimeLlmConfig;
+  llm: RuntimeLlmSelection;
+  agentCapabilities: RuntimeAgentCapabilitiesConfig;
+  security: RuntimeSecurityConfig;
 }
+/** @experimental */
 interface RuntimeConfigStore {
   /**
    * Loads the runtime configuration. Implementations SHOULD return a complete
@@ -102,20 +180,79 @@ interface RuntimeConfigStore {
   reset(): Promise<void>;
 }
 //#endregion
+//#region ../ui-kit/src/runtime-config/preferences.d.ts
+/** 导出结构的版本；导入时逐字校验，不做向前兼容猜测 */
+declare const PREFERENCE_EXPORT_VERSION = 1;
+/**
+ * 模型条目的可导出形态。`Omit<RuntimeLlmEntry, 'apiKey'>` 让**编译期**就放不进密钥——
+ * 靠「序列化时记得删」依赖开发者不忘记，靠类型则依赖编译器（FR-5.2）。
+ * @experimental
+ */
+type PreferenceLlmEntry = Omit<RuntimeLlmEntry, 'apiKey'>;
+/** 宿主自己持有的外观状态（不在 `RuntimeConfig` 里，由调用方传入） @experimental */
+interface PreferenceAppearance {
+  theme?: string;
+  locale?: string;
+  renderer?: string;
+}
+/** @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[];
+    };
+  };
+}
+//#endregion
 //#region src/core/types.d.ts
+/**
+ * 治理 port 集合（F1）：宿主把 `SkillStatePolicy` 的适配器交给 chatbot，
+ * 由它接到内部装配的 `WebSkillRuntime` 上。字段名与 `WebSkillRuntimeDeps` 逐个对齐，
+ * 不做重命名：中间多一层映射只会让宿主多记一套名字。
+ * @experimental
+ */
+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[]>;
+}
+/** 分配式交叉：直接写 `信封 & 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（payload 预览档，
- * 展示 Vercel AI SDK 数据契约 JSON，非完整运行时）
+ * openui（@openuidev/react-lang Renderer，ui-kit Library）/ vercel（@json-render/react
+ * Registry 渲染 catalog 声明树）
+ * @experimental
  */
 type RendererKind = 'native' | 'a2ui' | 'openui' | 'vercel';
-/** OpenAI 兼容端点配置（全部缺省时使用内置演示 LLM） */
-interface LlmConfig {
-  baseUrl?: string;
-  apiKey?: string;
-  model?: string;
-}
-/** assistant 消息所属 run 的一次工具调用（终态：completed/failed） */
+/** assistant 消息所属 run 的一次工具调用（终态：completed/failed） @stable */
 interface ChatToolCall {
   callId: string;
   name: string;
@@ -124,8 +261,15 @@ interface ChatToolCall {
   args?: string;
   /** 执行耗时（trace completed/failed 回填；live 由 started→终态计时） */
   durationMs?: number;
+  /**
+   * failed 时的结构化错误码（如 `TOOL_NOT_ALLOWED`）。
+   * 「被策略拒绝」与「执行失败」在 UI 上是两回事，靠错误码区分而不是解析文案。
+   */
+  errorCode?: string;
+  /** failed 时的错误说明（拒绝时即「被哪条策略拒绝」） */
+  errorMessage?: string;
 }
-/** 已落盘的待发送附件（composer 附件适配器产出） */
+/** 已落盘的待发送附件（composer 附件适配器产出） @experimental */
 interface ChatAttachmentInput {
   id: string;
   name: string;
@@ -134,11 +278,12 @@ interface ChatAttachmentInput {
   path: string;
   size: number;
 }
-/** 随消息持久化的附件元数据 */
+/** 随消息持久化的附件元数据 @experimental */
 interface ChatAttachmentMeta extends ChatAttachmentInput {
   /** 注入模型的内容形态；text 以外的类型当前不接收（runtime 只收纯文本 prompt） */
   kind: 'text';
 }
+/** @stable */
 interface ChatMessage {
   id: string;
   role: 'user' | 'assistant';
@@ -158,8 +303,22 @@ interface ChatMessage {
    */
   blocks?: RenderBlock[];
   /** The completed generative UI surfaces emitted by this run, retained for history replay. */
-  surfaces?: UiSurfaceSnapshot[];
+  surfaces?: UiSpecSnapshot[];
+  /** 该 run 的待办清单终态（历史消息重放；未产生清单时缺省） */
+  todos?: TodoItem[];
+  /**
+   * 该 run 内发生的页面只读感知（需求 10 FR-10.5）。
+   * 随消息持久化而不只在运行中闪现——事后仍能查到「那一次它读了哪些区域」。
+   * @experimental
+   */
+  perceptions?: PerceptionRecord[];
+  /**
+   * 发出本轮请求的模型条目 id（`RuntimeConfig.llm.entries[].id`）。
+   * 写在消息上而不是会话上：切换模型只对后续消息生效，已有消息的归属不能被改写。
+   */
+  model?: string;
 }
+/** @stable */
 interface ChatSessionMeta {
   id: string;
   createdAt: string;
@@ -169,6 +328,7 @@ interface ChatSessionMeta {
   /** 用户已手动重命名：后续 send 不再用首条消息覆盖标题 */
   titleLocked?: boolean;
 }
+/** @stable */
 type ChatEvent = {
   type: 'run-started';
   runId: string;
@@ -201,12 +361,21 @@ type ChatEvent = {
   callId: string;
   name: string;
   args?: string;
+  errorCode?: string;
 } | {
   type: 'run-completed';
   runId: string;
   status: 'completed' | 'failed' | 'cancelled';
   output: string;
   activeSkillNames: string[];
+} | {
+  type: 'todo-changed';
+  runId: string;
+  items: readonly TodoItem[];
+} | {
+  type: 'page-perceived';
+  runId: string;
+  record: PerceptionRecord;
 } | {
   type: 'interaction-requested';
   id: string;
@@ -216,13 +385,7 @@ type ChatEvent = {
   id: string;
   requestType: InteractionRequest['type'];
   cancelled?: boolean;
-} | {
-  type: 'lifecycle';
-  runId: string;
-  phase: RuntimePhase;
-  at: number;
-  data?: Record<string, unknown>;
-} | {
+} | LifecycleChatEvent | {
   type: 'session-updated';
   session: ChatSessionMeta;
 } | {
@@ -233,6 +396,7 @@ type ChatEvent = {
   message: string;
   code?: string;
 };
+/** @stable */
 interface ChatbotConfig {
   /** header 标题，默认 'WebSkill Chat' */
   title?: string;
@@ -240,7 +404,7 @@ interface ChatbotConfig {
   placeholder?: string;
   /** 会话/trace/artifact 存储根，默认 '/chat' */
   chatRoot?: string;
-  /** 覆盖 LLM（缺省走 adapter.llmConfig → 内置演示 LLM 的选择链） */
+  /** 覆盖 LLM（缺省走 `RuntimeConfig.llm` → 内置演示 LLM 的选择链） */
   llm?: LlmClient;
   /** AgentLoop 调参（maxTurns、超时等） */
   loopConfig?: AgentLoopConfig;
@@ -254,23 +418,36 @@ interface ChatbotConfig {
   /**
    * 开启后模型多一个 `render_ui` 工具，可面向 AI Component Catalog 直接生成声明式 UI。
    * 默认关：工具描述 + 入参 schema 约 14 KB，会计入每一次请求。
+   *
+   * 接了 `runtimeConfig` 时以 `RuntimeConfig.agentCapabilities.generativeUi` 为准
+   * （设置抽屉里的开关就是它），本字段只在未接配置存储的宿主上生效。
    */
   generativeUi?: boolean;
+  /** 宿主注册好钩子的 `HookRunner`；执行策略（超时/严格模式）按 `RuntimeConfig.hooks` 应用 */
+  hooks?: HookRunner;
+  /**
+   * 治理 port 注入（F1）：透传给 `ChatEngineOptions.governance`。
+   * 不注入即完全关闭，行为与 0.0.2 一致。
+   */
+  governance?: ChatbotGovernancePorts;
+  /**
+   * 技能自动生成的候选收货端（需求 9）：透传给 `ChatEngineOptions.skillCandidates`。
+   * 开关只决定工具进不进列表，候选往哪存由宙主注入；不注入时工具返回
+   * `SKILL_GENERATION_DISABLED`，不弹确认框、不产生候选。
+   */
+  skillCandidates?: SkillCandidateSink;
 }
 //#endregion
 //#region src/core/hostAdapter.d.ts
 /**
  * 宿主装配口：chatbot 不感知环境（浏览器/Node），全部能力经此注入。
  * 页面动态技能来源同时是外部工具来源与外部技能提供者（同一对象两个 port）。
+ * LLM 配置不在这里——它统一由 `RuntimeConfigStore` 承载（0.5.0 起）。
+ * @stable
  */
 interface ChatbotHostAdapter {
   storage: FileSystemProvider;
   skillRoots: string[];
-  llmConfig: {
-    load(): Promise<LlmConfig | undefined>;
-    save(config: LlmConfig): Promise<void>;
-    clear(): Promise<void>;
-  };
   pageSkillSource?: ExternalToolSource & ExternalSkillProvider;
   navigation: {
     openConsole(): void;
@@ -279,94 +456,17 @@ interface ChatbotHostAdapter {
   };
   /** 缺省 BrowserWorkerScriptExecutor（@webskill/browser）；Node 宿主可注入自己的执行器 */
   executor?: ScriptExecutor;
-}
-//#endregion
-//#region src/core/interactionBridge.d.ts
-/**
- * 探测 A2UI Lit 渲染器是否可用（@a2ui/lit 为 optional peer，未安装时 import 失败）。
- * Appearance/设置区据此对 A2UI 档置灰；仅动态 import，不强依赖。
- */
-declare function probeA2uiAvailability(): Promise<boolean>;
-/**
- * 为 A2UI 挂载容器配置 Markdown 渲染（@a2ui/markdown-it，optional peer）：
- * 经 @lit/context 向 surface 子树注入 renderMarkdown（markdown-it + dompurify），
- * 消除 "[MarkdownDirective] can't render markdown" 降级。
- * 未安装时返回 false（宿主可据此保留产品化限制说明）。
- */
-declare function configureA2uiMarkdown(mount: HTMLElement): Promise<boolean>;
-/**
- * 探测 OpenUI 渲染器是否可用（@openuidev/react-lang 为 optional peer）。
- * Appearance/设置区据此对 OpenUI 档置灰；仅动态 import，不强依赖。
- */
-declare function probeOpenUiAvailability(): Promise<boolean>;
-/** openui 档一次待决交互（lang 文本由 react 层交给 @openuidev/react-lang Renderer 渲染） */
-interface OpenUiSession {
-  request: InteractionRequest;
-  lang: string;
-}
-/**
- * OpenUI 交互通道（core 层，不 import react）：
- * - request() 把 InteractionRequest 转成 openui-lang 文本并挂起，react 层
- *   （OpenUiInteraction）订阅 current 后动态加载 @openuidev/react-lang 渲染；
- * - 动作事件经 handleAction → fromOpenUiAction（含 authorize Allow/Deny 语义）回传；
- * - react 层初始化失败调 fail()：挂起请求 reject（桥据此粘性降级 native）并记录原因；
- * - attach/detach 标记渲染视图是否挂载（未挂载时桥直接降级 native，不悬挂请求）。
- */
-declare class OpenUiChannel {
-  #private;
-  /** React useSyncExternalStore 兼容订阅 */
-  subscribe: (listener: () => void) => (() => void);
-  get current(): OpenUiSession | undefined;
-  get isAttached(): boolean;
-  /** react 层初始化失败原因（未安装 @openuidev/react-lang 等）；记录后粘性生效 */
-  get failure(): string | undefined;
-  attach(): void;
-  detach(): void;
-  request(input: InteractionRequest): Promise<InteractionResponse>;
-  /** runtime 交互超时/取消：以 cancelled resolve 挂起的 request（防悬挂 + 残留） */
-  cancel(id: string): void;
-  /** react 层 OpenUI 动作回传（fromOpenUiAction：Allow → value:true；Deny/Cancel → cancelled:true） */
-  handleAction(action: unknown): void;
-  /** react 层初始化失败：挂起请求 reject 并记录原因（桥读取后降级 native） */
-  fail(message: string): void;
-}
-interface CompositeUiBridgeDeps {
-  /** native 档交互 + streamingText/renderResult 数据源（始终生效；vercel 预览档也走它） */
-  reactBridge: ReactBridgeState;
-  getRenderer(): RendererKind;
-  /** a2ui 档交互容器（Chatbot ref 回调注入；未挂载时 a2ui 请求降级 native） */
-  getInteractionMount(): HTMLElement | undefined;
-  /** openui 档交互通道（引擎持有；react 层 OpenUiInteraction attach 后生效） */
-  getOpenUiChannel(): OpenUiChannel;
-  emit(event: ChatEvent): void;
-}
-/**
- * 复合 UiBridge（P2/P3 渲染框架档）：
- * - streamingText / renderResult 始终委托 ReactBridgeState（结果块数据源不变）；
- * - 交互 request/cancel 按渲染档分发：native → ReactBridgeState（InteractionCard），
- *   a2ui → LitRendererBridge（@a2ui/lit，容器由 Chatbot 提供），
- *   openui → OpenUiChannel（@openuidev/react-lang Renderer 由 react 层装配），
- *   vercel → ReactBridgeState（payload 预览卡消费 bridge.pending，仅可取消）；
- * - 每次交互开始/结束发 interaction-requested/resolved 事件（UI 据此显隐 a2ui 容器）；
- * - a2ui/openui 初始化失败（optional peer 未安装等）降级 native + warning 事件，不阻断 run。
- */
-declare class CompositeUiBridge implements UiBridge {
-  #private;
-  constructor(deps: CompositeUiBridgeDeps);
-  /** 渲染档热切换：丢弃已建的 a2ui 桥与降级状态（新档立即生效，无需重装配 runtime） */
-  reset(): void;
-  request(input: InteractionRequest): Promise<InteractionResponse>;
-  /** runtime 交互超时/取消：按档委托（a2ui/openui 桥 cancel 会以 cancelled resolve 挂起的 request） */
-  cancel(id: string): void;
-  renderResult(input: RenderResultRequest): Promise<void>;
-  renderSurface(event: UiSurfaceEvent): Promise<void>;
-  requestSurfaceAction(input: UiSurfaceActionRequest): Promise<UiSurfaceActionResponse>;
-  cancelSurfaceAction(nonce: string): void;
-  onTextDelta(runId: string, delta: string): Promise<void>;
+  /**
+   * 页面只读感知策略（需求 10）。**只能在这里注入**：启用与否是宿主侧配置，
+   * 设置抽屉里没有也不会有开关（FR-10.1）——风险由部署方承担，
+   * 不应交给终端用户随手勾选。
+   * @experimental
+   */
+  pagePerception?: PagePerceptionPolicy;
 }
 //#endregion
 //#region src/core/chatEngine.d.ts
-/** 默认沙箱执行器的构造参数（adapter.executor 未注入时；executorFactory 替换点可见同一形状） */
+/** 默认沙箱执行器的构造参数（adapter.executor 未注入时；executorFactory 替换点可见同一形状） @stable */
 interface SandboxExecutorDeps {
   fs: FileSystemProvider;
   sandbox?: SandboxMode;
@@ -374,7 +474,10 @@ interface SandboxExecutorDeps {
   capabilities?: BridgeCapabilities;
   approvalScope?: ApprovalScope;
   uiBridge?: UiBridge;
+  /** 缺省时 `.ts` 脚本按 `TOOL_UNSUPPORTED` 拒绝 */
+  typescript?: TypeScriptSupportOptions;
 }
+/** @stable */
 interface ChatEngineOptions {
   llm?: LlmClient;
   loopConfig?: AgentLoopConfig;
@@ -383,27 +486,68 @@ interface ChatEngineOptions {
   runtimeConfig?: RuntimeConfigStore;
   /** 初始渲染框架档（默认 'native'；运行中可 setRenderer 热切换） */
   renderer?: RendererKind;
-  /** 注入 `render_ui` 工具，让模型面向 AI Component Catalog 生成声明式 UI */
+  /**
+   * 注入 `render_ui` 工具，让模型面向 AI Component Catalog 生成声明式 UI。
+   *
+   * 注入了 `runtimeConfig` 时**以 `RuntimeConfig.agentCapabilities.generativeUi` 为准**，
+   * 本字段只在未接配置存储的宿主上生效（否则设置面板里的开关点了不算数）。
+   */
   generativeUi?: boolean;
   /** 沙箱执行器替换点（测试注入 spy 断言构造参数；缺省 BrowserWorkerScriptExecutor） */
   executorFactory?: (deps: SandboxExecutorDeps) => ScriptExecutor;
+  /**
+   * 会话落盘替换点（缺省 `FsSessionStore`，落在 `<chatRoot>/sessions`）。
+   * 宕主换自己的实现（如 IndexedDB）与测试统计端口读写量都走这里。
+   */
+  sessionStore?: SessionStore<ChatMessage>;
+  /**
+   * 宿主已注册好钩子的执行器；装配时把 `RuntimeConfig.hooks` 应用到它再交给 runtime。
+   * 不注入即不挂钩子（与 0.0.2 行为一致）。
+   */
+  hooks?: HookRunner;
+  /**
+   * 治理 port 注入（F1）：把 `SkillStatePolicy` 的三个适配器接到本引擎装配的 runtime 上。
+   *
+   * 不注入即完全关闭，行为与 0.0.2 一致。装配点必须在宿主：chatbot 不能依赖
+   * `@webskill/governance`（它是可选治理层，且要求宿主提供治理根与审计存储）。
+   *
+   * 三个一起给才形成闭环——只给 `skillOutcomeReporter` 会把技能标成 `quarantined`
+   * 却仍旧照常路由和执行，降级形同虚设。
+   */
+  governance?: ChatbotGovernancePorts;
+  /**
+   * 技能自动生成的候选收货端（需求 12 号）。与 `governance` 同理，装配点在宿主：
+   * `@webskill/governance` 的 `createCandidateSink()` 是现成实现。
+   *
+   * 开关另在 `RuntimeConfig.agentCapabilities.skillGeneration`（默认关）；
+   * 开关开但未注入本端口时，工具会把 `SKILL_GENERATION_DISABLED` 回给模型。
+   */
+  skillCandidates?: SkillCandidateSink;
 }
 /**
  * 对话框引擎：装配 WebSkillRuntime + 会话持久化 + 事件分发。
- * llmConfig.load() 是异步的，runtime 在首次 send 前懒装配（#ensureReady）。
+ * 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;
   /** 渲染框架热切换：复合桥按档分发，无需重装配 runtime（会话句柄保留） */
   setRenderer(renderer: RendererKind): void;
-  /** a2ui 档交互容器注入（Chatbot ref 回调；卸载传 null） */
-  setInteractionMount(el: HTMLElement | null): void;
-  /** openui 档交互通道（Chatbot 的 OpenUiInteraction 订阅/attach；core 只产出 lang 文本） */
-  get openUiChannel(): OpenUiChannel;
+  /** 非 native 三档共用的交互通道（Chatbot 的 SpecInteraction 订阅/attach；core 只产出 catalog 节点树） */
+  get interactionChannel(): SpecInteractionChannel;
   /** 探测 @a2ui/lit 是否安装（Appearance/设置区 A2UI 档置灰判定） */
   probeA2uiAvailability(): Promise<boolean>;
   onEvent(listener: (event: ChatEvent) => void): () => void;
@@ -412,11 +556,21 @@ declare class ChatEngine {
    * runtime/llm/会话句柄，下次 send 重新装配（RuntimeConfig 重新 load() 应用）
    */
   reloadConfig(): void;
-  /** 旧名保留（与 reloadConfig 同语义，向后兼容） */
-  reloadLlm(): void;
-  listSessions(): Promise<ChatSessionMeta[]>;
+  /**
+   * 会话列表页。归档会话也返回：UI 自己分区展示。
+   * `limit` 不给默认值——缺省属于 `SessionStore` 实现，在这里兜底就等于只下推了一半。
+   */
+  listSessions(options?: PageQuery): Promise<Page<ChatSessionMeta>>;
   createSession(): Promise<ChatSessionMeta>;
-  selectSession(id: string): Promise<ChatMessage[]>;
+  /**
+   * 选中会话并取**最新**一页历史（页内时间升序）。
+   * 返回全量 `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>;
@@ -443,13 +597,92 @@ declare class ChatEngine {
   get attachmentsRoot(): string;
   /** 取消进行中的 run（Composer Stop 按钮）；run 未找到/已结束返回 false */
   cancel(runId: string): boolean;
-  /** 列出可恢复的 interrupted run（InterruptedBanner 数据源） */
-  listInterrupted(): Promise<RunSnapshot$1[]>;
+  /** 列出 interrupted run（InterruptedBanner 数据源）；版本不受支持的项带 unsupported 标记 */
+  listInterrupted(): Promise<RunSnapshotListEntry[]>;
   /**
    * 恢复 interrupted run：等待中的交互重新进入 bridge.pending（UI 复用 InteractionForm），
    * 完成后与 send 同路径（assistant 消息持久化 + run-completed + trace 落盘）。
    */
   resume(runId: string): Promise<void>;
+  /**
+   * 清除跨会话表单填写历史（FR-5.11）。不传 `fieldKey` 即整体清空。
+   * 与开关分开：关掉开关只是停止召回，用户往往还想把已存的内容删干净。
+   * @experimental
+   */
+  clearFormAutofill(fieldKey?: string): Promise<void>;
+}
+//#endregion
+//#region src/core/interactionBridge.d.ts
+/** 单个渲染档的能力集（复合桥判定该不该回落 native 的唯一数据源） @experimental */
+interface RendererCapability {
+  /** 路径 A：runtime 发起的交互请求能否在本档内渲染 */
+  interaction: boolean;
+  /** 路径 B：模型产出的 surface 能否在本档内渲染 */
+  surface: boolean;
+  /** 本档依赖的 optional peer 包名（未安装 → 粘性降级 native） */
+  requiresPeer?: string;
+}
+/**
+ * 渲染档 → 能力集。四档在 0.4.0 起 interaction/surface 全部等价，
+ * 差别只剩「是否依赖 optional peer」。作为可注入值传入 CompositeUiBridge，
+ * 便于宿主按实际装配情况覆盖（例如已确认某 peer 不可用）。
+ * @experimental
+ */
+declare const DEFAULT_RENDERER_CAPABILITIES: Readonly<Record<RendererKind, RendererCapability>>;
+/**
+ * 探测 A2UI Lit 渲染器是否可用（@a2ui/lit 为 optional peer，未安装时 import 失败）。
+ * Appearance/设置区据此对 A2UI 档置灰；仅动态 import，不强依赖。
+ * @experimental
+ */
+declare function probeA2uiAvailability(): Promise<boolean>;
+/**
+ * 为 A2UI 挂载容器配置 Markdown 渲染（@a2ui/markdown-it，optional peer）：
+ * 经 @lit/context 向 surface 子树注入 renderMarkdown（markdown-it + dompurify），
+ * 消除 "[MarkdownDirective] can't render markdown" 降级。
+ * 未安装时返回 false（宿主可据此保留产品化限制说明）。
+ * @experimental
+ */
+declare function configureA2uiMarkdown(mount: HTMLElement): Promise<boolean>;
+/**
+ * 探测 OpenUI 渲染器是否可用（@openuidev/react-lang 为 optional peer）。
+ * Appearance/设置区据此对 OpenUI 档置灰；仅动态 import，不强依赖。
+ * @experimental
+ */
+declare function probeOpenUiAvailability(): Promise<boolean>;
+/** @stable */
+interface CompositeUiBridgeDeps {
+  /** native 档交互 + streamingText/renderResult 数据源（始终生效，也是各档降级后的接管方） */
+  reactBridge: ReactBridgeState;
+  getRenderer(): RendererKind;
+  /** 非 native 三档共用的交互通道（引擎持有；本档交互视图 attach 后生效） */
+  getInteractionChannel(): SpecInteractionChannel;
+  /** 渲染档能力表（省略用 DEFAULT_RENDERER_CAPABILITIES） */
+  capabilities?: Readonly<Record<RendererKind, RendererCapability>>;
+  emit(event: ChatEvent): void;
+}
+/**
+ * 复合 UiBridge（P2/P3 渲染框架档）：
+ * - streamingText / renderResult 始终委托 ReactBridgeState（结果块数据源不变）；
+ * - 交互 request/cancel 按渲染档分发：native → ReactBridgeState（InteractionCard），
+ *   其余三档 → SpecInteractionChannel（core 产出 catalog 节点树，react 层交给本档
+ *   已有的 spec 渲染路径：A2uiSpecSurface / OpenUiSpecSurface / JsonRenderSpecSurface）；
+ * - 每次交互开始/结束发 interaction-requested/resolved 事件；
+ * - 非 native 档初始化失败（optional peer 未安装等）降级 native + warning 事件，不阻断 run。
+ * @stable
+ */
+declare class CompositeUiBridge implements UiBridge {
+  #private;
+  constructor(deps: CompositeUiBridgeDeps);
+  /** 渲染档热切换：清降级状态（新档立即生效，无需重装配 runtime） */
+  reset(): void;
+  request(input: InteractionRequest): Promise<InteractionResponse>;
+  /** runtime 交互超时/取消：按档委托（通道 cancel 会以 cancelled resolve 挂起的 request） */
+  cancel(id: string): void;
+  renderResult(input: RenderResultRequest): Promise<void>;
+  renderSurface(event: UiSpecEvent): Promise<void>;
+  requestSurfaceAction(input: UiSurfaceActionRequest): Promise<UiSurfaceActionResponse>;
+  cancelSurfaceAction(nonce: string): void;
+  onTextDelta(runId: string, delta: string): Promise<void>;
 }
 //#endregion
 //#region src/i18n.d.ts
@@ -457,6 +690,7 @@ declare class ChatEngine {
  * chatbot 双语字典：全部 UI 文案的单一来源（英文为主，zh 条目齐全）。
  * 特性区块（WelcomeScreen / SettingsDrawer 各节 / authorize 说明等）必须含
  * title + description 双语条目——"会说话的 UI"的文案底座。
+ * @stable
  */
 declare const chatbotDictionary: {
   en: {
@@ -469,6 +703,14 @@ declare const chatbotDictionary: {
     'session.searchPlaceholder': string;
     'session.empty': string;
     'session.delete': string;
+    'session.rename': string;
+    'session.renameInput': string;
+    'session.archive': string;
+    'session.unarchive': string;
+    'session.archived': string;
+    'session.loadEarlier': string;
+    'session.loading': string;
+    'message.loadEarlier': string;
     'welcome.title': string;
     'welcome.assistantTitle': string;
     'welcome.description': string;
@@ -494,8 +736,11 @@ declare const chatbotDictionary: {
     'tool.status.running': string;
     'tool.status.completed': string;
     'tool.status.failed': string;
+    'tool.status.denied': string;
     'tool.duration': string;
     'tool.args': string;
+    'tool.denied.reason': string;
+    'tool.failed.reason': string;
     'cot.thinking': string;
     'cot.thought': string;
     'cot.summary': string;
@@ -503,12 +748,20 @@ declare const chatbotDictionary: {
     'cot.working': string;
     'trace.title': string;
     'trace.skill': string;
+    'perception.reading': string;
+    'perception.excluded': string;
     'trace.phase.route': string;
     'trace.phase.activate': string;
     'trace.phase.execute': string;
     'trace.phase.interact': string;
     'trace.phase.complete': string;
     'trace.phase.fail': string;
+    'todo.title': string;
+    'todo.progress': string;
+    'todo.status.pending': string;
+    'todo.status.inProgress': string;
+    'todo.status.completed': string;
+    'todo.delegatedTo': string;
     'interaction.ask.title': string;
     'interaction.confirm.title': string;
     'interaction.form.title': string;
@@ -517,6 +770,7 @@ declare const chatbotDictionary: {
     'interaction.authorize.description': string;
     'interaction.authorize.capability': string;
     'interaction.authorize.details': string;
+    'interaction.origin': string;
     'interaction.submit': string;
     'interaction.cancel': string;
     'interaction.confirm': string;
@@ -544,14 +798,37 @@ declare const chatbotDictionary: {
     'composer.attachments': string;
     'composer.addAttachment': string;
     'composer.removeAttachment': string;
+    'composer.model': string;
+    'composer.model.demo': 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.model.title': string;
     'settings.model.description': string;
+    'settings.model.empty': string;
+    'settings.model.add': string;
+    'settings.model.edit': string;
+    'settings.model.remove': string;
+    'settings.model.setDefault': string;
+    'settings.model.default': string;
+    'settings.model.label': string;
+    'settings.model.labelNote': string;
+    'settings.model.unavailable': string;
+    'settings.model.cancel': string;
     'settings.provider': string;
     'settings.providerNote': string;
     'settings.provider.openai-compatible': string;
     'settings.provider.anthropic': string;
     'settings.provider.google': string;
+    'settings.provider.chrome-builtin': string;
+    'settings.provider.chrome-builtin.note': string;
+    'settings.provider.chrome-builtin.limitation': string;
+    'settings.chromeBuiltin.api-missing': string;
+    'settings.chromeBuiltin.model-not-ready': string;
+    'settings.chromeBuiltin.unsupported-browser': string;
     'settings.provider.anthropic.note': string;
     'settings.provider.google.note': string;
     'settings.endpoint': string;
@@ -571,6 +848,30 @@ declare const chatbotDictionary: {
     'settings.demoNote': string;
     'settings.save': string;
     'settings.clear': string;
+    'settings.agent.title': string;
+    'settings.agent.description': string;
+    'settings.agent.todo': string;
+    'settings.agent.todoNote': string;
+    'settings.agent.generativeUi': string;
+    'settings.agent.generativeUiNote': string;
+    'settings.agent.skillGeneration': string;
+    '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.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;
@@ -588,6 +889,7 @@ declare const chatbotDictionary: {
     'vercel.preview.title': string;
     'vercel.preview.badge': string;
     'vercel.preview.description': string;
+    'surface.legacy.placeholder': string;
     'error.title': string;
     'error.suggestion': string;
     'error.dismiss': string;
@@ -602,6 +904,14 @@ declare const chatbotDictionary: {
     'session.searchPlaceholder': string;
     'session.empty': string;
     'session.delete': string;
+    'session.rename': string;
+    'session.renameInput': string;
+    'session.archive': string;
+    'session.unarchive': string;
+    'session.archived': string;
+    'session.loadEarlier': string;
+    'session.loading': string;
+    'message.loadEarlier': string;
     'welcome.title': string;
     'welcome.assistantTitle': string;
     'welcome.description': string;
@@ -627,8 +937,11 @@ declare const chatbotDictionary: {
     'tool.status.running': string;
     'tool.status.completed': string;
     'tool.status.failed': string;
+    'tool.status.denied': string;
     'tool.duration': string;
     'tool.args': string;
+    'tool.denied.reason': string;
+    'tool.failed.reason': string;
     'cot.thinking': string;
     'cot.thought': string;
     'cot.summary': string;
@@ -636,12 +949,20 @@ declare const chatbotDictionary: {
     'cot.working': string;
     'trace.title': string;
     'trace.skill': string;
+    'perception.reading': string;
+    'perception.excluded': string;
     'trace.phase.route': string;
     'trace.phase.activate': string;
     'trace.phase.execute': string;
     'trace.phase.interact': string;
     'trace.phase.complete': string;
     'trace.phase.fail': string;
+    'todo.title': string;
+    'todo.progress': string;
+    'todo.status.pending': string;
+    'todo.status.inProgress': string;
+    'todo.status.completed': string;
+    'todo.delegatedTo': string;
     'interaction.ask.title': string;
     'interaction.confirm.title': string;
     'interaction.form.title': string;
@@ -650,6 +971,7 @@ declare const chatbotDictionary: {
     'interaction.authorize.description': string;
     'interaction.authorize.capability': string;
     'interaction.authorize.details': string;
+    'interaction.origin': string;
     'interaction.submit': string;
     'interaction.cancel': string;
     'interaction.confirm': string;
@@ -677,14 +999,37 @@ declare const chatbotDictionary: {
     'composer.attachments': string;
     'composer.addAttachment': string;
     'composer.removeAttachment': string;
+    'composer.model': string;
+    'composer.model.demo': 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.model.title': string;
     'settings.model.description': string;
+    'settings.model.empty': string;
+    'settings.model.add': string;
+    'settings.model.edit': string;
+    'settings.model.remove': string;
+    'settings.model.setDefault': string;
+    'settings.model.default': string;
+    'settings.model.label': string;
+    'settings.model.labelNote': string;
+    'settings.model.unavailable': string;
+    'settings.model.cancel': string;
     'settings.provider': string;
     'settings.providerNote': string;
     'settings.provider.openai-compatible': string;
     'settings.provider.anthropic': string;
     'settings.provider.google': string;
+    'settings.provider.chrome-builtin': string;
+    'settings.provider.chrome-builtin.note': string;
+    'settings.provider.chrome-builtin.limitation': string;
+    'settings.chromeBuiltin.api-missing': string;
+    'settings.chromeBuiltin.model-not-ready': string;
+    'settings.chromeBuiltin.unsupported-browser': string;
     'settings.provider.anthropic.note': string;
     'settings.provider.google.note': string;
     'settings.endpoint': string;
@@ -704,6 +1049,30 @@ declare const chatbotDictionary: {
     'settings.demoNote': string;
     'settings.save': string;
     'settings.clear': string;
+    'settings.agent.title': string;
+    'settings.agent.description': string;
+    'settings.agent.todo': string;
+    'settings.agent.todoNote': string;
+    'settings.agent.generativeUi': string;
+    'settings.agent.generativeUiNote': string;
+    'settings.agent.skillGeneration': string;
+    '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.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;
@@ -721,12 +1090,13 @@ declare const chatbotDictionary: {
     'vercel.preview.title': string;
     'vercel.preview.badge': string;
     'vercel.preview.description': string;
+    'surface.legacy.placeholder': string;
     'error.title': string;
     'error.suggestion': string;
     'error.dismiss': string;
   };
 };
-/** chatbot 组件取文案：t('welcome.title') / t('tool.summary.other', { count: 3 }) */
+/** chatbot 组件取文案：t('welcome.title') / t('tool.summary.other', { count: 3 }) @stable */
 declare const useT: () => TranslateFn<{
   en: {
     'app.title': string;
@@ -738,6 +1108,14 @@ declare const useT: () => TranslateFn<{
     'session.searchPlaceholder': string;
     'session.empty': string;
     'session.delete': string;
+    'session.rename': string;
+    'session.renameInput': string;
+    'session.archive': string;
+    'session.unarchive': string;
+    'session.archived': string;
+    'session.loadEarlier': string;
+    'session.loading': string;
+    'message.loadEarlier': string;
     'welcome.title': string;
     'welcome.assistantTitle': string;
     'welcome.description': string;
@@ -763,8 +1141,11 @@ declare const useT: () => TranslateFn<{
     'tool.status.running': string;
     'tool.status.completed': string;
     'tool.status.failed': string;
+    'tool.status.denied': string;
     'tool.duration': string;
     'tool.args': string;
+    'tool.denied.reason': string;
+    'tool.failed.reason': string;
     'cot.thinking': string;
     'cot.thought': string;
     'cot.summary': string;
@@ -772,12 +1153,20 @@ declare const useT: () => TranslateFn<{
     'cot.working': string;
     'trace.title': string;
     'trace.skill': string;
+    'perception.reading': string;
+    'perception.excluded': string;
     'trace.phase.route': string;
     'trace.phase.activate': string;
     'trace.phase.execute': string;
     'trace.phase.interact': string;
     'trace.phase.complete': string;
     'trace.phase.fail': string;
+    'todo.title': string;
+    'todo.progress': string;
+    'todo.status.pending': string;
+    'todo.status.inProgress': string;
+    'todo.status.completed': string;
+    'todo.delegatedTo': string;
     'interaction.ask.title': string;
     'interaction.confirm.title': string;
     'interaction.form.title': string;
@@ -786,6 +1175,7 @@ declare const useT: () => TranslateFn<{
     'interaction.authorize.description': string;
     'interaction.authorize.capability': string;
     'interaction.authorize.details': string;
+    'interaction.origin': string;
     'interaction.submit': string;
     'interaction.cancel': string;
     'interaction.confirm': string;
@@ -813,14 +1203,37 @@ declare const useT: () => TranslateFn<{
     'composer.attachments': string;
     'composer.addAttachment': string;
     'composer.removeAttachment': string;
+    'composer.model': string;
+    'composer.model.demo': 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.model.title': string;
     'settings.model.description': string;
+    'settings.model.empty': string;
+    'settings.model.add': string;
+    'settings.model.edit': string;
+    'settings.model.remove': string;
+    'settings.model.setDefault': string;
+    'settings.model.default': string;
+    'settings.model.label': string;
+    'settings.model.labelNote': string;
+    'settings.model.unavailable': string;
+    'settings.model.cancel': string;
     'settings.provider': string;
     'settings.providerNote': string;
     'settings.provider.openai-compatible': string;
     'settings.provider.anthropic': string;
     'settings.provider.google': string;
+    'settings.provider.chrome-builtin': string;
+    'settings.provider.chrome-builtin.note': string;
+    'settings.provider.chrome-builtin.limitation': string;
+    'settings.chromeBuiltin.api-missing': string;
+    'settings.chromeBuiltin.model-not-ready': string;
+    'settings.chromeBuiltin.unsupported-browser': string;
     'settings.provider.anthropic.note': string;
     'settings.provider.google.note': string;
     'settings.endpoint': string;
@@ -840,6 +1253,30 @@ declare const useT: () => TranslateFn<{
     'settings.demoNote': string;
     'settings.save': string;
     'settings.clear': string;
+    'settings.agent.title': string;
+    'settings.agent.description': string;
+    'settings.agent.todo': string;
+    'settings.agent.todoNote': string;
+    'settings.agent.generativeUi': string;
+    'settings.agent.generativeUiNote': string;
+    'settings.agent.skillGeneration': string;
+    '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.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;
@@ -857,6 +1294,7 @@ declare const useT: () => TranslateFn<{
     'vercel.preview.title': string;
     'vercel.preview.badge': string;
     'vercel.preview.description': string;
+    'surface.legacy.placeholder': string;
     'error.title': string;
     'error.suggestion': string;
     'error.dismiss': string;
@@ -871,6 +1309,14 @@ declare const useT: () => TranslateFn<{
     'session.searchPlaceholder': string;
     'session.empty': string;
     'session.delete': string;
+    'session.rename': string;
+    'session.renameInput': string;
+    'session.archive': string;
+    'session.unarchive': string;
+    'session.archived': string;
+    'session.loadEarlier': string;
+    'session.loading': string;
+    'message.loadEarlier': string;
     'welcome.title': string;
     'welcome.assistantTitle': string;
     'welcome.description': string;
@@ -896,8 +1342,11 @@ declare const useT: () => TranslateFn<{
     'tool.status.running': string;
     'tool.status.completed': string;
     'tool.status.failed': string;
+    'tool.status.denied': string;
     'tool.duration': string;
     'tool.args': string;
+    'tool.denied.reason': string;
+    'tool.failed.reason': string;
     'cot.thinking': string;
     'cot.thought': string;
     'cot.summary': string;
@@ -905,12 +1354,20 @@ declare const useT: () => TranslateFn<{
     'cot.working': string;
     'trace.title': string;
     'trace.skill': string;
+    'perception.reading': string;
+    'perception.excluded': string;
     'trace.phase.route': string;
     'trace.phase.activate': string;
     'trace.phase.execute': string;
     'trace.phase.interact': string;
     'trace.phase.complete': string;
     'trace.phase.fail': string;
+    'todo.title': string;
+    'todo.progress': string;
+    'todo.status.pending': string;
+    'todo.status.inProgress': string;
+    'todo.status.completed': string;
+    'todo.delegatedTo': string;
     'interaction.ask.title': string;
     'interaction.confirm.title': string;
     'interaction.form.title': string;
@@ -919,6 +1376,7 @@ declare const useT: () => TranslateFn<{
     'interaction.authorize.description': string;
     'interaction.authorize.capability': string;
     'interaction.authorize.details': string;
+    'interaction.origin': string;
     'interaction.submit': string;
     'interaction.cancel': string;
     'interaction.confirm': string;
@@ -946,14 +1404,37 @@ declare const useT: () => TranslateFn<{
     'composer.attachments': string;
     'composer.addAttachment': string;
     'composer.removeAttachment': string;
+    'composer.model': string;
+    'composer.model.demo': 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.model.title': string;
     'settings.model.description': string;
+    'settings.model.empty': string;
+    'settings.model.add': string;
+    'settings.model.edit': string;
+    'settings.model.remove': string;
+    'settings.model.setDefault': string;
+    'settings.model.default': string;
+    'settings.model.label': string;
+    'settings.model.labelNote': string;
+    'settings.model.unavailable': string;
+    'settings.model.cancel': string;
     'settings.provider': string;
     'settings.providerNote': string;
     'settings.provider.openai-compatible': string;
     'settings.provider.anthropic': string;
     'settings.provider.google': string;
+    'settings.provider.chrome-builtin': string;
+    'settings.provider.chrome-builtin.note': string;
+    'settings.provider.chrome-builtin.limitation': string;
+    'settings.chromeBuiltin.api-missing': string;
+    'settings.chromeBuiltin.model-not-ready': string;
+    'settings.chromeBuiltin.unsupported-browser': string;
     'settings.provider.anthropic.note': string;
     'settings.provider.google.note': string;
     'settings.endpoint': string;
@@ -973,6 +1454,30 @@ declare const useT: () => TranslateFn<{
     'settings.demoNote': string;
     'settings.save': string;
     'settings.clear': string;
+    'settings.agent.title': string;
+    'settings.agent.description': string;
+    'settings.agent.todo': string;
+    'settings.agent.todoNote': string;
+    'settings.agent.generativeUi': string;
+    'settings.agent.generativeUiNote': string;
+    'settings.agent.skillGeneration': string;
+    '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.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;
@@ -990,6 +1495,7 @@ declare const useT: () => TranslateFn<{
     'vercel.preview.title': string;
     'vercel.preview.badge': string;
     'vercel.preview.description': string;
+    'surface.legacy.placeholder': string;
     'error.title': string;
     'error.suggestion': string;
     'error.dismiss': string;
@@ -997,22 +1503,29 @@ declare const useT: () => TranslateFn<{
 }>;
 //#endregion
 //#region src/react/appearance.d.ts
-/** chatbot 主题（根 div 挂 .dark 类生效） */
+/** chatbot 主题（根 div 挂 .dark 类生效） @stable */
 type ChatTheme = 'light' | 'dark';
-/** SettingsDrawer 内切换外观时回调宿主持久化 */
+/** SettingsDrawer 内切换外观时回调宿主持久化 @stable */
 interface AppearanceChange {
   theme?: ChatTheme;
   locale?: Locale;
   /** 渲染框架档（native/a2ui）；宿主持久化后经 Chatbot renderer prop 回注 */
   renderer?: RendererKind;
+  /**
+   * 语音识别语言（BCP-47，需求 7 的 FR-7.7）。空串表示跟随界面语言——
+   * 用 `''` 而不是省略字段，是为了让「改回跟随」也能作为一次变更传给宿主。
+   */
+  dictationLang?: string;
 }
 //#endregion
 //#region src/react/useChatLayout.d.ts
-/** 宿主可指定的布局档；auto 按容器尺寸判定 */
+/** 宿主可指定的布局档；auto 按容器尺寸判定 @stable */
 type ChatLayout = 'auto' | 'fullscreen' | 'embedded';
+/** @stable */
 type ResolvedChatLayout = 'fullscreen' | 'embedded' | 'mobile';
 //#endregion
 //#region src/react/Chatbot.d.ts
+/** @stable */
 interface ChatbotProps {
   adapter: ChatbotHostAdapter;
   config?: ChatbotConfig;
@@ -1022,120 +1535,129 @@ interface ChatbotProps {
   theme?: ChatTheme;
   /** 交互渲染框架档（默认 'native'；'a2ui' 需宿主安装 optional peer @a2ui/lit） */
   renderer?: RendererKind;
+  /** 语音识别语言（BCP-47）；缺省跟随界面语言（FR-7.7） */
+  dictationLang?: string;
   /** Native custom surface 的显式 renderer/schema allowlist。 */
   surfaceRegistry?: SurfaceRegistry;
   /** 布局档（默认 'auto'：按容器尺寸在 fullscreen / embedded / mobile 之间判定） */
   layout?: ChatLayout;
   onAppearanceChange?(next: AppearanceChange): void;
+  /**
+   * 装配完成后把引擎交给宿主，用于接线跨界面动作（例如 console 的快照恢复入口
+   * 需要调 `engine.resume(runId)`）。每次重新装配都会再调一次。
+   */
+  onEngineReady?(engine: ChatEngine): void;
 }
 /**
  * ChatEngine owns message/session/runtime state while assistant-ui Base owns the
  * presentation shell and accessible thread primitives.
+ * @stable
  */
-declare function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, renderer: rendererProp, surfaceRegistry, layout, onAppearanceChange }: ChatbotProps): import("react").JSX.Element;
+declare function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, renderer: rendererProp, dictationLang: dictationLangProp, surfaceRegistry, layout, onAppearanceChange, onEngineReady }: ChatbotProps): import("react").JSX.Element;
 //#endregion
 //#region src/react/A2uiSurfaceHost.d.ts
+/** @experimental */
 interface A2uiSurfaceHostProps {
   bridge: ReactBridgeState;
   runId?: string;
   registry?: SurfaceRegistry;
 }
+/** @experimental */
 interface A2uiSurfaceSnapshotHostProps {
-  snapshots: readonly UiSurfaceSnapshot[];
+  snapshots: readonly UiSpecSnapshot[];
   registry?: SurfaceRegistry;
   onAction?(event: UiSurfaceActionEvent): void;
-  drafts?: UiSurfaceDrafts;
+  drafts?: UiSpecDrafts;
   onDraftChange?(event: {
     runId: string;
     surfaceId: string;
     value: Record<string, unknown>;
   }): void;
 }
-/** Renders persisted A2UI Basic Catalog surfaces and controlled WebSkill extensions without a live bridge. @experimental */
+/** Renders persisted WebSkill UI spec snapshots through the A2UI BYOC catalog. @experimental */
 declare function A2uiSurfaceSnapshotHost({ snapshots, registry, onAction, drafts, onDraftChange }: A2uiSurfaceSnapshotHostProps): import("react").JSX.Element | null;
-/** Renders A2UI Basic Catalog surfaces and controlled WebSkill extensions from live bridge snapshots. @experimental */
+/** Renders WebSkill UI spec snapshots from live bridge state through the A2UI BYOC catalog. @experimental */
 declare function A2uiSurfaceHost({ bridge, runId, registry }: A2uiSurfaceHostProps): import("react").JSX.Element;
 //#endregion
 //#region src/react/SkillBadges.d.ts
-/** 消息底部展示该 run 激活的技能名徽章（无技能不渲染） */
+/** 消息底部展示该 run 激活的技能名徽章（无技能不渲染） @stable */
 declare function SkillBadges({ skills }: {
   skills: string[];
 }): import("react").JSX.Element | null;
 //#endregion
 //#region src/react/InteractionCard.d.ts
+/** @stable */
 interface InteractionCardProps {
   bridge: ReactBridgeState;
 }
-/** 订阅 bridge.pending 渲染五类交互卡（ask/confirm/form/select/authorize，native） */
+/**
+ * 订阅 bridge.pending 渲染五类交互卡（native 档；其它档降级后也由它接管）。
+ * 表单本体走 `NativeSpecSurface`——与 native 档 surface 侧同一个渲染入口。
+ * @stable
+ */
 declare function InteractionCard({ bridge }: InteractionCardProps): import("react").JSX.Element | null;
 //#endregion
-//#region src/react/OpenUiInteraction.d.ts
-interface OpenUiInteractionProps {
-  channel: OpenUiChannel;
+//#region src/react/SpecInteraction.d.ts
+/** @experimental */
+interface SpecInteractionProps {
+  channel: SpecInteractionChannel;
+  /** 非 native 三档之一：native 的交互卡由 `InteractionCard` 直接渲染 */
+  renderer: Exclude<RendererKind, 'native'>;
 }
 /**
- * openui 档交互视图：订阅 OpenUiChannel（core 产出 openui-lang 文本），动态加载
- * optional peer @openuidev/react-lang 的 Renderer 渲染；动作事件回传 channel.handleAction。
- * 模块加载失败 → channel.fail（桥粘性降级 native，InteractionCard 接管）。
+ * 非 native 三档的交互视图（路径 A）：订阅 SpecInteractionChannel（core 产出 catalog
+ * 节点树），交给本档 surface 侧同一个渲染入口渲染；提交/取消经 handleAction 回传。
+ * 未挂载时桥直接降级 native（不悬挂请求）。
+ * @experimental
  */
-declare function OpenUiInteraction({ channel }: OpenUiInteractionProps): import("react").JSX.Element | null;
+declare function SpecInteraction({ channel, renderer }: SpecInteractionProps): import("react").JSX.Element | null;
 //#endregion
 //#region src/react/OpenUiSurfaceHost.d.ts
+/** @experimental */
 interface OpenUiSurfaceHostProps {
   bridge: ReactBridgeState;
   runId?: string;
-  registry?: SurfaceRegistry;
 }
+/** @experimental */
 interface OpenUiSurfaceSnapshotHostProps {
-  snapshots: readonly UiSurfaceSnapshot[];
-  registry?: SurfaceRegistry;
-  onAction?(event: UiSurfaceActionEvent): void;
-  drafts?: UiSurfaceDrafts;
-  onDraftChange?(event: {
-    runId: string;
-    surfaceId: string;
-    value: Record<string, unknown>;
-  }): void;
+  snapshots: readonly UiSpecSnapshot[];
+  onAction?: (event: CustomSurfaceActionEvent) => void;
 }
-/** Renders persisted UiSurface snapshots through the OpenUI extension without a live bridge. @experimental */
-declare function OpenUiSurfaceSnapshotHost({ snapshots, registry, onAction, drafts, onDraftChange }: OpenUiSurfaceSnapshotHostProps): import("react").JSX.Element | null;
-/** Renders serializable UiSurface descriptors through an OpenUI library extension. @experimental */
-declare function OpenUiSurfaceHost({ bridge, runId, registry }: OpenUiSurfaceHostProps): import("react").JSX.Element;
+/** Renders persisted UI spec snapshots through the OpenUI extension without a live bridge. @experimental */
+declare function OpenUiSurfaceSnapshotHost({ snapshots, onAction }: OpenUiSurfaceSnapshotHostProps): import("react").JSX.Element | null;
+/** Renders WebSkill UI spec snapshots through an OpenUI library extension. @experimental */
+declare function OpenUiSurfaceHost({ bridge, runId }: OpenUiSurfaceHostProps): import("react").JSX.Element;
 //#endregion
 //#region src/react/VercelPayloadPreview.d.ts
+/** @experimental */
 interface VercelPayloadPreviewProps {
   bridge: ReactBridgeState;
 }
 /**
  * vercel 档（payload 预览）：不渲染表单，展示 InteractionRequest 经 toVercelToolInvocation
  * 转换后的 Vercel AI SDK 数据契约 JSON 卡。仅提供 Cancel 结束交互（非完整运行时）。
+ * @experimental
  */
 declare function VercelPayloadPreview({ bridge }: VercelPayloadPreviewProps): import("react").JSX.Element | null;
 //#endregion
 //#region src/react/VercelSurfaceHost.d.ts
+/** @experimental */
 interface VercelSurfaceHostProps {
   bridge: ReactBridgeState;
   runId?: string;
-  registry?: SurfaceRegistry;
 }
+/** @experimental */
 interface VercelSurfaceSnapshotHostProps {
-  snapshots: readonly UiSurfaceSnapshot[];
-  registry?: SurfaceRegistry;
-  onAction?(event: UiSurfaceActionEvent): void;
-  drafts?: UiSurfaceDrafts;
-  onDraftChange?(event: {
-    runId: string;
-    surfaceId: string;
-    value: Record<string, unknown>;
-  }): void;
+  snapshots: readonly UiSpecSnapshot[];
+  onAction?: (event: CustomSurfaceActionEvent) => void;
 }
-/** Renders persisted Vercel-compatible data parts without subscribing to a live bridge. @experimental */
-declare function VercelSurfaceSnapshotHost({ snapshots, registry, onAction, drafts, onDraftChange }: VercelSurfaceSnapshotHostProps): import("react").JSX.Element | null;
-/** Consumes Vercel-compatible surface data parts with a controlled React surface renderer. @experimental */
-declare function VercelSurfaceHost({ bridge, runId, registry }: VercelSurfaceHostProps): import("react").JSX.Element | null;
+/** Renders persisted UI spec snapshots through the json-render registry without a live bridge. @experimental */
+declare function VercelSurfaceSnapshotHost({ snapshots, onAction }: VercelSurfaceSnapshotHostProps): import("react").JSX.Element | null;
+/** Consumes WebSkill UI spec snapshots with a json-render surface renderer. @experimental */
+declare function VercelSurfaceHost({ bridge, runId }: VercelSurfaceHostProps): import("react").JSX.Element | null;
 //#endregion
 //#region src/react/ResultBlocksPro.d.ts
-/** 可下载文件描述（file 块与 artifact 统一成该形状） */
+/** 可下载文件描述（file 块与 artifact 统一成该形状） @stable */
 interface DownloadableFile {
   path: string;
   /** 所属 run（artifact 存储路径 <chatRoot>/artifacts/<runId>/<path> 解析用） */
@@ -1143,6 +1665,7 @@ interface DownloadableFile {
   mimeType?: string;
   size?: number;
 }
+/** @stable */
 interface ResultBlocksProProps {
   bridge: ReactBridgeState;
   /** 只在所属 run 仍活动时展示；完成结果块由 ChatMessage 历史承接。 */
@@ -1150,7 +1673,7 @@ interface ResultBlocksProProps {
   /** 注入后 file 块 / artifact 渲染下载按钮（宿主负责读存储并触发浏览器下载） */
   onDownload?(file: DownloadableFile): void;
 }
-/** 按 blocks 直接渲染的形态（历史消息结果块；当前 run 走 ResultBlocksPro 的 bridge 路径） */
+/** 按 blocks 直接渲染的形态（历史消息结果块；当前 run 走 ResultBlocksPro 的 bridge 路径） @stable */
 interface ResultBlockListProps {
   blocks: RenderBlock[];
   /** 所属 run（file 块下载路径解析用） */
@@ -1160,15 +1683,18 @@ interface ResultBlockListProps {
 /**
  * 结果块列表（AnimatePresence 逐块入场）：markdown / json / table / chart / image / file。
  * 历史消息（ChatMessage.blocks）与当前 run（ResultBlocksPro）共用的渲染形态。
+ * @stable
  */
 declare function ResultBlockList({ blocks, runId, onDownload }: ResultBlockListProps): import("react").JSX.Element;
 /**
  * run 完成结果块渐进挂载（AnimatePresence 逐块入场）：
  * markdown / json / table / chart / image / file + artifact 下载卡。
+ * @stable
  */
 declare function ResultBlocksPro({ bridge, activeRunId, onDownload }: ResultBlocksProProps): import("react").JSX.Element | null;
 //#endregion
 //#region src/react/InterruptedBanner.d.ts
+/** @stable */
 interface InterruptedBannerProps {
   engine: ChatEngine;
   /** 会话切换时重新检查（值变化即触发重新 listInterrupted） */
@@ -1177,39 +1703,57 @@ interface InterruptedBannerProps {
 /**
  * 未完成对话提示条：挂载/会话切换时检查 interrupted 快照，非空则顶部 banner
  * + Resume（engine.resume 后等待中的表单重新进入 bridge.pending）。
+ * @stable
  */
 declare function InterruptedBanner({ engine, sessionId }: InterruptedBannerProps): import("react").JSX.Element | null;
 //#endregion
 //#region src/react/SettingsDrawer.d.ts
+/** @stable */
 interface SettingsDrawerProps {
   open: boolean;
-  llmConfig: ChatbotHostAdapter['llmConfig'];
   /**
-   * 运行环境配置存储（P4-A）：注入后表单读写 store 的 llm 段 + streaming + loop.temperature，
-   * 保存后引擎 reloadConfig 装配生效；缺省回退 adapter.llmConfig 旧路径（仅 OpenAI 兼容）
+   * 运行环境配置存储：模型列表、流式、temperature、Agent 能力全部读写这里。
+   * 缺省时模型区只读展示（宿主没接配置源，谈不上持久化）。
    */
   runtimeConfig?: RuntimeConfigStore;
   theme: ChatTheme;
   locale: Locale;
-  /** 当前渲染框架档（Appearance 区 Badge 展示；切换由宿主外观配置源完成） */
+  /** 当前渲染框架档（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）。
+   * @experimental
+   */
+  onClearFormAutofill?(): Promise<void>;
+  /**
+   * 导出偏好时回调（FR-5.1）：不注入时默认触发浏览器下载；
+   * 宿主要改成写入自己的存储（或复制到剪贴板）时接本回调。
+   * @experimental
+   */
+  onExportPreferences?(data: PreferenceExport): void;
   onClose(): void;
 }
-/** 设置抽屉：LLM 配置（三协议供应商 / 能力探测 / Demo model 标识 / 流式与 temperature）+ 外观（主题/语言） */
-declare function SettingsDrawer({ open, llmConfig, runtimeConfig, theme, locale, renderer, onAppearanceChange, onSaved, onClose }: SettingsDrawerProps): import("react").JSX.Element;
+/** 设置抽屉：模型列表（增删改 / 设默认 / 逐条探测）+ 流式与 temperature + Agent 能力 + 外观 @stable */
+declare function SettingsDrawer({ open, runtimeConfig, theme, locale, renderer, dictationLang, onAppearanceChange, onSaved, onClearFormAutofill, onExportPreferences, onClose }: SettingsDrawerProps): import("react").JSX.Element;
 //#endregion
 //#region src/react/ErrorCard.d.ts
+/** @stable */
 interface ErrorCardProps {
   /** 稳定错误码（WebSkillError.code / RUN_FAILED；缺省不渲染徽章） */
   code?: string;
   message: string;
   onDismiss?(): void;
 }
-/** 结构化错误卡：错误码徽章 + 描述 + 建议（engine error 事件 / 失败 run） */
+/** 结构化错误卡：错误码徽章 + 描述 + 建议（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 ChatbotHostAdapter, type ChatbotProps, CompositeUiBridge, type CompositeUiBridgeDeps, type DownloadableFile, ErrorCard, type ErrorCardProps, InteractionCard, type InteractionCardProps, InterruptedBanner, type InterruptedBannerProps, type LlmConfig, type Locale, OpenUiChannel, OpenUiInteraction, type OpenUiInteractionProps, type OpenUiSession, OpenUiSurfaceHost, type OpenUiSurfaceHostProps, OpenUiSurfaceSnapshotHost, type OpenUiSurfaceSnapshotHostProps, type RendererKind, type ResolvedChatLayout, ResultBlockList, type ResultBlockListProps, ResultBlocksPro, type ResultBlocksProProps, type RunSnapshot, type SandboxExecutorDeps, SettingsDrawer, type SettingsDrawerProps, SkillBadges, 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 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 };