@webskill/chatbot 0.4.0 → 0.6.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { AgentLoopConfig, ApprovalScope, BridgeCapabilities, ExternalSkillProvider, ExternalToolSource, FileSystemProvider, HookRunner, InteractionRequest, InteractionResponse, LifecycleEventInit, LlmClient, NetworkPolicy, Page, PageQuery, RenderBlock, RenderResultRequest, RunSnapshot, RunSnapshotListEntry, RuntimePhase, ScriptExecutor, SessionStore, SkillCandidateMarker, SkillCatalogEntry, SkillIntegrityGuard, SkillOutcomeReporter, SkillStateGuard, UiBridge, UiSpecDrafts, UiSpecEvent, UiSpecSnapshot, UiSurfaceActionRequest, UiSurfaceActionResponse, UserProfile, UserProfileEntry, UserProfileExport, WebSkillErrorCode, diffUserProfile } from "@webskill/sdk";
+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 { 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";
@@ -290,6 +290,18 @@ interface ChatbotGovernancePorts {
   skillOutcomeReporter?: SkillOutcomeReporter;
   /** `SkillStatePolicy.catalogFilter()`：非 active 技能不进路由候选集 */
   catalogFilter?: (entries: SkillCatalogEntry[]) => SkillCatalogEntry[] | Promise<SkillCatalogEntry[]>;
+  /**
+   * run 未激活任何技能时的钩子（如 `createMissHook`）。
+   *
+   * 开关存在 `GovernanceFacade.missHook`（属 console），chatbot 读不到也不该依赖它；
+   * 所以读开关是**宿主**的责任。宿主应传一个**每次触发时才读开关**的闭包，
+   * 而不是装配时把布尔值算好——`#assemble()` 不是每次 run 都跑，
+   * 算好了会导致「开着启动 → 中途关闭」不生效（AC-17.11）。
+   */
+  onSkillMiss?: (input: {
+    prompt: string;
+    run: RuntimeRun;
+  }) => Promise<void>;
 }
 /** 分配式交叉：直接写 `信封 & LifecycleEventInit` 会把联合压成一个对象，`phase` 的判别性就没了 */
 type WithChatMeta<T> = T extends unknown ? {
@@ -622,6 +634,20 @@ interface SandboxExecutorDeps {
   /** 缺省时 `.ts` 脚本按 `TOOL_UNSUPPORTED` 拒绝 */
   typescript?: TypeScriptSupportOptions;
 }
+/**
+ * 装配时（而非执行时）把 `sandbox.typescript` 转成执行器参数，让配置错误早暴露。
+ * 只对绝对 URL 走 `RemoteUrlPolicy`：同源相对路径与打包器 specifier 不是出站请求。
+ */
+/**
+ * 由 `RuntimeConfig` 装出沙箱执行器依赖。
+ *
+ * 主链路与**评估链路**共用这一处（T-17-H）：此前评估侧只传 `fs`，
+ * 于是评估里跑的技能不受沙箱、网络策略、能力与授权范围约束——
+ * 那比「.ts 跑不了」严重得多（设计 17 §1.1a）。
+ *
+ * @experimental
+ */
+declare function sandboxExecutorDeps(fs: FileSystemProvider, rc?: RuntimeConfig, uiBridge?: SandboxExecutorDeps['uiBridge']): SandboxExecutorDeps;
 /** @stable */
 interface ChatEngineOptions {
   llm?: LlmClient;
@@ -934,6 +960,8 @@ declare const chatbotDictionary: {
     'message.copied': string;
     'message.retry': string;
     'message.delete': string;
+    'message.deleted.title': string;
+    'message.deleted.description': string;
     'message.viewTrace': string;
     'message.skillsUsed': string;
     'message.edit': string;
@@ -1020,6 +1048,10 @@ declare const chatbotDictionary: {
     'interaction.allow': string;
     'interaction.deny': string;
     'interaction.required': string;
+    'surface.addItem': string;
+    'surface.removeItem': string;
+    'surface.arrayFirstItemOnly': string;
+    'surface.readOnlySnapshot': string;
     'interaction.wait': string;
     'interaction.wait.inPanel': string;
     'interaction.wait.fallback': string;
@@ -1027,6 +1059,7 @@ declare const chatbotDictionary: {
     'result.artifacts': string;
     'result.download': string;
     'result.file': string;
+    'result.block.unknown': string;
     'status.aria': string;
     'status.route': string;
     'status.activate': string;
@@ -1051,7 +1084,7 @@ declare const chatbotDictionary: {
     'composer.attachment.compressed': string;
     'composer.model': string;
     'composer.model.demo': string;
-    'composer.menu': string;
+    'capability.group': string;
     'composer.pageCapture': string;
     'composer.pageCapture.disabled.setting': string;
     'composer.pageCapture.disabled.model': string;
@@ -1184,6 +1217,7 @@ declare const chatbotDictionary: {
     'vercel.preview.badge': string;
     'vercel.preview.description': string;
     'surface.legacy.placeholder': string;
+    'a11y.messageActions': string;
     'error.title': string;
     'error.suggestion': string;
     'error.suggestion.LLM_UNAVAILABLE': string;
@@ -1194,6 +1228,7 @@ declare const chatbotDictionary: {
     'error.suggestion.TOOL_RESOLUTION_EXHAUSTED': string;
     'error.limit.totalTimeoutMs': string;
     'error.limit.maxTurns': string;
+    'error.message.RUN_CANCELLED': string;
     'error.openSettings': string;
     'error.dismiss': string;
   };
@@ -1249,6 +1284,8 @@ declare const chatbotDictionary: {
     'message.editCancel': string;
     'message.retry': string;
     'message.delete': string;
+    'message.deleted.title': string;
+    'message.deleted.description': string;
     'message.viewTrace': string;
     'message.skillsUsed': string;
     'capability.tools.on': string;
@@ -1332,6 +1369,10 @@ declare const chatbotDictionary: {
     'interaction.allow': string;
     'interaction.deny': string;
     'interaction.required': string;
+    'surface.addItem': string;
+    'surface.removeItem': string;
+    'surface.arrayFirstItemOnly': string;
+    'surface.readOnlySnapshot': string;
     'interaction.wait': string;
     'interaction.wait.inPanel': string;
     'interaction.wait.fallback': string;
@@ -1339,6 +1380,7 @@ declare const chatbotDictionary: {
     'result.artifacts': string;
     'result.download': string;
     'result.file': string;
+    'result.block.unknown': string;
     'status.aria': string;
     'status.route': string;
     'status.activate': string;
@@ -1363,7 +1405,7 @@ declare const chatbotDictionary: {
     'composer.attachment.compressed': string;
     'composer.model': string;
     'composer.model.demo': string;
-    'composer.menu': string;
+    'capability.group': string;
     'composer.pageCapture': string;
     'composer.pageCapture.disabled.setting': string;
     'composer.pageCapture.disabled.model': string;
@@ -1496,6 +1538,7 @@ declare const chatbotDictionary: {
     'vercel.preview.badge': string;
     'vercel.preview.description': string;
     'surface.legacy.placeholder': string;
+    'a11y.messageActions': string;
     'error.title': string;
     'error.suggestion': string;
     'error.suggestion.LLM_UNAVAILABLE': string;
@@ -1506,6 +1549,7 @@ declare const chatbotDictionary: {
     'error.suggestion.TOOL_RESOLUTION_EXHAUSTED': string;
     'error.limit.totalTimeoutMs': string;
     'error.limit.maxTurns': string;
+    'error.message.RUN_CANCELLED': string;
     'error.openSettings': string;
     'error.dismiss': string;
   };
@@ -1561,6 +1605,8 @@ declare const useT: () => TranslateFn<{
     'message.copied': string;
     'message.retry': string;
     'message.delete': string;
+    'message.deleted.title': string;
+    'message.deleted.description': string;
     'message.viewTrace': string;
     'message.skillsUsed': string;
     'message.edit': string;
@@ -1647,6 +1693,10 @@ declare const useT: () => TranslateFn<{
     'interaction.allow': string;
     'interaction.deny': string;
     'interaction.required': string;
+    'surface.addItem': string;
+    'surface.removeItem': string;
+    'surface.arrayFirstItemOnly': string;
+    'surface.readOnlySnapshot': string;
     'interaction.wait': string;
     'interaction.wait.inPanel': string;
     'interaction.wait.fallback': string;
@@ -1654,6 +1704,7 @@ declare const useT: () => TranslateFn<{
     'result.artifacts': string;
     'result.download': string;
     'result.file': string;
+    'result.block.unknown': string;
     'status.aria': string;
     'status.route': string;
     'status.activate': string;
@@ -1678,7 +1729,7 @@ declare const useT: () => TranslateFn<{
     'composer.attachment.compressed': string;
     'composer.model': string;
     'composer.model.demo': string;
-    'composer.menu': string;
+    'capability.group': string;
     'composer.pageCapture': string;
     'composer.pageCapture.disabled.setting': string;
     'composer.pageCapture.disabled.model': string;
@@ -1811,6 +1862,7 @@ declare const useT: () => TranslateFn<{
     'vercel.preview.badge': string;
     'vercel.preview.description': string;
     'surface.legacy.placeholder': string;
+    'a11y.messageActions': string;
     'error.title': string;
     'error.suggestion': string;
     'error.suggestion.LLM_UNAVAILABLE': string;
@@ -1821,6 +1873,7 @@ declare const useT: () => TranslateFn<{
     'error.suggestion.TOOL_RESOLUTION_EXHAUSTED': string;
     'error.limit.totalTimeoutMs': string;
     'error.limit.maxTurns': string;
+    'error.message.RUN_CANCELLED': string;
     'error.openSettings': string;
     'error.dismiss': string;
   };
@@ -1876,6 +1929,8 @@ declare const useT: () => TranslateFn<{
     'message.editCancel': string;
     'message.retry': string;
     'message.delete': string;
+    'message.deleted.title': string;
+    'message.deleted.description': string;
     'message.viewTrace': string;
     'message.skillsUsed': string;
     'capability.tools.on': string;
@@ -1959,6 +2014,10 @@ declare const useT: () => TranslateFn<{
     'interaction.allow': string;
     'interaction.deny': string;
     'interaction.required': string;
+    'surface.addItem': string;
+    'surface.removeItem': string;
+    'surface.arrayFirstItemOnly': string;
+    'surface.readOnlySnapshot': string;
     'interaction.wait': string;
     'interaction.wait.inPanel': string;
     'interaction.wait.fallback': string;
@@ -1966,6 +2025,7 @@ declare const useT: () => TranslateFn<{
     'result.artifacts': string;
     'result.download': string;
     'result.file': string;
+    'result.block.unknown': string;
     'status.aria': string;
     'status.route': string;
     'status.activate': string;
@@ -1990,7 +2050,7 @@ declare const useT: () => TranslateFn<{
     'composer.attachment.compressed': string;
     'composer.model': string;
     'composer.model.demo': string;
-    'composer.menu': string;
+    'capability.group': string;
     'composer.pageCapture': string;
     'composer.pageCapture.disabled.setting': string;
     'composer.pageCapture.disabled.model': string;
@@ -2123,6 +2183,7 @@ declare const useT: () => TranslateFn<{
     'vercel.preview.badge': string;
     'vercel.preview.description': string;
     'surface.legacy.placeholder': string;
+    'a11y.messageActions': string;
     'error.title': string;
     'error.suggestion': string;
     'error.suggestion.LLM_UNAVAILABLE': string;
@@ -2133,6 +2194,7 @@ declare const useT: () => TranslateFn<{
     'error.suggestion.TOOL_RESOLUTION_EXHAUSTED': string;
     'error.limit.totalTimeoutMs': string;
     'error.limit.maxTurns': string;
+    'error.message.RUN_CANCELLED': string;
     'error.openSettings': string;
     'error.dismiss': string;
   };
@@ -2154,6 +2216,20 @@ interface AppearanceChange {
   dictationLang?: string;
 }
 //#endregion
+//#region src/react/settingsSection.d.ts
+/**
+ * chatbot 里各处「打开设置」出口指向的分区（FR-20.3）。
+ *
+ * 取值就是 console 的路由 leaf id，因此不需要维护第二套映射表；
+ * 但这**不构成对 `@webskill/console` 的依赖**——它只是一组字符串字面量。
+ * 宿主不用 console 时，这些字符串就是它自定义路由的键名，语义自定。
+ *
+ * 只覆盖**配置类** leaf：`skills.editor`、`governance.review` 这些与配置无关的页
+ * 不在其中（AC-20.7 按「无未覆盖的配置类 leaf」执行，见偏差 D-15）。
+ * @experimental
+ */
+type SettingsSectionId = 'settings.runtime' | 'settings.sandbox' | 'settings.genui' | 'settings.trust' | 'settings.privacy' | 'settings.appearance' | 'connections.models' | 'connections.page' | 'connections.mcp';
+//#endregion
 //#region src/react/useChatLayout.d.ts
 /** 宿主可指定的布局档；auto 按容器尺寸判定 @stable */
 type ChatLayout = 'auto' | 'fullscreen' | 'embedded';
@@ -2181,6 +2257,12 @@ interface ChatbotProps {
   /** 布局档（默认 'auto'：按容器尺寸在 fullscreen / embedded / mobile 之间判定） */
   layout?: ChatLayout;
   onAppearanceChange?(next: AppearanceChange): void;
+  /**
+   * 打开配置面（FR-20.4）。配置面本身已迁到 console，chatbot 只负责发出这个请求；
+   * 宿主不接就不渲染任何「打开设置」出口——给一个点了没反应的按钮更糟。
+   * `section` 可选（FR-16.5）：齿轮不带分区（→ Overview），带诉求的入口（错误卡等）才传分区。
+   */
+  onOpenSettings?(section?: SettingsSectionId): void;
   /**
    * 装配完成后把引擎交给宿主，用于接线跨界面动作（例如 console 的快照恢复入口
    * 需要调 `engine.resume(runId)`）。每次重新装配都会再调一次。
@@ -2192,7 +2274,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, onAppearanceChange, onEngineReady }: ChatbotProps): import("react").JSX.Element;
+declare function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, renderer: rendererProp, dictationLang: dictationLangProp, surfaceRegistry, layout, onAppearanceChange, onOpenSettings, onEngineReady }: ChatbotProps): import("react").JSX.Element;
 //#endregion
 //#region src/react/A2uiSurfaceHost.d.ts
 /** @experimental */
@@ -2348,66 +2430,6 @@ interface InterruptedBannerProps {
  */
 declare function InterruptedBanner({ engine, sessionId }: InterruptedBannerProps): import("react").JSX.Element | null;
 //#endregion
-//#region src/react/SettingsDrawer.d.ts
-/** @stable */
-interface SettingsDrawerProps {
-  open: boolean;
-  /**
-   * 运行环境配置存储：模型列表、流式、temperature、Agent 能力全部读写这里。
-   * 缺省时模型区只读展示（宿主没接配置源，谈不上持久化）。
-   */
-  runtimeConfig?: RuntimeConfigStore;
-  /**
-   * 语音识别语言（BCP-47）；空串即跟随界面语言（FR-7.7）。
-   * @experimental
-   */
-  dictationLang?: string;
-  /** 语音语言切换时回调（写回同一份外观配置） */
-  onAppearanceChange?(next: AppearanceChange): void;
-  /**
-   * 当前选中的模型条目 id（FR-14.4）：它不支持工具时，Agent 能力开关置灰。
-   * @experimental
-   */
-  selectedModelId?: string;
-  /** 保存/清除成功后回调（Chatbot 借此触发 engine.reloadConfig） */
-  onSaved(): void;
-  /**
-   * 用户画像的读写入口（需求 19）。不注入即整段画像 UI 不渲染（R11）——
-   * 没有数据源时展示一个空列表比不展示更容易让人以为「记录丢了」。
-   * @experimental
-   */
-  userProfileApi?: UserProfileApi;
-  /**
-   * 打开时定位到哪个分区（缺省 `'general'`）。触顶报错的「打开设置」按此直达 Agent 区，
-   * 让用户少找一步（FR-21.2）。传了不存在的 id 则回落到 `'general'`。
-   * @experimental
-   */
-  initialSectionId?: string;
-  onClose(): void;
-}
-/** 设置面板对画像数据的最小依赖面；实现由 Chatbot 用 ChatEngine 装配 @experimental */
-interface UserProfileApi {
-  read(): Promise<UserProfile>;
-  refine(): Promise<UserProfile>;
-  deleteEntry(id: string): Promise<UserProfile>;
-  clearRecords(): Promise<void>;
-  clearProfile(): Promise<void>;
-  /** 记录与画像一并清除（关闭总开关时的追问） */
-  clearAll(): Promise<void>;
-  /** `excludeIds` 来自导出前的逐条审阅 */
-  export(excludeIds: readonly string[]): Promise<UserProfileExport>;
-  diffImport(incoming: UserProfileExport): Promise<UserProfileImportDiff>;
-  applyImport(incoming: UserProfileExport): Promise<UserProfile>;
-}
-/** @experimental */
-interface UserProfileImportDiff {
-  added: readonly UserProfileEntry[];
-  updated: readonly UserProfileEntry[];
-  origin: string;
-}
-/** 设置抽屉：模型列表（增删改 / 设默认 / 逐条探测）+ 流式与 temperature + Agent 能力 + 语音语言 @stable */
-declare function SettingsDrawer({ open, runtimeConfig, dictationLang, selectedModelId, onAppearanceChange, onSaved, userProfileApi: profileApi, initialSectionId, onClose }: SettingsDrawerProps): import("react").JSX.Element;
-//#endregion
 //#region src/react/ErrorCard.d.ts
 /** @stable */
 interface ErrorCardProps {
@@ -2430,4 +2452,12 @@ interface ErrorCardProps {
 /** 结构化错误卡：错误码徽章 + 描述 + 建议（engine error 事件 / 失败 run） @stable */
 declare function ErrorCard({ code, message, loopLimits, onOpenSettings, onDismiss }: ErrorCardProps): import("react").JSX.Element;
 //#endregion
-export { A2uiSurfaceHost, type A2uiSurfaceHostProps, A2uiSurfaceSnapshotHost, type A2uiSurfaceSnapshotHostProps, type AppearanceChange, type ChatAttachmentInput, type ChatAttachmentMeta, ChatEngine, type ChatEngineOptions, type ChatEvent, type ChatInteractionRecord, type ChatLayout, type ChatMessage, type ChatRunPhase, type ChatSessionListResult, type ChatSessionMeta, type ChatTheme, 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, SettingsDrawer, type SettingsDrawerProps, SkillBadges, SpecInteraction, type SpecInteractionProps, type UserProfileApi, type UserProfileImportDiff, VercelPayloadPreview, type VercelPayloadPreviewProps, VercelSurfaceHost, type VercelSurfaceHostProps, VercelSurfaceSnapshotHost, type VercelSurfaceSnapshotHostProps, chatbotDictionary, configureA2uiMarkdown, createLocalStorageRuntimeConfigStore, createMemoryRuntimeConfigStore, probeA2uiAvailability, probeOpenUiAvailability, useT };
+//#region src/version.d.ts
+/** Generated by scripts/syncVersionConstant.mjs from packages/chatbot/package.json. Do not edit by hand. */
+/**
+ * Version of the published `@webskill/chatbot` package, injected at build time.
+ * @stable
+ */
+declare const CHATBOT_VERSION = "0.6.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 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, probeA2uiAvailability, probeOpenUiAvailability, sandboxExecutorDeps, useT };