@webskill/chatbot 0.7.0 → 0.8.0

package/dist/chatbot.css

@@ -11,7 +11,6 @@
     --container-sm: 24rem;
     --container-md: 28rem;
     --container-2xl: 42rem;
-    --container-3xl: 48rem;
     --text-xs: 0.75rem;
     --text-xs--line-height: calc(1 / 0.75);
     --text-sm: 0.875rem;
@@ -429,6 +428,9 @@
   .table {
     display: table;
   }
+  .aspect-\[4\/3\] {
+    aspect-ratio: 4/3;
+  }
   .aspect-square {
     aspect-ratio: 1 / 1;
   }
@@ -582,6 +584,9 @@
   .w-40 {
     width: calc(var(--spacing) * 40);
   }
+  .w-48 {
+    width: calc(var(--spacing) * 48);
+  }
   .w-72 {
     width: calc(var(--spacing) * 72);
   }
@@ -612,9 +617,6 @@
   .max-w-2xl {
     max-width: var(--container-2xl);
   }
-  .max-w-3xl {
-    max-width: var(--container-3xl);
-  }
   .max-w-48 {
     max-width: calc(var(--spacing) * 48);
   }
@@ -725,6 +727,15 @@
   .resize-y {
     resize: vertical;
   }
+  .snap-x {
+    scroll-snap-type: x var(--tw-scroll-snap-strictness);
+  }
+  .snap-mandatory {
+    --tw-scroll-snap-strictness: mandatory;
+  }
+  .snap-start {
+    scroll-snap-align: start;
+  }
   .list-decimal {
     list-style-type: decimal;
   }
@@ -734,6 +745,9 @@
   .grid-cols-1 {
     grid-template-columns: repeat(1, minmax(0, 1fr));
   }
+  .grid-cols-\[auto_1fr\] {
+    grid-template-columns: auto 1fr;
+  }
   .flex-col {
     flex-direction: column;
   }
@@ -796,6 +810,12 @@
     margin-block-start: calc(var(--spacing) * var(--tw-space-y-reverse));
     margin-block-end: calc(var(--spacing) * calc(1 - var(--tw-space-y-reverse)));
   }
+  .gap-x-4 {
+    column-gap: calc(var(--spacing) * 4);
+  }
+  .gap-y-1 {
+    row-gap: var(--spacing);
+  }
   :where(.divide-y > :not(:last-child)) {
     --tw-divide-y-reverse: 0;
     border-bottom-style: var(--tw-border-style);
@@ -910,6 +930,10 @@
     border-left-style: var(--tw-border-style);
     border-left-width: 1px;
   }
+  .border-l-2 {
+    border-left-style: var(--tw-border-style);
+    border-left-width: 2px;
+  }
   .border-dashed {
     --tw-border-style: dashed;
     border-style: dashed;
@@ -998,18 +1022,6 @@
   .bg-destructive-soft {
     background-color: var(--destructive-soft);
   }
-  .bg-foreground\/35 {
-    background-color: var(--foreground);
-    @supports (color: color-mix(in lab, red, red)) {
-      background-color: color-mix(in oklab, var(--foreground) 35%, transparent);
-    }
-  }
-  .bg-foreground\/45 {
-    background-color: var(--foreground);
-    @supports (color: color-mix(in lab, red, red)) {
-      background-color: color-mix(in oklab, var(--foreground) 45%, transparent);
-    }
-  }
   .bg-info {
     background-color: var(--info);
   }
@@ -1019,12 +1031,6 @@
   .bg-ink {
     background-color: var(--foreground);
   }
-  .bg-ink\/35 {
-    background-color: var(--foreground);
-    @supports (color: color-mix(in lab, red, red)) {
-      background-color: color-mix(in oklab, var(--foreground) 35%, transparent);
-    }
-  }
   .bg-muted {
     background-color: var(--muted-foreground);
   }
@@ -1037,6 +1043,9 @@
   .bg-primary {
     background-color: var(--primary);
   }
+  .bg-scrim {
+    background-color: var(--scrim);
+  }
   .bg-secondary {
     background-color: var(--secondary);
   }
@@ -1091,6 +1100,9 @@
   .p-4 {
     padding: calc(var(--spacing) * 4);
   }
+  .p-5 {
+    padding: calc(var(--spacing) * 5);
+  }
   .px-1 {
     padding-inline: var(--spacing);
   }
@@ -1178,6 +1190,9 @@
   .pl-2 {
     padding-left: calc(var(--spacing) * 2);
   }
+  .pl-3 {
+    padding-left: calc(var(--spacing) * 3);
+  }
   .pl-4 {
     padding-left: calc(var(--spacing) * 4);
   }
@@ -1323,6 +1338,9 @@
   .italic {
     font-style: italic;
   }
+  .not-italic {
+    font-style: normal;
+  }
   .tabular-nums {
     --tw-numeric-spacing: tabular-nums;
     font-variant-numeric: var(--tw-ordinal,) var(--tw-slashed-zero,) var(--tw-numeric-figure,) var(--tw-numeric-spacing,) var(--tw-numeric-fraction,);
@@ -2014,6 +2032,7 @@
 :where(.dark, .light, [data-theme]) {
   --color-background: var(--background);
   --color-foreground: var(--foreground);
+  --color-scrim: var(--scrim);
   --color-card: var(--card);
   --color-card-foreground: var(--card-foreground);
   --color-popover: var(--popover);
@@ -2064,8 +2083,22 @@
 }
 :root, :where(.light, [data-theme='light']) {
   --radius: 0.625rem;
+  --shadow-card-vivid: 0 6px 20px oklch(0 0 0 / 12%);
+  --surface-dashboard: oklch(0.2 0.01 260);
+  --border-dashboard: oklch(1 0 0 / 14%);
+  --palette-sky: oklch(0.95 0.03 240);
+  --palette-sky-ink: oklch(0.35 0.09 240);
+  --palette-violet: oklch(0.95 0.03 300);
+  --palette-violet-ink: oklch(0.35 0.1 300);
+  --palette-amber: oklch(0.95 0.05 85);
+  --palette-amber-ink: oklch(0.36 0.09 85);
+  --palette-rose: oklch(0.95 0.03 15);
+  --palette-rose-ink: oklch(0.37 0.11 15);
+  --palette-emerald: oklch(0.95 0.04 160);
+  --palette-emerald-ink: oklch(0.34 0.08 160);
   --background: oklch(1 0 0);
   --foreground: oklch(0.145 0 0);
+  --scrim: oklch(0.145 0 0 / 45%);
   --card: oklch(1 0 0);
   --card-foreground: oklch(0.145 0 0);
   --popover: oklch(1 0 0);
@@ -2154,8 +2187,22 @@
   --code-url: hsl(198, 99%, 37%);
 }
 :where(.dark, [data-theme='dark']) {
+  --shadow-card-vivid: 0 6px 20px oklch(0 0 0 / 40%);
+  --surface-dashboard: oklch(0.18 0.01 260);
+  --border-dashboard: oklch(1 0 0 / 16%);
+  --palette-sky: oklch(0.3 0.05 240);
+  --palette-sky-ink: oklch(0.88 0.06 240);
+  --palette-violet: oklch(0.3 0.06 300);
+  --palette-violet-ink: oklch(0.88 0.07 300);
+  --palette-amber: oklch(0.32 0.06 85);
+  --palette-amber-ink: oklch(0.9 0.09 85);
+  --palette-rose: oklch(0.31 0.06 15);
+  --palette-rose-ink: oklch(0.89 0.07 15);
+  --palette-emerald: oklch(0.29 0.05 160);
+  --palette-emerald-ink: oklch(0.88 0.08 160);
   --background: oklch(0.145 0 0);
   --foreground: oklch(0.985 0 0);
+  --scrim: oklch(0 0 0 / 60%);
   --card: oklch(0.205 0 0);
   --card-foreground: oklch(0.985 0 0);
   --popover: oklch(0.205 0 0);
@@ -2531,8 +2578,86 @@
 .webskill-surface--error, .webskill-surface--unsupported {
   border-color: var(--destructive);
 }
+.webskill-palette-sky {
+  background: var(--palette-sky);
+  color: var(--palette-sky-ink);
+}
+.webskill-palette-violet {
+  background: var(--palette-violet);
+  color: var(--palette-violet-ink);
+}
+.webskill-palette-amber {
+  background: var(--palette-amber);
+  color: var(--palette-amber-ink);
+}
+.webskill-palette-rose {
+  background: var(--palette-rose);
+  color: var(--palette-rose-ink);
+}
+.webskill-palette-emerald {
+  background: var(--palette-emerald);
+  color: var(--palette-emerald-ink);
+}
+[data-webskill-theme='vivid'] {
+  --radius-card: 1rem;
+  --shadow-card: var(--shadow-card-vivid);
+}
+[data-webskill-theme='dashboard-dark'] {
+  --radius-card: 0.375rem;
+  --shadow-card: none;
+  --color-surface: var(--surface-dashboard);
+  --color-border: var(--border-dashboard);
+}
+.webskill-spec-split {
+  container-type: inline-size;
+  grid-template-columns: var(--split-ratio, 1fr 1fr);
+}
+.webskill-spec-card--span2 {
+  grid-column: span 2;
+}
+@container (max-width: 30rem) {
+  .webskill-spec-split {
+    grid-template-columns: 1fr;
+  }
+  .webskill-spec-card--span2 {
+    grid-column: auto;
+  }
+}
+.webskill-spec-form__fields {
+  display: grid;
+  gap: 0.75rem;
+  container-type: inline-size;
+  grid-template-columns: repeat(auto-fit, minmax(16rem, 1fr));
+}
+.webskill-spec-form__fields > :has(textarea), .webskill-spec-form__fields > [data-field-span='full'] {
+  grid-column: 1 / -1;
+}
 .webskill-aui-shell {
   background: var(--color-background);
+  --webskill-chat-prose-max: 48rem;
+  --webskill-chat-surface-max: 64rem;
+}
+.webskill-aui-shell[data-layout='fullscreen'] {
+  --webskill-chat-surface-max: 80rem;
+}
+.webskill-aui-shell[data-layout='mobile'] {
+  --webskill-chat-prose-max: 100%;
+  --webskill-chat-surface-max: 100%;
+}
+.webskill-chat-prose {
+  max-width: var(--webskill-chat-prose-max);
+}
+.webskill-chat-column {
+  container-type: inline-size;
+}
+.webskill-chat-surface-wide:has([data-webskill-multicol]) {
+  --webskill-chat-surface-w: min(var(--webskill-chat-surface-max), 100cqw - 2rem);
+  width: var(--webskill-chat-surface-w);
+  margin-inline: calc((100% - var(--webskill-chat-surface-w)) / 2);
+}
+.webskill-aui-shell[data-layout='mobile'] .webskill-chat-surface-wide {
+  width: 100%;
+  margin-inline: 0;
 }
 .webskill-aui-header {
   border-color: var(--color-border);
@@ -2649,6 +2774,11 @@
   inherits: false;
   initial-value: 0;
 }
+@property --tw-scroll-snap-strictness {
+  syntax: "*";
+  inherits: false;
+  initial-value: proximity;
+}
 @property --tw-space-y-reverse {
   syntax: "*";
   inherits: false;
@@ -2884,6 +3014,7 @@
       --tw-translate-x: 0;
       --tw-translate-y: 0;
       --tw-translate-z: 0;
+      --tw-scroll-snap-strictness: proximity;
       --tw-space-y-reverse: 0;
       --tw-divide-y-reverse: 0;
       --tw-border-style: solid;

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 {
@@ -630,7 +661,8 @@ interface ChatbotConfig {
   quickPrompts?: string[];
   /**
    * 开启后模型多一个 `render_ui` 工具，可面向 AI Component Catalog 直接生成声明式 UI。
-   * 默认关：工具描述 + 入参 schema 约 14 KB，会计入每一次请求。
+   * 默认关：工具描述 + 入参 schema 约 34 KB，会计入每一次请求。
+   * 数字的单一来源是 `@webskill/ui` 的 `catalog/budget.ts`（实测终态 12 744 + 21 470）。
    *
    * 接了 `runtimeConfig` 时以 `RuntimeConfig.agentCapabilities.generativeUi` 为准
    * （设置抽屉里的开关就是它），本字段只在未接配置存储的宿主上生效。
@@ -649,6 +681,14 @@ interface ChatbotConfig {
    * `SKILL_GENERATION_DISABLED`，不弹确认框、不产生候选。
    */
   skillCandidates?: SkillCandidateSink;
+  /**
+   * 宿主声明的数据源取数入口（分册 16）：透传给 `ChatEngineOptions.fetchData`。
+   * 不注入即脚本上下文没有 `fetchData` 这个键。
+   *
+   * **必须是稳定引用**（模块级或 `useMemo`）：它进 `ChatEngine` 的 `useMemo`
+   * 依赖表，每次渲染新建一个箭头函数会把整个引擎重建掉。
+   */
+  fetchData?: (sourceId: string, params?: Record<string, unknown>) => Promise<unknown>;
 }
 //#endregion
 //#region src/core/hostAdapter.d.ts
@@ -685,9 +725,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 +806,14 @@ interface ChatEngineOptions {
   generativeUi?: boolean;
   /** 沙箱执行器替换点（测试注入 spy 断言构造参数；缺省 BrowserWorkerScriptExecutor） */
   executorFactory?: (deps: SandboxExecutorDeps) => ScriptExecutor;
+  /**
+   * 宿主声明的数据源取数入口（分册 16）。不注入即脚本上下文没有 `fetchData` 这个键。
+   *
+   * 装配点必须在宿主：策略本体 `DataSourcePolicy` 住在 `@webskill/agent`，
+   * 而数据源的目标地址是宿主自己的业务知识，chatbot 无从代为声明。
+   * 能力开关 `sandbox.capabilities.fetchData` 缺省关，注入了也还要宿主在配置里打开。
+   */
+  fetchData?: (sourceId: string, params?: Record<string, unknown>) => Promise<unknown>;
   /**
    * 会话落盘替换点（缺省 `FsSessionStore`，落在 `<chatRoot>/sessions`）。
    * 宕主换自己的实现（如 IndexedDB）与测试统计端口读写量都走这里。
@@ -1169,8 +1241,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;
@@ -1506,8 +1580,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;
@@ -1846,8 +1922,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;
@@ -2183,8 +2261,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;
@@ -2598,6 +2678,6 @@ declare function ErrorCard({ code, message, loopLimits, onOpenSettings, onDismis
  * Version of the published `@webskill/chatbot` package, injected at build time.
  * @stable
  */
-declare const CHATBOT_VERSION = "0.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, ChatEngine, type ChatEngineOptions, type ChatEvent, type ChatInteractionRecord, type ChatLayout, type ChatMessage, type ChatRunPhase, type ChatSessionListResult, type ChatSessionMeta, type ChatTheme, type ChatThinking, type ChatTokenUsage, type ChatToolCall, Chatbot, type ChatbotConfig, type ChatbotGovernancePorts, type ChatbotHostAdapter, type ChatbotProps, CompositeUiBridge, type CompositeUiBridgeDeps, DEFAULT_RENDERER_CAPABILITIES, DEFAULT_RUNTIME_CONFIG_STORAGE_KEY, type DownloadableFile, ErrorCard, type ErrorCardProps, InteractionCard, type InteractionCardProps, InterruptedBanner, type InterruptedBannerProps, type Locale, OpenUiSurfaceHost, type OpenUiSurfaceHostProps, OpenUiSurfaceSnapshotHost, type OpenUiSurfaceSnapshotHostProps, type RendererCapability, type RendererKind, type ResolvedChatLayout, ResultBlockList, type ResultBlockListProps, ResultBlocksPro, type ResultBlocksProProps, type RunSnapshot, type RuntimeAppearanceConfig, type RuntimeConfig, type RuntimeConfigStore, type RuntimeRendererId, type SandboxExecutorDeps, type SettingsSectionId, SkillBadges, SpecInteraction, type SpecInteractionProps, VercelPayloadPreview, type VercelPayloadPreviewProps, VercelSurfaceHost, type VercelSurfaceHostProps, VercelSurfaceSnapshotHost, type VercelSurfaceSnapshotHostProps, chatbotDictionary, configureA2uiMarkdown, createLocalStorageRuntimeConfigStore, createMemoryRuntimeConfigStore, isLlmEntryUsable, pickUsableLlmEntry, probeA2uiAvailability, probeOpenUiAvailability, sandboxExecutorDeps, useT };

package/dist/index.js

@@ -7678,7 +7678,7 @@ function SheetContent({ children, className = "", side = "right", title, size, h
 	const gutterClass = side === "left" ? "left-full" : "right-full";
 	return /* @__PURE__ */ jsxs(DialogPortal, {
 		container: usePortalContainer(),
-		children: [/* @__PURE__ */ jsx(DialogOverlay, { className: "fixed inset-0 z-[var(--webskill-z-scrim)] bg-ink/35 backdrop-blur-[1px]" }), /* @__PURE__ */ jsxs(DialogContent, {
+		children: [/* @__PURE__ */ jsx(DialogOverlay, { className: "fixed inset-0 z-[var(--webskill-z-scrim)] bg-scrim backdrop-blur-[1px]" }), /* @__PURE__ */ jsxs(DialogContent, {
 			className: `webskill-sheet-content fixed z-[var(--webskill-z-sheet)] flex flex-col bg-surface text-ink shadow-pop outline-none ${positionClass} ${className}`,
 			style: size === void 0 ? style : {
 				...style,
@@ -7730,7 +7730,7 @@ function Dialog({ open, onClose, title, description, footer, hideCloseButton = f
 		onOpenChange: (nextOpen) => !nextOpen && onClose(),
 		children: /* @__PURE__ */ jsxs(DialogPortal, {
 			container: usePortalContainer(),
-			children: [/* @__PURE__ */ jsx(DialogOverlay, { className: "fixed inset-0 z-[var(--webskill-z-scrim)] bg-foreground/45" }), /* @__PURE__ */ jsxs(DialogContent, {
+			children: [/* @__PURE__ */ jsx(DialogOverlay, { className: "fixed inset-0 z-[var(--webskill-z-scrim)] bg-scrim" }), /* @__PURE__ */ jsxs(DialogContent, {
 				className: `webskill-dialog-content fixed top-1/2 left-1/2 z-[var(--webskill-z-dialog)] flex max-h-[calc(100dvh-2rem)] -translate-x-1/2 -translate-y-1/2 flex-col rounded-card border border-border bg-surface shadow-pop outline-none max-sm:top-0 max-sm:left-0 max-sm:h-dvh max-sm:max-h-dvh max-sm:translate-x-0 max-sm:translate-y-0 max-sm:rounded-none ${className}`,
 				...size !== void 0 ? { style: { "--webskill-dialog-width": DIALOG_WIDTHS[size] } } : {},
 				children: [
@@ -12014,7 +12014,7 @@ function AlertDialog({ open, title, description, footer, className = "", size, c
 		open,
 		children: /* @__PURE__ */ jsxs(Portal2, {
 			container: usePortalContainer(),
-			children: [/* @__PURE__ */ jsx(Overlay2, { className: "fixed inset-0 z-[var(--webskill-z-scrim)] bg-foreground/45" }), /* @__PURE__ */ jsxs(Content2, {
+			children: [/* @__PURE__ */ jsx(Overlay2, { className: "fixed inset-0 z-[var(--webskill-z-scrim)] bg-scrim" }), /* @__PURE__ */ jsxs(Content2, {
 				onEscapeKeyDown: (event) => event.preventDefault(),
 				className: `webskill-dialog-content fixed top-1/2 left-1/2 z-[var(--webskill-z-dialog)] flex max-h-[calc(100dvh-2rem)] -translate-x-1/2 -translate-y-1/2 flex-col rounded-card border border-border bg-surface shadow-pop outline-none ${className}`,
 				...size !== void 0 ? { style: { "--webskill-dialog-width": DIALOG_WIDTHS[size] } } : {},
@@ -43213,6 +43213,39 @@ const fadeInUp = {
 	}
 };
 
+//#endregion
+//#region ../runtime/src/tools/types.ts
+/**
+* `file` 分片的上限（FR-23.4），量的是**实际上线的 base64 长度**而不是解码后的字节——
+* provider 的限额算的是请求载荷。
+*
+* 2026-08-14 查证的三家上限：
+* | provider  | 上限                                    | 出处                    |
+* | --------- | --------------------------------------- | ----------------------- |
+* | Anthropic | **32 MB**（**整个请求载荷**）、600 页   | PDF support / 请求大小  |
+* | OpenAI    | 单文件 50 MB，全部文件合计 50 MB        | File inputs / 使用须知  |
+* | Gemini    | 50 MB 或 1000 页（内联与 Files API 同） | 文档理解 / 技术详情     |
+*
+* 取最小值 Anthropic 的 32 MB。它是**整个请求**的额度，不是文档单独的额度，
+* 所以再留出余量给系统提示词、catalog（约 34 KB）、历史消息与其余分片。
+* 25 000 KB base64 ≈ 18.75 MB 原始 PDF。取 1024 的整数倍：设置界面按 KB 展示，
+* 十进制的 24 000 000 会显示成 23437.5 这种读不出来的数。
+*/
+const DEFAULT_MAX_DOCUMENT_BYTES = 256e5;
+/**
+* `document-text` 分片的上限（FR-23.4）。
+*
+* 约束来自**上下文窗口**而不是请求大小：抽出来的文本要整段进上下文。
+* 按英文约 4 字节/token 折算，500 KB ≈ 128K token，占 200K 窗口的多半，
+* 给历史消息与模型的回答留下其余。
+*/
+const DEFAULT_MAX_DOCUMENT_TEXT_BYTES = 512e3;
+/**
+* 单次 fetchData 结果的字节上限（分册 16，FR-16.6）：1000 KB。
+* 结构化数据不是文档，量级差一个数量级；超出**只拒不截**——截断的 JSON 解不出来。
+*/
+const DEFAULT_MAX_DATA_SOURCE_BYTES = 1024e3;
+
 //#endregion
 //#region ../runtime/src/engine/limits.ts
 /**
@@ -43256,7 +43289,9 @@ function defaultRuntimeConfig() {
 		loop: {
 			...DEFAULT_LOOP_LIMITS$1,
 			toolResultMaxBytes: 256e3,
-			maxHistoryMessages: 100
+			maxHistoryMessages: 100,
+			maxDocumentBytes: DEFAULT_MAX_DOCUMENT_BYTES,
+			maxDocumentTextBytes: DEFAULT_MAX_DOCUMENT_TEXT_BYTES
 		},
 		interaction: {
 			missingParams: "user",
@@ -43276,9 +43311,12 @@ function defaultRuntimeConfig() {
 			networkPolicy: "deny-all",
 			capabilities: {
 				readReference: true,
+				readAsset: true,
 				writeArtifact: true,
-				confirm: true
+				confirm: true,
+				fetchData: false
 			},
+			maxDataSourceBytes: DEFAULT_MAX_DATA_SOURCE_BYTES,
 			remoteUrl: {
 				allowHttp: false,
 				allowPrivateHosts: false
@@ -43306,9 +43344,10 @@ function defaultRuntimeConfig() {
 			maxImageBytes: 10 * 1024 * 1024,
 			maxImagesPerMessage: 5
 		},
+		documentSurface: { enabled: false },
 		userProfile: {
 			enabled: false,
-			injectMaxBytes: 4e3,
+			injectMaxBytes: 4096,
 			recordLimit: 500,
 			encrypted: true
 		},
@@ -43394,6 +43433,7 @@ function mergeRuntimeConfigDefaults(partial) {
 		security: sub("security", d.security),
 		appearance: mergeAppearance(p["appearance"], d.appearance),
 		multimodal: mergeMultimodal(p["multimodal"], d.multimodal),
+		documentSurface: mergeDocumentSurface(p["documentSurface"], d.documentSurface),
 		userProfile: mergeUserProfile(p["userProfile"], d.userProfile),
 		skillState: mergeSkillState(p["skillState"], d.skillState),
 		dismissedAutoEntries: readStringList$1(p["dismissedAutoEntries"], [])
@@ -43429,6 +43469,14 @@ function mergeMultimodal(raw, d) {
 		maxImagesPerMessage: positive(p["maxImagesPerMessage"], d.maxImagesPerMessage)
 	};
 }
+/**
+* CSP 白名单只收字符串数组；存储被污染时回退默认值（空），
+* **不能**把非法值原样带进 CSP —— `viewerCspHeader` 会抛，等于整条投放面瘫掉。
+*/
+function mergeDocumentSurface(raw, d) {
+	const p = typeof raw === "object" && raw !== null ? raw : {};
+	return { enabled: typeof p["enabled"] === "boolean" ? p["enabled"] : d.enabled };
+}
 /** 与 multimodal 同一套判据：非正数上限会让记录/注入通道恒空，回退默认值 */
 function mergeUserProfile(raw, d) {
 	const p = typeof raw === "object" && raw !== null ? raw : {};
@@ -43563,6 +43611,8 @@ function createMemoryRuntimeConfigStore(initial) {
 /**
 * 条目未显式标注时：`image` 按「不支持」（推断表覆盖不到私有部署的模型名），
 * `tools` 按「支持」（只有显式写 false 才降级，否则升级后的存量配置会突然不能用技能）
+* `document` 同 `image` 按「不支持」：猜错的代价是把 PDF 发给纯文本模型，
+* 用户拿到的是 provider 的原始报错（FR-23.5）。
 * @experimental
 */
 function entryCapabilities(entry) {
@@ -44134,8 +44184,10 @@ const chatbotDictionary = defineDictionary({
 		"composer.attachment.kind.text": "Text",
 		"composer.attachment.kind.image": "Image",
 		"composer.attachment.kind.file": "File",
+		"composer.attachment.kind.document-text": "Doc text",
 		"composer.attachment.compressed": "Compressed {from} → {to}",
 		"composer.model": "Model",
+		"composer.model.unconfigured": "Not usable: this entry has no API key or base URL. Configure it in the console.",
 		"composer.model.demo": "Demo model",
 		"composer.noModel.title": "No model configured",
 		"composer.noModel.description": "A large language model has not been configured yet. Configure one on the model settings page before chatting.",
@@ -44213,7 +44265,7 @@ const chatbotDictionary = defineDictionary({
 		"settings.agent.todo": "Task list",
 		"settings.agent.todoNote": "Lets the model split a multi-step request into a checklist and report progress.",
 		"settings.agent.generativeUi": "Generative UI",
-		"settings.agent.generativeUiNote": "Gates only the model’s own render_ui tool: letting the model start a screen on its own, picking the components and layout. Off by default: the component catalogue adds ~14 KB per request.",
+		"settings.agent.generativeUiNote": "Gates only the model’s own render_ui tool: letting the model start a screen on its own, picking the components and layout. Off by default: the component catalogue adds ~34 KB per request.",
 		"settings.agent.generativeUiUnaffected": "Turning this off does not hide skill-provided screens, interaction cards, or built-in result blocks.",
 		"settings.agent.skillGeneration": "Skill generation",
 		"settings.agent.skillGenerationNote": "Lets the model turn a reusable procedure from this conversation into a skill candidate. You confirm each one, and a reviewer approves it before anyone can use it.",
@@ -44471,8 +44523,10 @@ const chatbotDictionary = defineDictionary({
 		"composer.attachment.kind.text": "文本",
 		"composer.attachment.kind.image": "图片",
 		"composer.attachment.kind.file": "文件",
+		"composer.attachment.kind.document-text": "文档正文",
 		"composer.attachment.compressed": "已压缩 {from} → {to}",
 		"composer.model": "模型",
+		"composer.model.unconfigured": "不可用：该条目既没有 API 密钥也没有基础地址，请在控制台补全。",
 		"composer.model.demo": "演示模型",
 		"composer.noModel.title": "尚未配置大模型",
 		"composer.noModel.description": "大模型尚未配置，请先前往大模型配置页面完成配置，再开始对话。",
@@ -44550,7 +44604,7 @@ const chatbotDictionary = defineDictionary({
 		"settings.agent.todo": "待办清单",
 		"settings.agent.todoNote": "允许模型把多步骤任务拆成清单，并在执行中回报进度。",
 		"settings.agent.generativeUi": "生成式 UI",
-		"settings.agent.generativeUiNote": "仅控制模型自己的 render_ui 工具：允许模型自行发起界面、自选组件与布局。默认关闭：组件目录会给每次请求增加约 14 KB。",
+		"settings.agent.generativeUiNote": "仅控制模型自己的 render_ui 工具：允许模型自行发起界面、自选组件与布局。默认关闭：组件目录会给每次请求增加约 34 KB。",
 		"settings.agent.generativeUiUnaffected": "关掉它不会隐藏技能自带的界面、交互卡，以及内建的结果块。",
 		"settings.agent.skillGeneration": "技能自动生成",
 		"settings.agent.skillGenerationNote": "允许模型把本次对话里可复用的做法整理成技能候选。每个候选都需你当场确认，且经审核通过后才能被使用。",
@@ -44657,7 +44711,7 @@ const DISPLAY_PHASE = {
 * 归并后追加一个相位；同相位连续到达时返回原数组本身，
 * 调用方据引用相等判断「没变化」，不必再做深比较。
 */
-function appendRunPhase(phases, phase, at, note) {
+function appendRunPhase(phases, phase, at, note, detail) {
 	const display = DISPLAY_PHASE[phase];
 	const last = phases.at(-1);
 	if (last?.phase === display) return phases;
@@ -44667,7 +44721,8 @@ function appendRunPhase(phases, phase, at, note) {
 	}] : [], {
 		phase: display,
 		at,
-		...note !== void 0 ? { note } : {}
+		...note !== void 0 ? { note } : {},
+		...detail !== void 0 ? { detail } : {}
 	}];
 }
 /** 相位摘要：唯一读 `data` 的地方，此处事件还带着 `phase` 判别，下游不必再猜键名 */
@@ -44681,6 +44736,10 @@ function phaseNote(event) {
 		default: return;
 	}
 }
+/** 失败相位的具体说明（`reason` 之外的那句话）。只有 fail 有，其余相位一律 undefined。 */
+function phaseDetail(event) {
+	return event.phase === "fail" ? event.data.detail : void 0;
+}
 
 //#endregion
 //#region src/core/title.ts
@@ -44794,8 +44853,10 @@ const CHATBOT_PROFILE_USER_ID = "local";
 * 终止原因 → 稳定错误码（FR-21.2）。不再全部压平为 RUN_FAILED：
 * “跑超时了”与“模型没配对”对用户是两件事，得给不同的下一步。
 */
-const runFailureCode = (reason) => {
-	switch (reason) {
+const runFailureCode = (run) => {
+	const traced = ((run.trace?.find((event) => event.type === "run.failed"))?.data)?.code;
+	if (typeof traced === "string") return traced;
+	switch (run.terminationReason) {
 		case "timeout": return "RUN_TIMEOUT";
 		case "interaction-timeout": return "RUN_INTERACTION_TIMEOUT";
 		case "max-turns": return "RUN_MAX_TURNS_EXCEEDED";
@@ -44865,8 +44926,14 @@ const SANDBOX_MODE = {
 	"blob-worker": "worker",
 	"iframe-sandbox": "iframe"
 };
-/** 条目能否真的发请求：云端要有端点或密钥，浏览器内置两者都不需要 */
-const isUsableEntry = (entry) => entry.provider === "chrome-builtin" || Boolean(entry.apiKey?.trim()) || Boolean(entry.baseUrl?.trim());
+/**
+* 条目能否真的发请求：云端要有端点或密钥，浏览器内置两者都不需要。
+*
+* 导出给 UI：选择器不用同一份判据的话，用户能选中一个空配置条目，
+* 而引擎静默回退到另一条——界面说在用 A、实际跑的是 B（UI-UX8 D1）。
+* @experimental
+*/
+const isLlmEntryUsable = (entry) => entry.provider === "chrome-builtin" || Boolean(entry.apiKey?.trim()) || Boolean(entry.baseUrl?.trim());
 /**
 * 选中条目 → 默认条目 → 首条；命中不可用条目时**回退到下一个可用条目**
 * （0.10.0 复核：选中项失效时宁可静默换用可用模型，也不能把 UI 锁死成
@@ -44883,7 +44950,7 @@ function pickUsableLlmEntry(entries, defaultId, selectedId) {
 		byId(selectedId),
 		byId(defaultId),
 		...entries
-	].find((entry) => entry !== void 0 && isUsableEntry(entry));
+	].find((entry) => entry !== void 0 && isLlmEntryUsable(entry));
 }
 /** 选中条目 → 默认条目 → 首条；都没有则返回 undefined（走内置演示） */
 function pickLlmEntry(rc, selectedId) {
@@ -45401,12 +45468,13 @@ var ChatEngine = class {
 		for (const attachment of attachments) {
 			const path = `${this.attachmentsRoot}/${attachment.path}`;
 			if (!await this.#adapter.storage.exists(path)) continue;
-			if (attachment.kind === "text") {
+			if (attachment.kind === "text" || attachment.kind === "document-text") {
 				const body = await this.#adapter.storage.readText(path);
 				const clipped = body.length > ATTACHMENT_TEXT_LIMIT ? `${body.slice(0, ATTACHMENT_TEXT_LIMIT)}\n[truncated]` : body;
+				const label = attachment.kind === "document-text" ? `${attachment.name} (${attachment.contentType}, body text only)` : `${attachment.name} (${attachment.contentType})`;
 				parts.push({
 					type: "text",
-					text: `--- Attachment: ${attachment.name} (${attachment.contentType}) ---\n${clipped}`
+					text: `--- Attachment: ${label} ---\n${clipped}`
 				});
 				continue;
 			}
@@ -45727,6 +45795,7 @@ var ChatEngine = class {
 				toolTimeoutMs: rc.loop.toolTimeoutMs,
 				...rc.loop.temperature !== void 0 ? { temperature: rc.loop.temperature } : {},
 				toolResultMaxBytes: rc.loop.toolResultMaxBytes,
+				remoteUrl: rc.sandbox.remoteUrl,
 				...rc.renderResult ? {} : { renderResult: "off" }
 			} : {},
 			...entryCapabilities(pickLlmEntry(rc, this.#selectedModelId)).tools ? {} : { toolCallingDisabled: true },
@@ -45792,7 +45861,11 @@ var ChatEngine = class {
 			skillProviders: pageSkillSource ? [pageSkillSource] : [],
 			...this.#governanceDeps(),
 			...Object.keys(loopConfig).length > 0 ? { config: loopConfig } : {},
-			...model ? { model } : {}
+			...model ? { model } : {},
+			...this.#options.fetchData ? { fetchData: this.#options.fetchData } : {},
+			...this.#adapter.linkedDocuments ? { linkedDocuments: this.#adapter.linkedDocuments } : {},
+			...this.#adapter.docxExtractor ? { docxExtractor: this.#adapter.docxExtractor } : {},
+			...this.#adapter.documentAudit ? { documentAudit: this.#adapter.documentAudit } : {}
 		};
 		const runtime = new WebSkillRuntime({
 			...deps,
@@ -45827,7 +45900,7 @@ var ChatEngine = class {
 			const toolData = event.phase === "execute" && event.data.kind === "tool" ? event.data : void 0;
 			if (!toolData) {
 				const at = Date.parse(event.ts);
-				this.#runPhases.set(event.runId, appendRunPhase(this.#runPhases.get(event.runId) ?? [], event.phase, at, phaseNote(event)));
+				this.#runPhases.set(event.runId, appendRunPhase(this.#runPhases.get(event.runId) ?? [], event.phase, at, phaseNote(event), phaseDetail(event)));
 				this.#emit({
 					type: "lifecycle",
 					runId: event.runId,
@@ -45939,7 +46012,7 @@ var ChatEngine = class {
 			status,
 			output: result.output,
 			activeSkillNames: run.activeSkillNames,
-			...status === "completed" ? {} : { code: runFailureCode(run.terminationReason) }
+			...status === "completed" ? {} : { code: runFailureCode(run) }
 		});
 		this.#emit({
 			type: "message-complete",
@@ -46545,7 +46618,10 @@ function terminationParts(phases) {
 	return [{
 		type: "data",
 		name: TERMINATION_PART,
-		data: { ...last.note !== void 0 ? { reason: last.note } : {} }
+		data: {
+			...last.note !== void 0 ? { reason: last.note } : {},
+			...last.detail !== void 0 ? { detail: last.detail } : {}
+		}
 	}];
 }
 /**
@@ -47138,7 +47214,7 @@ function InteractionWaitBar({ bridge, label, elsewhere = false, panel, onLocate
 		id: INTERACTION_WAIT_ID,
 		"data-testid": "interaction-wait",
 		role: "status",
-		className: "mx-auto flex w-full max-w-3xl items-center gap-2 px-4 pt-2 text-xs text-muted",
+		className: "webskill-chat-prose mx-auto flex w-full items-center gap-2 px-4 pt-2 text-xs text-muted",
 		children: [
 			/* @__PURE__ */ jsx(Hourglass, {
 				className: "size-3.5 shrink-0",
@@ -47290,6 +47366,7 @@ function ModelMenuButton({ models }) {
 			"data-model-option": option.id,
 			checked: option.id === models.value,
 			disabled: option.disabled === true,
+			...option.unconfigured === true ? { title: t("composer.model.unconfigured") } : {},
 			onCheckedChange: () => models.onChange(option.id),
 			children: /* @__PURE__ */ jsx("span", {
 				className: "truncate",
@@ -47314,7 +47391,7 @@ function AssistantUiComposer({ running, disabled = false, waitTarget, placeholde
 		className: "webskill-aui-composer shrink-0 px-4 py-4",
 		children: /* @__PURE__ */ jsxs(ComposerPrimitive.AttachmentDropzone, {
 			disabled: !attachments,
-			className: "webskill-aui-composer-shell mx-auto flex w-full max-w-3xl flex-col gap-2 px-3 py-2 transition-colors data-[dragging=true]:border-ring",
+			className: "webskill-aui-composer-shell webskill-chat-prose mx-auto flex w-full flex-col gap-2 px-3 py-2 transition-colors data-[dragging=true]:border-ring",
 			children: [
 				/* @__PURE__ */ jsx("div", {
 					"aria-label": t("composer.attachments"),
@@ -47886,18 +47963,29 @@ const TERMINATION_KEY = {
 /**
 * 非正常终态提示（FR-20.5）。停在消息顶层，不进思维链分组——
 * 那个容器在 run 结束后自动折叠且折叠时从 DOM 卸载，提示放进去等于没提示（裁决 D-9）。
+*
+* `reason` 只有七种取值，说不出「哪个上限、哪个模型、本轮带了文档」——
+* 那句话在 `RuntimeRun.error.message` 里，此前被整个丢掉（UI-UX8 D15）。
 */
 function TerminationNotice({ data }) {
 	const t = useT();
 	const reason = readString(data, "reason");
+	const detail = readString(data, "detail");
 	const key = reason !== void 0 && reason in TERMINATION_KEY ? TERMINATION_KEY[reason] : "run.terminated.unknown";
-	return /* @__PURE__ */ jsxs("p", {
+	return /* @__PURE__ */ jsxs("div", {
 		"data-webskill-termination": reason ?? "unknown",
-		className: "flex items-center gap-2 text-xs text-danger",
+		className: "flex items-start gap-2 text-xs text-danger",
 		children: [/* @__PURE__ */ jsx(OctagonX, {
 			className: "size-3.5 shrink-0",
 			"aria-hidden": true
-		}), /* @__PURE__ */ jsx("span", { children: t(key) })]
+		}), /* @__PURE__ */ jsxs("div", {
+			className: "flex min-w-0 flex-col gap-1",
+			children: [/* @__PURE__ */ jsx("span", { children: t(key) }), detail !== void 0 && detail !== "" ? /* @__PURE__ */ jsx("span", {
+				"data-testid": "termination-detail",
+				className: "break-words text-muted",
+				children: detail
+			}) : null]
+		})]
 	});
 }
 function ToolGroup({ count, running, children }) {
@@ -47992,14 +48080,22 @@ function ToolRow({ part }) {
 			]
 		}), open && (part.argsText !== "" || errorMessage !== void 0) ? /* @__PURE__ */ jsxs("div", {
 			className: "border-t border-border px-2 py-1.5",
-			children: [errorMessage !== void 0 ? /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("p", {
-				className: "text-xs text-muted italic",
-				children: t(errorCode !== void 0 ? ERROR_TITLE_KEYS[errorCode] ?? "tool.failed.reason" : "tool.failed.reason")
-			}), /* @__PURE__ */ jsx("p", {
-				"data-testid": "tool-error-reason",
-				className: "text-xs break-words text-ink",
-				children: errorMessage
-			})] }) : null, part.argsText !== "" ? /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("p", {
+			children: [errorMessage !== void 0 ? /* @__PURE__ */ jsxs(Fragment$1, { children: [
+				/* @__PURE__ */ jsx("p", {
+					className: "text-xs text-muted italic",
+					children: t(errorCode !== void 0 ? ERROR_TITLE_KEYS[errorCode] ?? "tool.failed.reason" : "tool.failed.reason")
+				}),
+				/* @__PURE__ */ jsx("p", {
+					"data-testid": "tool-error-reason",
+					className: "text-xs break-words text-ink",
+					children: errorMessage
+				}),
+				errorCode !== void 0 ? /* @__PURE__ */ jsx("p", {
+					"data-testid": "tool-error-code",
+					className: "mt-1 font-mono text-xs text-muted",
+					children: errorCode
+				}) : null
+			] }) : null, part.argsText !== "" ? /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("p", {
 				className: "text-xs text-muted italic",
 				children: t("tool.args")
 			}), /* @__PURE__ */ jsx("pre", {
@@ -48063,14 +48159,22 @@ function WorkingIndicator() {
 		})
 	});
 }
-/** data part → 只读交互卡；请求体是落盘原样，畸形数据直接不渲染而不是抛 */
+/**
+* data part → 只读交互卡；请求体是落盘原样，畸形数据直接不渲染而不是抛。
+*
+* surfaceId 必须掺入 useId：交互 id 是 run 内序号，不同 run 的第一个交互都叫 `int-1`。
+* 两张 submitted 卡同屏时若直接用 `interaction-${id}`，surfaceForm 的控件 id 与
+* `<label htmlFor>` 关联会串到另一张卡（UI-UX8 UX-03：把上一张卡的问题念成这张卡的）。
+* @internal
+*/
 function PersistedInteraction({ data }) {
+	const domId = useId();
 	const request = data["request"];
 	const id = readString(data, "id");
 	if (typeof request !== "object" || request === null || id === void 0) return null;
 	const values = data["submittedValues"];
 	return /* @__PURE__ */ jsx(SubmittedInteraction, {
-		surfaceId: `interaction-${id}`,
+		surfaceId: `interaction-${id}-${domId}`,
 		request,
 		...values === void 0 ? {} : { submittedValues: values }
 	});
@@ -58627,10 +58731,13 @@ function WebSkillMessageExtensions({ message, onDownload, surfaceRegistry, rende
 				runId: message.runId ?? "",
 				...onDownload ? { onDownload } : {}
 			}) : null,
-			renderable.length > 0 ? /* @__PURE__ */ jsx(HistoricalSurfaces, {
-				snapshots: renderable,
-				...renderer ? { renderer } : {},
-				...surfaceRegistry ? { registry: surfaceRegistry } : {}
+			renderable.length > 0 ? /* @__PURE__ */ jsx("div", {
+				className: "webskill-chat-surface-wide",
+				children: /* @__PURE__ */ jsx(HistoricalSurfaces, {
+					snapshots: renderable,
+					...renderer ? { renderer } : {},
+					...surfaceRegistry ? { registry: surfaceRegistry } : {}
+				})
 			}) : null,
 			renderable.length < surfaces.length ? /* @__PURE__ */ jsx("p", {
 				"data-testid": "legacy-surface-placeholder",
@@ -58833,6 +58940,14 @@ const IMAGE_MIME_SET = new Set(IMAGE_MIME_TYPES);
 /** 非文本非图片但仍可整体外发的类型（provider 的 file 分片） */
 const FILE_MIME_TYPES = ["application/pdf"];
 const FILE_MIME_SET = new Set(FILE_MIME_TYPES);
+/**
+* 需要**客户端先抽取成文本**才能外发的类型（FR-23.9）。
+* 不走直通的 `file`：docx 发给 provider 会被当成二进制垃圾。
+*/
+const EXTRACTED_MIME_TYPES = ["application/vnd.openxmlformats-officedocument.wordprocessingml.document"];
+const EXTRACTED_MIME_SET = new Set(EXTRACTED_MIME_TYPES);
+const EXTRACTED_EXTENSIONS = ["docx"];
+const EXTRACTED_EXTENSION_SET = new Set(EXTRACTED_EXTENSIONS);
 function extensionOf(fileName) {
 	return fileName.split(".").pop()?.toLowerCase() ?? "";
 }
@@ -58840,9 +58955,11 @@ function extensionOf(fileName) {
 function classifyAttachment(contentType, fileName) {
 	const type = contentType.toLowerCase();
 	if (IMAGE_MIME_SET.has(type)) return "image";
+	if (EXTRACTED_MIME_SET.has(type)) return "document-text";
 	if (FILE_MIME_SET.has(type)) return "file";
 	if (type.startsWith("text/") || type === "application/json") return "text";
 	if (type === "" && TEXT_EXTENSION_SET.has(extensionOf(fileName))) return "text";
+	if (type === "" && EXTRACTED_EXTENSION_SET.has(extensionOf(fileName))) return "document-text";
 }
 const TEXT_ACCEPT = [
 	"text/plain",
@@ -58859,6 +58976,7 @@ function attachmentAccept(options) {
 	const parts = [...TEXT_ACCEPT, ...TEXT_EXTENSIONS.map((ext) => `.${ext}`)];
 	if (options.images) parts.push(...IMAGE_MIME_TYPES);
 	if (options.files) parts.push(...FILE_MIME_TYPES);
+	if (options.documents) parts.push(...EXTRACTED_MIME_TYPES, ...EXTRACTED_EXTENSIONS.map((ext) => `.${ext}`));
 	return parts.join(",");
 }
 
@@ -58891,7 +59009,11 @@ var WebSkillAttachmentAdapter = class {
 	}
 	/** assistant-ui 每次打开文件选择器都读一次，因此开关与模型能力的变化无需重建适配器 */
 	get accept() {
-		return attachmentAccept({ images: this.#imagesAllowed() });
+		return attachmentAccept({
+			images: this.#imagesAllowed(),
+			files: true,
+			documents: this.#options.docxExtractor !== void 0
+		});
 	}
 	#multimodal() {
 		return this.#options.multimodal?.() ?? DEFAULT_MULTIMODAL;
@@ -58905,7 +59027,8 @@ var WebSkillAttachmentAdapter = class {
 		if (kind === "image") {
 			if (!this.#multimodal().imageAttachments) throw new WebSkillError("ATTACHMENT_TYPE_REJECTED", "Image attachments are turned off. Enable them in settings before sending images.");
 			if (!(this.#options.imageCapable?.() ?? false)) throw new WebSkillError("MODEL_IMAGE_UNSUPPORTED", "Current model does not support image input. Switch model or remove the image.");
-		} else if (file.size > MAX_BYTES) throw new WebSkillError("ATTACHMENT_TOO_LARGE", `Attachment "${file.name}" is ${Math.round(file.size / 1024 / 1024)} MB, which exceeds the 10 MB limit`);
+		} else if (kind === "document-text" && this.#options.docxExtractor === void 0) throw new WebSkillError("ATTACHMENT_TYPE_REJECTED", "Word documents are not supported in this environment: no docx extractor is wired up.");
+		else if (file.size > MAX_BYTES) throw new WebSkillError("ATTACHMENT_TOO_LARGE", `Attachment "${file.name}" is ${Math.round(file.size / 1024 / 1024)} MB, which exceeds the 10 MB limit`);
 		const id = `att-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
 		const relative = `${this.#options.sessionId() ?? "pending"}/${id}-${safeName(file.name)}`;
 		const path = `${this.#options.root}/${relative}`;
@@ -58946,6 +59069,15 @@ var WebSkillAttachmentAdapter = class {
 				size: file.size
 			};
 		}
+		if (kind === "document-text") {
+			const extract = this.#options.docxExtractor;
+			if (extract === void 0) throw new WebSkillError("ATTACHMENT_TYPE_REJECTED", "No docx extractor is wired up in this environment.");
+			await this.#options.storage.writeText(path, await extract(new Uint8Array(await file.arrayBuffer())));
+			return {
+				...base,
+				size: file.size
+			};
+		}
 		if (kind === "file") {
 			await this.#options.storage.writeBinary(path, new Uint8Array(await file.arrayBuffer()));
 			return {
@@ -59023,7 +59155,7 @@ const start = (runId, at) => ({
 	chunks: 0
 });
 function appendPhase(live, event) {
-	const next = appendRunPhase(live.phases, event.phase, event.at, phaseNote(event));
+	const next = appendRunPhase(live.phases, event.phase, event.at, phaseNote(event), phaseDetail(event));
 	return next === live.phases ? live : {
 		...live,
 		phases: [...next]
@@ -59349,6 +59481,13 @@ function ActiveInteractionCard({ request, bridge }) {
 	const pageAction = isAuthorize && request.capability === "pageAction" ? pageActionDetails(request.details) : void 0;
 	const handleAction = (event) => {
 		if (event.intent !== "submit") {
+			if (request.type === "confirm" || request.type === "authorize") {
+				bridge.resolve({
+					id: request.id,
+					value: false
+				});
+				return;
+			}
 			bridge.resolve({
 				id: request.id,
 				cancelled: true
@@ -59820,6 +59959,7 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 		...config?.hooks ? { hooks: config.hooks } : {},
 		...config?.governance ? { governance: config.governance } : {},
 		...config?.skillCandidates ? { skillCandidates: config.skillCandidates } : {},
+		...config?.fetchData ? { fetchData: config.fetchData } : {},
 		...rendererProp ? { renderer: rendererProp } : {}
 	}), [
 		adapter,
@@ -59831,6 +59971,7 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 		config?.hooks,
 		config?.governance,
 		config?.skillCandidates,
+		config?.fetchData,
 		rendererProp
 	]);
 	useEffect(() => {
@@ -59928,7 +60069,8 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 		root: engine.attachmentsRoot,
 		sessionId: () => sessionRef.current,
 		multimodal: () => multimodalRef.current,
-		imageCapable: () => imageCapableRef.current
+		imageCapable: () => imageCapableRef.current,
+		...adapter.docxExtractor ? { docxExtractor: adapter.docxExtractor } : {}
 	}), [adapter, engine]);
 	useEffect(() => {
 		let cancelled = false;
@@ -60000,13 +60142,19 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 	const composerModels = useMemo(() => {
 		if (llmSelection.entries.length === 0) return void 0;
 		const selected = modelId ?? llmSelection.defaultId ?? llmSelection.entries[0]?.id ?? "";
+		const effective = pickUsableLlmEntry(llmSelection.entries, llmSelection.defaultId, modelId)?.id ?? selected;
 		return {
-			options: llmSelection.entries.map((entry) => ({
-				id: entry.id,
-				label: entry.label,
-				...entry.provider === "chrome-builtin" && chromeBuiltin?.available === false ? { disabled: true } : {}
-			})),
-			value: selected,
+			options: llmSelection.entries.map((entry) => {
+				const builtinUnavailable = entry.provider === "chrome-builtin" && chromeBuiltin?.available === false;
+				const unusable = !isLlmEntryUsable(entry);
+				return {
+					id: entry.id,
+					label: entry.label,
+					...builtinUnavailable || unusable ? { disabled: true } : {},
+					...unusable && !builtinUnavailable ? { unconfigured: true } : {}
+				};
+			}),
+			value: effective,
 			onChange: (id) => {
 				setModelId(id);
 				engine.setModel(id);
@@ -60356,7 +60504,7 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 						})
 					})
 				})] }), /* @__PURE__ */ jsxs("div", {
-					className: "flex min-h-0 min-w-0 flex-1 flex-col",
+					className: "webskill-chat-column flex min-h-0 min-w-0 flex-1 flex-col",
 					children: [
 						/* @__PURE__ */ jsx(AssistantUiThreadToolbar, {
 							...config?.title ? { title: config.title } : {},
@@ -60374,7 +60522,7 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 								/* @__PURE__ */ jsx(AssistantUiViewport, {
 									grow: !composerCentered,
 									children: /* @__PURE__ */ jsxs("div", {
-										className: "mx-auto flex w-full min-w-0 max-w-3xl flex-col gap-4 px-4 py-6",
+										className: "webskill-chat-prose mx-auto flex w-full min-w-0 flex-col gap-4 px-4 py-6",
 										children: [
 											messages.length === 0 && !sending ? /* @__PURE__ */ jsx(AssistantUiEmptyState, {
 												...config?.title ? { title: config.title } : {},
@@ -60424,24 +60572,29 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 												activeRunId: currentRunId,
 												onDownload: handleDownload
 											}),
-											renderer === "native" && liveSurfaceRunId ? /* @__PURE__ */ jsx(UiSurfaceList, {
-												bridge: engine.bridge,
-												runId: liveSurfaceRunId,
-												...surfaceRegistry ? { registry: surfaceRegistry } : {}
-											}) : null,
-											renderer === "vercel" && liveSurfaceRunId ? /* @__PURE__ */ jsx(VercelSurfaceHost, {
-												bridge: engine.bridge,
-												runId: liveSurfaceRunId
-											}) : null,
-											renderer === "openui" && liveSurfaceRunId ? /* @__PURE__ */ jsx(OpenUiSurfaceHost, {
-												bridge: engine.bridge,
-												runId: liveSurfaceRunId
-											}) : null,
-											renderer === "a2ui" && liveSurfaceRunId ? /* @__PURE__ */ jsx(A2uiSurfaceHost, {
-												bridge: engine.bridge,
-												runId: liveSurfaceRunId,
-												...surfaceRegistry ? { registry: surfaceRegistry } : {}
-											}) : null,
+											/* @__PURE__ */ jsxs("div", {
+												className: "webskill-chat-surface-wide",
+												children: [
+													renderer === "native" && liveSurfaceRunId ? /* @__PURE__ */ jsx(UiSurfaceList, {
+														bridge: engine.bridge,
+														runId: liveSurfaceRunId,
+														...surfaceRegistry ? { registry: surfaceRegistry } : {}
+													}) : null,
+													renderer === "vercel" && liveSurfaceRunId ? /* @__PURE__ */ jsx(VercelSurfaceHost, {
+														bridge: engine.bridge,
+														runId: liveSurfaceRunId
+													}) : null,
+													renderer === "openui" && liveSurfaceRunId ? /* @__PURE__ */ jsx(OpenUiSurfaceHost, {
+														bridge: engine.bridge,
+														runId: liveSurfaceRunId
+													}) : null,
+													renderer === "a2ui" && liveSurfaceRunId ? /* @__PURE__ */ jsx(A2uiSurfaceHost, {
+														bridge: engine.bridge,
+														runId: liveSurfaceRunId,
+														...surfaceRegistry ? { registry: surfaceRegistry } : {}
+													}) : null
+												]
+											}),
 											error ? /* @__PURE__ */ jsx(ErrorCard, {
 												message: error.message,
 												...error.code ? { code: error.code } : {},
@@ -60558,7 +60711,7 @@ function VercelPayloadPreview({ bridge }) {
 * Version of the published `@webskill/chatbot` package, injected at build time.
 * @stable
 */
-const CHATBOT_VERSION = "0.7.0";
+const CHATBOT_VERSION = "0.8.0";
 
 //#endregion
-export { A2uiSurfaceHost, A2uiSurfaceSnapshotHost, CHATBOT_VERSION, ChatEngine, Chatbot, CompositeUiBridge, DEFAULT_RENDERER_CAPABILITIES, DEFAULT_RUNTIME_CONFIG_STORAGE_KEY, ErrorCard, InteractionCard, InterruptedBanner, OpenUiSurfaceHost, OpenUiSurfaceSnapshotHost, ResultBlockList, ResultBlocksPro, SkillBadges, SpecInteraction, VercelPayloadPreview, VercelSurfaceHost, VercelSurfaceSnapshotHost, chatbotDictionary, configureA2uiMarkdown, createLocalStorageRuntimeConfigStore, createMemoryRuntimeConfigStore, pickUsableLlmEntry, probeA2uiAvailability, probeOpenUiAvailability, sandboxExecutorDeps, useT };
+export { A2uiSurfaceHost, A2uiSurfaceSnapshotHost, CHATBOT_VERSION, ChatEngine, Chatbot, CompositeUiBridge, DEFAULT_RENDERER_CAPABILITIES, DEFAULT_RUNTIME_CONFIG_STORAGE_KEY, ErrorCard, InteractionCard, InterruptedBanner, OpenUiSurfaceHost, OpenUiSurfaceSnapshotHost, ResultBlockList, ResultBlocksPro, SkillBadges, SpecInteraction, VercelPayloadPreview, VercelSurfaceHost, VercelSurfaceSnapshotHost, chatbotDictionary, configureA2uiMarkdown, createLocalStorageRuntimeConfigStore, createMemoryRuntimeConfigStore, isLlmEntryUsable, pickUsableLlmEntry, probeA2uiAvailability, probeOpenUiAvailability, sandboxExecutorDeps, useT };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webskill/chatbot",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "license": "MIT",
   "type": "module",
   "exports": {
@@ -26,7 +26,7 @@
     "@a2ui/web_core": "^0.10.5",
     "@lit/context": "^1.1.0",
     "@openuidev/react-lang": "0.2.8",
-    "@webskill/sdk": "^0.10.0",
+    "@webskill/sdk": "^0.11.0",
     "react": ">=19.0.0",
     "react-dom": ">=19.0.0",
     "zod": "^3.25.0 || ^4.0.0"