@webskill/chatbot 0.7.0 → 0.9.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { AgentLoopConfig, ApprovalScope, BridgeCapabilities, ExternalSkillProvider, ExternalToolSource, FileSystemProvider, HookRunner, InteractionRequest, InteractionResponse, LifecycleEventInit, LlmClient, NetworkPolicy, Page, PageQuery, RenderBlock, RenderResultRequest, RunSnapshot, RunSnapshotListEntry, RuntimePhase, RuntimeRun, ScriptExecutor, SessionStore, SkillCandidateMarker, SkillCatalogEntry, SkillIntegrityGuard, SkillOutcomeReporter, SkillStateGuard, UiBridge, UiSpecDrafts, UiSpecEvent, UiSpecSnapshot, UiSurfaceActionRequest, UiSurfaceActionResponse, UserProfile, UserProfileExport, WebSkillErrorCode, diffUserProfile } from "@webskill/sdk";
+import { AgentLoopConfig, ApprovalScope, BridgeCapabilities, DocxTextExtractor, ExternalSkillProvider, ExternalToolSource, FileSystemProvider, HookRunner, InteractionRequest, InteractionResponse, LifecycleEventInit, LinkedDocumentReader, LlmClient, NetworkPolicy, Page, PageQuery, RenderBlock, RenderResultRequest, RunSnapshot, RunSnapshotListEntry, RuntimePhase, RuntimeRun, ScriptExecutor, SessionStore, SkillCandidateMarker, SkillCatalogEntry, SkillIntegrityGuard, SkillOutcomeReporter, SkillStateGuard, UiBridge, UiSpecDrafts, UiSpecEvent, UiSpecSnapshot, UiSurfaceActionRequest, UiSurfaceActionResponse, UserProfile, UserProfileExport, WebSkillErrorCode, diffUserProfile } from "@webskill/sdk";
 import { SandboxMode, TypeScriptSupportOptions } from "@webskill/sdk/browser";
 import { CustomSurfaceActionEvent, ReactBridgeState, SpecInteractionChannel, SurfaceRegistry, UiSurfaceActionEvent } from "@webskill/sdk/ui-react";
 import { PageActionPolicy, PagePerceptionPolicy, PerceptionRecord, SkillCandidateSink, TodoItem } from "@webskill/sdk/agent";
@@ -53,6 +53,10 @@ interface RuntimeLoopConfig {
   temperature?: number;
   toolResultMaxBytes: number;
   maxHistoryMessages: number;
+  /** `file` 分片的 base64 上限；超出即拒绝并说明，不截断（FR-23.4） */
+  maxDocumentBytes: number;
+  /** `document-text` 分片的字节上限；同样拒绝而不截断（FR-23.4） */
+  maxDocumentTextBytes: number;
 }
 interface RuntimeInteractionConfig {
   missingParams: 'user' | 'llm';
@@ -74,9 +78,22 @@ interface RuntimeSandboxConfig {
   networkPolicy: NetworkPolicy$1;
   capabilities: {
     readReference: CapabilityMode;
+    /** 同时管 readAsset 与 readAssetBinary */
+    readAsset: CapabilityMode;
     writeArtifact: CapabilityMode;
     confirm: CapabilityMode;
+    /**
+     * 脚本按宿主声明的数据源取数（分册 16）。
+     * 与 `readAsset` **相反**，缺省 `false`：它会出网，缺省开等于每个技能默认拿到出站能力。
+     */
+    fetchData: CapabilityMode;
   };
+  /**
+   * 单次取数结果的字节上限（分册 16）。超出即拒绝，**不截断**
+   * ——截断后的 JSON 解不出来，比拒绝更糟。结果回到脚本，不进模型上下文，
+   * 所以不受 `toolResultMaxBytes` 约束。
+   */
+  maxDataSourceBytes: number;
   /**
    * 出站 URL 准入策略（`RemoteUrlPolicy` 的可配置部分）：技能安装、MCP 端点连接
    * 这类由宿主发起的取数都按它判定。两项都默认关，即 https-only 且拒绝内网/环回。
@@ -189,6 +206,17 @@ interface RuntimeAppearanceConfig {
  * 两者都会把图像随请求外发给模型提供方，属新增攻击面。
  * @experimental
  */
+/**
+ * 文档投放面（0.11.0 分册 18）。
+ *
+ * **只有一个闸门字段**。CSP 白名单不在这里：它由 viewer 路由的**响应头**
+ * 下发（FR-18.3 第 1 条），是宿主部署时调 `viewerCspHeader` 的入参；
+ * 浏览器侧的运行时配置改不动已经发出去的响应头，携在这里只会是个不生效的假开关。
+ */
+interface RuntimeDocumentSurfaceConfig {
+  /** 关着即没有这个投放面；开启还要求宿主额外提供一条 viewer 路由 */
+  enabled: boolean;
+}
 interface RuntimeMultimodalConfig {
   imageAttachments: boolean;
   /** 页面图像抓取总开关（FR-12.3）；关时感知只走纯文本路径 */
@@ -239,6 +267,7 @@ interface RuntimeConfig {
   security: RuntimeSecurityConfig;
   appearance: RuntimeAppearanceConfig;
   multimodal: RuntimeMultimodalConfig;
+  documentSurface: RuntimeDocumentSurfaceConfig;
   userProfile: RuntimeUserProfileConfig;
   skillState: RuntimeSkillStateConfig;
   /** 被用户删掉的自动模型条目 id（FR-14.3）：删一次就不该再自己长回来 */
@@ -289,7 +318,7 @@ declare function createMemoryRuntimeConfigStore(initial?: Partial<RuntimeConfig>
 //#endregion
 //#region src/core/attachmentKind.d.ts
 /** 附件在模型侧的内容形态（0.6.0 FR-11.2） @experimental */
-type ChatAttachmentKind = 'text' | 'image' | 'file';
+type ChatAttachmentKind = 'text' | 'image' | 'file' | 'document-text';
 //#endregion
 //#region src/core/types.d.ts
 /**
@@ -387,6 +416,8 @@ interface ChatRunPhase {
   endedAt?: number;
   /** 由结构化 `LifecycleEvent.data` 派生的一句摘要 */
   note?: string;
+  /** fail 相位的具体说明：`reason` 只有七种取值，说不出「哪个上限、哪个模型」 */
+  detail?: string;
 }
 /** 本轮发生的一次已提交交互（FR-17.8：提交后表单保留所填值） @experimental */
 interface ChatInteractionRecord {
@@ -417,6 +448,23 @@ interface ChatTokenUsage {
   /** 本 run 向大模型发送请求的次数（模型调用轮数） */
   llmCalls: number;
 }
+/**
+ * 助手消息的有序内容段（分册 17 FR-17.1）：文字与 surface / 结果块按生成顺序排列。
+ * 冗余记账——删掉本字段消息内容不缺失，只退化成「正文在上、扩展在下」（FR-17.11）。
+ * @experimental
+ */
+type ChatContentPart = {
+  type: 'text';
+  text: string;
+  at: number;
+} | {
+  type: 'surface';
+  surfaceId: string;
+  at: number;
+} | {
+  type: 'blocks';
+  at: number;
+};
 /** @stable */
 interface ChatMessage {
   id: string;
@@ -491,6 +539,11 @@ interface ChatMessage {
    * @experimental
    */
   candidates?: SkillCandidateMarker[];
+  /**
+   * 文字与 surface / blocks 的生成顺序（分册 17）。缺省时按 0.11.0 的两段式渲染。
+   * @experimental
+   */
+  contentParts?: ChatContentPart[];
 }
 /** @stable */
 interface ChatSessionMeta {
@@ -533,6 +586,21 @@ type ChatEvent = {
 } | {
   type: 'message-complete';
   message: ChatMessage;
+} |
+/**
+ * surface 上屏（分册 17 FR-17.3）：载荷只有引用，spec 本体照旧走 `bridge.surfaceSnapshots`。
+ * 事件只承担「顺序」这一件事。
+ * @experimental
+ */
+{
+  type: 'surface-opened';
+  runId: string;
+  surfaceId: string;
+} |
+/** 结果块整批上屏（分册 17 FR-17.3） @experimental */
+{
+  type: 'blocks-rendered';
+  runId: string;
 } | {
   type: 'skill-activated';
   runId: string;
@@ -609,6 +677,23 @@ type ChatEvent = {
   message: string;
   code?: string;
 };
+/**
+ * 快捷指令可选图标名（0.12.0 分册 21）。
+ * 用受控枚举而不是让宿主传组件：SDK 的图标集不进公开契约，
+ * 换实现（lucide → 别的）时宿主代码不用动。
+ * @experimental
+ */
+type QuickPromptIconName = 'chart' | 'document' | 'report' | 'search' | 'list' | 'bug' | 'test' | 'metric' | 'compare' | 'page' | 'run' | 'warn' | 'sparkles' | 'settings';
+/**
+ * 带图标的快捷指令（0.12.0 分册 21）。
+ * @experimental
+ */
+interface QuickPrompt {
+  /** 点击后发出的文本，同时作为按钮可见文案 */
+  text: string;
+  /** 缺省或取值不在枚举内时按无图标渲染 */
+  icon?: QuickPromptIconName;
+}
 /** @stable */
 interface ChatbotConfig {
   /** header 标题，默认 'WebSkill Chat' */
@@ -626,11 +711,12 @@ interface ChatbotConfig {
    * renderResult/sandbox/llm 映射；与 console Configure Tab 共用同一 store（宿主接线）
    */
   runtimeConfig?: RuntimeConfigStore;
-  /** WelcomeScreen 快捷 prompt 覆盖（缺省用内置双语示例） */
-  quickPrompts?: string[];
+  /** WelcomeScreen 快捷 prompt 覆盖（缺省用内置双语示例）；给字符串即无图标 */
+  quickPrompts?: readonly (string | QuickPrompt)[];
   /**
    * 开启后模型多一个 `render_ui` 工具，可面向 AI Component Catalog 直接生成声明式 UI。
-   * 默认关：工具描述 + 入参 schema 约 14 KB，会计入每一次请求。
+   * 默认关：工具描述 + 入参 schema 约 34 KB，会计入每一次请求。
+   * 数字的单一来源是 `@webskill/ui` 的 `catalog/budget.ts`（实测终态 12 744 + 21 470）。
    *
    * 接了 `runtimeConfig` 时以 `RuntimeConfig.agentCapabilities.generativeUi` 为准
    * （设置抽屉里的开关就是它），本字段只在未接配置存储的宿主上生效。
@@ -649,6 +735,14 @@ interface ChatbotConfig {
    * `SKILL_GENERATION_DISABLED`，不弹确认框、不产生候选。
    */
   skillCandidates?: SkillCandidateSink;
+  /**
+   * 宿主声明的数据源取数入口（分册 16）：透传给 `ChatEngineOptions.fetchData`。
+   * 不注入即脚本上下文没有 `fetchData` 这个键。
+   *
+   * **必须是稳定引用**（模块级或 `useMemo`）：它进 `ChatEngine` 的 `useMemo`
+   * 依赖表，每次渲染新建一个箭头函数会把整个引擎重建掉。
+   */
+  fetchData?: (sourceId: string, params?: Record<string, unknown>) => Promise<unknown>;
 }
 //#endregion
 //#region src/core/hostAdapter.d.ts
@@ -685,9 +779,33 @@ interface ChatbotHostAdapter {
    * @experimental
    */
   pageActions?: PageActionPolicy;
+  /**
+   * 读页面链接指向的文档（分册 22）。实现住在 `@webskill/browser`，
+   * 而 chatbot 不依赖它 —— 与 `pagePerception` 同一条装配规矩：宿主注入。
+   * 不注入即 `read_linked_document` 不注册。
+   */
+  linkedDocuments?: LinkedDocumentReader;
+  /** docx → 文本（`extractDocxText`）；不注入即 Word 文档明确报「本环境不支持」 */
+  docxExtractor?: DocxTextExtractor;
+  /** 文档读取留痕出口（FR-22.6） */
+  documentAudit?: {
+    append(event: {
+      type: string;
+      target: string;
+      data?: Record<string, unknown>;
+    }): Promise<unknown>;
+  };
 }
 //#endregion
 //#region src/core/chatEngine.d.ts
+/**
+ * 条目能否真的发请求：云端要有端点或密钥，浏览器内置两者都不需要。
+ *
+ * 导出给 UI：选择器不用同一份判据的话，用户能选中一个空配置条目，
+ * 而引擎静默回退到另一条——界面说在用 A、实际跑的是 B（UI-UX8 D1）。
+ * @experimental
+ */
+declare const isLlmEntryUsable: (entry: RuntimeLlmEntry) => boolean;
 /**
  * 选中条目 → 默认条目 → 首条；命中不可用条目时**回退到下一个可用条目**
  * （0.10.0 复核：选中项失效时宁可静默换用可用模型，也不能把 UI 锁死成
@@ -742,6 +860,14 @@ interface ChatEngineOptions {
   generativeUi?: boolean;
   /** 沙箱执行器替换点（测试注入 spy 断言构造参数；缺省 BrowserWorkerScriptExecutor） */
   executorFactory?: (deps: SandboxExecutorDeps) => ScriptExecutor;
+  /**
+   * 宿主声明的数据源取数入口（分册 16）。不注入即脚本上下文没有 `fetchData` 这个键。
+   *
+   * 装配点必须在宿主：策略本体 `DataSourcePolicy` 住在 `@webskill/agent`，
+   * 而数据源的目标地址是宿主自己的业务知识，chatbot 无从代为声明。
+   * 能力开关 `sandbox.capabilities.fetchData` 缺省关，注入了也还要宿主在配置里打开。
+   */
+  fetchData?: (sourceId: string, params?: Record<string, unknown>) => Promise<unknown>;
   /**
    * 会话落盘替换点（缺省 `FsSessionStore`，落在 `<chatRoot>/sessions`）。
    * 宕主换自己的实现（如 IndexedDB）与测试统计端口读写量都走这里。
@@ -951,6 +1077,12 @@ interface CompositeUiBridgeDeps {
    * @experimental
    */
   onSkillCandidate?(runId: string, candidate: SkillCandidateMarker): void;
+  /**
+   * surface 首次上屏（分册 17 FR-17.3）。只传引用，spec 本体照旧走 surfaceStore；
+   * 引擎拿它在账本里记一个顺序位。
+   * @experimental
+   */
+  onSurfaceOpened?(runId: string, surfaceId: string): void;
   emit(event: ChatEvent): void;
 }
 /**
@@ -996,11 +1128,13 @@ declare const chatbotDictionary: {
     'header.theme.dark': string;
     'header.language': string;
     'session.title': string;
+    'session.historyTitle': string;
+    'session.collapse': string;
+    'session.expand': string;
     'session.new': string;
     'session.searchPlaceholder': string;
     'session.searchClear': string;
     'session.empty': string;
-    'session.missingRoot': string;
     'session.skipped': string;
     'session.delete': string;
     'session.actions': string;
@@ -1126,6 +1260,15 @@ declare const chatbotDictionary: {
     'interaction.pageAction.role.click': string;
     'interaction.pageAction.role.fill': string;
     'interaction.pageAction.role.submit': string;
+    'interaction.pageAction.frame': string;
+    'interaction.pageAction.elevated': string;
+    'interaction.traceEvidence.title': string;
+    'interaction.traceEvidence.columnDraft': string;
+    'interaction.traceEvidence.columnTrace': string;
+    'interaction.traceEvidence.trace': string;
+    'interaction.traceEvidence.model': string;
+    'interaction.traceEvidence.noArgs': string;
+    'interaction.traceEvidence.redacted': string;
     'interaction.origin': string;
     'interaction.submitted': string;
     'interaction.submit': string;
@@ -1140,6 +1283,11 @@ declare const chatbotDictionary: {
     'surface.readOnlySnapshot': string;
     'surface.suggested': string;
     'surface.useSuggestion': string;
+    'surface.control.previousPage': string;
+    'surface.control.previous': string;
+    'surface.control.nextPage': string;
+    'surface.control.next': string;
+    'surface.control.carousel': string;
     'interaction.wait': string;
     'interaction.wait.inPanel': string;
     'interaction.wait.fallback': string;
@@ -1169,8 +1317,10 @@ declare const chatbotDictionary: {
     'composer.attachment.kind.text': string;
     'composer.attachment.kind.image': string;
     'composer.attachment.kind.file': string;
+    'composer.attachment.kind.document-text': string;
     'composer.attachment.compressed': string;
     'composer.model': string;
+    'composer.model.unconfigured': string;
     'composer.model.demo': string;
     'composer.noModel.title': string;
     'composer.noModel.description': string;
@@ -1318,6 +1468,7 @@ declare const chatbotDictionary: {
     'error.suggestion.RUN_INTERACTION_TIMEOUT': string;
     'error.suggestion.RUN_MAX_TURNS_EXCEEDED': string;
     'error.suggestion.TOOL_RESOLUTION_EXHAUSTED': string;
+    'error.suggestion.TOOL_SCHEMA_UNAVAILABLE': string;
     'error.limit.totalTimeoutMs': string;
     'error.limit.maxTurns': string;
     'error.message.RUN_CANCELLED': string;
@@ -1333,11 +1484,13 @@ declare const chatbotDictionary: {
     'header.theme.dark': string;
     'header.language': string;
     'session.title': string;
+    'session.historyTitle': string;
+    'session.collapse': string;
+    'session.expand': string;
     'session.new': string;
     'session.searchPlaceholder': string;
     'session.searchClear': string;
     'session.empty': string;
-    'session.missingRoot': string;
     'session.skipped': string;
     'session.delete': string;
     'session.actions': string;
@@ -1463,6 +1616,15 @@ declare const chatbotDictionary: {
     'interaction.pageAction.role.click': string;
     'interaction.pageAction.role.fill': string;
     'interaction.pageAction.role.submit': string;
+    'interaction.pageAction.frame': string;
+    'interaction.pageAction.elevated': string;
+    'interaction.traceEvidence.title': string;
+    'interaction.traceEvidence.columnDraft': string;
+    'interaction.traceEvidence.columnTrace': string;
+    'interaction.traceEvidence.trace': string;
+    'interaction.traceEvidence.model': string;
+    'interaction.traceEvidence.noArgs': string;
+    'interaction.traceEvidence.redacted': string;
     'interaction.origin': string;
     'interaction.submitted': string;
     'interaction.submit': string;
@@ -1477,6 +1639,11 @@ declare const chatbotDictionary: {
     'surface.readOnlySnapshot': string;
     'surface.suggested': string;
     'surface.useSuggestion': string;
+    'surface.control.previousPage': string;
+    'surface.control.previous': string;
+    'surface.control.nextPage': string;
+    'surface.control.next': string;
+    'surface.control.carousel': string;
     'interaction.wait': string;
     'interaction.wait.inPanel': string;
     'interaction.wait.fallback': string;
@@ -1506,8 +1673,10 @@ declare const chatbotDictionary: {
     'composer.attachment.kind.text': string;
     'composer.attachment.kind.image': string;
     'composer.attachment.kind.file': string;
+    'composer.attachment.kind.document-text': string;
     'composer.attachment.compressed': string;
     'composer.model': string;
+    'composer.model.unconfigured': string;
     'composer.model.demo': string;
     'composer.noModel.title': string;
     'composer.noModel.description': string;
@@ -1655,6 +1824,7 @@ declare const chatbotDictionary: {
     'error.suggestion.RUN_INTERACTION_TIMEOUT': string;
     'error.suggestion.RUN_MAX_TURNS_EXCEEDED': string;
     'error.suggestion.TOOL_RESOLUTION_EXHAUSTED': string;
+    'error.suggestion.TOOL_SCHEMA_UNAVAILABLE': string;
     'error.limit.totalTimeoutMs': string;
     'error.limit.maxTurns': string;
     'error.message.RUN_CANCELLED': string;
@@ -1673,11 +1843,13 @@ declare const useT: () => TranslateFn<{
     'header.theme.dark': string;
     'header.language': string;
     'session.title': string;
+    'session.historyTitle': string;
+    'session.collapse': string;
+    'session.expand': string;
     'session.new': string;
     'session.searchPlaceholder': string;
     'session.searchClear': string;
     'session.empty': string;
-    'session.missingRoot': string;
     'session.skipped': string;
     'session.delete': string;
     'session.actions': string;
@@ -1803,6 +1975,15 @@ declare const useT: () => TranslateFn<{
     'interaction.pageAction.role.click': string;
     'interaction.pageAction.role.fill': string;
     'interaction.pageAction.role.submit': string;
+    'interaction.pageAction.frame': string;
+    'interaction.pageAction.elevated': string;
+    'interaction.traceEvidence.title': string;
+    'interaction.traceEvidence.columnDraft': string;
+    'interaction.traceEvidence.columnTrace': string;
+    'interaction.traceEvidence.trace': string;
+    'interaction.traceEvidence.model': string;
+    'interaction.traceEvidence.noArgs': string;
+    'interaction.traceEvidence.redacted': string;
     'interaction.origin': string;
     'interaction.submitted': string;
     'interaction.submit': string;
@@ -1817,6 +1998,11 @@ declare const useT: () => TranslateFn<{
     'surface.readOnlySnapshot': string;
     'surface.suggested': string;
     'surface.useSuggestion': string;
+    'surface.control.previousPage': string;
+    'surface.control.previous': string;
+    'surface.control.nextPage': string;
+    'surface.control.next': string;
+    'surface.control.carousel': string;
     'interaction.wait': string;
     'interaction.wait.inPanel': string;
     'interaction.wait.fallback': string;
@@ -1846,8 +2032,10 @@ declare const useT: () => TranslateFn<{
     'composer.attachment.kind.text': string;
     'composer.attachment.kind.image': string;
     'composer.attachment.kind.file': string;
+    'composer.attachment.kind.document-text': string;
     'composer.attachment.compressed': string;
     'composer.model': string;
+    'composer.model.unconfigured': string;
     'composer.model.demo': string;
     'composer.noModel.title': string;
     'composer.noModel.description': string;
@@ -1995,6 +2183,7 @@ declare const useT: () => TranslateFn<{
     'error.suggestion.RUN_INTERACTION_TIMEOUT': string;
     'error.suggestion.RUN_MAX_TURNS_EXCEEDED': string;
     'error.suggestion.TOOL_RESOLUTION_EXHAUSTED': string;
+    'error.suggestion.TOOL_SCHEMA_UNAVAILABLE': string;
     'error.limit.totalTimeoutMs': string;
     'error.limit.maxTurns': string;
     'error.message.RUN_CANCELLED': string;
@@ -2010,11 +2199,13 @@ declare const useT: () => TranslateFn<{
     'header.theme.dark': string;
     'header.language': string;
     'session.title': string;
+    'session.historyTitle': string;
+    'session.collapse': string;
+    'session.expand': string;
     'session.new': string;
     'session.searchPlaceholder': string;
     'session.searchClear': string;
     'session.empty': string;
-    'session.missingRoot': string;
     'session.skipped': string;
     'session.delete': string;
     'session.actions': string;
@@ -2140,6 +2331,15 @@ declare const useT: () => TranslateFn<{
     'interaction.pageAction.role.click': string;
     'interaction.pageAction.role.fill': string;
     'interaction.pageAction.role.submit': string;
+    'interaction.pageAction.frame': string;
+    'interaction.pageAction.elevated': string;
+    'interaction.traceEvidence.title': string;
+    'interaction.traceEvidence.columnDraft': string;
+    'interaction.traceEvidence.columnTrace': string;
+    'interaction.traceEvidence.trace': string;
+    'interaction.traceEvidence.model': string;
+    'interaction.traceEvidence.noArgs': string;
+    'interaction.traceEvidence.redacted': string;
     'interaction.origin': string;
     'interaction.submitted': string;
     'interaction.submit': string;
@@ -2154,6 +2354,11 @@ declare const useT: () => TranslateFn<{
     'surface.readOnlySnapshot': string;
     'surface.suggested': string;
     'surface.useSuggestion': string;
+    'surface.control.previousPage': string;
+    'surface.control.previous': string;
+    'surface.control.nextPage': string;
+    'surface.control.next': string;
+    'surface.control.carousel': string;
     'interaction.wait': string;
     'interaction.wait.inPanel': string;
     'interaction.wait.fallback': string;
@@ -2183,8 +2388,10 @@ declare const useT: () => TranslateFn<{
     'composer.attachment.kind.text': string;
     'composer.attachment.kind.image': string;
     'composer.attachment.kind.file': string;
+    'composer.attachment.kind.document-text': string;
     'composer.attachment.compressed': string;
     'composer.model': string;
+    'composer.model.unconfigured': string;
     'composer.model.demo': string;
     'composer.noModel.title': string;
     'composer.noModel.description': string;
@@ -2332,6 +2539,7 @@ declare const useT: () => TranslateFn<{
     'error.suggestion.RUN_INTERACTION_TIMEOUT': string;
     'error.suggestion.RUN_MAX_TURNS_EXCEEDED': string;
     'error.suggestion.TOOL_RESOLUTION_EXHAUSTED': string;
+    'error.suggestion.TOOL_SCHEMA_UNAVAILABLE': string;
     'error.limit.totalTimeoutMs': string;
     'error.limit.maxTurns': string;
     'error.message.RUN_CANCELLED': string;
@@ -2397,6 +2605,8 @@ interface ChatbotProps {
   surfaceRegistry?: SurfaceRegistry;
   /** 布局档（默认 'auto'：按容器尺寸在 fullscreen / embedded / mobile 之间判定） */
   layout?: ChatLayout;
+  /** 会话列表形态（默认 'auto'：按**容器**宽度判定，不看视口） @stable */
+  sessionList?: 'auto' | 'collapsed' | 'inline';
   /**
    * 打开配置面（FR-20.4）。配置面本身已迁到 console，chatbot 只负责发出这个请求；
    * 宿主不接就不渲染任何「打开设置」出口——给一个点了没反应的按钮更糟。
@@ -2414,7 +2624,7 @@ interface ChatbotProps {
  * presentation shell and accessible thread primitives.
  * @stable
  */
-declare function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, renderer: rendererProp, dictationLang: dictationLangProp, surfaceRegistry, layout, onOpenSettings, onEngineReady }: ChatbotProps): import("react").JSX.Element;
+declare function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, renderer: rendererProp, dictationLang: dictationLangProp, surfaceRegistry, layout, sessionList, onOpenSettings, onEngineReady }: ChatbotProps): import("react").JSX.Element;
 //#endregion
 //#region src/react/A2uiSurfaceHost.d.ts
 /** @experimental */
@@ -2598,6 +2808,6 @@ declare function ErrorCard({ code, message, loopLimits, onOpenSettings, onDismis
  * Version of the published `@webskill/chatbot` package, injected at build time.
  * @stable
  */
-declare const CHATBOT_VERSION = "0.7.0";
+declare const CHATBOT_VERSION = "0.8.0";
 //#endregion
-export { A2uiSurfaceHost, type A2uiSurfaceHostProps, A2uiSurfaceSnapshotHost, type A2uiSurfaceSnapshotHostProps, type AppearanceChange, CHATBOT_VERSION, type ChatAttachmentInput, type ChatAttachmentMeta, ChatEngine, type ChatEngineOptions, type ChatEvent, type ChatInteractionRecord, type ChatLayout, type ChatMessage, type ChatRunPhase, type ChatSessionListResult, type ChatSessionMeta, type ChatTheme, type ChatThinking, type ChatTokenUsage, type ChatToolCall, Chatbot, type ChatbotConfig, type ChatbotGovernancePorts, type ChatbotHostAdapter, type ChatbotProps, CompositeUiBridge, type CompositeUiBridgeDeps, DEFAULT_RENDERER_CAPABILITIES, DEFAULT_RUNTIME_CONFIG_STORAGE_KEY, type DownloadableFile, ErrorCard, type ErrorCardProps, InteractionCard, type InteractionCardProps, InterruptedBanner, type InterruptedBannerProps, type Locale, OpenUiSurfaceHost, type OpenUiSurfaceHostProps, OpenUiSurfaceSnapshotHost, type OpenUiSurfaceSnapshotHostProps, type RendererCapability, type RendererKind, type ResolvedChatLayout, ResultBlockList, type ResultBlockListProps, ResultBlocksPro, type ResultBlocksProProps, type RunSnapshot, type RuntimeAppearanceConfig, type RuntimeConfig, type RuntimeConfigStore, type RuntimeRendererId, type SandboxExecutorDeps, type SettingsSectionId, SkillBadges, SpecInteraction, type SpecInteractionProps, VercelPayloadPreview, type VercelPayloadPreviewProps, VercelSurfaceHost, type VercelSurfaceHostProps, VercelSurfaceSnapshotHost, type VercelSurfaceSnapshotHostProps, chatbotDictionary, configureA2uiMarkdown, createLocalStorageRuntimeConfigStore, createMemoryRuntimeConfigStore, pickUsableLlmEntry, probeA2uiAvailability, probeOpenUiAvailability, sandboxExecutorDeps, useT };
+export { A2uiSurfaceHost, type A2uiSurfaceHostProps, A2uiSurfaceSnapshotHost, type A2uiSurfaceSnapshotHostProps, type AppearanceChange, CHATBOT_VERSION, type ChatAttachmentInput, type ChatAttachmentMeta, type ChatContentPart, ChatEngine, type ChatEngineOptions, type ChatEvent, type ChatInteractionRecord, type ChatLayout, type ChatMessage, type ChatRunPhase, type ChatSessionListResult, type ChatSessionMeta, type ChatTheme, type ChatThinking, type ChatTokenUsage, type ChatToolCall, Chatbot, type ChatbotConfig, type ChatbotGovernancePorts, type ChatbotHostAdapter, type ChatbotProps, CompositeUiBridge, type CompositeUiBridgeDeps, DEFAULT_RENDERER_CAPABILITIES, DEFAULT_RUNTIME_CONFIG_STORAGE_KEY, type DownloadableFile, ErrorCard, type ErrorCardProps, InteractionCard, type InteractionCardProps, InterruptedBanner, type InterruptedBannerProps, type Locale, OpenUiSurfaceHost, type OpenUiSurfaceHostProps, OpenUiSurfaceSnapshotHost, type OpenUiSurfaceSnapshotHostProps, type QuickPrompt, type QuickPromptIconName, type RendererCapability, type RendererKind, type ResolvedChatLayout, ResultBlockList, type ResultBlockListProps, ResultBlocksPro, type ResultBlocksProProps, type RunSnapshot, type RuntimeAppearanceConfig, type RuntimeConfig, type RuntimeConfigStore, type RuntimeRendererId, type SandboxExecutorDeps, type SettingsSectionId, SkillBadges, SpecInteraction, type SpecInteractionProps, VercelPayloadPreview, type VercelPayloadPreviewProps, VercelSurfaceHost, type VercelSurfaceHostProps, VercelSurfaceSnapshotHost, type VercelSurfaceSnapshotHostProps, chatbotDictionary, configureA2uiMarkdown, createLocalStorageRuntimeConfigStore, createMemoryRuntimeConfigStore, isLlmEntryUsable, pickUsableLlmEntry, probeA2uiAvailability, probeOpenUiAvailability, sandboxExecutorDeps, useT };