@webskill/chatbot 0.9.0 → 0.10.0

package/dist/chatbot.css

@@ -1170,6 +1170,9 @@
   .pb-1 {
     padding-bottom: var(--spacing);
   }
+  .pb-2 {
+    padding-bottom: calc(var(--spacing) * 2);
+  }
   .pb-3 {
     padding-bottom: calc(var(--spacing) * 3);
   }
@@ -1718,11 +1721,6 @@
   .disabled\:opacity-60:disabled {
     opacity: 60%;
   }
-  @media (hover: hover) {
-    .disabled\:hover\:bg-transparent:disabled:hover {
-      background-color: transparent;
-    }
-  }
   .has-disabled\:cursor-not-allowed:has(:disabled) {
     cursor: not-allowed;
   }
@@ -2497,9 +2495,17 @@
   text-align: left;
   vertical-align: middle;
 }
+.webskill-surface__table-header th {
+  border-inline-end: 0;
+  border-bottom: 0;
+  box-shadow: inset -1px -1px 0 0 var(--color-border);
+}
 .webskill-surface__table-header th:last-child, .webskill-surface__table-body td:last-child {
   border-inline-end: 0;
 }
+.webskill-surface__table-header th:last-child {
+  box-shadow: inset 0 -1px 0 0 var(--color-border);
+}
 .webskill-surface__table-header button {
   width: 100%;
   border-radius: 0;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-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 { AgentLoopConfig, ApprovalScope, BridgeCapabilities, DocxTextExtractor, ExternalSkillProvider, ExternalToolSource, FileSystemProvider, HookRunner, InteractionRequest, InteractionResponse, LifecycleEventInit, LinkedDocumentReader, LlmClient, NetworkPolicy, Page, PageQuery, PdfTextExtractor, RenderBlock, RenderResultRequest, RunSnapshot, RunSnapshotListEntry, RuntimePhase, RuntimeRun, ScriptExecutor, SessionStore, SkillCandidateMarker, SkillCatalogEntry, SkillIntegrityGuard, SkillOutcomeReporter, SkillStateGuard, UiBridge, UiSpecDrafts, UiSpecEvent, UiSpecSnapshot, UiSurfaceActionRequest, UiSurfaceActionResponse, UserProfile, UserProfileExport, WebSkillErrorCode, XlsxTextExtractor, 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";
@@ -7,6 +7,13 @@ import "react/jsx-runtime";
 //#region ../ui-kit/src/i18n/types.d.ts
 /** @stable */
 type Locale = 'zh' | 'en';
+/**
+ * 宿主 / 用户提供的、随界面语言切换的短文案（0.13.0 分册 21 FR-21.1）。
+ * SDK 自己的界面文案走 `createI18n` 字典，不用这个类型。
+ * 允许只填部分语种，缺的语种由 `resolveLocalizedText` 借用已填的。
+ * @experimental
+ */
+type LocalizedText = Partial<Record<Locale, string>>;
 /** 单语言词条：key → 文案（支持 {name} 占位插值） */
 type LocaleMessages = Record<string, string>;
 /** 双语字典：zh/en 两个 locale 的键集必须一致（见 assertDictionaryComplete） */
@@ -40,6 +47,43 @@ type NetworkPolicy$1 = 'deny-all' | 'allow-all' | {
   allow: string[];
 };
 //#endregion
+//#region ../ui-kit/src/runtime-config/quickPrompts.d.ts
+/**
+ * 快捷指令可选图标名（0.12.0 分册 21）。
+ * 用受控枚举而不是让宿主传组件：SDK 的图标集不进公开契约，
+ * 换实现（lucide → 别的）时宿主代码不用动。
+ *
+ * 0.13.0 分册 17 FR-17.1：真值源从 `@webskill/chatbot` 迁到这里，
+ * 让 console 的配置界面也能用同一份枚举；`@webskill/chatbot` 原样 re-export，
+ * 公开面逐字不变。
+ * @experimental
+ */
+type QuickPromptIconName = 'chart' | 'document' | 'report' | 'search' | 'list' | 'bug' | 'test' | 'metric' | 'compare' | 'page' | 'run' | 'warn' | 'sparkles' | 'settings';
+/**
+ * 带图标的快捷指令（0.12.0 分册 21）。
+ * @experimental
+ */
+interface QuickPrompt {
+  /**
+   * 点击后发出的文本，同时作为按钮可见文案。
+   * 0.13.0 分册 21 FR-21.1：改为按语种取值，可只填部分语种。
+   */
+  text: LocalizedText;
+  /** 缺省或取值不在枚举内时按无图标渲染 */
+  icon?: QuickPromptIconName;
+}
+/**
+ * `RuntimeConfig` 里持久化的快捷指令条目（0.13.0 分册 17）。
+ * 比 `QuickPrompt` 多一个稳定 `id`：列表增删改需要它做定位，
+ * 用 `text` 当 key 在「两条同文案」时会塌陷。`id` 不进任何发给模型的字符串。
+ * @experimental
+ */
+interface RuntimeQuickPrompt {
+  id: string;
+  text: LocalizedText;
+  icon?: QuickPromptIconName;
+}
+//#endregion
 //#region ../ui-kit/src/runtime-config/types.d.ts
 /**
  * 运行环境配置模型（P2）：console Configure Tab 编辑、chatbot ChatEngine 装配应用，
@@ -225,6 +269,11 @@ interface RuntimeMultimodalConfig {
   maxImageBytes: number;
   /** 附件与取像共用 */
   maxImagesPerMessage: number;
+  /**
+   * 页面取像时小于该面积（平方像素）的元素视作工具图标，不占名额（0.13.0 FR-20.4）。
+   * `0` 是合法值，意为关闭过滤；只作用于页面取像，不管用户上传的附件。
+   */
+  minImageArea: number;
 }
 /**
  * 用户画像配置（0.6.0 FR-19.6）。`enabled` 默认**关**（AC-G5）：
@@ -270,6 +319,19 @@ interface RuntimeConfig {
   documentSurface: RuntimeDocumentSurfaceConfig;
   userProfile: RuntimeUserProfileConfig;
   skillState: RuntimeSkillStateConfig;
+  /**
+   * 快捷指令的**唯一权威**（0.13.0 分册 21 FR-21.5）。
+   * `ChatbotConfig.quickPrompts` 降级为一次性种子源，不再参与渲染判断。
+   */
+  quickPrompts: readonly RuntimeQuickPrompt[];
+  /**
+   * 宿主种子是否已注入过（FR-21.6）。
+   * 不得用 `quickPrompts.length === 0` 推断：「从未配置」与「用户删光了」都是空数组，
+   * 靠数组本身分不开——这正是 D-17-3 当年绕不过去的地方。
+   */
+  quickPromptsSeeded: boolean;
+  /** 空态与动态指令条最多展示多少条；超出的部分截断。取值 1..{@link MAX_QUICK_PROMPT_LIMIT} */
+  quickPromptLimit: number;
   /** 被用户删掉的自动模型条目 id（FR-14.3）：删一次就不该再自己长回来 */
   dismissedAutoEntries: readonly string[];
 }
@@ -677,23 +739,6 @@ 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' */
@@ -711,8 +756,23 @@ interface ChatbotConfig {
    * renderResult/sandbox/llm 映射；与 console Configure Tab 共用同一 store（宿主接线）
    */
   runtimeConfig?: RuntimeConfigStore;
-  /** WelcomeScreen 快捷 prompt 覆盖（缺省用内置双语示例）；给字符串即无图标 */
+  /**
+   * WelcomeScreen 快捷 prompt 的**一次性种子**（0.13.0 分册 21 FR-21.5）；给字符串即无图标、不分语种。
+   *
+   * 接了 `runtimeConfig` 时，本字段只在该存储**从未种子化过**时被注入一次
+   * （之后 `RuntimeConfig.quickPrompts` 是唯一权威，console 的「快捷指令」页改的就是它）；
+   * 用户在 console 里删光清单后本字段**不会**自行回填，除非用户点「恢复宿主默认」。
+   * 未接 `runtimeConfig` 的宿主上，本字段仍是直接的静态清单。
+   */
   quickPrompts?: readonly (string | QuickPrompt)[];
+  /**
+   * 按当前上下文动态下发的快捷指令（FR-17.4）。宿主可以随用户所在页面随时换一批。
+   *
+   * 与静态清单**拼接**而不是覆盖（动态在前，同文案去重）——用户在 console 里配的
+   * 不该被宿主惄惄吞掉。不同于静态清单，它在**对话进行中**也会渲染（FR-17.6）。
+   * @experimental
+   */
+  dynamicQuickPrompts?: readonly (string | QuickPrompt)[];
   /**
    * 开启后模型多一个 `render_ui` 工具，可面向 AI Component Catalog 直接生成声明式 UI。
    * 默认关：工具描述 + 入参 schema 约 34 KB，会计入每一次请求。
@@ -787,6 +847,13 @@ interface ChatbotHostAdapter {
   linkedDocuments?: LinkedDocumentReader;
   /** docx → 文本（`extractDocxText`）；不注入即 Word 文档明确报「本环境不支持」 */
   docxExtractor?: DocxTextExtractor;
+  /** xlsx → 文本（`extractXlsxText`）；不注入即 Excel 工作簿明确报「本环境不支持」 */
+  xlsxExtractor?: XlsxTextExtractor;
+  /**
+   * PDF → 文本；**只用于直传被端点拒后的回退**（0.13.0 FR-22.1）。
+   * PDF 仍然默认直传，能读的端点拿到的还是原件；不注入即没有回退能力。
+   */
+  pdfExtractor?: PdfTextExtractor;
   /** 文档读取留痕出口（FR-22.6） */
   documentAudit?: {
     append(event: {
@@ -1123,6 +1190,9 @@ declare const chatbotDictionary: {
     'app.title': string;
     'header.sessions': string;
     'header.settings': string;
+    'header.dock': string;
+    'header.undock': string;
+    'header.close': string;
     'header.console': string;
     'header.theme.light': string;
     'header.theme.dark': string;
@@ -1168,10 +1238,7 @@ declare const chatbotDictionary: {
     'welcome.capability.transparency.title': string;
     'welcome.capability.transparency.description': string;
     'welcome.quickPrompts': string;
-    'welcome.prompt.1': string;
-    'welcome.prompt.2': string;
-    'welcome.prompt.3': string;
-    'welcome.prompt.4': string;
+    'welcome.dynamicPrompts': string;
     'message.copy': string;
     'message.copied': string;
     'message.retry': string;
@@ -1326,9 +1393,6 @@ declare const chatbotDictionary: {
     'composer.noModel.description': string;
     'composer.noModel.configure': string;
     'capability.group': string;
-    'composer.pageCapture': string;
-    'composer.pageCapture.disabled.setting': string;
-    'composer.pageCapture.disabled.model': string;
     'composer.addAttachment.imagesOff': string;
     'composer.addAttachment.modelNoImages': string;
     'attachment.imagesDropped': string;
@@ -1479,6 +1543,9 @@ declare const chatbotDictionary: {
     'app.title': string;
     'header.sessions': string;
     'header.settings': string;
+    'header.dock': string;
+    'header.undock': string;
+    'header.close': string;
     'header.console': string;
     'header.theme.light': string;
     'header.theme.dark': string;
@@ -1524,10 +1591,7 @@ declare const chatbotDictionary: {
     'welcome.capability.transparency.title': string;
     'welcome.capability.transparency.description': string;
     'welcome.quickPrompts': string;
-    'welcome.prompt.1': string;
-    'welcome.prompt.2': string;
-    'welcome.prompt.3': string;
-    'welcome.prompt.4': string;
+    'welcome.dynamicPrompts': string;
     'message.copy': string;
     'message.copied': string;
     'message.edit': string;
@@ -1682,9 +1746,6 @@ declare const chatbotDictionary: {
     'composer.noModel.description': string;
     'composer.noModel.configure': string;
     'capability.group': string;
-    'composer.pageCapture': string;
-    'composer.pageCapture.disabled.setting': string;
-    'composer.pageCapture.disabled.model': string;
     'composer.addAttachment.imagesOff': string;
     'composer.addAttachment.modelNoImages': string;
     'attachment.imagesDropped': string;
@@ -1838,6 +1899,9 @@ declare const useT: () => TranslateFn<{
     'app.title': string;
     'header.sessions': string;
     'header.settings': string;
+    'header.dock': string;
+    'header.undock': string;
+    'header.close': string;
     'header.console': string;
     'header.theme.light': string;
     'header.theme.dark': string;
@@ -1883,10 +1947,7 @@ declare const useT: () => TranslateFn<{
     'welcome.capability.transparency.title': string;
     'welcome.capability.transparency.description': string;
     'welcome.quickPrompts': string;
-    'welcome.prompt.1': string;
-    'welcome.prompt.2': string;
-    'welcome.prompt.3': string;
-    'welcome.prompt.4': string;
+    'welcome.dynamicPrompts': string;
     'message.copy': string;
     'message.copied': string;
     'message.retry': string;
@@ -2041,9 +2102,6 @@ declare const useT: () => TranslateFn<{
     'composer.noModel.description': string;
     'composer.noModel.configure': string;
     'capability.group': string;
-    'composer.pageCapture': string;
-    'composer.pageCapture.disabled.setting': string;
-    'composer.pageCapture.disabled.model': string;
     'composer.addAttachment.imagesOff': string;
     'composer.addAttachment.modelNoImages': string;
     'attachment.imagesDropped': string;
@@ -2194,6 +2252,9 @@ declare const useT: () => TranslateFn<{
     'app.title': string;
     'header.sessions': string;
     'header.settings': string;
+    'header.dock': string;
+    'header.undock': string;
+    'header.close': string;
     'header.console': string;
     'header.theme.light': string;
     'header.theme.dark': string;
@@ -2239,10 +2300,7 @@ declare const useT: () => TranslateFn<{
     'welcome.capability.transparency.title': string;
     'welcome.capability.transparency.description': string;
     'welcome.quickPrompts': string;
-    'welcome.prompt.1': string;
-    'welcome.prompt.2': string;
-    'welcome.prompt.3': string;
-    'welcome.prompt.4': string;
+    'welcome.dynamicPrompts': string;
     'message.copy': string;
     'message.copied': string;
     'message.edit': string;
@@ -2397,9 +2455,6 @@ declare const useT: () => TranslateFn<{
     'composer.noModel.description': string;
     'composer.noModel.configure': string;
     'capability.group': string;
-    'composer.pageCapture': string;
-    'composer.pageCapture.disabled.setting': string;
-    'composer.pageCapture.disabled.model': string;
     'composer.addAttachment.imagesOff': string;
     'composer.addAttachment.modelNoImages': string;
     'attachment.imagesDropped': string;
@@ -2576,7 +2631,7 @@ interface AppearanceChange {
  * 不在其中（AC-20.7 按「无未覆盖的配置类 leaf」执行，见偏差 D-15）。
  * @experimental
  */
-type SettingsSectionId = 'settings.runtime' | 'settings.sandbox' | 'settings.genui' | 'settings.trust' | 'settings.privacy' | 'settings.appearance' | 'connections.models' | 'connections.webmcp' | 'connections.page' | 'connections.mcp';
+type SettingsSectionId = 'settings.runtime' | 'settings.sandbox' | 'settings.genui' | 'settings.prompts' | 'settings.trust' | 'settings.privacy' | 'settings.appearance' | 'connections.models' | 'connections.webmcp' | 'connections.page' | 'connections.mcp';
 //#endregion
 //#region src/react/useChatLayout.d.ts
 /** 宿主可指定的布局档；auto 按容器尺寸判定 @stable */
@@ -2613,6 +2668,21 @@ interface ChatbotProps {
    * `section` 可选（FR-16.5）：齿轮不带分区（→ Overview），带诉求的入口（错误卡等）才传分区。
    */
   onOpenSettings?(section?: SettingsSectionId): void;
+  /**
+   * 当前是否已「固定」到宿主页面（下沉占宽）。**受控**：SDK 只用它决定图标与
+   * `aria-pressed`，自身布局与样式一概不因它改变——悬浮/下沉的容器归宿主外壳（FR-16.2）。
+   */
+  docked?: boolean;
+  /**
+   * 用户请求切换固定态（FR-16.1）。宿主不接就不渲染这个按钮。
+   * 入参是用户**请求切换到**的目标态；宿主改完布局后把新的 `docked` 传回来。
+   */
+  onDock?(next: boolean): void;
+  /**
+   * 用户请求关闭对话框（FR-16.3）。宿主不接就不渲染这个按钮。
+   * SDK 只发出意图，不卸载自己、不清理任何状态。
+   */
+  onClose?(): void;
   /**
    * 装配完成后把引擎交给宿主，用于接线跨界面动作（例如 console 的快照恢复入口
    * 需要调 `engine.resume(runId)`）。每次重新装配都会再调一次。
@@ -2624,7 +2694,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, sessionList, onOpenSettings, onEngineReady }: ChatbotProps): import("react").JSX.Element;
+declare function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, renderer: rendererProp, dictationLang: dictationLangProp, surfaceRegistry, layout, sessionList, onOpenSettings, docked, onDock, onClose, onEngineReady }: ChatbotProps): import("react").JSX.Element;
 //#endregion
 //#region src/react/A2uiSurfaceHost.d.ts
 /** @experimental */
@@ -2808,6 +2878,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.8.0";
+declare const CHATBOT_VERSION = "0.10.0";
 //#endregion
-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 };
+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, type LocalizedText, 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 RuntimeQuickPrompt, 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 };