@webskill/chatbot 0.8.0 → 0.9.0

package/dist/chatbot.css

@@ -21,7 +21,6 @@
     --text-lg--line-height: calc(1.75 / 1.125);
     --text-2xl: 1.5rem;
     --text-2xl--line-height: calc(2 / 1.5);
-    --font-weight-normal: 400;
     --font-weight-medium: 500;
     --font-weight-semibold: 600;
     --tracking-normal: 0em;
@@ -587,9 +586,6 @@
   .w-48 {
     width: calc(var(--spacing) * 48);
   }
-  .w-72 {
-    width: calc(var(--spacing) * 72);
-  }
   .w-80 {
     width: calc(var(--spacing) * 80);
   }
@@ -617,9 +613,6 @@
   .max-w-2xl {
     max-width: var(--container-2xl);
   }
-  .max-w-48 {
-    max-width: calc(var(--spacing) * 48);
-  }
   .max-w-72 {
     max-width: calc(var(--spacing) * 72);
   }
@@ -910,10 +903,6 @@
     border-right-style: var(--tw-border-style);
     border-right-width: 1px;
   }
-  .border-r-0 {
-    border-right-style: var(--tw-border-style);
-    border-right-width: 0px;
-  }
   .border-b {
     border-bottom-style: var(--tw-border-style);
     border-bottom-width: 1px;
@@ -1256,10 +1245,6 @@
     --tw-font-weight: var(--font-weight-medium);
     font-weight: var(--font-weight-medium);
   }
-  .font-normal {
-    --tw-font-weight: var(--font-weight-normal);
-    font-weight: var(--font-weight-normal);
-  }
   .font-semibold {
     --tw-font-weight: var(--font-weight-semibold);
     font-weight: var(--font-weight-semibold);
@@ -1296,9 +1281,6 @@
   .text-destructive-foreground {
     color: var(--destructive-foreground);
   }
-  .text-foreground {
-    color: var(--foreground);
-  }
   .text-info {
     color: var(--info);
   }
@@ -1646,9 +1628,6 @@
     .hover\:bg-surface:hover {
       background-color: var(--card);
     }
-    .hover\:text-foreground:hover {
-      color: var(--foreground);
-    }
     .hover\:text-ink:hover {
       color: var(--foreground);
     }
@@ -1896,9 +1875,6 @@
     .sm\:justify-end {
       justify-content: flex-end;
     }
-    .sm\:gap-2\.5 {
-      gap: calc(var(--spacing) * 2.5);
-    }
     .sm\:gap-4 {
       gap: calc(var(--spacing) * 4);
     }
@@ -1907,9 +1883,6 @@
     }
   }
   @media (width >= 48rem) {
-    .md\:block {
-      display: block;
-    }
     .md\:opacity-0 {
       opacity: 0%;
     }
@@ -1925,9 +1898,6 @@
     .lg\:flex {
       display: flex;
     }
-    .lg\:hidden {
-      display: none;
-    }
     .lg\:grid-cols-\[minmax\(0\,1fr\)_0\.625rem_minmax\(18rem\,var\(--webskill-secondary-size\)\)\] {
       grid-template-columns: minmax(0,1fr) 0.625rem minmax(18rem,var(--webskill-secondary-size));
     }
@@ -2412,6 +2382,20 @@
     }
   }
 }
+[data-slot='sidebar'][data-narrow='true'][data-state='collapsed'] [data-slot='sidebar-container'] {
+  width: 0;
+  border-inline-width: 0;
+}
+[data-slot='sidebar'][data-state='collapsed'][data-collapsible='offcanvas'] [data-slot='sidebar-inner'], [data-slot='sidebar'][data-state='collapsed'][data-narrow='true'] [data-slot='sidebar-inner'] {
+  visibility: hidden;
+}
+[data-slot='sidebar'][data-variant='floating'][data-state='collapsed'] [data-slot='sidebar-container'] {
+  padding: 0;
+}
+[data-slot='sidebar'][data-narrow='false'] {
+  height: auto;
+  align-self: stretch;
+}
 .webskill-surface-list {
   display: flex;
   flex-direction: column;
@@ -2480,21 +2464,6 @@
 .webskill-surface--table {
   overflow: hidden;
 }
-.webskill-surface__table-tools {
-  display: flex;
-  flex-wrap: wrap;
-  gap: 0.5rem;
-  padding: 0.75rem;
-}
-.webskill-surface__table-tools input[type='search'] {
-  min-width: min(100%, 14rem);
-  flex: 1;
-  border: 1px solid var(--color-input);
-  border-radius: 0.5rem;
-  background: var(--color-background);
-  padding: 0.5rem 0.75rem;
-  color: var(--color-foreground);
-}
 .webskill-surface__table-scroll {
   max-height: 22.5rem;
   overflow: auto;
@@ -2644,6 +2613,33 @@
   --webskill-chat-prose-max: 100%;
   --webskill-chat-surface-max: 100%;
 }
+.webskill-aui-session-list {
+  width: 18rem;
+  padding: 0.5rem;
+  align-self: stretch;
+  transition: width 200ms linear;
+}
+.webskill-aui-session-panel {
+  width: 17rem;
+  flex: 1 1 auto;
+  min-height: 0;
+}
+.webskill-aui-shell[data-session-list='collapsed'] .webskill-aui-session-list {
+  width: 0;
+  padding: 0;
+  visibility: hidden;
+  transition: width 200ms linear, padding 200ms linear, visibility 0s linear 200ms;
+}
+.webskill-aui-shell[data-session-list='inline'] .webskill-aui-sessions-button {
+  display: none;
+}
+.webskill-aui-shell[data-session-narrow='true'] .webskill-aui-session-list {
+  position: absolute;
+  inset-block: 0;
+  inset-inline-start: 0;
+  z-index: var(--webskill-z-raised);
+  max-width: 100%;
+}
 .webskill-chat-prose {
   max-width: var(--webskill-chat-prose-max);
 }

package/dist/index.d.ts

@@ -448,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;
@@ -522,6 +539,11 @@ interface ChatMessage {
    * @experimental
    */
   candidates?: SkillCandidateMarker[];
+  /**
+   * 文字与 surface / blocks 的生成顺序（分册 17）。缺省时按 0.11.0 的两段式渲染。
+   * @experimental
+   */
+  contentParts?: ChatContentPart[];
 }
 /** @stable */
 interface ChatSessionMeta {
@@ -564,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;
@@ -640,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' */
@@ -657,8 +711,8 @@ 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 约 34 KB，会计入每一次请求。
@@ -1023,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;
 }
 /**
@@ -1068,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;
@@ -1198,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;
@@ -1212,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;
@@ -1392,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;
@@ -1407,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;
@@ -1537,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;
@@ -1551,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;
@@ -1731,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;
@@ -1749,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;
@@ -1879,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;
@@ -1893,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;
@@ -2073,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;
@@ -2088,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;
@@ -2218,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;
@@ -2232,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;
@@ -2412,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;
@@ -2477,6 +2605,8 @@ interface ChatbotProps {
   surfaceRegistry?: SurfaceRegistry;
   /** 布局档（默认 'auto'：按容器尺寸在 fullscreen / embedded / mobile 之间判定） */
   layout?: ChatLayout;
+  /** 会话列表形态（默认 'auto'：按**容器**宽度判定，不看视口） @stable */
+  sessionList?: 'auto' | 'collapsed' | 'inline';
   /**
    * 打开配置面（FR-20.4）。配置面本身已迁到 console，chatbot 只负责发出这个请求；
    * 宿主不接就不渲染任何「打开设置」出口——给一个点了没反应的按钮更糟。
@@ -2494,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 */
@@ -2680,4 +2810,4 @@ declare function ErrorCard({ code, message, loopLimits, onOpenSettings, onDismis
  */
 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, 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, 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 };